{"id":28956862,"url":"https://github.com/developmentseed/josmmagicwand","last_synced_at":"2025-06-23T21:41:05.236Z","repository":{"id":66924850,"uuid":"539583773","full_name":"developmentseed/JosmMagicWand","owner":"developmentseed","description":"JOSM Plugin  allows  select areas to label using a range of colors,","archived":false,"fork":false,"pushed_at":"2025-02-04T15:14:35.000Z","size":100973,"stargazers_count":23,"open_issues_count":3,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-04T15:28:35.150Z","etag":null,"topics":["java","josm","josm-plugin","magic-wand","opencv"],"latest_commit_sha":null,"homepage":"","language":"Java","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/developmentseed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2022-09-21T16:28:50.000Z","updated_at":"2025-02-04T15:08:50.000Z","dependencies_parsed_at":"2024-01-19T19:41:53.901Z","dependency_job_id":"2bbfc8f1-c4df-4cc0-9c67-a7cb939ce54f","html_url":"https://github.com/developmentseed/JosmMagicWand","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/developmentseed/JosmMagicWand","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FJosmMagicWand","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FJosmMagicWand/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FJosmMagicWand/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FJosmMagicWand/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/developmentseed","download_url":"https://codeload.github.com/developmentseed/JosmMagicWand/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FJosmMagicWand/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261561190,"owners_count":23177545,"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":["java","josm","josm-plugin","magic-wand","opencv"],"created_at":"2025-06-23T21:41:04.336Z","updated_at":"2025-06-23T21:41:05.222Z","avatar_url":"https://github.com/developmentseed.png","language":"Java","readme":"# DS-annotate plugin for Java OpenStreetMap Editor\n\nThe DS-annotate plugin is an extension for the Java OpenStreetMap Desktop Editor (JOSM). Built upon ds-annotate, this plugin utilizes the [Segment Anything Service](https://github.com/developmentseed/segment-anything-services), which leverages Generative AI. Additionally, it allows users to label areas using a spectrum of colors, similar to a magic wand tool, enabling faster and more accurate mapping.\n\n![Peek 2022-11-09 16-53](https://user-images.githubusercontent.com/12978932/200950045-179c72d5-600c-4012-b2a4-3ceb1345ea25.gif)\n\n## Installation\n\n1. Search the magic wand plugin.\n\n   ![image](https://user-images.githubusercontent.com/12978932/200428835-a652ef65-f895-4acd-a19a-bef3e7a8175a.png)\n\n2. Wait to download the plugin, sometimes it takes a few minutes, because the plugin is 100 MB in size.\n\n   ![image](https://user-images.githubusercontent.com/12978932/200429273-ce2e2d4d-8839-46ce-ba47-a620e3984b17.png)\n\n3. Confirmation window.\n\n   ![image](https://user-images.githubusercontent.com/12978932/200429366-c8566cb9-d842-4efe-b810-151b68f86fc3.png)\n   ![image](https://user-images.githubusercontent.com/12978932/200431510-a414f03f-c285-4217-adf0-d9d91d41d47f.png)\n\n## Usage\n\nThe JOSM Magic Wand plugin offers three functionalities:\n\n- Generate Geometries\n- Merge Geometries\n- Simplify Geometries \n\n### Generate geometries.\n\nTo generate geometries, you must have a base map activated and a data layer.\n\n- You can press the shortcut `Ctrl + 1` or select directly in the mode bar (upper\n  left) ![image](https://user-images.githubusercontent.com/12978932/191857775-71da462d-66fd-401f-b03a-fbf444c07b04.png),\n  you will enter Magic Wand mode and you will see a wand on the\n  cursor ![image](https://user-images.githubusercontent.com/12978932/191858042-942aa381-3c4b-42bf-b9df-b23782d1dce5.png)\n  .\n- Click on the area.\n- `ctrl + 2` to generate the geometry.\n\n- To add or enhance the selection, you can press the `ctrl` button and `click` on new area.\n- To subtract the selection, you can press the `switch` button and `click` on area.\n\n### Merge geometries\n\nThis functionality allows you to merge several geometries into one, the geometries must intersects.\n\n![Peek 2022-09-22 22-44](https://user-images.githubusercontent.com/12978932/191888528-ea2105bc-7994-40e0-95bd-9d6c87c97631.gif)\n\n- Select one or more geometries.\n- Press `ctrl + 3`.\n\n### Simplify geometries.\n\nThis functionality allows you to simplify and smooth a geometry.\n\n- Select one or more geometries.\n- Press `ctrl + 4`.\n\n\n## Requirements\n\n- Java JDK 11+.\n- JOSM 18193 or higher.\n\n## Extra options \n\n![image](https://user-images.githubusercontent.com/12978932/200949130-5c4bdea3-cccb-4865-987a-5d15013089d7.png)\n\n![image](https://github.com/developmentseed/JosmMagicWand/assets/12978932/3261b754-e1f2-495b-9255-d0cc83b6009c)\n1. Select mode.\n2. Open window.\n3. In the window, you will find the following options:\n\n   - **Tolerance**: This option allows you to configure the color tolerance of the Magic Wand tool.\n\n    ```\n   Higher values expand the tolerance to more colors.\n   Lower values make the tool more specific to colors.\n   ```\n   - **Exterior contour**: This algorithm is specifically designed to simplify polygons while maintaining the shape and outer contour (hull) of the original polygon.\n\n    ```\n    Higher values result in less simplification.\n    Lower values result in more simplification.\n    ```\n   - **Vertices**: This algorithm focuses on the general simplification of polygons. Its goal is to reduce the number of vertices in a geometry while preserving its overall shape.\n\n    ```\n   Higher values result in more simplification.\n   Lower values result in less simplification.\n   ```\n   - **Topology**: This algorithm is used to simplify geometries while preserving their topology. Topology refers to the spatial relationship and connectivity between geometric elements.\n   \n    ```\n    Higher values result in more simplification.\n    Lower values result in less simplification.\n    ```\n    - **Smooth Angle**: This option allows you to smooth very sharp angles. The value entered represents the minimum angle to be simplified.\n    - **add tag**: a pop-up window will appear, allowing you to enter the tag that will be added when generating or simplifying the geometry, the format its `key=value`.\n\n\nTo disable the algorithms, set the value to 0.\n\n## Use cases\n### Cases where it works well\n\n| Image                                                                                                            | Description                                            |\n|------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------|\n| ![image](https://user-images.githubusercontent.com/12978932/200626354-cfe0ab0b-5490-4abf-9e0d-0e30bf57abf7.png)  | The edge of the lake has borders marked with the path. |\n| ![image](https://user-images.githubusercontent.com/12978932/200627390-ddd26531-cfe7-47c8-bf16-8e7a64ce3f60.png)  | The edge of the lake and the farm have marked borders. |\n| ![image](https://user-images.githubusercontent.com/12978932/200627737-04ec310a-2499-4a2d-8b33-c112e6926cdf.png)  | Uniform color and sharp edges (contrast).              |\n| ![image](https://user-images.githubusercontent.com/12978932/200628149-7e536725-369b-42aa-8309-d7cd37a73baa.png)  | Uniform color and sharp edges (contrast).              |\n| ![image](https://user-images.githubusercontent.com/12978932/200628412-756285de-581f-4369-8e81-f94c8f2f6da5.png)  | Uniform color and sharp edges (contrast).              |\n| ![image](https://user-images.githubusercontent.com/12978932/200628944-2c2143ec-a7e0-4b87-a507-41ad069e4d39.png)  | Uniform color and sharp edges (contrast).              |\n\n\n\n### Cases where it doesn't work well\n\n| Image                                                                                                            | Description                                                                   |\n|------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|\n| ![image](https://user-images.githubusercontent.com/12978932/200629118-48fa92ef-60a3-4d8a-b807-917c9dd95b8c.png)  | The two farms are separated by a very thin path of similar color.             |\n| ![image](https://user-images.githubusercontent.com/12978932/200629404-9b9a48f5-4c9d-483e-9f8d-1a7499f51659.png)  | Parts of the farm and the border have similar colors with the rest.           |\n| ![image](https://user-images.githubusercontent.com/12978932/200644356-09bbca8e-833c-49f8-9427-cb2c4de7a223.png)  | The borders of the farm with the road and the other farm have similar colors. |\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Fjosmmagicwand","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevelopmentseed%2Fjosmmagicwand","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Fjosmmagicwand/lists"}