![Raster Vision Logo](https://raw.githubusercontent.com/azavea/raster-vision/0.30/docs/img/raster-vision-logo.png)
[![Pypi](https://img.shields.io/pypi/v/rastervision.svg)](https://pypi.org/project/rastervision/)
[![Documentation Status](https://readthedocs.org/projects/raster-vision/badge/?version=latest)](https://docs.rastervision.io/en/stable/?badge=stable)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Build Status](https://github.com/azavea/raster-vision/actions/workflows/release.yml/badge.svg)](https://github.com/azavea/raster-vision/actions/workflows/release.yml)
[![codecov](https://codecov.io/gh/azavea/raster-vision/branch/master/graph/badge.svg)](https://codecov.io/gh/azavea/raster-vision)
Raster Vision is an open source Python **library** and **framework** for building computer vision models on satellite, aerial, and other large imagery sets (including oblique drone imagery).
It has built-in support for chip classification, object detection, and semantic segmentation with backends using PyTorch.
<div align="center">
<img src="docs/img/cv-tasks.png" alt="Examples of chip classification, object detection and semantic segmentation" width="60%">
</div>
**As a library**, Raster Vision provides a full suite of utilities for dealing with all aspects of a geospatial deep learning workflow: reading geo-referenced data, training models, making predictions, and writing out predictions in geo-referenced formats.
**As a low-code framework**, Raster Vision allows users (who don't need to be experts in deep learning!) to quickly and repeatably configure experiments that execute a machine learning pipeline including: analyzing training data, creating training chips, training models, creating predictions, evaluating models, and bundling the model files and configuration for easy deployment.
![Overview of Raster Vision workflow](https://raw.githubusercontent.com/azavea/raster-vision/0.30/docs/img/rv-pipeline-overview.png)
Raster Vision also has built-in support for running experiments in the cloud using [AWS Batch](https://github.com/azavea/raster-vision-aws).
See the [documentation](https://docs.rastervision.io/en/stable/) for more details.
## Installation
*For more details, see the [Setup documentation](https://docs.rastervision.io/en/stable/setup/)*.
### Install via `pip`
You can install Raster Vision directly via `pip`.
```sh
pip install rastervision
```
### Use Pre-built Docker Image
Alternatively, you may use a Docker image. Docker images are published to [quay.io](https://quay.io/repository/azavea/raster-vision) (see the *tags* tab).
We publish a new tag per merge into `master`, which is tagged with the first 7 characters of the commit hash. To use the latest version, pull the `latest` suffix, e.g. `raster-vision:pytorch-latest`. Git tags are also published, with the Github tag name as the Docker tag suffix.
### Build Docker Image
You can also build a Docker image from scratch yourself. After cloning this repo, run `docker/build`, and run then the container using `docker/run`.
## Usage Examples and Tutorials
**Non-developers** may find it easiest to use Raster Vision as a low-code framework where Raster Vision handles all the complexities and the user only has to configure a few parameters. The [*Quickstart guide*](https://docs.rastervision.io/en/stable/framework/quickstart.html) is a good entry-point into this. More advanced examples can be found on the [*Examples*](https://docs.rastervision.io/en/stable/framework/examples.html) page.
For **developers** and those looking to dive deeper or combine Raster Vision with their own code, the best starting point is [*Usage Overview*](https://docs.rastervision.io/en/stable/usage/overview.html), followed by [*Basic Concepts*](https://docs.rastervision.io/en/stable/usage/basics.html) and [*Tutorials*](https://docs.rastervision.io/en/stable/usage/tutorials/index.html).
## Contact and Support
You can ask questions and talk to developers (let us know what you're working on!) at:
* [Discussion Forum](https://github.com/azavea/raster-vision/discussions)
* [Mailing List](https://groups.google.com/forum/#!forum/raster-vision)
## Contributing
*For more information, see the [Contribution page](https://docs.rastervision.io/en/stable/CONTRIBUTING.html).*
We are happy to take contributions! It is best to get in touch with the maintainers
about larger features or design changes *before* starting the work,
as it will make the process of accepting changes smoother.
Everyone who contributes code to Raster Vision will be asked to sign the
Azavea CLA, which is based off of the Apache CLA.
1. Download a copy of the [Raster Vision Individual Contributor License
Agreement](docs/_static/cla/2018_04_17-Raster-Vision-Open-Source-Contributor-Agreement-Individual.pdf)
or the [Raster Vision Corporate Contributor License
Agreement](docs/_static/cla/2018_04_18-Raster-Vision-Open-Source-Contributor-Agreement-Corporate.pdf)
2. Print out the CLAs and sign them, or use PDF software that allows placement of a signature image.
3. Send the CLAs to Azavea by one of:
- Scanning and emailing the document to cla@azavea.com
- Faxing a copy to +1-215-925-2600.
- Mailing a hardcopy to:
Azavea, 990 Spring Garden Street, 5th Floor, Philadelphia, PA 19107 USA
## Licenses
Raster Vision is licensed under the Apache 2 license. See license [here](./LICENSE).
3rd party licenses for all dependecies used by Raster Vision can be found [here](./THIRD_PARTY_LICENSES.txt).
Raw data
{
"_id": null,
"home_page": "https://github.com/azavea/raster-vision",
"name": "rastervision",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "raster deep-learning ml computer-vision earth-observation geospatial geospatial-processing",
"author": "Azavea",
"author_email": "info@azavea.com",
"download_url": "https://files.pythonhosted.org/packages/21/69/0513f3bf270fc7072cf4a3c7527bee18f1d0f14206e200941cf7f1d43886/rastervision-0.30.0.tar.gz",
"platform": null,
"description": "![Raster Vision Logo](https://raw.githubusercontent.com/azavea/raster-vision/0.30/docs/img/raster-vision-logo.png)\n \n\n[![Pypi](https://img.shields.io/pypi/v/rastervision.svg)](https://pypi.org/project/rastervision/)\n[![Documentation Status](https://readthedocs.org/projects/raster-vision/badge/?version=latest)](https://docs.rastervision.io/en/stable/?badge=stable)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Build Status](https://github.com/azavea/raster-vision/actions/workflows/release.yml/badge.svg)](https://github.com/azavea/raster-vision/actions/workflows/release.yml)\n[![codecov](https://codecov.io/gh/azavea/raster-vision/branch/master/graph/badge.svg)](https://codecov.io/gh/azavea/raster-vision)\n\nRaster Vision is an open source Python **library** and **framework** for building computer vision models on satellite, aerial, and other large imagery sets (including oblique drone imagery).\n\nIt has built-in support for chip classification, object detection, and semantic segmentation with backends using PyTorch.\n\n<div align=\"center\">\n <img src=\"docs/img/cv-tasks.png\" alt=\"Examples of chip classification, object detection and semantic segmentation\" width=\"60%\">\n</div>\n\n**As a library**, Raster Vision provides a full suite of utilities for dealing with all aspects of a geospatial deep learning workflow: reading geo-referenced data, training models, making predictions, and writing out predictions in geo-referenced formats.\n\n**As a low-code framework**, Raster Vision allows users (who don't need to be experts in deep learning!) to quickly and repeatably configure experiments that execute a machine learning pipeline including: analyzing training data, creating training chips, training models, creating predictions, evaluating models, and bundling the model files and configuration for easy deployment.\n![Overview of Raster Vision workflow](https://raw.githubusercontent.com/azavea/raster-vision/0.30/docs/img/rv-pipeline-overview.png)\n\nRaster Vision also has built-in support for running experiments in the cloud using [AWS Batch](https://github.com/azavea/raster-vision-aws).\n\nSee the [documentation](https://docs.rastervision.io/en/stable/) for more details.\n\n## Installation\n\n*For more details, see the [Setup documentation](https://docs.rastervision.io/en/stable/setup/)*.\n\n### Install via `pip`\n\nYou can install Raster Vision directly via `pip`.\n\n```sh\npip install rastervision\n```\n\n### Use Pre-built Docker Image\n\nAlternatively, you may use a Docker image. Docker images are published to [quay.io](https://quay.io/repository/azavea/raster-vision) (see the *tags* tab).\n\nWe publish a new tag per merge into `master`, which is tagged with the first 7 characters of the commit hash. To use the latest version, pull the `latest` suffix, e.g. `raster-vision:pytorch-latest`. Git tags are also published, with the Github tag name as the Docker tag suffix.\n\n### Build Docker Image\n\nYou can also build a Docker image from scratch yourself. After cloning this repo, run `docker/build`, and run then the container using `docker/run`.\n\n## Usage Examples and Tutorials\n\n**Non-developers** may find it easiest to use Raster Vision as a low-code framework where Raster Vision handles all the complexities and the user only has to configure a few parameters. The [*Quickstart guide*](https://docs.rastervision.io/en/stable/framework/quickstart.html) is a good entry-point into this. More advanced examples can be found on the [*Examples*](https://docs.rastervision.io/en/stable/framework/examples.html) page.\n\nFor **developers** and those looking to dive deeper or combine Raster Vision with their own code, the best starting point is [*Usage Overview*](https://docs.rastervision.io/en/stable/usage/overview.html), followed by [*Basic Concepts*](https://docs.rastervision.io/en/stable/usage/basics.html) and [*Tutorials*](https://docs.rastervision.io/en/stable/usage/tutorials/index.html).\n\n\n## Contact and Support\n\nYou can ask questions and talk to developers (let us know what you're working on!) at:\n* [Discussion Forum](https://github.com/azavea/raster-vision/discussions)\n* [Mailing List](https://groups.google.com/forum/#!forum/raster-vision)\n\n## Contributing\n\n*For more information, see the [Contribution page](https://docs.rastervision.io/en/stable/CONTRIBUTING.html).*\n\nWe are happy to take contributions! It is best to get in touch with the maintainers\nabout larger features or design changes *before* starting the work,\nas it will make the process of accepting changes smoother.\n\nEveryone who contributes code to Raster Vision will be asked to sign the\nAzavea CLA, which is based off of the Apache CLA.\n\n1. Download a copy of the [Raster Vision Individual Contributor License\n Agreement](docs/_static/cla/2018_04_17-Raster-Vision-Open-Source-Contributor-Agreement-Individual.pdf)\n or the [Raster Vision Corporate Contributor License\n Agreement](docs/_static/cla/2018_04_18-Raster-Vision-Open-Source-Contributor-Agreement-Corporate.pdf)\n\n2. Print out the CLAs and sign them, or use PDF software that allows placement of a signature image.\n\n3. Send the CLAs to Azavea by one of:\n - Scanning and emailing the document to cla@azavea.com\n - Faxing a copy to +1-215-925-2600.\n - Mailing a hardcopy to:\n Azavea, 990 Spring Garden Street, 5th Floor, Philadelphia, PA 19107 USA\n\n## Licenses\n\nRaster Vision is licensed under the Apache 2 license. See license [here](./LICENSE).\n\n3rd party licenses for all dependecies used by Raster Vision can be found [here](./THIRD_PARTY_LICENSES.txt).\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "An open source framework for deep learning on satellite and aerial imagery",
"version": "0.30.0",
"project_urls": {
"Homepage": "https://github.com/azavea/raster-vision"
},
"split_keywords": [
"raster",
"deep-learning",
"ml",
"computer-vision",
"earth-observation",
"geospatial",
"geospatial-processing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "346d7d19481eedc10125fe8131a33b65124ea7cab95f37d482442c043928b50d",
"md5": "4b0e57534aa49d335913ae29de1b1c4f",
"sha256": "491d3616baf460b99af6bbb8ef2cbfb68c9cc209110a582a37035a817a9c76b4"
},
"downloads": -1,
"filename": "rastervision-0.30.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4b0e57534aa49d335913ae29de1b1c4f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4168,
"upload_time": "2024-04-10T22:17:26",
"upload_time_iso_8601": "2024-04-10T22:17:26.496725Z",
"url": "https://files.pythonhosted.org/packages/34/6d/7d19481eedc10125fe8131a33b65124ea7cab95f37d482442c043928b50d/rastervision-0.30.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "21690513f3bf270fc7072cf4a3c7527bee18f1d0f14206e200941cf7f1d43886",
"md5": "0c7a6946e49f4155e0ba4654b9ee7beb",
"sha256": "2da5977f8b353c699bf26a15db5e4c53568075dbf65d3fc24f39c4b62a9167ab"
},
"downloads": -1,
"filename": "rastervision-0.30.0.tar.gz",
"has_sig": false,
"md5_digest": "0c7a6946e49f4155e0ba4654b9ee7beb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4742,
"upload_time": "2024-04-10T22:17:28",
"upload_time_iso_8601": "2024-04-10T22:17:28.298882Z",
"url": "https://files.pythonhosted.org/packages/21/69/0513f3bf270fc7072cf4a3c7527bee18f1d0f14206e200941cf7f1d43886/rastervision-0.30.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-10 22:17:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "azavea",
"github_project": "raster-vision",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "rastervision_pipeline",
"specs": [
[
"==",
"0.30.0"
]
]
},
{
"name": "rastervision_aws_s3",
"specs": [
[
"==",
"0.30.0"
]
]
},
{
"name": "rastervision_aws_batch",
"specs": [
[
"==",
"0.30.0"
]
]
},
{
"name": "rastervision_core",
"specs": [
[
"==",
"0.30.0"
]
]
},
{
"name": "rastervision_pytorch_learner",
"specs": [
[
"==",
"0.30.0"
]
]
},
{
"name": "rastervision_pytorch_backend",
"specs": [
[
"==",
"0.30.0"
]
]
}
],
"lcname": "rastervision"
}