Command line tools

Geosections contains two command line functions, one to plot a cross-section and another to check the input data that will be plotted in a section, specifically which lithologies are present in the data. Both functions take as input a TOML configuration file (e.g. my-settings.toml) as input. See the Configuration file and Configuration options sections for the structure and content of such a TOML file.

Check lithology in the data

A cross-section shows the lithologic composition of borehole and CPT data in specific colors per lithology. These colors are specified in the configuration TOML (see Colors section). Therefore, geosections has a unique-lithologies function to check the present lithologic classes that are present in the data. Check each unique lithology code that is present in the data in the cross-section to configure a legend by:

geosections unique-lithologies "my_settings.toml"

Creating a cross-section

Create a cross-section based on the TOML file by using:

geosections plot "my_settings.toml"

This opens a plot window for the cross-section for inspecting the result. When the result is good enough, the section can directly be saved by clicking the save icon in the window. If the changes are required, simply close the plot window and type the same command.

The plot function also has options available to directly save the section, or close the preview plot window. To directly save the plot to an output file use:

geosections plot "my_settings.toml" --save "my-section.pdf"

Or directly save and do not show a preview:

geosections plot "my_settings.toml" --save "my-section.pdf" --close