IPIF / prosopogrAPhI

Tentative way towards a shared API for prosopographical data based on the factoid model (Bradley/Short 2005)
24 stars 6 forks source link

add param `independentStamtent` to make combination of parameters explicit #30

Open GVogeler opened 2 years ago

GVogeler commented 2 years ago

As described in Vogeler, Georg, Hadden, Richard, Schlögl, Matthias, & Vasold, Gunter. (2022, March 7). Prosopographische Interoperabilität (IPIF) - Stand der Entwicklungen. DHd 2022 Kulturen des digitalen Gedächtnisses. 8. Tagung des Verbands "Digital Humanities im deutschsprachigen Raum" (DHd 2022), Potsdam. https://doi.org/10.5281/zenodo.6328211 and Matthias Schlögl, Georg Vogeler, Gunter Vasold, Richard Hadden. "IPIF - pragmatic modelling decisions", presentation at the Data for History Conference, Berlin, 9.6.2021, https://d4h2020.sciencesconf.org/data/pages/Schlo_gl_Vogeler_Vasold_IPIF_2.pdf the combination of parameters as in https://example.org/ipif/v0.1/person/?name=Georg&place=Graz&from=2010&to=2015 has two possible interpretations: searching for one statement matching all parameters or applying the filter parameters to different statements. Both are sensible interpretations. We suggest to use the frist interpertation as default and make second one accesible via an optional filter parameter independentStatement=true .

GVogeler commented 2 years ago

The option can include three cases:

  1. false='and' in a single statement
  2. matchAll= 'and' in 1-n statements
  3. matchAny= 'or' in 1-n statements
GVogeler commented 2 years ago

Keeping the parameter optional would be achieved by excluding it from complianceLevel=1