Metadata-Version: 2.4
Name: geociencias-cli
Version: 0.2
Summary: toolkit de ferramentas relacionadas a geociências
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: folium>=0.20.0
Requires-Dist: pandas>=3.0.2
Requires-Dist: pyproj>=3.7.2
Requires-Dist: pytest>=9.0.3
Requires-Dist: rich>=15.0.0
Requires-Dist: ruff>=0.15.11
Requires-Dist: typer>=0.24.1

# geo-cli

toolkit de ferramentas relacionadas a geociências construídas por mim

**Usage**:

```console
$ geo-cli [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `geo2utm`: converte coordenadas geográficas...
* `utm2geo`: converte coordenadas UTM (EPSG:31983 como...
* `map`: gera um mapa interativo a partir de...
* `mineralformula`: constroe a tabela de formula mineral com...
* `escala`: calcula a distância real correspondente a...
* `indicecor`: calcula o índice de cor de uma rocha com...
* `mergulho`: determina a espessura real de um...
* `idaderocha`: determina a idade de uma rocha com base na...
* `atitude`: converte uma atitude no formato...

## `geo-cli geo2utm`

converte coordenadas geográficas (EPSG:4326 como padrão) para UTM (EPSG:31983 como padrão).

**Usage**:

```console
$ geo-cli geo2utm [OPTIONS] INPUT_FILE OUTPUT_FILE
```

**Arguments**:

* `INPUT_FILE`: caminho para o arquivo CSV de entrada (deve conter as colunas &quot;lat&quot; e &quot;lon&quot;)  [required]
* `OUTPUT_FILE`: caminho onde o CSV final com os dados convertidos será salvo  [required]

**Options**:

* `--source-epsg TEXT`: EPSG code for source coordinate system  [default: EPSG:4326]
* `--target-epsg TEXT`: EPSG code for target coordinate system  [default: EPSG:31983]
* `--help`: Show this message and exit.

## `geo-cli utm2geo`

converte coordenadas UTM (EPSG:31983 como padrão) para geográficas (EPSG:4326 como padrão).

**Usage**:

```console
$ geo-cli utm2geo [OPTIONS] INPUT_FILE OUTPUT_FILE
```

**Arguments**:

* `INPUT_FILE`: caminho para o arquivo CSV de entrada (deve conter as colunas &quot;easting&quot; e &quot;northing&quot;)  [required]
* `OUTPUT_FILE`: caminho onde o CSV final com os dados convertidos será salvo  [required]

**Options**:

* `--source-epsg TEXT`: EPSG code for source coordinate system  [default: EPSG:31983]
* `--target-epsg TEXT`: EPSG code for target coordinate system  [default: EPSG:4326]
* `--help`: Show this message and exit.

## `geo-cli map`

gera um mapa interativo a partir de coordenadas em um arquivo CSV.

**Usage**:

```console
$ geo-cli map [OPTIONS] INPUT_FILE [TITLE] [ID]
```

**Arguments**:

* `INPUT_FILE`: caminho para o arquivo CSV de entrada  [required]
* `[TITLE]`: título do mapa  [default: Mapa]
* `[ID]`: nome da coluna a ser usada como identificador dos pontos no mapa (opcional)

**Options**:

* `--zoom-start INTEGER`: nível de zoom inicial do mapa  [default: 2]
* `--help`: Show this message and exit.

## `geo-cli mineralformula`

constroe a tabela de formula mineral com base em um arquivo CSV contendo as colunas das moléculas e suas respectivas análises quimicas.

**Usage**:

```console
$ geo-cli mineralformula [OPTIONS] INPUT_FILE OUTPUT_FILE
```

**Arguments**:

* `INPUT_FILE`: caminho para o arquivo CSV de entrada  [required]
* `OUTPUT_FILE`: caminho onde o CSV final com a tabela de fórmulas minerais será salvo  [required]

**Options**:

* `--help`: Show this message and exit.

## `geo-cli escala`

calcula a distância real correspondente a uma medida feita em uma carta, com base na escala fornecida.

**Usage**:

```console
$ geo-cli escala [OPTIONS] ESCALA DISTANCIA_CARTA
```

**Arguments**:

* `ESCALA`: escala cartográfica  [required]
* `DISTANCIA_CARTA`: distância medida na carta (em cm)  [required]

**Options**:

* `--help`: Show this message and exit.

## `geo-cli indicecor`

calcula o índice de cor de uma rocha com base na proporção de minerais escuros (m) presente nela.

**Usage**:

```console
$ geo-cli indicecor [OPTIONS]
```

**Options**:

* `-o, --olivina FLOAT`: Porcentagem visual de Olivina  [default: 0.0]
* `-p, --piroxenio FLOAT`: Porcentagem visual de Piroxênio  [default: 0.0]
* `-b, --biotita FLOAT`: Porcentagem visual de Biotita  [default: 0.0]
* `-a, --anfibolio FLOAT`: Porcentagem visual de Anfibólio  [default: 0.0]
* `--opacos FLOAT`: Percentagem de minerais metálicos/opacos (Magnetite, Ilmenite)  [default: 0.0]
* `--outros FLOAT`: Outros minerais ferromagnesianos (Granada, Turmalina, etc.)  [default: 0.0]
* `--help`: Show this message and exit.

## `geo-cli mergulho`

determina a espessura real de um afloramento com base no comprimento na superfície e no seu ângulo de mergulho.

**Usage**:

```console
$ geo-cli mergulho [OPTIONS] LENGTH ANGLE
```

**Arguments**:

* `LENGTH`: comprimento do afloramento na superfície  [required]
* `ANGLE`: ângulo de mergulho do afloramento  [required]

**Options**:

* `--help`: Show this message and exit.

## `geo-cli idaderocha`

determina a idade de uma rocha com base na quantidade do isótopo pai e filho presentes nela, e na meia-vida do isótopo pai.

**Usage**:

```console
$ geo-cli idaderocha [OPTIONS]
```

**Options**:

* `-p, --pai FLOAT`: quantidade do isótopo pai  [required]
* `-f, --filho FLOAT`: quantidade do isótopo filho  [required]
* `-mv, --meia-vida FLOAT`: meia-vida do isótopo pai  [required]
* `--help`: Show this message and exit.

## `geo-cli atitude`

converte uma atitude no formato Rumo/Mergulho/Quadrante para o formato internacional Dip Direction/Dip (strike-dip).

**Usage**:

```console
$ geo-cli atitude [OPTIONS] RMQ
```

**Arguments**:

* `RMQ`: atitude no formato Rumo/Mergulho/Quadrante  [required]

**Options**:

* `--help`: Show this message and exit.
