The data subfolder is crucial for organizing all the input files necessary for the inversion process. Properly structuring this folder ensures smooth execution and accurate results from the inversion code. Below are the essential components and their descriptions that should be included in the data subfolder.

Data File

The main data file in CSV format. This file should contain all the necessary survey data including coordinates, measurements, and any other relevant attributes. The column names of the relevant data should be provided in the config_system.yaml.

  • Columns: x, y, z, sFz[1], etc.

Offtime Sampling File

A CSV file containing the receiver sampling times. This is used to define the sampling intervals during the off-time of the waveform.

The sampling file name and the column name should be provided in the config_system.yaml file.

Waveform File

A CSV file that defines the waveform from the source.

The waveform file name, type, and column names should be provided in the config_system.yaml file.

System Configuration

The system configuration file that outlines the setup of the survey system, including transmitter and receiver settings.

  • Required File Name: config_system.yaml

Logo Image (optional)

An optional logo image file to be used in reports and visualizations. This file should be placed in the data folder and the correct path should be passed in the config_system.yaml if you would like the logo to appear on the reports.

  • Example File Name: company_logo.png

The following configuration files are generated automatically during the preprocessing step and do not need to be provided by the user, HOWEVER they are required for the inversion to run. It is HIGHLY recommended that you modify these files to ensure that the inversion runs according to your preferences.

Discretization Configuration

The discretization configuration file that specifies the spatial discretization parameters for the inversion process, such as cell size, padding, and depth range as well as the time discretization.

  • Required File Name: config_discretization.yaml

Survey Configuration

The survey configuration file detailing the specific parameters of the survey, such as the area covered, line spacing, and other survey-specific details.

  • Required File Name: config_survey.yaml
A survey configuration file is generated automatically during the preprocessing step. The default configuration will cover the entire survey area provided in the data file. However, you can modify it to adjust the survey parameters as needed.

Inversion Configuration

The inversion configuration file that specifies the parameters and settings for the inversion process, including algorithm settings and initial models.

  • Required File Name: config_inversion.yaml
A default inversion configuration file is generated automatically during the preprocessing step. The default configuration will be based on the provided data and system parameters. It is recommended that you modify it to adjust the inversion parameters as needed.

Model Configuration

The model configuration file that defines the initial model for the inversion process, such as the background conductivity and any blocked structures.

  • Required File Name: config_model.yaml
A default model configuration file is generated automatically during the preprocessing step.

​
Additional Notes

  • Ensure that all files are named clearly and follow a consistent naming convention to avoid confusion.
  • Validate the data in each file to ensure there are no missing or incorrect values that could impact the inversion process.
  • Refer to the configuration documentation for detailed descriptions and examples of each configuration file.

By organizing your data subfolder according to these guidelines, you will facilitate a streamlined and efficient workflow for your 2.5D inversion projects.

Survey Folder StructureDistribution + Scaling