SICAR

This tool is designed for students, researchers, data scientists, or anyone who would like to have access to SICAR files.

Badges

Features

• Download polygon
• Download state
• Download the entire country
• Tesseract, and PaddleOCR (Optional) drivers to automatically detect captcha

Installation

Install SICAR with pip

bash pip install git+https://github.com/urbanogilson/SICAR

Prerequisite:

Google Tesseract OCR (additional info on how to install the engine on Linux, Mac OSX, and Windows).

Optional: PaddleOCR (additional info on how to install the engine on Linux, Mac OSX, and Windows).

If you don't want to install dependencies on your computer or don't know how to install them, we strongly recommend Google Colab.

Documentation

• SICAR package - API
• SICAR package - What is? Why?
• Data dictionary

Usage/Examples

```python from SICAR import Sicar, State, Polygon import pprint

Create Sicar instance

car = Sicar()

Get release data dates

statedates = car.getreleasedates() pprint.pprint(statedates)

{: '03/06/2025',

: '04/06/2025',

: '03/06/2025',

: '03/06/2025',

: '03/06/2025',

: '04/06/2025',

: '03/06/2025',

: '05/06/2025',

: '04/06/2025',

: '01/06/2025',

: '05/06/2025',

: '08/06/2025',

: '05/06/2025',

: '03/06/2025',

: '05/06/2025',

: '01/06/2025',

: '01/06/2025',

: '03/06/2025',

: '01/06/2025',

: '01/06/2025',

: '01/06/2025',

: '04/06/2025',

: '04/06/2025',

: '01/06/2025',

: '04/06/2025',

: '05/06/2025',

: '04/06/2025'}

Download APPS polygon for the PA state

car.download_state(State.PA, Polygon.APPS) ```

OCR drivers

Optical character recognition (OCR) drivers are used to recognize characters in a captcha.

We currently have two options for automating the download process.

Tesseract OCR (Default)

```python from SICAR import Sicar, State, Polygon from SICAR.drivers import Tesseract

Create Sicar instance using Tesseract OCR

car = Sicar(driver=Tesseract)

Download a state

car.downloadstate(State.SP, Polygon.LEGALRESERVE, folder='SICAR/SP') ```

PaddleOCR

Install SICAR with pip and include Paddle dependencies

bash pip install 'SICAR[paddle] @ git+https://github.com/urbanogilson/SICAR'

```python from SICAR import Sicar, State, Polygon from SICAR.drivers import Paddle

Create Sicar instance using PaddleOCR

car = Sicar(driver=Paddle)

Download a state

car.downloadstate(State.AM, Polygon.CONSOLIDATEDAREA, folder='SICAR/AM') ```

Run with Google Colab

Using Google Colab, you don't need to install the dependencies on your computer and you can save files directly to your Google Drive.

Run with Docker

Pull Image from Docker Hub urbanogilson/sicar

sh docker pull urbanogilson/sicar:latest

Run the downloaded Docker Image using an entry point (file) from your machine (host)

sh docker run -i -v $(pwd):/sicar urbanogilson/sicar:latest -<./examples/docker.py

Note: Update the entry point file ./examples/docker.py or create a new one to download data based on your needs.

or pass a script through STDIN

```sh docker run -i -v $(pwd):/sicar urbanogilson/sicar:latest -<<EOF from SICAR import Sicar, State, Polygon from SICAR.drivers import Paddle

car = Sicar(driver=Paddle)

car.downloadstate(state='MG', polygon=Polygon.CONSOLIDATEDAREA, folder='MG') EOF ```

Note: Using $(pwd) the container will save the download data into the current folder.

Optional: Make an external directory to store the downloaded data and use a volume parameter in the run command to point to it.

Data dictionary

| Attribute | Description | |---------------|--------------------------------------------------------------| | codestado | Unit of the Federation in which the registration is located. | | municipio | Municipality in which the registration is located. | | numarea | Gross area of the rural property or the subject that makes up the registry, in hectare. | | codimovel | Registration number in the Rural Environmental Registry (CAR). | | indstatus | Status of registration in CAR, according to Normative Instruction no. 2, of May 6, 2014, of the Ministry of the Environment (https://www.car.gov.br/leis/INCAR.pdf), and the Resolution No. 3, of August 27, 2018, of the Brazilian Forest Service (https://imprensanacional.gov.br/materia/-/assetpublisher/Kujrw0TZC2Mb/content/id/38537086/do1-2018-08-28-resolucao-n-3-de-27-de-agos-de-2018-38536774), being AT - Active; PE - Pending; SU - Suspended; and CA - Cancelled. | | descondic | Condition in which the registration is in the analysis flow by the competent body. | | indtipo | Type of Rural Property, being IRU - Rural Property; AST - Agrarian Reform Settlements; PCT - Traditional Territory of Traditional Peoples and Communities. | | modfiscal | Number of rural property tax modules. | | nomtema | Name of the theme that makes up the registration (Permanent Preservation Area, Path, Remnant of Native Vegetation, Restricted Use Area, Administrative Easement, Legal Reserve, Hydrography, Wetlands, Consolidated Rural Area, Areas with Altitude Higher than 1800 meters, Areas with Slopes Higher than 45 degrees, Hilltops, Plateau Edges, Fallow Areas, Mangroves and Restinga). |

Acknowledgements

• Sicar - Sistema Nacional de Cadastro Ambiental Rural
• Sicar - Base de Downloads

Roadmap

• [ ] Upload to pypi registry

Contributing

The development environment with all necessary packages is available using Visual Studio Code Dev Containers.

Contributions are always welcome!

Feedback

If you have any feedback, please reach me at hello@gilsonurbano.com

License

MIT