Skip to content
Giovanni Lughi edited this page May 13, 2021 · 3 revisions

rer3d-map provides some particular functions that can be used with specific data.

For more information see the TerriaJS guide and the catalog item reference.

CSV

rer3d-map can load CSV (Comma Separated Values) files. If the CSV file contains columns lat and lon it's loaded as a layer of points (a point for each row), otherwise it's loaded as a tabular layer without geographic entities.

Example of tabular CSV

x	 z	plant height
1	-1	     2
3	-3	     4
5	-5	     6
7	-7	     3
10	-10	     9
12	-12	     2

Example of CSV of point

lat	lon        value
-40	140         125
-39	139         365
-38	135         74
-37	145         1428
-37.5	145         0
-37	145.5       4
-40	135         64

Polling

In case a catalog item is changes over time, its layer can be updated in rer3d-map setting a polling in catalog definition.

{
  "name": ...,
  "type": ...,
  "url": ...,
  "polling": {
    "seconds": 20, // the number of seconds to wait before polling for new data
    "url": ..., // string of the resource url or path
    "replace": true // true if new polled data should replace existing data, false if should be appened
  }
}

Custom style

When a CSV of points is loaded in rer3d-map its appearance is setted using some default values. In catalog you can define display properties adding the tableStyle property. With tableStyle you can define static or dynamic (linked to some CSV column) style. For more information tabular data customizing appearance overview.

Example of CSV catalog item with tableStyle property.

{
  "name": "Auto Incidents No Time (CSV)",
  "type": "csv",
  "url": "test/incidents_notime.csv",
  "tableStyle": {
    "colorMap": [
    {
      "color": "hsla(60,80%,80%,1.00)",
      "offset": 0
    }
]}},

Chart

If first column of a CSV is a number or timestamp, its data can be represented as a chart, without any configuration. Chart will open automatically at the bottom of the window. In workench on the left you can choose which columns of CSV draw in chart.

Example of tabular CSV with timestamp

Time	                     Capacity	Power
2015-10-19T00:10:00+1000	0.1	0.085
2015-10-19T01:15:00+1000	0.2	0.14
2015-10-19T02:20:00+1000	0.3	0.3
2015-10-19T03:25:00+1000	0	0
2015-10-19T04:30:00+1000	0.1	0
2015-10-19T05:35:00+1000       -0.4	0
2015-10-19T06:40:00+1000	0.4	0.3
2015-10-19T07:45:00+1000	0.1	0.1

CSV chart

Timeseries

rer3d-map can handle time informations of layers, if any.

If a WMS has time dimension, in its catalog definition you should add showDatetimePicker and useOwnClock properties to use it.

Example of a WMS with time dimension.

{
  "name": "Rain Day AU",
  "layers": "rain_day",
  "url": "http://www.bom.gov.au/jsp/awra/thredds/wms/AWRACMS/deciles/year/rain_day.nc",
  "type": "wms",
  "maxRefreshIntervals": 9000,
  "showDatetimePicker": true,
  "useOwnClock": true
}

If a CSV has both lan/lon and time columns, time controls are displayed in rer3d-map interface so you can see and navigate data change over time.

Example of CSV with lan/lon and time columns.

Date	                Lat	Lon	        Magn	Hydrophones
30/08/1991 12:39:58	43.368	-125.577	215.1	3
30/08/1991 13:26:35	48.694	-129.007	225.38	3
30/08/1991 14:17:17	43.598	-128.728	216.18	5
31/08/1991 23:15:35	41.858	-125.856	222.39	4
01/09/1991 7:46:29	41.861	-125.835	219.83	5
01/09/1991 15:13:11	43.064	-127.784	215.44	4
01/09/1991 19:25:15	41.456	-126.037	221.48	5
02/09/1991 10:25:45	43.662	-128.728	234.23	5
03/09/1991 5:51:31	43.504	-128.557	228.46	5
03/09/1991 14:14:15	41.12	-126.175	221.96	5
03/09/1991 15:27:56	44.196	-130.162	220.49	5
03/09/1991 19:10:14	43.457	-128.584	224.63	3

CSV with time

Clone this wiki locally