Module eoxserver.resources.coverages.filters

This module defines filters and filter expressions for EO Coverages. For more information on filters, see eoxserver.core.filters.

Helper Classes

class eoxserver.resources.coverages.filters.TimeInterval(begin, end)

This class contains information about a time interval. The constructor accepts two arguments: begin and end which must be set either to the string "unbounded" or a datetime.datetime object.

InternalError is raised if the arguments do not validate. InvalidExpressionError is raised if the begin time is later than the end time.

class eoxserver.resources.coverages.filters.Slice(crs_id, axis_label, slice_point)

This class contains information about a slice subsetting. The constructor accepts three arguments:

• crs_id: either "imageCRS" or an integer EPSG SRID,
• axis_label: the axis label the slicing operation refers to,
• slice_point: a float or int containing the slice point information

InternalError is raised if arguments do not validate.

class eoxserver.resources.coverages.filters.BoundedArea(crs_id, minx, miny, maxx, maxy)

This class contains information about a bounded area. The constructor accepts a crs_id and four bounds arguments minx, miny, maxx, maxy. The crs_id parameter may be set to "imageCRS" or an integer EPSG SRID. The bounds parameters may be set to a float or int value designating the bound in the given coordinate system or to "unbounded".

InternalError is raised if the arguments do not validate. InvalidExpressionError is raised if the lower bounds of an axis are greater than the upper bounds.

Filter Expressions

Filter expressions (i.e. implementations of FilterExpressionInterface) define certain search constraints for resource factories. Filter expressions should be created using the get() or find() methods of CoverageExpressionFactory. They will be translated into the corresponding filters by the resource factory.

class eoxserver.resources.coverages.filters.TimeSliceExpression

Filter expression implementation representing a time slice. Expects one operand: a datetime.datetime object representing the slice point in time.

class eoxserver.resources.coverages.filters.TimeIntervalExpression

Filter expression implementation representing a time interval. It expects one operand of type TimeInterval.

class eoxserver.resources.coverages.filters.IntersectingTimeIntervalExpression

Filter expression implementation that matches if a time or time interval intersects with the time interval specified in the expression. Inherits from TimeIntervalExpression.

class eoxserver.resources.coverages.filters.ContainingTimeIntervalExpression

Filter expression implementation that matches if a time or time interval is contained in the time interval specified in the expression. Inherits from TimeIntervalExpression.

class eoxserver.resources.coverages.filters.SpatialSliceExpression

Filter expression implementation that represents a slice subsetting. It expects one operand of type Slice.

class eoxserver.resources.coverages.filters.BoundedAreaExpression

Filter expression implementation that represents a trim or BBOX subsetting. It expects one operand of type BoundedArea.

class eoxserver.resources.coverages.filters.FootprintIntersectsAreaExpression

Filter expression implementation that matches if the footprint of an object intersects the given BoundedArea. Inherits from BoundedAreaExpression.

class eoxserver.resources.coverages.filters.FootprintWithinAreaExpression

Filter expression implementation that matches if the footprint of an object is contained within the given BoundedArea. Inherits from BoundedAreaExpression.

Filters

Filters (i.e. implementations of FilterInterface) are used primarily to select EO Coverages matching certain criteria. In general developers will not use filters directly, but define filter expressions instead which will be applied to the EO Coverages when invoking the find() method of a resource factory.

class eoxserver.resources.coverages.filters.TimeSliceFilter

Filter class for time slice operations.

class eoxserver.resources.coverages.filters.RectifiedDatasetTimeSliceFilter

Filter which matches Rectified Datasets whose acquisition time interval contains a given timestamp.

class eoxserver.resources.coverages.filters.ReferenceableDatasetTimeSliceFilter

Filter which matches Referenceable Datasets whose acquisition time interval contains a given timestamp.

class eoxserver.resources.coverages.filters.RectifiedStitchedMosaicTimeSliceFilter

Filter which matches Rectified Stitched Mosaics whose acquisition time interval contains a given timestamp.

class eoxserver.resources.coverages.filters.IntersectingTimeIntervalFilter

Filter class for ‘time_intersects’ operations.

class eoxserver.resources.coverages.filters.RectifiedDatasetIntersectingTimeIntervalFilter

Filter which matches Rectified Datasets whose acquisition time interval intersects a given time interval.

class eoxserver.resources.coverages.filters.ReferenceableDatasetIntersectingTimeIntervalFilter

Filter which matches Referenceable Datasets whose acquisition time interval intersects a given time interval.

class eoxserver.resources.coverages.filters.RectifiedStitchedMosaicIntersectingTimeIntervalFilter

Filter which matches Rectified Stitched Mosaics whose acquisition time interval intersects a given time interval.

class eoxserver.resources.coverages.filters.ContainingTimeIntervalFilter

Filter class for ‘time_within’ operations.

class eoxserver.resources.coverages.filters.RectifiedDatasetContainingTimeIntervalFilter

Filter which matches Rectified Datasets whose acquisition time interval is contained within a given time interval.

class eoxserver.resources.coverages.filters.ReferenceableDatasetContainingTimeIntervalFilter

Filter which matches Referenceable Datasets whose acquisition time interval is contained within a given time interval.

class eoxserver.resources.coverages.filters.RectifiedStitchedMosaicContainingTimeIntervalFilter

Filter which matches Rectified Stitched Mosaics whose acquisition time interval is contained within a given time interval.

class eoxserver.resources.coverages.filters.SpatialFilter

Common base class for spatial filters.

class eoxserver.resources.coverages.filters.SpatialSliceFilter

Common base class for spatial slice filters.

class eoxserver.resources.coverages.filters.RectifiedDatasetSpatialSliceFilter

Filter which matches Rectified Datasets whose footprint intersects a given spatial slice.

class eoxserver.resources.coverages.filters.ReferenceableDatasetSpatialSliceFilter

Filter which matches Referenceable Datasets whose footprint intersects a given spatial slice.

class eoxserver.resources.coverages.filters.RectifiedStitchedMosaicSpatialSliceFilter

Filter which matches Rectified Stitched Mosaics whose footprint intersects a given spatial slice.

class eoxserver.resources.coverages.filters.FootprintFilter

Common base class for footprint-related filters.

class eoxserver.resources.coverages.filters.FootprintIntersectsAreaFilter

Base filter class matching EO Coverages whose footprint intersects a given area.

class eoxserver.resources.coverages.filters.RectifiedDatasetFootprintIntersectsAreaFilter

Filter which matches Rectified Datasets whose footprint intersects a given bounded area.

class eoxserver.resources.coverages.filters.ReferenceableDatasetFootprintIntersectsAreaFilter

Filter which matches Referenceable Datasets whose footprint intersects a given bounded area.

class eoxserver.resources.coverages.filters.RectifiedStitchedMosaicFootprintIntersectsAreaFilter

Filter which matches Rectified Stitched Mosaics whose footprint intersects a given bounded area.

class eoxserver.resources.coverages.filters.FootprintWithinAreaFilter

Filter matching EO Coverages whose footprint lies within a given area.

class eoxserver.resources.coverages.filters.RectifiedDatasetFootprintWithinAreaFilter

Filter which matches Rectified Datasets whose footprint is contained within a given bounded area.

class eoxserver.resources.coverages.filters.ReferenceableDatasetFootprintWithinAreaFilter

Filter which matches Referenceable Datasets whose footprint is contained within a given bounded area.

class eoxserver.resources.coverages.filters.RectifiedStitchedMosaicFootprintWithinAreaFilter

Filter which matches Rectified Stiched Mosaics whose footprint is contained within given bounded area.

class eoxserver.resources.coverages.filters.ContainedRectifiedDatasetFilter

Filter which matches RectifiedDatasets contained in a given RectifiedStitchedMosaic or Dataset series.

class eoxserver.resources.coverages.filters.ContainedReferenceableDatasetFilter

Filter which matches ReferenceableDatasets contained in a given DatasetSeries.

Factories

class eoxserver.resources.coverages.filters.CoverageExpressionFactory

This is the factory which gives access to the filter expressions defined in this module. It inherits from SimpleExpressionFactory.