Template:Import UGrid Points: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
(Created page with "__NOINDEX__ {{-}} <noinclude>Category:Tools</noinclude>")
 
No edit summary
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOINDEX__
__NOINDEX__
__NOTOC__
===Import UGrid Points===
The ''Import UGrid Points'' tool is used to import locations and datasets. The CSV file must contain coordinates for the points and, optionally, the file may contain datasets associated with the points.


The first line of the CSV file must be a header line with the coordinate columns of x, y, and z (optional). These columns must be named x, y, z. An error will be encountered if these columns do not exist.
Other columns may exist in the file for datasets. The dataset name is specified in the first line of the file.  If the column does not have a name then the column will be skipped.
Transient data may also be imported using this tool. Transient datasets comprise multiple columns in the file with the same column name and with time specified on the second line of the file in the associated dataset column. There may not be any value specified on the second line of the file for the x, y coordinates. The time values may be relative times: 0.0, 2.5, 10.0, etc. Additionally, the time values may be specified as date times. The date format should be in the form of YEAR-MONTH-DAY HH:MM:SS.SS.
Multiple example files are shown below.
====Input parameters====
*''CSV file with point coordinates and datasets'' – Shows the file name for the CSV file containing the coordinates and datasets. Clicking the '''Select File''' button will open a ''Select File'' browser dialog to select the CSV file.
*''No data value'' – When the “No data value” is encountered in the csv file in one of the datasets XMS marks the value as “NULL” or “no data”. These values are not contoured or used in interpolation in XMS.
*''Time unit'' – The time unit for transient datasets where the time is specified as a floating point number (in contrast to a date time).
*''Coordinate system project file (*.prj)'' – Shows the file name for the projection associated with the coordinates of the points in the file. Clicking the '''Select File''' button will open a ''Select File'' browser dialog to select the PRJ file.
<!--
====Output parameters====
*The output is a ugrid and datasets but these are not visible to the user in the tool. Not sure if anything should go here.
-->
====Current location in Toolbox====
Unstructured Grids/Import UGrid Points
====Example files====
=====Example 1=====
id,y,x,c
1,15459458,2685809,6.4
2,15459506,2685824,9.7
3,15459524,2685850,8
This is a simple csv file. Notice the “x” and  “y” columns;  these are required. Note that “z” is not required. Also, notice that the order of x and y does not matter.
The other 2 columns: “id”, “c”. The will be imported as datasets.
=====Example 2=====
y x z TDS TDS conc
0 1
-16 -75 8.5 59.04 9.24 1.9
32 -60 9.8 90.2 71 4.8
50 -34 0.7 67.2 98.4 9.5
This example shows a file with “x”, ”y”, and “z” columns. Notice that there are no values on the second line of the file for x, y, and z. This indicates that times are being specified for the datasets in the file.
The other 2 columns: “TDS” and “conc”. The will be imported as datasets. TDS will be a transient dataset with times of 0.0 and 1.0. The user will have to specify the units of the times in the tool. The conc dataset will be imported without multiple time steps.
=====Example 3=====
y x c2 c2 c2
2011-02-01 2012-02-01 2013-02-01
-16 -75 59.04 43.64 9.24
32 -60 90.2 44.16 71
50 -34 67.2 0 98.4
This is a csv file with a transient dataset with the time specified as dates.
=====Example 4=====
y X c2 c2 c2
2011-02-01 15:30:22.1 2012-02-01 2013-02-01 6:45:15
-16 -75 59.04 43.64 9.24
32 -60 90.2 44.16 71
50 -34 67.2 0 98.4
This is a csv file with a transient dataset with the time specified as dates and times.


{{-}}
{{-}}
<noinclude>[[Category:Tools]]</noinclude>
<noinclude>[[Category:Toolbox UGrid]]</noinclude>

Latest revision as of 15:33, 24 October 2023


Import UGrid Points

The Import UGrid Points tool is used to import locations and datasets. The CSV file must contain coordinates for the points and, optionally, the file may contain datasets associated with the points.

The first line of the CSV file must be a header line with the coordinate columns of x, y, and z (optional). These columns must be named x, y, z. An error will be encountered if these columns do not exist.

Other columns may exist in the file for datasets. The dataset name is specified in the first line of the file. If the column does not have a name then the column will be skipped.

Transient data may also be imported using this tool. Transient datasets comprise multiple columns in the file with the same column name and with time specified on the second line of the file in the associated dataset column. There may not be any value specified on the second line of the file for the x, y coordinates. The time values may be relative times: 0.0, 2.5, 10.0, etc. Additionally, the time values may be specified as date times. The date format should be in the form of YEAR-MONTH-DAY HH:MM:SS.SS.

Multiple example files are shown below.

Input parameters

  • CSV file with point coordinates and datasets – Shows the file name for the CSV file containing the coordinates and datasets. Clicking the Select File button will open a Select File browser dialog to select the CSV file.
  • No data value – When the “No data value” is encountered in the csv file in one of the datasets XMS marks the value as “NULL” or “no data”. These values are not contoured or used in interpolation in XMS.
  • Time unit – The time unit for transient datasets where the time is specified as a floating point number (in contrast to a date time).
  • Coordinate system project file (*.prj) – Shows the file name for the projection associated with the coordinates of the points in the file. Clicking the Select File button will open a Select File browser dialog to select the PRJ file.

Current location in Toolbox

Unstructured Grids/Import UGrid Points

Example files

Example 1
id,y,x,c
1,15459458,2685809,6.4
2,15459506,2685824,9.7
3,15459524,2685850,8

This is a simple csv file. Notice the “x” and “y” columns; these are required. Note that “z” is not required. Also, notice that the order of x and y does not matter.

The other 2 columns: “id”, “c”. The will be imported as datasets.

Example 2
y	x	z	TDS	TDS	conc
			0	1	
-16	-75	8.5	59.04	9.24	1.9
32	-60	9.8	90.2	71	4.8
50	-34	0.7	67.2	98.4	9.5

This example shows a file with “x”, ”y”, and “z” columns. Notice that there are no values on the second line of the file for x, y, and z. This indicates that times are being specified for the datasets in the file.

The other 2 columns: “TDS” and “conc”. The will be imported as datasets. TDS will be a transient dataset with times of 0.0 and 1.0. The user will have to specify the units of the times in the tool. The conc dataset will be imported without multiple time steps.

Example 3
y	x	c2	c2	c2
		2011-02-01	2012-02-01	2013-02-01
-16	-75	59.04	43.64	9.24
32	-60	90.2	44.16	71
50	-34	67.2	0	98.4

This is a csv file with a transient dataset with the time specified as dates.

Example 4
y	X	c2	c2	c2 
		2011-02-01 15:30:22.1	2012-02-01	2013-02-01 6:45:15
-16	-75	59.04	43.64	9.24
32	-60	90.2	44.16	71
50	-34	67.2	0	98.4

This is a csv file with a transient dataset with the time specified as dates and times.