Tool: get_ldp_filename

Description

This tool determines the proper filename for the LDP in the observation directory for a given LDP. This can happen in one of several ways. First, for NFI LDPS we use the ID from the tertiary header embedded in the LDP header. Next, for BAT LDPs and LDPs which have the ID set to 0xffffffff, we use the time from the tertiary header in conjunction with a timeline. BAT and the NFIs use different timelines. If the tertiary header time is set to an invalid value, then we use the secondary header from page 2 of the LDP. Finally, for LDPs which are old enough that we are confdent that no more packets will arive, we use the secondary header time from any available packet.

Option Summary

OptionArgument TypeDefault Value
-apid_list String apids.list
-bat_timeline String bat_timeline
-dir String .
-first_bat_apid Integer 289
-index Integer 0
-infile String -
-last_bat_apid Integer 571
-mature_data_time Real 0.0
-outfile String -
-timeline String timeline

Only the initial unique characters of each option are significant. Each option must be followed by an argument of the given type. Boolean "true" and "false" are indicated with "y" and "n" respectively. A boolean option without a value is assumed to be "true". For filename arguments, "-" means either stdin or stdout as appropriate. Each option is described in detail below.

Parameters

apid_list String (default = apids.list)
Configuration file identifying packets types by APID.

bat_timeline String (default = bat_timeline)

dir String (default = .)
Name of the observation directory to contain the renamed files.

first_bat_apid Integer (default = 289)

index Integer (default = 0)

infile String (default = -)
LDP file whose name we are trying to determine.

last_bat_apid Integer (default = 571)

mature_data_time Real (default = 0.0)

outfile String (default = -)
File to which the new filename willbe written (usually stdout).

timeline String (default = timeline)