{"id":15903485,"url":"https://github.com/vfdev-5/tinygeoimageutils","last_synced_at":"2025-06-26T07:05:04.878Z","repository":{"id":149001762,"uuid":"84330768","full_name":"vfdev-5/TinyGeoImageUtils","owner":"vfdev-5","description":"Some tools to quickly read geographical images and iterate over the image content by tiles ","archived":false,"fork":false,"pushed_at":"2018-02-06T08:11:14.000Z","size":6522,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-14T04:03:54.251Z","etag":null,"topics":["gdal","geographical-images","tile"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vfdev-5.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-08T14:43:10.000Z","updated_at":"2020-07-25T09:41:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"2d7fcf14-6197-4f1e-9b4a-702120a056b6","html_url":"https://github.com/vfdev-5/TinyGeoImageUtils","commit_stats":{"total_commits":20,"total_committers":1,"mean_commits":20.0,"dds":0.0,"last_synced_commit":"5630d03a9d3ee079fd1ab6b91af588d929d77db2"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vfdev-5/TinyGeoImageUtils","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vfdev-5%2FTinyGeoImageUtils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vfdev-5%2FTinyGeoImageUtils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vfdev-5%2FTinyGeoImageUtils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vfdev-5%2FTinyGeoImageUtils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vfdev-5","download_url":"https://codeload.github.com/vfdev-5/TinyGeoImageUtils/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vfdev-5%2FTinyGeoImageUtils/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262018765,"owners_count":23245621,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gdal","geographical-images","tile"],"created_at":"2024-10-06T12:02:06.890Z","updated_at":"2025-06-26T07:05:04.862Z","avatar_url":"https://github.com/vfdev-5.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tiny Geographical Image Utils\n\n[![Build Status](https://travis-ci.org/vfdev-5/TinyGeoImageUtils.svg?branch=master)](https://travis-ci.org/vfdev-5/TinyGeoImageUtils) \n[![Coverage Status](https://coveralls.io/repos/github/vfdev-5/TinyGeoImageUtils/badge.svg)](https://coveralls.io/github/vfdev-5/TinyGeoImageUtils)\n\nReading and manipulation of geographical images. Based on [GDAL](http://www.gdal.org/)\n\n## Installation:\n\n### Dependencies:\n\n#### Linux \n```\npip install numpy click\nsudo apt-get install libgdal-dev\npip install gdal\n```\n\n#### MacOSX\n\n```\npip install numpy\nbrew install gdal2\npip install gdal\n```\n\n### Repository\n\n```\npip install git+https://github.com/vfdev-5/TinyGeoImageUtils.git\n```\n\n## Basic tools:\n\n### Python API\n\n* `GeoImage` for reading geographical images \n* `GeoImageTiler` for tiled reading geographical images\n\n####  Usage:\n\n```python\nimport numpy as np\nimport matplotlib.pyplot as plt\nfrom gimg import GeoImage\n\ngimg = GeoImage(\"path/to/image/file\")\ndata = gimg.get_data([0, 0, 500, 500])\n\nprint(data.shape, data.type)\nplt.imshow(data[:, :, 0])\nplt.show()\n```\n\nand \n\n```python\nimport numpy as np\nimport matplotlib.pyplot as plt\nfrom gimg import GeoImage\nfrom gimg import GeoImageTilerConstSize\n\ngimg = GeoImage(\"path/to/image/file\")\ntiles = GeoImageTilerConstSize(gimg, tile_size=(512, 512), min_overlapping=128)\n\nfor tile, x, y in tiles:\n    print(tile.shape, tile.type, x, y)\n```\n\nSee other examples: \n- [example.ipynb](examples/examples.ipynb)\n- [create images](examples/create_images.py)\n\n\n### CLI \n\n#### `tile_generator` \n\nApplication to write tiles from input single image or a folder of images. \n\n##### tiles of constant size\n\nGenerate tiles of constant size with overlapping.\n\n```bash\n\u003e  tile_generator const_size --help\n\nUsage: tile_generator const_size [OPTIONS] INPUT_DIR_OR_FILE OUTPUT_DIR\n                                 TILE_SIZE_IN_PIXELS MIN_OVERLAPPING_IN_PIXELS\n\nOptions:\n  --extensions TEXT        String of file extensions to select (if input is a\n                           directory), e.g. 'jpg,png,tif'\n  --output_extension TEXT  Output tile file extension\n  --n_workers INTEGER      Number of workers in the processing pool\n                           [default=4]\n  -q, --quiet              Disable verbose mode\n  --help                   Show this message and exit.\n```\nFor example,\n```bash\n\u003e mkdir examples/tiles\n\u003e tile_generator const_size --extensions=\"jpg,png\" examples/dog.jpg examples/tiles 256 20\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvfdev-5%2Ftinygeoimageutils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvfdev-5%2Ftinygeoimageutils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvfdev-5%2Ftinygeoimageutils/lists"}