{"id":23116403,"url":"https://github.com/3dcitydb/iur-ade-citydb","last_synced_at":"2025-08-16T21:32:39.818Z","repository":{"id":141884462,"uuid":"285846399","full_name":"3dcitydb/iur-ade-citydb","owner":"3dcitydb","description":"i-Urban Revitalization ADE extension for the 3DCityDB","archived":false,"fork":false,"pushed_at":"2024-09-14T20:45:43.000Z","size":634,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-09-16T02:32:37.639Z","etag":null,"topics":["3dcitydb","ade","citygml","iur","planning","revitalization","urban"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/3dcitydb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","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":"2020-08-07T14:18:17.000Z","updated_at":"2024-09-14T20:45:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"15ba144c-a1be-4234-a7d9-16ec27e10e41","html_url":"https://github.com/3dcitydb/iur-ade-citydb","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3dcitydb%2Fiur-ade-citydb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3dcitydb%2Fiur-ade-citydb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3dcitydb%2Fiur-ade-citydb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3dcitydb%2Fiur-ade-citydb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/3dcitydb","download_url":"https://codeload.github.com/3dcitydb/iur-ade-citydb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230061427,"owners_count":18166705,"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":["3dcitydb","ade","citygml","iur","planning","revitalization","urban"],"created_at":"2024-12-17T04:16:08.427Z","updated_at":"2025-08-16T21:32:39.796Z","avatar_url":"https://github.com/3dcitydb.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# i-UR ADE extension for the 3D City Database\n\n\u003e [!NOTE]\n\u003e This repository hosts the 3DCityDB v4 i-UR ADE extension. Although 3DCityDB v5 is now available, 3DCityDB v4\n\u003e remains stable and operational. However, it is in **maintenance mode**, meaning no significant new features are\n\u003e planned, though existing bugs will continue to be addressed. Development is now focused on 3DCityDB v5, and we recommend\n\u003e upgrading to benefit from new features and improvements. Please refer to the [3DCityDB v5 user manual](https://3dcitydb.github.io/3dcitydb-mkdocs/)\n\u003e for more information.\n\nThis is a 3DCityDB extension for the **i-Urban Revitalization (i-UR)** Application Domain Extension for CityGML.\nThe \"i-UR\" is an information infrastructure for urban revitalization and planning.\n\n:information_source: The i-UR ADE extension is in **maintenance mode** with no significant active development planned.\nExisting bugs will be fixed, but large new features will likely not be added. Support through contributions or funding\nis welcome.\n\nThis extension adds support for managing i-UR ADE **version 1.4** data inside the 3DCityDB and enables the\n[Importer/Exporter tool](https://github.com/3dcitydb/importer-exporter) to load and export i-UR ADE enriched datasets.\n\n* **i-UR specification and material: https://www.chisou.go.jp/tiiki/toshisaisei/itoshisaisei/iur**\n* **Where to file issues: https://github.com/3dcitydb/iur-ade-citydb/issues**\n\n## How to use this extension\nThe i-UR ADE extension consists of two main parts:\n\n- A relational schema mapping the i-UR ADE data model to a set of database tables and objects. The relational schema\nis built upon and seamlessly integrates with the official 3DCityDB relational schema.\n- Java modules that are automatically loaded by the Importer/Exporter and enable the tool to read/write i-UR\nADE enriched datasets and to store and manage i-UR data in the 3DCityDB.\n\nBefore using the i-UR ADE extension, you must set up an instance of the 3DCityDB and install the Importer/Exporter tool.\nPlease follow the installation guidelines provided in the\n[3DCityDB online documentation](http://3dcitydb-docs.rtfd.io/). You will need the\n[ADE Manager Plugin](https://3dcitydb-docs.readthedocs.io/en/latest/plugins/ade-manager/) of the\nImporter/Exporter. So, make sure to select this plugin in the setup wizard of the Importer/Exporter.\n\nAfterwards, download a release package of the i-UR ADE extension as ZIP file from the\n[releases section](https://github.com/3dcitydb/iur-ade-citydb/releases). Please check the release information to\nmake sure that the extension can be used with your version of the 3DCityDB and of the Importer/Exporter tool.\nUnzip the package into the `ade-extensions` folder inside the installation directory of the Importer/Exporter.\n\nNext, create and register the i-UR ADE relational schema in your 3DCityDB instance. The easiest\nway to do this is to use the ADE Manager Plugin and the contents of the unzipped release package.\nFollow the steps described in the 3DCityDB online documentation:\n\n* **[How to register the i-UR ADE schema in your 3DCityDB instance](https://3dcitydb-docs.readthedocs.io/en/latest/plugins/ade-manager/ade-registration.html)**\n\nYou have to register the schema only once in every 3DCityDB instance that should be able to manage i-UR ADE data.\n\nFinally, use the Importer/Exporter to connect to your i-UR extended 3DCityDB instance and load/extract i-UR data.\nIf you have correctly unzipped the i-UR ADE extension package inside the `ade-extensions` folder, the tool will\nautomatically detect the extension and will be able to handle i-UR datasets. Again, the main steps for using an\nADE extension with the Importer/Exporter are described in the 3DCityDB online documentation:\n\n* **[How to use the i-UR ADE extension with the Importer/Exporter](https://3dcitydb-docs.readthedocs.io/en/latest/plugins/ade-manager/impexp-ade-extension.html)**\n\n## Technical details\nThe relational schema for the i-UR ADE has been fully automatically derived from the XML schemas using the ADE Manager\nPlugin of the Importer/Exporter. This ADE-to-3DCityDB mapping should work for all CityGML ADE XML schemas and is documented\n[here](https://3dcitydb-docs.readthedocs.io/en/latest/plugins/ade-manager/ade-transformation.html).\n\nThe Java module for enabling the Importer/Exporter tool to store i-UR ADE data according to the extended relational schema\nhas been manually implemented against the `ADEExtension` interface and plugin mechanism of the Importer/Exporter.\nThe `ADEExtension` interface has been introduced with [version 4.0](https://github.com/3dcitydb/3dcitydb/releases/tag/v4.0.0)\nof the 3D City Database. The [TestADE repository](https://github.com/3dcitydb/extension-test-ade) demonstrates the\nimplementation of an artificial ADE and may serve as template for implementing extensions for your own ADEs.\n\nThe Java module for parsing and writing i-UR ADE enriched datasets is implemented as extension for the open source\nCityGML library citygml4j. More information can be found [here](https://github.com/citygml4j/iur-ade-citygml4j).\n\n## Building from source\nThe i-UR ADE 3DCityDB extension uses [Gradle](https://gradle.org/) as build system. To build the extension from source,\nclone the repository to your local machine and run the following command from the root of the repository. \n\n    \u003e gradlew installDist\n\nThe script automatically downloads all required dependencies for building the module. So make sure you are connected\nto the internet. The build process runs on all major operating systems and only requires a Java 8 JDK or higher to run.\n\nIf the build was successful, you will find the extension package of the i-UR ADE module under `iur-ade-citydb/build/install`.\n\n## About i-UR\nThe \"i-UR\" information infrastructure allows people to analyse and to visualize the situation and problems of urban areas\naccording to the future vision of each area using geospatial information and virtual reality technologies. The\nquantitative analysis and visualization clearly show the cash-flow and spatial plan of the city and promotes\nunderstanding and encourages consensus building among relevant players, e.g. investors, citizens, and developers.\n\nThe i-UR ADE is an Application Domain Extension for [OGC CityGML 2.0](https://www.ogc.org/standard/citygml/).\n\n## License\n\nThe i-UR ADE 3DCityDB extension is licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).\nSee the `LICENSE` file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3dcitydb%2Fiur-ade-citydb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F3dcitydb%2Fiur-ade-citydb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3dcitydb%2Fiur-ade-citydb/lists"}