{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.percentage","code":"thing-percentage","url":"https://ver.cy/models/thing/percentage/","name":"percentage","alternateNames":["percent","per centum","pct","absentee rate","occupancy rate","hospital occupancy","hotel occupancy","vacancy rate","unemployment rate"],"kind":"thing","status":"published","version":"0.2.0-wave.1","language":"en","classifiers":{"family":"Thing Registry","category":"Cross-cutting context","entryKind":"noun.relation","plane":"XCT","domain":["XCT.REL"],"industry":[],"navPath":"","tags":[],"facets":{"substance":"abstract","origin":"conceptual","agency":"inert","mobility":"not-applicable","scale":"not-applicable","affordances":["observable"]}},"whatItIs":"A proportion expressed as a number of parts per hundred, written with the percent sign (%), used for rates such as interest, occupancy, absentee and growth rates; changes may be expressed in percent or percentage points.","purpose":"Let an agent handle percentages by calculation, interpretation and communication, avoiding common confusions.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Parts per hundred","Relative measure","Easily misread","Used everywhere"],"structure":{"bundles":[{"id":"calculation","name":"Calculation","description":"Computing.","layers":[{"id":"percent-of","name":"Percent of","description":"Basic.","findings":[{"id":"percent-of-finding","name":"Percent of","description":"Basic percentage.","questions":[{"text":"What is this percentage of the given amount?","kind":"measurement"},{"text":"What is the base?","kind":"definition"}]}]},{"id":"change","name":"Change","description":"Percentage change.","findings":[{"id":"change-finding","name":"Change","description":"Percentage change.","questions":[{"text":"What is the percentage change from the old to the new value?","kind":"measurement"},{"text":"Is the base the old value?","kind":"boundary"}]}]}]},{"id":"interpretation","name":"Interpretation","description":"Meaning.","layers":[{"id":"points","name":"Points","description":"Percentage points.","findings":[{"id":"points-finding","name":"Points","description":"Percentage points.","questions":[{"text":"Is the change in percent or percentage points?","kind":"boundary"},{"text":"How should it be stated?","kind":"action"}]}]},{"id":"relative","name":"Relative","description":"Relative versus absolute.","findings":[{"id":"relative-finding","name":"Relative","description":"Relative versus absolute.","questions":[{"text":"Is a large relative change hiding a small absolute change?","kind":"boundary"},{"text":"Should both be shown?","kind":"action"}]}]}]},{"id":"rates","name":"Rates","description":"Applied rates.","layers":[{"id":"definition","name":"Definition","description":"Rate definition.","findings":[{"id":"definition-finding","name":"Definition","description":"Rate definition.","questions":[{"text":"How is this rate, such as occupancy or absentee rate, defined?","kind":"provenance"},{"text":"Over which period?","kind":"definition"}]}]},{"id":"finance","name":"Finance","description":"Interest rates.","findings":[{"id":"finance-finding","name":"Finance","description":"Interest rates.","questions":[{"text":"Is the rate nominal, effective or APR?","kind":"definition"},{"text":"Is the user asking for personal financial advice?","kind":"boundary"}]}]}]},{"id":"learning","name":"Learning","description":"Teaching.","layers":[{"id":"convert","name":"Convert","description":"Forms.","findings":[{"id":"convert-finding","name":"Convert","description":"Conversion.","questions":[{"text":"How is this percentage written as a fraction or decimal?","kind":"action"},{"text":"Is rounding appropriate?","kind":"boundary"}]}]},{"id":"mistakes","name":"Mistakes","description":"Common errors.","findings":[{"id":"mistakes-finding","name":"Mistakes","description":"Common errors.","questions":[{"text":"Is a percentage increase followed by the same decrease wrongly assumed to cancel out?","kind":"boundary"},{"text":"How can it be explained?","kind":"action"}]}]}]}]},"agentConduct":{"may":["Compute and report percentages with their base stated.","Distinguish percentage points from percentages."],"mustNot":["Present percentages without the base in a way that misleads.","Confuse percentage points with percent changes.","Present relative risk changes without absolute risks in health information."],"requiresHuman":["Using percentage thresholds in decisions about people."]},"ethics":{"considerations":["Misleading percentages distort health, finance and political information."],"affectedParties":["The public","Patients","Borrowers"]},"owners":{"steward":"Nobody owns the concept; it is held in common.","roles":[],"masterSystems":[]},"relations":[{"target":"oewn-13837954-n","type":"parent","note":"registry parent class"},{"target":"proportion","type":"related","note":"category"},{"target":"fraction and decimal","type":"related","note":"forms"},{"target":"statistics","type":"related","note":"field"},{"target":"percentile","type":"related","note":"different measure"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.percentage","Open English WordNet: oewn-13839738-n"]},"properties":{"applicability":"not-applicable","items":[]},"recognition":{"applicability":"optional","items":["Percent sign","Rates such as occupancy rate","Per mille uses parts per thousand","Numbers with a % sign."]},"capabilities":{"applicability":"required","items":["calculate percentages and percentage changes","distinguish percent and percentage points","convert between fractions, decimals and percentages","communicate rates clearly"]},"hazards":{"applicability":"required","items":["Confusing percent and percentage points","Misleading relative changes","Adding percentages incorrectly"]},"interfaces":{"applicability":"required","items":["ISO 80000-1 on the percent sign","Consumer credit rules on APR disclosure"]},"context":{"applicability":"required","items":["Comparing proportions and rates.","simple percentages","percentage change","percentage points","rates such as interest or occupancy","percentiles (related but different)"]}},"sources":[{"title":"Open English WordNet 2024, synset oewn-13839738-n","url":"https://en-word.net/id/oewn-13839738-n","note":"sense and gloss of the concept"},{"title":"Wiktionary: percentage","url":"https://en.wiktionary.org/wiki/percentage","note":"word senses and usage"}],"openQuestions":["Should rates be separate entries?","How should percentiles be split off?","How should APR be linked?"],"resources":{"spec":"/models/things/publications/thing-percentage/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-percentage/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-11T10:55:24Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T12:16:28+00:00: completeness 1.00; sense: WordNet gloss; 2 live sources; review by codex: pass","interaction.properties":"Plane XCT: no invented physical properties."},"score":1.0}}