Skip to content

ImmersionLiquid

Bases: ManufacturerSpec_Type

Represents the XML element ImmersionLiquid.

This element refers to the Immersion Liquid that was used with this Objective during the Acquisition of this Image. According to ISO 10934-1:2002, an Immersion Liquid is a liquid (commonly immersion oil, water, glycerol or any media in which the Specimen is submerged during acquisition in case a Cover Glass is not used) specified as suitable for use in the space between the front of an Objective lens and the Cover Glass or the Object itself (i.e., such as is the case for Dipping Objectives). Refer to ISO 8036-1 for more details on Immersion Oil. Please NOTE: Because the Immersion Liquid is considered in the computing of corrections to be part of the lens, its refractive index and dispersion (or Abbe number) are critical. Also please NOTE: In case a Cover Glass is not used during Acquisition the Immersion Liquid is most often referred to as Dipping Medium. Examples of Dipping Media include, water-based solutions (biological buffers, culture media, other water-based solutions) and organic-based [FocusClear (CLARITY); CUBIC-1, CUBIC-2, CUBIC-R1, CUBIC-R2; 2,2-thiodiethanol (TDE); ethyl cinnamate; Benzyl Benzoate and BB-PEG (PEGASOS); Benzyl Alcohol, Benzyl Benzoate (BABB); dibenzyl ether (DBE); Ethanol].

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

setID(value)

Sets the value of the ID attribute.

A Unique Identifier for this component.

Parameters:

Name Type Description Default
value LSID_Type

The value to set

required

getID()

Returns the value of the ID attribute.

A Unique Identifier for this component.

Returns:

Type Description
LSID_Type

The value of the attribute

resetID()

Resets the ID attribute to an unset state.

A Unique Identifier for this component.

hasID()

Checks whether the optional ID attribute is present.

A Unique Identifier for this component.

Returns:

Type Description
boolean

true if the optional attribute has been set, false otherwise

setType(value)

Sets the value of the Type attribute.

This field records the general category to which this Immersion Liquid belongs.

Parameters:

Name Type Description Default
value ImmersionLiquidType_Type

The value to set

required

getType()

Returns the value of the Type attribute.

This field records the general category to which this Immersion Liquid belongs.

Returns:

Type Description
ImmersionLiquidType_Type

The value of the attribute

resetType()

Resets the Type attribute to an unset state.

This field records the general category to which this Immersion Liquid belongs.

hasType()

Checks whether the optional Type attribute is present.

This field records the general category to which this Immersion Liquid belongs.

Returns:

Type Description
boolean

true if the optional attribute has been set, false otherwise

setRefractiveIndex(value)

Sets the value of the RefractiveIndex attribute.

This field reocrds the nominal Refractive Index of this Immersion Liquid, as specified by the Manufacturer.

Parameters:

Name Type Description Default
value float

The value to set

required

getRefractiveIndex()

Returns the value of the RefractiveIndex attribute.

This field reocrds the nominal Refractive Index of this Immersion Liquid, as specified by the Manufacturer.

Returns:

Type Description
float

The value of the attribute

resetRefractiveIndex()

Resets the RefractiveIndex attribute to an unset state.

This field reocrds the nominal Refractive Index of this Immersion Liquid, as specified by the Manufacturer.

hasRefractiveIndex()

Checks whether the optional RefractiveIndex attribute is present.

This field reocrds the nominal Refractive Index of this Immersion Liquid, as specified by the Manufacturer.

Returns:

Type Description
boolean

true if the optional attribute has been set, false otherwise

setViscosity(value)

Sets the value of the Viscosity attribute.

This field records the nominal Viscosity of this Immersion Liquid as specified by the Manufacturer.

Parameters:

Name Type Description Default
value float

The value to set

required

getViscosity()

Returns the value of the Viscosity attribute.

This field records the nominal Viscosity of this Immersion Liquid as specified by the Manufacturer.

Returns:

Type Description
float

The value of the attribute

resetViscosity()

Resets the Viscosity attribute to an unset state.

This field records the nominal Viscosity of this Immersion Liquid as specified by the Manufacturer.

hasViscosity()

Checks whether the optional Viscosity attribute is present.

This field records the nominal Viscosity of this Immersion Liquid as specified by the Manufacturer.

Returns:

Type Description
boolean

true if the optional attribute has been set, false otherwise