{"id":20515544,"url":"https://github.com/ignf/itowns-legacy","last_synced_at":"2025-04-14T00:25:53.041Z","repository":{"id":109495005,"uuid":"50191475","full_name":"IGNF/itowns-legacy","owner":"IGNF","description":"iTowns is a JS/WebGL framework for 3D geospatial data visualization","archived":false,"fork":false,"pushed_at":"2016-07-08T16:10:23.000Z","size":7382,"stargazers_count":53,"open_issues_count":8,"forks_count":20,"subscribers_count":31,"default_branch":"master","last_synced_at":"2025-03-27T14:47:31.857Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IGNF.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}},"created_at":"2016-01-22T16:02:23.000Z","updated_at":"2024-01-05T03:29:22.000Z","dependencies_parsed_at":"2023-04-13T13:16:55.160Z","dependency_job_id":null,"html_url":"https://github.com/IGNF/itowns-legacy","commit_stats":null,"previous_names":["ignf/itowns-legacy"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IGNF%2Fitowns-legacy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IGNF%2Fitowns-legacy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IGNF%2Fitowns-legacy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IGNF%2Fitowns-legacy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IGNF","download_url":"https://codeload.github.com/IGNF/itowns-legacy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248800112,"owners_count":21163404,"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":[],"created_at":"2024-11-15T21:22:40.827Z","updated_at":"2025-04-14T00:25:53.012Z","avatar_url":"https://github.com/IGNF.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"http://www.itowns.fr/images/logo-itowns2XS.png\" /\u003e\n\u003c/p\u003e\n\n# iTowns V1\n\n### What is it?\n\niTowns is a web framework written in Javascript/WebGL for visualisation of 3D geographic data allowing precise measurements in 3D.\nIts first purpose was the visualisation of street view images and terrestrial lidar point cloud. It has then been extended to handle more data types.\n\nSee [http://itowns.github.io/] for more informations.\n\n### Supported data types\n\n- Oriented images\n- Panoramic images\n- Point Clouds\n- 3D textured models\n- WFS Vector\n\n![iTowns screenshot](http://www.itowns.fr/videos/screenshotGIT.jpg)\n\nThe V1 of iTowns Open Source is the core of the original iTowns from IGN Matis lab. As such, it contains a subset of the original application features.\n\n### Features\n\n- Load and project Oriented Images on mesh (cube or city model)\n- Load and display Panoramic Images\n- Load Depth Panoramic Image and render in 3D\n- Load 2D multipolygons with height (building footprint) from WFS or local file and triangulate it to create building boxes. This mesh can then be use for texture projection.\n- Navigate through Image Data using click and go functions\n- Load and display Point Cloud from PLY files.\n- Load and display 3D textured models (B3D, 3DS).\n- Simple API interface.\n\n### Sample data\n\nYou can test iTowns with a provided sample data set, courtesy of IGN.\n\nThe sample data is here : https://github.com/iTowns/itowns-sample-data\n\nIt includes :\n\n- 250 Oriented Images (50 Panoramics, 192 MB)\n- 1 patch (500 * 500m) of 3D textured city models (BATI3D, 50 MB)\n- Terrestrial PointCloud (20 Millions point, 400 MB)\n- JSON of building footprint and DTM (500 kB)\n\n### Getting started\n\nInstructions below will differ depending on whether you just want to run the demo locally,\nor start developping (and then run the demo in development mode).\n\n#### Running the demo locally\n\nTo get a quick idea of what iTowns is, just type in what follows in the\ncommand line:\n\n```\ngit clone -b gh-pages https://github.com/iTowns/itowns.git\ngit clone https://github.com/iTowns/itowns-sample-data.git\npython -m SimpleHTTPServer 8000\n```\n\nThe first command just clones this repository. The second one clones the sample\ndata repository and the third lauch a simple HTTP serveur on your machine on\nport 8000 (choose another available port if 8000 is already in use).\n\nThen just point your web browser at [http://localhost:8000/itowns-sample-data/](http://localhost:8000/itowns-sample-data/) and enjoy!\n\n#### Building iTowns\n\nTo build iTowns, make sure you have [Node.js](https://nodejs.org/) installed, clone the repository, then open a console and type\n(from the directory you cloned the iTowns repository into):\n\n```\nnpm install\nnpm run build\n```\n\nThis will produce an optimized, bundled `itowns.js` in the `dist/` directory.\n\nNote that if you already cloned the repository from the “Running the demo locally” instructions,\nyou'll have to checkout the `master` branch (above instructions did checkout the `gh-pages` instead,\nwhich contains a prebuilt version of iTowns).\n\n#### Run the demo in development mode\n\nTo run the demo in development mode, you need to clone the sample data repository next to the iTowns repository.\n\nIf you initially followed the “Running the demo locally” instructions, you're all setup;\notherwise, run the following commands:\n\n```\ncd ..\ngit clone https//github.com/iTowns/itowns-sample-data.git\ncd -\n```\n\nThen run:\n\n```\nnpm start\n```\n\nand open [http://localhost:8080/itowns-sample-data/](http://localhost:8080/itowns-sample-data/)\n(note that the port is different from the “Running the demo locally” instructions)\n\nAny change to a source file will automatically trigger a reload of the demo in the browser.\nThe webpack-dev-server that is launched by the `npm start` command builds the project on-the-fly\n(and in-memory) and generates source-maps for easy debugging in your browser.\nNote however that the code you run in the browser is not directory the code from the source files,\nit has been processed by webpack.\n\nTo change the port the server listens on, pass additional `-- --port PORT` arguments, e.g.\n\n```\nnpm start -- --port 8000\n```\n\n### Roadmap items\n\nThe following tasks are currently worked on :\n\n- Code simplification\n- Documentation\n- Offline examples\n- Python code for data preparation\n\nMeanwhile, [iTowns Version 2](https://github.com/iTowns/itowns2) is also being developped.\n\n### Support\n\niTowns is an original work from IGN, MATIS research laboratory.\nIt has been funded through various research programs involving the French National Research Agency, Cap Digital, UPMC, Mines ParisTec, CNRS, LCPC.\n\niTowns is currently maintained by IGN ( http://www.ign.fr ) and Oslandia ( http://www.oslandia.com )\n\n![IGN Logo](https://raw.githubusercontent.com/iTowns/itowns/master/images/IGN_logo_2012.png)\n![Oslandia Logo](https://raw.githubusercontent.com/iTowns/itowns/master/images/Oslandia_logo.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fignf%2Fitowns-legacy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fignf%2Fitowns-legacy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fignf%2Fitowns-legacy/lists"}