...
The sample viewer shows information about the samples that are shown based on the selected locations in the Data Viewer. For the selected locations a list of samples is shown in the upper part of the sample viewer. In the lower part of the sample viewer the content of selected samples are shown.
Contents
To use the sample viewer, configure it as <explorerTask> in Explorer.xml using <predefinedDisplay>sample viewer</predefinedDisplay> for example:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<explorerTask name="Monsters"> <iconFile>sysmon.png</iconFile> <mnemonic>M</mnemonic> <predefinedDisplay>sample viewer</predefinedDisplay> <toolbarTask>true</toolbarTask> <menubarTask>true</menubarTask> <accelerator>ctrl S</accelerator> <loadAtStartup>true</loadAtStartup> </explorerTask> |
...
Export Time Series
Values of time series belonging to all selected samples in the sample viewer can be exported via the (right mouse click) context menu.
...
The file types that can be chosen are configured in the Interactive Export Formats of Explorer.xml.
Select samples
Below the table with samples, a table with all values of the time series of the selected sample(s) are shown. In the image below sample 714 is selected so only values of the time series with sample id 714 are shown underneath.
...
Filtering also works by double clicking on a cell in the sample table. Just as filtering from the filter window this can be applied to multiple cells as illustrated in the next image where the sample table is filtered for location "MBP016" and medewerker "IMP"
Season and time filtering (since 2021.01)
Since 2021.01 it is also possible to filter samples on time and define a list of seasons for filtering of samples within a specific period within years.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<sampleDisplay xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews https://fewsdocs.deltares.nl/schemas/version1.0/sampleDisplay.xsd">
<enableEditor>true</enableEditor>
<permissions>
<editorPermission>beheerders</editorPermission>
</permissions>
<season startMonthDay="--04-01" endMonthDay="--09-30" label="Groeiseizoen"/>
<season startMonthDay="--09-30" endMonthDay="--04-01" label="Off season"/>
</sampleDisplay>
|
A dropdown menu on top of the sample panel will appear for this season and time filtering option:
Edit samples (since 2020.02)
Since 2020.02 it is possible to edit sample values directly from the sample viewer. To enable this the sampleViewer needs it its own configuration file with <enableEditor>true<with <enableEditor>true</enableEditor>. It is also possible to out set a permission on the editing of sample data.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<sampleDisplay xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http https://fewsfewsdocs.wldelftdeltares.nl/schemas/version1.0/sampleDisplay.xsd"> <enableEditor>true</enableEditor> <permissions> <editorPermission>beheerders</editorPermission> </permissions> </sampleDisplay> |
Make sure to also point towards this display in the explorer tasks with the same display config file name als the Sample Display config:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<explorerTask name="Monsterweergave"> <iconFile>sample.png</iconFile> <mnemonic>M</mnemonic> <displayConfigFileName>SampleDisplay</displayConfigFileName> <toolbarTask>true</toolbarTask> <menubarTask>true</menubarTask> <accelerator>ctrl M</accelerator> <loadAtStartup>false</loadAtStartup> </explorerTask> |
When this is configured correctly there will be an extra right mouse menu option to delete a row from the sample:
And also extra also an extra right mouse menu option to edit either the value of the time series or edit the value of a valueProperty:
An important thing to keep in mind is that deleting a value from the sample viewer cannot be undone via the sample viewer, but setting the value to a missing will.
Since 2022.01 the option "Delete selected record until reimport" has been added, that also gives the possibility to reimport (an updated value of) this record.
Delete samples
Since 2021.02 samples can be deleted via the right mouse menu, this will also delete all values belonging to the sample.
For this editing must be enabled.
Comments
Since 2021.01 it is also possible to view, add and edit comments directly from the table via the right mouse menu.
The comment column will appear automatically when at least 1 comment is present.
For this editing must be enabled.
Flags
Since 2021.01 flags are automatically shown (if present) in the Quality column, unreliable values are shown as missing in the Sample Viewer, but the value (if not a real missing) can be exported from the database:
History
Since 2021.01 the option to show the history of a value is also added to the right mouse menu
...
This will show the history window in the same way as can be done via the Time Series Dialog:
Season and time filtering
Since 2021.01 it is also possible filter samples on time and define a list of seasons for filtering of samples within a specific period within years.
| Code Block | ||||
|---|---|---|---|---|
| ||||
<sampleDisplay xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews
http://fews.wldelft.nl/schemas/version1.0/sampleDisplay.xsd">
<enableEditor>true</enableEditor>
<permissions>
<editorPermission>beheerders</editorPermission>
</permissions>
<season startMonthDay="--04-01" endMonthDay="--09-30" label="Groeiseizoen"/>
<season startMonthDay="--09-30" endMonthDay="--04-01" label="Off season"/>
</sampleDisplay>
|
A dropwon on top of the sample panel will appear for this.