---
name: "x2sys_report"
section: "1gmt"
platform: "linux"
package: "gmt-common"
version: "5.4.5+dfsg-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/x2sys_report"
---

# x2sys\_report(1gmt)

Report statistics from crossover data base

## NAME

x2sys\_report - Report statistics from crossover data base

## SYNOPSIS

**x2sys\_report**  **-C***column*  **-T***TAG* \[ *coedbase.txt* \] \[  **-A** \] \[  **-I**\[*list*\] \] \[  **-L**\[*corrtable*\] \] \[  **-N***nx\_min* \] \[  **-Qe**\|**i** \] \[ \[  **-R***region* \] \[  **-S***track* \] \[  **-V**\[*level*\] \]

**Note:** No space is allowed between the option flag and the associated arguments.

## DESCRIPTION

**x2sys\_report** will read the input crossover ASCII data base *coedbase.txt* (or *stdin*) and report on the statistics of crossovers (*n*, *mean*, *stdev*, *rms*, *weight*) for each track. Options are available to let you exclude tracks and limit the output.

## REQUIRED ARGUMENTS

- ***coedbase.txt***

  The name of the input ASCII crossover error data base as produced by x2sys\_cross. If not given we read standard input instead.

- **-C***column*

  Specify which data column you want to process. Crossovers related to this column name must be present in the crossover data base.

- **-T***TAG*

  Specify the x2sys *TAG* which tracks the attributes of this data type.

## OPTIONAL ARGUMENTS

- **-A**

  Eliminate COEs by distributing the COE between the two tracks in proportion to track weight and producing (dist, adjustment) spline knots files for each track (for the selected *column*). Such adjustments may be used by x2sys\_datalist. The adjustment files are called *track.column*.adj and are placed in the **$X2SYS\_HOME**/*TAG* directory. For background information on how these adjustments are designed, see *Mittal* \[1984\].

- **-I**\[*list*\]

  Name of ASCII file with a list of track names (one per record) that should be excluded from consideration \[Default includes all tracks\].

- **-L**\[*corrtable*\]

  Apply optimal corrections to the chosen observable. Append the correction table to use \[Default uses the correction table *TAG*\_corrections.txt which is expected to reside in the **$X2SYS\_HOME**/*TAG* directory\]. For the format of this file, see x2sys\_solve.

- **-N***nx\_min*

  Only report data from tracks involved in at least *nx\_min* crossovers \[all tracks\].

- **-Qe**\|**i**

  Append **e** for external crossovers or **i** for internal crossovers only \[Default is external\].

- **-R***west*/*east*/*south*/*north*\[/*zmin*/*zmax*\]\[**+r**\]\[**+u***unit*\]

  *west*, *east*, *south*, and *north* specify the region of interest, and you may specify them in decimal degrees or in \[±\]dd:mm\[:ss.xxx\]\[**W**\|**E**\|**S**\|**N**\] format Append **+r** if lower left and upper right map coordinates are given instead of w/e/s/n. The two shorthands **-Rg** and **-Rd** stand for global domain (0/360 and -180/+180 in longitude respectively, with -90/+90 in latitude). Alternatively for grid creation, give **R***codelon*/*lat*/*nx*/*ny*, where *code* is a 2-character combination of L, C, R (for left, center, or right) and T, M, B for top, middle, or bottom. e.g., BL for lower left.  This indicates which point on a rectangular region the *lon*/*lat* coordinate refers to, and the grid dimensions *nx* and *ny* with grid spacings via **-I** is used to create the corresponding region. Alternatively, specify the name of an existing grid file and the **-R** settings (and grid spacing, if applicable) are copied from the grid. Appending **+u***unit* expects projected (Cartesian) coordinates compatible with chosen **-J** and we inversely project to determine actual rectangular geographic region. For perspective view (**-p**), optionally append /*zmin*/*zmax*. In case of perspective view (**-p**), a z-range (*zmin*, *zmax*) can be appended to indicate the third dimension. This needs to be done only when using the **-Jz** option, not when using only the **-p** option. In the latter case a perspective view of the plane is plotted, with no third dimension. For Cartesian data just give *xmin/xmax/ymin/ymax*. This option bases the statistics on those COE that fall inside the specified domain.

- **-S***track*

  Name of a single track. If given we restrict output to those crossovers involving this track \[Default output is crossovers involving any track pair\].

- **-V**\[*level*\] (more ...)

  Select verbosity level \[c\].

- **-^** or just **-**

  Print a short message about the syntax of the command, then exits (NOTE: on Windows just use **-**).

- **-+** or just **+**

  Print an extensive usage (help) message, including the explanation of any module-specific option (but not the GMT common options), then exits.

- **-?** or no arguments

  Print a complete usage (help) message, including the explanation of all options, then exits.

## EXAMPLES

To report statistics of all the external magnetic crossovers associated with the tag MGD77 from the file COE\_data.txt, restricted to occupy a certain region in the south Pacific, try

```
gmt x2sys_report COE_data.txt -V -TMGD77 -R180/240/-60/-30 -Cmag >
                 mag_report.txt
```

To report on the faa crossovers globally that involves track 12345678, try

```
gmt x2sys_report COE_data.txt -V -TMGD77 -Cfaa -S2345678 > faa_report.txt
```

## REFERENCES

Mittal, P. K. (1984), Algorithm for error adjustment of potential field data along a survey network, *Geophysics*, **49**(4), 467-469.

## SEE ALSO

x2sys\_binlist x2sys\_cross x2sys\_datalist x2sys\_get x2sys\_init x2sys\_list x2sys\_put x2sys\_solve

## COPYRIGHT

2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe