geodesic.entanglement.object.get_objects¶
- geodesic.entanglement.object.get_objects(*, search=None, version_datetime=None, object_class=None, domain=None, category=None, type=None, xid=None, geometry=None, spatial_predicate='intersects', distance=0.0, project=None, limit=500, page_size=500, as_graph=False)[source]¶
Search for objects in Entanglement. There are a few ways of requesting/filtering them. A blank query will return the first 500 nodes for a project (in order of creation).
- Parameters
search – a search string with which to query object names and descriptions. Anything that matches this query will be returned in the specified project.
version_datetime – search for versions of nodes that were valid at this datetime. Defaults to None which will only search for latest nodes.
object_class – filters the search by object class (e.g. observable, dataset, entity, etc)
domain – filters the search by domain
category – filters the search by category
type – filters the search by object type
xid – filters by external ID
geometry – is a spatial filter is designed, this can be any shapely geometry, GeoJSON as dict, or other object with a __geo_interface__ attribute. Geometries must be in WGS84 lon/lat.
spatial_predicate – A spatial predicate for the filter, either ‘contains’, ‘within’, ‘intersects’, or ‘near’
distance – If the predicate is ‘near’, a distance, in meters, to query from the point.
project – a Project or project name/alias to get objects for. A query can only be for a single project. If you want objects for multiple projects, break up into separate queries.
limit – The max number of objects to return (500 by default). Set to None to return everything matching a query (USE WITH CAUTION, GRAPHS CAN CONTAIN MANY NODES)
page_size – The number of results per request. This shouldn’t need to be changed unless you’re running into issues.
as_graph – If True, will return as a Graph object instead of a list.
- Returns
Either a Graph or list of objects matching the query.