Difference between revisions of "Input DNA Data"

From GGBN Wiki
Jump to: navigation, search
(Input Tool)
Line 1: Line 1:
 
=Input Tool=
 
=Input Tool=
[[File:Input.jpg|thumb|300px|Input Mask DNA Module]]
+
[[File:Main_menu_input.jpg|thumb|200px|Main menu]]
This feature enables to set up references between DNA and specimen data.<br>
+
This feature enables to set up references between DNA and specimen data. Here, specific DNA information like:
Input mask is parted in specimen data (green) and DNA data (black). Please have a look at the screenshot.
+
* DNA extraction (e.g. extraction process, DNA quality and long-term storage)
<div id="wikinote">
+
* amplified sequence fragments
Before entering DNA data you have to load the relevant specimen data. There is no possibility to save DNA data without specimen information! To guarantee both the safeguarding and long-term availability of referenced DNA samples these should be deposited in research collections. Corresponding data including voucher information have to be stored in suitable collections databases.</div>
+
* respective Genbank No. and/or BOLD IDs
 +
can be associated to specimen, previuosly integrated in an GBIF database.<br>
  
==Specimen Data==
+
Before entering DNA data you have to load the relevant specimen data. There is no possibility to save DNA data without specimen information! To guarantee both the safeguarding and long-term availability of referenced DNA samples these should be deposited in research collections. Corresponding data including voucher information have to be stored in suitable collections databases. If the respective databases are not yet integrated into the DNA Bank Network, these can either be [[#Add new specimen provider|newly added]] or alternatively, if the specimen data are not availably in an online database, these can be set up offline with the [[Specimen Tool]].<br>
 +
 
 +
Once you have successfully logged in, click “Input Tool” to add DNA details.<div style="clear:both;"></div>
 +
 
 +
==Specimen Details==
 
Each DNA sample is extracted from a specimen. This specimen can be a tissue sample, a complete individual, a living plant or animal or a culture (algae, microorganisms). By defining a reference between DNA sample and the DNA voucher you should keep in mind what exactly the DNA voucher is. In terms of the DNA Bank Network the ideal DNA voucher means a complete individual, from which the tissue and DNA sample was taken from. This DNA voucher should be deposited in a natural history collection and the voucher data are available via GBIF. In many cases it is not possible to deposit such an ideal voucher, because it is for example a threatend species. Than you should reference to the most applicable DNA voucher.
 
Each DNA sample is extracted from a specimen. This specimen can be a tissue sample, a complete individual, a living plant or animal or a culture (algae, microorganisms). By defining a reference between DNA sample and the DNA voucher you should keep in mind what exactly the DNA voucher is. In terms of the DNA Bank Network the ideal DNA voucher means a complete individual, from which the tissue and DNA sample was taken from. This DNA voucher should be deposited in a natural history collection and the voucher data are available via GBIF. In many cases it is not possible to deposit such an ideal voucher, because it is for example a threatend species. Than you should reference to the most applicable DNA voucher.
 +
[[File:Input.jpg|thumb|400px|Input Mask DNA Module]]
  
 
===The GBIF world===
 
===The GBIF world===
Line 20: Line 26:
 
*** If not: Relevant institution has no specimen database or no possibility of becoming a GBIF provider any time soon?
 
*** If not: Relevant institution has no specimen database or no possibility of becoming a GBIF provider any time soon?
  
 +
===Integration of Specimen data===
 +
To integrate specimen data, the following information are necessary:<br>
 +
* The unique specimen number/UnitID.<br>
 +
* The respective collection database, where the specimen (data) is stored.
 +
 +
====Specimen number/UnitID====
 +
The UnitID is a unique identifier applied to a specimen in an electronic database, it is necessary to conduct a successful wrapper query. In an ideal world, the collection uses a definite voucher ID, which is also used for the electronic database (e.g. the herbarium at the BGBM uses the barcodes for the herbarium vouchers as UnitIDs for the electronic database). However, in other collections, the original voucher ID might differ from the UnitID in the electronic database. In this case, a wrapper query for the voucher ID would fail and the user has to investigate for the accordant UnitID.
 +
 +
====Collection databases====
 +
The respective collection database can be selected from either the 'internal' or the 'external' rolldown menu, which include all databases currently integrated in (associated with?) the DNA-Bank Network. If the respective database is not yet integrated, it is possible to [[#Add new specimen provider|add a new specimen provider]].
 +
 +
There are several cases, why a specimen number might currently not be available:<br>
 +
* The respective collection has no electronic database
 +
* The respective collection has an electronic database, but is not accessible online via Wrapper.
 +
* The electronic collection database is accessible online, but the wanted specimen data is not online yet.
 +
* The wanted specimen is in private ownership and thus not accessible online.
 +
 +
In these cases, please use the [[Specimen Tool]] to add offline specimen data. These offline data can later be replaced by eventually now online available collection database.
 +
 +
===Add new specimen provider===
 +
New specimen databases can be integrated with the 'New specimen provider' menu. Specimen databases are generally hosted by provider (institutes, museums, collections etc.). The Provider-Url for each specific specimen database is generally available via GBIF (or alternatively from the respective institute).
 +
[[File:Add_new_1.jpg|thumb|200px|Add new specimen provider]]
 +
[[File:Add_new_2.jpg|thumb|200px|Add new specimen provider]]
 +
 +
This list shows three different examples of provider urls:<br>
 +
Example 1: http://ww3.bgbm.org/biocase/pywrapper.cgi?dsa=HerbariumImages<br>
 +
Example 2: http://aadc-maps.aad.gov.au/digir/digir.php<br>
 +
Example 3: http://www.biologie.uni-ulm.de/cgi-bin/biocase_new/www/pywrapper.cgi?dsa=zoological
 +
 +
In following, the standard procedure to add a new speceimen database via GBIF is described.
 +
 +
# Enter: http://data.gbif.org/welcome.htm
 +
# Search for taxon name of the specimen -> 'Explore' -> 'Occurences'
 +
# Add search filter: 'Catalogue Number' -> Enter Specimen No. -> Check 'Add filter' -> Check 'Search'
 +
# In table 'Sample results' check 'View'
 +
# Check 'Data set'
 +
# Copy Provider Url ('Access Point Url') and paste into the 'Wrapper Url'-Field -> Check 'Verify'
 +
 +
If the Url does not exist yet, you can now set up a new provider/dataset. The following informations must be provided:
 +
 +
* Database scheme ('Schema')
 +
* Digir Resource/Source (if using a Digir database)
 +
* View ('Bezeichnung')
 +
* Internal or external database
 +
 +
The database scheme is mandatory and can be selected from a rolldown menu list (ABCD 1.2, ABCD 2.05, ABCD 2.06, DarwinCore/Digir). This information can either be found directly in the Url (in the case of Digir databases) or retrieved by accessing the Url. The latter will display a xml-scheme, where 'Supportedschemas' provides the correct scheme information.<br>
 +
 +
Example 2:
 +
<SupportedSchemas request="true" namespace="http://www.tdwg.org/schemas/abcd/1.2" response="true">
 +
Here, the ABCD 1.2 scheme is used.
 +
 
 +
If using Digir databases, the 'Resource' and 'Source' information is mandatory. These can also be retrieved by accessing the Url. In the header, you will find a line refering to 'source' and 'resource'.<br>
 +
 +
Example 3:
 +
<response>
 +
  <header>
 +
  <version>$Revision: 1.10 $</version>
 +
  <sendTime>01-12-2007 01:28:09+1100<sendTime>
 +
  <source resource="seabirds">http://aadc-maps.aad.gov.au:80/digir/digir.php</source>
 +
  <destination>192.38.28.101</destination>
 +
</header></response><br>
 +
Here, 'seabirds' refers to the resource and the url refers to the 'source'.
 +
 +
 +
==DNA Details==
 +
In this section DNA extraction details can be linked with the respective voucher specimen. Furthermore, associated information like amplified fragments and associated Genbank Acc. No. and/or BOLD Process IDs can be added.
 +
 +
The following table provides explanations and an example to all DNA details.
 +
 +
{| class="wikitable"
 +
|- style="background-color:#C0C0C0;font-weight:bold"  valign="bottom"
 +
| width="166" height="13" | DNA and Tissue Data
 +
| width="289" | Explanation
 +
| width="57" | Pre-defined
 +
| width="135" | Mandatory?
 +
| width="220" | Example
 +
 +
|- style="font-weight:bold"
 +
| height="13" valign="bottom" | General Details:
 +
| valign="bottom" | 
 +
| valign="bottom" | 
 +
| valign="bottom" | 
 +
| align="right"  valign="bottom" | &nbsp;
 +
 +
|-  valign="bottom"
 +
| height="13" | DNA Extraction Number
 +
| A unique identifier or code for this individual DNA sample.
 +
| No
 +
| Yes
 +
| ZFMK-DNA ColCar 0399
 +
 +
|-  valign="bottom"
 +
| height="13" | Relation to Voucher
 +
| Relation between DNA/Tissue and voucher specimen.
 +
| Yes
 +
| Yes
 +
| DNA from specimen (voucher)
 +
 +
|-  valign="bottom"
 +
| height="13" | Tissue
 +
| Type of tissue
 +
| No
 +
| Yes
 +
| leg
 +
 +
|-  valign="bottom"
 +
| height="13" | Preservation
 +
| Method of preservation
 +
| Yes
 +
| Yes
 +
| in alcohol (ethanol, 96%)
 +
 +
|-  valign="bottom"
 +
| height="13" | DNA Type
 +
| Origin of DNA
 +
| Yes
 +
| No
 +
| gDNA
 +
 +
|- style="background-color:#C0C0C0"
 +
|style="font-weight:bold" height="13" valign="bottom" | Extraction Details:
 +
|style="font-weight:bold" valign="bottom" | 
 +
|style="font-weight:bold" valign="bottom" | 
 +
|style="font-weight:bold" valign="bottom" | 
 +
| align="right"  valign="bottom" | &nbsp;
 +
 +
|-  valign="bottom"
 +
| height="13" | DNA Extraktion Date
 +
| Date of DNA extraction;YYYY-MM-DD
 +
| Yes
 +
| Yes
 +
| align="right" | &nbsp;
 +
 +
|-  valign="bottom"
 +
| height="13" | DNA Extraktion Method:
 +
| DNA isolation kit (company/product name) or extraction protocol.
 +
| No
 +
| Yes; if unknown = "Unknown"
 +
| Unknown
 +
 +
|-  valign="bottom"
 +
| height="13" | DNA Extraktion Staff
 +
| Person who extraced DNA
 +
| No
 +
| Yes; if unknown = "Unknown"
 +
| C.Blume/C.Etzbauer
 +
 +
|- style="font-weight:bold"  valign="bottom"
 +
| height="13" | Quality Details:
 +
 +
 +
 +
| align="right" | &nbsp;
 +
 +
|-  valign="bottom"
 +
| height="13" | DNA Purification Method
 +
| DNA purification kit (company/product name) or protocol.
 +
 +
| Yes; if unknown = "Unknown"
 +
| QIAquick PCR Purification Kit Qiagen
 +
 +
|-  valign="bottom"
 +
| height="16" | Ratio of Absorbance
 +
| Assessment of DNA optical density
 +
| No
 +
| No
 +
| 1,99 OD260nm/OD280nm
 +
 +
|-  valign="bottom"
 +
| height="13" | Concentration in  ng/µl
 +
| Concentration of DNA
 +
| No
 +
| No
 +
| 26,64ng/µl
 +
 +
|-  valign="bottom"
 +
| height="13" | DNA Quality
 +
| Rating of DNA quality
 +
| Yes
 +
| No
 +
| high
 +
 +
|-  valign="bottom"
 +
| height="13" | Quality Check Date
 +
| Date of DNA quality check;YYYY-MM-DD
 +
| Yes
 +
| No
 +
| -
 +
 +
|- style="background-color:#C0C0C0;font-weight:bold"
 +
| height="13" valign="bottom" | GenBank or BOLD Entries:
 +
| valign="bottom" | 
 +
| valign="bottom" | 
 +
| valign="bottom" | 
 +
| align="right"  valign="bottom" | &nbsp;
 +
 +
|-  valign="bottom"
 +
| height="13" | Genetic Locus
 +
 +
| Yes
 +
| No
 +
| COI
 +
 +
|-  valign="bottom"
 +
| height="13" | GenBank Acc.No / Bold Process ID
 +
 +
| No
 +
| No
 +
| -
 +
 +
|-  valign="bottom"
 +
| height="13" | Link
 +
 +
| No
 +
| No
 +
| -
 +
 +
|- style="background-color:#C0C0C0;font-weight:bold"
 +
| height="13" valign="bottom" | Notes:
 +
| valign="bottom" | 
 +
| valign="bottom" | 
 +
| valign="bottom" | 
 +
| align="right"  valign="bottom" | &nbsp;
 +
 +
|-  valign="bottom"
 +
| height="13" | DNA Sample Provided by
 +
| Person who provided the DNA
 +
| Yes
 +
| Yes; if unknown = "Unknown"
 +
| Zoological Research Museum Alexander Koenig
 +
 +
|-  valign="bottom"
 +
| height="13" | Blocked Until
 +
| Sample data will be visible via web portal but can not be ordered until two years or less from the given date; YYYY-MM-DD
 +
| -
 +
| No
 +
| -
 +
 +
|-  valign="bottom"
 +
| height="13" | Remarks for Customers
 +
| -
 +
| -
 +
| No
 +
| -
 +
 +
|-  valign="bottom"
 +
| height="13" | Internal Remarks
 +
| -
 +
| -
 +
| No
 +
| -
 +
 +
|- style="background-color:#C0C0C0;font-weight:bold"
 +
| height="13" valign="bottom" | Stock/Aliquots: <sup>1</sup>)
 +
| valign="bottom" | 
 +
| valign="bottom" | 
 +
| valign="bottom" | 
 +
| align="right"  valign="bottom" | &nbsp;
 +
 +
|-  valign="bottom"
 +
| height="13" | Fridge/Rack/Box
 +
 +
| -
 +
| No
 +
| -
 +
 +
|-  valign="bottom"
 +
| height="13" | Barcode
 +
 +
| -
 +
| No
 +
| -
 +
 +
|-  valign="bottom"
 +
| height="13" | Position
 +
| Positon in fridge
 +
| -
 +
| No
 +
| -
 +
 +
|-  valign="bottom"
 +
| height="13" | Source volume (µl)
 +
| Original volume of aliquot
 +
| -
 +
| No
 +
| -
 +
 +
|-  valign="bottom"
 +
| height="13" | Remaining volume (µl)
 +
| Volume of aliquot left
 +
| -
 +
| No
 +
| -
 +
 +
|-  valign="bottom"
 +
| height="13" | Price per Aliqout
 +
| -
 +
| -
 +
| No
 +
| -
 +
 +
|}
 +
 +
<sup>1</sup>) Not shown in the DNA-Bank-Network webportal.
  
Dazu benötigen Sie folgende Informationen:
+
====Comments on the DNA details====
1. Specimen Number/UnitID
 
2. in welcher Datenbank liegen die Informationen -> ist die Datenbank schon angebunden? (Datenbank anbinden)
 
3. Für den Fall, dass die Specimen-Daten nicht online verfügbar sind, lesen Sie bitte hier weiter
 
Es ist auch möglich, Daten abzurufen, zu denen es keine Specimen-Nummer bzw. keinen Beleg gibt (s.u.)
 
 
Im Folgenden werden alle Felder genauer erläutert.
 
  
Grafik 1:
+
The DNA numbers are sorted in ascending order. 'Last DNA No.' displays the highest assigned DNA number, which generally (but not always) refers to the last entered number.
Specimen Number/UnitID:
 
Um die Wrapper-Abfrage erfolgreich ausführen zu können, benötigen Sie die UnitID des Specimens. Dabei handelt es sich um eine eindeutige Nummer in der Datenbank.
 
Einige Sammlungen benutzen als UnitID die hausinterne eindeutige Nummer des Beleges, z.B. wird in der Herbar-Datenbank des BGBM der Barcode der Herbarbelege als UnitID verwendet (z.B. "B 10 000204643"), der auch auf dem digitalisierten Beleg zu finden ist.
 
Es kann jedoch auch vorkommen, dass als UnitID eine datenbankintere Nummer verwendet wird, die nichts mit der eigentlichen Beleg-Nummer zu tun hat und demzufolge auch nicht auf dem digitalisierten Beleg zu finden ist! Sollte also bei der Wrapper-Abfrage nicht das gewünschte Ergebnis geliefert werden, könnte das auch daran liegen! Ein Beispiel dafür ist das Herbarium Wien. Die Belege haben hausintern eine Nummer nach folgendem Schema 1956-000123. Als UnitID wird jedoch eine Datenbank-ID benutzt, z.B. 3115643.
 
Specimen database:
 
Hinter "Internal" und "External" verbirgt sich jeweils eine Liste mit Datenbanken. Auf die hausinternen Datenbanken wird genauso per Wrapper zugegriffen wie auf die externen. In der Liste der internen Datenbanken gibt es zusätzlich den Eintrag "offline specimen data". Wenn Sie das auswählen, wird ausschließlich in den Specimen-Daten gesucht, die nicht online verfügbar sind und von Ihnen zuvor eingegeben wurden. An die Auswahl einer Datenbank (außer offline specimen data) ist zwingend die Eingabe der Specimen-Nummer/UnitID gekoppelt. Anschließend müssen Sie auf "Verify" drücken.
 
No specimen number available:
 
Dies trifft zu, wenn z.B. der externe Beleg vorhanden ist, jedoch vor Ort noch nicht in der Datenbank erfasst wurde und noch keine Specimen-Nr. vergeben wurde. Oder es handelt sich um einen Beleg in Privathand. Da es sich dabei immer um externe Belege handelt, kann die Specimen-Nummer nur von der besitzenden Sammlung vergeben werden. Die Specimen-Daten können jedoch hier offline eingegeben werden und später, wenn die Daten durch die externe Sammlung online zugänglich gemacht wurden durch die online-Daten ersetzt werden. Um die Daten dann abzurufen müssen sie die Box "No specimen number available" (siehe Grafik 1) markieren und bei Specimen database "Internal" ->"offline specimen data" auswählen, anschließend auf "Verify" drücken und aus der Liste das gewünschte Objekt selektieren.
 
add offline specimen data:
 
Bei Klick öffnet sich ein neues Formular, in das Specimen-Daten eingegeben werden können, die nicht online verfügbar sind. Gründe dafür können sein: die betreffende Sammlung
 
- hat keine Datenbank,
 
- hat eine Datenbank, die jedoch nicht online via Wrapper zugänglich ist,
 
- hat eine Datenbank, die via Wrapper erreichbar ist, jedoch werden die benötigten Daten erst sehr viel später eingegeben und online zugänglich
 
- der Beleg befindet sich in Privathand und ist nicht per Wrapper erreichbar.
 
Nähere Informationen dazu entnehmen Sie bitte der dortigen Dokumentation.
 
Im Verwaltungsteil der DNA-Daten gibt es eine Funktion, bei der für die betroffenen DNA-Proben im Nachhinein die offline-Daten durch die online-Daten manuell ersetzt werden können.
 
add new dataset:
 
Bei Klick öffnet sich ein neues Formular, in das eine neue Datenbankanbindung eingegeben werden kann. Nähere Informationen dazu entnehmen Sie bitte der dortigen Dokumentation.
 
  
===TO DO===
+
=====Extraction Number=====
Abcd 2.05 und digir noch keine Sammelnummer zum Speichern drin!
+
The extraction code provided here should be exclusively numerical. Institutional codes might be added later for all provided data sets.
  
==Add new specimen data provider==
+
=====Relation to voucher=====
Mit diesem Formular können Sie neue Specimen-Datenbanken anbinden.
+
'No voucher available (voucher->observation)' should be selected, if only parts of an organism (blood, feathers or leaves) have been collected.
Die Specimen-Datenbanken liegen bei Providern. Oft hostet ein Provider mehrere Specimen-Datenbanken. Dabei wird für die Datenabfrage oft die selbe url für mehrere Datenbanken eines Providers benutzt. Daher wird im Formular zuerst geprüft, ob die url bereits im DNA-Modul gespeichert wurde und wenn ja für welche Specimen-Datenbanken. (Für den Fall, dass die Specimen-Daten nicht online verfügbar sind, lesen Sie bitte hier weiter)
 
  
Die Provider-Url bekommt man zumeist über Gbif (wenn nicht muss man sich an das jeweilige Institut wenden):
+
=====Tissue=====
1. http://data.gbif.org/welcome.htm
+
'Tissue material gone': Please select this box, if the tissue used for DNA extraction has been used up.
2. Nach dem Specimen-Artnamen suchen -> Explore: -> "Occurrences"
 
3. Add search filter "Catalogue Number" -> Specimen-Number eintragen -> "Add filter" anklicken -> "Search" anklicken
 
4. In der Tabelle "Sample results" ganz rechts beim richtigen Specimen "View" anklicken
 
5. Als erster Block erscheint "Dataset" -> auf den Link vom "Dataset" klicken
 
6. Ganz unten beim Block "Information" erscheint die Url des Providers als "Access Point Url"
 
Diese Url muss in das folgende Feld eingetragen werden:
 
Provider-Url:
 
Beispiel 1: http://ww3.bgbm.org/biocase/pywrapper.cgi?dsa=HerbariumImages
 
Beispiel 2: http://aadc-maps.aad.gov.au/digir/digir.php
 
Beispiel 3: http://www.biologie.uni-ulm.de/cgi-bin/biocase_new/www/pywrapper.cgi?dsa=zoological
 
Beispiel 3 ist die Url zu den zoologischen Datenbanken, die von SysTax gehostet werden. Diese Url gilt daher für viele Specimen-Datenbanken, auf die möglicherweise hier zugegriffen werden muss. Beispiel 1 hingegen gilt nur für die Specimen-Datenbank "HerbarImages" des BGBM.
 
Nach der Eingabe der Url bitte auf "Verify" klicken. Jetzt wird in der DNA-Datenbank gesucht, ob diese Url schon existiert.
 
Fall A - die Url existiert noch nicht:
 
In diesem Fall erscheint eine entsprechende Meldung und die Möglichkeit, einen neuen Provider/Dataset einzugeben. Dabei wird automatisch das Feld "Provider url" mit dem gesuchten Wert gefüllt, kann jedoch beliebig geändert werden.
 
Anmerkung: In jedem Fall sollte man einen Verbindungstest durchführen bevor man speichert, das heißt, prüfen, ob der Provider erreichbar ist. Wenn eine Fehlermeldung kommt, kann man es ein paar Minuten später noch einmal probieren. Möglicherweise lag nur ein temporäres Problem vor. Sollte der Verbindungstest jedoch mehrfach fehlschlagen, muss man sich an den zuständigen Provider wenden. Um zu prüfen, ob das Skript richtig arbeitet, kann man als Test eine "normale Webseite" eingeben (z.B. http://www.bgbm.org).
 
  
Die Eingabe des verwendeten Schemas ist zwingend erforderlich. Man kann dieses aus der Liste auswählen (ABCD 1.2, ABCD 2.05, ABCD 2.06, DarwinCore/Digir).
+
=====Extraction date=====
Welches Schema verwendet wird, erkennt man, indem man die Provider-Url aufruft bzw. schon an der Url selber, z.B. wenn wie in Beispiel 2 in der url bereits die Bezeichnung "digir" auftaucht.
+
'Extraction Date not available': Please select this box, if the extraction date cannot be determined any more.
Beim Aufrufen der Url erhält man ein xml-Schema, in dem im oberen Teil u.a. diese oder eine ähnliche Zeile zu finden ist:
 
<SupportedSchemas request="true" namespace="http://www.tdwg.org/schemas/abcd/1.2" response="true">
 
In diesem Fall (Beispiel 1), wäre es das Schema ABCD 1.2, bei Beispiel 3 wäre es ABCD 2.06.
 
Desweiteren muss eine Bezeichnung eingegeben werden (das ist die Info, dass in der DNA-Input-Mask im Auswahl-Feld erscheint) und ausgewählt werden, ob es sich um eine externe oder interne Datenbank handelt. Diese Zuordnung und Bezeichnung soll Ihnen die Bedienung und das Wiederfinden erleichtern. Da Sie auf die hauseigenen Datenbanken häufiger zugreifen werden und daher eine kurze eigene Liste handlicher ist.
 
Fall B - die Url existiert bereits:
 
In diesem Fall erhält man eine Liste mit den bereits gespeicherten Specimen-Datenbank-Verknüpfungen. Wenn wir z.B. für die SysTax-Url (Beispiel 3) bereits einen Eintrag haben der "Zoologische Staatssammlung München - Mollusca" heißt und nun als nächstes "Zoologische Staatssammlung München - Arachnida" anbinden wollen kann man dafür entweder einen neuen Dataset-Eintrag für den Provider festlegen oder man ändert den Namen  "Zoologische Staatssammlung München - Mollusca" in  "Zoologische Staatssammlung München " um und legt keinen neuen Eintrag fest. Das bleibt dem Nutzer überlassen. Eine Liste aller gehosteten Datenbanken von SysTax findet man bei Gbif. SysTax ist ein Beispiel, wo sehr viele Datenbanken gehostet werden. Je mehr Datenbanken Sie anbinden werden, desto häufiger werden Sie jedoch weitere Provider finden, die mehr als eine Specimen-Datenbank hosten.
 
Es kann daher der Fall eintreten, dass Sie eine Specimen-Nummer in die DNA-Input-Mask eingeben und mehr als einen Treffer bekommen, einfach weil dieselbe Nummer in verschiedenen Datenbanken des Providers verwendet wird. In diesem Fall können Sie jedoch das gewünschte Specimen anklicken (im Hintergrund werden nun weitere Identifier übergeben und abgefragt) und bekommen die gewünschten Daten angezeigt.
 
Anmerkung: Sollte es sich um einen Digir-Provider handeln ist der Bearbeitungsmodus generell deaktiviert! Das liegt daran, dass Digir zwei weitere Parameter für die "Ansprache" der richtigen Specimen-Datenbank benötigt und somit eine "Sammel-Url" für Datenbanken desselben Digir-Providers nicht zum gewünschten Ergebnis führen würde. Jede Digir-Specimen-Datenbank muss also einzeln angebunden werden.
 
Wenn der Provider mit Digir arbeitet, ist die Eingabe zweier weiterer Parameter zwingend erforderlich: Resource und Source.
 
1.-4. siehe oben
 
5. „Retrieve original record from data provider” anklicken (ganz oben in dem hellrosa Kasten)
 
6. man erhält ein XML-Schema, wobei die ersten Zeilen so aussehen sollten:
 
<response>
 
  <header>
 
  <version>$Revision: 1.10 $</version>
 
  <sendTime>01-12-2007 01:28:09+1100</sendTime>
 
  <source resource="seabirds">http://aadc-maps.aad.gov.au:80/digir/digir.php</source>
 
  <destination>192.38.28.101</destination>
 
</header></response>
 
7. seabirds ist in diesem Fall die resource und http://aadc-maps.aad.gov.au:80/digir/digir.php ist die source. (In diesem Beispiel handelt es sich also offensichtlich um eine Datenbank über Seevögel.) Die Source unterscheidet sich in diesem Fall durch ":80" von der url in Beispiel 2. Mitunter kann es jedoch passieren, dass die source mit der Provider-Url identisch ist. Die Eingabe der source ist aber in jedem Fall zwingend.
 
Es kann auch vorkommen, dass die resource sehr kryptisch aussieht, z.B. rsr941f2d0ae5d102bfc2267d999a16650b für eine entomologische Datenbank in Dänemark.
 
8. Diese Angaben sind in die beiden folgenden Felder einzutragen:
 
Digir-Resource:
 
Digir-Source:
 
Bei jeder neuen Digir-Datenbank muss natürlich auch eine Bezeichnung eingegeben werden und ausgewählt werden, ob es sich um eine interne oder externe Datenbank handelt (so wie oben bei Fall A beschrieben)
 
  
==DNA Daten==
+
=====Ratio of Absorbance=====
Dateneingabe:
+
The ratio OD<sub>260nm/OD280nm</sub> provides an estimation of the purity of the sample. The measured value should range from 1.8 to 2.1. The ratio OD<sub>260nm/OD230nm</sub> provides an estimation of the purity against polysaccharides and polyphenol (important for some plants). The measured value should range above 2.0.
Mit diesem Formular können Sie DNA-Daten eingeben und dem richtigen Beleg zuordnen.
 
Die Eingabe-Maske ist aufgeteilt in Specimen-relevante Daten (grün) und DNA-relevante Daten (schwarz).
 
Als erstes sollten Sie die Specimen-/bzw. Aufsammlungs-Daten abrufen.
 
 
Grafik 2
 
  
+
=====Block in General=====
Übersicht >> Dateneingabe >> DNA-Daten
+
Please select this box if DNA sample shall not be searchable or available via the DNA Bank Network's webportal. If box is not selected, the DNA sample can be ordered.
DNA-Daten eingeben
 
Last DNA No:
 
Die DNA-Nummern sind aufsteigend sortiert. Hier wird die höchste vergebene und eingetragene Nummer angezeigt. Das entspricht meist, jedoch nicht immer der zuletzt eingegeben DNA-Nummer.
 
DNA Extraction Number:
 
Pflichtfeld. Das Format sollte immer eine Zahl sein. Sollten Sie für die spätere Darstellung im Webportal einen Institutions-Code davorsetzen wollen, kann das später für alle Datensätze festgelegt werden.
 
Relation to Voucher:
 
Pflichtfeld. Erweiterbar. Hier ist folgende Auswahl möglich:
 
- DNA from specimen (voucher)
 
- DNA and specimen from the same population
 
- DNA from cultivated offspring of the specimen
 
- No voucher available (voucher->observation) -> das trifft z.B. zu, wenn im Feld nur eine Feder, Blut oder ein Blatt entnommen wurden und nicht das Individuum als Ganzes entnommen wird. Im Idealfall sollte dann dazu ein Foto vom Naturstandort existieren
 
Tissue:
 
Erweiterbar. Bezeichnet das Gewebe bzw. Organ, von dem DNA entnommen wurde (z.B. Muskel, Blüte).
 
Preservation:
 
Erweiterbar. Bezeichnet die Konservierungsmethode des Gewebes/Individuums, aus dem DNA entnommen wurde. (z.B. Alkohol, Frischmaterial, Silikagel)
 
DNA Type:
 
Auswahl zwischen "Complete DNA" und "Mitochondrial DNA" möglich.
 
DNA Extraktion Method:
 
Pflichtfeld. Erweiterbar. Bezeichnet das Extraktionskit.
 
DNA Extraction Date:
 
Pflichtfeld. Bezeichnet das Datum der Extraktion. Das Format ist vorgegeben.
 
DNA Extraktion Staff:
 
Pflichtfeld. Erweiterbar. Anzeige nur intern, nicht im Webportal. Bezeichnet den, der die Extraktion durchgeführt hat.
 
DNA Purification Method:
 
Pflichtfeld. Erweiterbar. Bezeichnet das Aufreinigungskit.
 
Ratio of absorbance:
 
Bezeichnet die Werte der optischen Dichte. Zugelassen sind die Ziffern 0-9 sowie der Punkt.
 
DNA Concentration:
 
Bezeichnet den Wert der Konzentration. Zugelassen sind die Ziffern 0-9 sowie der Punkt.
 
DNA Quality:
 
Auswahl zwischen "high", "medium" und "low".
 
DNA Qualtity Check Date:
 
Bezeichnet das Datum der Qualitätsmessung (Messung von Konzentration und optischer Dichte).
 
Number of Aliquots:
 
Anzeige nur intern, nicht im Webportal. Anzahl der hergestellten Aliquots, Standardwert ist in diesem Beispiel "5". Dabei ist zu beachten, dass der Stock extra gewertet wird. Also wenn man 5 eingibt, bedeutet das, dass 5 Aliquots plus 1 Stock angelegt und gespeichert werden.
 
µl per Aliquot:
 
Anzeige nur intern, nicht im Webportal. Volumenangabe pro Aliquot. Beim Speichern wird im Hintergrund das Gesamtvolumen aller zusammengehörenden Aliquots berechnet sowie die Aliquot-Nummer vergeben.
 
z.B. DNA-Nummer: 1234, fünf Aliquots angelegt
 
-> 1. Aliquot: 1234-A
 
-> 2. Aliquot: 1234-B
 
-> 3. Aliquot: 1234-C
 
-> 4. Aliquot: 1234-D
 
-> 5. Aliquot: 1234-E
 
Location Stock Solution:
 
Pflichtfeld. Anzeige nur intern, nicht im Webportal. Bezeichnet den Lagerort des Stock. Dahinter kann man die Menge des Stocks in µl eintragen. Der Standardwert in diesem Beispiel liegt bei "47".
 
Location Aliquots:
 
Kein Pflichtfeld, jedoch erscheint bei Nichtangabe eine Meldung. Anzeige nur intern, nicht im Webportal. Bezeichnet den Lagerort der Aliquots. Normalerweise passen mehrere Aliquots in eine Box, so dass nur einmal für alle zusammengehörenden Aliquots der Lagerort eingetragen werden muss. Es kann jedoch sein, dass zusammengehörende Aliquots sich auf mehrere Boxen verteilen oder unterschiedliche Volumina aufweisen. Für diesen Fall kann man die in Grafik 3 markierte Box aktivieren und es erscheint eine weitere Tabelle mit der Möglichkeit zur Eingabe von 10 verschiedenen Aliquots. Gleichzeitig verschwinden die Eingabemöglichkeiten für "Number of Aliquots", "µl per Aliquot" sowie "Location Aliquots" (siehe Grafik 4). Hierbei muss nun für JEDES angelegte Aliquot der Lagerort und die µl festgelegt werden. Sollten Sie mehr als 10 Aliquots anlegen wollen, können sie über die Suchfunktion den Datensatz suchen und weitere Aliquots hinzufügen.
 
  
Grafik 3
 
  
Grafik 4
+
=='Save' and 'Save + Carry Forward'==
Backup Aliquot:
+
After succesfully filling out all fields for which you have or can provide information, please press 'save' to add the DNA details to the respective specimen voucher, or click on 'save and carry forward' if you wish to add DNA details to more than one specimen voucher, so that you do not have to fill out all fields again.  
Anzeige nur intern, nicht im Webportal. Diese Box ist standardmäßig markiert. Es bezeichnet das Aliquot, was zur Sicherheit zusätzlich angelegt wird. Es bekommt keinen fortlaufenden Buchstabenzusatz wie die normalen Aliquots.
 
Source material gone:
 
Anzeige nur intern, nicht im Webportal. Als Ausgangsmaterial ist hier z.B. die Silikaprobe, allgemein die Gewebeprobe oder der ganze Beleg gemeint.
 
DNA Sample Provided by:
 
Erweiterbar. Anzeige nur intern, nicht im Webportal. Bezeichnet den externen Wissenschaftler, der die DNA zur Verfügung gestellt hat.
 
Block until:
 
Sofern der externe Wissenschaftler (DNA Sample Provided by) die Weitergabe des DNA-Materials bis zu einem bestimmten Zeitpunkt blocken möchte, kann hier das jeweilige Datum eingetragen werden. Das Format ist vorgegeben.
 
Die DNA wäre dann im Webportal suchbar, jedoch nicht bestellbar!
 
Block in General:
 
Sofern die DNA-Probe aus z.B. artenschutzrechtlichen Gründen nicht weitergegeben werden darf, muss diese Box markiert sein.
 
Die DNA wäre dann im Webportal nicht suchbar und auch nicht bestellbar!
 
Notes:
 
Anmerkungen zu dieser DNA-Probe.
 
Amplification:
 
Wenn Amplifikationen durchgeführt wurden, muss diese Box (Grafik 5) markiert werden. Dann öffnet sich eine weitere Tabelle (Grafik 6).
 
  
Grafik 5
+
If you chose 'Save + Carry Forward' a new consecutively 'Extraction No.' will automatically be generated and all fields previously filled will contain the same information as the voucher you entered before.
  
Grafik 6
+
If you just click on 'save new specimen', the DNA details will be saved to the database and you can start with a new, empty input-sheet.
Amplification successful:
 
Auswahl ja oder nein.
 
Amplification Date:
 
Bezeichnet das Datum der Amplifikation. Das Format ist vorgegeben.
 
Staff:
 
Bezeichnet den, der die Amplifikation durchgeführt hat.
 
Fragment:
 
Erweiterbar. Bezeichnet das Fragment an dem die Amplifikation durchgeführt wurde.
 
GenBank Acc.No:
 
Sofern vorhanden, kann hier die Gen Bank Accession Number eingetragen werden.
 
Link:
 
Sofern eine Gen Bank Accession Number vorhanden ist, kann hier der entsprechende Link eingetragen werden
 
add more Amplifications:
 
Beim Markieren dieser Box öffnet sich die gleiche Tabelle für vier weitere Eintragungen.
 
  
 
=Search/Edit=
 
=Search/Edit=

Revision as of 13:26, 17 May 2011

Input Tool

Main menu

This feature enables to set up references between DNA and specimen data. Here, specific DNA information like:

  • DNA extraction (e.g. extraction process, DNA quality and long-term storage)
  • amplified sequence fragments
  • respective Genbank No. and/or BOLD IDs

can be associated to specimen, previuosly integrated in an GBIF database.

Before entering DNA data you have to load the relevant specimen data. There is no possibility to save DNA data without specimen information! To guarantee both the safeguarding and long-term availability of referenced DNA samples these should be deposited in research collections. Corresponding data including voucher information have to be stored in suitable collections databases. If the respective databases are not yet integrated into the DNA Bank Network, these can either be newly added or alternatively, if the specimen data are not availably in an online database, these can be set up offline with the Specimen Tool.

Once you have successfully logged in, click “Input Tool” to add DNA details.

Specimen Details

Each DNA sample is extracted from a specimen. This specimen can be a tissue sample, a complete individual, a living plant or animal or a culture (algae, microorganisms). By defining a reference between DNA sample and the DNA voucher you should keep in mind what exactly the DNA voucher is. In terms of the DNA Bank Network the ideal DNA voucher means a complete individual, from which the tissue and DNA sample was taken from. This DNA voucher should be deposited in a natural history collection and the voucher data are available via GBIF. In many cases it is not possible to deposit such an ideal voucher, because it is for example a threatend species. Than you should reference to the most applicable DNA voucher.

File:Input.jpg
Input Mask DNA Module

The GBIF world

GBIF technologies are basis and backbone of the DNA Module and the DNA Bank Network. Many institutions are GBIF providers, more than 213 millions of specimen and observation records are available via GBIF.
But how to find out if the required specimen data is available via GBIF? For that you should check the following facts:

  • Where is the DNA voucher deposited?
  • Is the relevant institution already a GBIF provider? Ask administrators or curators for help.
    • If so: The requirement related to specimen data is fulfilled.
    • If not: Is the relevant institution planning or willing to become a GBIF provider?
      • If so: The requirement will be met if the relevant database is GBIF accessible.
      • If not: Relevant institution has no specimen database or no possibility of becoming a GBIF provider any time soon?

Integration of Specimen data

To integrate specimen data, the following information are necessary:

  • The unique specimen number/UnitID.
  • The respective collection database, where the specimen (data) is stored.

Specimen number/UnitID

The UnitID is a unique identifier applied to a specimen in an electronic database, it is necessary to conduct a successful wrapper query. In an ideal world, the collection uses a definite voucher ID, which is also used for the electronic database (e.g. the herbarium at the BGBM uses the barcodes for the herbarium vouchers as UnitIDs for the electronic database). However, in other collections, the original voucher ID might differ from the UnitID in the electronic database. In this case, a wrapper query for the voucher ID would fail and the user has to investigate for the accordant UnitID.

Collection databases

The respective collection database can be selected from either the 'internal' or the 'external' rolldown menu, which include all databases currently integrated in (associated with?) the DNA-Bank Network. If the respective database is not yet integrated, it is possible to add a new specimen provider.

There are several cases, why a specimen number might currently not be available:

  • The respective collection has no electronic database
  • The respective collection has an electronic database, but is not accessible online via Wrapper.
  • The electronic collection database is accessible online, but the wanted specimen data is not online yet.
  • The wanted specimen is in private ownership and thus not accessible online.

In these cases, please use the Specimen Tool to add offline specimen data. These offline data can later be replaced by eventually now online available collection database.

Add new specimen provider

New specimen databases can be integrated with the 'New specimen provider' menu. Specimen databases are generally hosted by provider (institutes, museums, collections etc.). The Provider-Url for each specific specimen database is generally available via GBIF (or alternatively from the respective institute).

Add new specimen provider
Add new specimen provider

This list shows three different examples of provider urls:
Example 1: http://ww3.bgbm.org/biocase/pywrapper.cgi?dsa=HerbariumImages
Example 2: http://aadc-maps.aad.gov.au/digir/digir.php
Example 3: http://www.biologie.uni-ulm.de/cgi-bin/biocase_new/www/pywrapper.cgi?dsa=zoological

In following, the standard procedure to add a new speceimen database via GBIF is described.

  1. Enter: http://data.gbif.org/welcome.htm
  2. Search for taxon name of the specimen -> 'Explore' -> 'Occurences'
  3. Add search filter: 'Catalogue Number' -> Enter Specimen No. -> Check 'Add filter' -> Check 'Search'
  4. In table 'Sample results' check 'View'
  5. Check 'Data set'
  6. Copy Provider Url ('Access Point Url') and paste into the 'Wrapper Url'-Field -> Check 'Verify'

If the Url does not exist yet, you can now set up a new provider/dataset. The following informations must be provided:

  • Database scheme ('Schema')
  • Digir Resource/Source (if using a Digir database)
  • View ('Bezeichnung')
  • Internal or external database

The database scheme is mandatory and can be selected from a rolldown menu list (ABCD 1.2, ABCD 2.05, ABCD 2.06, DarwinCore/Digir). This information can either be found directly in the Url (in the case of Digir databases) or retrieved by accessing the Url. The latter will display a xml-scheme, where 'Supportedschemas' provides the correct scheme information.

Example 2:

<SupportedSchemas request="true" namespace="http://www.tdwg.org/schemas/abcd/1.2" response="true">

Here, the ABCD 1.2 scheme is used.

If using Digir databases, the 'Resource' and 'Source' information is mandatory. These can also be retrieved by accessing the Url. In the header, you will find a line refering to 'source' and 'resource'.

Example 3:

<response>
  <header>
  <version>$Revision: 1.10 $</version>
  <sendTime>01-12-2007 01:28:09+1100<sendTime>
http://aadc-maps.aad.gov.au:80/digir/digir.php
  <destination>192.38.28.101</destination>
</header></response>

Here, 'seabirds' refers to the resource and the url refers to the 'source'.


DNA Details

In this section DNA extraction details can be linked with the respective voucher specimen. Furthermore, associated information like amplified fragments and associated Genbank Acc. No. and/or BOLD Process IDs can be added.

The following table provides explanations and an example to all DNA details.

DNA and Tissue Data Explanation Pre-defined Mandatory? Example
General Details:  
DNA Extraction Number A unique identifier or code for this individual DNA sample. No Yes ZFMK-DNA ColCar 0399
Relation to Voucher Relation between DNA/Tissue and voucher specimen. Yes Yes DNA from specimen (voucher)
Tissue Type of tissue No Yes leg
Preservation Method of preservation Yes Yes in alcohol (ethanol, 96%)
DNA Type Origin of DNA Yes No gDNA
Extraction Details:  
DNA Extraktion Date Date of DNA extraction;YYYY-MM-DD Yes Yes  
DNA Extraktion Method: DNA isolation kit (company/product name) or extraction protocol. No Yes; if unknown = "Unknown" Unknown
DNA Extraktion Staff Person who extraced DNA No Yes; if unknown = "Unknown" C.Blume/C.Etzbauer
Quality Details:  
DNA Purification Method DNA purification kit (company/product name) or protocol. Yes; if unknown = "Unknown" QIAquick PCR Purification Kit Qiagen
Ratio of Absorbance Assessment of DNA optical density No No 1,99 OD260nm/OD280nm
Concentration in ng/µl Concentration of DNA No No 26,64ng/µl
DNA Quality Rating of DNA quality Yes No high
Quality Check Date Date of DNA quality check;YYYY-MM-DD Yes No -
GenBank or BOLD Entries:  
Genetic Locus Yes No COI
GenBank Acc.No / Bold Process ID No No -
Link No No -
Notes:  
DNA Sample Provided by Person who provided the DNA Yes Yes; if unknown = "Unknown" Zoological Research Museum Alexander Koenig
Blocked Until Sample data will be visible via web portal but can not be ordered until two years or less from the given date; YYYY-MM-DD - No -
Remarks for Customers - - No -
Internal Remarks - - No -
Stock/Aliquots: 1)  
Fridge/Rack/Box - No -
Barcode - No -
Position Positon in fridge - No -
Source volume (µl) Original volume of aliquot - No -
Remaining volume (µl) Volume of aliquot left - No -
Price per Aliqout - - No -

1) Not shown in the DNA-Bank-Network webportal.

Comments on the DNA details

The DNA numbers are sorted in ascending order. 'Last DNA No.' displays the highest assigned DNA number, which generally (but not always) refers to the last entered number.

Extraction Number

The extraction code provided here should be exclusively numerical. Institutional codes might be added later for all provided data sets.

Relation to voucher

'No voucher available (voucher->observation)' should be selected, if only parts of an organism (blood, feathers or leaves) have been collected.

Tissue

'Tissue material gone': Please select this box, if the tissue used for DNA extraction has been used up.

Extraction date

'Extraction Date not available': Please select this box, if the extraction date cannot be determined any more.

Ratio of Absorbance

The ratio OD260nm/OD280nm provides an estimation of the purity of the sample. The measured value should range from 1.8 to 2.1. The ratio OD260nm/OD230nm provides an estimation of the purity against polysaccharides and polyphenol (important for some plants). The measured value should range above 2.0.

Block in General

Please select this box if DNA sample shall not be searchable or available via the DNA Bank Network's webportal. If box is not selected, the DNA sample can be ordered.


'Save' and 'Save + Carry Forward'

After succesfully filling out all fields for which you have or can provide information, please press 'save' to add the DNA details to the respective specimen voucher, or click on 'save and carry forward' if you wish to add DNA details to more than one specimen voucher, so that you do not have to fill out all fields again.

If you chose 'Save + Carry Forward' a new consecutively 'Extraction No.' will automatically be generated and all fields previously filled will contain the same information as the voucher you entered before.

If you just click on 'save new specimen', the DNA details will be saved to the database and you can start with a new, empty input-sheet.

Search/Edit

GenBank and BOLD entries