Metadata-Version: 2.4
Name: pycoast
Version: 1.8.0
Summary: Writing of coastlines, borders and rivers to images in Python
Author: Esben S. Nielsen
Author-email: esn@dmi.dk
License: Apache-2.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Requires-Python: >3.9
License-File: LICENSE.txt
Requires-Dist: aggdraw
Requires-Dist: pyshp
Requires-Dist: numpy
Requires-Dist: pyproj
Requires-Dist: pillow
Provides-Extra: docs
Requires-Dist: pyresample; extra == "docs"
Requires-Dist: pytest; extra == "docs"
Requires-Dist: pytest-lazy-fixtures; extra == "docs"
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx_rtd_theme; extra == "docs"
Requires-Dist: sphinxcontrib-apidoc; extra == "docs"
Provides-Extra: tests
Requires-Dist: coverage; extra == "tests"
Requires-Dist: coveralls; extra == "tests"
Requires-Dist: pyresample; extra == "tests"
Requires-Dist: pytest; extra == "tests"
Requires-Dist: pytest-cov; extra == "tests"
Requires-Dist: pytest-lazy-fixtures; extra == "tests"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

PyCoast
=======

.. image:: https://github.com/pytroll/pycoast/workflows/CI/badge.svg?branch=main
    :target: https://github.com/pytroll/pycoast/actions?query=workflow%3A%22CI%22

.. image:: https://coveralls.io/repos/github/pytroll/pycoast/badge.svg?branch=main
    :target: https://coveralls.io/github/pytroll/pycoast?branch=main

.. image:: https://img.shields.io/pypi/v/pycoast.svg
        :target: https://pypi.python.org/pypi/pycoast

.. image:: https://results.pre-commit.ci/badge/github/pytroll/pycoast/main.svg
   :target: https://results.pre-commit.ci/latest/github/pytroll/pycoast/main
   :alt: pre-commit.ci status

Python package for adding coastlines, borders, rivers, lakes, cities, and other
overlays to raster images.

Installation
------------

PyCoast can be installed from PyPI using pip::

    pip install pycoast

Or with conda using the conda-forge channel::

    conda install -c conda-forge pycoast

Example
-------

::

    >>> from PIL import Image
    >>> from pycoast import ContourWriterAGG
    >>> img = Image.open('BMNG_clouds_201109181715_areaT2.png')
    >>> proj4_string = '+proj=stere +lon_0=8.00 +lat_0=50.00 +lat_ts=50.00 +ellps=WGS84'
    >>> area_extent = (-3363403.31,-2291879.85,2630596.69,2203620.1)
    >>> area_def = (proj4_string, area_extent)
    >>> cw = ContourWriterAGG('/home/esn/data/gshhs')
    >>> cw.add_coastlines(img, area_def, resolution='l', level=4)
    >>> cw.add_rivers(img, area_def, level=5, outline='blue')
    >>> cw.add_borders(img, area_def, outline=(255, 0, 0))
    >>> img.show()

License
-------

Copyright 2011 Pycoast developers

Licensed under the Apache License, Version 2.0 (the "License");
you may not use these files except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
