Attention: Development for this project has moved to a new location. Please refer to github.com/netherlands3d for the latest updates and contributions.
If you have any questions or concerns, feel free to reach out to us.
3D Amsterdam is a platform ( available at 3d.amsterdam.nl ) where the city of Amsterdam can be experienced interactively in 3D.
The main goals are:
- providing information about the city;
- making communication and participation more accessible through visuals;
- viewing and sharing 3D models.
More and more information and data is embedded, allowing future features like running simulations, visualization of solar and wind studies and showing impact of spatial urban changes. It will improve public insight in decision making processes.
The project is using the latest LTS (long-term support) release of Unity: 2021.3.*
We will upgrade the minor updates for the same LTS often due to stability improvements of the WebGL platform.
Currently the main target platform is a WebGL(2.0) application.
The project is set up to use the Universal Render Pipeline, focussing on high performance for lower end machines. Please note that shaders/materials have specific requirements in order to work in this render pipeline.
All the project code and comments should be written in English. Content text is written in Dutch.
For C#/.NET coding conventions please refer to the Microsoft conventions:
https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/inside-a-program/coding-conventions
For variable naming please refer to:
https://docs.microsoft.com/en-us/dotnet/standard/design-guidelines/general-naming-conventions
The files structure of the project looks like this.
3DAmsterdam
├── README.md
├── .gitattributes
├── .gitignore
├── docs
| ├── gettingstarted.md #Getting started with a new manucipality
| ├── assetgeneration.md #How to generate assets for the 3D layers
| └── faq.md #Frequently asked questions
├── 3DAmsterdam #Main Unity project folder
| └──Assets
| ├──3DAmsterdam #Amsterdam specific config, scenes and assets
| ├──Netherlands3D #Shared assets used by 3DUtrecht and 3DAmsterdam that may be moved to the Netherlands3D package
| └──WebGLTemplates #Special Unity folder containing our Netherlands3D fullscreen WebGL template
To set-up a project for a new municipality or city, please refer to the Netherlands3D repository.
The project uses the new Unity input system called Input Action Assets. The input mappings are defined in
\Assets\Netherlands3D\Input\3DNetherlands.inputactions
This will then generate a c# class that will be used in
\Assets\Netherlands3D\Input\ActionHandler.cs
The platform uses a tile based system consisting of 1km by 1km tiles. The handling of the tiles is initiated by the TileHandler which resides under the /Layers in the scene and needs to be configured with the active Layers that implement the Layer baseclass.
We currently have 4 implemented Layers which are
- Buildings
- Trees
- Sewerage
- Terrain
Each Layer script needs implement the HandleLayer method. This function receives a TileChange variable that provides the RD X and Y coordinate and an action.
The available actions are
- Create (create the tile)
- Upgrade (the Level of detail increases)
- Downgrade (the Level of detail decreases)
- Remove (remove the tile)
The 3D tiles used by the Tile System can be generated by the TileBakeTool. You can find this tool in its own repository: https://github.com/Amsterdam/CityDataToBinaryModel
If you like to contribute to 3DAmsterdam we encourage you to do so via the open source Netherlands3D repository; a modular Unity package containing functionalities independant of 3DAmsterdam that are useful for other municipalities: https://github.com/Amsterdam/Netherlands3D
Copyright (C) X Gemeente
X Amsterdam
X Economic Services Departments
Licensed under the EUPL, Version 1.2 or later (the "License");
You may not use this work except in compliance with the License.
You may obtain a copy of the License at:
https://github.com/Amsterdam/3DAmsterdam/blob/master/LICENSE.txt
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" basis,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied. See the License for the specific language governing
permissions and limitations under the License.
DXF export library - Lesser General Public Licence
Sun Script - Credits to Paul Hayes
3D BAG - CC-BY licentie (TU Delft)
BruTile (only used for its Extent struct) - Apache License 2.0
Simple SJON - MIT License
Mesh Simplifier - MIT License
Clipping Triangles - MIT License
scripts/extentions/ListExtensions.cs - MIT License
Scripts/RuntimeHandle derivative work - MIT License
quantized mesh tiles (no longer used) - MIT License
JSZip - MIT License