{ "info": { "author": "databasin", "author_email": "databasinadmin@consbio.org", "bugtrack_url": null, "classifiers": [], "description": "# Trefoil (formerly Clover)\nBecause today might be your lucky day.\n\n**(note: this was renamed from `clover` on 4/20/2018 due to name conflicts on `pypi`)\n\nGeospatial operations with NetCDF files and numpy arrays.\n\n[![Build Status](https://travis-ci.org/consbio/trefoil.svg)](https://travis-ci.org/consbio/trefoil) [![Coverage Status](https://coveralls.io/repos/consbio/trefoil/badge.svg?branch=master&service=github)](https://coveralls.io/github/consbio/trefoil?branch=master)\n\n\n## Why?\nWe needed a library to consolidate a series of utility scripts and general\ngeospatial operations on NetCDF and numpy arrays. We found we were creating\na lot of purpose built scripts for other projects involving lots of processing\nof NetCDF climate and model outputs. Where possible, we have been pulling out\ngeneral patterns and placing them here. When we looked for existing work, we \ndidn't find anything that quite met our needs, with a clean API and no strong \nassertions about data model or compliance with CF-conventions \n(we aspire to conventions, but not all data meet them). \n\nSpecifically, we want to provide:\n\n* simple and fast API for rendering numpy arrays to images\n* simple API to provide utility functions that make working with NetCDF data\neasier\n* simple command line interface to make common operations easy and portable\n* analysis operations to simplify using geometries alongside raster data\n* analysis operations to summarize across various dimensions of spatial and \ntemporal-spatial datasets (anything more than 3 dimensions makes our heads hurt!)\n\nWe are trying to avoid reimplementing anything well-handled elsewhere. Where \npossible, we contribute functionality to other libraries (e.g., [rasterio](https://github.com/mapbox/rasterio))\nwhere we think that the functionality is general enough not to depend on\nliving within trefoil.\n\n\n## Where is it being used?\nThis is a core dependency for [ncdjango](https://github.com/consbio/ncdjango), our \nDjango-based NetCDF map server.\n\nWe are using this on a variety of internal projects within the Conservation\nBiology Institute.\n\n\n## Installation\n[pipenv](https://github.com/pypa/pipenv) is used for managing dependencies in this project.\n\n`pipenv install trefoil`\n\n\n### No longer directly maintained / supported:\nOn Windows, install the ones that require compiling from [Python Windows Packages](http://www.lfd.uci.edu/~gohlke/pythonlibs/).\nThen install the remainder using `pip`\n\n\n## Command line interface\nThis is currently undergoing heavy development. \nSee [CLI docs](https://github.com/consbio/trefoil/blob/master/docs/cli.md) for more information.\n\n\n## Work in progress\nThis is still under active development, as we have time and need. All APIs are\nsubject to change until we hit version 1.0.\n\nSpecifically, we need to work on:\n\n* standardizing API patterns\n* documentation\n* test coverage and correctness\n* roadmap\n\n\n## Contributors:\n\n* [Brendan C. Ward](https://github.com/brendan-ward)\n* [Nik Stevenson-Molnar](https://github.com/nikmolnar)\n\nWith inspiration from [Tim Sheehan](http://consbio.org/people/staff/tim-sheehan) \nand [Ken Ferschweiler](http://consbio.org/people/staff/ken-ferschweiler).\n\n\n## See Also:\n\n* [rasterio](https://github.com/mapbox/rasterio): Geospatial I/O and operations on rasters, done right.\n* [OCGIS](https://github.com/NCPP/ocgis): Geoprocessing on CF compatible climate datasets.\n* [scikit-image](http://scikit-image.org/): Python image processing\n* [python-rasterstats](https://github.com/perrygeo/python-rasterstats): Summary statistics of rasters using geometries\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/consbio/trefoil", "keywords": "", "license": "see LICENSE", "maintainer": "", "maintainer_email": "", "name": "trefoil", "package_url": "https://pypi.org/project/trefoil/", "platform": "", "project_url": "https://pypi.org/project/trefoil/", "project_urls": { "Homepage": "https://github.com/consbio/trefoil" }, "release_url": "https://pypi.org/project/trefoil/0.3.1.1/", "requires_dist": [ "affine (>=1.0)", "click", "jinja2", "palettable", "pytz", "six", "fiona (>=1.6.0)", "netCDF4 (>=1.1.1)", "Numpy", "Pillow (>=2.9.0)", "pyproj", "rasterio (>=1.0a12)" ], "requires_python": "", "summary": "Useful tools for spatial analysis using numpy and NetCDF", "version": "0.3.1.1" }, "last_serial": 4815641, "releases": { "0.3.0": [ { "comment_text": "", "digests": { "md5": "c263c83bfc193a07c366f28d1f4388fd", "sha256": "d1e0a37ce86bfcca9b70185d26922bd4920f83617d1b8716a15df01ae78b6dbc" }, "downloads": -1, "filename": "trefoil-0.3.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "c263c83bfc193a07c366f28d1f4388fd", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 71257, "upload_time": "2018-04-21T05:27:25", "url": "https://files.pythonhosted.org/packages/8f/f0/809ac7d3570238244dc7292be66cc497b3785c8454a6e666c1dbaba8b7ad/trefoil-0.3.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8f68f5a343cc92e9be626d1a6d9fd6d9", "sha256": "12724644caf70557c45d89749b44ee30b4668d02213e0ef4249c0ac07ce1ddaa" }, "downloads": -1, "filename": "trefoil-0.3.0.tar.gz", "has_sig": false, "md5_digest": "8f68f5a343cc92e9be626d1a6d9fd6d9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 51618, "upload_time": "2018-04-21T05:27:27", "url": "https://files.pythonhosted.org/packages/d1/a1/2d774244716cb6b5716712f91679260d77a444cfa0dfeecc3ccfb5166aa8/trefoil-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "7dd58675710a13b942798b1ec6dbc6f0", "sha256": "f0966dbf422cf374814aa811091d8f23c8e698b7565e72a227bd42fc0bed46a0" }, "downloads": -1, "filename": "trefoil-0.3.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "7dd58675710a13b942798b1ec6dbc6f0", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 74517, "upload_time": "2019-01-06T13:20:54", "url": "https://files.pythonhosted.org/packages/23/0f/27a01538889411ea2114b9603573a79ee88d78a8e261fa7c785b36ef3fa4/trefoil-0.3.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7902289f932ddd19a83aa4f265af5376", "sha256": "483375fece52a5abdb119cc2cb09ddb4bc7e89ffd59d656fdf08f15edb8ec001" }, "downloads": -1, "filename": "trefoil-0.3.1.tar.gz", "has_sig": false, "md5_digest": "7902289f932ddd19a83aa4f265af5376", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 53958, "upload_time": "2019-01-06T13:20:56", "url": "https://files.pythonhosted.org/packages/34/8e/750b3782440c13e930638b65dc0c9ae7cc002ed5db27c4c521bec66075bc/trefoil-0.3.1.tar.gz" } ], "0.3.1.1": [ { "comment_text": "", "digests": { "md5": "e2cb961bcb7c41293362b49c102dd29d", "sha256": "8fa3a4d94b29d539085d125f24dca3089515d4f4b65f3d68aaf5c97c9c19b26e" }, "downloads": -1, "filename": "trefoil-0.3.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e2cb961bcb7c41293362b49c102dd29d", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 74542, "upload_time": "2019-02-13T13:11:23", "url": "https://files.pythonhosted.org/packages/8a/43/0ea98673cd3376346130018b620023ba302ce2fbb0e6514d09e4c89c34b4/trefoil-0.3.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "baab296fa5abb7382bc002d18766efe9", "sha256": "d2e05ee258042d34b391d98ffe5d850c48cca06bf5592a20b4d8bccdfee2d96e" }, "downloads": -1, "filename": "trefoil-0.3.1.1.tar.gz", "has_sig": false, "md5_digest": "baab296fa5abb7382bc002d18766efe9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 53952, "upload_time": "2019-02-13T13:11:25", "url": "https://files.pythonhosted.org/packages/8b/6f/db4caa0046be50148d9dfb8daa987ca4f4356b989cbf83ef9098682004ff/trefoil-0.3.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "e2cb961bcb7c41293362b49c102dd29d", "sha256": "8fa3a4d94b29d539085d125f24dca3089515d4f4b65f3d68aaf5c97c9c19b26e" }, "downloads": -1, "filename": "trefoil-0.3.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e2cb961bcb7c41293362b49c102dd29d", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 74542, "upload_time": "2019-02-13T13:11:23", "url": "https://files.pythonhosted.org/packages/8a/43/0ea98673cd3376346130018b620023ba302ce2fbb0e6514d09e4c89c34b4/trefoil-0.3.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "baab296fa5abb7382bc002d18766efe9", "sha256": "d2e05ee258042d34b391d98ffe5d850c48cca06bf5592a20b4d8bccdfee2d96e" }, "downloads": -1, "filename": "trefoil-0.3.1.1.tar.gz", "has_sig": false, "md5_digest": "baab296fa5abb7382bc002d18766efe9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 53952, "upload_time": "2019-02-13T13:11:25", "url": "https://files.pythonhosted.org/packages/8b/6f/db4caa0046be50148d9dfb8daa987ca4f4356b989cbf83ef9098682004ff/trefoil-0.3.1.1.tar.gz" } ] }