GXDSEL class

class geosoft.gx.GXDSEL
The DSEL object is used to select subsets of data from the DATA object
static create((GXContext)ctx) → GXDSEL:
Create a Selection object
Parameters:ctx (geosoft.gx.GXContext) – The GX execution context
Returns:DSEL handle, terminates if creation fails
Return type:geosoft.gx.GXDSEL

New in version 5.0.3.

data_significant_figures((float)arg1) → None:
Specify the data significant figures required
Parameters:arg1 (float) – Significant figures (positive, can be fractional)
Return type:None

New in version 5.0.8.

Note:

This is the number of significant figures that you require for the data.
You can reduce this number to achieve better compression ratios.
This should only be used when there is one data type in the data.

See sSpatialResolution_DSEL to set the desired spatial resolution.
is_null() → bool

Check if the instance of geosoft.gx.GXDSEL is null (undefined)

Returns:True if this is a null instance of geosoft.gx.GXDSEL, False otherwise.
Return type:bool`
meta_query((str)arg1) → None:
Specify a metadata query string.
Parameters:arg1 (str) – Meta query string
Return type:None

New in version 5.1.3.

static null() → GXDSEL

A null (undefined) instance of geosoft.gx.GXDSEL

Returns:A null geosoft.gx.GXDSEL
Return type:geosoft.gx.GXDSEL
picture_quality((int)arg1) → None:
Specify the quality of pictures being returned.
Parameters:arg1 (int) – Quality
Return type:None

New in version 5.1.4.

Note:

Affected Data Types: PICTURE
request_all_info((int)arg1) → None:
Request that all meta-data info be sent
Parameters:arg1 (int) – TRUE to for all data, FALSE - for normal data
Return type:None

New in version 5.1.3.

select_area((GXPLY)arg1) → None:
Select a complex clipping area
Parameters:arg1 (geosoft.gx.GXPLY) – PLY containing complex area (must contain a projection)
Return type:None

New in version 5.1.3.

Note:

The DAP server may not handle clipping and may return
more data than requested.
select_rect((float)arg1, (float)arg2, (float)arg3, (float)arg4) → None:
Select a rectangular area.
Parameters:
  • arg1 (float) – Min X
  • arg2 (float) – Min Y
  • arg3 (float) – Max X
  • arg4 (float) – Max Y
Return type:

None

New in version 5.0.3.

select_resolution((float)arg1, (int)arg2) → None:
Specify the resolution desired
Parameters:
  • arg1 (float) – Minimum Resolution
  • arg2 (int) – TRUE to force this resolution, if possible
Return type:

None

New in version 5.0.3.

Note:

Resolution must be specified in the units of the selection IPJ.

This will be the optimum data resoulution.  (grid cell for grids, data
separation for other data types).
You will normally get a reasonable resolution as near to or smaller than
this unless sRequireResolution_DSEL has been set.

Call sRequireResolution_DSEL with TRUE to force the client to re-sample
the data to the resolution requested.
select_size((int)arg1, (int)arg2) → None:
Specify the image size desired
Parameters:
  • arg1 (int) – Image width in pixels
  • arg2 (int) – Image height in pixels
Return type:

None

New in version 7.0.0.

set_extract_as_document((int)arg1) → None:
Specify that we want to extract this file as a document
Parameters:arg1 (int) – TRUE (1) if we want as a document
Return type:None

New in version 8.0.0.

set_ipj((GXIPJ)arg1, (int)arg2) → None:
Set the desired projection
Parameters:
  • arg1 (geosoft.gx.GXIPJ) – IPJ to set
  • arg2 (int) – TRUE to force reprojection, if possible
Return type:

None

New in version 5.0.8.

Note:

If the server supports reprojection, the data will be
reprojected at the server.

If reprojection is not forced, the data may come in any projection.

The spatial resolution and accuracy are accumed to be in the
coordinate system defined by this IPJ.
spatial_accuracy((float)arg1) → None:
Specify the spatial accuracy required.
Parameters:arg1 (float) – spatial accuracy desired
Return type:None

New in version 5.0.8.

Note:

Must be specified in the units of the selection IPJ.

The spatial accuracy is used improve compression performance for
the spatial component of the data returned.
You can reduce this number to achieve better compression ratios.
This should only be used when there is one data type in the data.

DSEL_PICTURE_QUALITY constants

Line Label Formats
gx.DSEL_PICTURE_QUALITY_DEFAULT = 0
gx.DSEL_PICTURE_QUALITY_LOSSLESS = 1
gx.DSEL_PICTURE_QUALITY_SEMILOSSY = 2
gx.DSEL_PICTURE_QUALITY_LOSSY = 3
gx.DSEL_PICTURE_QUALITY_NATIVE = 4
gx.DSEL_PICTURE_QUALITY_ECW = 5
gx.DSEL_PICTURE_QUALITY_JPG = 6
gx.DSEL_PICTURE_QUALITY_PNG = 7
gx.DSEL_PICTURE_QUALITY_BMP = 8
gx.DSEL_PICTURE_QUALITY_TIF = 9