UD-Viz : Urban Data Vizualisation

UD-Viz is a javascript mono repository for creating web applications for visualizing and interacting with geospatial 3D urban data.

Online documentation — Developers — License — Getting Started — Architecture

Online demos:

3D tiles related

Directory Hierarchy

UD-Viz (repo)
├── bin                       # Monorepo scripts
├── docs                      # Documentation
├── examples                  # Examples of the ud-viz framework
├── test                      # Monorepo test scripts
├── packages                  # Packages folder
├── .eslintrc.js              # Linting rules and configuration
├── .gitignore                # Files/folders ignored by Git
├── .prettierrc               # Formatting rules
├── travis.yml                # Continuous integration entrypoint
├── favicon.ico               # Landing page icon
├── index.html                # Landing page entrypoint
├── package-lock.json         # Latest npm package installation file
├── package.json              # Global npm project description
├── Readme.md                 # It's a me, Mario!
├── style.css                 # Landing page style

Github repositories:

Repository	Link	Description
UD-Viz-docker	https://github.com/VCityTeam/UD-Viz-docker	Docker, which performs all the steps described in Getting Started.
UD-Viz-template	https://github.com/VCityTeam/UD-Viz-template	A basis for creating your application using UD-Viz.

Getting Started

Installing node/npm

For the node/npm installation instructions refer here

UD-Viz has been reported to work with versions:

node version 18.X
npm version: 9.X

Installing the UD-Viz framework per se

Clone the UD-Viz repository and install requirements with npm

git clone https://github.com/VCityTeam/UD-Viz.git
cd UD-Viz
npm install # resolve dependencies based on the package.json (and package-lock.json if it exists)

Install ImageMagick and GraphicsMagick

For the install imagemagick and graphicsmagick binary sub dependencies since the server needs gm.

Linux

 sudo apt-get install -y imagemagick graphicsmagick

Windows
- It seems not necessary to install imagemagick on windows.
- Download and install graphicsmagick from graphicmagick-binaries (@ud-viz/game_node_template has been reported to work with version 1.3.34-Q8)
⚠️ TIP : allias gm doesn't work in powershell because it conflicts with the command Get-Member !!!!

OSX

brew install imagemagick graphicsmagick

How to run it locally?

npm run start

After running go to localhost:8000 which links to documentation and examples