Class: GMT

Inherits:
Object
  • Object
show all
Defined in:
lib/gmt.rb

Overview

This class provides a native extension accessing the programs of the Generic Mapping Tools; an open source collection of about 80 command-line tools for manipulating geographic and Cartesian data sets (including filtering, trend fitting, gridding, projecting, etc.) and producing PostScript illustrations ranging from simple x–y plots via contour maps to artificially illuminated surfaces and 3D perspective views

An example of usage:

require 'gmt'

common = { file: 'output.ps', R: '0/3/0/2', J: 'x1i' }

GMT.session do |gmt|
  gmt.psxy('dots.xy', position: :first, S: 'c0.50c', G: 'blue', **common)
  gmt.psxy('dots.xy', position: :last, S: 'c0.25c', G: 'red', **common)
end

Those familiar with GMT will recognise the -R (range) and -J (projection) options which are now keys for the program options hash.

The session

All GMT functions (modules in the GMT parlance) require a session context, and an instance of the GMT class is exactly such a context.

gmt = GMT.new

There are no arguments for the constructor.

A session object is also yielded by the GMT.session class method:

GMT.session do |gmt|
  # do something with gmt
end

GMT functions

Each GMT function is available as instance method, and each has the same signatures: several arguments, typically input files, followed by a single options hash. The options hash corresponds to the command-line options of the GMT program; hence the shell command

gmt makecpt -Cgebco depths.txt -i2 -Z -E24 > bath.cpt

would be replicated by the Ruby

gmt = GMT.new
gmt.makecpt('depths.txt', C: 'gebco', i: 2, Z: nil, E: 24, :> => 'bath.cpt')

Note that

  • the argument(s) (the input file 'depths.txt') preceed(s) the options hash

  • the options hash has keys which are symbols

  • options which lack arguments correspond to hash keys with nil values Z: nil.

  • the output redirection is also treated as hash option, with key :> and value which is the output file.

The options without argument can also be specifed by a symbol argument, but recall that arguments must proceed the options hash, so the above would be

gmt.makecpt('depths.txt', :Z, C: 'gebco', i: 2, E: 24, :> => 'bath.cpt')

using this format.

PostScript functions

When creating complex PostScript plots one needs to make several calls to GMT functions, to use the -O and -K options, and to append output of the second and subsequent calls (rather than overwriting). This is tiresome and error-prone on the command-line, and more so in the “options hash” representation in the Ruby module.

So we add some syntactic sugar for these PostScript functions: if the options hash has the keys :position (with values one of :first, :middle, or :last) and :file (with the value of the ouptut file), then the -O and -K options and the output redirection are handled by the class. So one might write

gmt = GMT.new
gmt.psbasemap( ..., file: 'map.ps', position: :first)
gmt.pstext(    ..., file: 'map.ps', position: :middle)
gmt.psxy(      ..., file: 'map.ps', position: :middle)
gmt.pslogo(    ..., file: 'map.ps', position: :last)

Constant Summary collapse

VERSION_MAJOR =

version constants

INT2NUM(GMT_MAJOR_VERSION)
VERSION_MINOR = 
INT2NUM(GMT_MINOR_VERSION)
VERSION_RELEASE = 
INT2NUM(GMT_RELEASE_VERSION)

Plotting collapse

Filtering collapse

Gridding collapse

Sampling of 1-D and 2-D data collapse

Projection and map-transformation collapse

Information retrieval collapse

Mathematical operations on tables or grids collapse

Convert or extract subsets of data collapse

Trends in 1-D and 2-D data collapse

Grid operations collapse

Miscellaneous collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Object 



54
55
56
57
58
59
60
61
62
63
64
65
66
67
 
# File 'ext/gmt/gmt.c', line 54

static VALUE gmt_init(VALUE self)
{
  gmt_t *gmt;

  Data_Get_Struct(self, gmt_t, gmt);

  gmt->session =
    GMT_Create_Session("Session name", 2, 0, NULL);

  if (gmt->session == NULL)
    rb_raise(rb_eNoMemError, "failed to create GMT session");

  return self;
}

Class Method Details

.session {|gmt| ... } ⇒ Object

Yields:

  • (gmt) —

    yields the GMT session to the block



162
163
164
165
166
 
# File 'lib/gmt.rb', line 162

def session
  gmt = GMT.new
  yield gmt
  gmt.free
end

.version_at_least?(major, minor = 0, release = 0) ⇒ Boolean

Returns true if the current API version is at least as requested.

Examples:

If the current API version if 5.3.2, then

GMT.version_at_least?(5) #=> true
GMT.version_at_least?(5, 3, 1) #=> true
GMT.version_at_least?(5, 3, 3) #=> false

Parameters:

  • major (Integer) —

    The major version

  • minor (Integer) (defaults to: 0) —

    The minor version

  • release (Integer) (defaults to: 0) —

    The release version

Returns:

  • (Boolean) —

    true if the current API version is at least as requested



102
103
104
105
106
107
108
109
110
 
# File 'lib/gmt.rb', line 102

def version_at_least?(major, minor=0, release=0)
  if VERSION_MAJOR > major then
    true
  elsif VERSION_MAJOR < major then
    false
  else
    version_at_least_minor?(minor, release)
  end
end

Instance Method Details

#blockmean(*arguments, **options) ⇒ Boolean

L2 (x,y,z) table data filter/decimator

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



322
 
# File 'lib/gmt.rb', line 322

wrapper_other :blockmean

#blockmedian(*arguments, **options) ⇒ Boolean

L1 (x,y,z) table data filter/decimator

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



325
 
# File 'lib/gmt.rb', line 325

wrapper_other :blockmedian

#blockmode(*arguments, **options) ⇒ Boolean

Mode estimate (x,y,z) table data filter/decimator

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



328
 
# File 'lib/gmt.rb', line 328

wrapper_other :blockmode

#dimfilter(*arguments, **options) ⇒ Boolean

Directional filtering of grids in the space domain

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



337
 
# File 'lib/gmt.rb', line 337

wrapper_other :dimfilter

#filter1d(*arguments, **options) ⇒ Boolean

Time domain filtering of 1-D data tables

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



331
 
# File 'lib/gmt.rb', line 331

wrapper_other :filter1d

#fitcircle(*arguments, **options) ⇒ Boolean

Finds the best-fitting great or small circle for a set of points

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



475
 
# File 'lib/gmt.rb', line 475

wrapper_other :fitcircle

#free ⇒ Object 



69
70
71
72
73
74
75
76
77
78
79
80
81
82
 
# File 'ext/gmt/gmt.c', line 69

static VALUE gmt_release(VALUE self)
{
  gmt_t *gmt;

  Data_Get_Struct(self, gmt_t, gmt);

  if (gmt->session)
    {
      GMT_Destroy_Session(gmt->session);
      gmt->session = NULL;
    }

  return self;
}

#gmt2kml(*arguments, **options) ⇒ Boolean

Like psxy but plots KML for use in Google Earth

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



532
 
# File 'lib/gmt.rb', line 532

wrapper_other :gmt2kml

#gmtconnect(*arguments, **options) ⇒ Boolean

Connect segments into more complete lines or polygons

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



430
 
# File 'lib/gmt.rb', line 430

wrapper_other :gmtconnect

#gmtconvert(*arguments, **options) ⇒ Boolean

Convert data tables from one format to another

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



433
 
# File 'lib/gmt.rb', line 433

wrapper_other :gmtconvert

#gmtdefaults(*arguments, **options) ⇒ Boolean

List the current default settings

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



391
 
# File 'lib/gmt.rb', line 391

wrapper_other :gmtdefaults

#gmtget(*arguments, **options) ⇒ Boolean

Retrieve selected parameters in current file

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



394
 
# File 'lib/gmt.rb', line 394

wrapper_other :gmtget

#gmtinfo(*arguments, **options) ⇒ Boolean

Get information about table data files

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



397
 
# File 'lib/gmt.rb', line 397

wrapper_other :gmtinfo

#gmtlogo(*files, **options) ⇒ Boolean

Plot the GMT logo on maps

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



253
 
# File 'lib/gmt.rb', line 253

wrapper_ps :gmtlogo

#gmtmath(*arguments, **options) ⇒ Boolean

Mathematical operations on table data

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



409
 
# File 'lib/gmt.rb', line 409

wrapper_other :gmtmath

#gmtregress(*arguments, **options) ⇒ Boolean

Linear regression of 1-D data sets

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



478
 
# File 'lib/gmt.rb', line 478

wrapper_other :gmtregress

#gmtselect(*arguments, **options) ⇒ Boolean

Select subsets of table data based on multiple spatial criteria

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



436
 
# File 'lib/gmt.rb', line 436

wrapper_other :gmtselect

#gmtset(*arguments, **options) ⇒ Boolean

Change selected parameters in current file

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



400
 
# File 'lib/gmt.rb', line 400

wrapper_other :gmtset

#gmtsimplify(*arguments, **options) ⇒ Boolean

Line reduction using the Douglas-Peucker algorithm

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



364
 
# File 'lib/gmt.rb', line 364

wrapper_other :gmtsimplify

#gmtspatial(*arguments, **options) ⇒ Boolean

Geospatial operations on lines and polygons

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



439
 
# File 'lib/gmt.rb', line 439

wrapper_other :gmtspatial

#gmtvector(*arguments, **options) ⇒ Boolean

Operations on Cartesian vectors in 2-D and 3-D

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



442
 
# File 'lib/gmt.rb', line 442

wrapper_other :gmtvector

#grd2cpt(*arguments, **options) ⇒ Boolean

Make color palette table from a grid files

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



493
 
# File 'lib/gmt.rb', line 493

wrapper_other :grd2cpt

#grd2kml(*arguments, **options) ⇒ Boolean

Create KML image quadtree from single grid

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



469
 
# File 'lib/gmt.rb', line 469

wrapper_other :grd2kml

#grd2rgb(*arguments, **options) ⇒ Boolean

Convert Sun raster or grid file to red, green, blue component grids

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



445
 
# File 'lib/gmt.rb', line 445

wrapper_other :grd2rgb

#grd2xyz(*arguments, **options) ⇒ Boolean

Conversion from 2-D grid file to table data

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



448
 
# File 'lib/gmt.rb', line 448

wrapper_other :grd2xyz

#grdblend(*arguments, **options) ⇒ Boolean

Blend several partially over-lapping grid files onto one grid

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



451
 
# File 'lib/gmt.rb', line 451

wrapper_other :grdblend

#grdclip(*arguments, **options) ⇒ Boolean

Limit the z-range in gridded data sets

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



496
 
# File 'lib/gmt.rb', line 496

wrapper_other :grdclip

#grdcontour(*files, **options) ⇒ Boolean

Contouring of 2-D gridded data sets

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



256
 
# File 'lib/gmt.rb', line 256

wrapper_ps :grdcontour

#grdconvert(*arguments, **options) ⇒ Boolean

Converts grid files into other grid formats

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



454
 
# File 'lib/gmt.rb', line 454

wrapper_other :grdconvert

#grdcut(*arguments, **options) ⇒ Boolean

Cut a sub-region from a grid file

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



457
 
# File 'lib/gmt.rb', line 457

wrapper_other :grdcut

#grdedit(*arguments, **options) ⇒ Boolean

Modify header information in a 2-D grid file

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



499
 
# File 'lib/gmt.rb', line 499

wrapper_other :grdedit

#grdfft(*arguments, **options) ⇒ Boolean

Perform operations on grid files in the frequency domain

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



502
 
# File 'lib/gmt.rb', line 502

wrapper_other :grdfft

#grdfill(*arguments, **options) ⇒ Boolean

Interpolate across holes in a grid

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



505
 
# File 'lib/gmt.rb', line 505

wrapper_other :grdfill

#grdfilter(*arguments, **options) ⇒ Boolean

Filter 2-D gridded data sets in the space domain

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



334
 
# File 'lib/gmt.rb', line 334

wrapper_other :grdfilter

#grdgdal(*arguments, **options) ⇒ Boolean

Execute GDAL raster programs from GMT

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



541
 
# File 'lib/gmt.rb', line 541

wrapper_other :grdgdal

#grdgradient(*arguments, **options) ⇒ Boolean

Compute directional gradient from grid files

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



508
 
# File 'lib/gmt.rb', line 508

wrapper_other :grdgradient

#grdhisteq(*arguments, **options) ⇒ Boolean

Histogram equalization for grid files

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



511
 
# File 'lib/gmt.rb', line 511

wrapper_other :grdhisteq

#grdimage(*files, **options) ⇒ Boolean

Produce images from 2-D gridded data sets

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



259
 
# File 'lib/gmt.rb', line 259

wrapper_ps :grdimage

#grdinfo(*arguments, **options) ⇒ Boolean

Get information about grid files

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



403
 
# File 'lib/gmt.rb', line 403

wrapper_other :grdinfo

#grdinterpolate(*arguments, **options) ⇒ Boolean

Interpolate 2-D grids or 1-D series from a 3-D data cube

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



358
 
# File 'lib/gmt.rb', line 358

wrapper_other :grdinterpolate

#grdlandmask(*arguments, **options) ⇒ Boolean

Create masking grid files from shoreline data base

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



514
 
# File 'lib/gmt.rb', line 514

wrapper_other :grdlandmask

#grdmask(*arguments, **options) ⇒ Boolean

Reset grid nodes in/outside a clip path to constants

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



517
 
# File 'lib/gmt.rb', line 517

wrapper_other :grdmask

#grdmath(*arguments, **options) ⇒ Boolean

Mathematical operations on grid files

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



520
 
# File 'lib/gmt.rb', line 520

wrapper_other :grdmath

#grdmix(*arguments, **options) ⇒ Boolean

Blending and transforming grids and images

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



523
 
# File 'lib/gmt.rb', line 523

wrapper_other :grdmix

#grdpaste(*arguments, **options) ⇒ Boolean

Paste together grid files along a common edge

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



460
 
# File 'lib/gmt.rb', line 460

wrapper_other :grdpaste

#grdproject(*arguments, **options) ⇒ Boolean

Project gridded data sets onto a new coordinate system

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



379
 
# File 'lib/gmt.rb', line 379

wrapper_other :grdproject

#grdsample(*arguments, **options) ⇒ Boolean

Resample a 2-D gridded data set onto a new grid

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



367
 
# File 'lib/gmt.rb', line 367

wrapper_other :grdsample

#grdtrack(*arguments, **options) ⇒ Boolean

Sampling of 2-D gridded data set(s) along 1-D track

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



370
 
# File 'lib/gmt.rb', line 370

wrapper_other :grdtrack

#grdtrend(*arguments, **options) ⇒ Boolean

Fit trend surface to grids and compute residuals

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



487
 
# File 'lib/gmt.rb', line 487

wrapper_other :grdtrend

#grdvector(*files, **options) ⇒ Boolean

Plotting of 2-D gridded vector fields

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



262
 
# File 'lib/gmt.rb', line 262

wrapper_ps :grdvector

#grdview(*files, **options) ⇒ Boolean

3-D perspective imaging of 2-D gridded data sets

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



265
 
# File 'lib/gmt.rb', line 265

wrapper_ps :grdview

#grdvolume(*arguments, **options) ⇒ Boolean

Calculate volumes under a surface within specified contour

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



526
 
# File 'lib/gmt.rb', line 526

wrapper_other :grdvolume

#greenspline(*arguments, **options) ⇒ Boolean

Interpolation with Green’s functions for splines in 1–3 D

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



343
 
# File 'lib/gmt.rb', line 343

wrapper_other :greenspline

#kml2gmt(*arguments, **options) ⇒ Boolean

Extracts coordinates from Google Earth KML files

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



535
 
# File 'lib/gmt.rb', line 535

wrapper_other :kml2gmt

#makecpt(*arguments, **options) ⇒ Boolean

Make color palette tables

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



412
 
# File 'lib/gmt.rb', line 412

wrapper_other :makecpt

#mapproject(*arguments, **options) ⇒ Boolean

Transformation of coordinate systems for table data

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



382
 
# File 'lib/gmt.rb', line 382

wrapper_other :mapproject

#nearneighbor(*arguments, **options) ⇒ Boolean

Nearest-neighbor gridding scheme

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



346
 
# File 'lib/gmt.rb', line 346

wrapper_other :nearneighbor

#project(*arguments, **options) ⇒ Boolean

Project table data onto lines or great circles

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



385
 
# File 'lib/gmt.rb', line 385

wrapper_other :project

#psbasemap(*files, **options) ⇒ Boolean

Create a basemap plot

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



268
 
# File 'lib/gmt.rb', line 268

wrapper_ps :psbasemap

#psclip(*files, **options) ⇒ Boolean

Use polygon files to define clipping paths

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



271
 
# File 'lib/gmt.rb', line 271

wrapper_ps :psclip

#pscoast(*files, **options) ⇒ Boolean

Plot (and fill) coastlines, borders, and rivers on maps

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



274
 
# File 'lib/gmt.rb', line 274

wrapper_ps :pscoast

#pscontour(*files, **options) ⇒ Boolean

Contour or image raw table data by triangulation

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



277
 
# File 'lib/gmt.rb', line 277

wrapper_ps :pscontour

#psconvert(*arguments, **options) ⇒ Boolean

Crop and convert PostScript files to raster images, EPS, and PDF

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



538
 
# File 'lib/gmt.rb', line 538

wrapper_other :psconvert

#psevents(*files, **options) ⇒ Boolean

Plot event symbols and labels for a moment in time

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



316
 
# File 'lib/gmt.rb', line 316

wrapper_ps :psevents

#pshistogram(*files, **options) ⇒ Boolean

Plot a histogram

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



280
 
# File 'lib/gmt.rb', line 280

wrapper_ps :pshistogram

#psimage(*files, **options) ⇒ Boolean

Plot Sun raster files on a map

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



283
 
# File 'lib/gmt.rb', line 283

wrapper_ps :psimage

#pslegend(*files, **options) ⇒ Boolean

Plot a legend on a map

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



286
 
# File 'lib/gmt.rb', line 286

wrapper_ps :pslegend

#psmask(*files, **options) ⇒ Boolean

Create overlay to mask out regions on maps

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



289
 
# File 'lib/gmt.rb', line 289

wrapper_ps :psmask

#psrose(*files, **options) ⇒ Boolean

Plot sector or rose diagrams

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



292
 
# File 'lib/gmt.rb', line 292

wrapper_ps :psrose

#psscale(*files, **options) ⇒ Boolean

Plot gray scale or color scale on maps

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



295
 
# File 'lib/gmt.rb', line 295

wrapper_ps :psscale

#pssolar(*files, **options) ⇒ Boolean

Calculate and plot the day-night terminator

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



310
 
# File 'lib/gmt.rb', line 310

wrapper_ps :pssolar

#psternary(*files, **options) ⇒ Boolean

Plot data on ternary diagrams

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



313
 
# File 'lib/gmt.rb', line 313

wrapper_ps :psternary

#pstext(*files, **options) ⇒ Boolean

Plot text strings on maps

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



298
 
# File 'lib/gmt.rb', line 298

wrapper_ps :pstext

#pswiggle(*files, **options) ⇒ Boolean

Draw table data time-series along track on maps

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



301
 
# File 'lib/gmt.rb', line 301

wrapper_ps :pswiggle

#psxy(*files, **options) ⇒ Boolean

Plot symbols, polygons, and lines on maps

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



304
 
# File 'lib/gmt.rb', line 304

wrapper_ps :psxy

#psxyz(*files, **options) ⇒ Boolean

Plot symbols, polygons, and lines in 3-D

A PostScript function (accepts :file and :position options).

Parameters:

  • files (Array<String>) —

    The input files

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



307
 
# File 'lib/gmt.rb', line 307

wrapper_ps :psxyz

#sample1d(*arguments, **options) ⇒ Boolean

Resampling of 1-D table data sets

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



373
 
# File 'lib/gmt.rb', line 373

wrapper_other :sample1d

#spectrum1d(*arguments, **options) ⇒ Boolean

Compute various spectral estimates from time-series

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



415
 
# File 'lib/gmt.rb', line 415

wrapper_other :spectrum1d

#sph2grd(*arguments, **options) ⇒ Boolean

Compute grid from spherical harmonic coefficients

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



418
 
# File 'lib/gmt.rb', line 418

wrapper_other :sph2grd

#sphdistance(*arguments, **options) ⇒ Boolean

Make grid of distances to nearest points on a sphere

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



421
 
# File 'lib/gmt.rb', line 421

wrapper_other :sphdistance

#sphinterpolate(*arguments, **options) ⇒ Boolean

Spherical gridding in tension of data on a sphere

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



349
 
# File 'lib/gmt.rb', line 349

wrapper_other :sphinterpolate

#sphtriangulate(*arguments, **options) ⇒ Boolean

Delaunay or Voronoi construction of spherical lon,lat data

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



424
 
# File 'lib/gmt.rb', line 424

wrapper_other :sphtriangulate

#splitxyz(*arguments, **options) ⇒ Boolean

Split xyz files into several segments

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



463
 
# File 'lib/gmt.rb', line 463

wrapper_other :splitxyz

#surface(*arguments, **options) ⇒ Boolean

A continuous curvature gridding algorithm

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



352
 
# File 'lib/gmt.rb', line 352

wrapper_other :surface

#trend1d(*arguments, **options) ⇒ Boolean

Fits polynomial or Fourier trends to y = f(x) series

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



481
 
# File 'lib/gmt.rb', line 481

wrapper_other :trend1d

#trend2d(*arguments, **options) ⇒ Boolean

Fits polynomial trends to z = f(x,y) series

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



484
 
# File 'lib/gmt.rb', line 484

wrapper_other :trend2d

#triangulate(*arguments, **options) ⇒ Boolean

Perform optimal Delauney triangulation and gridding

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



355
 
# File 'lib/gmt.rb', line 355

wrapper_other :triangulate

#xyz2grd(*arguments, **options) ⇒ Boolean

Convert an equidistant table xyz file to a 2-D grid file

Parameters:

  • arguments (Array<String>) —

    The arguments

  • options (Hash) —

    The GMT command-line options in hash form

Returns:

  • (Boolean) —

    true on success

See Also:



466
 
# File 'lib/gmt.rb', line 466

wrapper_other :xyz2grd