Shapely中的几何图形操作

Geometric Objects

object.area

Returns the area (float) of the object.

object.bounds

Returns a (minx, miny, maxx, maxy) tuple (float values) that bounds the object.

object.length

Returns the length (float) of the object.

object.geom_type

Returns a string specifying the Geometry Type

object.distance(other)

Returns the minimum distance (float) to the other geometric object.

object.representative_point()

Returns a cheaply computed point that is guaranteed to be within the geometric object.

Unary Predicates

object.has_z

Returns True if the feature has not only x and y, but also z coordinates for 3D (or so-called, 2.5D) geometries.

object.is_ccw

Returns True if coordinates are in counter-clockwise order (bounding a region with positive signed area). This method applies to LinearRing objects only

object.is_empty

Returns True if the feature’s interior and boundary (in point set terms) coincide with the empty set.

object.is_ring

Returns True if the feature is closed. A closed feature’s boundary coincides with the empty set.

object.is_simple

Returns True if the feature does not cross itself.

object.is_valid

Returns True if a feature is “valid” in the sense of [1].

Binary Predicates

object.almost_equals

(other[, decimal=6])

Returns True if the object is approximately equal to the other at all points to specified decimal place precision.

object.contains(other)

Returns True if the object’s interior contains the boundary and interior of the other object and their boundaries do not touch at all.

object.crosses(other)

Returns True if the interior of the object intersects the interior of the other but does not contain it, and the dimension of the intersection is less than the dimension of the one or the other.

object.disjoint(other)

Returns True if the boundary and interior of the object do not intersect at all with those of the other.

object.equals(other)

Returns True if the set-theoretic boundary, interior, and exterior of the object coincide with those of the other.

object.intersects(other)

Returns True if the boundary and interior of the object intersect in any way with those of the other.

object.touches(other)

Returns True if the objects have at least one point in common and their interiors do not intersect with any part of the other.

object.within(other)

Returns True if the object’s boundary and interior intersect only with the interior of the other (not its boundary or exterior).

DE-9IM Relationships

object.relate(other)

Returns a string representation of the DE-9IM matrix of relationships between an object’s interior, boundary, exterior and those of another geometric object.

Set-theoretic Methods

object.boundary

Returns a lower dimensional object representing the object’s set-theoretic boundary.

object.centroid

Returns a representation of the object’s geometric centroid (point).

object.difference(other)

Returns a representation of the points making up this geometric object that do not make up the other object.

object.intersection(other)

Returns a representation of the intersection of this object with the other geometric object.

object.symmetric_difference(other)

Returns a representation of the points in this object not in the other geometric object, and the points in the other not in this geometric object.

object.union(other)

Returns a representation of the union of points from this object and the other geometric object.

Constructive Methods

object.buffer

(distance, resolution=16,

cap_style=1, join_style=1,

mitre_limit=1.0)

Returns an approximate representation of all points within a given distance of the this geometric object.

object.convex_hull

Returns a representation of the smallest convex Polygon containing all the points in the object unless the number of points in the object is less than three.

object.envelope

Returns a representation of the point or smallest rectangular polygon (with sides parallel to the coordinate axes) that contains the object.

object.parallel_offset

(distance, side, resolution=16,

join_style=1, mitre_limit=1.0)

Returns a LineString or MultiLineString geometry at a distance from the object on its right or its left side.

object.simplify(tolerance,

preserve_topology=True)

Returns a simplified representation of the geometric object.

Affine Transformations

shapely.affinity.affine_transform

(geom, matrix)

Returns a transformed geometry using an affine transformation matrix.

shapely.affinity.rotate

(geom, angle, origin='center',

use_radians=False)

Returns a rotated geometry on a 2D plane.

shapely.affinity.scale

(geom, xfact=1.0, yfact=1.0,

zfact=1.0, origin='center')

Returns a scaled geometry, scaled by factors along each dimension.

shapely.affinity.skew

(geom, xs=0.0, ys=0.0,

origin='center', use_radians=False)

Returns a skewed geometry, sheared by angles along x and y dimensions.

shapely.affinity.translate

(geom, xoff=0.0, yoff=0.0, zoff=0.0)

Returns a translated geometry shifted by offsets along each dimension.

shapely.ops.transform(func, geom)

Applies func to all coordinates of geom and returns a new geometry of the same type from the transformed coordinates.

Merging Linear Features

shapely.ops.polygonize(lines)

Returns an iterator over polygons constructed from the input lines.

shapely.ops.polygonize_full(lines)

Creates polygons from a source of lines, returning the polygons and leftover geometries.

shapely.ops.linemerge(lines)

Returns a LineString or MultiLineString representing the merger of all contiguous elements of lines.

Cascading Unions

shapely.ops.cascaded_union(geoms)

Returns a representation of the union of the given geometric objects.

shapely.ops.unary_union(geoms)

Returns a representation of the union of the given geometric objects.

Prepared Geometry Operations

prepared.prep(ob)

Creates and returns a prepared geometric object.

Diagnostics

validation.explain_validity(ob)

Returns a string explaining the validity or invalidity of the object.

Interoperation--Well-Known Formats

object.wkb.encode('hex')

A Well Known Text (WKT) or Well Known Binary (WKB) representation [1] of any geometric object can be had via its wkt or wkb attribute.

object.wkt

shapely.wkb.dumps(ob)

Returns a WKB representation of ob.

shapely.wkb.loads(wkb)

Returns a geometric object from a WKB representation wkb.

shapely.wkt.dumps(ob)

Returns a WKT representation of ob.

shapely.wkt.loads(wkt)

Returns a geometric object from a WKT representation wkt.

Interoperation-- Numpy and Python Arrays

shapely.geometry.asShape()

family of functions can be used to wrap Numpy coordinate arrays so that they can then be analyzed using Shapely while maintaining their original storage

Interoperation-- Python Geo Interface

shapely.geometry.asShape(context)

Adapts the context to a geometry interface. The coordinates remain stored in the context.

shapely.geometry.shape(context)

Returns a new, independent geometry with coordinates copied from the context.

shapely.geometry.mapping(ob)

Returns a new, independent geometry with coordinates copied from the context.

 

Linear Referencing Methods

object.interpolate(distance[, normalized=False])

Return a point at the specified distance along a linear geometric object.

object.project

(other[, normalized=False])

Returns the distance along this geometric object to a point nearest the other object.

posted @ 2016-08-07 16:40  ParamousGIS  阅读(3599)  评论(1编辑  收藏  举报