Appendix A - Grid Formats
- Kester Scandrett
Native CVLGrid Formats
Data Format A-1 - CVL File
The CVL file is the native CVLGrid grid file. The header lines describe the format for the grid.
Example
____________________________________________________________________________________________________
* DSI CVLGrid Version 1.1
*
* The 1st line: CVLGrid file format version
* The 2nd line: # row, # col, coordinate system (0-Cartesian),
* UTM zone (default 0, > 0 for northern hemisphere, < 0 for southern hemisphere),
* 3 parameters (scale and shift for X and Y, default 1, 0, 0),
* 2 parameters (scale and shift, default 1 and 0) for vertical units conversion Z.
* Other lines: I, J (corner nodes), Cell Type, X, Y, Z LL Corner Coordinate
CVLGridFormat=1.0
136 280 0 0 1 0 0 1 0
1 157 5 4.917964931152040E+05 5.242959347802510E+06 0
1 158 5 4.912742546024100E+05 5.243034901705380E+06 0
1 159 5 4.907515911957290E+05 5.243117804821200E+06 0
1 160 5 4.902472357772360E+05 5.243210643889140E+06 0
1 161 5 4.897719663253260E+05 5.243314696917570E+06 0
1 162 5 4.893519862918540E+05 5.243423351823180E+06 0
Data Format A-2 P2D Polyline/Polygon File.
Any number of polylines/polygons can reside in the same file. Each one begins with a single line header that is used as the "ID" of the polyline/polygon. Next comes the data in either 2D or 3D format, the importing automatically handles either. Finally the polyline/polygon is finished (not necessarily "closed") by an "*" in column 1. There is no difference between polyline and polygon in a P2D file, only how the data are treated by the application reading the file.
Example
____________________________________________________________________________________________________
Polyline Test
609115.69390674 3643612.72035394 0
608828.057738002 3642922.39387814 0
608569.186338242 3642232.06904821 0
608396.604307826 3640908.94563456 0
...
...
...
601493.350247946 3628713.19503985 0
601464.586301899 3627763.99747289 0
601522.11337106 3627016.14485373 0
601522.11337106 3626642.21854415 0 *
General Grid Formats
Data Format A-3 DXDY/LXLY
Example
____________________________________________________________________________________________________
C DXDY.INP FILE, IN FREE FORMAT ACROSS COLUMNS for 9322 Active Cells
C Project: AWWU BE
C BOTTOM Veg
C I J DX DY DEPTH ELEV ZROUGH TYPE
3 41 713.7 1052.2 0.081 7.992 0.0010
3 42 693.1 1022.4 0.081 6.552 0.0010
3 43 674.6 996.8 0.081 8.050 0.0010
3 44 657.2 894.7 0.081 8.044 0.0010
3 45 640.1 1026.0 0.081 8.143 0.0010
3 46 622.5 942.8 0.081 6.302 0.0010
3 47 605.0 869.4 0.081 8.317 0.0010
4 27 879.6 1627.8 0.081 6.200 0.0010
4 40 690.6 1080.7 0.081 7.607 0.0010
Example
____________________________________________________________________________________________________
C LXLY.INP FILE, IN FREE FORMAT ACROSS LINE for 9322 Active Cells
C Project: AWWU BE
C WIND
C I J X Y CUE CVE CUN CVN SHELTER
3 41 624703.9 6794905.0 0.23872 0.97109 -0.97109 0.23872 1.00
3 42 625713.0 6795145.1 0.22543 0.97426 -0.97426 0.22543 1.00
3 43 626698.3 6795365.6 0.21242 0.97718 -0.97718 0.21242 1.00
3 44 627623.9 6795560.3 0.20017 0.97976 -0.97976 0.20017 1.00
3 45 628566.2 6795745.9 0.18848 0.98208 -0.98208 0.18848 1.00
3 46 629534.1 6795924.9 0.17670 0.98426 -0.98426 0.17670 1.00
3 47 630427.0 6796079.0 0.16587 0.98615 -0.98615 0.16587 1.00
4 27 610220.5 6788565.6 0.48437 0.87486 -0.87486 0.48437 1.00
4 40 623852.8 6793953.4 0.27212 0.96226 -0.96226 0.27212 1.00
4 41 624875.6 6794236.1 0.25910 0.96585 -0.96585 0.25910 1.00
4 42 625870.4 6794492.8 0.24376 0.96984 -0.96984 0.24376 1.00
Data Format A-4 Corners(4)
Example
____________________________________________________________________________________________________
* 07-Oct-07 3:49:15 PM
* I J X Y
3 3 147268.3 211473.6 147427.3 211409.0 147474.5 211475.5 147312.4 211573.0
4 3 147312.4 211573.0 147474.5 211475.5 147538.3 211555.3 147374.2 211687.1
5 3 147374.2 211687.1 147538.3 211555.3 147622.8 211650.0 147452.3 211811.0
6 3 147452.3 211811.0 147622.8 211650.0 147726.5 211758.3 147545.0 211943.4
7 3 147545.0 211943.4 147726.5 211758.3 147843.6 211876.1 147649.1 212082.4
8 3 147649.1 212082.4 147843.6 211876.1 147970.5 212002.1 147760.9 212226.5
9 3 147760.9 212226.5 147970.5 212002.1 148102.9 212134.7 147876.0 212373.1
Grid Formats from Other Models Imported into CVLGrid
Data Format A-5 ECOMSED
ECOMSED is a three-dimensional hydrodynamic and sediment transport computer code developed by HydroQual.
Example of Grid
____________________________________________________________________________________________________
ECOMSED ST CHANNEL GRID 255X 161
2 SIGMA LEVELS
2
0.00
-1.00
HORIZONTAL SEGMENTATION: 186.1318 M BY 283.3225 M
257 163
176 3 186.13180 283.32250 0.00 112.46 27.145591 -122.122904 0.00
177 3 187.18390 283.09130 0.00 112.44 27.147153 -122.123611 0.00
178 3 187.63180 282.70260 0.00 112.41 27.148721 -122.124321 0.00
179 3 188.10340 282.10040 0.00 112.38 27.150294 -122.125031 0.00
180 3 188.34230 281.25040 0.00 112.34 27.151870 -122.125741 0.00
181 3 188.27640 280.11520 0.00 112.29 27.153447 -122.126450 0.00
182 3 187.84130 278.66650 0.00 112.24 27.155023 -122.127157 0.00
Data Format A-6 Grid95
Grid95 is a public domain grid generator. The output from Grid95 can be directly imported into EFDC_Explorer's model generation function using the GRD saved results file. Refer to the user manual for Grid95 for details on the format.
Example of Grid
____________________________________________________________________________________________________
41 11
-17.500000000000000 -20.000000000000000
-19.489228298202900 -20.000000000000000
-21.687665562789850 -20.000000000000000
-24.117314492825130 -20.000000000000000
-26.802491831433730 -20.000000000000000
-29.770071735939730 -20.000000000000000
-33.049754743465460 -20.000000000000000
-36.674365023889780 -20.000000000000000
-40.680178895172740 -20.000000000000000
-45.107287888938710 -20.000000000000000
-50.000000000000000 -20.000000000000000
-17.388450867189730 -18.180965079699230
-19.352817413073470 -18.069105224173820
Data Format A-7 SEAGRID
SeaGrid is a Matlab 5.2+ application for generating an orthogonal grid within a curved perimeter, suitable for oceanographic modeling.
Example of Grid
____________________________________________________________________________________________________
Created by SeaGrid on 22-Dec-2015 14:52:03
Vertical Segmentation - Sigma Levels (KB)
2
0.00
-1.00
Horizontal Segmentation (IM & JM) -- Grid Information
257 163
176 3 186.13180 283.32250 0.00 112.46 0.00000 0.00000 -122.122904 27.145591
177 3 187.18390 283.09130 0.00 112.44 0.00000 0.00000 -122.123611 27.147153
178 3 187.63180 282.70260 0.00 112.41 0.00000 0.00000 -122.124321 27.148721
179 3 188.10340 282.10040 0.00 112.38 0.00000 0.00000 -122.125031 27.150294
180 3 188.34230 281.25040 0.00 112.34 0.00000 0.00000 -122.125741 27.151870
181 3 188.27640 280.11520 0.00 112.29 0.00000 0.00000 -122.126450 27.153447
Data Format A-8 CH3D
CH3D is a Curvilinear-grid Hydrodynamics 3D model developed originally by Dr. Y. Peter Sheng at the Aeronautical Research Associates of Princeton, Inc in the 1980s.
Example of Grid
____________________________________________________________________________________________________
CH3D GRID (FORT 15) FILE
404 761
0.733960125000E+06 0.530563984375E+05 0.274899997711E+02 1 1
0.734032812500E+06 0.531251015625E+05 0.275000000000E+02 2 1
0.734105375000E+06 0.531938007812E+05 0.274899997711E+02 3 1
0.734178125000E+06 0.532625000000E+05 0.274799995422E+02 4 1
0.734250812500E+06 0.533311992188E+05 0.274699993134E+02 5 1
0.734323375000E+06 0.533998984375E+05 0.274799995422E+02 6 1
0.734396125000E+06 0.534686015625E+05 0.274799995422E+02 7 1
Data Format A-9 Delft RGFGrid
Refer to the Delft RGFGrid user guide.