Make Trajectory Layer (Data Management Tools)
Summary
Generates a feature layer from selected variables in a trajectory file.
Usage
This tool can use trajectory data from satellite altimetry sensors such as Jason, Sentinel-3, CryoSat, and ICESat.
Different sensors may use different variable names for the same type of measurement. The Predefined Variables parameter combines data from sensors by mapping variable names to a common measurement type. For example, to merge sea surface height data from sentinel 3 and sentinel 6, specify the Sea Surface Height option. The tool will map the corresponding variables to a common variable in the output trajectory layer. See Trajectory type properties for a list of predefined variables for each available sensor.
Parameters
Label
Explanation
Data type
Input Trajectory File
The input trajectory file.
File; Trajectory Layer
Output Trajectory Layer
The output feature layer that contains the selected variables.
Trajectory Layer
Dimension Name
(Optional)
The dimension name. The first dimension is used by default.
String
Predefined Variables
(Optional)
Specifies the predefined variables that will be used for measurement for different sensor types.
Surface Backscatter Coefficient —A variable that contains Surface Backscatter Coefficient will be used.
Sea Surface Height —A variable that contains Sea Surface Height will be used.
Sea Surface Height Anomaly —A variable that contains Sea Surface Height Anomaly will be used.
Significant Wave Height —A variable that contains Significant Wave Height will be used.
Ocean Surface Backscatter Coefficient —A variable that contains Ocean Surface Backscatter Coefficient will be used.
Sea Ice Surface Elevation —A variable that contains Sea Ice Surface Elevation will be used.
Sea Ice Surface Height Anomaly —A variable that contains Sea Ice Surface Height Anomaly will be used.
Sea Ice Concentration —A variable that contains Sea Ice Concentration will be used.
Sea Ice Surface Backscatter Coefficient —A variable that contains Sea Ice Surface Backscatter Coefficient will be used.
Ice Sheet Surface Elevation —A variable that contains Ice Sheet Surface Elevation will be used.
Ice Sheet Surface Backscatter Coefficient —A variable that contains Ice Sheet Surface Backscatter Coefficient will be used.
Ice Surface Elevation —A variable that contains Ice Surface Elevation will be used.
Ice Surface Backscatter Coefficient —A variable that contains Ice Surface Backscatter Coefficient will be used.
Wind Speed —A variable that contains Wind Speed will be used.
Mean Sea Surface Elevation —A variable that contains Mean Sea Surface Elevation will be used.
String
Variables
(Optional)
The variables that will be included in the output layer. All variables are selected by default.
String
arcpy.management.MakeTrajectoryLayer(in_trajectory_file, out_trajectory_layer, {dimension}, {predefined_variables}, {variables})
Name
Explanation
Data type
in_trajectory_file
The input trajectory file.
File; Trajectory Layer
out_trajectory_layer
The output feature layer that contains the selected variables.
Trajectory Layer
dimension
(Optional)
The dimension name. The first dimension is used by default.
String
predefined_variables
[predefined_variables,...]
(Optional)
Specifies the predefined variables that will be used for measurement for different sensor types.
SIGMA0 —A variable that contains Surface Backscatter Coefficient will be used.
SSH —A variable that contains Sea Surface Height will be used.
SSHA —A variable that contains Sea Surface Height Anomaly will be used.
SWH —A variable that contains Significant Wave Height will be used.
SIGMA0_OCEAN —A variable that contains Ocean Surface Backscatter Coefficient will be used.
H_SEA_ICE —A variable that contains Sea Ice Surface Elevation will be used.
H_SEA_ICE_ANOMALY —A variable that contains Sea Ice Surface Height Anomaly will be used.
SIC —A variable that contains Sea Ice Concentration will be used.
SIGMA0_SEA_ICE —A variable that contains Sea Ice Surface Backscatter Coefficient will be used.
H_ICE_SHEET —A variable that contains Ice Sheet Surface Elevation will be used.
SIGMA0_ICE_SHEET —A variable that contains Ice Sheet Surface Backscatter Coefficient will be used.
H_ICE —A variable that contains Ice Surface Elevation will be used.
SIGMA0_ICE —A variable that contains Ice Surface Backscatter Coefficient will be used.
WS —A variable that contains Wind Speed will be used.
H_MSS —A variable that contains Mean Sea Surface Elevation will be used.
String
variables
[variables,...]
(Optional)
The variables that will be included in the output layer. All variables are selected by default.
String
Code sample
MakeTrajectoryLayer example (stand-alone script)
This example creates a trajectory layer from a Cryosat trajectory file.
# Import system modules
import arcpy
# Set local variables
in_trajectory_file = r"C:\data\Cryosat\CS_OFFL_SIR_LRM_2__20210301T000738_20210301T001611_D001.nc"
out_trajectory_layer = r"C:\data\Cryosat\trajectory_layer"
dimension = "CS_OFFL_SIR_LRM_2__20210301T000738_20210301T001611_D001_time_20_ku"
predefined_variables = "SSH;H_SEA_ICE"
variables = "height_1_20_ku"
# Run MakeTrajectoryLayer
trajectory_output = arcpy.management.MakeTrajectoryLayer(in_trajectory_file, out_trajectory_layer,
dimension, predefined_variables, variables)
Environments
This tool does not use any geoprocessing environments.
Licensing information
Basic: No
Standard: Yes
Advanced: Yes