Pinhole

Bases: OpticalAperture_Type

Represents the XML element Pinhole.

A pin-like aperture positioned axially to the Light Path, which can act as a spatial filter for a beam of light to clean up the output of lasers and / or to suppress out-of-focus light in a confocal Microscope. Specifically, in Confocal Microscopy, such Pinholes are diaphragm typically situated in a plane conjugate with the object, and they restrict the area in the object plane that is illuminated and/or from which light is collected.

getTypeName()

Returns the class type name.

Returns:

Type	Description
string	The class type name

getXMLName()

Returns the XML element name corresponding to this class.

Returns:

Type	Description
string	The XML element name

getNBOType()

Returns the NBO Type corresponding to this class.

Returns:

Type	Description
int	The NBO Type value

getChildren()

Returns a list of all classes derived from this class.

Returns:

Type	Description
List[NBOBaseClass]	The list of derived classes

getSubElements()

Returns a list of all child elements contained in this class.

Returns:

Type	Description
List[NBOBaseClass]	The list of child classes

fromJsonFile(path)

Populates this object from a JSON file.

Parameters:

Name	Type	Description	Default
path	string	The path to the JSON file	required

fromJsonString(json_string)

Populates this object from a JSON string.

Parameters:

Name	Type	Description	Default
json_string	string	The JSON content as a string	required

fromXmlFile(path)

Populates this object from a XML file.

Parameters:

Name	Type	Description	Default
path	string	The path to the XML file	required

fromXmlString(xml_string)

Populates this object from a XML string.

Parameters:

Name	Type	Description	Default
xml_string	string	The XML content as a string	required

toXmlFile(filename)

Serializes this object to an XML file.

Parameters:

Name	Type	Description	Default
filename	string	The path to the output XML file	required

toXmlString()

Serializes this object to an XML string.

Returns:

Type	Description
string	A string containing the XML representation of this object

setMaxDiameter(value)

Sets the value of the MaxDiameter attribute.

This field records the maximum physical diameter of this Pinhole.

Parameters:

Name	Type	Description	Default
value	float	The value to set	required

getMaxDiameter()

Returns the value of the MaxDiameter attribute.

This field records the maximum physical diameter of this Pinhole.

Returns:

Type	Description
float	The value of the attribute

setMaxDiameterUnit(value)

Sets the value of the MaxDiameterUnit attribute.

No description available in the XSD standard.

Parameters:

Name	Type	Description	Default
value	UnitsLength_Type	The value to set	required

getMaxDiameterUnit()

Returns the value of the MaxDiameterUnit attribute.

No description available in the XSD standard.

Returns:

Type	Description
UnitsLength_Type	The value of the attribute

resetMaxDiameterUnit()

Resets the MaxDiameterUnit attribute to an unset state.

No description available in the XSD standard.

hasMaxDiameterUnit()

Checks whether the optional MaxDiameterUnit attribute is present.

No description available in the XSD standard.

Returns:

Type	Description
boolean	true if the optional attribute has been set, false otherwise

setShape(value)

Sets the value of the Shape attribute.

This field records the Shape of this Pinhole.

Parameters:

Name	Type	Description	Default
value	PinholeShapeList_Type	The value to set	required

getShape()

Returns the value of the Shape attribute.

This field records the Shape of this Pinhole.

Returns:

Type	Description
PinholeShapeList_Type	The value of the attribute

resetShape()

Resets the Shape attribute to an unset state.

This field records the Shape of this Pinhole.

hasShape()

Checks whether the optional Shape attribute is present.

This field records the Shape of this Pinhole.

Returns:

Type	Description
boolean	true if the optional attribute has been set, false otherwise