ewatercycle/cesium-ncwms repository overview

⁠Cesium-NcWMS

Cesium (cesiumjs.org) based visualization using ncWMS to serve NetCDF data and D3 (d3js.org) to display graphs.
A live running version of this software can be found here: http://forecast.ewatercycle.org⁠

⁠Getting started (windows, from scratch)

1. Install Git : http://git-scm.com/downloads⁠
2. Install Node.js : http://nodejs.org/⁠ (Make sure add node to PATH option is checked)
3. Create '$HOME/npm' folder (Where $HOME is c:\Users<username>\AppData\Roaming).
4. Open node command prompt and run npm install -g bower grunt-cli
5. Install Apache Tomcat (http://tomcat.apache.org/⁠) 8.0 or higher.
6. Add C:\Users{YOUR USERNAME HERE}\node_modules\bower\bin to your PATH
7. Start Git bash
8. Change directory to your "apache tomcat installation directory"/webapps/ROOT
9. Type: "git clone https://github.com/NLeSC/Cesium-NcWMS.git⁠"
10. Type: "cd Cesium-NcWMS"
11. Type: "npm install -g grunt grunt-cli"
12. Type: "npm install"
13. Type: "bower install"
14. Type: "bower update"
15. Copy the ncWMS-2.0-rc1.war from the ncWMS_dist directory to your apache-tomcat/webapps directory.
16. Edit the tomcat-users.xml in your apache-tomcat/conf directory and add ncWMS-admin as a role to your username
17. Serve some netcdf data with ncWMS via the admin interface, make sure it is CF-1.7 compliant.
18. Edit the serverconfig.json file in the app/ subdirectory to reflect the location of your ncWMS server.
19. Type: "grunt serve"

⁠Getting started (Linux, Debian and Ubuntu based)

⁠Prerequisites:

1. nodejs, http://nodejs.org/⁠
2. bower, http://bower.io⁠
3. Java Development Kit, https://www.java.com/⁠

⁠Installation:

⁠Install nodejs

Follow instructions at joyents github website: https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager#debian-and-ubuntu-based-linux-distributions⁠

⁠Install bower and grunt-cli globally

sudo npm install -g bower grunt-cli

⁠Fetch git repository

git clone https://github.com/NLeSC/Cesium-NcWMS.git

⁠Install Apache Tomcat

1. Go to http://tomcat.apache.org/⁠ and install version 8.0 or higher.
2. Copy the ncWMS-2.0-rc1.war file from the ncWMS_dist directory to your apache/webapps directory.
3. Edit the tomcat-users.xml in your apache-tomcat/conf directory and add ncWMS-admin as a role to your username.
4. Edit the serverconfig.json file in the app/ subdirectory to point to the location of your ncWMS server.

⁠setup with bower

cd Cesium-NcWMS
npm install
bower install

If you already have a installed the bower packages before, but need to update them for a new version of the code, run

bower update

⁠Start development server & open browser

grunt serve

Changes made to code will automatically reload web page.

⁠Run unit tests

grunt test

Generates test report and coverage inside test/reports folder.

⁠Build a distro

grunt build

The dist folder has production ready distribution.

⁠Copyrights & Disclaimers

Cesium-NcWMS is copyrighted by the Netherlands eScience Center and releases under the Apache License, Version 2.0.

See http://www.esciencecenter.nl⁠ for more information on the Netherlands eScience Center.

See the "LICENSE" file for more information.