nordic-dev.net/PAMGuard
nordic-dev.net/PAMGuard
2
0
Fork 0
mirror of https://github.com/PAMGuard/PAMGuard.git synced 2024-11-21 22:52:22 +00:00
Code Issues Packages Projects Releases Wiki Activity

Documented new species search in help

Browse Source
This commit is contained in:
Marie 2024-01-23 14:33:50 -08:00
parent 971165b72e
commit f1bb6e4c0c
3 changed files with 52 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
src/help/utilities/tethys/docs/images/species_search.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 68 KiB

53
src/help/utilities/tethys/docs/tethys_speciescodes.html
View File

@ -100,7 +100,7 @@
PAMGuard events typically are a short name that represents the
species and/or potentially a call. Knowledge of the PAMGuard
modules that were run and the data on which they executed will let
a user infer what she be recorded.
a user infer what should be recorded.
The dialog below shows a sample set of events produced by one or more PAMGuard modules
using the names: HP, DO, SON, KW, UNK, and PHP:
@ -123,18 +123,23 @@
</li>
<li>
ITIS code - The TSN that should be associated with the PAMGuard
event name. Currently, these must be looked up at the ITIS web
site although future releases may remove this restriction.
Pressing the Find button will look up the name associated with
the ITIS code. In the example above, the user typed 180473 and
then pressed Find.
ITIS code -This is the ITIS TSN that is associated with PAMGuard
event code. Click on Find to inovke the TSN
search dialog whose behavior is described in the <a href="#TSNLookup">next
section</a>.
<p>
If you happen to know the TSN, you
can enter it directly. Pressing Find after typing the TNS will
populate the Latin and English vernauclar names so that you may
verify your TSN was entered correctly.
</p>
</li>
<li> Call / sound type - This will default to the code provided by
the module but should be updated to specify an appropriate call
type or left blank to indicate that the detection is not related
to a specific call type.
to a specific call type. In the case of a porpoise detector,
the likely call type would be "Clicks".
<strong>We should double check that no Call element is generated when this is blank.</strong>
</li>
</ul>
@ -142,5 +147,35 @@
<p>
Once all species names and call/sound types have been identified, press the Okay button.
</p>
<h2 name="TSNLookup"> Searching for ITIS Taxonomic Serial Numbers (TSNs) </h2>
<p>
As noted above, pressing Find without typing a TSN will bring up a
search dialog:
</p>
<div>
<image src="./images/species_search.png" class=".center"/>
</div>
<p>
The top of this dialog has a search box where one can enter either
a Latin name or the common name for a species. The Tethys server
will search for all species that match the search-box contents.
For many species, there are common name entries in languages
other than English, and these are searched as well.
</p>
<p>
Once you press the search button, a list will appear with all
matches for your search term. If there are too many, a scroll bar
will permit you to look through the list. Select the entry that
you wish and press OK. The TSN on the species dialog will be
populated along with the Latin name and common names from the ITIS
database.
</p>
</body>

9
src/tethys/species/swing/DataBlockSpeciesDialog.java
View File

@ -40,7 +40,14 @@ public class DataBlockSpeciesDialog extends PamDialog {
JPanel nPanel = new JPanel(new BorderLayout());
nPanel.setBorder(new TitledBorder("Code management"));
nPanel.add(BorderLayout.EAST, itisButton);
String otherMsg = "<html>Use a valid ITIS species code, Or for Noise Measurements <br>and \"Other Phenomena\" use code -10</html>";
String otherMsg =
"<html>Specify an ITIS taxonomic serial number (coding)."
+ "<br>Press the Find button to look up TSNs by Latin or common name. "
+ "Anthropogenic signals should be coded as Homo sapiens (180092). "
+ "<br>Noise Measurements and geophonic sounds should be coded as "
+ "\"Other Phenomena\" (-10). "
+ "<br>When known, a call or sound type should "
+ "be specified (see help for more information).</html>";
nPanel.add(BorderLayout.CENTER, new JLabel(otherMsg , JLabel.LEFT));
// JPanel nwBit = new JPanel(new FlowLayout());
// JButton exportButton = new JButton("Export");