Commons:Biodiversity Heritage Library/Modeling

This documents BHL's data modeling for SDC statements for images derived from book scans.

Optional properties are labeled in yellow and required properties in green.

You can look at this Commons SPARQL query to see the conformant entries.

There were (as of Nov 2024), three places where this modelling is being discussed:

• here
• on a collaborative Google Spreadsheet.
• on a Google Document

These three versions included discrepancies and comments. They were sorted out for version 0.1 of the Data Model:

• This Google Docs

There has been an evolving spreadsheet capturing changes as they occur:

• This Google Spreadsheet

BHL Image Data Model - v0.1.6

For this model, we consider "BHL Images" all images (book pages, drawings, photographs, collages etc.) that were first digitized as part of the Biodiversity Heritage Library project.

Full Data Model

Wikidata Property Name	PID	Values	Qualifiers	References	Cardinality	STATUS	Definition
Instance of	instance of (P31)	illustration (Q178659), photograph (Q125191), illustrated text (Q131597974), text-only page (Q131729449), table of contents (Q1456936), title page (Q1339862), list of illustrations (Q12547062), colophon (Q372474), map (Q4006), bookplate (Q188456), foldout (Q2649400), and others	quantity (P1114) → Number (optional, for multiple photographs in one image)	–	Usually single	Required	The nature of the Image in respect to its art form. It will be used mostly to distinguish photos from drawings.
BHL Page ID	BHL page ID (P687)	Numeric ID (e.g. 33665243)	–	–	Always single	Required	Numeric identifier of a BHL page (e.g. biodiversitylibrary.org/page/33665243).
Published In	published in (P1433)	Wikidata publication	applies to part (P518) → analog work (Q112134971) (optional, analog work) volume (P478) → String (volume, recommended) plate(s) (P12275) → String (plate, optional)	reference URL (P854) → BHL Page URL (optional)	Usually single	Required	Wikidata item for the publication where this Image is derived from.
Collection	collection (P195)	Wikidata institution	object of statement has role (P3831) → holding institution (Q131597993) (Holding Institution, recommended)	reference URL (P854) → BHL Bibliography URL	Always single	Required	The holding institution for the digitized Item that originated this Image. Use the most granular institution possible.
Sponsor	sponsor (P859)	Wikidata institution	object of statement has role (P3831) → digitization sponsor (Q131344184) (Digitization Sponsor, recommended)	reference URL (P854) → BHL Bibliography URL	Always single	Required	The financial sponsor of the digitization of the item; not to be confused with the Holding Institution.
Depicts	depicts (P180)	Wikidata taxon	object named as (P1932) → Label in Image (optional) series ordinal (P1545) → Number (optional) relative position within image (P2677) → IIIF sector (optional)	based on heuristic (P887) → inferred from Commons subcategory for taxonomic illustrations (Q131478853) (Commons categories, optional) based on heuristic (P887) → inferred from Wikitext (Q131783016) (Wikitext, optional) based on heuristic (P887) → inferred from BHL's OCR (Q132359710) (BHL OCR, optional) based on heuristic (P887) → inferred from GBIF scientific name matching service (Q132907038) (GBIF match, optional) reference URL (P854) + based on heuristic (P887) → inferred from Flickr tags (Q131782980) (Flickr tags, optional)	Multiple	Recommended	The taxa depicted on the BHL Image. Should point to the current valid name, ideally at species/subspecies level.
Creator	creator (P170)	Name(s) of creator	object of statement has role (P3831) → illustrator (Q644687) (Illustrator), engraver (Q329439) (Engraver), lithographer (Q16947657) (Lithographer), painter (Q1028181) (Painter), etc. applies to part (P518) → analog work (Q112134971) (Analog work, optional)	reference URL (P854) → URL (optional) reference URL (P854) + based on heuristic (P887) → inferred from Flickr tags (Q131782980) (inferred from Flickr, optional)	Multiple	Recommended	The makers of the image. May include illustrator, author, engraver, photographer, etc.
Inception	inception (P571)	Date (YYYY-MM-DD preferred)	applies to part (P518) → analog work (Q112134971) (Analog work, optional) sourcing circumstances (P1480) → no later than (Q110290992) ("No later than", optional)	based on heuristic (P887) → inferred from publication date (Q110393725) (Inferred from publication, optional) reference URL (P854) → BHL URL (optional)	Usually single	Recommended	The date the photograph was taken or illustration was finished. May require inference from publication date.
Copyright Status	copyright status (P6216)	"public domain", "no known copyright restrictions", "copyrighted"	Applies to jurisdiction → United States (optional)	–	Single	Optional	General copyright status of the image.
Copyright license	copyright license (P275)	"cc-by-2.0", "cc-by-nc-sa-3.0", etc.	–	–	Single	Optional	License under which the copyrighted work is released. Applicable only to a minority of recent BHL images.
Source of the File	source of file (P7482)	file available on the internet (Q74228490) (file available on the internet)	–	–	Single	Optional	The direct source of the file uploaded to Commons (BHL, Internet Archive, Flickr).
RightsStatements.org statement	RightsStatements.org statement according to source website (P6426)	RightsStatements.org URI	–	–	Single	Optional (if applicable)	RightsStatements.org controlled vocabulary for copyright.
Flickr Photo ID	Flickr photo ID (P12120)	Flickr numeric ID	–	–	Single	Optional (if applicable)	Identifier for the image on Flickr. Useful for mapping between Commons and Flickr.