Skip to content

geotrax export

Export georeferenced trajectories to GIS formats (GeoPackage, GeoJSON).

usage: geotrax export [-h] [--format {gpkg,geojson}] [--geometry {lines,points}]
                      [--crs {wgs84,local}] [--output-folder OUTPUT_FOLDER] [--cfg CFG]
                      [--set KEY=VALUE] [--log-path LOG_PATH] [--verbose]
                      input

Export georeferenced trajectories to GIS formats (GeoPackage, GeoJSON)

Positional arguments

Argument Value Config key Description
input A georeferenced .csv file, a video file (its georeferenced .csv is looked up in the output folder), or a folder searched recursively for georeferenced and aggregated .csv files.

Optional arguments

Argument Value Config key Description
--format, -f gpkg | geojson Output format: gpkg (GeoPackage) or geojson (default: gpkg).
--geometry, -g lines | points lines = one LineString per vehicle with summary attributes; points = one Point per trajectory row with every CSV column (default: lines).
--crs, -crs wgs84 | local wgs84 = Latitude/Longitude in EPSG:4326; local = Local_X/Local_Y in cfg -> georef -> transformation -> target_crs (default: wgs84).
--output-folder, -of OUTPUT_FOLDER Folder for the exported files. Defaults to the folder of each input .csv; for a folder input, the sub-folder layout below it is mirrored.
--cfg, -c CFG Pipeline config: a bundled preset name (default, confident, lenient, stable) or a path to a custom config file. Run 'geotrax config show' to list presets or 'geotrax config copy' to customize.
--set, -st KEY=VALUE Override a pipeline config value for this run; repeat for more than one, e.g. --set conf=0.35 --set iou=0.6. KEY is a dotted path ('ultralytics.conf') or any unambiguous tail of one ('conf'); an ambiguous or unknown key is an error that lists the candidates. VALUE is read with YAML rules, so true/null/0.35/[0,1,2] all mean what they do in the config file. Use the dedicated flag instead where one exists (it validates its input); passing both for the same key is an error.
--log-path, -lp LOG_PATH Where to write detailed logs: a directory (an auto-named <stage><timestamp><pid>.log file is created inside it, so concurrent or later runs never share a file) or a full file path ending in .log or .txt (any other new path is created as a directory). Defaults to a platform-specific log directory.
--verbose, -v Also show INFO messages on the console (default: warnings and key notices only).