Helper functions for SODA manipulators.
This primarily comprises various WCS helpers. It is built on base.coords, which is where you’ll get the wcsFields.
Note that this must not use things from protocols.datalink, as it is imported from there. Essentially, use this space for helpers for SODA manipulations that are generic enough to be kept outside of the RD but not generic enough to go do base.coords.
A datalink error (“fault”, as it’s called in the spec).
These are usually constructed using one of the classmethods
AuthenticationFault – Not authenticated (and authentication required)
AuthorizationFault – Not authorized (to access the resource)
NotFoundFault – Unknown ID value
UsageFault – Invalid input (e.g. no ID values)
TransientFault – Service is not currently able to function
FatalFault – Service cannot perform requested action
Fault – General error (not covered above)
all of which take the pubDID that caused the failure and a human-oriented error message.
returns an error row for the datalink response.
- exception gavo.protocols.soda.DeliverNow¶
can be raised by data functions to abort all further processing and return the current descriptor.data to the client.
- exception gavo.protocols.soda.EmptyData¶
raise this when you notice you won’t have any data to return.
- responseCode = 204¶
- responsePayload = ''¶
- exception gavo.protocols.soda.FormatNow¶
can be raised by data functions to abort all further processing and format the current descriptor.data.
- gavo.protocols.soda.addPolygonSlices(descriptor, poly, srcPar='Unknown')¶
adds slicings in descriptor.slices for a pgsphere.SPoly poly.
srcPar is the name of the parameter that generated the polygon (for making error messages)
- gavo.protocols.soda.doAxisCutout(descriptor, args)¶
updates descriptor.data on a FITS descriptor, interpreting the parameters defined by iter*AxisKeys, passed in in args.
This is the main implementation of //soda#fits_doWCSCutout
furnishes a soda fits descriptor with skyWCS and spatialAxes attributes if necessary.
This is usually called by the functions needing this automatically, and it’s a no-op if it has already run.
skyWCS will be None after this function as run if no usable WCS is found; otherwise, it will be a astropy.wcs.WCS instance. Additionally, spatialAxes will be a sequence of 1-based axis indices, and an empty dictionary axisNames is available to be filled by metaMakers. It will then map the SODA parameter name to either a FITS axis index or to the special WCSLONG, WCSLAT values.
- gavo.protocols.soda.iterOtherAxisKeys(descriptor, axisMetaOverrides)¶
yields inputKeys for all non-spatial WCS axes.
descriptor must be a FITSDescriptor.
Note that this will not generate params unless the fits axis index is mentioned in axisMetaOverrides. This is because typically, there are pre-defined SODA parameters for such other axes.
- gavo.protocols.soda.iterSpatialAxisKeys(descriptor, axisMetaOverrides)¶
yields SODA inputKeys for spatial cutouts along the spatial coordinate axes.
This can be nothing if descriptor doesn’t have a skyWCS attribute or if it’s None.