co_drivers — Cassini Driver Classes

The ale.drivers.co_drivers module

New in version 0.1.0.

class ale.drivers.co_drivers.CassiniIssIsisLabelIsisSpiceDriver(file, num_ephem=909, num_quats=909, props={}, parsed_label=None)

Bases: Framer, IsisLabel, IsisSpice, NoDistortion, Driver

property center_ephemeris_time

Returns the middle exposure time for the image in ephemeris seconds.

This is overridden because the ISIS ISSNAC and ISSWAC sensor models use the label utc times so the converted times are not available in the NaifKeywords. Instead we get it from the tables.

Returns

: float

property focal_length

The focal length of the instrument Expects naif_keywords to be defined. This should be a dict containing Naif keyworkds from the label. Expects ikid to be defined. This should be the integer Naif ID code for the instrument.

Returns

float :

The focal length in millimeters

property instrument_id

Returns the ID of the instrument

Returns

: str

ID of the sensor

property sensor_name

Returns the name of the instrument

Returns

: str

Name of the sensor

class ale.drivers.co_drivers.CassiniIssIsisLabelNaifSpiceDriver(file, num_ephem=909, num_quats=909, props={}, parsed_label=None)

Bases: Framer, IsisLabel, NaifSpice, RadialDistortion, Driver

property center_ephemeris_time

Returns the starting ephemeris time as the ssi framers center is the start.

Returns

: double

Center ephemeris time for an image

property ephemeris_start_time

Returns the start and stop ephemeris times for the image.

Returns

: float

start time

property focal_length

NAC uses multiple filter pairs, each filter combination has a different focal length. NAIF’s Cassini kernels do not contain focal lengths for NAC filters and so we aquired updated NAC filter data from ISIS’s IAK kernel.

property frame_chain

Construct the initial frame chain using the original sensor_frame_id obtained from the ikid. Then tack on the ISIS iak rotation.

Returns

: Object

Custom Cassini ALE Frame Chain object for rotation computation and application

property instrument_id

Returns an instrument id for unquely identifying the instrument, but often also used to be piped into Spice Kernels to acquire instrument kernel (IK) NAIF IDs. Therefore they use the same NAIF ID asin bods2c calls. Expects instrument_id to be defined from a mixin class. This should return a string containing either ‘ISSNA’ or ‘ISSWA’

Returns

: str

instrument id

property odtk

The radial distortion coeffs are not defined in the ik kernels, instead they are defined in the ISS Data User Guide (Knowles). Therefore, we manually specify the codes here. Expects instrument_id to be defined. This should be a string containing either CASSINI_ISS_WAC or CASSINI_ISIS_NAC

Returns

: list<float>

radial distortion coefficients

property sensor_frame_id

Overwrite sensor frame id to return fake frame ID for NAC representing a mounting point with a 180 degree rotation. ID was taken from ISIS’s IAK kernel for Cassini. This is because NAC requires an extra rotation not in NAIF’s Cassini kernels. Wac does not require an extra rotation so we simply return original sensor frame id for Wac.

Returns

: int

NAIF’s Wac sensor frame ID, or ALE’s Nac sensor frame ID

property sensor_model_version

Returns the ISIS camera version

Returns

: int

Camera version number

property sensor_name

Returns the name of the instrument

Returns

: str

Name of the sensor

property spacecraft_name

Spacecraft name used in various Spice calls to acquire ephemeris data.

Returns

: str

Name of the spacecraft

class ale.drivers.co_drivers.CassiniIssPds3LabelNaifSpiceDriver(file, num_ephem=909, num_quats=909, props={}, parsed_label=None)

Bases: Framer, Pds3Label, NaifSpice, RadialDistortion, Driver

Cassini mixin class for defining Spice calls.

property detector_center_line

Detector center based on ISIS’s corrected values.

Returns

: int

The detector line of the principle point

property detector_center_sample

Detector center based on ISIS’s corrected values.

Returns

: int

The detector sample of the principle point

property focal2pixel_lines

Expects ikid to be defined. This should be an integer containing the Naif ID code of the instrument

Returns

: list<double>

focal plane to detector lines

property focal2pixel_samples

Expects ikid to be defined. This should be an integer containing the Naif ID code of the instrument

Returns

: list<double>

focal plane to detector samples

property focal_epsilon

Expects ikid to be defined. This should be an integer containing the Naif ID code of the instrument

Returns

: float

focal epsilon

property focal_length

NAC uses multiple filter pairs, each filter combination has a different focal length. NAIF’s Cassini kernels do not contain focal lengths for NAC filters and so we acquired updated NAC filter data from ISIS’s IAK kernel.

property frame_chain

Construct the initial frame chain using the original sensor_frame_id obtained from the ikid. Then tack on the ISIS iak rotation.

Returns

: Object

Custom Cassini ALE Frame Chain object for rotation computation and application

property instrument_id

Returns an instrument id for uniquely identifying the instrument, but often also used to be piped into Spice Kernels to acquire instrument kernel (IK) NAIF IDs. Therefore they use the same NAIF ID asin bods2c calls. Expects instrument_id to be defined from a mixin class. This should return a string containing either ‘ISSNA’ or ‘ISSWA’

Returns

: str

instrument id

property odtk

The radial distortion coeffs are not defined in the ik kernels, instead they are defined in the ISS Data User Guide (Knowles). Therefore, we manually specify the codes here. Expects instrument_id to be defined. This should be a string containing either CASSINI_ISS_WAC or CASSINI_ISIS_NAC

Returns

: list<float>

radial distortion coefficients

property sensor_frame_id

Overwrite sensor frame id to return fake frame ID for NAC representing a mounting point with a 180 degree rotation. ID was taken from ISIS’s IAK kernel for Cassini. This is because NAC requires an extra rotation not in NAIF’s Cassini kernels. Wac does not require an extra rotation so we simply return original sensor frame id for Wac.

Returns

: int

NAIF’s Wac sensor frame ID, or ALE’s Nac sensor frame ID

property sensor_model_version

Returns instrument model version

Returns

: int

ISIS sensor model version

property spacecraft_name

Spacecraft name used in various Spice calls to acquire ephemeris data.

Returns

: str

Name of the spacecraft