Datasphere User Manual2022!01!31
Datasphere User Manual2022!01!31
The software programs described in this document KISTERS makes no warranty of any kind with regard
and the information contained in this document are to this material including, but not limited to, the
confidential and proprietary products of KISTERS or implied warranties or merchantability and fitness for
its licensors. KISTERS waives copyright for a particular purpose.
licensed software users to print out parts of the
documentation in hard copy for their own use only. KISTERS shall not be liable for any incidental,
This documentation may not be transferred, indirect, special or consequential damages
disclosed, or otherwise provided to third parties. whatsoever (including but not limited to lost profits)
In duplicating any part of this document, the arising out of or related to this documentation, the
recipient agrees to make every reasonable effort to information contained in it or from the use of
prevent the unauthorized use and distribution of the programs and source code that may accompany it,
proprietary information. even if KISTERS has been advised of the possibility
of such damages.
No parts of this work may be reproduced in any
form or by any means - graphic, electronic, or Any errors found in any KISTERS product should be
mechanical, including photocopying, recording, reported to KISTERS where every effort will be
taping, or information storage and retrieval systems made to quickly resolve the problem.
- without the written permission of the publisher.
Products that are referred to in this document may
KISTERS reserves the right to make changes in be either trademarks and/or registered trademarks
specifications and other information contained in of the respective owners. The publisher and the
this publication without prior notice. author make no claim to these trademarks.
Author: KISTERS
Date of print of current edition: 31/01/2022
1st edition
Current software version: 2.0.x
Table of Contents
Table of Contents
Index 77
KISTERS 3
Where Data Informs Decisions
You can easily share your own data with other stakeholders. datasphere is available everywhere and anywhere in
your web browser.
Manage your sensor network or other assets with datasphere’s easy-to-use monitoring dashboards and real-time
notifications. You benefit from the following features:
Easy Viewing
You can access your sensor and raster data easily anywhere from any device at any time. Maps and graphs with real-
time data as well as historical developments within your system are a good place to find current and recurring issues.
Alarming
Receiving real-time notifications might be essential for your business. With the easy-to-use alarm management, you
can set up individual thresholds and manage alarm recipients for your own sensors, but also on Open data or data
that have been shared with you. Thus every alarm goes to the right team so they can react accordingly. Statistics and a
historic record of alarms support you in learning the behaviour of your network and provide management information.
Subscribe in the blink of an eye to a wide range of open and commercial data that is available to help expand your
network quickly. It is also possible to share your own sensor data with other users via datasphere, privately within
datasphere or to users on the open Internet: This opens up a wide range of business opportunities and
collaborations for your organisation.
Better data means better decisions: This is why datasphere offers editing and validating tools for improving the quality
of your data.
Easily perform and persist extra analysis to your data or add forecast time series to them, issued from meteorological
or other models. Different kinds of tabular reports give you a summary of current and past sensor behaviour at the
click of a button. Knowing what happened in the past helps you shape your understanding of the future.
Watching
You can easily keep an eye on your sensor locations using webcams.
datasphere is the central hub for you where data are converted into information.
4 KISTERS
How To Work With datasphere
§ Locations 6
§ Dashboards 41
§ Alarm Event Status 45
§ Alarming 47
§ Channels 54
§ Account Settings 65
§ Time Series 70
§ RasterViewer 71
KISTERS 5
How To Work With datasphere
· Then enter your mail address and the password from the e-mail n the login dialog displayed above.
· You will be asked to modify your password.
· The login dialog will then be presented again where you log in with your new password.
· Then datasphere will be opened.
You can control your password by clicking on the eye symbol in the PASSWORD box.
Note: When you forgot your password, you may well retrieve it by clicking on the link Forgot password. A new
window opens and if you are already known as a User to the system (which implies a valid e-mail address is
known), your password will be resend to you.
§ Once you are logged in, you can log out of the application again by clicking on the drop down arrow on the upper
right menu item.
§ Select and confirm LOGOUT to leave the application again.
For any support questions, please refer to your account manager or send an email to [email protected].
2.2 Locations
This view displays your configured locations as a list 8 and in either a geographical map 29 or a table 31 . After
login and your locations having been set up, the first place to enter the software is here. Click the links for more
information.
6 KISTERS
How To Work With datasphere
Use this view as starting point for various features and actions described in the topics hereafter.
§ Locations List 8
§ Adding Locations 11
§ Time Series List 13
§ Time Series List Menu 14
§ Adding Time Series 18
§ Time Series Graph 20
§ Map 29
§ Table 31
§ Editing Time Series Values 32
§ Overlaid Plot 34
§ Basic Statistics 36
§ Forecasts 37
§ Adding Forecasts to the Dashboard 40
KISTERS 7
How To Work With datasphere
The list shows your configured locations. Use it to select one or various locations and their time series for further
analysis.
Filtering Locations
§ Enter filter strings for location names or tags to reduce the amount of displayed locations in the search box at the
top of the list.
§ Or click on the coloured tag behind the location name in the list to filter for locations with identical tags.
§ Click on SHOW ONLY MY LOCATIONS to filter for your own locations (all locations with the MY LOCATIONS tag).
§ Click on SHOW ONLY THIS CHANNEL to filter for locations of the respective channel (shared channels or from
open data sources).
§ Click on SHOW CHANNEL DESCRIPTION to display a textual information for the current channel in an overlay
window.
See Available Channels 63 for details on channels and their tags.
8 KISTERS
How To Work With datasphere
§ Click on a location name to expand the list to display the time series 13 being configured for the location with
more detailed information like the last value or configured alarm thresholds 50 .
KISTERS 9
How To Work With datasphere
This view will also indicate warnings if e.g. thresholds are exceeded.
10 KISTERS
How To Work With datasphere
Though under normal circumstances your system is automatically filled with the necessary location metadata and
time-series-based sensor data (by uploads using e.g. FTP, a REST API or automatic importers), it could become
necessary to add a location by hand to the map and system:
§ Click the button on the upper right side of the map.
§ Enter the location data in the dialog being displayed.
KISTERS 11
How To Work With datasphere
Element Description
General tab
Icon Icon for the location when being displayed in the map.
Elevation If desired, speify here the height of the location above sea level.
Adding a type will allow a number of fixed views to become available on top of the time
series list for that location type (e.g. ‘irrigation”).
External ID for data ID to be used to identify the location during data exchange.
exchange
12 KISTERS
How To Work With datasphere
Element Description
Metadata tab This tab contains some technical information about the location.
Note:
§ The same dialog is opened when editing location data using the [EDIT LOCATION] button of the locations list
details 9 or the button of the OPTIONS table column.
§ In order to have sensor data at the new location, you need to add the corresponding time series 18 . This can
be done manually using the Upload list function 16 ; for automatic uploads please contact your account
manager.
KISTERS 13
How To Work With datasphere
Note: Depending on user permissions 65 (upload and edit rights) the menu contains additional functions for
uploading, editing and similar time series operations.
14 KISTERS
How To Work With datasphere
Overlaid Plot Overlay your time series plots 34 to compare different time ranges of the same time
series. With this, you can spot differences, e.g. in temperature, water level, etc.
Liquid Fill Gauge Display the gauge of your currently selected time series in a widget.
Last Value Display the last value with date/time stamp of the selected time series in a widget.
Gauge Widget Display the gauge of your currently selected time series in a bar widget.
KISTERS 15
How To Work With datasphere
Heatmap Open the current time series in a heatmap. It shows different values in different colours,
thus indicating e.g. warm and cold temperatures or high or low water levels respectively.
Specify a fixed time range like 3 days or use the calendar to define a time range of data
for the heatmap.
Move the mouse over a field to get detailed information on the value.
Zoom in the heatmap holding the left mouse button and drawing a rectangle in the
heatmap. Zoom out again stepwise with the right mouse button.
Basic Statistics Start some basic statistical evaluations 36 for your data.
Upload Upload sensor data from CSV files. Use this function if you e.g. added a time series by
hand 18 and need to populate it with sensor data.
Either upload your time series data from file or paste values from the clipboard.
Paste values with UTC time stamp and value in two columns.
2021-07-19T01:00:00Z;89
16 KISTERS
How To Work With datasphere
2021-07-19T02:00:00Z;92
2021-07-19T03:00:00Z;97
2021-07-19T04:00:00Z;72
2021-07-19T05:00:00Z;67
2021-07-19T06:00:00Z;58
2021-07-19T07:00:00Z;52
2021-07-19T08:00:00Z;49
KISTERS 17
How To Work With datasphere
You can basically edit the same data as during creation of a new time series 18 .
Follow the link for detailed information on how to edit time series values.
Normally, time series are added to your locations in collaboration with your account manager in an automatic way.
Occasionally, e.g. when wanting to upload time series data as a one-off, you can add time series also manually in
order to prepare the data upload.
§ Click the [NEW TIME SERIES] button in the locations list details 9 .
§ Or use the button in the time series list.
§ Enter the data in the dialog being displayed.
18 KISTERS
How To Work With datasphere
Element Description
General tab
Note: If a larger interval is selected, datasphere will interpolate possible missing values
over that period.
External ID for data ID to be used to identify the time series during data exchange.
exchange
KISTERS 19
How To Work With datasphere
Element Description
Metadata tab This tab contains some technical information about the time series.
You can display your sensor data in a graph and a table. Use it for better visual control and to compare different
parameters and time series values.
Note: Graph and table are synchronised: If you click on a point in the graph, the corresponding value in the table is
marked. The same applies the other way round: If you select a certain entry in the table, the corresponding value is
selected in the graph.
§ Click on a time series name (in both the normal or expanded detail view 9 ) to display the time series values in a
graph.
§ Alternatively, click on next to the time series name to use the time series list menu 14 .
§ Adapt the data time range to be displayed according to your needs. Use the fixed ranges or define your own time
range using the calendar (from/to).
§ Add more time series to the graph by clicking on the time series names.
§ Use the graph legend to hide time series from display.
20 KISTERS
How To Work With datasphere
§ Remove time series from the graph by clicking again on the time series names in the list or using the X in the
legend.
§ Show or hide the control bar with .
§ Show or hide the table with the time series values with .
§ Add additional information to the graph with .
Note: The number of functions available here and also if the button is visible at all depends on your subscription to
analysis tools.
You can enrich your graph with the information described in the table hereafter.
Information Description
Mean This will add the mean value of your time series sensor data to the graph.
§ Select the time series for which to display the mean values.
§ Select the desired aggregation interval, e.g. days.
§ Select a colour for the mean values plot.
§ Confirm with [SAVE].
Total This will add the total value of your time series sensor data to the graph.
KISTERS 21
How To Work With datasphere
Information Description
Minimum This will add the lowest value of your time series sensor data to the graph.
Maximum This will add the highest value of your time series sensor data to the graph.
22 KISTERS
How To Work With datasphere
Information Description
Cumulation This will add the accumulation of your time series sensor data to the graph.
§ Select the time series for which to display the cumulative plot.
§ Select the desired aggregation interval, e.g. days.
§ Select a colour for the plot.
§ Confirm with [SAVE].
Degree Days Degree days use the daily mean value of a source time series and define the 'amount' of
degrees above or below a threshold value per day.
Specify the accumulation (e.g. degree days per single day of total). When the latter is
selected, a ‘reset’ date must be defined. This defines the date from which accumulation
is to be started.
§ Select the time series for which to display the degree days.
§ Select a colour for the plot.
§ Give the plot a name.
§ Select a unit in which to display the values.
KISTERS 23
How To Work With datasphere
Information Description
Long-Term Values Long-term statistics refer to a longer period of time such as >=10 years and compile
information over defined periods of time, such as 'mean monthly rainfall totals', which
allow statements such as 'the current July total was 20% higher than typical'.
§ Select the time series for which to display the long-term values.
§ Select a colour for the plot.
§ Give the plot a name.
§ Specify the analysis time range (last 10 years).
§ Define the statistics interval (like 10 days or a week).
§ Select a statistics type for the aggregated values (like minimum, maximum or totals).
§ Specify whether the long-term comparison should be based on minimum, maximum
or mean values.
§ Confirm with [SAVE].
Thresholds This will display the configured alarm thresholds 50 for the time series in the graph.
Different types 52 are above a threshold, below a threshold, normal divergence and
outdated values.
24 KISTERS
How To Work With datasphere
Information Description
Marking Line
KISTERS 25
How To Work With datasphere
Information Description
§ Either select the appropriate time series by preconfigured products and by parameter
or directly by parameter and corresponding product.
§ Select the forecast model run to visualise in the graph by date and by time stamp of
the run.
§ Select [ADD].
The forecast data are loaded into the graph.
Note: This may take a while.
More information on forecasts can be found here 37 .
§ To persist the analysis you performed, add them to a dashboard 41 you defined.
§ If you have not yet created a dashboard, learn from the Creating Dashboards 43 section how to do so.
§ You can download the data and save to different formats with the icon.
§ Add the currently open time series graph to your favourite dashboard 41 , if desired.
§ Close the graph with [X] on the right border of the display.
Plot areas
Adapt the graph's appearance and properties or create stacked plots with .
26 KISTERS
How To Work With datasphere
The PLOT AREAS tile displays all time series of the current graph.
§ Add plots with the respective link.
§ Define the settings for the new plot like its title and lower and upper fixed limits of the axis values in the respective
fields.
§ Use the information icon on each field for detailed information.
§ Move the time series between plots by dragging and dropping the legend entry.
Note: Stacked plots just have one Y axis. Rename the axis title and optionally mention that you visualise
information with different units.
§ When accepting with [OK], the time series will be rearranged in the graph according to the defined stacked plots.
KISTERS 27
How To Work With datasphere
Other options
§ Define here the chart background or border colour and add grid lines in horizontal and vertical direction.
§ You can also influence the spacing between plots.
§ Use the RESET links to set the different options back to defaults.
The result could look like this:
28 KISTERS
How To Work With datasphere
2.2.7 Map
As explained, the locations list and the map are the starting points for most of your worksteps.
The map displays your locations geographically and indicates states like warnings or alarms at the locations.
§ Move the mouse over a location for more detailed information:
§ Click on a location to open its detail data in the locations list 9 and the corresponding time series.
KISTERS 29
How To Work With datasphere
Overlay Description
My area This rectangle mainly covers your locations and the area for which open data are
available if you subscribed to them, provided they are available in that rectangle.
30 KISTERS
How To Work With datasphere
§ Use the zoom buttons and to zoom into the map and out again or simply use the mouse wheel inside the
map to zoom like known from other map software.
§ Use the button to download the currently displayed location data into a CSV file.
§ Add your current map display to your favourite dashboard 41 , if desired.
2.2.8 Table
§ Click the icon to display your locations in a tabular list.
KISTERS 31
How To Work With datasphere
§ Click the [DELETE] button to remove the currently edited location from the map and system.
While checking your sensor data for correctness and plausibility, it may become necessary to modify single or various
data.
§ Select EDIT from the time series list menu 14 of the respective time series.
§ Edit the data in the dialog being displayed. Each sensor data point is marked by a bullet in the graph.
Note: Graph and table are synchronised: If you click on a point in the graph, the corresponding value in the table is
marked. The same applies the other way round: If you select a certain entry in the table, the corresponding value is
selected in the graph.
32 KISTERS
How To Work With datasphere
The selected data points will be highlighted in black. The values are also selected in the table.
§ Now you can edit the time series values, their quality flags and add or edit remarks to the values.
§ Enter e.g. a value to be applied to the selected data points:
§ Use the arrow keys to increase (up), decrease (down) or set the selected data points to the entered value.
The graph will show the original values and the modified values in two plots (see the legend).
§ Select a quality for the selected value from the list.
KISTERS 33
How To Work With datasphere
§ Click the [SHOW PREVIEW IN TABLE] button to apply the remark to the values in the table.
§ Save your changes in the end with the button of the same name.
Note: After saving your changes, datasphere will allow to display both the original and the changed data for further
use.
You can compare different time ranges of the same time series to spot differences, e.g. in temperature, water level,
etc. Use this function to evaluate your data for differences e.g. between summer and winter or between months of a
year, etc.
§ Start from the locations list 8 .
§ In the first step, select the time range to overlay one time series range with another.
34 KISTERS
How To Work With datasphere
The dialog presents the available intervals according to the time range to overlay that was specified in the first
step.
KISTERS 35
How To Work With datasphere
You can display basic statistical values for your data like minimum, mean and maximum values in a graph and as
tabular list.
§ Start the function from the time series list menu 14 .
36 KISTERS
How To Work With datasphere
The display both of the graph and the table changes accordingly. Monthly and yearly statistics are displayed as
Box-Whisker plot with lower and upper quantiles.
§ Move the mouse over the values for detailed information.
2.2.12 Forecasts
Note:
§ Access to forecast time series at your locations is determined by your subscriptions and is further configurable by
your administrator/manager.
§ To persist the forecast time series in the graph, add it to a dashboard 40 .
Forecasts can be added in two ways:
§ First, with the ADD FORECAST TIME SERIES menu item of the icon in the graph 26 .
KISTERS 37
How To Work With datasphere
§ Either select the appropriate time series by preconfigured products and by parameter or directly by parameter
and corresponding product.
§ Select the forecast model run to visualise in the graph by date and by time stamp of the run.
§ Select [ADD].
The forecast data are loaded into the graph.
Note: This may take a while.
Different plot colours are used for the original data and the forecast data.
§ Again you have all the features at hand being explained above 20 .
§ The second way to load forecasts is to simply click the FORECASTS entry in the location details 9 of the
locations list 8 .
You will get a default forecast graph and table.
38 KISTERS
How To Work With datasphere
The display gives you an overview for a specific location and its main main parameters for the set forecast time
range.
The flyover displays the current values for the main parameters.
KISTERS 39
How To Work With datasphere
You can save the forecast graph and table with their currently active settings to your dashboard 41 and modify certain
settings.
Note: When saving you forecasts to your dashboards, you can modify the icon, the title and especially the time range
of the forecast!
§ So if your forecast comes with e.g. three days resolution, but you want a five-day resolution in the dashboard,
change the setting in the FORECASTED DAYS RANGE field from P3D (for period of 3 days) to P5D for 5 days.
§ Same of course for different hours (like P24H) or weeks (W) or months (e.g. P6M for a 6 month forecast time
range).
See an example for a forecast table:
§ Here the number of values per day was modified to 24 in the FORECAST VALUES PER DAY field.
§ Select in the USER SELECTED FORECASTS field the forecasts (time series) to be displayed in the dashboard
widget.
40 KISTERS
How To Work With datasphere
Note: The number of forecast fields configured here will be displayed in the forecast graphs and tables!
2.3 Dashboards
Dashboards display your favourite data elements and time series for monitoring purposes in a central view.
You can create and add new dashboards 43 from here and configure preferences 44 for your dashboards. Click the
links for more information.
§ To display and work with your existing dashboards, simply select your preferred dashboard from the menu item's
list to load it.
KISTERS 41
How To Work With datasphere
§ Arrange the widgets either by dragging and dropping with the mouse or automatically with the icon on the upper
right.
§ Move the mouse over the widget border and click to configure the dashboard widget.
§ Use the same settings as when adding you forecast widgets to your dashboards 40 .
Note that the configuration options depend on the type of widget that you added to your dashboard.
For the time series graphs it looks like this:
42 KISTERS
How To Work With datasphere
Before being able to add widgets to a dashboard 44 , the dashboard must be defined first.
§ To start this, select ADD from the DASHBOARDS menu.
Configure your dashboards in the DASHBOARD FACTORY dialog being displayed.
Element Description
Icon Class Select an icon for the dashboard from the list.
Layout
Layout type Description
Flexible
Absolute:
KISTERS 43
How To Work With datasphere
Note:
§ When saving you widgets to a dashboard, you can modify the icon, the title, the colour and e.g. the minimum or
maximum value to be displayed in the dashboard.
§ The settings to be changed depend on the data to be added to the dashboard, e.g. the type of time series.
See this example for a widget to add to a dashboard:
Depending on the time series or parameter, the dialog changes its appearance:
2.3.3 Preferences
You can configure the look-and-feel of your dashboards.
§ Select PREFERENCES from the DASHBOARDS menu.
§ Configure your dashboards in the dialog being displayed.
See Creating Dashboards 43 for details.
44 KISTERS
How To Work With datasphere
Element Description
Options
Option Description
Note: In responsive mode, the ALARM EVENT STATUS view is depicted by the icon .
KISTERS 45
How To Work With datasphere
This view basically displays in a graph the numbers of warnings, alarms and good values as defined in the threshold
configuration 50 . Besides all alarms are listed in a table as well as in an alarm feed .
Note that all three parts of the dashboard basically display the same information:
§ Click the single bars in the graph to open a detailed information window on the respective status.
46 KISTERS
How To Work With datasphere
§ Use the graph legend to hide good values, warnings or alarms from display.
§ Click the icon to open the location of the alarm notification in the geographical map 29 .
§ In the feed you can also double-click an entry to change to the locations in the map.
The corresponding time series will be automatically selected in the location list 8 and opened in the time series
graph 20 .
2.5 Alarming
The ALARMING view comprises some views for different aspects of alarming like threshold configuration or the
management of recipients for alarms and groups of them.
§ Recipients 48
KISTERS 47
How To Work With datasphere
§ Recipients Groups 49
§ Thresholds 50
All alarm notifications based on the existing threshold configurations 50 can be displayed in a list.
§ Select ALARM NOTIFICATIONS from the ALARMING menu.
You get a list of the existing alarm notifications.
§ You can filter the notifications and specify a time range for which to display the notifications (like all notifications of
the last seven days (7D) or the last year (1Y).
§ You can download the contents of the table using the icon.
2.5.2 Recipients
You can define the recipients that will receive alarm messages in case of warnings or alarms.
§ Select RECIPIENTS from the ALARMING menu.
You get a list of the already configured recipients in your system. For each recipient the table displays the
properties like name or e-mail address.
48 KISTERS
How To Work With datasphere
§ You can add new recipients, edit existing ones and delete them.
§ Add new recipients with the icon.
§ Enter the recipient data in the dialog being displayed.
§ Enter name, an optional description, the recipient's e-mail address and/or a telephone number for SMS text
messages.
Note that you can define recipients that receive alarm notifications only by SMS, only by e-mail or both.
§ Save the new recipient.
§ To edit an existing recipient, click the icon behind the desired recipient in the table.
The dialog being displayed looks like the one for new recipients. It additionally contains information about the date
and time of the creation and the person who created the recipient. Also the date of the last modification of the data
set is displayed as well as the person who last edited the data set.
§ Modify the desired data and save.
§ To delete an existing recipient, click the red [DELETE] button.
§ Alternatively use the icon in the table.
You can subsume your configured recipients 48 under groups that will receive alarm messages in case of warnings
or alarms.
§ Select RECIPIENTS GROUPS from the ALARMING menu.
You get a list of the already configured recipient groups in your system.
KISTERS 49
How To Work With datasphere
2.5.4 Thresholds
You can configure alarm thresholds for your locations and time series where warnings or alarms are triggered. You
can add new thresholds 50 , edit 50 existing ones and delete 50 them. Different types 52 are above a threshold,
below a threshold, normal divergence and outdated values.
Note that these configurations will trigger alarm notifications 48 . They also influence the content of the dashboard for
the alarm event status 45 .
The thresholds configured here can be displayed in the locations list 9 on a separate tab and in the time series
graph 24 as additional information.
50 KISTERS
How To Work With datasphere
Adding Thresholds
KISTERS 51
How To Work With datasphere
Element Description
Note: This box is not displayed if you add thresholds directly from out of the locations
list 9 .
Time Series Select the time series for which to define a threshold.
No: You will not be warned. Your threshold configuration is nevertheless saved.
Threshold Type
Type Description
52 KISTERS
How To Work With datasphere
Element Description
Type Description
Outdated Warnings and alarms are triggered, if the time stamp of the data is
Value too old.
Level Matrix Specify the range of values that are evaluated as being good or that will trigger a
(Undefined, Alarm, warning or even an alarm.
Warning, Good,
Undefined) As explained above 29 , the alarm notification according to the classes configured
here can be identified directly in the map at the location.
Note: Values above the upper alarm threshold and below the lower threshold for good
values are judged as undefined.
Recipient Group Select a recipient group 49 . The alarm notifications based on the current threshold
configuration will be sent to the members of this group based on their communication
medium: by e-mail or by text message (SMS).
Show in Alarm Yes: Alarm notifications based on the current threshold are listed unter Alarming >
Overview Alarm Notifications 48 .
No: The current threshold is not taken into account for the alarm notification list.
Use in Channel Yes: Your defined alarms will be displayed in any public channels where you have
defined locations and time series with thresholds.
No: Your defined alarms will not be displayed in any public channels.
§ To edit an existing threshold, click the icon behind the desired threshold entry in the table.
KISTERS 53
How To Work With datasphere
Deleting Thresholds
§ To delete an existing threshold, use the icon in the tabular list of thresholds.
2.6 Channels
Channels are used to share data with other parties. For this you need to define channels of different types 55 .
Channels can be private, public (shared), open or anonymous.
You can display overviews about the channels that you are subscribed to 61 or a complete list of all channels being
available 63 for you or a list of organisations 64 you can share data with. You can also copy your sharing key 64 to
provide it to organisations that want to subscribe to your channels.
§ Available Channels 63
§ Organisations 64
§ Your SharingKEY 64
54 KISTERS
How To Work With datasphere
2.6.1 My Channels
You as an organisation can create channels from where you share your data with other people or organisations. You
can add new channels 55 , edit 55 existing ones and delete 55 them. Click the links for more information.
§ Select MY CHANNELS from the CHANNELS menu.
You get a list of the channels that you use to share your data with others.
§ Like known from other tabular views in datasphere, enter filter strings to reduce the amount of displayed channels
in the search box at the upper right side of the list.
§ Sort the table content by clicking on the header (ascending or descending).
§ Display or hide table columns with .
Adding Channels
KISTERS 55
How To Work With datasphere
Element Description
Channel Type
Type Description
shared A default channel that you can use to share your data of e.g. your
demo site with other organisations or persons.
56 KISTERS
How To Work With datasphere
Element Description
Type Description
public A shared channel from where you can publish your data to
unidentified users.
open An open channel contains data that stem from open or public
places or organisations like the German DWD or the UK EA.
anonymous This channel type is an open channel not revealing the originator's
name.
Features Check the ALARMING box if you want the current channel to be part of the alarm
notification system 47 .
§ Go to the TIME SERIES tab and define the time series to be published by the new channel.
Note: If you do not define time series, your new channel remains empty. See the TIME SERIES COUNT column
of the channel list.
KISTERS 57
How To Work With datasphere
§ You can filter the amount of displayed time series in the search box at the upper right of the list either by
location names or by parameter names.
Air for example will reduce the list of channels to those being assigned to a parameter wit Air in its name or
to locations containing Air in their name.
§ Then check the boxes of those time series you want to add to the new channel.
58 KISTERS
How To Work With datasphere
KISTERS 59
How To Work With datasphere
§ The sharing count in your channel list will show the result of this action.
Note: As a result of this action, the organisation you share your data with will find your organisation in its
Available Channels 63 view. The channel is also added to the locations list 13 of the organisation, provided it
has subscribed the channel from the list of available channels (simply done by clicking the asterisk in the
OPTIONS column).
§ Go to the TIME SERIES tab and modify the time series to be published by the new channel.
§ If appropriate, go to the SHARED WITH tab and modify the organisations to share your data with.
Deleting Channels
§ To delete an existing channel, click the icon in the table list behind the channel to be deleted.
60 KISTERS
How To Work With datasphere
Options, View
§ Use the icon from the OPTIONS table column to open a separate page that describes the technical options
for using a public channel.
Each channel provides a certain set of features and information which is listed in tables on this separate page.
The page also offers preview links and an example call for the current channel.
In contrary to your channels others have access to 55 , you can get a list of all channels where you subscribed to. This
can include channels shared directly with you or channels where you subscribed to using the Available Channels 63
view. You can edit or remove channels from the list and control the visibility for other users of your entity in the
application.
Note: The locations of the channels you subscribed to, are displayed in your locations list 8 . Same is true for the
time series 13 of the locations.
§ Select SUBSCRIBED CHANNELS from the CHANNELS menu.
You get a list with all your subscribed channels.
KISTERS 61
How To Work With datasphere
§ Like known from other tabular views in datasphere, enter filter strings to reduce the amount of displayed channels
in the search box at the upper right side of the list.
§ Sort the table content by clicking on the header (ascending or descending).
§ Display or hide table columns with .
§ Edit the data of the current channel with .
§ Modify the title you use for the channel, the optional description, the icon that depicts your channel and the icon
colour.
§ If you want to unsubscribe from a channel, click .
62 KISTERS
How To Work With datasphere
You can get an overview about all channels being available for you in order to subscribe to them. After your
subscription they are listed in the Subscribed Channels 61 view.
Open channels can be accessed by any user within datasphere, as long as they are included under the subscribed
channels 61 . Public channels on the contrary can also be accessed outside of datasphere using public widgets.
§ Select AVAILABLE CHANNELS from the CHANNELS menu.
The list of available channels displays in the OPTIONS column, which channels you are already subscribed to.
Note: The entry in the TITLE column corresponds to the tag name in the locations list 8 .
§ Filter for e.g. only open channels:
§ Like known from other tabular views in datasphere, enter filter strings to reduce the amount of displayed channels
in the search box at the upper right side of the list.
§ Sort the table content by clicking on the header (ascending or descending).
KISTERS 63
How To Work With datasphere
2.6.4 Organisations
If you want to share your data with other organisations, you need their sharing keys. You can add the organisations by
entering their sharing keys here.
Note: If those other organisations want to subscribe to your channels, they need your sharing key. See Your
SharingKEY 64 for details.
§ Select ORGANISATIONS from the CHANNELS menu.
You get a list of organisations with imported sharing keys.
§ Like known from other tabular views in datasphere, enter filter strings to reduce the amount of displayed
organisations in the search box at the upper right side of the list.
§ Sort the table content by clicking on the header (ascending or descending).
§ Display or hide table columns with .
§ Add new organisations with the icon.
§ Enter the sharing key you received from the organisation where you want to share data with in the dialog being
displayed.
You can share your sharing key with other organisations by sending this key via e-mail to your contact persons. Once
they know your sharing key, they can share information with you.
§ Select YOUR SHARINGKEY from the CHANNELS menu.
You get information about your sharing key.
64 KISTERS
How To Work With datasphere
§ To let other organisations connect to your channels, copy your sharing key to the clipboard with the corresponding
button.
§ Then share this sharing key with this organisation(s) you want to share data with.
§ Provide an e-mail address to send the key to. Use whitespaces or comma, if you want to send to more than one
recipient.
Note: In responsive mode, the ACCOUNT SETTINGS view is depicted by the icon .
§ Quality Codes 69
2.7.1 Users
You can manage the users of your system. You can create new users for datasphere and invite users without
password specification.
§ Select USERS from the ACCOUNT SETTINGS menu.
You get a list of users that are configured in your system.
KISTERS 65
How To Work With datasphere
§ You can add new users, edit existing ones and delete them.
§ Add users with the icon.
§ Enter the user data in the dialog being displayed.
66 KISTERS
How To Work With datasphere
KISTERS 67
How To Work With datasphere
So this function avoids having to define a password for this new invited user.
§ To delete a user, use the icon in the table behind the user to be deleted.
You can manage the alarm classes to be used for your alarming system.
Note: We do not advise to delete alarm classes! Any changes made to the number or severity level of alarm classes
can lead to inconsistencies!
§ Select ALARM CLASS SETTINGS from the ACCOUNT SETTINGS menu.
You get a list of those alarm classes that are configured in your system.
68 KISTERS
How To Work With datasphere
§ To edit an existing alarm class, click the icon behind the desired class in the table.
§ Modify the desired data and save.
You can manage the time series quality codes to be used in your system.
§ Select QUALITY CODES from the ACCOUNT SETTINGS menu.
You get a list of quality codes that are configured in your system.
KISTERS 69
How To Work With datasphere
Normally, time series are added to your locations in collaboration with your account manager in an automatic way.
Occasionally, e.g. when wanting to upload time series data as a one-off, you can add time series also manually in
order to prepare the data upload.
Note: In responsive mode, the TIME SERIES view is depicted by the icon .
§ Select TIME SERIES from the menu.
You get a list of time series that are configured in your system.
§ Like known from other tabular views in datasphere, enter filter strings to reduce the amount of displayed time
series in the search box at the upper right side of the list.
§ Sort the table content by clicking on the header (ascending or descending).
§ Display or hide table columns with .
70 KISTERS
How To Work With datasphere
2.9 RasterViewer
datasphere is connected to the KISTERS Raster Viewer application.
The application is used to display observations and forecast data based on raster data. The data basically come from
all open or commercial raster channels that you have subscribed to (called "products" here).
See Available Channels 63 for information about subscribed channels and data.
§ Select RASTERVIEWER from the drop-down list.
KISTERS 71
How To Work With datasphere
Observations View
§ If you select to view observations, you first select the preconfigured source product where to get the observations
from (like certain radars or from certain satellites like e.g. satellite derived precipitation data of the Eumetsat HSAF,
etc.).
72 KISTERS
How To Work With datasphere
§ Click the info button for detailed information about the selected product.
§ Select the corresponding parameter and time series that contain the data to be viewed.
§ Specify the end date of the time range to be viewed (like e.g. what was the precipitation like last weekend?).
§ Select the increment for the animation:
Note that the increment is automatically adapted if no data in the selected increment exist.
§ Accept with the [SHOW DATA] button.
The selected data is being loaded into the map.
Forecasts View
§ If you decide to view forecasts, you first select the preconfigured source product and its parameters and time
series.
§ Select the forecast model run to visualise in the map by date and by time stamp of the run.
KISTERS 73
How To Work With datasphere
Use the following functions in the map with loaded raster data:
§ Zoom in and out with the and icons.
§ Zoom to your My Area extent 30 with the icon.
§ Zoom to the complete product extent with the icon.
This will focus on the complete region for which raster data exist.
§ Start the animation with the play button below the map.
§ Modify the animation settings with .
74 KISTERS
How To Work With datasphere
§ Click the icon to add a wind animation to your raster data in the map.
§ Click the icon to indicate one point in the raster where you need more detailed information about.
§ Click the icon to download the current raster data.
KISTERS 75
How To Work With datasphere
76 KISTERS
Index
Thresholds 50
Index
A
Account Settings 65
Alarming 47
Notifications 48
Recipients 48
Recipients Groups 49
Thresholds 50
C
Channels 54
Available channels 63
Organisation 64
SharingKEY 64
Subscriptions 61
F
Forecast 6
G
GeoJSON 6
Graph 6
J
JSON 6
L
Location 6
Login 5
M
Metadata 6
N
Notifications 48
R
Recipients 48
Recipients Groups 49
S
Sensor 6
SharingKEY 64
T
Table 6
Threshold 6
KISTERS 77