Parameter lists in detail:

ATTRIB

Attribute

Describes attributes considered within an XML section Attributes are the field provided within the opening tag, for field "href" in the following example: //...">

Usage: ATTRIB SECTION
1 parameter in this list:

SECTION

 Section name. In case of ambiguity, the name may include the name of the enclosing section, for example: "station.epoch". If the section was not defined in list SECTION, it is added.
  • Format: Character (80 characters)
  • Default value: Not specified

1 group of 5 REPEAT parameters per line:

This repeat list gives the names of XML attributes (fields given within the main tag) of section NAME from which trace headers may be loaded. Multiple references to the same subsection (SUBSECT) can be used to output multiple trace headers (for example, in different formats)

ATTRIB

 Name of XML attribute considered within this section
  • Format: Character (24 characters)
  • Default value: Not specified

FIELD

 Number of the field in the record written into HEADER. The fields can be separated by white spaces, tabs, newlines, commas, semicolons, or colons
  • Format: INTEGER
  • Min value: 1
  • Default value: 1

HEADER

 Trace header loaded from this attribute
  • Format: Character (8 characters)
  • Default value: Not specified

FORMAT

 Format of the trace header created.
  • Format: Header entry format: float, double, integer, long, or char
  • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
  • Default value: Not specified

TRNSFRM

 Name of the transformation of the string for converting into trace header value (case-insensitive):
  1. %skipalpha - skip all non-numeric characters and then use standard format conversions or other in this list;
  2. %timeIRISws - IRIS web service time string;
  3. %timeBREQFAST - IRIS Breqfast time string;
  4. %timeNETDC - IRIS NetDC time string;
  5. %timesql: - SQL time string;
  6. %timephp: - PHP time string;
  7. %f, %d, %e - standard conversions in C style;
  8. %g (or NONE) - no transformation, the value is obtained by standard scanf in C.
NOTE: of time formats, currently, only %timeIRISws is implemented.
  • Format: Character (36 characters)
  • Default value: NONE

DATA

Data values

Describes handling of the DATA string within an XML section.

The DATA is the text contained between the opening and closing tags, for example for tag 'georss:point' from NRCAN: '51.0831 -130.7587'. This example contains two fields in the DATA text (51.0831 -130.7587), which can be extracted in two trace headers.

Usage: DATA SECTION
1 parameter in this list:

SECTION

 Section name. In case of ambiguity, the name may include the name of the enclosing section, for example: "station.epoch". If the section was not defined in list SECTION, it is added.
  • Format: Character (80 characters)
  • Default value: Not specified

1 group of 4 REPEAT parameters per line:

This repeat list describes output of trace headers from DATA field

FIELD

 Number of the field in the record written into HEADER. The fields can be separated by white spaces, tabs, newlines, commas, semicolons, or colons
  • Format: INTEGER
  • Min value: 1
  • Default value: 1

HEADER

 Trace header loaded from this field
  • Format: Character (8 characters)
  • Default value: Not specified

FORMAT

 Format of the trace header created.
  • Format: Header entry format: float, double, integer, long, or char
  • Min value: Integer:INT|Real:REAL|Long:LONG|Double:DOUBLE|c...:EDIT
  • Default value: Not specified

TRNSFRM

 Name of the transformation of the string for converting into trace header value (case-insensitive):
  1. %skipalpha - skip all non-numeric characters and then convert to integer, float, or double;
  2. %timeIRISws - IRIS web service time string (format YYYY-MM-DDThh:mm:ss[.ssssss], for example 1997-01-31T12:04:32.123);
  3. %timeBREQFAST - IRIS Breqfast time string;
  4. %timeNETDC - IRIS NetDC time string;
  5. %timesql: - SQL time string;
  6. %timephp: - PHP time string;
  7. %g (or NONE) - no transformation, the value is obtained by standard scanf in C.
NOTE: of time formats, currently, only %timeIRISws is implemented.
  • Format: Character (36 characters)
  • Default value: NONE

Preceding list (ATTRIB)

GENTRC

Generate trace

Specifies which sections generate seismic traces. When such a section is processed, a trace is generated and all enclosing sections put their trace headers into it.

Usage: GENTRC DT NSAMP SECTION
3 parameters in this list:

DT

 Sampling interval set in the output trace
  • Format: FLOAT
  • Default value: 1.0

NSAMP

 Number of samples in the output trace
  • Format: INTEGER
  • Default value: 1

SECTION

 Section name. In case of ambiguity, the name may include the name of the enclosing section, foir example: "station.epoch". If the section was not defined in list SECTION, it is added.
  • Format: Character (64 characters)
  • Default value: Not specified

Preceding list (DATA)

PRINT

Print

Print out contents of selected sections (done when reading traces)

Usage: PRINT WHAT FNAME
2 parameters in this list:

WHAT

 Key word specifying what to print in sections whose names are given in REPEAT lists:
  1. TAGS (ot TAG) - prints all tags encountered in the selected section
  2. CONTENT (or TEXT, STRING) - prints contents of the selected secions
  3. ATTR (or ATTRIB) - prints names and values of attributes in this section
  4. HEADER - trace headers produced from the records
  5. ALL - prints everything in the selected sections
  • Format: Selection
  • Selectable Values: (codes in parentheses)
    • tags (TAGS)
    • Content (CONTENT)
    • Tags and Content (ALL)
  • Default value: Not specified

FNAME

 Name of output file for printout. "*" will mean current job output
  • Format: Character (80 characters)
  • Default value: *

1 group of 1 REPEAT parameter per line:

This repeat list lists masks for selecting sections that need to be printed out. Multiple masks are combined using 'or' operation

SECTION

 String selecting what sections to print. Text string matching can be used, and subsections can be concatenated with ".". For example, "*" prints all sections in the XML input, "*.chan*" selects second-level sections with names starting from "chan", etc.)
  • Format: Character (80 characters)
  • Default value: Not specified

Preceding list (GENTRC)

SECTION

Section

These lists contain the sections considered within the XML document. For each section NAME, the Repeat list gives the subsections from which outputs will be made. If no SECTION lists are used, all XML sections will be loaded. Within the loaded sections, data selections aer made by lists ATTRIB, DATA, and GENTRC

Usage: SECTION SECTION
1 parameter in this list:

SECTION

 Section name. In case of ambiguity, the name may include the name of the enclosing section, for example: "station.epoch". Empty name means the whole XML document.
  • Format: Character (80 characters)
  • Default value: Not specified

1 group of 1 REPEAT parameter per line:

This repeat list gives the names of XML subsections (tags) of section NAME from which trace headers may be loaded. Multiple references to the same subsection (SUBSECT) can be used to output multiple trace headers (for example, in different formats)

SUBSECT

 Name of subsection considered within this section
  • Format: Character (24 characters)
  • Default value: Not specified

Preceding list (PRINT)

TEMPLAT

Print template

Reads through the XML file and prints out its structure in the format ready for editing, adding trace headers, and using in the call to READXML in the job. When using this option, no other operations are performed by READXML

Usage: TEMPLAT FNAME
1 parameter in this list:

FNAME

 File name for the output template
  • Format: Character (80 characters)
  • Default value: Not specified

Preceding list (SECTION)
IGeoS version 5.1
Copyright (c) 1995-2015, I.B.Morozov
Updated Wed Apr 1 21:42:24 2020