Coordinates label photos
The problem we are trying to solve: On the one hand, we have a photos with unlabeled GPS data, but only a timestamp. In the other hand, we have a GPS track, with coordinates and timestamp. This situation is originally caused by the fact that pictures are taken underwater but we can position a GPS above the water. Our purpose is to interpolate the GPS position from the track, with the photo timestamp and insert the information in the EXIF photo metadata.
Installation
pip install coordinates-label-photos
Run
To label all images from /path/to/images-directory/* with the GPX track points from path/to/your.gpx or LLH (Reach RS 2) format:
coordinates-label-photos --coords=/path/to/your.gpx --images=/path/to/images-directory
Try coordinates-label-photos --help to see how to save image locations in a separate file, output reports, set accuracy and more.
Other Utils
A few side tools may come handy in some situations
Removing GPS information from pictures
coordinates-clear-photos --images=/path/to/images-directory
Selecting the closest images to a point list
During acquisition, excessive number of pictures can be taken (when strolling outside of the perimeter or moving not fast enough). If we provide a list of positions where the images should have been taken, we can select only the closest images to each of those position.
select-closest-photos \
--coords=/path/to/perfect-positions.csv \
--images=/source/image/directory \
--dest=/selected/image/directory \
--report=/path/to/report.png
Comparing GPX tracks
Compare various coords tracks, from .gpx, .llh, .pos (useful to plot the same track from different GPS):
plot-coords-tracks --gpx="gps A:/path/to/a.gpx" --gpx="gps B:/path/to/b.gpx" --output=/path/to/plot.jpeg
Extracting photos coordinates to a GPX file
From a directory containing images (with GPS locations), create a GPX file:
images-to-gpx --output=/path/to/a.gpx --images=/path/to/images-directory
License
MIT
Development
Setup
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
Testing
pytest
PIPy deployment
Increase the version in setup.cfg.
Github release.
Juste create a new release on github and let the action flow.
dev laptop release
rm dist/*
python3.11 -m build
python3.11 -m twine upload dist/*
Metadata
Release files for coordinates-label-photos 1.0.7
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 |
|---|---|---|---|---|
| coordinates-label-photos-1.0.7.tar.gz | 17.1 kB | Without provenance | Details for coordinates-label-photos-1.0.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| coordinates_label_photos-1.0.7-py3-none-any.whl | Python 3 | none | any | Details for coordinates_label_photos-1.0.7-py3-none-any.whl |
Total release size: 40.8 kB
Release files / coordinates-label-photos-1.0.7.tar.gz
| Download URL | coordinates-label-photos-1.0.7.tar.gz |
|---|---|
| Size | 17.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
56bc8684407666147896b262c8b13dd245cc02ad41e172a03a81b4ec3ec1a105
|
|
BLAKE2b-256 checksum How to use checksums |
1f713a89c7f767db46250702a2517513ede64a5f9f620d6225535786d19d2be8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.9.18
|
Release files / coordinates_label_photos-1.0.7-py3-none-any.whl
| Download URL | coordinates_label_photos-1.0.7-py3-none-any.whl |
|---|---|
| Size | 23.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
76df7fd737953b3c0b8ffa54e31987d65d2d9d5cef1ab146750efacb3f1df43f
|
|
BLAKE2b-256 checksum How to use checksums |
568dcaa6f9dfbd3cfc98ba38a59b058ba0943f8ecce24bf343d047dea214d8eb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.9.18
|
Security for coordinates-label-photos 1.0.7
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.