This guide provides details of the format of the data files produced by LaharFlow.
The following files can be exported from LaharFlow on the Data export tab:
- 000xxx.txt – comma separated data at 100 time steps;
- MaxHeights.txt – comma separated data of the maximum flow depths;
- MaxSpeeds.txt – comma separated data of the maximum flow speeds;
- MaxHeights.kml – KML encoded data of the maximum flow depths;
- MaxSpeeds.kml – KML encoded data of the maximum flow speeds;
- Volume.txt – comma separated data for the time series of volume and mass of the flow;
- RunInfo.txt – text file with information regarding the simulation settings;
- OutputReadme.txt – text file with information regarding the format of output files.
Data at each output time step of the simulation are written to files called 000xxx.txt, with xxx ranging from 000 to 100. These files contain the detailed results of the simulation and are likely to be used in post-processing. The data are presented as ascii plain text, comma separated values with a header line giving a descriptive label. To facilitate import of the data into arcGIS, the labels are concise.
The data files are created when the simulation reaches an output time step, with an interval of 1/100 of the simulation time. The files can be downloaded as they are created through the 'Plain text file' option on the Data export tab, and all the available files are included in the zip file created if the 'zipped numerical results' option is selected.
Futher details of the formatting of the files is given in the file OutputReadme.txt and in the table below. (Note SI units are adopted, with distances measured in metres (m), time in seconds (s) and mass in kilograms (kg).)
| Column | Label | Description | Symbol | Unit | Data type |
|---|---|---|---|---|---|
| 1 | tile | tile id | dimensionless | integer | |
| 2 | x_distance | Easting distance from origin at the domain centre | \(x\) | m | real |
| 3 | y_distance | Northing distance from origin at the domain centre | \(y\) | m | real |
| 4 | latitude | Latitude in WGS84 coordinates | decimal degrees | real | |
| 5 | longitude | Longitude in WGS84 coordinates | decimal degrees | real | |
| 6 | flow_depth | Depth of lahar | \(h\) | m | real |
| 7 | flow_speed | Speed of lahar | \(\sqrt{u^2+v^2}\) | m/s | real |
| 8 | mass_per_unit_area | Mass of lahar per unit area | \(\rho h\) | kg/m^2 | real |
| 9 | x_flux | Mass flux in the easting per unit length | \(\rho h u\) | kg/m/s | real |
| 10 | y_flux | Mass flux in the northing per unit length | \(\rho h v\) | kg/m/s | real |
| 11 | mass_of_solids | Mass of solids per unit area | \(\rho h c\) | kg/m^2 | real |
| 12 | base_elevation | Base topographic elevation | \(b_0\) | m (a.s.l.) | real |
| 13 | base_x_slope | Slope of base topography in Easting | \(\partial b_0/ \partial x\) | dimensionless | real |
| 14 | base_y_slope | Slope of base topography in Northing | \(\partial b_0/ \partial y\) | dimensionless | real |
| 15 | elevation_change | Change in topographic elevation | \(b_t\) | m (a.s.l.) | real |
| 16 | change_in_x_slope | Change in x-slope of topography | \(\partial b_t/ \partial x\) | dimensionless | real |
| 17 | change_in_y_slope | Change in y-slope of topography | \(\partial b_t/ \partial y\) | dimensionless | real |
Data for the maximum flow depth in each cell in the flow domain are available in the file called MaxHeights.txt. This file is updated during the simulation. The file contains ascii plain text data as comma separated values with a header line giving a descriptive label. To facilitate import of the data into arcGIS, the labels are concise.
The MaxHeights.txt file is available as part of the zip file created if the 'zipped numerical results' option is selected on the Data export tab.
Futher details of the formatting of the files is given in the file OutputReadme.txt and in the table below. (Note SI units are adopted, with distances measured in metres (m), time in seconds (s) and mass in kilograms (kg).)
| Column | Label | Description | Symbol | Unit | Data type |
|---|---|---|---|---|---|
| 1 | tile | tile id | dimensionless | integer | |
| 2 | x_distance | Easting distance from origin at the domain centre | \(x\) | m | real |
| 3 | y_distance | Northing distance from origin at the domain centre | \(y\) | m | real |
| 4 | latitude | Latitude in WGS84 coordinates | decimal degrees | real | |
| 5 | longitude | Longitude in WGS84 coordinates | decimal degrees | real | |
| 6 | maximum_depth | Maximum depth of lahar | \(\max{h}\) | m | real |
| 7 | time_of_maximum | Time of the maximum depth | \(t_{\max h}\) | s | real |
Data for the maximum flow speeds in each cell in the flow domain are available in the file called MaxSpeeds.txt. This file is updated during the simulation. The file contains ascii plain text data as comma separated values with a header line giving a descriptive label. To facilitate import of the data into arcGIS, the labels are concise.
The MaxSpeeds.txt file is available as part of the zip file created if the 'zipped numerical results' option is selected on the Data export tab.
Futher details of the formatting of the files is given in the file OutputReadme.txt and in the table below. (Note SI units are adopted, with distances measured in metres (m), time in seconds (s) and mass in kilograms (kg).)
| Column | Label | Description | Symbol | Unit | Data type |
|---|---|---|---|---|---|
| 1 | tile | tile id | dimensionless | integer | |
| 2 | x_distance | Easting distance from origin at the domain centre | \(x\) | m | real |
| 3 | y_distance | Northing distance from origin at the domain centre | \(y\) | m | real |
| 4 | latitude | Latitude in WGS84 coordinates | decimal degrees | real | |
| 5 | longitude | Longitude in WGS84 coordinates | decimal degrees | real | |
| 6 | maximum_speed | Maximum speed of lahar | \(\max{spd}\) | m/s | real |
| 7 | time_of_maximum | Time of the maximum speed | \(t_{\max spd}\) | s | real |
Data for the maximum flow depth in each cell in the flow domain are available in a KML encoded file called MaxHeights.kml. The file can be loaded directly into Google Earth which displays the data in three-dimensions as geolocated extruded polygons. KML files can also be loaded easily in some GIS software, although the extruded third-dimensions may not be supported, in which case a outline of the flow extent is displayed. The KML only shows flow depths that exceed 0.1 m.
The MaxHeights.kml file is updated during the simulation. It is available to download from the Data export tab by selecting 'KML file' and is included in the zip file that is created if the 'zipped numerical results' option is selected.
Data for the maximum flow speed in each cell in the flow domain are available in a KML encoded file called MaxSpeeds.kml. The file can be loaded directly into Google Earth which displays the data in three-dimensions as geolocated extruded polygons. KML files can also be loaded easily in some GIS software, although the extruded third-dimensions may not be supported, in which case a outline of the flow extent is displayed. The KML only shows flow speeds at locations where the flow depths that exceed 0.1 m.
The MaxSpeeds.kml file is updated during the simulation. It is available to download from the Data export tab as part of the zip file that is created if the 'zipped numerical results' option is selected.
Data for the temporal variation of the volume and mass of the flow are available in the file called volume.txt. This file is updated during the simulation. The file contains ascii plain text data as comma separated values with a header line giving a concise descriptive label.
The Volume.txt file is available as part of the zip file created if the 'zipped numerical results' option is selected on the Data export tab.
Futher details of the formatting of the files is given in the file OutputReadme.txt and in the table below. (Note SI units are adopted, with distances measured in metres (m), time in seconds (s) and mass in kilograms (kg).)
| Column | Label | Description | Symbol | Unit | Data type |
|---|---|---|---|---|---|
| 1 | time | Time | \(t\) | s | real |
| 2 | volume | Volume of the flowing material | \(V\) | m\(^3\) | real |
| 3 | mass | Mass of the flowing material | \(M\) | kg | real |
Detailed information on the simulation inputs and settings are provided in the file RunInfo.txt. This is a plain text ascii file and is included in the zip file that is created if the 'zipped numerical results' option is selected on the Data export tab. This file is updated during the simulation.