GEOGEN CLI

geogen

PSA Geometry Generator (GEOGEN) CLI.

geogen [OPTIONS] COMMAND [ARGS]...

Options

--version

Show the version and exit.

compute

Computes the observation geometry parameters and footprint associated to one or several PDS observational data products listed in INPUT_FILE.

INPUT_FILE

Path of an input PFL file or B3F file (not implemented).

Output files are by default generated in the data/ directory from where the command is ran, and follow the following scheme:

<INPUT_FILE_basename>/<target>_<instrument_host_id>_<instrument>_<product_type>_[ell|dsk][_split][.geojson|.b3f]

geogen compute [OPTIONS] INPUT_FILE

Options

--preview, --no-preview

Preview coverages and observations computation. Use –no-preview to run computation.

--dsk, --no-dsk

Use loaded DSKs as target body surface model (target-dependant).

--b3f-input, --no-b3f-input

Use B3F file as input instead of PLF.

--config-file <config_file>

Configuration file (default is /Users/nmanaud/workspace/geogen/psa_geo/psa_config.json).

--addendum-dir <addendum_dir>

Addendum kernels directory (default is /Users/nmanaud/workspace/geogen/psa_geo/data/addendum/).

--data-dir <data_dir>

Output data directory containing B3F, GeoJSON and LOG directories and files.

--instrument-id <instrument_id>

Filter input PLF file by instrument name.

--product-id <product_id>

Filter input PLF file by product ID.

--forced-target <forced_target>

Name of target name, superseding target names in input PLF file.

--force-detector, --no-force-detector

Force computation for unknown SPICE detector name (assumed IN-SITU).

--split, --no-split

Split footprints geometry when needed.

-v, --verbose

Enables verbose mode (always true in preview mode).

Arguments

INPUT_FILE

Required argument

config

Check configuration for a given mission, instrument or product type.

Examples:
$ geogen config
$ geogen config –mission-id=MEX
$ geogen config –mission-id=MEX –instrument-id=OMEGA
$ geogen config –mission-id=MEX –instrument-id=OMEGA –product-type=EDR
geogen config [OPTIONS]

Options

--config-file <config_file>

Configuration file (default is /Users/nmanaud/workspace/geogen/psa_geo/psa_config.json).

--mission-id <mission_id>

Name of the mission to be checked.

--instrument-id <instrument_id>

Name of the instrument to be checked.

--product-type <product_type>

Name of the product type to be checked.

--addendum-dir <addendum_dir>

Addendum kernels directory (default is /Users/nmanaud/workspace/geogen/psa_geo/data/addendum/).

--data-dir <data_dir>

Output data directory containing B3F, GeoJSON and LOG directories and files.

--source-code, --no-source-code

Show source code for computing Geometry.

fov

Check SPICE instrument detectors FOV definition for a given mission.

geogen fov [OPTIONS] MISSION_ID

Options

--config-file <config_file>

Configuration file (default is /Users/nmanaud/workspace/geogen/psa_geo/psa_config.json).

Arguments

MISSION_ID

Required argument

product

Generate a PLF Product item (JSON object) corresponding to an input PDS4 Product Label XML file.

Example:
$ geogen product cas_raw_sc_20161126T232450-20161126T232454-10-35-PAN-100795368-23-0.xml
{
“instrument_host_id”: “TGO”,
“instrument_id”: “CASSIS”,
“product_type”: “Raw”,
“target_name”: “PHOBOS”,
“start_time”: “2016-11-26T23:24:50.580Z”,
“stop_time”: “2016-11-26T23:24:54.580Z”,
“samples”: “2048”,
“lines”: “279”
}
geogen product [OPTIONS] PDS4_LABEL_FILE

Options

--config-file <config_file>

Configuration file (default is /Users/nmanaud/workspace/geogen/psa_geo/psa_config.json).

Arguments

PDS4_LABEL_FILE

Required argument

split

Split geometries from input GeoJSON file.

Generated output GeoJSON file is located in the same directory as the input GeoJSON file, with the _split suffix to the basename.

geogen split [OPTIONS] INPUT_GEOJSON_FILE

Arguments

INPUT_GEOJSON_FILE

Required argument

target

Get information about a given target name, for a specific mission.

NAME Name of target as specified in a PDS product label.
MISSION Name of the related mission (as defined in config file).
geogen target [OPTIONS] NAME MISSION

Options

--config-file <config_file>

Configuration file (default is /Users/nmanaud/workspace/geogen/psa_geo/psa_config.json).

Arguments

NAME

Required argument

MISSION

Required argument