cli.CsvPreprocessConfig

cli.CsvPreprocessConfig(
    script,
    simulation,
    data_file,
    variable,
    units,
    output,
    timestep,
    amend=False,
    crs=None,
    parallel=False,
)

Preprocess CSV point data into Josh’s .jshd format.

CSV must have columns named exactly “longitude” and “latitude”. All other columns are available as variables. The timestep parameter is required to specify which simulation timestep the data maps to.

Note: CSV preprocessing uses brute-force nearest-neighbor lookup, which may be slow for large files. For large datasets, consider converting to GeoTIFF first.

Attributes

Name Type Description
script Path Path to Josh simulation file (.josh).
simulation str Name of simulation for grid extraction.
data_file Path Path to CSV file (.csv).
variable str Column name to extract.
units str Units of the data for simulation use.
output Path Path for output .jshd file.
timestep int Simulation timestep this data maps to (required).
amend bool Append to existing JSHD file.
crs str | None Coordinate Reference System.
parallel bool Enable parallel processing (~Nx speedup on N cores).