Metadata-Version: 2.1
Name: geomob
Version: 0.0.2
Summary: Geospatial and mobility data library
Home-page: https://github.com/lwdovico/geomob
Author: Ludovico Lemma
Author-email: ludovico.lemma@mindearth.ch
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: geopandas==0.14.4
Requires-Dist: h3==3.7.7
Requires-Dist: haversine==2.8.1
Requires-Dist: keplergl==0.3.2
Requires-Dist: numpy==2.0.0
Requires-Dist: pandas==2.2.2
Requires-Dist: Pytess==1.0.0
Requires-Dist: requests==2.32.3
Requires-Dist: shapely==2.0.4

# GEOMOB

Welcome to **GEOMOB**, a lightweight library designed to facilitate working with geospatial data. At the moment this library provides essential tools for preprocessing and tessellating geospatial mobility data, making it an excellent choice for developers and researchers in the field of geographic information systems (GIS). I am planning to add many more features. Stay tuned!

## Features

### Current functionalities

1. **Preprocess Module**
   - Convert input GeoJSON formats into Shapely Geometries.
   - A lightweight improved version of a stop detection algorithm (2004, Ramaswamy, H., Toyama, K.).
   - A location function to rank users locations during a time window based on different criterions.

2. **Tessellation Module**
   - Module to discretize the space of a shape.
   - Support for multiple tessellation techniques (e.g., Squared, H3, Voronoi, etc.)
   - Function to simplify complex polygons into a complex of triangles
   - Efficient function to compute a random set of points in a polygon (useful for synthetic data generation, to randomized Voronoi tessellation etc.)

## Installation

To install GEOMOB, you can use pip:

```sh
pip install geomob
```

## Contributing

I welcome contributions from the community. If you would like to contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Commit your changes and push your branch to your fork.
4. Submit a pull request to our main repository.

Please ensure all contributions adhere to our coding standards and include appropriate tests.

## License

GEOMOB is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.

## Contact

If you have any questions or need further assistance, feel free to open an issue on GitHub or contact me at lwdovico@protonmail.com

Happy Mapping!
