# 🗺️ ezGPX
[](https://ezgpx.readthedocs.io/en/latest/?badge=latest)
<!--  -->
## 🔎 Description
Easy to use Python GPX library.
- PyPi: https://pypi.org/project/ezgpx/
- Documentation: https://ezgpx.readthedocs.io/en/latest/
- Source code: https://github.com/FABallemand/ezGPX
- Bug reports: https://github.com/FABallemand/ezGPX/issues
## 🛠️ Installation
```bash
pip install ezgpx
```
## 🏁 Get started
```python
import ezgpx
import matplotlib
# Parse GPX file
gpx = ezgpx.GPX("file.gpx")
# Simplify (using Ramer-Dougle-Peucker algorithm)
gpx.simplify()
# Remove metadata
gpx.remove_metadata()
# Plot with Matplotlib
test_gpx.matplotlib_plot(figsize=(16,9),
size=6,
color="ele",
cmap=matplotlib.cm.get_cmap("gnuplot", 12),
colorbar=False,
start_point_color="green",
stop_point_color="red",
way_points_color=None,
background="World_Imagery",
offset_percentage=0.04,
dpi=100,
title=test_gpx.name(),
title_fontsize=20,
watermark=True,
file_path="img_1.png")
# Write new simplified GPX file
gpx.to_gpx("new_file.gpx")
```
## 🏋️ Advanced Use
```python
import ezgpx
import matplotlib
# Parse GPX file
gpx = ezgpx.GPX("file.gpx")
# Plot with Matplotlib
test_gpx.expert_plot(figsize=(16,9),
subplots=(3,2),
map_position=(0,0),
map_size=10,
map_color="ele",
map_cmap=matplotlib.cm.get_cmap("viridis", 12),
map_colorbar=True,
start_point_color=None,
stop_point_color=None,
way_points_color=None,
background="World_Imagery",
offset_percentage=0.04,
xpixels=1000,
ypixels=None,
dpi=100,
elevation_profile_position=(1,0),
elevation_profile_size=10,
elevation_profile_color="ele",
elevation_profile_cmap=matplotlib.cm.get_cmap("viridis", 12),
elevation_profile_colorbar=False,
elevation_profile_grid=True,
elevation_profile_fill_color="lightgray",
elevation_profile_fill_alpha=0.5,
pace_graph_position=(2,0),
pace_graph_size=10,
pace_graph_color="ele",
pace_graph_cmap=None,
pace_graph_colorbar=False,
pace_graph_grid=True,
pace_graph_fill_color="lightgray",
pace_graph_fill_alpha=0.5,
pace_graph_threshold=15,
ascent_rate_graph_position=(1,1),
made_with_ezgpx_position=(0,1),
shared_color="ele",
shared_cmap=None,
shared_colorbar=True,
data_table_position=(2,1),
title=test_gpx.name(),
title_fontsize=20,
watermark=False,
file_path="img_2.png")
```
## 👤 Author
- Fabien ALLEMAND
Raw data
{
"_id": null,
"home_page": "",
"name": "ezgpx",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Fabien ALLEMAND <allemand.fabien@orange.fr>",
"keywords": "gpx,gpx-files,gpx-parser,gpx-reader,gpx-writer,gpx-converter,gpx-data,kml,kmz,fit",
"author": "",
"author_email": "Fabien ALLEMAND <allemand.fabien@orange.fr>",
"download_url": "https://files.pythonhosted.org/packages/51/fd/8826bcc1c1d25b0f24852afce37a3c5c640e086c5171da130f3c76a8ac35/ezgpx-0.2.0.tar.gz",
"platform": null,
"description": "# \ud83d\uddfa\ufe0f ezGPX\n\n\n\n\n[](https://ezgpx.readthedocs.io/en/latest/?badge=latest)\n\n<!--  -->\n\n## \ud83d\udd0e Description\nEasy to use Python GPX library.\n\n- PyPi: https://pypi.org/project/ezgpx/\n- Documentation: https://ezgpx.readthedocs.io/en/latest/\n- Source code: https://github.com/FABallemand/ezGPX\n- Bug reports: https://github.com/FABallemand/ezGPX/issues\n\n## \ud83d\udee0\ufe0f Installation\n\n```bash\npip install ezgpx\n```\n\n## \ud83c\udfc1 Get started\n\n```python\nimport ezgpx\nimport matplotlib\n\n# Parse GPX file\ngpx = ezgpx.GPX(\"file.gpx\")\n\n# Simplify (using Ramer-Dougle-Peucker algorithm)\ngpx.simplify()\n\n# Remove metadata\ngpx.remove_metadata()\n\n# Plot with Matplotlib\ntest_gpx.matplotlib_plot(figsize=(16,9),\n size=6,\n color=\"ele\",\n cmap=matplotlib.cm.get_cmap(\"gnuplot\", 12),\n colorbar=False,\n start_point_color=\"green\",\n stop_point_color=\"red\",\n way_points_color=None,\n background=\"World_Imagery\",\n offset_percentage=0.04,\n dpi=100,\n title=test_gpx.name(),\n title_fontsize=20,\n watermark=True,\n file_path=\"img_1.png\")\n\n# Write new simplified GPX file\ngpx.to_gpx(\"new_file.gpx\")\n```\n\n\n## \ud83c\udfcb\ufe0f Advanced Use\n\n```python\nimport ezgpx\nimport matplotlib\n\n# Parse GPX file\ngpx = ezgpx.GPX(\"file.gpx\")\n\n# Plot with Matplotlib\ntest_gpx.expert_plot(figsize=(16,9),\n subplots=(3,2),\n map_position=(0,0),\n map_size=10,\n map_color=\"ele\",\n map_cmap=matplotlib.cm.get_cmap(\"viridis\", 12),\n map_colorbar=True,\n start_point_color=None,\n stop_point_color=None,\n way_points_color=None,\n background=\"World_Imagery\",\n offset_percentage=0.04,\n xpixels=1000,\n ypixels=None,\n dpi=100,\n elevation_profile_position=(1,0),\n elevation_profile_size=10,\n elevation_profile_color=\"ele\",\n elevation_profile_cmap=matplotlib.cm.get_cmap(\"viridis\", 12),\n elevation_profile_colorbar=False,\n elevation_profile_grid=True,\n elevation_profile_fill_color=\"lightgray\",\n elevation_profile_fill_alpha=0.5,\n pace_graph_position=(2,0),\n pace_graph_size=10,\n pace_graph_color=\"ele\",\n pace_graph_cmap=None,\n pace_graph_colorbar=False,\n pace_graph_grid=True,\n pace_graph_fill_color=\"lightgray\",\n pace_graph_fill_alpha=0.5,\n pace_graph_threshold=15,\n ascent_rate_graph_position=(1,1),\n made_with_ezgpx_position=(0,1),\n shared_color=\"ele\",\n shared_cmap=None,\n shared_colorbar=True,\n data_table_position=(2,1),\n title=test_gpx.name(),\n title_fontsize=20,\n watermark=False,\n file_path=\"img_2.png\")\n```\n\n\n## \ud83d\udc64 Author\n- Fabien ALLEMAND\n",
"bugtrack_url": null,
"license": "GNU GPLv3",
"summary": "Easy to use Python GPX library",
"version": "0.2.0",
"project_urls": {
"Documentation": "https://ezgpx.readthedocs.io/en/latest/",
"Issues": "https://github.com/FABallemand/ezGPX/issues",
"PyPi": "https://pypi.org/project/ezgpx/",
"Repository": "https://github.com/FABallemand/ezGPX"
},
"split_keywords": [
"gpx",
"gpx-files",
"gpx-parser",
"gpx-reader",
"gpx-writer",
"gpx-converter",
"gpx-data",
"kml",
"kmz",
"fit"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "11d1f9e8b06ff23e0e5ddf5d58556b7bcc69d8079238548e644c2a50995a9b66",
"md5": "ef233603be61b4558a2886b94c2b7bcc",
"sha256": "479e0cd1ed4c136ddccd5ab276fa27f0d8374af32c526d2c3c3fd0ec7d2f8da4"
},
"downloads": -1,
"filename": "ezgpx-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ef233603be61b4558a2886b94c2b7bcc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 85154,
"upload_time": "2024-03-02T17:15:25",
"upload_time_iso_8601": "2024-03-02T17:15:25.137871Z",
"url": "https://files.pythonhosted.org/packages/11/d1/f9e8b06ff23e0e5ddf5d58556b7bcc69d8079238548e644c2a50995a9b66/ezgpx-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "51fd8826bcc1c1d25b0f24852afce37a3c5c640e086c5171da130f3c76a8ac35",
"md5": "0421532b0ae5ab91d37281b1f1bd71ba",
"sha256": "a9942a17a0961f935e7d77ff115976b6efff571102632c21c48ec8247b232964"
},
"downloads": -1,
"filename": "ezgpx-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "0421532b0ae5ab91d37281b1f1bd71ba",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 76067,
"upload_time": "2024-03-02T17:15:27",
"upload_time_iso_8601": "2024-03-02T17:15:27.199295Z",
"url": "https://files.pythonhosted.org/packages/51/fd/8826bcc1c1d25b0f24852afce37a3c5c640e086c5171da130f3c76a8ac35/ezgpx-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-02 17:15:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "FABallemand",
"github_project": "ezGPX",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "ezgpx"
}
JSON
