| Name | gemf-map JSON |
| Version |
0.3.0
JSON |
| download |
| home_page | None |
| Summary | GEMF, an efficient tile-based map format. |
| upload_time | 2025-08-02 23:49:06 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
gemf
tiles
map
mobile map
locus
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# GEMF
Python package for the GEMF map format. From the format [specification](https://www.cgtk.co.uk/gemf):
> This tile store format is intended to provide a static (i.e. cannot be updated without regenerating from scratch) file containing a large number of tiles, stored
> in a manner that makes efficient use of SD cards and with which it is easy to access individual tiles very quickly. It is intended to overcome the existing issues
> with the way tiles are stored in most existing Android map applications as these are not very scalable.
# Installation
```cmd
pip install gemf-map
```
# Features
Core features are...
- reading `.gemf` map files via the `GEMF.from_file()` classmethod
- creating a GEMF object from PNG or JPG tiles via the `GEMF.from_tiles()` classmethod
- writing a newly created GEMF object to file via the `write()` method
Further features are...
- extracting tiles (PNG or JPG) from binary `.gemf` files via the `save_tiles()` method
- adding tiles to an existing `.gemf` file (TODO)
# Usage
```python
from gemf import GEMF
my_gemf = GEMF.from_file("MY_GEMF.gemf") # load an existing .gemf file
new_gemf = GEMF.from_tiles("PATH/TO/TILEDIR") # create a GEMF object from tiles on disk
new_gemf.write("PATH/TO/GEMF_FILE.gemf") # write GEMF object to .gemf file
```
`.gemf` files may be used in mobile mapping applications like [Locus](https://www.locusmap.app/)
Raw data
{
"_id": null,
"home_page": null,
"name": "gemf-map",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "gemf, tiles, map, mobile map, locus",
"author": null,
"author_email": "Colin Moldenhauer <colin.moldenhauer@tum.de>",
"download_url": "https://files.pythonhosted.org/packages/49/e5/32cf95e69f16ac3674adc71d0fab4456b457f4f163de5733de9e3166c66e/gemf_map-0.3.0.tar.gz",
"platform": null,
"description": "# GEMF\r\n\r\nPython package for the GEMF map format. From the format [specification](https://www.cgtk.co.uk/gemf):\r\n\r\n> This tile store format is intended to provide a static (i.e. cannot be updated without regenerating from scratch) file containing a large number of tiles, stored\r\n> in a manner that makes efficient use of SD cards and with which it is easy to access individual tiles very quickly. It is intended to overcome the existing issues\r\n> with the way tiles are stored in most existing Android map applications as these are not very scalable.\r\n\r\n\r\n# Installation\r\n```cmd\r\npip install gemf-map\r\n```\r\n\r\n\r\n# Features\r\nCore features are...\r\n- reading `.gemf` map files via the `GEMF.from_file()` classmethod\r\n- creating a GEMF object from PNG or JPG tiles via the `GEMF.from_tiles()` classmethod\r\n- writing a newly created GEMF object to file via the `write()` method\r\n\r\nFurther features are...\r\n- extracting tiles (PNG or JPG) from binary `.gemf` files via the `save_tiles()` method\r\n- adding tiles to an existing `.gemf` file (TODO)\r\n\r\n\r\n# Usage\r\n```python\r\nfrom gemf import GEMF\r\n\r\n\r\nmy_gemf = GEMF.from_file(\"MY_GEMF.gemf\") # load an existing .gemf file\r\n\r\nnew_gemf = GEMF.from_tiles(\"PATH/TO/TILEDIR\") # create a GEMF object from tiles on disk\r\nnew_gemf.write(\"PATH/TO/GEMF_FILE.gemf\") # write GEMF object to .gemf file\r\n```\r\n\r\n`.gemf` files may be used in mobile mapping applications like [Locus](https://www.locusmap.app/)\r\n",
"bugtrack_url": null,
"license": null,
"summary": "GEMF, an efficient tile-based map format.",
"version": "0.3.0",
"project_urls": {
"Homepage": "https://github.com/ColinMoldenhauer/GEMF",
"Issues": "https://github.com/ColinMoldenhauer/GEMF/issues"
},
"split_keywords": [
"gemf",
" tiles",
" map",
" mobile map",
" locus"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9e87e4e02fcd6817eb01d8e3c5481aa4458e00aafed725057de57517905a8000",
"md5": "5eed4ddce09f3add962ed78097ea42b4",
"sha256": "01eb7a71ffab5ac52393762b7a8a9a34c9d9364a2e03b754d1d671f5f79169c0"
},
"downloads": -1,
"filename": "gemf_map-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5eed4ddce09f3add962ed78097ea42b4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 40388,
"upload_time": "2025-08-02T23:49:04",
"upload_time_iso_8601": "2025-08-02T23:49:04.804848Z",
"url": "https://files.pythonhosted.org/packages/9e/87/e4e02fcd6817eb01d8e3c5481aa4458e00aafed725057de57517905a8000/gemf_map-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "49e532cf95e69f16ac3674adc71d0fab4456b457f4f163de5733de9e3166c66e",
"md5": "5e2763a52b28067de34a1bddcfc3ec28",
"sha256": "f7c3bb999295d1765b3b31a1f6e6a6050328bf0cd9a405ee0752100b93967fc1"
},
"downloads": -1,
"filename": "gemf_map-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "5e2763a52b28067de34a1bddcfc3ec28",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 39662,
"upload_time": "2025-08-02T23:49:06",
"upload_time_iso_8601": "2025-08-02T23:49:06.257567Z",
"url": "https://files.pythonhosted.org/packages/49/e5/32cf95e69f16ac3674adc71d0fab4456b457f4f163de5733de9e3166c66e/gemf_map-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-02 23:49:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ColinMoldenhauer",
"github_project": "GEMF",
"github_not_found": true,
"lcname": "gemf-map"
}
