Skip to content

Commit

Permalink
Merge branch 'toniof-xxx-fix-romania_ts' into main
Browse files Browse the repository at this point in the history
  • Loading branch information
TonioF committed Aug 19, 2024
2 parents c49e000 + 77ef0a9 commit 8864794
Show file tree
Hide file tree
Showing 27 changed files with 557 additions and 148 deletions.
138 changes: 138 additions & 0 deletions HELP.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,138 @@

Dashboard App
==========

The Dashboard Application offers users an accessible and visually appealing interface
for browsing and analyzing varied datasets using interactive visualizations.

Functionality
=============

The dashboard provides access to a range of functions such as weather forecasts, time
series, scatter plots, point and line graphs, and trajectory displays. It allows for
faster load times and smoother user interactions, benefiting the overall experience
for users.

<!-- <img src="doors_dashboards/assets/_static/screenshot_dashboard_selection_pnl.png"
alt="Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Dashboard](doors_dashboards/assets/_static/screenshot_dashboard_selection_pnl.png)

The dashboard visualizes data from the datasets on top of a basemap.
For zooming hover the mouse on map and the buttons in the top right corner will show
up or the zooming function of your computer mouse.In the upper left corner a
corresponding legend to the mapped collection is available.

<!-- <img src="doors_dashboards/assets/_static/screenshot_map_window_features.png"
alt="Bulgaria Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Bulgaria Dashboard](doors_dashboards/assets/_static/screenshot_map_window_features.png)

To view different/single collections on map using `legend` double-click on one of
collection in the `legend` and only that collection will be shown on map amd other
will be disbaled. Similary to get back all the collection points on map then again
double on earlier selected collection.

<!-- <img src="doors_dashboards/assets/_static/screenshot_map_legend.png"
alt="Legend Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Legend Dashboard](doors_dashboards/assets/_static/screenshot_map_legend.png)

To change the map theme click on the `Settings` button symbol. `Carto Positron` is
default map theme applied.

<!-- <img src="doors_dashboards/assets/_static/screenshot_map_setting.png"
alt="Settings Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Settings Dashboard](doors_dashboards/assets/_static/screenshot_map_setting.png)


An individual dashboard can have different collections which you can select
via the drop-down menu `Collection`. If you choose a collection, the graphs will update
to display the correct data for that selection.

<!-- <img src="doors_dashboards/assets/_static/screenshot_collection_drp.png"
alt="Collection exp Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Collection exp Dashboard](doors_dashboards/assets/_static/screenshot_collection_drp.png)

If more than one variable is available within a selected collection,
you may change the variable by using the drop-down menu `Variable` on the right side
of dashboard in visualization area.

<!-- <img src="doors_dashboards/assets/_static/screenshot_variable_drp.png"
alt="Variable exp Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Variable exp Dashboard](doors_dashboards/assets/_static/screenshot_variable_drp.png)

To view data for certain time periods, use the `Time range` option at the top of the
graph. This will allow you to view selective data for the specified variable. The
`Time Slider` at the bottom of the graph allows for seeing various periods of data by
moving it left or right.

<!-- <img src="doors_dashboards/assets/_static/screenshot_time_range.png"
alt="Time range Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Time range Dashboard](doors_dashboards/assets/_static/screenshot_time_range.png)

The visualisation depends on the data in collection and use case so for some
collections the visualisation will be different like line plot and point plot.

<!-- <img src="doors_dashboards/assets/_static/screenshot_georgia_dashboard.png"
alt="Georgia Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Georgia Dashboard](doors_dashboards/assets/_static/screenshot_georgia_dashboard.png)

If more than one cruise is available within a selected collection,
you may change the cruise by using the drop-down menu `Cruise` on the right side
of dashboard in visualization area.

<!-- <img src="doors_dashboards/assets/_static/screenshot_cruise_drp.png"
alt="Cruise Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Cruise Dashboard](doors_dashboards/assets/_static/screenshot_cruise_drp.png)

If more than one station is available within a selected cruise,
you may change the station by using the drop-down menu `Station` on the right side
of dashboard for scatter point plot graph in visualization area.

<!-- <img src="doors_dashboards/assets/_static/screenshot_station_drp.png"
alt="Station Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Station Dashboard](doors_dashboards/assets/_static/screenshot_station_drp.png)

The selected station from the dropdown will be highlighted on the map to get an idea
about the station location.

<!-- <img src="doors_dashboards/assets/_static/screenshot_selected_station.png.png"
alt="Selected Station Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Selected Station Dashboard](doors_dashboards/assets/_static/screenshot_selected_station.png)

To adjust the variables displayed on the scatter plot, use the 'X-Var' drop-down menu
located on the right side of the dashboard above point plot. This menu allows you to
select the variable you want to display on the X-axis. Once you make a selection, the
scatter plot will automatically update to reflect the new comparison.

<!-- <img src="doors_dashboards/assets/_static/screenshot_xvar_drp.png"
alt="Xvar Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Xvar Dashboard](doors_dashboards/assets/_static/screenshot_xvar_drp.png)

Similarly, for y variable select a variable from dropdown `Y-Var` on the right side
of dashboard above point plot graph.

<!-- <img src="doors_dashboards/assets/_static/screenshot_yvar_drp.png"
alt="Yvar Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Yvar Dashboard](doors_dashboards/assets/_static/screenshot_yvar_drp.png)

When hovering over the on graph area on right side of the dashboard, the menu for
graph appears. Download the graph as PNG by clicking on the camera button. The axis
can be zoomed in using zoom functionality. Zoom button are provided to zoom in and
out on the graph.

<!-- <img src="doors_dashboards/assets/_static/screenshot_graph_menu_highlight.png"
alt="Graph Menu Dashboard" style="width:60em;display:block;margin-left:auto;
margin-right:auto"/> -->
![Graph Menu Dashboard](doors_dashboards/assets/_static/screenshot_graph_menu_highlight.png)
3 changes: 1 addition & 2 deletions configs/blocklist.txt
Original file line number Diff line number Diff line change
@@ -1,2 +1 @@
tr1
ro1
tr1
26 changes: 13 additions & 13 deletions configs/ro1.yml
Original file line number Diff line number Diff line change
Expand Up @@ -63,19 +63,19 @@ features:
# - "coccolithus sp.3 (18) b[mg/m^3]"
- "coronosphaera mediterranea b[mg/m^3]"
- "emiliania huxleyi b[mg/m^3]"
- id: Chlorophyll-a_HPLC_1
type: geodb
params:
title: "Chlorophyll-a HPLC Cruise 1"
collection: Chlorophyll-a_HPLC
database: DOORS_Cruise_1_USTIR
color: purple
levels:
- "station"
- "sampling_depth[m]"
label: station
variables:
- "chla[mg m^-3]"
# - id: Chlorophyll-a_HPLC_1
# type: geodb
# params:
# title: "Chlorophyll-a HPLC Cruise 1"
# collection: Chlorophyll-a_HPLC
# database: DOORS_Cruise_1_USTIR
# color: purple
# levels:
# - "station"
# - "sampling_depth[m]"
# label: station
# variables:
# - "chla[mg m^-3]"
components:
scattermap:
scattermap:
Expand Down
26 changes: 26 additions & 0 deletions configs/ro2.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
id: ro2
title: Romania Bathymetry
#eez: RO_eez
features:
- id: Bathymetry_good
type: geodb
params:
title: "Bathymetry"
collection: Bathymetry_good
database: doors-geoecomar
color: blue
# levels:
# - "spotter id"
variables:
- 'raw depth (hi)'
- 'corrected depth'
components:
scattermap:
scattermap:
placement: left
selectcollection:
selectcollection:
placement: top
timeplots:
timeplots:
placement: right
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
156 changes: 156 additions & 0 deletions doors_dashboards/assets/help.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,156 @@
Dashboards App
==============

The Dashboards Application offers users an accessible and appealing interface
for browsing and analyzing varied datasets using interactive visualizations.
The datasets that can be visualized with the Dashboards App are vector data, such as
in-situ measurements.
Any such dataset within the Dashboards App is called a collection.

The Dashboards Application is a collection of several dashboards.
Each dashboard consists of different elements - so far, each one at least of a map -
and may handle different collections.
Other elements are typically plots that may help to gain further insight into a
collection.
The overview button in the top left brings up the available dashboards.

<p align="center">
<img src="../assets/_static/screenshot_dashboard_selection_pnl.png"
alt="Dashboard" style="width:50em;"/>
</p>


Functionality
=============

The Dashboards App provides access to a range of functions such as weather forecasts,
time series, scatter plots, point and line graphs, and trajectory displays.
It allows for fast load times and smooth interactions, benefiting the overall experience
for users.

The Base Map
------------

The Map is the one element that you may find in every dashboard.
It will either show locations from elements of one or more collections,
or other specifically denoted locations.
To zoom, either use the buttons in the top right bar of the map (becomes visible on
hovering) or your mouse wheel.

<p align="center">
<img src="../assets/_static/screenshot_map_window_features.png"
alt="Bulgaria Dashboard" style="width:50em;"/>
</p>

A dashboard visualizes data from the datasets on top of a basemap.
For zooming hover the mouse on map and the buttons in the top right corner will show
up or the zooming function of your computer mouse.
In the upper left corner a legend to the mapped collection is available.
To toggle the display of collections on the map, click a collection's name in the
upper left corner.
Double-clicking will cause that only the selected collection is shown, another
double-click brings up the other collections again.

<p align="center">
<img src="../assets/_static/screenshot_map_legend.png"
alt="Legend Dashboard" style="width:50em;"/>
</p>

To change the map theme click on the `Settings` button on the top right of the app.
`Carto Positron` is the default map theme applied.

<p align="center">
<img src="../assets/_static/screenshot_map_setting.png"
alt="Settings Dashboard" style="width:50em;"/>
</p>

Plots
-----

When the dashboard offers also plots in addition to the map, you can switch between
collections via the drop-down menu `Collection`.
If you choose a collection, the graphs will update to display the correct data for
that selection.

<p align="center">
<img src="../assets/_static/screenshot_collection_drp.png"
alt="Collection exp Dashboard" style="width:50em;"/>
</p>

If more than one variable is available within a selected collection,
you may change the variable by using the drop-down menu `Variable` on the right side
of dashboard in visualization area.

<p align="center">
<img src="../assets/_static/screenshot_variable_drp.png"
alt="Variable exp Dashboard" style="width:50em;"/>
</p>

In the time range plot, to view data for certain time periods, use the `Time range`
option at the top of the graph.
This will allow you to view selective data for the specified variable.
The `Time Slider` at the bottom of the graph allows for seeing various periods of data
by moving it left or right.

<p align="center">
<img src="../assets/_static/screenshot_time_range.png"
alt="Time range Dashboard" style="width:50em;"/>
</p>


Some dashboards will offer more than one plot, like this one who offers a line and a
scatter plot, to better allow to explore the data.

<p align="center">
<img src="../assets/_static/screenshot_georgia_dashboard.png"
alt="Georgia Dashboard" style="width:50em;"/>
</p>


If more than one cruise is available for a collection,
you may change the cruise by using the drop-down menu `Cruise`.

<p align="center">
<img src="../assets/_static/screenshot_cruise_drp.png"
alt="Cruise Dashboard" style="width:50em;"/>
</p>

If more than one station is available for a selected cruise,
you may change the station by using the drop-down menu `Station`.

<p align="center">
<img src="../assets/_static/screenshot_station_drp.png"
alt="Station Dashboard" style="width:50em;"/>
</p>


The selected station will be highlighted on the map.
Likewise, if you select a location on the map, the plots will be updated accordingly.

<p align="center">
<img src="../assets/_static/screenshot_selected_station.png"
alt="Selected Station Dashboard" style="width:50em;"/>
</p>


To adjust the variables displayed on the scatter plot, use the `X-Var` and `Y-Var`
drop-down menus.
These allow you to select the variables you want to display on the X- and Y-axis,
respectively.
Once you make a selection, the scatter plot will update.

<p align="center">
<img src="../assets/_static/screenshot_xvar_drp.png"
alt="Xvar Dashboard" style="width:50em;"/>
</p>


For each plot, there is a button bar in the top right.
You can download a graph as png by clicking on the camera button.
There is also functionality to zoom in and out, reset axes, and to pan.

<p align="center">
<img src="../assets/_static/screenshot_graph_menu_highlight.png"
alt="Graph Menu Dashboard" style="width:50em;"/>
</p>

Loading

0 comments on commit 8864794

Please sign in to comment.