dawn_drivers — Dawn Driver Classes

The ale.drivers.dawn_drivers module

Added in version 0.8.1.

class ale.drivers.dawn_drivers.DawnFcPds3NaifSpiceDriver(file, num_ephem=909, num_quats=909, props={})

Bases: Framer, Pds3Label, NaifSpice, Driver

Dawn driver for generating an ISD from a Dawn PDS3 image.

property detector_center_line

Returns center detector line acquired from Spice Kernels. Expects ikid to be defined. This should be the integer Naid ID code for the instrument.

We have to add 0.5 to the CCD Center because the Dawn IK defines the detector pixels as 0.0 being the center of the first pixel so they are -0.5 based.

Returns

: float

center detector line

property detector_center_sample

Returns center detector sample acquired from Spice Kernels. Expects ikid to be defined. This should be the integer Naid ID code for the instrument.

We have to add 0.5 to the CCD Center because the Dawn IK defines the detector pixels as 0.0 being the center of the first pixel so they are -0.5 based.

Returns

: float

center detector sample

property ephemeris_start_time

Compute the center ephemeris time for a Dawn Frame camera. This is done via a spice call but 193 ms needs to be added to account for the CCD being discharged or cleared.

property focal2pixel_lines

Expects ikid to be defined. This should be an integer containing the Naif ID code for 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 for the instrument.

Returns

: list<double>

focal plane to detector samples

property instrument_id

Returns an instrument id for uniquely identifying the instrument, but often also used to be piped into Spice Kernels to acquire IKIDs. Therefore the the same ID that Spice expects in bods2c calls. Expects instrument_id to be defined from the PDS3Label mixin. This should be a string containing the short name of the instrument. Expects filter_number to be defined. This should be an integer containing the filter number from the PDS3 Label.

Returns

: str

instrument id

property label

Loads a PVL from from the _file attribute and parses the binary table data.

Returns

PVLModule :

Dict-like object with PVL keys

property odtk

The coefficients for the distortion model Expects ikid to be defined. This should be an integer containing the Naif ID code for the instrument.

Returns

: list

Radial distortion coefficients

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. Dawn does not have a SPACECRAFT_NAME keyword, therefore we are overwriting this method using the instrument_host_id keyword instead. Expects instrument_host_id to be defined. This should be a string containing the name of the spacecraft that the instrument is mounted on.

Returns

: str

Spacecraft name

property target_name

Returns an target name for unquely identifying the instrument, but often piped into Spice Kernels to acquire Ephermis data from Spice. Therefore they the same ID the Spice expects in bodvrd calls. In this case, vesta images have a number infront of them like “4 VESTA” which needs to be simplified to “VESTA” for spice. Expects target_name to be defined in the Pds3Label mixin. This should be a string containing the name of the target body.

Returns

: str

target name

property usgscsm_distortion_model

The Dawn framing camera uses a unique radial distortion model so we need to overwrite the method packing the distortion model into the ISD. Expects odtk to be defined. This should be a list containing the radial distortion coefficients

Returns

: dict

Dictionary containing the distortion model