Add Data To Trajectory Dataset (Data Management)

Summary

Adds trajectory data to an existing trajectory dataset.

Usage

• Supported trajectory types are Sentinel-3 SRAL, Sentinel-6, Cryosat-2, and ICESat-2.

• Supported input file formats are netCDF and HDF (.nc and .hdf files).

• The same type of measurement acquired by different sensors can be stored under different variable names. The Auxilary Inputs parameter can be used to automatically map different variable names to a common measurement type, which allows you to add and integrate data from multiple sensors. For example, to combine sea surface height data from both sentinel 3 and sentinel 6, under Auxilary Inputs, type PredefinedVariables in the Name column and SSH in the Value column. The tool will map the corresponding variables to a common variable when the data is added to the trajectory dataset.

Parameters

Dialog

Label	Explanation	Data Type
Trajectory Dataset	The trajectory dataset to which the data will be added.	Trajectory Layer
Trajectory Type	Specifies the data type that will be added. Cryosat-2—Cryosat-2 data will be added. ICESat-2—ICESat-2 data will be added. Sentinel-3 SRAL—Sentinel-3 SRAL data will be added. Sentinel-6—Sentinel-6 data will be added. This is the default.	Raster Type
Input Data	The input files or folder. The inputs can be netCDF or HDF (.nc or .hdf files).	Workspace; File; WCS Coverage; Image Service; Map Server; WMS Map; Table View; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Layer File; WMTS Layer
Input Data Filter (Optional)	The filter for the input data. The default will be determined by the Trajectory Type parameter value. Custom filter criteria can also be provided. For example, a value of STD_ will filter files that start with STD_ in the file name.	String
Include Sub Folders (Optional)	Specifies whether data in the Input Data subfolders will be searched and added. Checked—All subfolders will be searched and the data added. This is the default. Unchecked—Only the top-level folder will be searched and the data added.	Boolean
Auxiliary Inputs (Optional)	The properties that are determined by the Trajectory Type parameter value. Supported property names are ProductFilter, Frequency, PredefinedVariables, and Variables. For a list of supported values associated with each property name, see Trajectory type properties.	Value Table

Derived Output

Label	Explanation	Data Type
Trajectory Dataset	The updated trajectory dataset.	Trajectory Layer

Python

arcpy.management.AddDataToTrajectoryDataset(in_trajectory_dataset, trajectory_type, input_path, {filter}, {sub_folder}, {aux_inputs})

Name	Explanation	Data Type
in_trajectory_dataset	The trajectory dataset to which the data will be added.	Trajectory Layer
trajectory_type	Specifies the data type that will be added. Cryosat-2—Cryosat-2 data will be added. ICESat-2—ICESat-2 data will be added. Sentinel-3 SRAL—Sentinel-3 SRAL data will be added. Sentinel-6—Sentinel-6 data will be added.	Raster Type
input_path [input_path,...]	The input files or folder. The inputs can be netCDF or HDF (.nc or .hdf files).	Workspace; File; WCS Coverage; Image Service; Map Server; WMS Map; Table View; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Layer File; WMTS Layer
filter (Optional)	Specifies the filter for the input data. The default will be determined by the trajectory_type parameter value. Custom filter criteria can also be provided. For example, a value of STD_ will filter files that start with STD_ in the file name.	String
sub_folder (Optional)	Specifies whether data in the input_path subfolders will be searched and added. SUBFOLDERS—All subfolders will be searched and the data added. This is the default. NO_SUBFOLDERS—Only the top-level folder will be searched and the data added.	Boolean
aux_inputs [aux_inputs,...] (Optional)	The properties that are determined by the trajectory_type parameter value. Supported property names are ProductFilter, Frequency, PredefinedVariables, and Variables. For a list of supported values associated with each property name, see Trajectory type properties.	Value Table

Derived Output

Name	Explanation	Data Type
out_trajectory_dataset	The updated trajectory dataset.	Trajectory Layer

Code sample

AddDataToTrajectoryDataset (stand-alone script)

Add a trajectory file to an empty trajectory dataset using the Cryosat-2 trajectory type.

# Import system modules
import arcpy
from arcpy.ia import *

# Set local variables
in_trajectory_dataset = r"C:\temp\trajectory_data.gdb\trajectory_dataset"

input_path = r"C:\data\Cryosat\CS_OFFL_SIR_LRM_2__20210301T000738_20210301T001611_D001.nc"

# Execute
trajectory_output = arcpy.management.AddDataToTrajectoryDataset(in_trajectory_dataset, 
		   "Cryosat-2", input_path, "*CS_*.nc", "SUBFOLDERS", None)

Environments

Parallel Processing Factor, Geographic Transformations

Licensing information

• Basic: No
• Standard: Yes
• Advanced: Yes