pygmt.clib.Session.write_data

Session.write_data(family, geometry, mode, wesn, output, data)[source]

Write a GMT data container to a file.

The data container should be created by create_data.

Wraps GMT_Write_Data but only allows writing to a file. So the method argument is omitted.

Parameters
  • family (str) – A valid GMT data family name (e.g., 'GMT_IS_DATASET'). See the data_families attribute for valid names. Don’t use the GMT_VIA_VECTOR or GMT_VIA_MATRIX constructs for this. Use GMT_IS_VECTOR and GMT_IS_MATRIX instead.

  • geometry (str) – A valid GMT data geometry name (e.g., 'GMT_IS_POINT'). See the data_geometries attribute for valid names.

  • mode (str) – How the data is to be written to the file. This option varies depending on the given family. See the GMT API documentation for details.

  • wesn (list or numpy array) – [xmin, xmax, ymin, ymax, zmin, zmax] of the data. Must have 6 elements.

  • output (str) – The output file name.

  • data (ctypes.c_void_p) – Pointer to the data container created by create_data.

Raises

GMTCLibError – For invalid input arguments or if the GMT API functions returns a non-zero status code.