cbers4asat


Namecbers4asat JSON
Version 0.7.3 PyPI version JSON
download
home_page
SummaryBiblioteca Python para realizar a busca e processamento de imagens dos satélites CBERS-04A e AMAZONIA-1
upload_time2024-02-20 13:37:59
maintainer
docs_urlNone
author
requires_python>=3.8
licenseMIT License Copyright (c) 2023 Gabriel Russo Copyright (c) 2020 Sandro Klippel Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords amazonia-1 cbers cbers-04a cbers4a geoprocessing remote sensing
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # cbers4asat

## Descrição

Biblioteca Python para realizar a busca e processamento de imagens dos satélites CBERS-04A e AMAZONIA-1.

A biblioteca `cbers4asat` surgiu da necessidade de automatizar a busca e manipulação de imagens do satélite
sino-brasileiro CBERS-04A utilizando linguagens de programação. Posteriormente foi incluido a automação do satélite AMAZONIA-1.

O design do projeto foi inspirado no [sentinelsat](https://github.com/sentinelsat/sentinelsat), onde é possível de forma
intuitiva realizar diversas ações, como: 
- Pesquisar por imagens. 
- Baixar as imagens pesquisadas.
- Processar as imagens baixadas.

Veja todos os [exemplos de uso](https://cbers4asat.readthedocs.io/pt_BR/latest/examples/) na documentação.

Também disponível uma [Interface de Linha de Comando](https://www.hostinger.com.br/tutoriais/o-que-e-cli) (CLI) do `cbers4asat` para Windows e Linux. [Clique aqui e saiba mais](https://cbers4asat.readthedocs.io/pt_BR/latest/cli/).

---
[![Latest Version](https://img.shields.io/pypi/v/cbers4asat?style=plastic)](https://pypi.python.org/pypi/cbers4asat/)
[![Latest Version](https://img.shields.io/pypi/l/cbers4asat?style=plastic)](https://github.com/gabriel-russo/cbers4asat/blob/master/LICENSE)
[![Latest Version](https://img.shields.io/pypi/pyversions/cbers4asat?style=plastic)](https://pypi.python.org/pypi/cbers4asat/)
[![Latest Version](https://img.shields.io/pypi/dm/cbers4asat?style=plastic)](https://pypi.python.org/pypi/cbers4asat/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)
![GitHub Workflow Status](https://github.com/gabriel-russo/cbers4asat/actions/workflows/build-cbers4asat.yml/badge.svg)
![GitHub Workflow Status](https://github.com/gabriel-russo/cbers4asat/actions/workflows/build-cbers4asat-cli.yml/badge.svg)
![GitHub Workflow Status](https://github.com/gabriel-russo/cbers4asat/actions/workflows/test-cbers4asat.yml/badge.svg)
[![Documentation Status](https://readthedocs.org/projects/cbers4asat/badge/?version=latest)](https://cbers4asat.readthedocs.io/pt_BR/latest/?badge=latest)
> [Read this README in english (old version of docs)](https://github.com/gabriel-russo/cbers4asat/blob/master/en-US_README.md)
> 🇺🇸

## Busque imagens com poucas linhas de código

```python
from cbers4asat import Cbers4aAPI
from datetime import date

# Inicializando a biblioteca
api = Cbers4aAPI('email@mail.com')

# Área de interesse. Pode ser: bouding box, path row ou polygon.
path_row = (229, 124)

# Buscando metadados. Este exemplo utiliza o path row (órbita/ponto). 
# Consulte a órbita/ponto: http://www.dgi.inpe.br/documentacao/grades
produtos = api.query(location=path_row,
                     initial_date=date(2021, 6, 1),
                     end_date=date(2021, 7, 1),
                     cloud=100,
                     limit=10,
                     collections=['AMAZONIA1_WFI_L2_DN', 'CBERS4A_WPM_L4_DN'])

# Exibindo os resultados
print(produtos)
```

## Utilize a caixa de ferramenta para os trabalhos mais comuns

```python
# Para ver todas as ferramentas disponíveis, verifique a documentação
from cbers4asat.tools import rgbn_composite
import rasterio as rio
from rasterio.plot import show

# Criando a composição cor verdadeira
rgbn_composite(red='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND3.tif',
               green='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND2.tif',
               blue='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND1.tif',
               nir='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND4.tif',
               filename='CBERS4A_WPM22812420210704_TRUE_COLOR.tif',
               outdir='./STACK')

# Plotando a imagem
raster = rio.open("./STACK/CBERS4A_WPM22812420210704_TRUE_COLOR.tif")

show(raster.read(), transform=raster.transform)
```

## Download da biblioteca com pip

```
pip install cbers4asat
```

Instalação com a caixa de ferramentas

```
pip install "cbers4asat[tools]"
```

## Documentação

Você pode ler a documentação da biblioteca no link abaixo

> https://cbers4asat.readthedocs.io/

## TCC

Esse projeto foi meu objeto de estudo do Trabalho de Conclusão de Curso (TCC) no curso de Bacharelado em Ciência da Computação, você
pode visualizar o PDF neste Link:

[Repositório Institucional da Universidade Federal de Rondônia](https://ri.unir.br/jspui/handle/123456789/4345)

## Contribuição

Convido qualquer pessoa a participar contribuindo com código, relatando bugs,
escrevendo documentação, criando tutoriais e discutindo o futuro deste projeto.

Para mais informações de como contribuir ao projeto,
leia [ao manual de contribuição](https://github.com/gabriel-russo/cbers4asat/blob/master/CONTRIBUTING.md)

## Progresso do projeto

Você pode acompanhar todo o progresso do desenvolvimento
no [painel de projetos](https://github.com/gabriel-russo/cbers4asat/projects)

# Licença

Copyright (c) 2023 Gabriel Russo

Copyright (c) 2020 Sandro Klippel

O uso é fornecido sob a Licença do MIT. Veja
em [LICENSE](https://github.com/gabriel-russo/cbers4asat/blob/master/LICENSE)
para mais detalhes.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "cbers4asat",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "amazonia-1,cbers,cbers-04a,cbers4a,geoprocessing,remote sensing",
    "author": "",
    "author_email": "Gabriel Russo <gabrielrusso@protonmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/57/4a/2013bc9f5d6ec34e3cb3b9c823d31b784119e54e62060f780534cc9d8e92/cbers4asat-0.7.3.tar.gz",
    "platform": null,
    "description": "# cbers4asat\n\n## Descri\u00e7\u00e3o\n\nBiblioteca Python para realizar a busca e processamento de imagens dos sat\u00e9lites CBERS-04A e AMAZONIA-1.\n\nA biblioteca `cbers4asat` surgiu da necessidade de automatizar a busca e manipula\u00e7\u00e3o de imagens do sat\u00e9lite\nsino-brasileiro CBERS-04A utilizando linguagens de programa\u00e7\u00e3o. Posteriormente foi incluido a automa\u00e7\u00e3o do sat\u00e9lite AMAZONIA-1.\n\nO design do projeto foi inspirado no [sentinelsat](https://github.com/sentinelsat/sentinelsat), onde \u00e9 poss\u00edvel de forma\nintuitiva realizar diversas a\u00e7\u00f5es, como: \n- Pesquisar por imagens. \n- Baixar as imagens pesquisadas.\n- Processar as imagens baixadas.\n\nVeja todos os [exemplos de uso](https://cbers4asat.readthedocs.io/pt_BR/latest/examples/) na documenta\u00e7\u00e3o.\n\nTamb\u00e9m dispon\u00edvel uma [Interface de Linha de Comando](https://www.hostinger.com.br/tutoriais/o-que-e-cli) (CLI) do `cbers4asat` para Windows e Linux. [Clique aqui e saiba mais](https://cbers4asat.readthedocs.io/pt_BR/latest/cli/).\n\n---\n[![Latest Version](https://img.shields.io/pypi/v/cbers4asat?style=plastic)](https://pypi.python.org/pypi/cbers4asat/)\n[![Latest Version](https://img.shields.io/pypi/l/cbers4asat?style=plastic)](https://github.com/gabriel-russo/cbers4asat/blob/master/LICENSE)\n[![Latest Version](https://img.shields.io/pypi/pyversions/cbers4asat?style=plastic)](https://pypi.python.org/pypi/cbers4asat/)\n[![Latest Version](https://img.shields.io/pypi/dm/cbers4asat?style=plastic)](https://pypi.python.org/pypi/cbers4asat/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)\n![GitHub Workflow Status](https://github.com/gabriel-russo/cbers4asat/actions/workflows/build-cbers4asat.yml/badge.svg)\n![GitHub Workflow Status](https://github.com/gabriel-russo/cbers4asat/actions/workflows/build-cbers4asat-cli.yml/badge.svg)\n![GitHub Workflow Status](https://github.com/gabriel-russo/cbers4asat/actions/workflows/test-cbers4asat.yml/badge.svg)\n[![Documentation Status](https://readthedocs.org/projects/cbers4asat/badge/?version=latest)](https://cbers4asat.readthedocs.io/pt_BR/latest/?badge=latest)\n> [Read this README in english (old version of docs)](https://github.com/gabriel-russo/cbers4asat/blob/master/en-US_README.md)\n> \ud83c\uddfa\ud83c\uddf8\n\n## Busque imagens com poucas linhas de c\u00f3digo\n\n```python\nfrom cbers4asat import Cbers4aAPI\nfrom datetime import date\n\n# Inicializando a biblioteca\napi = Cbers4aAPI('email@mail.com')\n\n# \u00c1rea de interesse. Pode ser: bouding box, path row ou polygon.\npath_row = (229, 124)\n\n# Buscando metadados. Este exemplo utiliza o path row (\u00f3rbita/ponto). \n# Consulte a \u00f3rbita/ponto: http://www.dgi.inpe.br/documentacao/grades\nprodutos = api.query(location=path_row,\n                     initial_date=date(2021, 6, 1),\n                     end_date=date(2021, 7, 1),\n                     cloud=100,\n                     limit=10,\n                     collections=['AMAZONIA1_WFI_L2_DN', 'CBERS4A_WPM_L4_DN'])\n\n# Exibindo os resultados\nprint(produtos)\n```\n\n## Utilize a caixa de ferramenta para os trabalhos mais comuns\n\n```python\n# Para ver todas as ferramentas dispon\u00edveis, verifique a documenta\u00e7\u00e3o\nfrom cbers4asat.tools import rgbn_composite\nimport rasterio as rio\nfrom rasterio.plot import show\n\n# Criando a composi\u00e7\u00e3o cor verdadeira\nrgbn_composite(red='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND3.tif',\n               green='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND2.tif',\n               blue='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND1.tif',\n               nir='./CBERS4A_WPM22812420210704/CBERS_4A_WPM_20210704_228_124_L4_BAND4.tif',\n               filename='CBERS4A_WPM22812420210704_TRUE_COLOR.tif',\n               outdir='./STACK')\n\n# Plotando a imagem\nraster = rio.open(\"./STACK/CBERS4A_WPM22812420210704_TRUE_COLOR.tif\")\n\nshow(raster.read(), transform=raster.transform)\n```\n\n## Download da biblioteca com pip\n\n```\npip install cbers4asat\n```\n\nInstala\u00e7\u00e3o com a caixa de ferramentas\n\n```\npip install \"cbers4asat[tools]\"\n```\n\n## Documenta\u00e7\u00e3o\n\nVoc\u00ea pode ler a documenta\u00e7\u00e3o da biblioteca no link abaixo\n\n> https://cbers4asat.readthedocs.io/\n\n## TCC\n\nEsse projeto foi meu objeto de estudo do Trabalho de Conclus\u00e3o de Curso (TCC) no curso de Bacharelado em Ci\u00eancia da Computa\u00e7\u00e3o, voc\u00ea\npode visualizar o PDF neste Link:\n\n[Reposit\u00f3rio Institucional da Universidade Federal de Rond\u00f4nia](https://ri.unir.br/jspui/handle/123456789/4345)\n\n## Contribui\u00e7\u00e3o\n\nConvido qualquer pessoa a participar contribuindo com c\u00f3digo, relatando bugs,\nescrevendo documenta\u00e7\u00e3o, criando tutoriais e discutindo o futuro deste projeto.\n\nPara mais informa\u00e7\u00f5es de como contribuir ao projeto,\nleia [ao manual de contribui\u00e7\u00e3o](https://github.com/gabriel-russo/cbers4asat/blob/master/CONTRIBUTING.md)\n\n## Progresso do projeto\n\nVoc\u00ea pode acompanhar todo o progresso do desenvolvimento\nno [painel de projetos](https://github.com/gabriel-russo/cbers4asat/projects)\n\n# Licen\u00e7a\n\nCopyright (c) 2023 Gabriel Russo\n\nCopyright (c) 2020 Sandro Klippel\n\nO uso \u00e9 fornecido sob a Licen\u00e7a do MIT. Veja\nem [LICENSE](https://github.com/gabriel-russo/cbers4asat/blob/master/LICENSE)\npara mais detalhes.\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2023 Gabriel Russo Copyright (c) 2020 Sandro Klippel  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
    "summary": "Biblioteca Python para realizar a busca e processamento de imagens dos sat\u00e9lites CBERS-04A e AMAZONIA-1",
    "version": "0.7.3",
    "project_urls": {
        "Bug Tracker": "https://github.com/gabriel-russo/cbers4asat/issues",
        "Homepage": "https://cbers4asat.readthedocs.io/pt_BR/latest",
        "Repository": "https://github.com/gabriel-russo/cbers4asat.git"
    },
    "split_keywords": [
        "amazonia-1",
        "cbers",
        "cbers-04a",
        "cbers4a",
        "geoprocessing",
        "remote sensing"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cbfc7bb059c3432a736f4eb6ddce805b84f82c46001a2301f0703f223e40c3bb",
                "md5": "2eec48a195965400692be2a6cdde9fad",
                "sha256": "69d0dbeb03f00dd7b148f8d2a11cb258b828410c8912d9581c0bda869f48ac73"
            },
            "downloads": -1,
            "filename": "cbers4asat-0.7.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2eec48a195965400692be2a6cdde9fad",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 15902,
            "upload_time": "2024-02-20T13:37:58",
            "upload_time_iso_8601": "2024-02-20T13:37:58.257001Z",
            "url": "https://files.pythonhosted.org/packages/cb/fc/7bb059c3432a736f4eb6ddce805b84f82c46001a2301f0703f223e40c3bb/cbers4asat-0.7.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "574a2013bc9f5d6ec34e3cb3b9c823d31b784119e54e62060f780534cc9d8e92",
                "md5": "46be2d9e3856d1c4630e6a4d57e925eb",
                "sha256": "39051d8d152da3ccb840d695e3974e35d5db14becc51a80dda18a0c25ab0b944"
            },
            "downloads": -1,
            "filename": "cbers4asat-0.7.3.tar.gz",
            "has_sig": false,
            "md5_digest": "46be2d9e3856d1c4630e6a4d57e925eb",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 5677327,
            "upload_time": "2024-02-20T13:37:59",
            "upload_time_iso_8601": "2024-02-20T13:37:59.539138Z",
            "url": "https://files.pythonhosted.org/packages/57/4a/2013bc9f5d6ec34e3cb3b9c823d31b784119e54e62060f780534cc9d8e92/cbers4asat-0.7.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-20 13:37:59",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "gabriel-russo",
    "github_project": "cbers4asat",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "cbers4asat"
}
        
Elapsed time: 3.24494s