Difference between revisions of "DiversityDescriptions Quiz (Artenquiz)"

From Diversity Workbench
Jump to: navigation, search
(Database: gray tables (=unused by the quiz))
(+section New projects)
Line 81: Line 81:
 
     fontcolor="gray"
 
     fontcolor="gray"
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
       <tr><td BGCOLOR="#cee12c" colspan="2">CategoricalSamplingData</td></tr>
+
       <tr><td BGCOLOR="#cee12c" colspan="2"><font color="black">CategoricalSamplingData</font></td></tr>
 
       <tr><td PORT="id">id</td><td></td></tr>
 
       <tr><td PORT="id">id</td><td></td></tr>
 
       <tr><td PORT="sampling_unit_id">sampling_unit_id</td><td>ut_1</td></tr>
 
       <tr><td PORT="sampling_unit_id">sampling_unit_id</td><td>ut_1</td></tr>
Line 253: Line 253:
 
     tooltip="Mapping of a quantitative descriptor to a categorical state"
 
     tooltip="Mapping of a quantitative descriptor to a categorical state"
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
       <tr><td BGCOLOR="#e5c96a" colspan="1">DescriptorMapping_Q2C</td></tr>
+
       <tr><td BGCOLOR="#e5c96a" colspan="1"><font color="black">DescriptorMapping_Q2C</font></td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="from_descr_id">from_descr_id</td></tr>
 
       <tr><td PORT="from_descr_id">from_descr_id</td></tr>
Line 481: Line 481:
 
     fontcolor="gray"
 
     fontcolor="gray"
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
       <tr><td BGCOLOR="#cee12c" colspan="1">QuantitativeSamplingData</td></tr>
+
       <tr><td BGCOLOR="#cee12c" colspan="1"><font color="black">QuantitativeSamplingData</font></td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="measure_id">measure_id</td></tr>
 
       <tr><td PORT="measure_id">measure_id</td></tr>
Line 496: Line 496:
 
     tooltip="The quantitative data recorded for a sampling event" fontcolor="gray"
 
     tooltip="The quantitative data recorded for a sampling event" fontcolor="gray"
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
       <tr><td BGCOLOR="#00c900" colspan="2">QuantitativeSummaryData</td></tr>
+
       <tr><td BGCOLOR="#00c900" colspan="2"><font color="black">QuantitativeSummaryData</font></td></tr>
 
       <tr><td PORT="id">id</td><td></td></tr>
 
       <tr><td PORT="id">id</td><td></td></tr>
 
       <tr><td PORT="measure_id">measure_id</td><td>ut_1</td></tr>
 
       <tr><td PORT="measure_id">measure_id</td><td>ut_1</td></tr>
Line 591: Line 591:
 
     tooltip="A sampling event may contain many sampling units" fontcolor="gray"
 
     tooltip="A sampling event may contain many sampling units" fontcolor="gray"
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
       <tr><td BGCOLOR="#cee12c" colspan="1">SamplingEvent</td></tr>
+
       <tr><td BGCOLOR="#cee12c" colspan="1"><font color="black">SamplingEvent</font></td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="description_id">description_id</td></tr>
 
       <tr><td PORT="description_id">description_id</td></tr>
Line 610: Line 610:
 
     tooltip="Categorical data" fontcolor="gray"
 
     tooltip="Categorical data" fontcolor="gray"
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COlOR="gray">
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COlOR="gray">
       <tr><td BGCOLOR="#cee12c" colspan="1">SamplingUnit</td></tr>
+
       <tr><td BGCOLOR="#cee12c" colspan="1"><font color="black">SamplingUnit</font></td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="sampling_event_id">sampling_event_id</td></tr>
 
       <tr><td PORT="sampling_event_id">sampling_event_id</td></tr>
Line 636: Line 636:
 
     tooltip="Specimens from collections; proxy for WB component" fontcolor="gray"
 
     tooltip="Specimens from collections; proxy for WB component" fontcolor="gray"
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
       <tr><td BGCOLOR="lightblue" colspan="1">SpecimenProxy</td></tr>
+
       <tr><td BGCOLOR="lightblue" colspan="1"><font color="black">SpecimenProxy</font></td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="id">id</td></tr>
 
       <tr><td PORT="label">label</td>u</tr>
 
       <tr><td PORT="label">label</td>u</tr>
Line 647: Line 647:
 
     tooltip="The statistical measures predefined according SDD 1.1 rev 5"
 
     tooltip="The statistical measures predefined according SDD 1.1 rev 5"
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
       <tr><td BGCOLOR="#e5c96a" colspan="2">StatisticalMeasure_Enum</td></tr>
+
       <tr><td BGCOLOR="#e5c96a" colspan="2"><font color="black">StatisticalMeasure_Enum</font></td></tr>
 
       <tr><td PORT="id">id</td><td PORT="id_e"></td></tr>
 
       <tr><td PORT="id">id</td><td PORT="id_e"></td></tr>
 
       <tr><td PORT="label">label</td><td>u</td></tr>
 
       <tr><td PORT="label">label</td><td>u</td></tr>
Line 762: Line 762:
 
     tooltip="Free-form text data recorded for a sampling event" fontcolor="gray"
 
     tooltip="Free-form text data recorded for a sampling event" fontcolor="gray"
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
 
     label=<<table BORDER="0" BGCOLOR="white" CELLBORDER="1" CELLSPACING="0" COLOR="gray">
       <tr><td BGCOLOR="#cee12c" colspan="2">TextSamplingData</td></tr>
+
       <tr><td BGCOLOR="#cee12c" colspan="2"><font color="black">TextSamplingData</font></td></tr>
 
       <tr><td PORT="id">id</td><td></td></tr>
 
       <tr><td PORT="id">id</td><td></td></tr>
 
       <tr><td PORT="sampling_unit_id">sampling_unit_id</td><td>ut_1</td></tr>
 
       <tr><td PORT="sampling_unit_id">sampling_unit_id</td><td>ut_1</td></tr>
Line 1,057: Line 1,057:
 
| sucess || tinyint || Was the taxon answered correctly by the user? (default: 0)
 
| sucess || tinyint || Was the taxon answered correctly by the user? (default: 0)
 
|}
 
|}
 +
 +
== New projects ==
 +
 +
Steps to enter data for anew project:
 +
Create a project (table: Project)
 +
* Project.code is important: it is used as URL part and within the Django application as internal project identifier it should never be changed
 +
* eventially create or associate scopes, like “female”, “male” (table: OtherScope, Project_AvailableScope)
 +
Eventually create the taxa (table: TaxonProxy)
 +
* associate taxa to the project (tables: TaxonSet, TaxonSet_Taxon)
 +
* associate images of taxa (tables: Resource, ResourceVariant, BaseEntity.specific_rights_text should contain the corresponding picture’s author name like: “© Author Name”). A set of maximum of 16 thumbs will be displayed
 +
*: resource variants as ReourceVariant_Enum.code "tiny_sample" (=thumb 75×75px) and "best_quality" (max 500×500px displayed) should have corresponding urls in ResourceVariant.url
 +
* eventually associate geographic area (table: GeographicAreaProxy, GeographicArea_Taxon)
 +
Create character and character states (table Descriptor, CategoricalState), character tree (tables: DescriptorTree, DescriptorTreeNode)
 +
* associate images to characters or character states (tables: Resource, ResourceVariant, BaseEntity.specific_rights_text should contain the corresponding picture’s author name like: “© Author Name”), size of images with maximal height 40px
 +
Make a project publically available: set the Project‘s tag (table: Tag)
 +
* tag "Artenquiz" means it is a quiz
 +
* tag "Public" means it will be publically available
 +
* tag "Identification" make the project availabel for identification (URL: …/mobile_bestimmung/)

Revision as of 08:42, 25 August 2014

DiversityDescriptions_Quiz (DD_Quiz) is a clone of DiversityDescriptions 3.00.10. July 17th, 2014 that is intended to work with the Web-Framework Django to have a quiz for species descriptions in German. This project is presently under development. Additional tables see below.

Hover the mouse over a table to jump to the documentation (linked to DiversityDescriptions 3.00.10. July 17th, 2014).

Documentation

Database

Graph image creation requires permission to upload.

The following conventions and abbreviations have been used in the tables: Columns of primary key:underlined. Categorical data are presented to a user in the quiz therefore some tables (in gray) are not used for the quiz.

Graph image creation requires permission to upload.


Table: Contribution

Multiple contributors may contribute in different roles

Column Data type Description
id int Database-internal ID of this record (primary key)
object_id int Reference (foreign key) to a BaseEntity
contributor_id int Reference (foreign key) to a contributor
role nvarchar (255) one of 'creator', 'contributor', 'editor', 'photographer'
timestamp datetime Time stamp of the contribution

Table: Contributor

People contibuting to a work. Roles are recorded in Contribution

Column Data type Description
id int Database-internal ID of this record (primary key)
avatar_uri nvarchar (255) Optional URI to an image representing the user (default: NULL)
email nvarchar (255) User’s email address (default: NULL)
linked_agent_uri nvarchar (255) Linking to agents managed in an external component (default: NULL)
real_name nvarchar (255) Optional name the user gave (full name) (default: NULL)
web_pseudonym nvarchar (255) Optional alternative name to display publicly on the web (default: NULL)

Note: in the Quiz all users/contributors are requested to input their full name.

Table: ResourceWatchedTime

The time a resource thumb was watched (=mouse hover)

Column Data type Description
id int Database-internal ID of this record (primary key)
resource_id int Reference (foreign key) to a resource
contributor_id int Reference (foreign key) to a contributor
watched_time int watched time in milliseconds

Table: TaxonQuiz

User’s correctly answered taxa.

unique together = ('project_id', 'contributor_id', 'taxon_id', 'scope_id')
Column Data type Description
id int Database-internal ID of this record (primary key)
taxon_id int Reference (foreign kex) to a taxon that has been answerd correctly
project_id int Reference (foreign key) to the project
contributor_id int Reference (foreign key) to a contributor
scope_id int Reference to a scope (default: 0)
points int Points through scoring characters, already 3 added if success (default: 0)
sucess tinyint Was the taxon answered correctly by the user? (default: 0)

New projects

Steps to enter data for anew project: Create a project (table: Project)

  • Project.code is important: it is used as URL part and within the Django application as internal project identifier it should never be changed
  • eventially create or associate scopes, like “female”, “male” (table: OtherScope, Project_AvailableScope)

Eventually create the taxa (table: TaxonProxy)

  • associate taxa to the project (tables: TaxonSet, TaxonSet_Taxon)
  • associate images of taxa (tables: Resource, ResourceVariant, BaseEntity.specific_rights_text should contain the corresponding picture’s author name like: “© Author Name”). A set of maximum of 16 thumbs will be displayed
    resource variants as ReourceVariant_Enum.code "tiny_sample" (=thumb 75×75px) and "best_quality" (max 500×500px displayed) should have corresponding urls in ResourceVariant.url
  • eventually associate geographic area (table: GeographicAreaProxy, GeographicArea_Taxon)

Create character and character states (table Descriptor, CategoricalState), character tree (tables: DescriptorTree, DescriptorTreeNode)

  • associate images to characters or character states (tables: Resource, ResourceVariant, BaseEntity.specific_rights_text should contain the corresponding picture’s author name like: “© Author Name”), size of images with maximal height 40px

Make a project publically available: set the Project‘s tag (table: Tag)

  • tag "Artenquiz" means it is a quiz
  • tag "Public" means it will be publically available
  • tag "Identification" make the project availabel for identification (URL: …/mobile_bestimmung/)