{"id":20068548,"url":"https://github.com/tofull/py3dtiles_merger","last_synced_at":"2025-05-05T19:31:19.322Z","repository":{"id":220589290,"uuid":"142480522","full_name":"Tofull/py3dtiles_merger","owner":"Tofull","description":"A tool to merge independant 3dtiles to ease vizualization of big 3d data on Cesium or Itowns","archived":false,"fork":false,"pushed_at":"2019-11-12T19:20:25.000Z","size":2154,"stargazers_count":27,"open_issues_count":1,"forks_count":11,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-24T02:53:38.650Z","etag":null,"topics":["3dtiles","bigdata","cesiumjs","itowns","py3dtiles","stream","tileset"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tofull.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2018-07-26T18:42:02.000Z","updated_at":"2024-03-12T01:30:50.000Z","dependencies_parsed_at":"2024-02-02T23:26:44.387Z","dependency_job_id":"0d3e7a0a-ea59-4a86-a15a-4f9df2c11888","html_url":"https://github.com/Tofull/py3dtiles_merger","commit_stats":null,"previous_names":["tofull/py3dtiles_merger"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tofull%2Fpy3dtiles_merger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tofull%2Fpy3dtiles_merger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tofull%2Fpy3dtiles_merger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tofull%2Fpy3dtiles_merger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tofull","download_url":"https://codeload.github.com/Tofull/py3dtiles_merger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224461746,"owners_count":17315116,"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":["3dtiles","bigdata","cesiumjs","itowns","py3dtiles","stream","tileset"],"created_at":"2024-11-13T14:07:30.589Z","updated_at":"2024-11-13T14:07:31.233Z","avatar_url":"https://github.com/Tofull.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"py3dtiles_merger\n================\n\n    **Disclaimer:**\n\n    This project is under active development and has been created to generate data as fast as possible at Jakarto (rush time). It doesn't cover either unit test, well-written documentation, or a sufficient level of abstraction to be used in different contexts. However, I will be more than happy to remove this disclaimer when improvements will be done. Feel free to open an issue to help the project.\n\n\nA tool to merge independant 3dtiles to ease visualization of big 3d data on `Cesium \u003chttps://cesiumjs.org/Cesium/Build/Apps/Sandcastle/index.html\u003e`_ or `Itowns \u003chttps://github.com/iTowns/itowns\u003e`_.\n\nThe 3dtiles must have been generated in the same format than `py3dtiles \u003chttps://github.com/Oslandia/py3dtiles\u003e`_ output (branch `lasTo3dtiles` until it's merged).\n\npy3dtiles_merger generate a `tileset.json` file which points to some `tileset.json` children respecting the `3dtiles external tilesets referencing specification \n\u003chttps://github.com/AnalyticalGraphicsInc/3d-tiles#external-tilesets\u003e`_.\n\n.. image:: doc/assets/py3dtiles_merger.png\n    :width: 200px\n    :align: center\n    :height: 100px\n    :alt: py3dtiles_merger schema\n\nInstallation\n#############\n\n- Local installation *(recommended until the project support pypi integration)*\n\n.. code-block:: shell\n\n    git clone https://github.com/Tofull/py3dtiles_merger\n    cd py3dtiles_merger\n    pip install .\n\n\nUsage\n###########\n\nTo merge `\u003cchild_paths\u003e/tileset.json` into one global `tileset.json`, use:\n\n    .. code-block:: shell\n    \n        # On windows\n        py3dtiles_merger.exe -v -r D:/data_py3dtiles/output_merged\n\n\nWhat's next ?\n############\n\nOnce you have generated the global tileset.json, you can expose it over the Internet with any http server, like :\n\n.. code-block:: shell\n\n    # using https://www.npmjs.com/package/http-server\n    npm install http-server -g\n    http-server D:/data_py3dtiles/output_merged --cors -p 8080\n\nThen, your tileset is available over the Internet, and you can visualize it using 3d viewer, for example Cesium sandcastle : \n\n1. Go to https://cesiumjs.org/Cesium/Build/Apps/Sandcastle/index.html\n2. Insert the following code on Javascript Code section : \n\n    .. code-block:: javascript\n    \n        var viewer = new Cesium.Viewer('cesiumContainer');\n        var tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({\n            url : 'http://127.0.0.1:8080/tileset.json'\n        }));\n\n3. Click Run (or F8) and enjoy.\n\n    .. image:: doc/assets/example_3dtiles_on_cesium.png\n        :width: 200px\n        :align: center\n        :height: 100px\n        :alt: Example on cesium\n\n\nContribution\n#############\n\nContributions are welcome. Feel free to open an issue for a question, a remark, a typo, a bugfix or a wanted feature.\n\n\n\nLicence\n##########\n\nCopyright © 2018 Loïc Messal (@Tofull) and contributors\n\nDistributed under the MIT Licence.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftofull%2Fpy3dtiles_merger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftofull%2Fpy3dtiles_merger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftofull%2Fpy3dtiles_merger/lists"}