semvec/pypi-packages huggingface dataset:
cellseg-gsontools 0.1.8
Toolbelt for merging and extracting features from geojson masks.
Requires Python: <4.0,>=3.10

<div align="center">

# cellseg_gsontools

[![Github Test](https://img.shields.io/github/actions/workflow/status/okunator/cellseg_gsontools/tests.yml?label=tests)](https://github.com/okunator/cellseg_models.pytorch/actions/workflows/tests.yml) [![Generic badge](https://img.shields.io/github/license/okunator/cellseg_gsontools)](https://github.com/okunator/cellseg_gsontools/blob/master/LICENSE) [![Python - Version](https://img.shields.io/pypi/pyversions/cellseg_gsontools)](https://www.python.org/) [![Package - Version](https://img.shields.io/pypi/v/cellseg_gsontools)](https://pypi.org/project/cellseg-gsontools/)
[![DOI](https://zenodo.org/badge/554131853.svg)](https://zenodo.org/doi/10.5281/zenodo.10617987)



Tools for feature extraction in cell and tissue segmentation maps.

Checkout the [documentation](https://okunator.github.io/cellseg_gsontools/) for tutorials.

</div>

## Introduction

**Cellseg_gsontools** is a Python toolset designed to analyze and summarize large cell and tissue segmentation maps created from Whole Slide Images (WSI). The library is built on top of [`geopandas`](https://geopandas.org/en/stable/index.html) and [`libpysal`](https://pysal.org/libpysal/). In other words, the library can process **geospatial** data with **GeoJSON**-interface.


<p align="center">

<img src="./docs/img/index.png"/>

</p>

**NOTE**: The library is synergetic with the [cellseg_models.pytorch](https://github.com/okunator/cellseg_models.pytorch) segmentation library which enables you to segment your WSI into `GeoJSON` format.

**Another NOTE**: The library expects that the cell type labels are in a field named `class_name` in your `geojson`. If not, you should rename that field to `class_name`.

## Installation

``` shell
pip install cellseg-gsontools
```

## Citation

```bibtex
@misc{cellseg_gsontools2023,
    title={{cellseg_gsontools}: Tools for feature extraction in cell and tissue segmentation maps.},
    author={Oskari Lehtonen},
    howpublished = {\url{https://github.com/okunator/cellseg_gsontools}},
    doi={https://zenodo.org/doi/10.5281/zenodo.10617987},
    year={2023}
}
```

## Contribute

Any suggestions, feature requests, or bug reports are welcome! Please open a new issue on GitHub for those. If you want to contribute to the codebase, please open a pull request.

## Licence

This project is distributed under [MIT License](https://github.com/okunator/cellseg_models.pytorch/blob/main/LICENSE)

If you find this library useful in your project, it is your responsibility to ensure you comply with the conditions of any dependent licenses. Please create an issue if you think something is missing regarding the licenses.