shapely.intersects_xy

intersects_xy(geom, x, y=None, **kwargs)

Return True if geom and the Point (x, y) share any portion of space.

This is a special-case (and faster) variant of the intersects() function which avoids having to create a Point object if you start from x/y coordinates.

See the docstring of intersects() for more details about the predicate.

If you need to test multiple geometries against the same geometry, you can improve performance by preparing geom in advance using prepare().

Parameters:

geomGeometry or array_like

Geometry or geometries to check if they intersect with the point.

x, yfloat or array_like

Coordinates as separate x and y arrays, or a single array of coordinate x, y tuples.

**kwargs

See NumPy ufunc docs for other keyword arguments.

See also

intersects

variant taking two geometries as input

prepare

improve performance by preparing geom (the first argument)

Notes

If you compare a single or few geometries with many points, it can be beneficial to prepare the geometries in advance using shapely.prepare().

The touches predicate can be determined with this function by getting the boundary of the geometries: intersects_xy(boundary(geom), x, y).

Examples

>>> import shapely
>>> from shapely import LineString, Point
>>> line = LineString([(0, 0), (1, 1)])
>>> shapely.intersects(line, Point(0, 0))
True
>>> shapely.intersects_xy(line, 0, 0)
True