Data

Data note는 모델을 학습하기 전에 example, label, metadata, split, benchmark가 어떻게 만들어지는지 설명합니다. Applied AI에서는 architecture보다 dataset이 실제 문제를 더 강하게 정의하는 경우가 많습니다.

A dataset induces an empirical distribution:

Training과 evaluation은 이 empirical distribution이 의도한 deployment distribution과 맞을 때만 의미가 있습니다.

이동 지도

필요시작점이어서 확인할 것
define what one row meansExample unitData schema, Label semantics
define what must be held outSplit unitDataset split contract, Leakage
prepare raw recordsPreprocessing contractData preprocessing, Data lineage
describe a reusable datasetDataset cardMetadata and provenance, Data versioning
build a benchmarkBenchmark intakeBenchmark claim contract, Evaluation set design
handle imperfect labelsLabel noiseCensored label, Weak label
handle distribution problemsDataset shiftSampling bias, Class imbalance

Data Contract

Dataset은 table 파일이 아니라 claim을 가능하게 하는 contract입니다.

where is the raw example unit, is the model-ready input, is the label or target, is metadata, and is quality or filtering state.

PartAskRoute
raw unitwhat real object does one example represent?Example unit
processed inputhow does raw data become model input?Preprocessing contract, Representation contract
labelwhat exactly is measured or annotated?Label semantics, Annotation and labeling
metadatawhat source, context, time, group, protocol, or quality fields matter?Metadata and provenance
quality statewas the example valid, repaired, filtered, censored, weak, or missing?Missing data, Censored label, Weak label
versioncan the dataset be reconstructed?Data versioning, Data lineage

Identity, Representation, Label

These three should be kept separate.

LayerExampleCommon Mistake
identitymolecule, protein, document, subject, query, complexduplicate identity crosses train/test
representationtokenized text, graph, fingerprint, coordinates, embeddingrepresentation built using test or deployment-unavailable context
labelclass, scalar, rank, pose, preference, annotationlabel direction, unit, threshold, or censoring omitted

For computational biology, this separation is critical: a molecule can have many protonation/tautomer/stereo/conformer representations, and a protein can have sequence, domain, structure, MSA, template, or pocket representations. The dataset note should say which identity is being split and which representation the model sees.

Construction Order

Good data notes preserve the order of operations:

The dangerous step is fitting or choosing preprocessing on all data before split assignment. Any learned scaler, imputer, vocabulary, threshold, deduplication rule, feature selector, standardization choice, or retrieval index can become leakage if it sees validation/test information.

StepKeep
raw sourcesource, license, acquisition time, inclusion rule
schemafield names, units, identifiers, relations
identity resolutionduplicate and near-duplicate policy
split assignmentsplit unit, grouped counts, random seed or rule
preprocessingdeterministic vs learned, fit-on-train-only parameters
artifactfile/version/hash, shape, masks, quality flags
evaluationdenominator, invalid cases, metric and protocol

Claim Boundaries

Data issueClaim affected
weak split unitgeneralization claim
hidden duplicate or near-duplicatebenchmark validity
label noise or censoringmetric ceiling and calibration
source imbalanceOOD and robustness claim
preprocessing leakageall downstream evaluation
missing or filtered examplesdenominator and deployment readiness
unreconstructable versionreproducibility

Boundary With Other Sections

If the note is aboutPut it in
example unit, label, schema, split, preprocessing, provenancethis section
metric, baseline, uncertainty, threshold, evaluation protocol[[concepts/evaluation/index
checkpoint, artifact, environment, serving, run reproducibility[[concepts/systems/index
molecule, protein, assay, pocket, structure-specific data rules[[molecular-modeling/index
architecture, objective, optimizer, representation learning[[concepts/machine-learning/index
paper-specific dataset claim or benchmark table[[papers/index

Data notes answer “what examples and labels exist?” Evaluation notes answer “what claim does a score support?” Systems notes answer “can the artifact and run be reconstructed?”

Public Data Note Template

FieldWrite
Sourcepublic source, collection rule, version or date
Example unitrow, molecule, protein, document, complex, query, task trace
Identity keydeduplication key, grouping key, near-duplicate policy
Labelendpoint, unit, direction, threshold, censoring, annotation source
Metadatasource, time, protocol, target, species, assay, structure context
Splitsplit unit, train/validation/test rule, leakage controls
Preprocessingfit-on-train-only parameters, deterministic transforms, filters
Denominatorraw records, excluded records, valid records, evaluated records
Public boundaryprivate IDs, paths, collaborators, unpublished labels removed

For generated or filtered data, preserve the denominator:

주제 묶음

확인할 것

  • 하나의 example은 무엇인가?
  • split unit은 무엇인가?
  • dataset은 어떤 distribution을 대표해야 하는가?
  • field, unit, identifier, relationship을 정의하는 schema가 있는가?
  • target label은 무엇에서 만들어지는가?
  • label이 정확히 무엇을 의미하는가?
  • missing, censored, weak label이 명시적으로 표현되는가?
  • batch, source, protocol, time, species, target, structure context를 설명하는 metadata가 있는가?
  • collection bias 때문에 빠진 example은 무엇인가?
  • class 또는 label distribution이 imbalanced한가?
  • sampling bias가 validation을 deployment보다 쉽게 만들지 않는가?
  • train, validation, test, deployment 사이에 어떤 shift가 있는가?
  • split이 의도한 generalization claim과 맞는가?
  • 다른 사람이 dataset version과 filtering policy를 재구성할 수 있는가?
  • label이 noisy, censored, inconsistent, protocol-dependent하지 않은가?

구성 경로

  1. Define example unit and split unit.
  2. Write the data schema and label semantics.
  3. Specify the preprocessing contract.
  4. Record metadata and provenance and data lineage.
  5. Choose the sampling strategy and dataset split contract.
  6. Summarize the result in a dataset card.
  7. Design the evaluation set.
  8. Attach an evaluation protocol.
  9. Use benchmark intake and benchmark claim contract before treating a score as evidence for a paper claim.

Public Boundary

Public data notes should preserve reusable structure without exposing private datasets or unpublished results.

KeepRemove
dataset class and public sourceprivate dataset path or internal project name
schema patternreal private identifiers
split strategyprivate split files or user-specific labels
preprocessing contractcredentials, storage paths, internal tool endpoints
qualitative data issueunpublished metrics or collaborator details
public benchmark versionunreleased benchmark contents