UD-Viz is an Demonstrations illustating some usages of the UD-Viz JS library.

The following sub-directories hold pure front-end indenpedent applications

DemoFull: client application (working with vanilla http server)
ImuvEditor: client application (working with vanilla http server)

In opposition Imuv is a front-end application requiring ImuvServer its back-end node application providing an http server and a websocket communication layer (expecting Imuv client connections),

• Ubuntu

  • Install and update npm

    sudo apt-get install npm    ## Will pull NodeJS
    sudo npm install -g n     
    sudo n latest

  • References: how can I update Nodejs, and install Ubuntu

• Windows

  • Installing from the installer

  • Installing with the CLI

    iex (new-object net.webclient).downstring(‘https://get.scoop.sh’)
    scoop install nodejs

In order to install the pure front-end demos

• enter the chosen sub-directory,
• launch npm install (to install the demo package dependencies),
• run the demo with npm run debug command,
• eventually open http://localhost:8000/ with your favorite (web) browser.

For example the DemoFull application can be locally (on your desktop) started in the following way

cd DemoFull
npm install
npm run debug      # integrates building

and then use your favorite (web) browser to open http://localhost:8000/.

Note that technically the npm run debug command will use the webpack-dev-server npm package that

• runs node application that in turn launched a vanilla http sever in local (on your desktop)
• launches a watcher (surveying changes in sources)
• in case of change that repacks an updated bundle
• that triggers a client (hot) reload

Notes: TO BE CHECKED !

• If you want to change the listening port use

  npm run debug -- --port=8081

• if you want this server to be visible from another host (than the one running this npm based server) then (as documented in this issue) use

  npm run debug -- --host=0.0.0.0

  or alternatively

  npm run debug -- --host=<the_host_IP_number>

FIXME: unmature section

Some modules used by the DemoFull require some server-side components to be installed on some server (possibly your desktop). For example

• the 3D objects (buildings) are (by default) serverd by a LIRIS server and thus require no specific configuratione there is nothing more to do
• handling of documents will require you to install the API_enhanced_city.
• you can also modify the application configuration file