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. See Trajectory type properties for more details on the trajectory products and variables.

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

Parameters

LabelExplanationData 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

LabelExplanationData Type
Trajectory Dataset

The updated trajectory dataset.

Trajectory Layer

arcpy.management.AddDataToTrajectoryDataset(in_trajectory_dataset, trajectory_type, input_path, {filter}, {sub_folder}, {aux_inputs})
NameExplanationData 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)

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.

  • SUBFOLDERSAll subfolders will be searched and the data added. This is the default.
  • NO_SUBFOLDERSOnly 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

NameExplanationData 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)

Related topics