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
- 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
- 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