CARIS HIPS and SIPS : CARIS Batch Utility : CZMIL Processes : Import CZMIL to Survey
 

Import CZMIL to Survey

Description

The ImportCZMILToSurvey process will import a CZMIL mission execution file and raw information and create a new survey file.

Inputs

A CZMIL mission execution file.

Outputs

A survey file.

Command Line Syntax

carisbatch --run ImportCZMILToSurvey --mission-execution-file <value> --processing-folder <value> --sbet-files <value> [options]

User Interface Command

Import CZMIL Mission

Options

The following table describes the parameters available for this process.

Parameter

 

Long

Short

Description

Can Repeat

Notes

 

--mission-execution-file

The full path to the input Mission Execution file that references the lidar dataset.

FALSE

This must be specified explicitly.

--camera-raw-folder

If set, the full path to the input raw camera dataset.

FALSE

--processing-folder

The full path to the output processing location for the survey folder.

FALSE

This must be specified explicitly.

--survey-name

If set, the name used for the survey file and folder for all of the processed data.

If not set, a unique survey name will be generated from the Mission Execution information and the current date/time.

FALSE

--buffer-time

The maximum allowable difference (in seconds) in start times between the CZMIL LRAW files and flight lines stored in the CZMIL Mission Execution files.

If not set, the default value of 5 will be used.

FALSE

--sbet-files

The name and location of the SBET file containing the navigation points of the survey.

Multiple files can be specified if more than one file was used for the survey. If more than one file is specified, they will be applied during import in the order they are specified.

TRUE

--sbet-rms-files

The name and location of the SBET RMS file for the CZMIL dataset.

Multiple files can be specified if more than one file was used for the survey. If more than one file is specified, they will be applied during import in the order they are specified.

TRUE

--output-crs

c

<ReferenceKey>

A string specifying the horizontal coordinate reference system key of the output.

For time-dependent coordinate reference systems, the epoch can be specified, typically using the year as <crs_id>@1997. A fractional year can also be specified, such as <crs_id>@1997.3, if needed. If no epoch is specified, the reference epoch of the coordinate reference system is used.

FALSE

Example

To use this command refer to the following example.

Example

Objective

You want to create a new survey file from an existing CZMIL mission execution file.

Description

Command Line Syntax

The mission execution file is called CZ09ME20001_P_171008_2137.xml and is located in the D:\SampleData directory.

--mission-execution-file D:\SampleData\CZ09ME20001_P_171008_2137.xml

The camera images for the dataset are to be included with the survey and can be found in the D:\SampleData\RawImages directory.

--camera-raw-folder D:\SampleData\RawImages

The resulting survey file will be created in the D:\SampleData\Surveys directory.

--processing-folder D:\SampleData\Surveys

The SBET file for the survey is called sbet_0714_NAD83.out and can be found in the D:\SampleData\Surveys directory.

--sbet-files D:\SampleData\Surveys\sbet_0714_NAD83.out

Command Line

carisbatch -r ImportCZMILToSurvey --mission-execution-file D:\SampleData\CZ09ME20001_P_171008_2137.xml --camera-raw-folder D:\SampleData\RawImages --processing-folder D:\SampleData\Surveys --sbet-files D:\SampleData\Surveys\sbet_0714_NAD83.out

Outcome

A new survey file is created in the processing folder, with a file name generated from the current date and the information in the mission execution and SBET file.

Extra Notes

N/A