# Color Relief Editor
<img width="622" alt="sample" src="https://github.com/corb555/ColorReliefEditor/blob/main/docs/images/color%20sample.png?raw=true">
---
# Overview
This application uses GDAL tools to create high-quality color relief maps from
Digital Elevation Model (DEM) files.
The app provides user-configurable settings for the colors and parameters, and directly executes GDAL
utilities, providing a seamless experience for creating relief maps.
---
## Features
### **Color Editor**
- **Real-Time Editing:** Modify settings and preview results instantly.
- **Color Palette Selector:** Choose colors for each elevation range with ease.
- **Undo Support:** Roll back unwanted changes.
- **Insert rows:** Insert rows with interpolation.
- **Rescale:** Rescale elevation values with one click.
- **Import:** Import standard GDAL color files.
### **Hillshade Editor**
- Modify hillshade settings and see immediate previews.
### **Final Relief Image Generation**
- **Blending:** Combines hillshade and color relief with composite multiply for smooth results.
- **Optimized Processing:**
- Only rebuilds components when their configuration changes.
- Supports multi-core processing for faster performance.
- **External Tools:** Links to external viewers like QGIS or GIMP for post-processing.
- **Convenient Workflow:** Copy the final image directly to a map folder.
### **Elevation File Management**
- **Drag-and-Drop:** Easily upload elevation files via the Elevation Tab.
- **Coordinate Reference System (CRS):** Optionally set the CRS for your files.
- **Sources:** Save source URLs and license information for elevation files.
---
## Installation
---
## _Install Dependencies_
Launch Terminal
### Mac / Anaconda
```shell
conda install yq gdal make
```
### Mac / Homebrew
```shell
brew install yq gdal make
```
### Debian / Ubuntu
```shell
sudo apt-get install yq gdal-bin
```
## _Install ColorReliefEditor_
Launch Terminal
It is recommended that you set up a virtual Python environment for this (not needed for Anaconda):
```shell
python3 -m venv .venv
source .venv/bin/activate
```
Install the app:
```shell
pip install ColorReliefEditor
```
---
## Usage
---
1. **Launch ColorReliefEditor**
- Start Terminal and type:
```shell
ColorReliefEditor
```
2. **In Project Tab** - click _New_ to create a new project
3. **In Elevation Tab** - download Digital Elevation files and drag and drop them here
4. **In Hillshade and Color Tab** - edit Hillshade and Color settings and click _Preview_ to review
5. **In Relief Tab** - click _Create_ to create a full size merge of hillshade and color relief
---
## License
---
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
documentation files (the “Software”), to deal in the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
**Note: This uses PyQT with its license terms**
---
## Support
---
To report an issue, please visit the [issue tracker](https://github.com/corb555/ColorReliefEditor/issues).
Raw data
{
"_id": null,
"home_page": null,
"name": "ColorReliefEditor",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "GDAL, GIS, editor, DEM, Elevation",
"author": "corb",
"author_email": null,
"download_url": null,
"platform": null,
"description": "# Color Relief Editor\n\n<img width=\"622\" alt=\"sample\" src=\"https://github.com/corb555/ColorReliefEditor/blob/main/docs/images/color%20sample.png?raw=true\">\n\n---\n\n# Overview\n\nThis application uses GDAL tools to create high-quality color relief maps from \nDigital Elevation Model (DEM) files. \nThe app provides user-configurable settings for the colors and parameters, and directly executes GDAL \nutilities, providing a seamless experience for creating relief maps.\n\n---\n\n## Features\n\n### **Color Editor**\n- **Real-Time Editing:** Modify settings and preview results instantly.\n- **Color Palette Selector:** Choose colors for each elevation range with ease.\n- **Undo Support:** Roll back unwanted changes.\n- **Insert rows:** Insert rows with interpolation.\n- **Rescale:** Rescale elevation values with one click.\n- **Import:** Import standard GDAL color files.\n\n### **Hillshade Editor**\n- Modify hillshade settings and see immediate previews.\n\n### **Final Relief Image Generation**\n- **Blending:** Combines hillshade and color relief with composite multiply for smooth results.\n- **Optimized Processing:**\n - Only rebuilds components when their configuration changes.\n - Supports multi-core processing for faster performance.\n- **External Tools:** Links to external viewers like QGIS or GIMP for post-processing.\n- **Convenient Workflow:** Copy the final image directly to a map folder.\n\n### **Elevation File Management**\n- **Drag-and-Drop:** Easily upload elevation files via the Elevation Tab.\n- **Coordinate Reference System (CRS):** Optionally set the CRS for your files.\n- **Sources:** Save source URLs and license information for elevation files.\n\n---\n\n## Installation\n\n---\n\n## _Install Dependencies_\nLaunch Terminal\n\n### Mac / Anaconda\n\n```shell\nconda install yq gdal make\n```\n\n### Mac / Homebrew\n \n```shell\nbrew install yq gdal make\n```\n\n### Debian / Ubuntu \n \n```shell\nsudo apt-get install yq gdal-bin\n```\n\n## _Install ColorReliefEditor_\nLaunch Terminal\n\n It is recommended that you set up a virtual Python environment for this (not needed for Anaconda):\n ```shell\n python3 -m venv .venv\n source .venv/bin/activate\n ```\n\n Install the app:\n ```shell\n pip install ColorReliefEditor\n ```\n\n---\n\n## Usage \n\n---\n\n1. **Launch ColorReliefEditor**\n - Start Terminal and type:\n ```shell\n ColorReliefEditor\n ```\n \n2. **In Project Tab** - click _New_ to create a new project\n3. **In Elevation Tab** - download Digital Elevation files and drag and drop them here\n4. **In Hillshade and Color Tab** - edit Hillshade and Color settings and click _Preview_ to review\n5. **In Relief Tab** - click _Create_ to create a full size merge of hillshade and color relief\n\n---\n\n## License\n\n---\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated\ndocumentation files (the \u201cSoftware\u201d), to deal in the Software without restriction, including without limitation the\nrights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit\npersons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the\nSoftware.\n\nTHE SOFTWARE IS PROVIDED \u201cAS IS\u201d, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE\nWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR\nOTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n**Note: This uses PyQT with its license terms**\n\n---\n\n## Support\n\n---\nTo report an issue, please visit the [issue tracker](https://github.com/corb555/ColorReliefEditor/issues).\n",
"bugtrack_url": null,
"license": null,
"summary": "Creates hillshade images and color relief images from Digital Elevation Files using GDAL",
"version": "0.3.0",
"project_urls": {
"Repository": "https://github.com/corb555/ColorReliefEditor"
},
"split_keywords": [
"gdal",
" gis",
" editor",
" dem",
" elevation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "83187340b719392a9d6b45f02dc6c422bdaecce851802def0221d4a8a3e95d5f",
"md5": "645140dba51fbb086c928e855ea9e4ec",
"sha256": "fbb43969687f0e1a7f6c9899c558528cc9486e462bee383b6c1cd7db3adccdc4"
},
"downloads": -1,
"filename": "ColorReliefEditor-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "645140dba51fbb086c928e855ea9e4ec",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 87545,
"upload_time": "2025-01-06T07:50:44",
"upload_time_iso_8601": "2025-01-06T07:50:44.176418Z",
"url": "https://files.pythonhosted.org/packages/83/18/7340b719392a9d6b45f02dc6c422bdaecce851802def0221d4a8a3e95d5f/ColorReliefEditor-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-06 07:50:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "corb555",
"github_project": "ColorReliefEditor",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "setuptools",
"specs": [
[
"~=",
"56.0.0"
]
]
},
{
"name": "pytest",
"specs": [
[
"~=",
"8.3.4"
]
]
},
{
"name": "PyQt6",
"specs": [
[
"~=",
"6.7.1"
]
]
},
{
"name": "PyQt6-sip",
"specs": [
[
"~=",
"13.8.0"
]
]
},
{
"name": "YMLEditor",
"specs": [
[
"~=",
"0.1.17"
]
]
},
{
"name": "appdirs",
"specs": [
[
"~=",
"1.4.4"
]
]
}
],
"lcname": "colorreliefeditor"
}
JSON
