Difference between revisions of "Plants humanities"

From JSTOR Labs Wikibase
Jump to navigation Jump to search
Line 68: Line 68:
  
 
Conceptually, populating mentions data operates in much the same way as items, however, certain caveats exist. Mentions exist as part of a singular item, namely an herbal or a book. They are plants on a single page and exist as entities with properties at a point in time.
 
Conceptually, populating mentions data operates in much the same way as items, however, certain caveats exist. Mentions exist as part of a singular item, namely an herbal or a book. They are plants on a single page and exist as entities with properties at a point in time.
 +
 +
Explicit information about editing surface mention data can be found [https://kg.jstor.org/wiki/Surface_mentions here].
  
 
To record mentions in a book or herbal, follow the steps below:
 
To record mentions in a book or herbal, follow the steps below:

Revision as of 19:34, 19 November 2019

This is the main documentation page for those looking to edit the Plant Humanities Knowledge Graph. Please look here for information associated with knowledge graph creation and updates about the Plants Humanities project.

Introduction

In September 2018 Dumbarton Oaks and JSTOR Labs received partner grants from the National Endowment for the Humanities (NEH) to advance a Plant Humanities Initiative. These grants integrate elements of the digital humanities with scholarly programming, to set forth a new, interdisciplinary field that communicates the unparalleled significance of plants to human culture. The grant has three main goals: to provide innovative research and professional development opportunities for early-career humanists; to create a digital tool informed by the insights and needs of teachers and students as well as librarians and technical experts; and to supplement existing digitized resources with new primary source material, contextualize them, and disseminate them.

This knowledge graph aims to compliment that digital tool while extending current digitized resources. As such it employs Resource Description Framework (RDF) metadata standards that allow researchers to contribute to a semantic web architecture by cataloguing, navigating, and organizing data surrounding the cultural history of plants.

Knowledge Graph

The JSTOR Labs Plant Humanities Knowledge Graph emulates the technical and philosophical architecture of Wikidata. It is a collaboratively edited knowledge base committed to producing linked open data under a public domain license.

Background

Conceptually, this graph grew from the seed of Dumbarton Oaks' vast collection of herbals. While initial conversations centered on defining networks of catalogued plants, they rapidly expanded into exploring and recording the people involved in the creation and amelioration of these books. Not wanting to limit ourselves to traditional cataloguing ontologies, we have included ways of expressing this data beyond modern taxonomies. Where available, we include the ability to record things such as traditional uses, Galenic properties, and historic names. We additionally grant the ability to link to modern plant taxonomies. The benefit of a linked open data architecture is that these ontologies are not set in stone. Please let us know if there are any other properties we should include.

Using

The Plant Humanities Knowledge Graph is a document-oriented database focused on items, which represent topics, concepts, or objects. Each item is identified by a unique, "QID," number that enables basic information about an item to be stored without favoring any particular language. Fundamentally, an item consists of a label, a description, and some number of statements.

Editing and Contributing

Manual Edits

Please find below information about editing or creating an individual Knowledge Graph page.

Individual Knowledge graph entries can be updated or created manually once a username has been created. Please contact JSTOR Labs via email to create a username.

To add individual items

  1. Click on the Add New Item tag on the left tool bar of this page.
  2. Enter a label, description, and alias (if applicable). Please note that aliases are separated either by a new line (preferred) or the pipe symbol ( | ). Click create.
  3. Once the base document has been created, feel free to enter any additional properties through the 'add statement' button.
    1. A master list of properties can be found here.
    2. It may help to see some examples of items with many properties. Find some useful examples below:
      1. Persea americana
      2. Exoticorum libri decem
  4. Due to the experimental nature of this early-stage product, known data caveats are as follows:
    1. We only support images added from the Bioheritage Diversity Library. Thus, if you would like to link to individual pages within a book or herbal, please locate it on the BHL website and add the DOI under the property tag: full work available at (P134).
    2. If looking to add a linked property, for example, mentions in JSTOR Global Plants ... should we encourage this to be done manually?

Programatic Edits

This section includes information for the Dumbarton Oaks fellows about updating JSTOR's Knowledge Graph programmatically using a Google sheet interface.

Please note that if referencing an entity, the thing must exist before it can be referenced.

If the thing exists in the knowledge graph, refer to it as a QID rather than as an entity label.

Items

To add an item or series of items into the Knowledge Graph, follow the steps below:

  1. Search for item on Wikidata. If this item does not exist on Wikidata, skip to step two.
    1. Copy Wikidata QID from the webpage header. For example, a search for Cactaceae reveals a QID of Q14560.
    2. In the spreadsheet, paste the QID into 'wikidata id' column.
    3. If the 'wikidata id' column is populated, the remaining fields will be auto-populated based on Wikidata's fields. Based on what information is desired, proceed to step two.
  2. Populate 'label,' 'description,' 'aliases,' 'instance of,' 'subclass of' fields with string fields. Where apt, populate remaining fields with Wikidata QID information.
    1. For example, the Wikidata QID for Latin is Q397. This can be used to populate the 'language of work or name' field.
    2. As a reminder, these fields will be auto-populated based on what data is drawn from the 'wikidata id.'
  3. Once all desired fields are populated, write TRUE in the 'Ingest Data' column and click the 'Ingest Data' button.
    1. NB: A green pop-up will appear on Google Sheets, informing the user that a script is running and that a script has finished, however, the data fields will still remain empty. This is a known data lag, please be patient as the database updates.
  4. Upon completion of the script, a 'local id' will be produced (In the case of Cactaceae, QID Q994 will be produced).

Mentions

Conceptually, populating mentions data operates in much the same way as items, however, certain caveats exist. Mentions exist as part of a singular item, namely an herbal or a book. They are plants on a single page and exist as entities with properties at a point in time.

Explicit information about editing surface mention data can be found here.

To record mentions in a book or herbal, follow the steps below:

  1. First identify the plant that is mentioned in the book or herbal.
  2. Ensure the book is loaded into our local knowledge graph. If not proceed to our guide on loading books into our knowledge graph.
  3. Identify the columns paste the following:
    1. The page number (on the physical book copy)
    2. The URL for the page.
      1. Please note that at this time we only accept Biodiversity Heritage Library URLs
    3. The historic name
      1. Multiple historic names can be added in the same cell with space or pipe delimiters, or in separate rows (preferred entry method).
      2. A language tag is required. A comprehensive list of language codes recognized by Wikidata can be found here.
    4. A local QID for the main subject or modern name for the plant (species or genus) EXAMPLE
    5. Plant Description is a free-form text field
    6. Has Virtue requires items from a controlled vocabulary of virtues. See list here.
    7. Select one of the galenic qualities. This is controlled vocabulary representing the galenic properties and humors. See a full list here.
    8. Plant origin string is a free-form text field.
    9. If possible, the images are demarked through the image: page, Image: creator, Image creator name string, and image: inception fields. Here, the user identifies the page range of the mention (usually one page). They also denote the engraver, or artist as identified by either QID or string. Finally, inception is used to identify the creation date of those images.

Books and Herbals

Adding herbals to the knowledge graph follows much the same format as adding items:

  1. First look up the item in Wikidata. If it exists fill in supplemental material as desired. These facets could include author or printer information, or full work information.
  2. If Wikidata QID is provided, please note that existing fields do not need to be repeated on spreadsheet.
  3. If populating a field that requires a QID, ensure that the item exists in either Wikidata or the JSTOR Knowledge Graph.
  4. Once satisfied with the information given, populate the 'Ingest Data' cell with a TRUE value, and click the 'Ingest Data' button. This will run the script and generate a local knowledge graph id upon completion. There is a known lag, please give it a minute.

Knowledge Graph Query Service

The JSTOR Labs Knowledge Graph Query Service employs the standard SPARQL language to retrieve and manipulate data stored in the RDF format. SPARQL allows users to write queries as triples, conjunctions, disjunctions, and optional patterns. For more information on querying the Plant Humanities Knowledge Graph along with sample SPARQL queries please see our Plant Humanities Knowledge Graph Wiki.

Project Updates

Stay tuned.

Further Reading

Dumbarton Oaks

Plant Humanities Initiative

Dumbarton Oaks and JSTOR Launch Plant Humanities Initiative

JSTOR Plant Humanities Page

Dumbarton Oaks and JSTOR award Plant Humanities Fellowships

Wikimedia language codes/lists/all