About this site 한국어

Unofficial explanatory translation of the Korean AI-Ready Data (AIRD) draft standard. The Korean text prevails.

Preparing data › Examples

Walkthrough with example data

Type · ProcedureReading time · about 10 minData providers

ContentsContents
  1. ① Data overview
  2. ② Writing the discovery layer
  3. ③ Measuring quality
  4. ④ Preparing for a purpose
  5. Remaining work and why

This page applies the preparation stages one by one to a single example file (20 business registration records) and shows what is recorded at each stage and how the measurement results change.

Example The example file contains fictional data for illustration. It does not refer to any real organization or data. The figures on this page were obtained by measuring the example file with this site’s measurement engine (test version). To reproduce the results, use the same input file · tool version · measurement rules.

① Data overview

Source file

The source file is example.csv, a CSV file with 20 rows · 8 columns in UTF-8 encoding. The first three rows are as follows.

bizIdbizNameindustryCoderegionCodeemployeeCountrevenueBandregisteredOnclosedFlag
B-2019-0001Gaon PrecisionC292941168042B32019-03-110
B-2019-0014Daeseong PackagingC222404113517B22019-05-020
B-2019-0033Hanbyeol ElectronicsC2642928185133B42019-07-190

At the start there is only the file, with no description.

Type judgment: tabular STRUCT — the example file has rows and columns, and each column has a defined datatype. [Part 1 5.6 Table 5-5]

Personal information check — business names are corporate information. However, the business name of a sole proprietor may count as personal information. The data provider does not decide this alone but checks it together with the department responsible for personal information protection. The check procedure is in Checking your data.

② Writing the discovery layer (metadata elements · column schema)

Example data · measured In stage 1, the data provider fills in the discovery layer of the manifest. Stage 1 does not change data values. What stage 1 adds is information that explains the meaning · format · origin of the values.

What the data provider filled in: 19 dataset metadata elements

19 dataset metadata elements — expand 17-row table
ElementValue entered
Identifierhttps://data.example.go.kr/id/dataset/biz-registry
TitleExample business registry
DescriptionDataset of registration information and business status of workplaces by region
Keywordbusiness · industry classification · region · business status (4)
Data service typeFILE (file)
Dataset structure typeStructured (tabular)
LanguageKOR
Lifecycle statusDiscoverable
ThemeINDUSTRY_EMPLOYMENT
Landing pagehttps://data.example.go.kr/dataset/biz-registry
Creator · publisherExample Agency
Maintaining department · contact pointExample Agency Data Management Team · data@example.go.kr
Creation methodcollected (survey · measurement)
Update frequencyANNUAL (once a year)
LicenseKOGL-1 (KOGL Type 1, Korea Open Government License)
RightsKOGL Type 1. Commercial use and modification are allowed with attribution of the source.
Access rightsPUBLIC

For value-list elements, choose a notation value (for example KOR · KOGL-1). The manifest holds the concept URI from the AIRD vocabulary. How to fill in each element is in Metadata elements.

The example organization has no identifier assignment policy. So the data provider applied the default pattern from Choosing persistent identifiers, https://data.<organization domain>/id/dataset/<name>. The dataset identifier is as follows.

https://data.example.go.kr/id/dataset/biz-registry

What the data provider filled in: column schema for 8 columns

The data provider recorded the datatype and description of the 8 columns in the column schema (csvw:tableSchema).

Column schema — expand 8-row table
ColumnDatatypeDescription
bizIdstringUnique business registration number. Format B-YYYY-NNNN. Required column
bizNamestringBusiness name
industryCodestringKorean Standard Industrial Classification sub-class code
regionCodestringAdministrative standard code: legal-district city/county/district code
employeeCountintegerNumber of regular employees. From 0 to 100000
revenueBandstringRevenue band code. B1 to B4
registeredOndateDate of first registration. ISO 8601-1 date
closedFlagintegerClosure flag. 0 is operating, 1 is closed

The data provider marked bizId as a required column. The diagnostic tool can measure D1-01 (Required field completeness) only when required columns are marked.

The data provider must also record the meaning of code values. For example, if it is not recorded which revenue band B3 in revenueBand stands for, users and agents cannot interpret the revenueBand column.

The “from 0 to 100000” in the employeeCount description is a description for people to read. For the diagnostic tool to measure D5-02 (Numeric range validity), the minimum · maximum (minimum · maximum of the CSVW datatype) must be recorded separately in the column schema’s datatype. This example records them only in the description, so D5-02 remains not measured.

4 distribution metadata elements

ElementValueRecorded by
Access URLhttps://data.example.go.kr/aird/.../example.csvData provider
Media typetext/csvMeasurement engine
File formatCSVData provider
Checksum7ad8add25d7a6383… (SHA-256)Computed from the file by the measurement engine

The measurement engine also produced per-column observations (share of non-empty values · number of distinct values · sample values). In this example the measurement engine computed the checksum. The data provider can also compute the checksum directly with a common tool such as sha256sum.

③ Measuring quality

Example data · measured The example file was measured twice with this site’s measurement engine (test version). The first time, only the file existed. The second time was after the stage 1 metadata elements were filled in and bizId was designated as the record key. The figures below are measured values, not calculation examples.

File only compared with after stage 1

ItemFile onlyAfter stage 1
Metadata elements1 / 2323 / 23
Column descriptions0 / 88 / 8
Required formal indicators measured6 / 137 / 13
Diagnostic Maturity (DM)DM-0 (provisional)DM-0 (provisional)
Quality tierNot judged: no operating guideline appliedNot judged: no operating guideline applied
Judgments the agent must guess102
  • The 1 metadata element met with the file only is the checksum that the measurement engine computed from the file.
  • After stage 1, one more indicator was measured. Because the data provider marked bizId as required, D1-01 (Required field completeness) became measurable.
  • The data values did not change. Only the recorded information needed to interpret the values increased.

The 4 minimum measurable indicators (MMI) (D5-03 · D6-01 · D7-01 · D7-02) were measured in both runs. Because there is no operating guideline, D5-03 (Statistical plausibility) is a provisional value measured with the example patterns in [Part 2 Appendix I]. Only 7 of the 13 required formal indicators were measured, so the Diagnostic Maturity does not reach DM-2. The decision table that determines Diagnostic Maturity is in Judgment procedure.

The quality tier was not judged because no operating guideline was applied, not because of the data. Even if every score is 1.0000, no tier is judged without an operating guideline. The assessment status PROVISIONAL in the diagnostic report means a provisional measurement; it is not a tier.

Indicator scores with the file only

rows 20 · columns 8 · encoding UTF-8

1. Metadata elements (23)   met 1 / 23
2. Column schema            none: a draft is generated from headers and values
3. Quality measurement
     D1-02  Required metadata completeness   0.0435
     D5-01  Format validity                  1.0000
     D5-03  Statistical plausibility         1.0000 (provisional)
     D6-01  Uniqueness                       1.0000
     D7-01  Encoding consistency             1.0000
     D7-02  Technical validity               1.0000

The file opens and its format is valid, but there is no description. Because no record key was designated, D6-01 (Uniqueness) was measured over the combination of all columns.

Indicator scores after stage 1

IndicatorWhat is measuredScore
D1-01Required field completeness1.0000
D1-02Required metadata completeness1.0000
D5-01Format validity1.0000
D5-03Statistical plausibility · MMI1.0000 (provisional)
D6-01Uniqueness · MMI1.0000
D7-01Encoding consistency · MMI1.0000
D7-02Technical validity · MMI1.0000

All 20 records had the correct format, so there were no values to fix. The example file has had its format errors removed. With real data, D5-01 (Format validity) and D7-01 (Encoding consistency) can measure below 1.0000. Measurement results for real public-sector data are in Public data examples.

Indicators not measured and why

The diagnostic report records the indicators not measured together with the materials needed to measure them. The 6 indicators not measured for the example file are listed below. This list is the list of materials the data provider has to obtain.

IndicatorMaterials needed for measurement
D2-01 Inter-field consistencyRelationship rules defined in the column schema or the manifest
D2-02 Referential integrityActual values of the master code table to compare against (an address or reference alone is not enough)
D2-03 Derived value accuracyDefinition of the rules for calculating derived values (not applicable if no derived values are stored)
D3-01 Standard name conformanceAn authoritative reference usable as a code–name mapping. The data must contain both codes and names
D4-01 CurrencyReference date and update history
D5-02 Numeric range validityDefinition of the allowed numeric range per column

How to read the reasons for not measuring is in Reading the diagnostic report (stage 2).

Diagnostic report excerpt

generatedAt   2026-10-05T...
datasetFile   example.csv
fileChecksum  SHA-256 7ad8add2...
dataType      STRUCT
recordCount   20
indicators    D1-01 1.0 (required) · D5-01 1.0 (required) · D5-03 1.0 (required · provisional) · ...
notMeasured   D2-02 (required): compare against actual values of the master code table
              D3-01 (required): an authoritative reference is needed
formalAssessmentCoverage  0.5385
diagnosticMaturity        DM-0
assessmentStatus          PROVISIONAL
thresholdProfile          example profile (EXAMPLE)
note   Provisional diagnostic report produced with an example profile. Do not use for official disclosure or cross-organization comparison.
  • formalAssessmentCoverage 0.5385 is a coverage value meaning that 7 of the 13 required formal indicators were measured. It is not a quality score or a tier.
  • assessmentStatus PROVISIONAL is the assessment status indicating that D5-03 was measured provisionally with example patterns.
  • The example threshold profile in thresholdProfile has the status EXAMPLE. An example threshold profile is for provisional calculation only and is not used for tier judgment.

④ Preparing for a purpose

Example data · measured The data provider identifies the use purposes that the example data can support. The review is limited to purposes relevant to the example data.

Use purposeRelevance of the example dataJudgment
ML (machine learning)Label column candidate closedFlag (closure flag)Candidate
KG (knowledge graph)Standard code columns industryCode · regionCodeCandidate
Stats (statistical analysis)registeredOn is a registration date, not a time-ordered measurementNot applicable
RAG (retrieval-augmented generation)No natural-language documentsNot applicable
DL (deep learning)No imagesNot applicable
FineTuning (fine-tuning)No instruction · response pairs (PT)Not applicable

Choosing purposes alone does not complete stage 3. The output of stage 3 is a purpose-specific operation file, one per purpose type. A purpose tier is judged only when the purpose profile for that purpose is registered. If the purpose profile is not registered, the data provider records the purpose tier as “not judged” together with the reason PROFILE_NOT_REGISTERED (purpose profile not registered).

Stage 3 is carried out after the use purpose is confirmed. By completing stage 1, the example data meets the metadata requirements of Discoverable, and it has a stage 2 diagnostic report. To become Quality-Ready, it needs Diagnostic Maturity DM-2 and a tier of Tier 1 or higher judged under an operating guideline.

Remaining work and why

The example file has completed stage 1 metadata and stage 2 measurement. Diagnostic Maturity DM-2 · the quality tier · purpose-specific operation files remain. The data provider records the reason for each remaining item by category, and does not mix unmet requirements in the data itself with the absence of an operating guideline. The list of reasons is in Status and judgment values.

Reason categoryMeaningItems for the example file
Can be done nowNo additional materials neededDesignating the record key · entering metadata elements (done in stage 1) · recording limitations
Can be done after obtaining materialsMaterials to obtain and the indicators they make measurableCode tables → D2-02 · D3-01; reference date · update history → D4-01
Outside the data provider’s scopeRecord the reason and waitApplying an operating guideline → quality tier judgment

Follow-up actions for the data provider

The follow-up action list that the measurement engine produced with the diagnostic report is as follows.

  1. Obtain the industry classification · legal-district code tables. Result: D2-02 (Referential integrity) can be measured.
  2. Obtain code–name mapping materials. Result: D3-01 (Standard name conformance) can be measured.
  3. Compile the reference date and update history. Result: D4-01 (Currency) can be measured.
  4. Record limitations that cannot be fixed. Example: “closedFlag may be updated later than the actual closure because closure reports are filed late.” Result: recorded limitations in the understanding layer of the manifest.
  5. Apply an operating guideline and re-measure the indicators it requires. Needed: the operating guideline provided with the standard (published when the standard is established, expected December 2026) or an operating guideline built and published by your organization. Result: a new diagnostic report and a tier judged under that operating guideline.
Last updated · 2026-10-07Report an error