Name | geodense JSON |
Version |
1.0.0
JSON |
| download |
home_page | |
Summary | Python library and CLI tool to check density and densify (GeoJSON) geometries using the geodesic (ellipsoidal great-circle) calculation for accurate CRS transformations |
upload_time | 2024-02-09 08:57:20 |
maintainer | |
docs_url | None |
author | |
requires_python | >=3.11 |
license | MIT |
keywords |
coordinate reference system
crs
densify
geodesic
geojson
great-circle
nsgi
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# geodense
[![Code
Coverage](https://img.shields.io/endpoint?url=https%3A%2F%2Fgeodetischeinfrastructuur.github.io%2Fgeodense%2Fbadge.json&style=flat-square&logo=pytest&logoColor=white)](https://geodetischeinfrastructuur.github.io/geodense/)
[![Python
3.11+](https://img.shields.io/badge/python-3.11+-teal.svg?style=flat-square)](https://www.python.org/downloads/release/python-3116/)
![License:
MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)
[![PyPI
Version](https://img.shields.io/pypi/v/geodense.svg?style=flat-square)](https://pypi.python.org/pypi/geodense)
Python library and CLI tool to **check density** and **densify** geometries
using the geodesic (ellipsoidal great-circle) calculation for accurate CRS
transformations.
Implementation based on [*Eenduidige transformatie van grenzen tussen ETRS89 en
RD*](https://gnss-data.kadaster.nl/misc/docs/langelijnenadvies.pdf)
Requires Python v3.11 or higher.
Depends on:
- `pyproj ~= 3.6.0` -> [requires PROJ
9+](https://pyproj4.github.io/pyproj/stable/installation.html#installing-from-source)
- `shapely ~= 2.0.2` -> [requires GEOS >=
3.5](https://shapely.readthedocs.io/en/stable/index.html#requirements)
## Usage CLI
Use either `geodense` or the short `gden` alias:
```txt
$ geodense --help
Usage: geodense [-h] [-v] {densify,check-density} ...
Check density of, and densify geometries using the geodesic (ellipsoidal great-circle) calculation for accurate CRS transformations
Commands:
{densify,check-density}
Options:
-h, --help show this help message and exit
-v, --version show program's version number and exit
Created by https://www.nsgi.nl/
```
## Usage Docs
See
[`DOCS.md`](https://github.com/GeodetischeInfrastructuur/geodense/blob/main/DOCS.md)
for usage docs; for now only containing flow-charts of the `densify` and
`check-densify` subcommands.
## Contributing
Issues (bugs/feature requests) can be reported in the [issue tracker of this
repository](https://github.com/GeodetischeInfrastructuur/geodense/issues). Pull
requests are more than welcome, but we encourage to start a discussion on the
issue tracker first.
## Development
Install/uninstall geodense for development, including dev dependencies (run from
root of repository):
```sh
pip install -e ".[dev]"
pip uninstall geodense
```
### Tests
Run tests:
```sh
python3 -m pytest tests/
```
Check test coverage:
```sh
python3 -m coverage run -p --source=src/geodense -m pytest -v tests && python3 -m coverage report --data-file $(ls -t .coverage.* | head -1)
```
### Create release
Creating a release requires the `build` and `twine` packages, which are part of
this package's `dev` dependencies. To create a release follow these steps:
To release a new version create a new git tag and push the new tag with
```sh
git tag -a x.x.x -m "tagging x.x.x release"
git push --tags
```
Create a new build with:
```sh
rm -rf dist/* # clean dist folder before build
python -m build
```
Check wheel contains expected files:
```sh
unzip dist/geodense-0.0.1a3-py3-none-any.whl -d geodense-whl
tree geodense-whl
rm -rf geodense-whl
```
Check whether package description will render properly on PyPI:
```sh
twine check dist/*
```
Upload release to pypi:
```sh
twine upload -r testpypi dist/*
```
> **Note:** requires
> [`~/.pypirc`](https://packaging.python.org/en/latest/specifications/pypirc/)
> file with API token (when 2FA is enabled on PyPi).
Raw data
{
"_id": null,
"home_page": "",
"name": "geodense",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "",
"keywords": "coordinate reference system,CRS,densify,geodesic,geojson,great-circle,NSGI",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/3d/ef/707671318cc467359e6d66f554edb10d11705d4458a3fa9b799512ef8881/geodense-1.0.0.tar.gz",
"platform": null,
"description": "# geodense\n\n[![Code\nCoverage](https://img.shields.io/endpoint?url=https%3A%2F%2Fgeodetischeinfrastructuur.github.io%2Fgeodense%2Fbadge.json&style=flat-square&logo=pytest&logoColor=white)](https://geodetischeinfrastructuur.github.io/geodense/)\n[![Python\n3.11+](https://img.shields.io/badge/python-3.11+-teal.svg?style=flat-square)](https://www.python.org/downloads/release/python-3116/)\n![License:\nMIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)\n[![PyPI\nVersion](https://img.shields.io/pypi/v/geodense.svg?style=flat-square)](https://pypi.python.org/pypi/geodense)\n\nPython library and CLI tool to **check density** and **densify** geometries\nusing the geodesic (ellipsoidal great-circle) calculation for accurate CRS\ntransformations.\n\nImplementation based on [*Eenduidige transformatie van grenzen tussen ETRS89 en\nRD*](https://gnss-data.kadaster.nl/misc/docs/langelijnenadvies.pdf)\n\nRequires Python v3.11 or higher.\n\nDepends on:\n\n- `pyproj ~= 3.6.0` -> [requires PROJ\n 9+](https://pyproj4.github.io/pyproj/stable/installation.html#installing-from-source)\n- `shapely ~= 2.0.2` -> [requires GEOS >=\n 3.5](https://shapely.readthedocs.io/en/stable/index.html#requirements)\n\n## Usage CLI\n\nUse either `geodense` or the short `gden` alias:\n\n```txt\n$ geodense --help\n\nUsage: geodense [-h] [-v] {densify,check-density} ...\n\nCheck density of, and densify geometries using the geodesic (ellipsoidal great-circle) calculation for accurate CRS transformations\n\nCommands:\n {densify,check-density}\n\nOptions:\n -h, --help show this help message and exit\n -v, --version show program's version number and exit\n\nCreated by https://www.nsgi.nl/\n```\n\n## Usage Docs\n\nSee\n[`DOCS.md`](https://github.com/GeodetischeInfrastructuur/geodense/blob/main/DOCS.md)\nfor usage docs; for now only containing flow-charts of the `densify` and\n`check-densify` subcommands.\n\n## Contributing\n\nIssues (bugs/feature requests) can be reported in the [issue tracker of this\nrepository](https://github.com/GeodetischeInfrastructuur/geodense/issues). Pull\nrequests are more than welcome, but we encourage to start a discussion on the\nissue tracker first.\n\n## Development\n\nInstall/uninstall geodense for development, including dev dependencies (run from\nroot of repository):\n\n```sh\npip install -e \".[dev]\"\npip uninstall geodense\n```\n\n### Tests\n\nRun tests:\n\n```sh\npython3 -m pytest tests/\n```\n\nCheck test coverage:\n\n```sh\npython3 -m coverage run -p --source=src/geodense -m pytest -v tests && python3 -m coverage report --data-file $(ls -t .coverage.* | head -1)\n```\n\n### Create release\n\nCreating a release requires the `build` and `twine` packages, which are part of\nthis package's `dev` dependencies. To create a release follow these steps:\n\nTo release a new version create a new git tag and push the new tag with\n\n```sh\ngit tag -a x.x.x -m \"tagging x.x.x release\"\ngit push --tags\n```\n\nCreate a new build with:\n\n```sh\nrm -rf dist/* # clean dist folder before build\npython -m build\n```\n\nCheck wheel contains expected files:\n\n```sh\nunzip dist/geodense-0.0.1a3-py3-none-any.whl -d geodense-whl\ntree geodense-whl\nrm -rf geodense-whl\n```\n\nCheck whether package description will render properly on PyPI:\n\n```sh\ntwine check dist/*\n```\n\nUpload release to pypi:\n\n```sh\ntwine upload -r testpypi dist/*\n```\n\n> **Note:** requires\n> [`~/.pypirc`](https://packaging.python.org/en/latest/specifications/pypirc/)\n> file with API token (when 2FA is enabled on PyPi).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python library and CLI tool to check density and densify (GeoJSON) geometries using the geodesic (ellipsoidal great-circle) calculation for accurate CRS transformations",
"version": "1.0.0",
"project_urls": {
"repository": "https://github.com/GeodetischeInfrastructuur/geodense"
},
"split_keywords": [
"coordinate reference system",
"crs",
"densify",
"geodesic",
"geojson",
"great-circle",
"nsgi"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2af79d12678aee787d451d118f65210f61d54fceeca17f0acf9d870345ea781a",
"md5": "30637fc98de26eeaaff2702eeb96a981",
"sha256": "f5b6e0c32daf539f8d518a2827c9c18bc5b67d7331e59638f1f684ac826cc046"
},
"downloads": -1,
"filename": "geodense-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "30637fc98de26eeaaff2702eeb96a981",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 16549,
"upload_time": "2024-02-09T08:57:18",
"upload_time_iso_8601": "2024-02-09T08:57:18.658955Z",
"url": "https://files.pythonhosted.org/packages/2a/f7/9d12678aee787d451d118f65210f61d54fceeca17f0acf9d870345ea781a/geodense-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3def707671318cc467359e6d66f554edb10d11705d4458a3fa9b799512ef8881",
"md5": "b695de34091b6d3ac8f909ce8c85016d",
"sha256": "8c0905bf33fecf92eafd0b306636881ff9527abdae6eaf5f3e8501212c6db01e"
},
"downloads": -1,
"filename": "geodense-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "b695de34091b6d3ac8f909ce8c85016d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 943971,
"upload_time": "2024-02-09T08:57:20",
"upload_time_iso_8601": "2024-02-09T08:57:20.420759Z",
"url": "https://files.pythonhosted.org/packages/3d/ef/707671318cc467359e6d66f554edb10d11705d4458a3fa9b799512ef8881/geodense-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-09 08:57:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GeodetischeInfrastructuur",
"github_project": "geodense",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "geodense"
}