testapi — GMT 5.1.1 documentation

### Navigation

- index
- next
- previous
- Project Home »
- GMT 5.1.1 documentation »
- T »
- Search:

# testapi

testapi - Test API i/o methods for any data type

## Synopsis

testapi -Ic|d|f|r|s[/m|v] -Tc|d|g|i|t -Wc|d|f|r|s[/m|v] [ -V[level] ]

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

## Description

testapi will test the API for all i/o combinations. In general, data types (DATASET, TEXTSET, CPT, GRID, and IMAGE) can be read from or written to 5 different ways (file, stream, file descriptor, copy from memory, reference from memory). We use this tool to check the various possibilities, for each data type.

## Required Arguments

-Ic|d|f|r|s[/m|v]
  Set input method; choose from copy from memory, file descriptor, file, memory reference, or stream. For methods c|r, optionally append /m|v. Then, we obtain the values for the input dataset or grid via either a user matrix (m) or a set of user vectors (v). We simulate this internally by filling out a matrix or vectors and pass that as the source instead of a data file. -Td may take either m|v while -Tg can only take the m modifier.
-Tc|d|g|i|t
  Specify data type; choose from cpt, dataset, grid, image, or textset.
-Wc|d|f|r|s[/m|v]
  Set output method; choose from copy to memory, file descriptor, file, memory reference, or stream. For methods c|r, optionally append /m|v. Then, we first write the values of the output dataset or grid via either a user matrix (m) or a set of user vectors (v). Finally, the matrix or vectors are written out to file. -Td may take either m|v while -Tg can only take the m modifier.

## Optional Arguments

-V[level] (more ...)
  Select verbosity level [c].

## Examples

To check if reading and writing the test dataset file yields an identical copy, try

>     testapi -Td -If -Wf -V

To check if reading the test grid from memory and writing it to file yields an identical copy, try

>     testapi -Tg -Ic -Wf -V

To read the test grid via user matrix memory and writing it via another user matrix before saving to a grid file, try

>     testapi -Tg -Ic/m -Wf/m -V

## See Also

gmt

### Navigation

- index
- next
- previous
- Project Home »
- GMT 5.1.1 documentation »
- T »
- Search: