Skip to content

Papyri.info Use Case

Hugh A. Cayless edited this page Oct 3, 2016 · 1 revision

Papyri.info has 3 "top-level" collections. These are interrelated, so information is crosslinked where it is related (e.g. 2 documents talking about the same publication, or 2 documents talking about the same source). The Duke Databank of Doucumentary Papyri (DDbDP) publishes editions, the Heidelberger Gasamtverzeichnis der griechischen Papyrusurkunden Ägyptens (HGV) publishes data about the sources and editions, and the Advanced Papyrological Information System (APIS) publishes catalog records from institutions with papyrus holdings. DDb and HGV pick what they consider to be the best edition, and DDb publishes that, deprecating older editions if it contained them. We plan to move away from that practice and keep all of the editions. So ultimately the model will be something like:

Source Document -> 1–n editions -> 1 metadata record -> images

There are complicating factors, but I won't go into them now. The short version is that a request for any DDb, HGV, or APIS record will bring with it any related information.

top level request

http://papyri.info/ddbdp for RDF, use http://papyri.info/ddbdp/turtle, or /n3, /rdf; /json gives you a JSON serialization of the SPARQL query response. The SPARQL query is a request for all outbound and inbound triples for a given URI (i.e. where the URI is )

response

{
  "http://papyri.info/ddbdp/p.fay" : {
    "http://purl.org/dc/terms/isPartOf" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp"
    }
     ]
  }
   ,
   "etc" : "..."
 }

The responses in DDb and HGV are a list of publication series and individual volumes. If a series is requested, the response is a list of the volumes therein, if a volume is requested, the response is a list of documents.

Series level request:

http://papyri.info/bgu/json

response

{
  "http://papyri.info/ddbdp/bgu" : {
    "http://purl.org/dc/terms/identifier" : [ {
      "type" : "uri" ,
      "value" : "Perseus:text:1999.05.0001"
    }
     ] ,
    "http://www.w3.org/1999/02/22-rdf-syntax-ns#type" : [ {
      "type" : "uri" ,
      "value" : "http://purl.org/ontology/bibo/Series"
    }
     ] ,
    "http://purl.org/dc/terms/isPartOf" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp"
    }
     ] ,
    "http://purl.org/dc/terms/bibliographicCitation" : [ {
      "type" : "literal" ,
      "value" : "BGU"
    }
     ] ,
    "http://purl.org/dc/terms/hasPart" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1"
    }
			] ,
	"etc" : "..."
	},

  "http://papyri.info/ddbdp/bgu;1" : {
    "http://purl.org/dc/terms/isPartOf" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu"
    }
     ]
  },
  "etc" : "..."
}

volume level request

http://papyri.info/ddbdp/bgu;1/json DDbDP URIs use identifiers in the form <series>;<volume>;<item>

response

{
	"http://papyri.info/ddbdp/bgu;1;1/source" : {
	"http://purl.org/dc/terms/isPartOf" : [ {
		"type" : "uri" ,
		"value" : "http://papyri.info/ddbdp/bgu;1"
	}
	 ]
	},
  "http://papyri.info/ddbdp/bgu;1;2/source" : {
    "http://purl.org/dc/terms/isPartOf" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1"
    }
     ]
    }
}

The volume contains source documents. These are not the pages one sees in the Papyrological Navigator, but the actual EpiDoc editions, so we'll detour slightly and ask about the page, http://papyri.info/ddbdp/bgu;1;2 instead.

request for page

http://papyri.info/ddbdp/bgu;1;2/json is a request for an item page

response

{
  "http://papyri.info/ddbdp/bgu;1;2/source" : {
    "http://xmlns.com/foaf/0.1/page" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2"
    }
     ]
  }
   ,
  "http://papyri.info/hgv/8961/source" : {
    "http://xmlns.com/foaf/0.1/page" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2"
    }
     ]
  }
   ,
  "http://papyri.info/ddbdp/bgu;1;2/annotation/5341328de15ed446a548a8928c4bae5d" : {
    "http://www.openannotation.org/ns/hasTarget" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2"
    }
     ]
  }
   ,
  "http://papyri.info/ddbdp/bgu;1;2" : {
    "http://xmlns.com/foaf/0.1/topic" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/hgv/8961/source"
    }
    , {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/source"
    }
     ]
  }
}

Note that this gets you metadata about the page, not the source for that page, http://papyri.info/ddbdp/bgu;1;2/source, which is the URI for the actual EpiDoc edition.

item level request

http://papyri.info/ddbdp/bgu;1;2/source/json

response

{
  "http://papyri.info/ddbdp/bgu;1;2" : {
    "http://xmlns.com/foaf/0.1/topic" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/source"
    }
     ]
  }
   ,
  "http://papyri.info/hgv/8961/source" : {
    "http://purl.org/dc/terms/relation" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/source"
    }
     ]
  }
   ,
  "http://papyri.info/ddbdp/bgu;1;2/source" : {
    "http://purl.org/dc/terms/identifier" : [ {
      "type" : "literal" ,
      "value" : "bgu.1.2"
    }
    , {
      "type" : "literal" ,
      "value" : "papyri.info/ddbdp/bgu;1;2"
    }
     ] ,
    "http://purl.org/dc/terms/relation" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/hgv/8961/source"
    }
    , {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/chr.mitt;;113/source"
    }
    , {
      "type" : "uri" ,
      "value" : "http://www.trismegistos.org/text/8961"
    }
    , {
      "type" : "uri" ,
      "value" : "http://papyri.info/trismegistos/8961"
    }
     ] ,
    "http://purl.org/dc/terms/replaces" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/chr.mitt;;113/source"
    }
     ] ,
    "http://purl.org/dc/terms/source" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/work"
    }
     ] ,
    "http://purl.org/dc/terms/isPartOf" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1"
    }
     ] ,
    "http://xmlns.com/foaf/0.1/page" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2"
    }
     ]
  }
   ,
  "http://papyri.info/ddbdp/bgu;1" : {
    "http://purl.org/dc/terms/hasPart" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/source"
    }
     ]
  }
   ,
  "http://papyri.info/ddbdp/chr.mitt;;113/source" : {
    "http://purl.org/dc/terms/isReplacedBy" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/source"
    }
     ] ,
    "http://purl.org/dc/terms/relation" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/source"
    }
     ]
  }
   ,
  "http://www.trismegistos.org/text/8961" : {
    "http://purl.org/dc/terms/relation" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/source"
    }
     ]
  }
   ,
  "http://papyri.info/trismegistos/8961" : {
    "http://purl.org/dc/terms/relation" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/source"
    }
     ]
  }
}

The EpiDoc source has lots of relationships in papyri.info. One of those points to the source for the EpiDoc edition, the print edition BGU 1 2, with the URI http://papyri.info/ddbdp/bgu;1;2/work.

request for publication

http://papyri.info/ddbdp/bgu;1;2/work/json

response

{
  "http://papyri.info/ddbdp/bgu;1;2/source" : {
    "http://purl.org/dc/terms/source" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/work"
    }
     ]
  }
   ,
  "http://papyri.info/ddbdp/bgu;1;2/work" : {
    "http://purl.org/dc/terms/source" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/original"
    }
     ]
  }
}

The printed publication in turn has a source, the original document on papyrus, http://papyri.info/ddbdp/bgu;1;2/original.

request for original

http://papyri.info/ddbdp/bgu;1;2/original/json

response

{
  "http://papyri.info/ddbdp/bgu;1;2/original" : {
    "http://lawd.info/ontology/foundAt" : [ {
      "type" : "uri" ,
      "value" : "http://pleiades.stoa.org/places/737053#this"
    }
     ]
  }
   ,
  "http://papyri.info/ddbdp/bgu;1;2/work" : {
    "http://purl.org/dc/terms/source" : [ {
      "type" : "uri" ,
      "value" : "http://papyri.info/ddbdp/bgu;1;2/original"
    }
     ]
  }
}

Clone this wiki locally