WMS:XY Series Files: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
No edit summary
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
The [[WMS:XY Series Editor|XY Series Editor]] is used in several places in WMS. The XY Series Editor is a general purpose editor for entering curves or pairs of lists of data. The XY Series Editor allows a curve to be imported from a file, created and edited graphically, or created and edited using two columns of edit fields in a spreadsheet-like interface.
The [[WMS:XY Series Editor|XY Series Editor]] is used in several places in WMS. The'' XY Series Editor'' is a general purpose editor for entering curves or pairs of lists of data. The ''XY Series Editor'' allows a curve to be imported from a file, created and edited graphically, or created and edited using two columns of edit fields in a spreadsheet-like interface.


XY series files can be used to prepare a set of curves for import to the XY Series Editor. XY series files are also used to export curves generated within the Editor for future use.
XY series files can be used to prepare a set of curves for import to the XY Series Editor. XY series files are also used to export curves generated within the Editor for future use.


The format of the XY Series File is shown in Figure 1, and a sample file is shown in Figure 2. Curves are defined in an XY Series File using one of three types of cards: XY1, XY2, or XY3. With the XY1 card, both the x and y values are listed for each point on the curve. There is no limit to the spacing or interval used between subsequent x values. The XY2 card is identical to the XY1 card except that the number of points and the x values are assumed to be static and cannot be altered by the user. With the XY3 card, the x values are defined by a beginning x value, an initial increment in x, and a percent change in x per increment. Only the y values are explicitly listed.
The format of the XY Series File is shown in Figure 1, and a sample file is shown in Figure 2. Curves are defined in an XY Series File using one of three types of cards: XY1, XY2, or XY3. With the XY1 card, both the x and y values are listed for each point on the curve. There is no limit to the spacing or interval used between subsequent x values. The XY2 card is identical to the XY1 card except that the number of points and the x values are assumed to be static and cannot be altered. With the XY3 card, the x values are defined by a beginning x value, an initial increment in x, and a percent change in x per increment. Only the y values are explicitly listed.


{|class="wikitable" style="border:1px #AAA solid;"
{|class="wikitable" style="border:1px #AAA solid;"
|+ align="bottom"|''Figure 1. The XY Series File Format''
|width="250"|XY1 id n dx dy rep begc name
|width="250"|XY1 id n dx dy rep begc name
|width="250"|/* XY Series vers. #1 */
|width="250"|/* XY Series vers. #1 */
Line 13: Line 14:
|x<sub>2</sub> y<sub>2</sub>||/* XY values */
|x<sub>2</sub> y<sub>2</sub>||/* XY values */
|-
|-
|.
|. ||
|-
|-
|.
|. ||
|-
|-
|x<sub>n</sub> y<sub>n</sub>
|x<sub>n</sub> y<sub>n</sub> ||
|-
|-
|XY2 id n dx dy rep begc name||/* XY Series vers. #2 */
|XY2 id n dx dy rep begc name||/* XY Series vers. #2 */
Line 23: Line 24:
|x<sub>1</sub> y<sub>1</sub>||/* XY values */
|x<sub>1</sub> y<sub>1</sub>||/* XY values */
|-
|-
|x<sub>2</sub> y<sub>2</sub>
|x<sub>2</sub> y<sub>2</sub> ||
|-
|-
|.
|. ||
|-
|-
|.
|. ||
|-
|-
|x<sub>n</sub> y<sub>n</sub>
|x<sub>n</sub> y<sub>n</sub> ||
|-
|-
|XY3 id n x1 incx pcx dx dy rep begc name||/* XY Series vers. #2 */
|XY3 id n x1 incx pcx dx dy rep begc name||/* XY Series vers. #2 */
Line 37: Line 38:
|y<sub>1</sub>||/* Y values */
|y<sub>1</sub>||/* Y values */
|-
|-
|y<sub>2</sub>
|y<sub>2</sub> ||
|-
|-
|.
|. ||
|-
|-
|.
|. ||
|-
|-
|y<sub>n</sub>
|y<sub>n</sub> ||
|}
|}
''Figure 1. The XY Series File Format.''


{|{|class="wikitable" border="1"
{|class="wikitable"  
|+ align="bottom"|''Figure 2. The Sample XY Series File''
|-
|-
|width="400"|XY3 1 241 0 6 0 0 0 0 0 typeI-24hour
|width="400"|XY3 1 241 0 6 0 0 0 0 0 typeI-24hour
Line 61: Line 62:
|1.0000
|1.0000
|}
|}
''Figure 2. The Sample XY Series File.''


The card types used in the XY series file format are as follows:
The card types used in the XY series file format are as follows:


{|border="1" style="text-align:center"
{|class="wikitable" style="text-align:center"
|-
|-
|''Card Type''
|''Card Type''
Line 102: Line 102:




{|border="1" style="text-align:center
{|class="wikitable" style="text-align:center
|-  
|-  
|width="150" style="text-align:center"|''Card Type''
|width="150" style="text-align:center"|''Card Type''
Line 108: Line 108:
|-
|-
|style="text-align:center"|''Decription''
|style="text-align:center"|''Decription''
|style="text-align:center"|Defines a curve with a list of XY values. This card is identical to the XY1 card except that the number of points and the x values are assumed to be static and cannot be altered by the user.
|style="text-align:center"|Defines a curve with a list of XY values. This card is identical to the XY1 card except that the number of points and the x values are assumed to be static and cannot be altered.
|}
|}




{|border="1" style="text-align:center"
{|class="wikitable" style="text-align:center"
|-
|-
|''Card Type''
|''Card Type''
Line 162: Line 162:


{{WMSMain}}
{{WMSMain}}
[[Category:File Formats]]
[[Category:WMS File Formats|X]]
[[Category:WMS Plot]]

Latest revision as of 15:22, 10 January 2017

The XY Series Editor is used in several places in WMS. The XY Series Editor is a general purpose editor for entering curves or pairs of lists of data. The XY Series Editor allows a curve to be imported from a file, created and edited graphically, or created and edited using two columns of edit fields in a spreadsheet-like interface.

XY series files can be used to prepare a set of curves for import to the XY Series Editor. XY series files are also used to export curves generated within the Editor for future use.

The format of the XY Series File is shown in Figure 1, and a sample file is shown in Figure 2. Curves are defined in an XY Series File using one of three types of cards: XY1, XY2, or XY3. With the XY1 card, both the x and y values are listed for each point on the curve. There is no limit to the spacing or interval used between subsequent x values. The XY2 card is identical to the XY1 card except that the number of points and the x values are assumed to be static and cannot be altered. With the XY3 card, the x values are defined by a beginning x value, an initial increment in x, and a percent change in x per increment. Only the y values are explicitly listed.

Figure 1. The XY Series File Format
XY1 id n dx dy rep begc name /* XY Series vers. #1 */
x1 y1 /* XY values */
x2 y2 /* XY values */
.
.
xn yn
XY2 id n dx dy rep begc name /* XY Series vers. #2 */
x1 y1 /* XY values */
x2 y2
.
.
xn yn
XY3 id n x1 incx pcx dx dy rep begc name /* XY Series vers. #2 */


y1 /* Y values */
y2
.
.
yn
Figure 2. The Sample XY Series File
XY3 1 241 0 6 0 0 0 0 0 typeI-24hour
0.00000
0.00174
.
.
1.0000

The card types used in the XY series file format are as follows:

Card Type XY1
Description Defines a curve with a list of XY values. Any number of points and any x spacing between points may be used.
Required NO
Format XY1 id n dx dy rep begc name
x1 y1
x2
y2
.
.
xn
yn
Sample XY1 1 5 0 0 0 0 head
0.0 0.0
1.0 2.0
2.5 7.0
3.0 8.0
4.5 9.5
'Field Variable Value Description
1 id + The id of the XY series.
2 n + The number of point in the series.
3 dx 0,1 A flag defining whether the x values listed are to be interpreted as incremental (dx=1) or absolute (dx=0).
4 dy 0,1 A flag defining whether the y values listed are to be interpreted as incremental (dy=1) or absolute (dy=0).
5 rep 0,1 A flag defining whether the xy series is to be interpreted as cyclic (repeating)
6 begc "+/-" The x value in the series where the cyclic portion of the curve begins. Value is ignored if rep=0.
7 name str The name of the series
8-9 x,y "+/-" The xy values of the points defining the curve. Repeat n times.


Card Type XY3
Decription Defines a curve with a list of XY values. This card is identical to the XY1 card except that the number of points and the x values are assumed to be static and cannot be altered.


Card Type XY3
Description Defines a curve with a list of Y values. The x values are defined by a beginning value, an increment, and a bias.
Required NO
Format XY3 id n x1 incx biasx dx dy rep begc name
y1
y2
.
.
yn
Sample XY3 1 10 0 1 0 0 0 0 0 head
0.0
2.0
7.0
8.0
9.5
'Field Variable Value Description
1 id + The id of the XY series.
2 n + The number of point in the series.
3 x1 "+/-" The first x value.
4 incx "+/-" The increment in x used to compute the next x value.
5 pcx + The per cent change in x used to compute subsequent x values. Expressed as a decimal, i.e., 0.05 = 5%.
6 dx 0,1 A flag defining whether the x values listed are to be interpreted as incremental (dx=1) or absolute (dx=0).
7 dy 0,1 A flag defining whether the y values listed are to be interpreted as incremental (dy=1) or absolute (dy=0).
8 rep 0,1 A flag defining whether the xy series is to be interpreted as cyclic (repeating)
9 begc "+/-" The x value in the series where the cyclic portion of the curve begins. Value is ignored if rep=0.
10 name str The name of the series
11 y "+/-" The y values of the points defining the curve. Repeat n times.


Related Topics