| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182 |
- """Load/dump geometries using the well-known text (WKT) format.
- Also provides pickle-like convenience functions.
- """
- import shapely
- def loads(data):
- """Load a geometry from a WKT string.
- Parameters
- ----------
- data : str
- A WKT string
- Returns
- -------
- Shapely geometry object
- """
- return shapely.from_wkt(data)
- def load(fp):
- """Load a geometry from an open file.
- Parameters
- ----------
- fp :
- A file-like object which implements a `read` method.
- Returns
- -------
- Shapely geometry object
- """
- data = fp.read()
- return loads(data)
- def dumps(ob, trim=False, rounding_precision=-1, **kw):
- """Dump a WKT representation of a geometry to a string.
- Parameters
- ----------
- ob :
- A geometry object of any type to be dumped to WKT.
- trim : bool, default False
- Remove excess decimals from the WKT.
- rounding_precision : int, default -1
- Round output to the specified number of digits.
- Default behavior returns full precision.
- **kw : kwargs, optional
- Keyword output options passed to :func:`~shapely.to_wkt`.
- Returns
- -------
- input geometry as WKT string
- """
- return shapely.to_wkt(ob, trim=trim, rounding_precision=rounding_precision, **kw)
- def dump(ob, fp, **settings):
- """Dump a geometry to an open file.
- Parameters
- ----------
- ob :
- A geometry object of any type to be dumped to WKT.
- fp :
- A file-like object which implements a `write` method.
- **settings : kwargs, optional
- Keyword output options passed to :func:`~shapely.wkt.dumps`.
- Returns
- -------
- None
- """
- fp.write(dumps(ob, **settings))
|