River Outputs

After running Tolosa-sw, all results are written under the res/ subdirectory of the working directory. The structure reflects the outputs configured in input.txt and savefield.yaml.

Directory Structure

/res
    run_YYYY-MM-DD_HH:MM:SS     ! run information file
    energy.plt                   ! energy balance (if w_post = 1)
    energy_init_final.csv
    umax.plt
    volume.plt
    /bin                         ! full-domain binary outputs
    /vtk                         ! full-domain VTK outputs
    /gauge                       ! tide gauge time series
    /field
        /Window_1                ! VTK sub-window
        /Window_2                ! binary sub-window

1D Outputs — Tide Gauges

Tide gauge time series are stored in res/gauge/ as .csv files, one per gauge:

/gauge
    TIDE_G_1.csv
    TIDE_G_2.csv
    TIDE_G_3.csv
    TIDE_G_4.csv

Each file contains the time evolution of the requested fields (ssh, u, v, etc.) at the specified cell, written at the configured interval.

2D Outputs

VTK Files (entire domain)

Written to res/vtk/ at interval dtw:

/vtk
    result_000000.vtk
    result_000001.vtk
    ...
    result_XXXXXX.vtk

Each file contains the sea surface height, bathymetry, and velocity components at all cell centers for one time step. Open the file bundle in ParaView to visualize and animate.

VTK Files (sub-window)

Window_1 was defined without format: bin, so it uses VTK by default:

/field
    /Window_1
        Window_1_000000.vtk
        ...
        Window_1_XXXXXX.vtk

These files contain the same fields as the full-domain output but restricted to the Window_1 spatial extent.

Binary Files (entire domain)

Written to res/bin/ at interval dtb:

/bin
    result_data_000001.bin
    ...
    result_data_XXXXXX.bin
    result_data_minmax.txt
    result_gmsh_element.bin
    result_info.txt
    result_mesh.bin
    result_lon_lat_degrees.bin
    result_lon_lat_radians.bin

File	Content
result_info.txt	Summary of fields, dates, and key values
result_mesh.bin	Mesh connectivity (links data to mesh nodes)
result_gmsh_element.bin	Global cell indices as defined in Gmsh
result_lon_lat_degrees.bin	Node coordinates in longitude/latitude (degrees)
result_lon_lat_radians.bin	Node coordinates in longitude/latitude (radians)
result_data_XXXXXX.bin	Field values at each cell center (one file per time step)
result_data_minmax.txt	Min/max of each field at each time step

Binary files are readable by PyTolosa.

Binary Files (sub-window)

Window_2 was defined with format: bin:

/field
    /Window_2
        Window_2_data_000000.bin
        ...
        Window_2_data_XXXXXX.bin
        Window_2_data_minmax.txt
        Window_2_gmsh_element.bin
        Window_2_info.txt
        Window_2_mesh.bin
        Window_2_lon_lat_degrees.bin
        Window_2_lon_lat_radians.bin

Same structure as the full-domain binary output but restricted to the Window_2 spatial extent.

Post-treatment Outputs

If w_post = 1, Tolosa-sw writes global diagnostic time series to the res/ root:

File	Content
energy.plt	Kinetic energy, potential energy, total energy
energy_init_final.csv	Energy at first and last time step
umax.plt	Maximum velocity over time
volume.plt	Total water volume over time

These can be visualized with Gnuplot (.plt files) or any CSV reader.