73 lines
2.3 KiB
Markdown
73 lines
2.3 KiB
Markdown
# TwinCity
|
||
|
||
**Mixed Reality Digital Twin city simulation**
|
||
Developed as part of the course *Design for Complex and Dynamic Contexts (DCDC)* at Stockholm University (SU), Spring 2025.
|
||
|
||
---
|
||
|
||
## 📍 Overview
|
||
|
||
**TwinCity** is an experimental Mixed Reality (MR) platform that overlays a real-time 3D model of a city using Unity, Cesium for Unity, and Google Photorealistic 3D Tiles. The system serves as a collaborative emergency response environment, enabling users to explore, simulate disasters, and coordinate interventions inside a Digital Twin of a real-world location.
|
||
|
||
This project was developed by a four-person team at SU to explore concepts of:
|
||
- Mixed Reality spatial interfaces
|
||
- Collaborative interaction and role-based interdependence
|
||
- Digital Twins as real-time responsive environments
|
||
|
||
---
|
||
|
||
## 🔧 Technologies Used
|
||
|
||
- **Unity 6 LTS**
|
||
- **Cesium for Unity**
|
||
- **Google Maps 3D Tiles API**
|
||
- **Meta XR SDK** (Passthrough + Hand Tracking)
|
||
- **Photon Fusion** (Multiplayer Framework)
|
||
- **Visual Studio Code + GitHub**
|
||
|
||
---
|
||
|
||
## 🧪 Features (in development)
|
||
|
||
- ✅ 3D photorealistic Digital Twin city rendered in Unity
|
||
- ✅ Flood simulation using water plane or visual overlays
|
||
- ✅ MR interface with gesture-based navigation
|
||
- 🔄 Multiplayer interaction for emergency response roles
|
||
- 🔄 Visual indicators and alerts for dynamic events
|
||
- 🔄 Subscene placement and collision-aware environment
|
||
|
||
---
|
||
|
||
## 🎮 How to Run
|
||
|
||
> Requires Unity 6 LTS and Cesium for Unity setup.
|
||
|
||
1. Clone the repo: ```git clone https://github.com/<your-username>/twincity.git```
|
||
2. Open in **Unity 6**
|
||
3. Sign in to your **Cesium account**
|
||
4. Enter your **Google Maps API key** to load 3D tiles
|
||
5. Enter Play Mode
|
||
|
||
---
|
||
|
||
## 👥 Team
|
||
|
||
- **Andreas** – Backend, Unity architecture, repo management
|
||
- **Eman** – UI/UX design, Figma mockups, portfolio materials
|
||
- **Florian** – Lead Unity implementation, Cesium integration
|
||
- **Minhui** – Interaction design, XR design, Documentation, Testing, and Research
|
||
|
||
---
|
||
|
||
## 📁 License
|
||
|
||
This project is open source under the [MIT License](LICENSE).
|
||
|
||
---
|
||
|
||
## 💡 Acknowledgments
|
||
|
||
- Cesium for Unity: [https://cesium.com/unity](https://cesium.com/unity)
|
||
- Google Maps Photorealistic Tiles
|
||
- Original concept inspiration: [YouTube Video](https://www.youtube.com/watch?v=lLw5hCqSv5Y)
|