pygmt.x2sys_cross

pygmt.x2sys_cross(tracks=None, outfile=None, **kwargs)[source]

Calculate crossovers between track data files.

x2sys_cross is used to determine all intersections between (“external cross-overs”) or within (“internal cross-overs”) tracks (Cartesian or geographic), and report the time, position, distance along track, heading and speed along each track segment, and the crossover error (COE) and mean values for all observables. The names of the tracks are passed on the command line. By default, x2sys_cross will look for both external and internal COEs. As an option, you may choose to project all data using one of the map-projections prior to calculating the COE.

Full option list at https://docs.generic-mapping-tools.org/latest/supplements/x2sys/x2sys_cross.html

Aliases:

  • Q = coe

  • T = tag

Parameters

  • tracks (pandas.DataFrame or str) – Either a table with (x, y) or (lon, lat) values in the first two columns, or a filename (e.g. csv, txt format). More columns may be present.

  • outfile (str) – Optional. The file name for the output ASCII txt file to store the table in.

  • tag (str) – Specify the x2sys TAG which identifies the attributes of this data type.

  • coe (str) – Use e for external COEs only, and i for internal COEs only [Default is all COEs].

Returns

crossover_errors (pandas.DataFrame or None) – Table containing crossover error information. Return type depends on whether the outfile parameter is set:

  • pandas.DataFrame table with (x, y, …, etc) if outfile is not set

  • None if outfile is set (track output will be stored in outfile)