Appearance
Chapter overview
NOTEBOOK 05

Pipe Organ Dataset

You’re reading the fixed September 2026 · Cuntz worked examples edition.Current notebook ↗
RESOURCES / NOTEBOOK 05

Ask a question the corpus can answer

A good corpus query defines its unit, cohort and evidence requirements before counting. The thesis’s data stories show how this changes the interpretation of organ history.

Start with a denominator and a release

POD 1.6.0 reports 215,769 canonical organs, 143,880 organs with stop accounts and 3,604,579 public stop rows. The ratio 143,880 / 215,769 is about 66.7 percent. It describes the proportion of that release’s canonical organ records with stop accounts. It does not measure the percentage of organs worldwide that have been documented or the completeness of each recorded disposition.

The unit matters just as much as the denominator. A stop row is a published data row, not necessarily one unique physical stop across all sources and historical states. A source account, canonical instrument, state, location and workshop are different counting units. State which one your query uses, how duplicates are handled and how a join can multiply observations.

Three productive research directions

QuestionDefine before queryingInterpretation to avoid
How do stop names vary across regions and periods?Source spelling, pitch, division, state, date, region and the vocabulary mapping policy.Treating Praestant, Principal and Montre as timeless physical equivalents.
How do organ configurations change over time?Instrument identity, documented states, typed construction or alteration events and temporal uncertainty.Reading an updated catalogue description as a complete sequence of historical events.
How are builders and workshops connected?Resolved actor identities, typed participation, source grounding and the cohort’s coverage.Treating co-occurrence in a record as collaboration, kinship or apprenticeship.

Stop nomenclature is especially revealing because a familiar label can conceal different construction or usage. Preserve the original lexeme alongside a proposed normalized concept. A pitch designation or division can disambiguate a local account; a regional or historical convention may still require expert interpretation. A corpus can expose patterns and candidate comparisons without proving that all occurrences describe acoustically equivalent pipes.

Read a map as a map of documentation too

A dense cluster on a map may reflect a well-documented collection, an active source provider or easier geographic reconciliation. A sparse area may reflect a gap in source availability rather than a historical absence of instruments. Keep source and regional coverage visible, and distinguish an instrument’s location from the location of a source, workshop or repository. Unknown coordinate accuracy should remain unknown.

Temporal coverage has a similar problem. An exact-looking year can come from a broad estimate, a later catalogue or an event that concerns a rebuild rather than initial construction. Preserve date precision and event roles. Excluding records with uncertain dates may make a chart cleaner while systematically removing less-documented regions or periods; report that selection rather than treating the remaining cohort as neutral.

A reproducible query plan

  • Identify the exact POD release and distribution used. Retain its published identity and the relevant local file digest.
  • Write the research question and unit of observation in a sentence. Define the cohort, date interpretation and inclusion rules.
  • Inspect the supplied schema before joining tables. Check whether source accounts, states or repeated relations multiply rows.
  • Report the starting population, missing values, exclusions and final analyzed cohort. Keep unresolved identities and mappings inspectable.
  • Save the query or analysis script, vocabulary version and resulting table. Cite the corpus release as well as the notebook that explains the method.
Cuntz · Worked example#

What exactly does “1281” tell us?

An observation connects a property and a result to the thing observed. A unit gives the number a physical interpretation; a source selector identifies its evidential location.

Work through the example 3 STEPS

The published Cuntz manifest contains an observation for rank:ged:pipe:key-036 with property code GesL, value 1281, unit MilliM, and source-cell flag Holzgedackt 8!D9.

  1. Identify the subject and property

    The number belongs to the specified pipe entity and the workbook’s GesL property. It is not a dimension of the complete organ or an arbitrary distance on the screen.

  2. Retain value and unit together

    The stored value is 1281 millimetres. Converting it gives 1.281 metres; keep that conversion separate from the original source value and unit.

  3. Locate the source

    The observation links to the exact workbook realization, the measurement activity and the cell selector. A later reader can check the entry and consult the workbook’s definition of GesL.

BASIS FOR THIS EXAMPLE
  • Cuntz Positiv · VAO 0.5.0-rc.2 ↗

    Published manifest: identities, measurement observations, realization digests, profiles and rights. Exact examples checked against this release.

  • VAO Standard 0.5.0 ↗

    The standard contract is separate from the Cuntz dataset content version 0.5.0-rc.2.

The example reproduces a release observation; it does not independently remeasure the pipe or supply a calibration uncertainty that the record does not provide.

The useful distinction. A reusable measurement needs a subject, property, value, unit and evidence location.

What a defensible result looks like

A useful result might describe the distribution of a source spelling among a defined set of stop accounts in one release, with the number of accounts lacking date or location information. That is narrower and more reproducible than a statement about the universal prevalence of a stop. A follow-up can inspect representative source fragments, compare alternative mappings and test whether one provider dominates the pattern.

Navigator supports discovery of promising relations and cases. A fixed dataset distribution supports a recoverable analytical cohort. Use both: move from exploration to an explicit query, and from an aggregate back to individual evidence. The result then explains not only what the corpus contains, but how the available documentation supports the historical question.

Sources & further reading

  1. Pipe Organ Dataset 1.6.0

    Public versioned corpus and distributions. Counts and coverage in these notebooks refer to this release.

  2. Dominik Ukolov · Musikinstrumente im virtuellen Raum (2026)

    Dissertation submitted to Universität Leipzig, 11 September 2026. Chapter 4, especially §§4.1–4.3 and 4.6; §8.3.2, pp. 271–272. Page numbers refer to the printed manuscript pagination. The manuscript is not distributed by this website.

Page editions 2026-09-r5 ↓

Read a fixed snapshot of this chapter, or return to the current notebook.

Edition 2026-09-r5 · SHA-256 e1301ec7c8faPage metadata ↗