| Name | ahn-cli JSON |
| Version |
0.2.1
JSON |
| download |
| home_page | None |
| Summary | None |
| upload_time | 2024-05-04 14:17:48 |
| maintainer | None |
| docs_url | None |
| author | HideBa |
| requires_python | <3.12,>=3.9 |
| license | MIT |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# AHN CLI
[](https://opensource.org/licenses/MIT)
[](https://github.com/HideBa/ahn-cli/releases/tag/v0.2.1)
[](https://github.com/HideBa/ahn-cli/actions)
## Description
AHN CLI is a command-line interface tool designed for the effortless downloading of AHN (Actueel Hoogtebestand Nederland) point cloud data for specific cities and classification classes.
## Installation
Install AHN CLI using pip:
```
pip install ahn_cli
```
## Usage
To utilize the AHN CLI, execute the following command with the appropriate options:
```shell
Options:
-c, --city <city_name> Download point cloud data for the specified city.
-o, --output <file> Designate the output file for the downloaded data.
-i, --include-class <class> Include specific point cloud classes in the download,
specified in a comma-separated list. Available classes:
0:Created, never classified; 1:Unclassified; 2:Ground;
6:Building; 9:Water; 14:High tension; 26:Civil structure.
-e, --exclude-class <class> Exclude specific point cloud classes from the download,
specified in a comma-separated list. Available classes as above.
-d, --decimate <step> Decimate the point cloud data by the specified step.
-ncc, --no-clip-city Avoid clipping the point cloud data to the city boundary.
-cf, --clip-file <file> Provide a file path for a clipping boundary file to clip
the point cloud data to a specified area.
-e, --epsg <epsg> Set the EPSG code for user's clip file.
-b, --bbox <bbox> Specify a bounding box to clip the point cloud data. It should be comma-separated list with minx,miny,maxx,maxy
centered on the city polygon.
-p, --preview Preview the point cloud data in a 3D viewer.
-h, --help [category] Show help information. Optionally specify a category for
detailed help on a specific command.
-v, --version Display the version number of the AHN CLI and exit.
```
### Usage Examples
**Download Point Cloud Data for Delft with All Classification Classes:**
```
ahn_cli -c delft -o ./delft.laz
```
**To Include or Exclude Specific Classes:**
```
ahn_cli -c delft -o ./delft.laz -i 1,2
```
**For Non-Clipped, Rectangular-Shaped Data:**
```
ahn_cli -c delft -o ./delft.laz -i 1,2 -ncc
```
**To Decimate City-Scale Point Cloud Data:**
```
ahn_cli -c delft -o ./delft.laz -i 1,2 -d 2
```
**Specify a Bounding box for clipping:**
If you specify a `b`, it will clip the point cloud data with specified bounding box.
```
ahn_cli -o ./delft.laz -i 1,2 -b 194198.0,443461.0,194594.0,443694.0
```
## Reporting Issues
Encountering issues or bugs? We greatly appreciate your feedback. Please report any problems by opening an issue on our GitHub repository. Be as detailed as possible in your report, including steps to reproduce the issue, the expected outcome, and the actual result. This information will help us address and resolve the issue more efficiently.
## Contributing
Your contributions are welcome! If you're looking to contribute to the AHN CLI project, please first review our Contribution Guidelines. Whether it's fixing bugs, adding new features, or improving documentation, we value your help.
To get started:
- Fork the repository on GitHub.
- Clone your forked repository to your local machine.
- Create a new branch for your contribution.
- Make your changes and commit them with clear, descriptive messages.
Push your changes to your fork.
- Submit a pull request to our repository, providing details about your changes and the value they add to the project.
- We look forward to reviewing your contributions and potentially merging them into the project!
Raw data
{
"_id": null,
"home_page": null,
"name": "ahn-cli",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "HideBa",
"author_email": "baba.papa1120.ba@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/fa/5b/4cce49072dcb72b95dd414b956ea24791ff2ffad6b049a9154ece2f24bff/ahn_cli-0.2.1.tar.gz",
"platform": null,
"description": "# AHN CLI\n\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/HideBa/ahn-cli/releases/tag/v0.2.1)\n[](https://github.com/HideBa/ahn-cli/actions)\n\n## Description\n\nAHN CLI is a command-line interface tool designed for the effortless downloading of AHN (Actueel Hoogtebestand Nederland) point cloud data for specific cities and classification classes.\n\n## Installation\n\nInstall AHN CLI using pip:\n\n```\npip install ahn_cli\n```\n\n## Usage\n\nTo utilize the AHN CLI, execute the following command with the appropriate options:\n\n```shell\nOptions:\n -c, --city <city_name> Download point cloud data for the specified city.\n -o, --output <file> Designate the output file for the downloaded data.\n -i, --include-class <class> Include specific point cloud classes in the download,\n specified in a comma-separated list. Available classes:\n 0:Created, never classified; 1:Unclassified; 2:Ground;\n 6:Building; 9:Water; 14:High tension; 26:Civil structure.\n -e, --exclude-class <class> Exclude specific point cloud classes from the download,\n specified in a comma-separated list. Available classes as above.\n -d, --decimate <step> Decimate the point cloud data by the specified step.\n -ncc, --no-clip-city Avoid clipping the point cloud data to the city boundary.\n -cf, --clip-file <file> Provide a file path for a clipping boundary file to clip\n the point cloud data to a specified area.\n -e, --epsg <epsg> Set the EPSG code for user's clip file.\n -b, --bbox <bbox> Specify a bounding box to clip the point cloud data. It should be comma-separated list with minx,miny,maxx,maxy\n centered on the city polygon.\n -p, --preview Preview the point cloud data in a 3D viewer.\n -h, --help [category] Show help information. Optionally specify a category for\n detailed help on a specific command.\n -v, --version Display the version number of the AHN CLI and exit.\n```\n\n### Usage Examples\n\n**Download Point Cloud Data for Delft with All Classification Classes:**\n\n```\nahn_cli -c delft -o ./delft.laz\n```\n\n**To Include or Exclude Specific Classes:**\n\n```\nahn_cli -c delft -o ./delft.laz -i 1,2\n```\n\n**For Non-Clipped, Rectangular-Shaped Data:**\n\n```\nahn_cli -c delft -o ./delft.laz -i 1,2 -ncc\n```\n\n**To Decimate City-Scale Point Cloud Data:**\n\n```\nahn_cli -c delft -o ./delft.laz -i 1,2 -d 2\n```\n\n**Specify a Bounding box for clipping:**\n\nIf you specify a `b`, it will clip the point cloud data with specified bounding box.\n```\nahn_cli -o ./delft.laz -i 1,2 -b 194198.0,443461.0,194594.0,443694.0\n```\n\n\n## Reporting Issues\n\nEncountering issues or bugs? We greatly appreciate your feedback. Please report any problems by opening an issue on our GitHub repository. Be as detailed as possible in your report, including steps to reproduce the issue, the expected outcome, and the actual result. This information will help us address and resolve the issue more efficiently.\n\n## Contributing\n\nYour contributions are welcome! If you're looking to contribute to the AHN CLI project, please first review our Contribution Guidelines. Whether it's fixing bugs, adding new features, or improving documentation, we value your help.\n\nTo get started:\n\n- Fork the repository on GitHub.\n- Clone your forked repository to your local machine.\n- Create a new branch for your contribution.\n- Make your changes and commit them with clear, descriptive messages.\n Push your changes to your fork.\n- Submit a pull request to our repository, providing details about your changes and the value they add to the project.\n- We look forward to reviewing your contributions and potentially merging them into the project!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": null,
"version": "0.2.1",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7c57289019ef16af19b36da4252b8962e8056a2b5056a3a577e558e387d464a0",
"md5": "214f55593097d8e5b65116c55e4c3d65",
"sha256": "c5fb69309ab0af0ea07acc0810667d6786baab1f6c2adb3d0d2910d2aca767db"
},
"downloads": -1,
"filename": "ahn_cli-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "214f55593097d8e5b65116c55e4c3d65",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.9",
"size": 14374371,
"upload_time": "2024-05-04T14:17:40",
"upload_time_iso_8601": "2024-05-04T14:17:40.732536Z",
"url": "https://files.pythonhosted.org/packages/7c/57/289019ef16af19b36da4252b8962e8056a2b5056a3a577e558e387d464a0/ahn_cli-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fa5b4cce49072dcb72b95dd414b956ea24791ff2ffad6b049a9154ece2f24bff",
"md5": "446e97075b0f60526eb6880243ee80a5",
"sha256": "bfd6df3609961e4a7cc7fcdbd8148d100939b2e3a49bd97322b6c1888d800c6c"
},
"downloads": -1,
"filename": "ahn_cli-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "446e97075b0f60526eb6880243ee80a5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.9",
"size": 14367088,
"upload_time": "2024-05-04T14:17:48",
"upload_time_iso_8601": "2024-05-04T14:17:48.627912Z",
"url": "https://files.pythonhosted.org/packages/fa/5b/4cce49072dcb72b95dd414b956ea24791ff2ffad6b049a9154ece2f24bff/ahn_cli-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-04 14:17:48",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "ahn-cli"
}
