ASC to ASC: Difference between revisions

Content deleted Content added
No edit summary
 
(10 intermediate revisions by 3 users not shown)
Line 7:
 
=2023-03-AA (and later)=
<span style="color:red;font-size:14">This release incorporates new GIS/GRID formats included in the 2023-03-AA TUFLOW release. Some slight changes to the commandconsole linewindow interface have been made to accomodate the new formats therefore please be aware that some of behaviour in 2023 release contradicts documentation presented elsewhere on this page (these are explicitly listed in <b><u>[[#Changes_to_Old_Switches | Changes to Old Switches]]</u></b> below). Where contradiction occurs, the behaviour listed here is the latest information and supersedes the behaviour listed elsewhere. </span> <span style="font-size:11"></span><br>
 
The '''ASC_to_ASC-2023-03-AA''' release incorporates several new GIS formats - '''GeoTIFF''', '''GPKG''', '''NetCDF''' (note: NetCDF was previously supported but now has better integration with all operations). The commands are largely unchanged and now support input and output to a range of new formats.
Line 101:
*Converts the file "DEM_M01.asc" for .flt format.<br>
:<tt>asc_to_asc.exe -conv DEM_M01.asc</tt>
 
===No Data Values===
 
<b>"-ndv <val>"</b><br>
An additional option to set the "no data value" is also possible when running the conversion function: <tt>-ndv <val></tt>. Note, this option will identify NaN values ("not a number") in the input grid, and treat them as no data values during the conversion (regardless of whether they are explicitly labelled as "no data values" in the grid header). This is useful if the user wants to remove all NaN values from the grid. Note, from the 2025.1 release and onwards, NaN's values in grid inputs are always treated as “no data values” and therefore grids can be read into TUFLOW directly without undertaking the below process.
 
*Converts asc to tif and sets the "no data value" to -999
:<tt>asc_to_asc.exe -conv -tif -ndv -999 DEM_M01.asc</tt>
*Removes all NaN values in a tif and replace them with -999
:<tt>asc_to_asc.exe -conv -tif -ndv -999 <input.tif> -out <output.tif></tt><nowiki>**</nowiki><br>
<nowiki>**</nowiki> Note, in the above example it is important to specify an output name with <tt>-out</tt> when converting to the same format (e.g. tif to tif) as otherwise the output will overwrite the input.<br>
 
==Maximum==
Line 221 ⟶ 232:
'''"-brkline <gis file in 2d_zsh format>"'''<br>
This feature was added to the 2013-06-AA version of the utility.<br>
Extracts elevations from a DEM for breaklines in the 2d_zsh format. This GIS input should have four attributes, z, dz, width and shape_options, as described in the <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW manualManual]</u>. For the utility the '''dz''', '''shape_width''' and the '''shape_options''' are used. Valid shape_options are "Max" and "Min" or blank (average used). The utility will extract an elevation at each <u>vertex</u> along the line.<br>
Depending on the line width and DEM cell size, the following methods are used:<br>
* If the width is set to 0, the closest DEM value to the vertex is used. If a "shape_option" is specified this is ignored.