Please cite the software if you are using it in your scientific publication.
Toolkit for handling point clouds created using airborne laser scanning (ALS). Find neighboring points in your point cloud and describe them as feature values. Read our user manual and our (very modest) tutorial.
Installation
Prerequisites:
- Python 3.10 or higher
- pip
pip install laserchicken
Necessary steps for making a new release
- Set new version number in the following files:
laserchicken/__version__.pypyproject.tomlCITATION.cff
- Create .zenodo.json file from CITATION.cff (using cffconvert)
cffconvert --validatecffconvert --format zenodo --outfile .zenodo.json - Check that documentation uses the correct version
- Edit Changelog (based on commits in https://github.com/eecolidar/laserchicken/compare/v0.3.2...master)
- Test if package can be installed with pip (
pip install .) - Create Github release (release to PyPI is implemented via GitHub Actions)
- Check doi on zenodo
Feature testing
All features were tested for the following general conditions:
- Output consistent point clouds and don't crash with artificial data, real data, all zero data (x, y or z), data without points, data with very low number of neighbors (0, 1, 2)
- Input should not be changed by the feature extractor
The specific features were tested as follows.
Echo ratio
A test was written with artificial data to check the correctness of the calculation with manually calculated ratio. Also tested on real data to make sure it doesn't crash, without checking for correctness. We could add a test for correctness with real data but we would need both that data and a verified ground truth.
Eigenvalues
Only sanity tests (l1>l2>l3) on real data and corner cases but no actual test for correctness. The code is very simple though and mainly calls numpy.linalg.eig.
Height statistics (max_z','min_z','mean_z','median_z','std_z','var_z','coeff_var_z','skew_z','kurto_z)
Tested on real data for correctness. It is however unclear where the ground truths come from. Code is mainly calling numpy methods that do all the work already. Only calculations in our code are:
range_z = max_z - min_z
coeff_var_z = np.std(z) / np.mean(z)
I don't know about any packages that could provide an out of the box coefficient of variance. This is probably because the calculation is so simple.
Pulse penetration ratio
Tested for correctness using artificial data against manually calculated values. No comparison was made with other implementations.
Sigma_z
Tested for correctness using artificial data against manually calculated values. No comparison was made with other implementations.
Percentiles
Tested for correctness using a simple case with artificial data against manually calculated values.
point_density
Tested for correctness on artificial data.
Metadata
Release files for laserchicken 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| laserchicken-0.8.1.tar.gz | 62.5 kB | Without provenance | Details for laserchicken-0.8.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| laserchicken-0.8.1-py3-none-any.whl | Python 3 | none | any | Details for laserchicken-0.8.1-py3-none-any.whl |
Total release size: 156.6 kB
Release files / laserchicken-0.8.1.tar.gz
| Download URL | laserchicken-0.8.1.tar.gz |
|---|---|
| Size | 62.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
df5651052bc396f46e2efc3e1068fded655d263c605be2fa5c8b8b9e93b4d410
|
|
BLAKE2b-256 checksum How to use checksums |
e15395080e1de3408812f92c33daa90b83cde2f332809b1b01dda5b9c9918776
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / laserchicken-0.8.1-py3-none-any.whl
| Download URL | laserchicken-0.8.1-py3-none-any.whl |
|---|---|
| Size | 94.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
08542ed33d84fd7aeea416c237dd093842b04e4b84374a09fd3600f4f8927a69
|
|
BLAKE2b-256 checksum How to use checksums |
fb9e1afe18c1ad1a014fd852ef0cebd93b04df76fa55404b56cf5f93ad42a31e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for laserchicken 0.8.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.