WMS:File Import Wizard: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(29 intermediate revisions by one other user not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
WMS can read many files generated by other software in their native format. Refer to [[WMS:WMS Non-native Files|Non-native WMS Files]] for a list. For files that are not included in the list, WMS provides the ''Text Import Wizard''.
WMS can read many files generated by other software in their native format. Refer to [[WMS:WMS Non-native Files|Non-native WMS Files]] for a list. For files that are not included in the list, WMS provides the ''File Import Wizard''.


The ''Text Import Wizard'' enables users to import many different types of data into WMS. The ''Text Import Wizard'' is initialized by selecting a *.txt file in the '''Open''' command from the ''File'' menu, it can also be initiated by pasting data from a text file or spreadsheet into WMS using the [[WMS:Edit Menu#Paste|Paste]] command from the ''Edit'' menu.  
The ''File Import Wizard'' enables importing many different types of data into WMS. The ''File Import Wizard'' is initialized by selecting a *.txt file in the '''Open''' command from the ''File'' menu, it can also be initiated by pasting data from a text file or spreadsheet into WMS using the [[WMS:Edit Menu#Paste|Paste]] command from the ''Edit'' menu.  


The wizard has two steps.
The wizard has two steps.


[[WMS:Text Import Wizard#Step 1 – File Outline|Step 1 – Delimiting Columns]]
[[WMS:File Import Wizard#Step 1 – File Outline|Step 1 – Delimiting Columns]]


[[WMS:Text Import Wizard#Step 2 – Assigning Column Types|Step 2 – Assigning Column Types]]
[[WMS:File Import Wizard#Step 2 – Assigning Column Types|Step 2 – Assigning Column Types]]


===Step 1 – File Outline===
===Step 1 – File Outline===


The first step in the wizard allows users to delimit the data into columns. Two options exist to delimit the data.
The first step in the wizard allows delimiting the data into columns. Two options exist to delimit the data.
*''Delimited'' – Select to specify a delimiter. Typical delimiters are included.
*''Fixed Width'' – Can help to specify a column.


*Delimited
Columns can also be specified by clicking on the ruler bar or the window with the data. Break lines can be dragged, and they can be deleted by double-clicking on the break line or dragging them off the screen. Specify the starting row the data will be imported. If the data has a row of headings, indicate such, and WMS will use the headings in the next step to determine what kind of data each column represents.
*Fixed Width


For the ''Delimited'' option, typical delimiters are included as well as an option for users to specify a delimiter. Columns can also be specified with a fixed width by clicking on the ruler bar or the window with the data. Break lines can be dragged, and they can be deleted by double-clicking on the break line or dragging them off the screen. The user can specify the starting row the data will be imported. If your data has a row of headings, you can indicate such and WMS will use the headings in the next step to determine what kind of data each column represents.
[[Image:WMS File import wiz 1.jpg|thumb|none|left|500 px|Step 1 of the ''File Import Wizard'' dialog]]


[[Image:TI_1.jpg|frame|none|Step 2 (File Format) of the Text Import Wizard.]]
===Step 2 – Assigning Column Types===


==Step 2 – Assigning Column Types==
The first 20 lines of the file are displayed in a spreadsheet according to the file outline specified in step 1. This step allows picking what kind of data to import (see the supported formats below). A "no data flag" can be specified for the file. This is a number that, when encountered in the file, tells WMS to mark the value as "NULL" or "no data". If the file type is a scatter point, the file can be marked as transient. If the file is transient, only one dataset can be created and all dataset columns become time steps of the dataset.


The first 20 lines of the file are displayed in a spreadsheet according to the file outline specified in step 1. This step lets you pick what kind of data you are importing (see the supported formats below). A "no data flag" can be specified for the file. This is a number that, when encountered in the file, tells WMS to mark the value as "NULL" or "no data". If the file type is a scatter point, the file can be marked as transient. If the file is transient, only one dataset can be created and all dataset columns become time steps of the dataset.
The data in the columns are identified by selecting the type in the combo box at the top of each column in the spreadsheet. If a row of headings exists, WMS will automatically select the proper type if it recognizes the heading. Otherwise they are labeled "Not Mapped" by default. The available column types changes depending on the WMS data type selected. Certain column types must be mapped for each file format before progressing to the next step in the wizard. The name of each column is changed by editing the Header cell.


The data in the columns are identified by selecting the type in the combo box at the top of each column in the spreadsheet. If a row of headings exists, WMS will automatically select the proper type if it recognizes the heading. Otherwise they are labeled "Not Mapped" by default. The available column types changes depending on the WMS data type selected. Certain column types must be mapped for each file format before the user can progress to the next step in the wizard. The name of each column is changed by editing the Header cell.
[[Image:WMS File Import Wiz 2.jpg|thumb|none|left|500 px|Step 2 of the ''File Import Wizard'' dialog]]


[[Image:TI_2.jpg|frame|none|Step 2 (File Format) of the Text Import Wizard.]]
====File Import Filter Options====
[[Image:WMS File Import Filter Options.jpg|thumb|250 px|''File Import Filter Options'' dialog]]
 
In Step 2 of the ''File Import Wizard'' dialog, when selecting "Survey Data", "TIN Vertices", or "Catalog" ''WMS data types'' an '''Options''' button becomes active. Selecting this button will bring up the ''File Import Filter Options'' dialog.
* Filter Type
** nth Point
** Area
** Grid


==Supported Formats==
==Supported Formats==
The following types of data can be imported into WMS via the Text Import Wizard:
The following types of data can be imported into WMS via the ''File Import Wizard'':


*[[WMS:2D Scatter Point Module|2D Scatter Sets]]
*[[WMS:2D Scatter Point Module|2D Scatter Sets]]


===Fields===
==Fields==
A description of the fields (columns) that WMS recognizes when importing text files is provided in the tables below.
A description of the fields (columns) that WMS recognizes when importing text files is provided in the tables below.
    
    
{| border="1" cellpadding="2" style= text-align: center
{| class="wikitable" style= text-align: center
|-
|-
|colspan="4"|'''2D Scatter Points'''
!colspan="4"|'''2D Scatter Points'''
|-
|-
|width="100"|Field
|width="100"|'''Field'''
|width="100"|Type
|width="100"|'''Type'''
|width="100"|Required
|width="100"|'''Required'''
|width="100"|Comments
|width="100"|'''Comments'''
|-
|-
|X||Number||yes||   
|X||Number||yes||   
Line 54: Line 62:
|Material ID||Number||no||   
|Material ID||Number||no||   
|-
|-
|Data set||Number||no||One transient, or multiple steady state datasets.
|Dataset||Number||no||One transient, or multiple steady state datasets.
|-
|-
|colspan="4"|'''Example'''
!colspan="4"|'''Example'''
|-
|-
|colspan="4"|"id" "x" "y" "rain" "humidity"<br>"OW-21" 32.4 5234.3 300 -999<br>"OW-22" 93.4 5832.3 84 398<br>"OW-23" 83.3 8438.2 89 47
|colspan="4"|"id" "x" "y" "rain" "humidity"<br>"OW-21" 32.4 5234.3 300 -999<br>"OW-22" 93.4 5832.3 84 398<br>"OW-23" 83.3 8438.2 89 47
|}
|}


==Related Links==
==Related Links==
Line 68: Line 75:


{{WMSMain}}
{{WMSMain}}
[[Category:WMS General Information|F]]
[[Category:Importing Data]]
[[Category:WMS Import Dialogs]]
[[Category:WMS File Format Dialogs]]

Latest revision as of 20:51, 4 May 2020

WMS can read many files generated by other software in their native format. Refer to Non-native WMS Files for a list. For files that are not included in the list, WMS provides the File Import Wizard.

The File Import Wizard enables importing many different types of data into WMS. The File Import Wizard is initialized by selecting a *.txt file in the Open command from the File menu, it can also be initiated by pasting data from a text file or spreadsheet into WMS using the Paste command from the Edit menu.

The wizard has two steps.

Step 1 – Delimiting Columns

Step 2 – Assigning Column Types

Step 1 – File Outline

The first step in the wizard allows delimiting the data into columns. Two options exist to delimit the data.

  • Delimited – Select to specify a delimiter. Typical delimiters are included.
  • Fixed Width – Can help to specify a column.

Columns can also be specified by clicking on the ruler bar or the window with the data. Break lines can be dragged, and they can be deleted by double-clicking on the break line or dragging them off the screen. Specify the starting row the data will be imported. If the data has a row of headings, indicate such, and WMS will use the headings in the next step to determine what kind of data each column represents.

Step 1 of the File Import Wizard dialog

Step 2 – Assigning Column Types

The first 20 lines of the file are displayed in a spreadsheet according to the file outline specified in step 1. This step allows picking what kind of data to import (see the supported formats below). A "no data flag" can be specified for the file. This is a number that, when encountered in the file, tells WMS to mark the value as "NULL" or "no data". If the file type is a scatter point, the file can be marked as transient. If the file is transient, only one dataset can be created and all dataset columns become time steps of the dataset.

The data in the columns are identified by selecting the type in the combo box at the top of each column in the spreadsheet. If a row of headings exists, WMS will automatically select the proper type if it recognizes the heading. Otherwise they are labeled "Not Mapped" by default. The available column types changes depending on the WMS data type selected. Certain column types must be mapped for each file format before progressing to the next step in the wizard. The name of each column is changed by editing the Header cell.

Step 2 of the File Import Wizard dialog

File Import Filter Options

File Import Filter Options dialog

In Step 2 of the File Import Wizard dialog, when selecting "Survey Data", "TIN Vertices", or "Catalog" WMS data types an Options button becomes active. Selecting this button will bring up the File Import Filter Options dialog.

  • Filter Type
    • nth Point
    • Area
    • Grid

Supported Formats

The following types of data can be imported into WMS via the File Import Wizard:

Fields

A description of the fields (columns) that WMS recognizes when importing text files is provided in the tables below.

2D Scatter Points
Field Type Required Comments
X Number yes
Y Number yes
Label Text no
Material ID Number no
Dataset Number no One transient, or multiple steady state datasets.
Example
"id" "x" "y" "rain" "humidity"
"OW-21" 32.4 5234.3 300 -999
"OW-22" 93.4 5832.3 84 398
"OW-23" 83.3 8438.2 89 47

Related Links