Previous topic


Next topic


This Page


The filter module provides utilities for parsing and encoding filters.

class geoscript.filter.Filter

A predicate or constraint used to match or filter Feature objects.

obj is the CQL str representation of the filter.

>>> f = Filter("name = 'foobar'")
>>> f
[ name = foobar ]

obj may also be specified as XML.

>>> f = Filter('<Filter><PropertyIsEqualTo><PropertyName>name</PropertyName><Literal>foobar</Literal></PropertyIsEqualTo></Filter>')
>>> f
[ name = foobar ]

The CQL representation of the filter.


Evaluates the filter against a Feature.

f is the geoscript.feature.Feature to evaluate against.

>>> from geoscript.feature import Feature
>>> feature = Feature({'name': 'foobar'})
>>> f = Filter("name = 'foobar'")
>>> f.evaluate(feature)
xml(pretty=True, version=1.0)

Returns the OGC XML representation of the filter.

pretty controls if the resulting xml is “pretty printed” or not.

version specifies the version of of the OGC filter encoding specification to use for encoding. The default is 1.0. Other possibilites include 1.1.

>>> f = Filter("name = 'foobar'")
>>> xml = f.xml(False)
>>> from xml.dom import minidom
>>> d = minidom.parseString(xml)
>>> str(d.documentElement.tagName)