skkg_collection_stats
skkg_collection_statsCount SKKG collection objects by dimension with search and field filters; add a breakdown to cross-tabulate two dimensions for distributions and how-many questions.
Instructions
Count SKKG objects by one dimension, with the filters of skkg_search_objects. A query narrows them like a search. Use it for "how many", "which most", and distributions; use skkg_search_objects to list the objects. An object counts once per value, so an object with two materials counts in both and the bucket counts can add up to more than total_objects; without_value counts the objects that have none. breakdown adds a second dimension per bucket (a cross table). Buckets carry filter, the skkg_search_objects arguments that list exactly their objects when added to this call's arguments (production decades have none). With a creator filter, the creator dimensions count only the creator rows it matches: with creator, dimension creator_role gives that creator's roles. Two creator dimensions (creator, creator_role, attribution) are crossed per creator row: creator by creator_role gives each creator's own roles. With no query and no filter, the whole collection is counted.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dimension": "<dimension>"
},
"name": "skkg_collection_stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Buckets per page; at most 50 with a breakdown | |
| lang | No | Language of vocabulary labels. Most vocabularies, materials and object types among them, have German labels only, which are returned whatever the language; titles and texts stay as recorded | de |
| epoch | No | Epoch label as SKKG dates objects, e.g. "19. Jh.", "1. Hälfte 20. Jh.". A term id ("type/…") or a German label, matched exactly except for case. | |
| order | No | count: largest buckets first (default); value: chronological, for the decade dimensions only (their default) | |
| query | No | German keywords over titles, inscriptions, object texts, and inventory numbers. Every word must occur; "a phrase" matches in order; a trailing * matches a prefix; OR between two words matches either; NOT before a word excludes it. Umlauts may be written ä or ae | |
| scope | No | Where the query matches: all (default), title, inscription, text (descriptions), or inventory_number | all |
| offset | No | ||
| creator | No | Creator: an actor id ("person/41") or a name ("Anker", "Albert Anker"). A name matches every person whose name contains all its words; applied_filters lists them | |
| date_to | No | Latest year of production; see date_from | |
| part_of | No | Object id (its parts) or object group id (its members) | |
| material | No | Material, e.g. "Holz", "Papier", "Silber". A term id ("type/…") or a German label, matched exactly except for case. | |
| breakdown | No | Optional second dimension, counted within each bucket of `dimension`; two creator dimensions are crossed per creator row: object_type (object type, as recorded (not rolled up to broader types)); material (material; an object with several counts in each); technique (technique); epoch (epoch ("19. Jh.")); object_copyright (copyright status of the object); provenance_status (provenance research status); image_license (licence of the primary image); creator (person or institution named as creator, "influenced by" included, as the creator filter matches); creator_role (role of a creator ("Künstler:in", "Verlag")); attribution (attribution qualifier ("zugeschrieben", "nach")); acquisition_type (how SKKG acquired it); acquisition_decade (decade of SKKG's acquisition); production_decade (decade of production, only for objects dated within one decade; no filter) | |
| date_from | No | Earliest year of production. Matches objects whose dating overlaps the range; undated objects never match | |
| dimension | Yes | What to count by: object_type (object type, as recorded (not rolled up to broader types)); material (material; an object with several counts in each); technique (technique); epoch (epoch ("19. Jh.")); object_copyright (copyright status of the object); provenance_status (provenance research status); image_license (licence of the primary image); creator (person or institution named as creator, "influenced by" included, as the creator filter matches); creator_role (role of a creator ("Künstler:in", "Verlag")); attribution (attribution qualifier ("zugeschrieben", "nach")); acquisition_type (how SKKG acquired it); acquisition_decade (decade of SKKG's acquisition); production_decade (decade of production, only for objects dated within one decade; no filter) | |
| has_image | No | Only objects with (true) or without (false) a published image | |
| technique | No | Technique, e.g. "bemalt", "vergoldet", "geschnitzt". A term id ("type/…") or a German label, matched exactly except for case. | |
| exhibition | No | Exhibition id: only objects shown in it | |
| literature | No | Literature id: only objects it refers to | |
| attribution | No | Attribution qualifier, e.g. "zugeschrieben", "nach", "Kopie nach". Applies to the same creator row as `creator`. A term id ("type/…") or a German label, matched exactly except for case. | |
| object_type | No | Object type, e.g. "Zeichnung" or "Malerei". A term id ("type/…") or a German label, matched exactly except for case. | |
| creator_role | No | Role of the creator, e.g. "Künstler:in", "Verlag", "Stecher:in". Applies to the same creator row as `creator`. A term id ("type/…") or a German label, matched exactly except for case. | |
| acquired_from | No | Who SKKG acquired the object from: an actor id or a name, as for `creator` | |
| breakdown_top | No | Values of `breakdown` per bucket, largest first. Default 10 | |
| image_license | No | Licence of the object's primary image: "CC0 1.0", "CC BY 4.0", or "©". A term id ("type/…") or a German label, matched exactly except for case. | |
| acquisition_type | No | How SKKG acquired the object, e.g. "Auktion", "Ankauf", "Schenkung". A term id ("type/…") or a German label, matched exactly except for case. | |
| include_narrower | No | Term filters also match narrower terms, e.g. "Malerei" includes "Malerei auf Papier". Default true | |
| object_copyright | No | Copyright status of the object itself: "gemeinfrei" or "Copyright". A term id ("type/…") or a German label, matched exactly except for case. | |
| provenance_status | No | Provenance research status: "klar", "geklärt", or "ungeklärt". A term id ("type/…") or a German label, matched exactly except for case. | |
| acquisition_year_to | No | Latest year of SKKG's acquisition | |
| exclude_attributions | No | Attribution labels or ids; leaves out objects with a creator so attributed. With `creator`, `creator_role`, or `attribution`, only the creator row those match counts, e.g. ["nach", "Kopie nach"] for works by the creator rather than after them | |
| has_provenance_chain | No | Only objects with (true) or without (false) a provenance chain before SKKG | |
| acquisition_year_from | No | Earliest year of SKKG's acquisition |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order | Yes | ||
| offset | Yes | ||
| buckets | Yes | ||
| has_more | Yes | ||
| returned | Yes | ||
| warnings | No | ||
| breakdown | No | ||
| dimension | Yes | ||
| data_as_of | No | ||
| with_value | Yes | Of these, objects with at least one value for `dimension` | |
| next_offset | No | ||
| total_buckets | Yes | ||
| total_objects | Yes | Objects the query and filters match | |
| without_value | Yes | ||
| applied_filters | No |