GEDI L1A Product Data Dictionary

Dimension Variable Description
MT Number of shots
AV Number of average waveform groups


Group: /
l0_to_l1a_githash (Attribute) Git commit hash of the l0_to_l1a software used to create the L1A file
l0_to_l1a_version (Attribute) Version number of the l0_to_l1a software used to create the L1A file
short_name (Attribute) GEDI_L1A ${DESCRIPTION}
Group: /METADATA/DatasetIdentification
abstract (Attribute) The GEDI L1A and L1B standard data product contains precise latitude, longitude, and height above the reference ellipsoid of the laser shot received bounce point for all laser shots. Geophysical corrections are applied to the surface return values for each laser shot. Geophysical corrections, atmospheric corrections, and the surface types are provided for each laser shot. ${DESCRIPTION}
characterSet (Attribute) utf8 ${DESCRIPTION}
creationDate (Attribute) File creation date
credit (Attribute) The software that generates the L1A product was designed and implemented within the GEDI Science Data Processing System at the NASA Goddard Space Flight Center in Greenbelt, Maryland. ${DESCRIPTION}
fileName (Attribute) Original file name
language (Attribute) eng ${DESCRIPTION}
originatorOrganizationName (Attribute) GSFC GEDI-SDPS > GEDI Science Data Processing System ${DESCRIPTION}
PGEVersion (Attribute) Production software version ID
purpose (Attribute) The purpose of the L1A dataset is to provide all of the instrument information for each laser shot for all eight GEDI beams. This includes all instrument parameters, ranging parameters, waveforms, geolocation parameters, and geophysical corrections. ${DESCRIPTION}
shortName (Attribute) GEDI_L1A ${DESCRIPTION}
spatialRepresentationType (Attribute) along-track ${DESCRIPTION}
status (Attribute) onGoing ${DESCRIPTION}
topicCategory (Attribute) geoscientificInformation ${DESCRIPTION}
uuid (Attribute) Universally unique identifier (UUID) for this file
VersionID (Attribute) Release data product version ID
Group: /BEAMXXXX
description (Attribute) "Coverage beam" or "Full power beam"
Label Datatype
(Dimensions)
long_name units
source
description
all_samples_sum UINT32
(MT)
All samples sum counts from the ADC (Analog-to-Digital Converter)
L0B
Sum of all values within the 10 km range window. delta_time
bdu UINT16
(MT)
Beam dithering unit N/A
L0B
Beam dithering unit code delta_time
beam UINT16
(MT)
Beam counter
Derived
Beam number (0-15). delta_time
channel UINT8
(MT)
Channel counter
L0B
Channel number (0-7). delta_time
dithered UINT8
(MT)
Dithered boolean
L0B
Set to 1 if the shot is dithered, 0 otherwise. delta_time
framesync UINT32
(MT)
Framesync 2e-7 seconds
L0B
Oven controlled oscillator (OCXO) framesync offset count from Global Positioning System (GPS) Pulse Per Second (PPS).
gps_framesync UINT32
(MT)
GPS framesync 2e-7 seconds
L0B
GPS framesync offset count from GPS PPS.
gps_time UINT32
(MT)
GPS time seconds since 1980-01-06T00:00:00Z
L0B
GPS time, integer part.
is_crc_valid UINT8
(MT)
Is CRC valid boolean
Derived
Set to 1 if the CRC matches the packet, 0 otherwise. delta_time
iss_fraction UINT16
(MT)
ISS fraction N/A
L0B
Middle 16 bits of the 48 bit long time value broadcast by the ISS.
iss_framesync UINT32
(MT)
ISS framesync 2e-7 seconds
L0B
International Space Station (ISS) framesync offset count from GPS PPS.
iss_time UINT32
(MT)
ISS integer time seconds since 1980-01-06T00:00:00Z
L0B
International Space Station (ISS) clock integer time.
master_frac FLOAT64
(MT)
Master time fractional seconds seconds
Derived
Master time, fractional part. master_int+master_frac is equivalent to /BEAMXXXX/geolocation/delta_time and /BEAMXXXX/geophys_corr/delta_time.
master_int UINT32
(MT)
Master time integer seconds seconds
Derived
Master time, integer part. Seconds since master_time_epoch. master_int+master_frac is equivalent to /BEAMXXXX/geolocation/delta_time and /BEAMXXXX/geophys_corr/delta_time.
master_source UINT8
(MT)
Master time source flag
Derived
The source for each master time. 0=None, 1=GPS, 2=OCXO, 3=ISS. delta_time
minor_frame_number UINT16
(MT)
Minor frame number counter
L0B
Minor frame number (0-241). delta_time
noise_mean FLOAT32
(MT)
Noise mean counts from the ADC
L0B
Noise mean. delta_time
noise_std_dev UINT16
(MT)
Noise standard deviation counts from the ADC
L0B
Noise standard deviation, rounded integer. delta_time
override UINT8
(MT)
Override boolean
L0B
1 if threshold override is on. delta_time
packet_count UINT32
(MT)
Packet count counter
L0B
Packet count since last FPGA load. delta_time
packet_length UINT16
(MT)
Packet length bytes
L0B
Valid packet byte count. delta_time
pers_coarse UINT8
(MT)
Persistance coarse boolean
L0B
Persistance coarse, 1 if single. delta_time
pers_fine UINT8
(MT)
Persistance fine boolean
L0B
Persistance fine, 1 if single. delta_time
rx_offset UINT16
(MT)
RX offset sample intervals (~1 ns)
L0B
Time interval from first stored sample to first downloaded RX sample (1ns resolution). delta_time
rx_open UINT32
(MT)
RX open sample intervals (~1 ns)
L0B
Time interval from t0 to first stored RX sample (4ns resolution). delta_time
rx_sample UINT8
(MT)
RX sample flag
L0B
If set to 1, the RX waveform is suppressed. delta_time
rx_sample_count UINT16
(MT)
RX sample count sample intervals
L0B
The number of sample intervals (elements) in each RX waveform. delta_time
rx_sample_start_index UINT64
(MT)
RX sample start index index (origin 1)
Derived
The index in the rxwaveform dataset of the first element of each RX waveform. The indices start at 1. delta_time
rx_sample_sum UINT32
(MT)
RX sample sum counts from the ADC
L0B
Sum of RX values in RX waveform. delta_time
rxwaveform UINT16
(UNLIMITED)
RX waveform counts from the ADC
L0B
The receive (RX) waveforms. Use rx_sample_count and rx_sample_start_index to identify the location of each waveform.
selection_stretchers_x UINT16
(MT)
Selection stretchers X sample intervals (~1 ns)
L0B
Commanded number of samples added to algo section on the left. delta_time
selection_stretchers_y UINT16
(MT)
Selection stretchers Y sample intervals (~1 ns)
L0B
Commanded number of samples added to algo section on the right. delta_time
shot_number UINT64
(MT)
Shot number counter
Derived
Unique shot ID. delta_time
stale_return_flag UINT8
(MT)
Stale return flag boolean
L0B
Indicates that a "stale" cue point from the coarse search algorithm is being used. delta_time
stretchers_x UINT8
(MT)
Stretchers X sample intervals (~1 ns)
L0B
Buffer size added to left of the fine threshold location. delta_time
stretchers_y UINT8
(MT)
Stretchers Y sample intervals (~1 ns)
L0B
Buffer size added to the right of the fine threshold location. delta_time
sum_of_squares UINT32
(MT)
Noise sum of squares counts from the ADC
L0B
Sum of squares calculated for noise region. delta_time
sync UINT16
(MT)
Sync word N/A
L0B
Constant sync word in the L0B file, should always be 0xA5A5. delta_time
th_coarse_used UINT16
(MT)
Threshold coarse used counts
L0B
Count values for coarse threshold. Once a pulse has been detected, then window for fine threshold search is set. Two consecutive points at or above this value indicates pulse detection. delta_time
th_left_used UINT16
(MT)
Threshold fine left used counts from the ADC
L0B
Count values for left threshold used in fine search. Two consecutive points at or above this value indicates pulse detection. delta_time
th_mult_coarse FLOAT32
(MT)
Threshold multiplier coarse N/A
L0B
Multiplier used to determine threshold coarse used. delta_time
th_mult_left FLOAT32
(MT)
Threshold multiplier fine left N/A
L0B
Multiplier used to determine threshold fine left used. delta_time
th_mult_right FLOAT32
(MT)
Threshold multiplier fine right N/A
L0B
Multiplier used to determine threshold right left used. delta_time
th_right_used UINT16
(MT)
Threshold fine right used counts from the ADC
L0B
Count value for right threshold used in fine search. Two consecutive points at or above this value indicates pulse detection. delta_time
tx_offset UINT16
(MT)
TX offset sample intervals (~1 ns)
L0B
Time interval from first stored sample to first downloaded TX sample (1ns resolution). delta_time
tx_open UINT32
(MT)
TX open sample intervals (~1 ns)
L0B
Time interval from t0 to first stored TX sample (4ns resolution) delta_time
tx_sample_count UINT16
(MT)
TX sample count sample intervals
Derived
The number of sample intervals (elements) in each TX waveform. delta_time
tx_sample_info UINT8
(MT)
TX sample info flag
L0B
Flag indicating the value of tx_sample_count. 1:64, 2:80, 4:96, 8:112, else:128 delta_time
tx_sample_start_index UINT64
(MT)
TX sample start index index (origin 1)
Derived
The index in the rxwaveform dataset of the first element of each RX waveform. The indices start at 1. delta_time
tx_sample_sum UINT32
(MT)
TX sample sum counts from the ADC
L0B
Sum of TX values in TX waveform. delta_time
txwaveform UINT16
(UNLIMITED)
TX waveform counts from the ADC
L0B
The transmit (TX) waveforms. Use tx_sample_count and tx_sample_start_index to identify the location of each waveform.
Group: /BEAMXXXX/ancillary
Label Datatype
(Dimensions)
long_name units
source
description
master_time_epoch FLOAT64
(1)
Master time epoch seconds
Number of GPS seconds between the GPS epoch (1980-01-06T00:00:00Z) and the GEDI epoch (2018-01-01T00:00:00Z). Add this value to delta_time parameters to compute full GPS seconds (relative to the GPS epoch) for each data point.
Group: /BEAMXXXX/CLK
description (Attribute) Clock calibration data ${DESCRIPTION}
Program_Version (Attribute) Version number of the DU_clk_f_calib software used to create the L1A file.
Label Datatype
(Dimensions)
long_name units
source
description
dFF FLOAT64
(MT)
dF/F Hz/Hz
Derived from clock housekeeping
"Instantaneous" change in clock frequency correction, independent of frequency. delta_time
fit FLOAT64
(MT)
dF/F fit Hz/Hz
Derived
Linear fit to dF/F. delta_time
interp UINT8
(MT)
Interpolation flag boolean
Derived
Flag if dF/F had to be interpolated (no HK CLK data). delta_time
range_bin0_m FLOAT64
(MT)
Range bin 0 meters meters
Derived
2-way range for first bin, converted from bins to meters using speed of light (299792458 m/s) and frequency correction. If use_linear_fit=1, fit dataset is used, else dFF dataset is used. delta_time
range_lastbin_m FLOAT64
(MT)
Range last bin meters meters
Derived
2-way range for last bin, converted from bins to meters using speed of light (299792458 m/s) and frequency correction. If use_linear_fit=1, fit dataset is used, else dFF dataset is used. delta_time
Group: /BEAMXXXX/CLK/ancillary
Label Datatype
(Dimensions)
long_name units
source
description
I_warmup FLOAT64
(1)
Current warmup amps
Configuration
Specified warm-up current.
calibration_time UINT8
(1)
Calibration time seconds
Configuration
Calibration/integration time of instantaneous dF/F.
f_nom FLOAT64
(1)
Frequency nominal Hz
Derived
Nominal frequency for ranges.
f_nom_pll FLOAT64
(1)
Frequency nominal PLL Hz
Configuration
Nominal frequency of PLL.
f_nom_pll_pecl FLOAT64
(1)
Frequency nominal PLL PECL Hz
Configuration
Nominal frequency of the PLL PECL clock.
f_nom_slope FLOAT64
(1)
Frequency nominal slope Hz/sec
Configuration
Default change in nominal frequency over time. Used in computing the corrected frequency if use_f_nom is true.
f_nom_tcxo FLOAT64
(1)
Frequency nominal TCXO Hz
Configuration
Nominal frequency of TXCO.
fit_bias FLOAT64
(1)
Fit bias seconds
Derived
Linear fit bias used for range calculation (pll, pll_pecl).
fit_desc STRING
(1)
Fit description N/A
Derived
Description of linear fit used for range calculation (pll, pll_pecl).
fit_edit_multiplier FLOAT64
(1)
Fit edit multiplier N/A
Configuration
Editing multiplier for dF/F fit.
fit_epoch FLOAT64
(1)
Fit epoch seconds
Derived
Linear fit epoch (master time) used for range calculation.
fit_max_iter FLOAT64
(1)
Fit maximum iterations iterations
Configuration
Maximum iterations for dF/F fit.
fit_tolerance FLOAT64
(1)
Fit tolerance percent/100
Configuration
Maximum fit tolerance as a percentage of standard deviation of the residuals.
fit_trend FLOAT64
(1)
Fit trend dF/F / sec
Derived
Linear fit trend used for range calculation.
max_valid_rms FLOAT64
(1)
Maximum valid RMS of dF/F fit Hz/sec
Configuration
Maximum allowed RMS of instrument housekeeping data derived dF/F linear fit. If the final RMS of the linear fit is greater than this value, the configuration specified nominal frequency and slope are used to compute the corrected frequency for computing ranges in meters.
orbit_bounds FLOAT64
(2)
Orbit bounds seconds
Configuration
Orbit bounds (GPS seconds).
sig_N UINT8
(1)
Sigma N counter
Configuration
Sigma of the rolling counter, essentially discretization error.
sig_dT FLOAT64
(1)
Sigma dT seconds
Configuration
Sigma dT, from GPS processing.
use_f_nom UINT8
(1)
Use nominal frequency boolean
Configuration
If true, use nominal frequency and frequency slope values specified in the configuration file to determine corrected frequency. If false, the corrected frequency is computed using the instrument housekeeping data.
use_headersecs UINT8
(1)
Use CCSDS packet header time boolean
Configuration
If true, use the CCDS packet header time instead of the GPS time within the instrument housekeeping packets when matching housekeeping observations to science data.
use_linear_fit UINT8
(1)
Use linear fit boolean
Configuration
Flag to indicate if linear fit is used in calculation of ranges.
use_master_time UINT8
(1)
Use master time boolean
Configuration
If true, use of master observation time tag to match data to housekeeping observations. If false, GPS observation time tags are used.
Group: /BEAMXXXX/INST_HK
description (Attribute) Instrument housekeeping data. Recorded at 1 second interval on board and repeated to beam frequency. ${DESCRIPTION}
Program_Version (Attribute) Version number of the process_L1A_INSTHK software used to create the L1A file.
Label Datatype
(Dimensions)
long_name units
source
description
adc_t FLOAT64
(MT)
ADC temperature Degrees Celsius
Instrument housekeeping
ADC temperature diode delta_time
adccal FLOAT64
(MT)
ADC calibration microseconds
Instrument housekeeping
Science RT ADC calibration (used everytime DU is power cycled or when termal condition changes). delta_time
bgngate_frac FLOAT64
(MT)
Background noise gate fraction 0.1 microseconds
Instrument housekeeping
t-time for start of Background Noise Gate (0-9). delta_time
bgngate_usec FLOAT64
(MT)
Background noise gate microseconds microseconds
Instrument housekeeping
t-time for start of Background Noise Gate in microseconds. delta_time
dma_det_t FLOAT64
(MT)
Detector module #1 detector temperature Degrees Celsius
Instrument housekeeping
Detector module #1 detector temperature on APD pedestal. delta_time
dma_gain_mode FLOAT64
(MT)
Detector module #1 gain mode flag
Instrument housekeeping
Detector module #1 gain mode. 0=high, 1=low. delta_time
dma_htr_i FLOAT64
(MT)
Detector module #1 detector heater current microamps
Instrument housekeeping
Detector module #1 detector heater current. delta_time
dma_hv_i FLOAT64
(MT)
Detector module #1 high voltage current microamps
Instrument housekeeping
Detector module #1 high voltage current draw by APD at bias voltage. delta_time
dma_hvbias_cmd FLOAT64
(MT)
Detector module #1 high voltage bias commanded volts
Instrument housekeeping
Detector module #1 commanded high voltage bias voltage for APD bias. delta_time
dma_hvbias_meas FLOAT64
(MT)
Detector module #1 high voltage bias measured volts
Instrument housekeeping
Detector module #1 measured high voltage bias voltage for APD bias. delta_time
dma_hvbias_setpt FLOAT64
(MT)
Detector module #1 high voltage bias setpoint volts
Instrument housekeeping
Detector module #1 high voltage bias setpoint. delta_time
dma_n5p0_v FLOAT64
(MT)
Detector module #1 -5V volts
Instrument housekeeping
Detector module #1 DPU -5V power supply voltage. delta_time
dma_p12_v FLOAT64
(MT)
Detector module #1 +12V volts
Instrument housekeeping
Detector module #1 DPU +12V power supply voltage. delta_time
dma_p5p0_v FLOAT64
(MT)
Detector module #1 +5V volts
Instrument housekeeping
Detector module #1 DPU +5V power supply voltage. delta_time
dmb_det_t FLOAT64
(MT)
Detector module #2 detector temperature Degrees Celsius
Instrument housekeeping
Detector module #2 detector temperature on APD pedestal. delta_time
dmb_gain_mode FLOAT64
(MT)
Detector module #2 gain mode flag
Instrument housekeeping
Detector module #2 gain mode. 0=high, 1=low. delta_time
dmb_htr_i FLOAT64
(MT)
Detector module #2 detector heater current microamps
Instrument housekeeping
Detector module #2 detector heater current. delta_time
dmb_hv_i FLOAT64
(MT)
Detector module #2 high voltage current microamps
Instrument housekeeping
Detector module #2 high voltage current draw by APD at bias voltage. delta_time
dmb_hvbias_cmd FLOAT64
(MT)
Detector module #2 high voltage bias commanded volts
Instrument housekeeping
Detector module #2 commanded high voltage bias voltage for APD bias. delta_time
dmb_hvbias_meas FLOAT64
(MT)
Detector module #2 high voltage bias measured volts
Instrument housekeeping
Detector module #2 measured high voltage bias voltage for APD bias. delta_time
dmb_hvbias_setpt FLOAT64
(MT)
Detector module #2 high voltage bias setpoint volts
Instrument housekeeping
Detector module #2 high voltage bias setpoint. delta_time
dmb_n5p0_v FLOAT64
(MT)
Detector module #2 -5V volts
Instrument housekeeping
Detector module #2 DPU -5V power supply voltage. delta_time
dmb_p12_v FLOAT64
(MT)
Detector module #2 +12V volts
Instrument housekeeping
Detector module #2 DPU +12V power supply voltage. delta_time
dmb_p5p0_v FLOAT64
(MT)
Detector module #2 +5V volts
Instrument housekeeping
Detector module #2 DPU +5V power supply voltage. delta_time
interp UINT8
(MT)
Interpolated boolean
Derived
Flag if instrument HK data was interpolated for this time (used HK data from last HK data present). delta_time
interp_even_odd_nsemean UINT8
(MT)
Interpolated even odd noise mean boolean
Derived
Flag if instrument even and odd mean noise HK data was interpolated for this time (used HK data from last HK data present). delta_time
last_lzr_mode FLOAT64
(MT)
Last laser mode flag
Instrument housekeeping
Laser mode before current laser mode. 0=standby, 1=warmup, 2=wlkbk, 3=operational. delta_time
lzr_mode FLOAT64
(MT)
Laser mode flag
Instrument housekeeping
Current laser mode. 0=standby, 1=warmup, 2=wlkbk, 3=operational. delta_time
nsemean FLOAT64
(MT)
Noise mean counts from the ADC
Instrument housekeeping
Noise mean of the beam's detector channel. delta_time
nsemean_even FLOAT64
(MT)
Noise mean even counts from the ADC
Instrument housekeeping
Noise mean of the beam's detector channel from even sub-converter. delta_time
nsemean_odd FLOAT64
(MT)
Noise mean odd counts from the ADC
Instrument housekeeping
Noise mean of the beam's odd sub-converter. delta_time
rxgate_frac FLOAT64
(MT)
RX gate fraction 0.1 microseconds
Instrument housekeeping
t-time offset for receive gate fraction (0-9). delta_time
rxgate_usec FLOAT64
(MT)
RX gate microseconds microseconds
Instrument housekeeping
t-time offset for receive gate. delta_time
rxgateadj_frac FLOAT64
(MT)
RX gate adjust fraction 0.1 microseconds
Instrument housekeeping
t-time offset for receive gate fraction (0-9). delta_time
rxgateadj_usec FLOAT64
(MT)
RX gate adjust microseconds microseconds
Instrument housekeeping
t-time offset for receive gate. delta_time
time_since_last_lzr_mode FLOAT64
(MT)
Time since last laser mode seconds
Derived
Time laser has been in current laser mode. Current looks at just the 15 minutes before start of file (so maximum time on at start of file is 15 minutes). delta_time
time_since_valid_HK FLOAT64
(MT)
Time since last valid HK value seconds
Derived
Number of seconds the HK data has needed to be interpolated. delta_time
time_since_valid_even_odd_mean_HK FLOAT64
(MT)
Time since last valid HK value seconds
Derived
Number of seconds the even odd nsemean HK data has needed to be interpolated. delta_time
txgate_frac FLOAT64
(MT)
TX gate fraction 0.1 microseconds
Instrument housekeeping
t-time for start of laser transmit gate fraction (0-9). delta_time
txgate_usec FLOAT64
(MT)
TX gate microseconds microseconds
Instrument housekeeping
t-time for start of laser transmit gate. delta_time
Group: /BEAMXXXX/TX_PROCESSING
wp-average-waveform_githash (Attribute) Git commit hash of the wp-average-waveform software used to create the L1A file
wp-average-waveform_version (Attribute) Version number of the wp-average-waveform software used to create the L1A file
wp-flags_githash (Attribute) Git commit hash of the wp-flags software used to create the L1A file
wp-flags_version (Attribute) Version number of the wp-flags software used to create the L1A file
wp-gaussian-fit_githash (Attribute) Git commit hash of the wp-gaussian-fit software used to create the L1A file
wp-gaussian-fit_version (Attribute) Version number of the wp-gaussian-fit software used to create the L1A file
Label Datatype
(Dimensions)
long_name units
source
description
range_bin0 FLOAT64
(MT)
Range bin 0 sample intervals (~1 ns)
Derived
Range in sample intervals (~1 ns) from the center of the TX pulse to the start of the RX window. delta_time
range_bin0_error FLOAT64
(MT)
Range bin 0 error sample intervals (~1 ns)
Derived
Error on range_bin0. delta_time
range_lastbin FLOAT64
(MT)
Range last bin sample intervals (~1 ns)
Derived
Range in sample intervals (~1 ns) from the center of the TX pulse to the end of the RX window. delta_time
range_lastbin_error FLOAT64
(MT)
Range last bin error sample intervals (~1 ns)
Derived
Error on range_lastbin. delta_time
rx_energy FLOAT64
(MT)
RX energy sample number (~1ns) multiplied by counts from the ADC
Derived
Integrated energy in RX waveform after subtracting the noise mean. delta_time
short_term_av_end_time_frac FLOAT64
(MT)
Short term average end time fraction seconds
Derived
End time for span over which the average waveform was computed (fractional part). delta_time
short_term_av_end_time_int INT64
(AV)
Short term average end time integer seconds
Derived
End time for span over which the average waveform was computed (integer part, seconds since master_time_epoch).
short_term_av_start_time_frac FLOAT64
(AV)
Short term average start time fraction seconds
Derived
End time for span over which the average waveform was computed (fractional part).
short_term_av_start_time_int INT64
(AV)
Short term average start time integer seconds
Derived
Start time for span over which the average waveform was computed (integer part, seconds since master_time_epoch)
short_term_av_tx_waveform FLOAT64
(AV,UNLIMITED)
Short term average TX waveform counts from the ADC
Derived
Average waveforms between the short term average start and end time [2D array]. One per laser turn-on period.
tx_ampflag INT32
(MT)
TX amplitude flag boolean
Derived
Amplitude flag is set when TX waveform amplitude is too weak or too close to saturation. Limits are defined in tx_ampbounds_ul and tx_ampbounds_ll. delta_time
tx_cntsat INT64
(MT)
TX saturation count sample intervals (~1 ns)
Derived
Maximum number of sequential saturated sample intervals (~1 ns) in the TX waveform. delta_time
tx_egamplitude FLOAT64
(MT)
TX extended Gaussian amplitude counts from the ADC
Derived
Amplitude of the extended Gaussian fit to the TX waveform. delta_time
tx_egamplitude_error FLOAT64
(MT)
TX extended Gaussian amplitude error counts from the ADC
Derived
Error on tx_egamplitude. delta_time
tx_egbias FLOAT64
(MT)
TX extended Gaussian bias counts from the ADC
Derived
Bias of the extended Gaussian fit to the TX waveform. delta_time
tx_egbias_error FLOAT64
(MT)
TX extended Gaussian bias error counts from the ADC
Derived
Error on tx_egbias. delta_time
tx_egcenter FLOAT64
(MT)
TX extended Gaussian center sample intervals (~1 ns)
Derived
Center of the extended Gaussian fit to the TX waveform. delta_time
tx_egcenter_error FLOAT64
(MT)
TX extended Gaussian center error sample intervals (~1 ns)
Derived
Error on tx_egcenter_error. delta_time
tx_egchisq FLOAT64
(MT)
TX extended Gaussian chi squared N/A
Derived
Residual RSS of extended Gaussian fit to the TX waveform. delta_time
tx_egflag INT32
(MT)
TX extended Gaussian flag flag
Derived
Extended Gaussian fit status flag. 1=convergence in chi2 value, 2=convergence in parameter value, 3=convergence in chi2 and parameter values, 4=convergence in orthogonality, 5=maximum number of iterations reached, 6=ftol too small (no further improvement), 7=xtol too small (no further improvement), 8=gtol too small (no further improvement). delta_time
tx_eggamma FLOAT64
(MT)
TX extended Gaussian gamma N/A
Derived
Gamma value of the extended Gaussian fit to the TX waveform. delta_time
tx_eggamma_error FLOAT64
(MT)
TX extended Gaussian gamma error N/A
Derived
Error on tx_eggamma. delta_time
tx_egiters INT32
(MT)
TX extended Gaussian iterations iterations
Derived
Number of iterations to converge extended Gaussian fit to TX waveform. delta_time
tx_egsigma FLOAT64
(MT)
TX extended Gaussian sigma sample intervals (~1 ns)
Derived
Sigma of the extended Gaussian fit to the TX waveform. delta_time
tx_egsigma_error FLOAT64
(MT)
TX extended Gaussian sigma error sample intervals (~1 ns)
Derived
Error on tx_egsigma. delta_time
tx_energy FLOAT64
(MT)
TX energy sample number (~1ns) multiplied by counts from the ADC
Derived
Integrated energy in TX waveform after subtracting the noise mean. delta_time
tx_gamplitude FLOAT64
(MT)
TX Gaussian amplitude counts from the ADC
Derived
Amplitude of the Gaussian fit to the TX waveform. delta_time
tx_gamplitude_error FLOAT64
(MT)
TX Gaussian amplitude error counts
Derived
Error on tx_gamplitude. delta_time
tx_gbias FLOAT64
(MT)
TX Gaussian bias counts from the ADC
Derived
Bias of the Gaussian fit to the TX waveform. delta_time
tx_gbias_error FLOAT64
(MT)
TX Gaussian bias error counts from the ADC
Derived
Error on tx_gbias. delta_time
tx_gchisq FLOAT64
(MT)
TX Gaussian chi squared N/A
Derived
Residual RSS of Gaussian fit to the TX waveform. delta_time
tx_gflag INT32
(MT)
TX Gaussian flag flag
Derived
Gaussian fit status flag. 1=convergence in chi2 value, 2=convergence in parameter value, 3=convergence in chi2 and parameter values, 4=convergence in orthogonality, 5=maximum number of iterations reached, 6=ftol too small (no further improvement), 7=xtol too small (no further improvement), 8=gtol too small (no further improvement). delta_time
tx_giters INT32
(MT)
TX Gaussian iterations iterations
Derived
Number of iterations to converge Gaussian fit to TX waveform. delta_time
tx_gloc FLOAT64
(MT)
TX Gaussian location sample intervals (~1 ns)
Derived
Location (mean) of the Gaussian fit to the TX waveform. delta_time
tx_gloc_error FLOAT64
(MT)
TX Gaussian location error sample intervals (~1 ns)
Derived
Error on tx_gloc. delta_time
tx_gwidth FLOAT64
(MT)
TX Gaussian width sample intervals (~1 ns)
Derived
Width of the Gaussian fit to the TX waveform. delta_time
tx_gwidth_error FLOAT64
(MT)
TX Gaussian width error sample intervals (~1 ns)
Derived
Error on tx_gwidth. delta_time
tx_maxamp FLOAT64
(MT)
TX maximum amplitude counts from the ADC
Derived
Maximum amplitude in each TX waveform. delta_time
tx_minamp FLOAT64
(MT)
TX minimum amplitude counts from the ADC
Derived
Minimum amplitude in each TX waveform. delta_time
tx_peakloc INT64
(MT)
TX peak location sample intervals (~1 ns)
Derived
Location of the bin containing the point with the maximum amplitude. delta_time
tx_pulseflag INT32
(MT)
TX pulse flag boolean
Derived
Set to 1 if a pulse is detected in the TX waveform. delta_time
tx_ringflag INT32
(MT)
TX ring flag boolean
Derived
Set to 1 if there is a ringing pattern in the TX waveform. delta_time
tx_satflag INT32
(MT)
TX saturation flag boolean
Derived
Set to 1 if the TX waveform has been clipped. Clipping is defined as an amplitude exceeding 4095. delta_time
tx_sd_nw FLOAT64
(MT)
Noise standard deviation, floating point. counts from the ADC
Derived
Noise standard deviation, floating point. delta_time
Group: /BEAMXXXX/TX_PROCESSING/ancillary
Label Datatype
(Dimensions)
long_name units
source
description
centerbin INT64
(1)
Center bin sample intervals (~1 ns)
Configuration
The center position for computing the TX pulse waveform average.
good_laser_mode INT32
(1)
Good laser mode N/A
Configuration
Only shots with this laser mode number were used to compute average waveforms.
min_laser_on_time_seconds FLOAT64
(1)
Minimum laser on time in seconds seconds
Configuration
Time to ignore at the start of a turn on period when computing an average waveform.
mpfit_max_func_evals INT64
(1)
MPFit maximum function evaluations counter
Configuration
Maximum number of function evalutions allowed for fitting the Gaussian/extended Gaussian to the TX waveform.
mpfit_maxiters INT64
(1)
MPFit maximum iterations counter
Configuration
Maximum number of iterations allowed for fitting the Gaussian/extended Gaussian to the TX waveform.
mpfit_tolerance FLOAT64
(1)
MPFit tolerance N/A
Configuration
Convergence tolerance when fitting the Gaussian/extended Gaussian to the TX waveform.
resolution FLOAT64
(1)
Resolution N/A
Configuration
Waveform resampling factor for waveform averaging.
saturated_amp INT64
(1)
Saturated amplitude counts from the ADC
Configuration
Waveform amplitudes above this value are considered saturated.
tx_ampbounds_ll INT64
(1)
TX amplitude bounds lower level counts from the ADC
Configuration
Lower allowable waveform peak above the mean noise. Used to set tx_ampflag.
tx_ampbounds_ul INT64
(1)
TX amplitude bounds upper level counts from the ADC
Configuration
Upper allowable waveform value when subtracted from the saturation amplitude. Used to set tx_ampflag.
tx_constraint_egamplitude_lower FLOAT64
(1)
TX extended Gaussian lower amplitude constraint counts from the ADC
Configuration
Lower allowable limit for the TX extended Gaussian fit amplitude.
tx_constraint_egamplitude_upper FLOAT64
(1)
TX extended Gaussian upper amplitude constraint counts from the ADC
Configuration
Upper allowable limit for the TX extended Gaussian fit amplitude.
tx_constraint_eggamma_lower FLOAT64
(1)
TX extended Gaussian lower gamma constraint
Configuration
Lower allowable limit for the TX extended Gaussian fit gamma parameter.
tx_constraint_eggamma_upper FLOAT64
(1)
TX extended Gaussian upper gamma constraint
Configuration
Upper allowable limit for the TX extended Gaussian fit gamma parameter.
tx_constraint_egloc_lower FLOAT64
(1)
TX extended Gaussian lower location constraint sample intervals (~1 ns)
Configuration
Lower allowable limit for the TX extended Gaussian fit location.
tx_constraint_egloc_upper FLOAT64
(1)
TX extended Gaussian upper location constraint sample intervals (~1 ns)
Configuration
Upper allowable limit for the TX extended Gaussian fit location.
tx_constraint_egwidth_lower FLOAT64
(1)
TX extended Gaussian lower width constraint sample intervals (~1 ns)
Configuration
Lower allowable limit for the TX extended Gaussian fit width.
tx_constraint_egwidth_upper FLOAT64
(1)
TX extended Gaussian upper width constraint sample intervals (~1 ns)
Configuration
Upper allowable limit for the TX extended Gaussian fit width.
tx_constraint_gamplitude_lower FLOAT64
(1)
TX Gaussian lower amplitude constraint counts from the ADC
Configuration
Lower allowable limit for the TX Gaussian fit amplitude.
tx_constraint_gamplitude_upper FLOAT64
(1)
TX Gaussian upper amplitude constraint counts from the ADC
Configuration
Upper allowable limit for the TX Gaussian fit amplitude.
tx_constraint_gloc_lower FLOAT64
(1)
TX Gaussian lower location constraint sample intervals (~1 ns)
Configuration
Lower allowable limit for the TX Gaussian fit location.
tx_constraint_gloc_upper FLOAT64
(1)
TX Gaussian upper location constraint sample intervals (~1 ns)
Configuration
Upper allowable limit for the TX Gaussian fit location.
tx_constraint_gwidth_lower FLOAT64
(1)
TX Gaussian lower width constraint sample intervals (~1 ns)
Configuration
Lower allowable limit for the TX Gaussian fit width.
tx_constraint_gwidth_upper FLOAT64
(1)
TX Gaussian upper width constraint counts from the ADC
Configuration
Upper allowable limit for the TX Gaussian fit width.
tx_estimate_bias INT32
(1)
TX estimate bias boolean
Configuration
If set to 1, a bias was estimated as part of the Gaussian/extended gaussian fits. Set to 0 otherwise.
tx_mean_noise_level FLOAT64
(1)
TX mean noise level counts from the ADC
Configuration
If amplitude is less than this value, no gaussian fitting is performed to the TX waveform.
tx_pulsethresh INT64
(1)
TX pulse threshold counts from the ADC
Configuration
If the amplitude is greater than the standard deviation multiplied by tx_pulsethresh, a TX waveform pulse exists.
tx_ringthresh INT64
(1)
TX ring threshold counts from the ADC
Configuration
Threshold for post pulse minimum to indicate problematic levels of ringing in the detector.
tx_smoothwidth FLOAT64
(1)
TX smoothing width sample intervals (~1 ns)
Configuration
Smoothing width to apply to waveforms before Gaussian/extended Gaussian fitting.
Group: /BEAMXXXX/geolocation
description (Attribute) Geolocation ${DESCRIPTION}
vegas_githash (Attribute) Git commit hash of the VEGAS software used to create the L1A file
vegas_version (Attribute) Version number of the VEGAS software used to create the L1A file
Label Datatype
(Dimensions)
long_name units
source
description
altitude_instrument FLOAT64
(MT)
Instrument altitude meters
Derived
Height of the instrument diffractive optical element (DOE) above the WGS84 ellipsoid. delta_time latitude_instrument longitude_instrument delta_time
altitude_instrument_error FLOAT64
(MT)
Instrument altitude error meters
Derived
Error on altitude_instrument. delta_time latitude_instrument longitude_instrument delta_time
bounce_time_offset_bin0 FLOAT64
(MT)
Bounce time offset bin 0 seconds
Derived
The difference between the transmit time and the time at the start of the RX window delta_time latitude_bin0 longitude_bin0 delta_time
bounce_time_offset_bin0_error FLOAT64
(MT)
Bounce time offset bin 0 error seconds
Derived
Error on bounce_time_offset_bin0. delta_time latitude_bin0 longitude_bin0 delta_time
bounce_time_offset_lastbin FLOAT64
(MT)
Bounce time offset last bin seconds
Derived
The difference between the transmit time and the time at the end of the RX window delta_time latitude_lastbin longitude_lastbin delta_time
bounce_time_offset_lastbin_error FLOAT64
(MT)
Bounce time offset last bin error seconds
Derived
Error on bounce_time_offset_lastbin. delta_time latitude_lastbin longitude_lastbin delta_time
degrade INT8
(MT)
Degrade flag
Derived
Greater than zero if the shot occurs during a degrade period, zero otherwise. delta_time
delta_time FLOAT64
(MT)
Delta time seconds since 2018-01-01
Derived
Transmit time of the shot, measured in seconds from the master_time_epoch. By adding the offset contained within /BEAMXXXX/ancillary/master_time_epoch to delta_time, the time in GPS seconds relative to the GPS epoch can be computed. Equivalent to /BEAMXXXX/master_int+/BEAMXXXX/master_frac. delta_time latitude_bin0 longitude_bin0
digital_elevation_model FLOAT64
(MT)
Digital elevation model meters
TanDEM-X DEM
Digital elevation model height above the WGS84 ellipsoid. Interpolated at latitude_bin0 and longitude_bin0 from the TandemX 90m product. delta_time latitude_bin0 longitude_bin0 delta_time -999999.0
elevation_bin0 FLOAT64
(MT)
Bounce elevation bin 0 meters
Derived
Height of the start of the RX window, relative to the WGS-84 ellipsoid. Includes corrections due to the range bias, atmospheric path delay, solid Earth tides, ocean loading, ocean pole tide, and solid Earth pole tide. delta_time latitude_bin0 longitude_bin0 delta_time
elevation_bin0_error FLOAT64
(MT)
Bounce elevation bin 0 error meters
Derived
Error on elevation_bin0. delta_time latitude_bin0 longitude_bin0 delta_time
elevation_lastbin FLOAT64
(MT)
Bounce elevation last bin meters
Derived
Height of the end of the RX window, relative to the WGS-84 ellipsoid. Includes corrections due to the range bias, atmospheric path delay, solid Earth tides, ocean loading, ocean pole tide, and solid Earth pole tide. delta_time latitude_lastbin longitude_lastbin delta_time
elevation_lastbin_error FLOAT64
(MT)
Bounce elevation last bin error meters
Derived
Error on elevation_lastbin. delta_time latitude_lastbin longitude_lastbin delta_time
latitude_bin0 FLOAT64
(MT)
Bounce latitude bin 0 degrees
Derived
Latitude of the start of the RX window. delta_time longitude_bin0 delta_time
latitude_bin0_error FLOAT64
(MT)
Bounce latitude bin 0 error degrees
Derived
Error on latitude_bin0. delta_time latitude_bin0 longitude_bin0 delta_time
latitude_lastbin FLOAT64
(MT)
Bounce latitude last bin degrees
Derived
Latitude of the end of the RX window. delta_time longitude_lastbin delta_time
latitude_lastbin_error FLOAT64
(MT)
Bounce latitude last bin error degrees
Derived
Error on latitude_lastbin. delta_time latitude_lastbin longitude_lastbin delta_time
latitude_instrument FLOAT64
(MT)
Instrument latitude degrees
Derived
Latitude of the instrument diffractive optical element (DOE) at laser transmit time. delta_time
latitude_instrument_error FLOAT64
(MT)
Instrument latitude error degrees
Derived
Error on latitude_instrument. delta_time
local_beam_azimuth FLOAT64
(MT)
Local beam azimuth radians
Derived
Azimuth of the unit pointing vector for the laser in the local ENU frame. The angle is measured from North and positive towards East. delta_time latitude_bin0 longitude_bin0 delta_time
local_beam_azimuth_error FLOAT64
(MT)
Local beam azimuth error radians
Derived
Error on local_beam_azimuth. delta_time latitude_bin0 longitude_bin0 delta_time
local_beam_elevation FLOAT64
(MT)
Local beam elevation radians
Derived
Elevation of the unit pointing vector for the laser in the local ENU frame. The angle is measured from East-North plane and positive towards Up. delta_time latitude_bin0 longitude_bin0 delta_time
local_beam_elevation_error FLOAT64
(MT)
Local beam elevation error radians
Derived
Error on local_beam_elevation. delta_time latitude_bin0 longitude_bin0 delta_time
longitude_bin0 FLOAT64
(MT)
Bounce longitude bin 0 degrees
Derived
Longitude of the start of the RX window. delta_time latitude_bin0 delta_time
longitude_bin0_error FLOAT64
(MT)
Bounce longitude bin 0 error degrees
Derived
Error on longitude_bin0. delta_time latitude_bin0 longitude_bin0 delta_time
longitude_lastbin FLOAT64
(MT)
Bounce longitude last bin degrees
Derived
Longitude of the end of the RX window. delta_time latitude_lastbin delta_time
longitude_lastbin_error FLOAT64
(MT)
Bounce longitude last bin error degrees
Derived
Error on longitude_lastbin. delta_time latitude_lastbin longitude_lastbin delta_time
longitude_instrument FLOAT64
(MT)
Instrument longitude degrees
Derived
Longitude of the instrument diffractive optical element (DOE) at laser transmit time. delta_time
longitude_instrument_error FLOAT64
(MT)
Instrument longitude error degrees
Derived
Error on longitude_instrument. delta_time
mean_sea_surface FLOAT64
(MT)
Mean sea surface meters
DTU15
Mean sea surface height above the WGS84 ellipsoid, includes the geoid. Interpolated at latitude_bin0 and longitude_bin0 from DTU15. delta_time latitude_bin0 longitude_bin0 delta_time
neutat_delay_derivative_bin0 FLOAT64
(MT)
(Neutral atmosphere delay)/dh bin 0 meters/meter
Derived
Change in neutral atmospheric delay per height change for the start of the RX window. delta_time latitude_bin0 longitude_bin0 delta_time
neutat_delay_derivative_lastbin FLOAT64
(MT)
(Neutral atmosphere delay)/dh last bin meters/meter
Derived
Change in neutral atmospheric delay per height change for the end of the RX window. delta_time latitude_lastbin longitude_lastbin delta_time
neutat_delay_total_bin0 FLOAT64
(MT)
Total neutral atmospheric delay bin 0 meters
Derived
Total neutral atmosphere delay correction (wet+dry) from the TX pulse to the start of the RX window (computed according to ICESat-2 ATL03A ATDB). This value is subtracted from the range during geolocation. delta_time latitude_bin0 longitude_bin0 delta_time
neutat_delay_total_lastbin FLOAT64
(MT)
Total neutral atmospheric delay last bin meters
Derived
Total neutral atmosphere delay correction (wet+dry) from the TX pulse to the end of the RX window (computed according to ICESat-2 ATL03A ATDB). This value is subtracted from the range during geolocation. delta_time latitude_lastbin longitude_lastbin delta_time
range_bias_correction FLOAT32
(MT)
Range bias correction meters
Derived
The range bias applied to the range measurement. This value is subtracted from the range to get the corrected range. delta_time latitude_bin0 longitude_bin0 delta_time
shot_number FLOAT64
(MT)
Shot number counter
Derived
Unique shot ID. delta_time latitude_bin0 longitude_bin0 delta_time
solar_azimuth FLOAT32
(MT)
Solar azimuth degrees
Derived
The azimuth of the sun position vector from the laser bounce point position in the local ENU frame. The angle is measured from North and is positive towards East. delta_time latitude_bin0 longitude_bin0 delta_time
solar_elevation FLOAT32
(MT)
Solar elevation degrees
Derived
The elevation of the sun position vector from the laser bounce point position in the local ENU frame. The angle is measured from the East-North plane and is positive Up. delta_time latitude_bin0 longitude_bin0 delta_time
surface_type INT8
(5,MT)
Surface type boolean
ICESat-2 surface type mask
Flags describing which surface types this interval is associated with. 0=not type, 1=is type. Order of array is land, ocean, sea ice, land ice, inland water. delta_time latitude_bin0 longitude_bin0 delta_time
Group: /BEAMXXXX/geophys_corr
description (Attribute) Geophysical corrections ${DESCRIPTION}
vegas_githash (Attribute) Git commit hash of the VEGAS software used to create the L1A file
vegas_version (Attribute) Version number of the VEGAS software used to create the L1A file
Label Datatype
(Dimensions)
long_name units
source
description
delta_time FLOAT64
(MT)
Delta time seconds since 2018-01-01
Derived
Transmit time of the shot, measured in seconds from the master_time_epoch. By adding the offset contained within /BEAMXXXX/ancillary/master_time_epoch to delta_time, the time in GPS seconds relative to the GPS epoch can be computed. Equivalent to /BEAMXXXX/master_int+/BEAMXXXX/master_frac.
dynamic_atmosphere_correction FLOAT64
(MT)
Dynamic atmosphere correction meters
MOG2D
Dynamic Atmospheric Correction (DAC) includes inverted barometer (IB) effect. delta_time
geoid FLOAT64
(MT)
Geoid meters
Derived from EGM2008
Geoid height above WGS-84 reference ellipsoid (range -107 to 86m). Not applied on the product. delta_time
tide_earth FLOAT64
(MT)
Earth tide meters
IERS conventions (2010)
Solid Earth tides delta_time
tide_load FLOAT64
(MT)
Load tide meters
GOT 4.8
Load Tide - Local displacement due to Ocean Loading (-6 to 0 cm). delta_time
tide_ocean FLOAT64
(MT)
Ocean tide meters
GOT 4.8
Ocean Tides including diurnal and semi-diurnal (harmonic analysis), and longer period tides (dynamic and self-consistent equilibrium). delta_time
tide_ocean_pole FLOAT64
(MT)
Ocean pole tide meters
IERS conventions (2010)
Oceanic surface rotational deformation due to polar motion (-2 to 2 mm). delta_time
tide_pole FLOAT64
(MT)
Solid earth pole tide meters
IERS conventions (2010)
Solid Earth Pole Tide -- Rotational deformation due to polar motion (-1.5 to 1.5 cm). delta_time
Group: /BEAMXXXX/land_surface_data
Label Datatype
(Dimensions)
long_name units
source
description
landsat_treecover FLOAT64
(MT)
Landsat tree canopy cover percent
Derived from treecover2010_v3 geotiff tiles
Tree cover in the year 2010, defined as canopy closure for all vegetation taller than 5m in height (Hansen et al.). Encoded as a percentage per output grid cell. ../geolocation/delta_time ../geolocation/latitude_bin0 ../geolocation/longitude_bin0 delta_time -9999.0
modis_treecover FLOAT64
(MT)
MODIS tree cover percent
Derived from MODIS geotiff tiles
Percent tree cover from MODIS data. Interpolated at latitude_bin0 and longitude_bin0. doi:10.5067/MODIS/MOD44B.006 ../geolocation/delta_time ../geolocation/latitude_bin0 ../geolocation/longitude_bin0 delta_time -9999.0
modis_treecover_sd FLOAT64
(MT)
MODIS tree cover standard deviation percent
Derived from MODIS geotiff tiles
Percent tree cover standard deviation from MODIS data. Interpolated at latitude_bin0 and longitude_bin0. doi:10.5067/MODIS/MOD44B.006 ../geolocation/delta_time ../geolocation/latitude_bin0 ../geolocation/longitude_bin0 delta_time -9999.0
modis_nonvegetated FLOAT64
(MT)
MODIS non-vegetated percent
Derived from MODIS geotiff tiles
Percent non-vegetated from MODIS data. Interpolated at latitude_bin0 and longitude_bin0. doi:10.5067/MODIS/MOD44B.006 ../geolocation/delta_time ../geolocation/latitude_bin0 ../geolocation/longitude_bin0 delta_time -9999.0
modis_nonvegetated_sd FLOAT64
(MT)
MODIS non-vegetated standard deviation percent
Derived from MODIS geotiff tiles
Percent non-vegetated standard deviation from MODIS data. Interpolated at latitude_bin0 and longitude_bin0. doi:10.5067/MODIS/MOD44B.006 ../geolocation/delta_time ../geolocation/latitude_bin0 ../geolocation/longitude_bin0 delta_time -9999.0