An open API service indexing awesome lists of open source software.

https://github.com/mggg/gdutils

A collection of geodata utility tools.
https://github.com/mggg/gdutils

geodata python

Last synced: 7 months ago
JSON representation

A collection of geodata utility tools.

Awesome Lists containing this project

README

          

# gdutils
[![Documentation Status](https://readthedocs.org/projects/gdutils/badge/?version=latest)](https://gdutils.readthedocs.io/en/latest/?badge=latest)

A collection of geodata utility tools.

Available modules:

- `gdutils.datamine`: a `python` module for mining and listing data sources.
- `gdutils.dataqa`: a `python` module for comparing analyzing and comparing
data for QA purposes.
- `gdutils.extract`: a script and `python` module for extracting tabular
data for data science (data wrangling) purposes. A user-friendly, lite
wrapper of `geopandas` with the power of `pandas`.

## Requirements
- Python3
- pip3

## Installation
```bash
$ pip3 install git+https://github.com/mggg/gdutils.git
```

To uninstall, run `pip3 uninstall gdutils`.

*Troubleshooting:* If installation problems, it may be due to issues with
`geopandas`' dependencies. Please see [installing `geopandas`](https://geopandas.org/install.html) for more details.

## Development
To install manually:

```bash
$ git clone https://github.com/mggg/gdutils.git
$ cd gdutils
$ python3 -m venv venv # we recommend using a virtual environment
$ source venv/bin/activate
$ make install
$ make clean
```

To run automated tests, run `pytest`.

To uninstall, run `pip3 uninstall gdutils`.

## Documentation
Documentation can be found on [Read the Docs](https://gdutils.readthedocs.io/).
Additionally, documentation for modules can be found using the `python`
`help()` function, e.g. `import gdutils.datamine; help(gdutils.datamine)`.