eaarl.io.ins

Handling for ins trajectory file

eaarl.io.ins.add_to_frame(frame, sod, ins, ops=None, prefix='ins_', zone=None)[source]

Adds interpolated INS data to a frame

Adds the following fields to the given dataframe:
  • ins_lon - longitude of GPS antenna in degrees
  • ins_lat - latitude of GPS antenna in degrees
  • ins_alt - altitude of GPS antenna in meters
  • ins_roll - roll of INS in degrees
  • ins_pitch - pitch of INS in degrees
  • ins_heading - heading of INS in degrees
  • ins_east - UTM easting of GPS antenna in meters
  • ins_north - UTM northing of GPS antenna in meters
  • ins_zone - UTM zone for ins_east and ins_north
Parameters
frame : pandas.DataFrame
A pandas DataFrame that will have fields added to it
sod : np.array or pandas.Series
Seconds-of-the-day time values that correspond to the records in the frame
ins : pandas.DataFrame
INS data to interpolate from
ops : dict
The ops data for the flight
prefix : string, default “ins\_”
Allows you to change the prefix used for the added fields.
zone : number or None
Allows you to specify a UTM zone that should be used when deriving the northing and easting values
Returns : pandas.DataFrame
Returns the DataFrame that was passed to it, which now contains added fields.
eaarl.io.ins.apply_corrections(ins, gps_time_offset=0)[source]

Update INS data with relevant corrections

The timestamp in an INS file can originally be in seconds-of-the-week format. This converts it to seconds-of-the-mission-day format.

The heading is also “unwrapped” so the angle values avoid big jumps. For example, the sequence [359, 1] will become [359, 361]. This speeds up interpolation.

Parameters
ins : pandas.DataFrame
A DataFrame containing the INS data
gps_time_offset : numeric
GPS time offset to apply to the data to convert it to UTC time.
Returns : pandas.DataFrame
Returns the modified ins DataFrame.
eaarl.io.ins.read(filename)[source]

Read INS data from a given HDF5 or CSV file

Returns : pandas.DataFrame
Returns a DataFrame with the file’s data.