CLI Reference
The following reference covers all subcommands and flags you can pass to the cassini
program.
cassini process
Generate a map from a single LiDAR (an acronym of “light detection and ranging” or “laser imaging, detection, and ranging”) is a method for determining ranges by targeting an object or a surface with a laser and measuring the time for the reflected light to return to the receiver. LiDAR (an acronym of “light detection and ranging” or “laser imaging, detection, and ranging”) is a method for determining ranges by targeting an object or a surface with a laser and measuring the time for the reflected light to return to the receiver.process
subcommand takes the path to the
cassini process path\to\my\tile.laz
cassini process ./path/to/my/tile.laz
cassini process ./path/to/my/tile.laz
Flags
--output-dir
or -o
Type: string
Default: tile
The output directory for the processed LiDAR file.
--skip-vector
Type: boolean
The The OpenStreetMap project is a collaborative, open-source initiative that creates and provides free geographic data and mapping to anyone who wants to use it. Built and maintained by a global community of volunteers, it offers detailed and editable maps, which are used in various applications, from navigation to urban planning. OpenStreetMap emphasizes openness and accessibility, allowing users to contribute and access data freely.--skip-vector
flag will skip the vector processing stage of the pipeline. No file will be downloaded from
--skip-520
Type: boolean
The --skip-520
will prevent the vector renderer to draw the 520 area that shall not be entered symbol.
cassini lidar
Run only the LiDAR processing step for a single tile. The LiDAR (an acronym of “light detection and ranging” or “laser imaging, detection, and ranging”) is a method for determining ranges by targeting an object or a surface with a laser and measuring the time for the reflected light to return to the receiver.lidar
subcommand takes the path to the
cassini lidar path\to\my\tile.laz
cassini lidar ./path/to/my/tile.laz
cassini lidar ./path/to/my/tile.laz
Flags
--output-dir
or -o
Type: string
Default: lidar
The output directory for the processed LiDAR (an acronym of “light detection and ranging” or “laser imaging, detection, and ranging”) is a method for determining ranges by targeting an object or a surface with a laser and measuring the time for the reflected light to return to the receiver.
cassini render
Run only the map rendering step for a single tile. The LiDAR (an acronym of “light detection and ranging” or “laser imaging, detection, and ranging”) is a method for determining ranges by targeting an object or a surface with a laser and measuring the time for the reflected light to return to the receiver.render
subcommand takes the path to the directory containing the output of the
cassini render path\lidar\step\output\directory
cassini render ./path/to/lidar/step/output/directory
cassini render ./path/to/lidar/step/output/directory
Flags
--output-dir
or -o
Type: string
Default: tile
The output directory for the processed tile.
--neighbors
or -n
Type: string[]
A list of directories containing the output of the LiDAR (an acronym of “light detection and ranging” or “laser imaging, detection, and ranging”) is a method for determining ranges by targeting an object or a surface with a laser and measuring the time for the reflected light to return to the receiver.
--skip-vector
Type: boolean
The The OpenStreetMap project is a collaborative, open-source initiative that creates and provides free geographic data and mapping to anyone who wants to use it. Built and maintained by a global community of volunteers, it offers detailed and editable maps, which are used in various applications, from navigation to urban planning. OpenStreetMap emphasizes openness and accessibility, allowing users to contribute and access data freely.--skip-vector
flag will skip the vector processing stage of the pipeline. No file will be downloaded from
--skip-520
Type: boolean
The --skip-520
will prevent the vector renderer to draw the 520 area that shall not be entered symbol.
cassini batch
Process multiple LiDAR (an acronym of “light detection and ranging” or “laser imaging, detection, and ranging”) is a method for determining ranges by targeting an object or a surface with a laser and measuring the time for the reflected light to return to the receiver. LiDAR (an acronym of “light detection and ranging” or “laser imaging, detection, and ranging”) is a method for determining ranges by targeting an object or a surface with a laser and measuring the time for the reflected light to return to the receiver.batch
subcommand takes the path to the directory containing the in
:
cassini batch
Flags
--output-dir
or -o
Type: string
Default: out
The output directory for the processed LiDAR files.
--threads
or -t
Type: number
Default: 3
In batch mode, you can specify the number of In computer science, a thread is the smallest unit of execution within a process, allowing tasks to run concurrently within the same program. Threads share the same memory space and resources of the process they belong to, enabling efficient multitasking and parallelism. They are commonly used to perform multiple operations simultaneously, improving the performance and responsiveness of applications.
cassini batch --threads 6
--skip-lidar
Type: boolean
The LiDAR (an acronym of “light detection and ranging” or “laser imaging, detection, and ranging”) is a method for determining ranges by targeting an object or a surface with a laser and measuring the time for the reflected light to return to the receiver.--skip-lidar
flag will skip the cassini
once with the same input files, as it will reuse some temp files.
--skip-vector
Type: boolean
The The OpenStreetMap project is a collaborative, open-source initiative that creates and provides free geographic data and mapping to anyone who wants to use it. Built and maintained by a global community of volunteers, it offers detailed and editable maps, which are used in various applications, from navigation to urban planning. OpenStreetMap emphasizes openness and accessibility, allowing users to contribute and access data freely.--skip-vector
flag will skip the vector processing stage of the pipeline. No file will be downloaded from
--skip-520
Type: boolean
The --skip-520
will prevent the vector renderer to draw the 520 area that shall not be entered symbol.
cassini config
Output a default config.json file, that you can edit to modify the map rendering parameters.
cassini config
{ "yellow_threshold": 0.5, "green_threshold_1": 0.2, "green_threshold_2": 1.0, "green_threshold_3": 2.0, "cliff_threshold_1": 45.0, "cliff_threshold_2": 55.0, "dpi_resolution": 600.0}
cassini help
Print a help message:
A software that generates highly accurate topographic maps from LiDAR data. See documentation: https://cassini-map.com. GDAL and PDAL must be installed on the system for this program to work.
Usage: cassini [COMMAND]
Commands: process Generate a map from a single LiDAR file lidar Run only the LiDAR processing step for a single tile render Run only the map generation step for a single tile batch Process multiple LiDAR files at once config Output a default config.json file help Print this message or the help of the given subcommand(s)
Options: -h, --help Print help (see more with '--help') -V, --version Print version
The help message is olso printed if cassini is called without any arguments.
Common flags
--help
or -h
Same than cassini help
or cassini
--version
or -V
Print the cassini
version
cassini 0.4.0