Difference between revisions of "FLO2D to TUFLOW"
Chris Huxley (talk | contribs) |
|||
(60 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
=Introduction= | =Introduction= | ||
− | This page outlines some utilities that may be used to convert FLO2D model files into a format which compatible with TUFLOW. The utilities are available for download from the | + | This page outlines some utilities that may be used to convert FLO2D model files into a format which is compatible with TUFLOW. The utilities are available for download from the <u>[https://www.tuflow.com/Tuflow%20Utilities.aspx TUFLOW website]</u>.<br>If you have any suggestions to be included in these pages, please contact <u>[mailto:support@tuflow.com support@tuflow.com]</u>.<br><br> |
− | = Model Conversion ( | + | = Model Conversion Utility (FLO2D_to_GIS.exe) = |
The flo2d_to_gis.exe utility creates a complete TUFLOW model from FLO-2D model data. The utility converts the following data into a TUFLOW compatible format: | The flo2d_to_gis.exe utility creates a complete TUFLOW model from FLO-2D model data. The utility converts the following data into a TUFLOW compatible format: | ||
* Model origin, grid orientation, extent and resolution information | * Model origin, grid orientation, extent and resolution information | ||
Line 10: | Line 10: | ||
* Width reduction factors (flow constriction features) | * Width reduction factors (flow constriction features) | ||
* Inflow/outflow locations | * Inflow/outflow locations | ||
− | * Boundary condition | + | * Boundary condition time series data |
These datasets are written to the standard TUFLOW model folder structure. TUFLOW control files are also output (tcf, tcg, tbc, boundary condition database). | These datasets are written to the standard TUFLOW model folder structure. TUFLOW control files are also output (tcf, tcg, tbc, boundary condition database). | ||
Line 16: | Line 16: | ||
''Note: This utility is currently still in its beta testing phase. Output should be carefully quality checked. '' | ''Note: This utility is currently still in its beta testing phase. Output should be carefully quality checked. '' | ||
<br> | <br> | ||
− | == | + | == Utility Execution == |
− | The TUFLOW Model Conversion (TMC) file used to define the input files and projection information required by the utility. | + | The TUFLOW Model Conversion (TMC) file is used to define the input files and projection information required by the utility. Steps how to create a TMC file and run the utility are as follows: |
− | + | <ol> | |
− | <u>Required Inputs:</u> <br> | + | <li> Place a copy of the flo2d_to_GIS.exe utility in the same location as the FLO2D model files. |
+ | <li> Create a new text file in the same location as the FLO2D model files. The name must have the extension ".tmc". For example the file name could be "run_model_Conversion.tmc". | ||
+ | <li> Enter the relevant command syntax (shown in italics below). | ||
+ | <li> The model conversion can be run either by dragging the TMC file onto the flo2d_to_GIS.exe utility, or from a batch file. Steps to create a batch file are: | ||
+ | <ol> | ||
+ | <li> Create a new text file in the same location as the TMC and FLO-2D files. The file name must have the extension ".bat". For example, "run_FLO2D_to_GIS.bat". | ||
+ | <li> Reference the executable, specify the batchfile flag (-b) and the TMC file name within the text file. Additional conversion references can be specified in series to process multiple models in sequence, for example: <ol>''flo2d_to_GIS.exe -b conv1.tmc''</ol><ol>''flo2d_to_GIS.exe -b conv2.tmc''</ol><ol>''flo2d_to_GIS.exe -b conv3.tmc''</ol> | ||
+ | <li> Double click the batch file in windows explorer to execute the model conversion.<br> | ||
+ | </ol></ol><br> | ||
+ | |||
+ | <u><b>Required TMC File Inputs:</b></u> <br> | ||
* FLO-2D floodplain grid element data file: <ol>''FLO2D FPLAIN == <Filename>'' </ol> | * FLO-2D floodplain grid element data file: <ol>''FLO2D FPLAIN == <Filename>'' </ol> | ||
* FLO-2D co-ordinate point data file: <ol>''FLO2D CADPTS == <Filename>'' </ol> | * FLO-2D co-ordinate point data file: <ol>''FLO2D CADPTS == <Filename>'' </ol> | ||
Line 26: | Line 36: | ||
* Projection Data (four available options) <br> | * Projection Data (four available options) <br> | ||
<ol><ol> | <ol><ol> | ||
− | <li> ''MI Projection == <coordinate line from .mif file>'' | + | <li> ''MI Projection == <coordinate projection line from .mif file>'' |
<li> ''MI Projection File == <link to .mif file used for setting projection>'' | <li> ''MI Projection File == <link to .mif file used for setting projection>'' | ||
− | <li> ''SHP Projection == <coordinate line from .prj file>'' | + | <li> ''SHP Projection == <coordinate projection line from .prj file>'' |
<li> ''SHP Projection File == <link to .prj file used for setting projection> <br><br>'' | <li> ''SHP Projection File == <link to .prj file used for setting projection> <br><br>'' | ||
</ol></ol> | </ol></ol> | ||
− | <u>Optional Inputs:</u> <br> | + | <u><b>Optional TMC File Inputs:</b></u> <br> |
* FLO-2D floodplain area and width reduction data file: <ol>''FLO2D ARF == <Filename>''</ol><br> | * FLO-2D floodplain area and width reduction data file: <ol>''FLO2D ARF == <Filename>''</ol><br> | ||
− | |||
− | |||
− | |||
=== Example Syntax === | === Example Syntax === | ||
+ | <u>Description:</u> Convert a FLO2D model into TUFLOW format using a shp projection file | ||
FLO2D FPLAIN == FPLAIN.DAT | FLO2D FPLAIN == FPLAIN.DAT | ||
FLO2D CADPTS == CADPTS.DAT | FLO2D CADPTS == CADPTS.DAT | ||
Line 43: | Line 51: | ||
FLO2D OUTFLOW == OUTFLOW.DAT | FLO2D OUTFLOW == OUTFLOW.DAT | ||
FLO2D ARF == ARF.DAT !#Optional | FLO2D ARF == ARF.DAT !#Optional | ||
− | SHP Projection File == Projection.prj | + | SHP Projection File == Projection.prj |
− | |||
− | |||
− | |||
+ | <u>Description:</u> Convert a FLO2D model into TUFLOW format using a mif coordinate projection line from | ||
+ | FLO2D FPLAIN == FPLAIN.DAT | ||
+ | FLO2D CADPTS == CADPTS.DAT | ||
+ | FLO2D INFLOW == INFLOW.DAT | ||
+ | FLO2D OUTFLOW == OUTFLOW.DAT | ||
+ | FLO2D ARF == ARF.DAT !#Optional | ||
+ | MI Projection == CoordSys NonEarth Units "survey ft" Bounds (1910000, 14400000) (2000000, 14500000) | ||
+ | == Utility Output == | ||
+ | flo2d_to_gis.exe will convert the FLO-2D model into a working TUFLOW model titled: ''conv_001.tcf'' | ||
+ | [[File: Flo2d_tcf.JPG]]<br> | ||
+ | The following items from the FLO-2D model will be included within the TUFLOW model: | ||
+ | * Model origin, grid orientation, extent and resolution | ||
+ | * Topography (elevation) datasets | ||
+ | * Landuse delineation information (non-varying with depth) | ||
+ | * Storage adjustment features | ||
+ | * Width reduction factors (flow constriction features) | ||
+ | * Inflow/outflow locations | ||
+ | * Boundary condition time series data | ||
+ | * Output interval commands | ||
+ | The TUFLOW model time step will be set based on a pre-defined ratio of the model grid size. This value should be reviewed by the modeller and updated if necessary. | ||
+ | [[File: Flo2d_tcf_001.JPG|600px]]<br><br> | ||
− | + | == Model Conversion Limitations == | |
− | + | Some FLO-2D datasets will not automatically be translated across to the TUFLOW model. These items can be manually added to the model using the commands listed below: | |
− | + | * Depth varying manning's n (shallow n): ''Read Materials File == <file>'' | |
− | + | * Distributed hydrology rainfall inflow data: ''Read GIS RF == <file>'' | |
− | + | * Infiltration and evaporation data: ''Read Soils File == file.tsoilf'' | |
− | + | * 1D channel data: ''ESTRY Control File == <.ecf_file>'' | |
− | + | * Levee breakline features: ''Read GIS Z Shape == <file>'' | |
− | + | * Dam and levee breach data: ''Read GIS Variable Z Shape == <file>'' | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<br> | <br> | ||
− | + | {{Tips Navigation | |
− | + | |uplink=[[Main_Page| Back to Main Page]] | |
− | + | }} | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Latest revision as of 10:14, 21 December 2023
Introduction
This page outlines some utilities that may be used to convert FLO2D model files into a format which is compatible with TUFLOW. The utilities are available for download from the TUFLOW website.
If you have any suggestions to be included in these pages, please contact support@tuflow.com.
Model Conversion Utility (FLO2D_to_GIS.exe)
The flo2d_to_gis.exe utility creates a complete TUFLOW model from FLO-2D model data. The utility converts the following data into a TUFLOW compatible format:
- Model origin, grid orientation, extent and resolution information
- Topography datasets
- Landuse delineation
- Storage adjustment features
- Width reduction factors (flow constriction features)
- Inflow/outflow locations
- Boundary condition time series data
These datasets are written to the standard TUFLOW model folder structure. TUFLOW control files are also output (tcf, tcg, tbc, boundary condition database).
Note: This utility is currently still in its beta testing phase. Output should be carefully quality checked.
Utility Execution
The TUFLOW Model Conversion (TMC) file is used to define the input files and projection information required by the utility. Steps how to create a TMC file and run the utility are as follows:
- Place a copy of the flo2d_to_GIS.exe utility in the same location as the FLO2D model files.
- Create a new text file in the same location as the FLO2D model files. The name must have the extension ".tmc". For example the file name could be "run_model_Conversion.tmc".
- Enter the relevant command syntax (shown in italics below).
- The model conversion can be run either by dragging the TMC file onto the flo2d_to_GIS.exe utility, or from a batch file. Steps to create a batch file are:
- Create a new text file in the same location as the TMC and FLO-2D files. The file name must have the extension ".bat". For example, "run_FLO2D_to_GIS.bat".
- Reference the executable, specify the batchfile flag (-b) and the TMC file name within the text file. Additional conversion references can be specified in series to process multiple models in sequence, for example:
- flo2d_to_GIS.exe -b conv1.tmc
- flo2d_to_GIS.exe -b conv2.tmc
- flo2d_to_GIS.exe -b conv3.tmc
- Double click the batch file in windows explorer to execute the model conversion.
Required TMC File Inputs:
- FLO-2D floodplain grid element data file:
- FLO2D FPLAIN == <Filename>
- FLO-2D co-ordinate point data file:
- FLO2D CADPTS == <Filename>
- FLO-2D inflow hydrograph data file:
- FLO2D INFLOW == <Filename>
- FLO-2D outflow hydrograph data file:
- FLO2D OUTFLOW == <Filename>
- Projection Data (four available options)
- MI Projection == <coordinate projection line from .mif file>
- MI Projection File == <link to .mif file used for setting projection>
- SHP Projection == <coordinate projection line from .prj file>
- SHP Projection File == <link to .prj file used for setting projection>
Optional TMC File Inputs:
- FLO-2D floodplain area and width reduction data file:
- FLO2D ARF == <Filename>
Example Syntax
Description: Convert a FLO2D model into TUFLOW format using a shp projection file
FLO2D FPLAIN == FPLAIN.DAT FLO2D CADPTS == CADPTS.DAT FLO2D INFLOW == INFLOW.DAT FLO2D OUTFLOW == OUTFLOW.DAT FLO2D ARF == ARF.DAT !#Optional SHP Projection File == Projection.prj
Description: Convert a FLO2D model into TUFLOW format using a mif coordinate projection line from
FLO2D FPLAIN == FPLAIN.DAT FLO2D CADPTS == CADPTS.DAT FLO2D INFLOW == INFLOW.DAT FLO2D OUTFLOW == OUTFLOW.DAT FLO2D ARF == ARF.DAT !#Optional MI Projection == CoordSys NonEarth Units "survey ft" Bounds (1910000, 14400000) (2000000, 14500000)
Utility Output
flo2d_to_gis.exe will convert the FLO-2D model into a working TUFLOW model titled: conv_001.tcf
The following items from the FLO-2D model will be included within the TUFLOW model:
- Model origin, grid orientation, extent and resolution
- Topography (elevation) datasets
- Landuse delineation information (non-varying with depth)
- Storage adjustment features
- Width reduction factors (flow constriction features)
- Inflow/outflow locations
- Boundary condition time series data
- Output interval commands
The TUFLOW model time step will be set based on a pre-defined ratio of the model grid size. This value should be reviewed by the modeller and updated if necessary.
Model Conversion Limitations
Some FLO-2D datasets will not automatically be translated across to the TUFLOW model. These items can be manually added to the model using the commands listed below:
- Depth varying manning's n (shallow n): Read Materials File == <file>
- Distributed hydrology rainfall inflow data: Read GIS RF == <file>
- Infiltration and evaporation data: Read Soils File == file.tsoilf
- 1D channel data: ESTRY Control File == <.ecf_file>
- Levee breakline features: Read GIS Z Shape == <file>
- Dam and levee breach data: Read GIS Variable Z Shape == <file>
Up |
---|
Back to Main Page |