cleandataengineering.aiData Platform, from the big picture to the code
You are here: Start here › Code map › Who calls what › world

Data PlatformZoom level 3

Who calls what: world

Every class, function and method in the world package, with who calls it. Found by reading the code. A call written as object.method() is matched by the method's name, so a same-named method elsewhere can appear: those rows say by name.

196 definitions in 12 modules. Jump to a module: clock.py · __init__.py · clinical.py · clinical_gold.py · clinical_oracle.py · tyre.py · tyre_gold.py · tyre_oracle.py · dwd.py · engine.py · oracle.py · shop.py

world/clock.py

The simulated clock (DPC-0032: jobs read time only through the clock port). A world day is one business day in the business time zone; day 1 starts at the DWD's clock.start. The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
SimClock
class, line 12
ClinicalTrial.__init__ · world/domains/clinical.py:134
TyreCompany.__init__ · world/domains/tyre.py:94
no test names it
SimClock.__init__
method, line 13
none found in the codeno test names it
SimClock.day_start
method, line 17
00:00 business time on the given world day, as an aware datetime.SimClock.day_end · world/clock.py:23
SimClock.date · world/clock.py:26
SimClock.at · world/clock.py:29
Harness.build · twin/runner.py:88 (by name)
ClinicalTrial._sites · world/domains/clinical.py:752 (by name)
ClinicalTrial._readings · world/domains/clinical.py:788 (by name)
and 6 more
no test names it
SimClock.day_end
method, line 22
silver_watermark · gold/harness.py:108 (by name)
_fact · gold/harness.py:340 (by name)
TyreCompany._plant · world/domains/tyre.py:541 (by name)
TyreCompany._lab_files · world/domains/tyre.py:591 (by name)
test_gold_plan.py
SimClock.date
method, line 25
main.housekeeping · scripts/run_platform.py:512 (value)
main.on_day · scripts/run_platform.py:576 (value)
main · scripts/run_platform.py:651 (value)
module level · realms/databricks/v1/tasks/hop.py:28 (by name)
main · scripts/dac_coverage.py:40 (by name)
write_calendar · scripts/run_platform.py:202 (by name)
and 27 more
no test names it
SimClock.at
method, line 28
DatabricksSystemTables.lineage · adapters/databricks_system.py:99 (value)
DatabricksSystemTables.access · adapters/databricks_system.py:105 (value)
MemorySystemTables.lineage · adapters/memory_system.py:22 (value)
MemorySystemTables.access · adapters/memory_system.py:26 (value)
counts_per_rule_per_day · obs/alerts.py:295 (value)
steps_table · obs/ops.py:191 (value)
and 25 more
no test names it
SimClock.day_of
method, line 31
Which world day an instant falls on, in business time.none found in the codetest_world_clinical.py, test_world_tyre.py
iso
function, line 36
Every timestamp the world writes: UTC, ISO 8601, second precision.ClinicalTrial._site_row · world/domains/clinical.py:209
ClinicalTrial._make_visits · world/domains/clinical.py:220
ClinicalTrial._subject_row · world/domains/clinical.py:310
ClinicalTrial._subjects · world/domains/clinical.py:329
ClinicalTrial._kits · world/domains/clinical.py:372
ClinicalTrial._edc · world/domains/clinical.py:433
and 19 more
no test names it

world/domains/__init__.py

Domain models: how one simulated company's source systems behave. The DWD's `name` picks the model. The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
model_for
function, line 14
main · scripts/run_platform.py:444
main · scripts/run_world.py:175
Harness.build · twin/runner.py:87
test_ingest_world.py, test_semantic_metrics.py and 5 more
gold_judge_for
function, line 27
The domain's gold judge: published gold against the oracle's gold for the day, and the incidents gold owns._duckdb · scripts/platform_binding.py:72
_table_port · scripts/platform_binding.py:102
_legacy · scripts/platform_binding.py:117
test_world_clinical.py
models_folder
function, line 41
The folder of the domain's gold build models, under the repo's models/ (named by the platform domain)._duckdb · scripts/platform_binding.py:72
_table_port · scripts/platform_binding.py:101
_legacy · scripts/platform_binding.py:116
test_world_clinical.py

world/domains/clinical.py

The clinical trial (data-platform-catalog slices/03-clinical/world.yaml): six source systems, day by day. The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
Subject
class, line 60
ClinicalTrial._make_population · world/domains/clinical.py:187no test names it
Subject.__init__
method, line 63
none found in the codeno test names it
Visit
class, line 70
One planned visit: what the source holds on each day follows from `outcome` and `res_day`.ClinicalTrial._make_visits · world/domains/clinical.py:217no test names it
Visit.__init__
method, line 94
none found in the codeno test names it
Visit.status
method, line 108
main · scripts/run_platform.py:652 (value)
MemoryMetaStore.log_step · adapters/memory_meta.py:199 (value)
PostgresMetaStore.log_step · adapters/postgres_meta.py:158 (value)
PostgresMetaStore.log_file · adapters/postgres_meta.py:164 (value)
SparkRunLog.write · adapters/spark_delta.py:117 (value)
summary · gold/harness.py:478 (value)
and 18 more
test_cloud_adapters.py, test_explain.py and 40 more
ClinicalTrial
class, line 112
model_for · world/domains/__init__.py:23no test names it
ClinicalTrial.__init__
method, line 130
none found in the codeno test names it
ClinicalTrial._make_population
method, line 170
ClinicalTrial.__init__ · world/domains/clinical.py:167no test names it
ClinicalTrial._site_row
method, line 200
ClinicalTrial._make_population · world/domains/clinical.py:176
ClinicalTrial._sites · world/domains/clinical.py:765
no test names it
ClinicalTrial._make_visits
method, line 212
The subject's visits and what becomes of each. Decided here, once, from the visits stream.ClinicalTrial._make_population · world/domains/clinical.py:189no test names it
ClinicalTrial._make_kits
method, line 242
ClinicalTrial._make_population · world/domains/clinical.py:198no test names it
ClinicalTrial.day
method, line 258
run_checks · realms/databricks/tasks/checks.py:24 (value)
step_prepare · realms/databricks/tasks/main.py:82 (value)
probe_platform · realms/databricks/tasks/main.py:101 (value)
step_land · realms/databricks/tasks/main.py:113 (value)
write_ops_page · scripts/run_platform.py:133 (value)
main.housekeeping · scripts/run_platform.py:512 (value)
and 17 more
no test names it
ClinicalTrial._count
method, line 273
ClinicalTrial._subjects · world/domains/clinical.py:344
ClinicalTrial._kits · world/domains/clinical.py:393
ClinicalTrial._edc · world/domains/clinical.py:447
ClinicalTrial._labs · world/domains/clinical.py:694
ClinicalTrial._logs · world/domains/clinical.py:719
ClinicalTrial._sites · world/domains/clinical.py:772
and 1 more
no test names it
ClinicalTrial._find
method, line 278
ClinicalTrial._subjects · world/domains/clinical.py:330
ClinicalTrial._kits · world/domains/clinical.py:386
ClinicalTrial._silent_loss · world/domains/clinical.py:490
ClinicalTrial._correct · world/domains/clinical.py:536
ClinicalTrial._act_late_change · world/domains/clinical.py:624
ClinicalTrial._labs · world/domains/clinical.py:696
and 3 more
no test names it
ClinicalTrial._on
method, line 291
ClinicalTrial._subjects · world/domains/clinical.py:322
ClinicalTrial._kits · world/domains/clinical.py:382
ClinicalTrial._edc · world/domains/clinical.py:452
ClinicalTrial._silent_loss · world/domains/clinical.py:481
ClinicalTrial._adverse_events · world/domains/clinical.py:554
ClinicalTrial._readings · world/domains/clinical.py:784
and 1 more
no test names it
ClinicalTrial._status_on
method, line 296
The subject's status at the start of day d: what the visits recorded before today say.ClinicalTrial._subject_row · world/domains/clinical.py:308no test names it
ClinicalTrial._subject_row
method, line 303
ClinicalTrial._subjects · world/domains/clinical.py:329no test names it
ClinicalTrial.present
method, line 313
Subjects in the source at the end of day d (entered, and not deleted).ClinicalTrial._subjects · world/domains/clinical.py:321
ClinicalTrial._adverse_events · world/domains/clinical.py:550
_silver · world/domains/clinical_oracle.py:67 (by name)
test_lakeformation.py, test_discovery.py and 9 more
ClinicalTrial._subjects
method, line 317
ClinicalTrial.day · world/domains/clinical.py:262no test names it
ClinicalTrial._accept_copy
method, line 347
A copy the platform accepts: a new silver version for each row whose tracked columns changed.ClinicalTrial._subjects · world/domains/clinical.py:343
ClinicalTrial._kits · world/domains/clinical.py:395
no test names it
ClinicalTrial._kits
method, line 367
ClinicalTrial.day · world/domains/clinical.py:263no test names it
ClinicalTrial._seq
method, line 400
ClinicalTrial._edc · world/domains/clinical.py:431
ClinicalTrial._adverse_events · world/domains/clinical.py:572
ClinicalTrial._ae_update · world/domains/clinical.py:602
ClinicalTrial._act_late_change · world/domains/clinical.py:617
no test names it
ClinicalTrial._visit_row
method, line 404
ClinicalTrial._edc · world/domains/clinical.py:433
_silver · world/domains/clinical_oracle.py:69 (by name)
no test names it
ClinicalTrial._edc
method, line 424
ClinicalTrial.day · world/domains/clinical.py:264no test names it
ClinicalTrial._dispense
method, line 459
ClinicalTrial._edc · world/domains/clinical.py:435no test names it
ClinicalTrial._silent_loss
method, line 480
ClinicalTrial._edc · world/domains/clinical.py:448no test names it
ClinicalTrial._correct
method, line 495
The study team records corrections as rows in the metadata store's corrections table, with a backfill plan that activates them later and names the windows to rebuild. The data capture system is not changed.ClinicalTrial._edc · world/domains/clinical.py:454no test names it
ClinicalTrial.planned
method, line 539
The planned date as the world knows it on day d (a correction counts once its plan is active).Visit.__init__ · world/domains/clinical.py:95 (value)
_visits · world/domains/clinical_oracle.py:105 (by name)
test_obs_alerts.py, test_world_clinical.py and 1 more
ClinicalTrial._adverse_events
method, line 547
ClinicalTrial._edc · world/domains/clinical.py:455no test names it
ClinicalTrial._ae_update
method, line 593
ClinicalTrial._adverse_events · world/domains/clinical.py:588no test names it
ClinicalTrial._act_late_change
method, line 607
Two severity changes: the older one commits six hours after the newer one.ClinicalTrial._adverse_events · world/domains/clinical.py:590no test names it
ClinicalTrial._results_of
method, line 629
ClinicalTrial._labs · world/domains/clinical.py:669no test names it
ClinicalTrial._labs
method, line 661
One file per site per collection day, in the evening of that day; the incidents move or change a file.ClinicalTrial.day · world/domains/clinical.py:265no test names it
ClinicalTrial._logs
method, line 703
ClinicalTrial.day · world/domains/clinical.py:266no test names it
ClinicalTrial._log_rows
method, line 727
The site's report for the month: subjects screened and randomised in it, per cohort.ClinicalTrial._logs · world/domains/clinical.py:712no test names it
ClinicalTrial._sites
method, line 747
ClinicalTrial.day · world/domains/clinical.py:267no test names it
ClinicalTrial._readings
method, line 779
Hour by hour so a day of readings never sits in memory at once. Late readings carry into the next hour.ClinicalTrial.day · world/domains/clinical.py:268no test names it
ClinicalTrial._reading_truth
method, line 850
Readings per event-time hour: every shipment makes one per `every` seconds, whatever arrives late or twice.ClinicalTrial._readings · world/domains/clinical.py:848no test names it
ClinicalTrial.oracle
method, line 869
main.on_day · scripts/run_platform.py:582 (value)
World.step · world/engine.py:96 (by name)
test_end_to_end.py, test_explain.py and 15 more
ClinicalTrial.incidents
method, line 874
World.finish · world/engine.py:107 (by name)test_end_to_end.py, test_explain.py and 3 more
_ts
function, line 878
ClinicalTrial._readings · world/domains/clinical.py:813
ClinicalTrial._reading_truth · world/domains/clinical.py:857
no test names it
_csv
function, line 882
CSV with a header line, in the delimiter the dataset's manifest declares. `header` renames columns on the way out (the laboratory's renamed column).ClinicalTrial._labs · world/domains/clinical.py:691
ClinicalTrial._logs · world/domains/clinical.py:714
no test names it

world/domains/clinical_gold.py

The clinical trial's gold judge: published gold against the oracle's gold for the day, and the incidents gold owns. The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
_rows
function, line 53
A table gold has not published yet reads as no rows (the comparison then shows what is missing).ClinicalGoldJudge._visits · world/domains/clinical_gold.py:95
ClinicalGoldJudge._labs · world/domains/clinical_gold.py:110
ClinicalGoldJudge._enrolment · world/domains/clinical_gold.py:124
ClinicalGoldJudge._temperature · world/domains/clinical_gold.py:139
no test names it
_f
function, line 63
_windows · world/domains/clinical_gold.py:73
ClinicalGoldJudge._visits · world/domains/clinical_gold.py:100
ClinicalGoldJudge._labs · world/domains/clinical_gold.py:115
ClinicalGoldJudge._enrolment · world/domains/clinical_gold.py:129
ClinicalGoldJudge._temperature · world/domains/clinical_gold.py:144
no test names it
_windows
function, line 67
The windows where any named number (gold column -> oracle key) or the complete flag differs.ClinicalGoldJudge._visits · world/domains/clinical_gold.py:98
ClinicalGoldJudge._labs · world/domains/clinical_gold.py:113
ClinicalGoldJudge._enrolment · world/domains/clinical_gold.py:127
ClinicalGoldJudge._temperature · world/domains/clinical_gold.py:142
no test names it
ClinicalGoldJudge
class, line 79
gold_judge_for · world/domains/__init__.py:37test_world_clinical.py
ClinicalGoldJudge.__init__
method, line 80
none found in the codeno test names it
ClinicalGoldJudge.compare
method, line 84
none found in the codetest_profiling.py, test_silver_stages.py and 4 more
ClinicalGoldJudge._visits
method, line 94
ClinicalGoldJudge.compare · world/domains/clinical_gold.py:88no test names it
ClinicalGoldJudge._labs
method, line 109
ClinicalGoldJudge.compare · world/domains/clinical_gold.py:89no test names it
ClinicalGoldJudge._enrolment
method, line 122
ClinicalGoldJudge.compare · world/domains/clinical_gold.py:90no test names it
ClinicalGoldJudge._temperature
method, line 137
ClinicalGoldJudge.compare · world/domains/clinical_gold.py:91no test names it
ClinicalGoldJudge.judge
method, line 150
none found in the codetest_end_to_end.py, test_explain.py and 3 more
ClinicalGoldJudge._v
method, line 165
ClinicalGoldJudge._today · world/domains/clinical_gold.py:176
ClinicalGoldJudge._later · world/domains/clinical_gold.py:213
no test names it
ClinicalGoldJudge._today
method, line 168
ClinicalGoldJudge.judge · world/domains/clinical_gold.py:154no test names it
ClinicalGoldJudge._later
method, line 203
ClinicalGoldJudge.judge · world/domains/clinical_gold.py:159no test names it

world/domains/clinical_oracle.py

The clinical trial's oracle: per simulated day, what a correct platform holds at bronze, silver and gold, and what each certified metric must say. Computed only from the world's own truth (R9, SIM-01). The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
day_oracle
function, line 25
ClinicalTrial.oracle · world/domains/clinical.py:872no test names it
measures
function, line 46
The dataset manifest's own reconciliation measures, so the oracle and the platform count the same things._silver · world/domains/clinical_oracle.py:67test_semantic_governance.py, gold_helpers.py and 17 more
_silver
function, line 56
day_oracle · world/domains/clinical_oracle.py:35no test names it
_country
function, line 87
_visits · world/domains/clinical_oracle.py:113
_lab · world/domains/clinical_oracle.py:154
_enrolment · world/domains/clinical_oracle.py:188
no test names it
_compliant
function, line 91
_visits · world/domains/clinical_oracle.py:106no test names it
_visits
function, line 99
day_oracle · world/domains/clinical_oracle.py:27no test names it
_lab
function, line 136
day_oracle · world/domains/clinical_oracle.py:27no test names it
_enrolment
function, line 171
day_oracle · world/domains/clinical_oracle.py:28no test names it
_temperature
function, line 203
day_oracle · world/domains/clinical_oracle.py:28no test names it
_where
function, line 223
`country = 'IN' AND planned month = 2026-11` -> {"country": "IN", "planned month": "2026-11"}.known_answers · world/domains/clinical_oracle.py:241no test names it
known_answers
function, line 232
Every known answer the metric views carry (ADR-022), beside what the world produced for the same question. The questions and values are read from the metric view files, so the oracle never restates them.day_oracle · world/domains/clinical_oracle.py:39test_semantic_governance.py, test_end_to_end.py and 3 more
_pct
function, line 255
_visits · world/domains/clinical_oracle.py:129
_lab · world/domains/clinical_oracle.py:164
no test names it

world/domains/tyre.py

The tyre company (data-platform-catalog slices/02-tyre/world.yaml): six source systems, day by day. The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
Line
class, line 45
One sales order line: its current source row plus the truth the oracle needs.TyreCompany._act_order · world/domains/tyre.py:349
TyreCompany.__init__ · world/domains/tyre.py:104 (value)
no test names it
Line.__init__
method, line 62
none found in the codeno test names it
TyreCompany
class, line 73
model_for · world/domains/__init__.py:19no test names it
TyreCompany.__init__
method, line 90
none found in the codeno test names it
TyreCompany._make_population
method, line 125
TyreCompany.__init__ · world/domains/tyre.py:122no test names it
TyreCompany._dealer_row
method, line 166
TyreCompany._make_population · world/domains/tyre.py:132
TyreCompany._dealer_api · world/domains/tyre.py:696
no test names it
TyreCompany._plant_of
method, line 176
none found in the codeno test names it
TyreCompany.day
method, line 180
run_checks · realms/databricks/tasks/checks.py:24 (value)
step_prepare · realms/databricks/tasks/main.py:82 (value)
probe_platform · realms/databricks/tasks/main.py:101 (value)
step_land · realms/databricks/tasks/main.py:113 (value)
write_ops_page · scripts/run_platform.py:133 (value)
main.housekeeping · scripts/run_platform.py:512 (value)
and 17 more
no test names it
TyreCompany._count
method, line 194
TyreCompany._masters · world/domains/tyre.py:261
TyreCompany._erp · world/domains/tyre.py:312
TyreCompany._plant · world/domains/tyre.py:567
TyreCompany._lab_files · world/domains/tyre.py:621
TyreCompany._partner · world/domains/tyre.py:660
TyreCompany._dealer_api · world/domains/tyre.py:704
and 1 more
no test names it
TyreCompany._find
method, line 199
TyreCompany._masters · world/domains/tyre.py:254
TyreCompany._act_delete · world/domains/tyre.py:423
TyreCompany._act_late_change · world/domains/tyre.py:441
TyreCompany._silent_loss · world/domains/tyre.py:479
TyreCompany._correct · world/domains/tyre.py:526
TyreCompany._lab_files · world/domains/tyre.py:623
and 3 more
no test names it
TyreCompany._on
method, line 212
TyreCompany._masters · world/domains/tyre.py:250
TyreCompany._erp · world/domains/tyre.py:295
TyreCompany._silent_loss · world/domains/tyre.py:470
TyreCompany._readings · world/domains/tyre.py:716
TyreCompany._reading_truth · world/domains/tyre.py:791
no test names it
TyreCompany._masters
method, line 217
TyreCompany.day · world/domains/tyre.py:184no test names it
TyreCompany._accept_copy
method, line 267
A copy the platform accepts: a new silver version for each row whose tracked columns changed.TyreCompany._masters · world/domains/tyre.py:263no test names it
TyreCompany._erp
method, line 281
TyreCompany.day · world/domains/tyre.py:185no test names it
TyreCompany._seq
method, line 314
TyreCompany._act_order · world/domains/tyre.py:347
TyreCompany._update · world/domains/tyre.py:377
TyreCompany._act_deliver · world/domains/tyre.py:404
TyreCompany._act_delete · world/domains/tyre.py:422
no test names it
TyreCompany._act_order
method, line 318
none found in the codeno test names it
TyreCompany._plan
method, line 355
Decide now what happens to the line later: cancelled, rescheduled, delivered on time or late, in full or not.TyreCompany._act_order · world/domains/tyre.py:351no test names it
TyreCompany._schedule
method, line 370
TyreCompany._plan · world/domains/tyre.py:359no test names it
TyreCompany._update
method, line 374
TyreCompany._act_cancel · world/domains/tyre.py:385
TyreCompany._act_reschedule · world/domains/tyre.py:391
TyreCompany._act_late_change · world/domains/tyre.py:438
no test names it
TyreCompany._act_cancel
method, line 382
none found in the codeno test names it
TyreCompany._act_reschedule
method, line 387
none found in the codeno test names it
TyreCompany._act_deliver
method, line 393
none found in the codeno test names it
TyreCompany._act_delete
method, line 409
none found in the codeno test names it
TyreCompany._act_late_change
method, line 426
Two promised-date changes: the older one commits six hours after the newer one.none found in the codeno test names it
TyreCompany._prepare_incidents
method, line 452
Make sure an incident has something to act on at small scales (tests): enough cancelled lines to delete.TyreCompany._erp · world/domains/tyre.py:283no test names it
TyreCompany._silent_loss
method, line 469
TyreCompany._erp · world/domains/tyre.py:305no test names it
TyreCompany._correct
method, line 483
The sales team records corrections as rows in the metadata store's corrections table (ADR-017), with a backfill plan that activates them later and names the windows to rebuild. The ERP is not changed.TyreCompany._erp · world/domains/tyre.py:308no test names it
TyreCompany.promise
method, line 529
The date first promised, as the world knows it on day d (a correction counts once its plan is active)._otif · world/domains/tyre_oracle.py:102 (by name)test_gold_engine.py, test_gold_harness.py and 2 more
TyreCompany._plant
method, line 537
TyreCompany.day · world/domains/tyre.py:186no test names it
TyreCompany._inspect
method, line 570
TyreCompany._plant · world/domains/tyre.py:564no test names it
TyreCompany._lab_files
method, line 589
One CSV per plant per local hour of inspection, arriving a few minutes after the hour closes.TyreCompany._plant · world/domains/tyre.py:568no test names it
TyreCompany._rename_from
method, line 632
TyreCompany._lab_files · world/domains/tyre.py:608no test names it
TyreCompany._partner
method, line 639
Last month's file from every dealer arrives in the world's first five days (DWD: due on day 1 for D-0042).TyreCompany.day · world/domains/tyre.py:187no test names it
TyreCompany._sellout_rows
method, line 670
TyreCompany._partner · world/domains/tyre.py:651no test names it
TyreCompany._dealer_api
method, line 679
TyreCompany.day · world/domains/tyre.py:188no test names it
TyreCompany._readings
method, line 712
Hour by hour so a day of readings never sits in memory at once. Late readings carry into the next hour.TyreCompany.day · world/domains/tyre.py:189no test names it
TyreCompany._reading_truth
method, line 779
Readings per event-time hour: every press makes one per `every` seconds, whatever arrives late or twice.TyreCompany._readings · world/domains/tyre.py:777no test names it
TyreCompany.oracle
method, line 797
main.on_day · scripts/run_platform.py:582 (value)
World.step · world/engine.py:96 (by name)
test_end_to_end.py, test_explain.py and 15 more
TyreCompany.incidents
method, line 802
World.finish · world/engine.py:107 (by name)test_end_to_end.py, test_explain.py and 3 more
_local_hours
function, line 806
Whole local hours of a plant whose start falls inside [start, end).TyreCompany._plant · world/domains/tyre.py:544no test names it
_shift
function, line 818
Shift 1 from 06:00, 2 from 14:00, 3 from 22:00; a two-shift plant is idle overnight.TyreCompany._plant · world/domains/tyre.py:546
TyreCompany._readings · world/domains/tyre.py:734
no test names it
_ts
function, line 827
TyreCompany._readings · world/domains/tyre.py:749
TyreCompany._reading_truth · world/domains/tyre.py:787
no test names it
_csv
function, line 831
CSV with a header line, in the delimiter the dataset's manifest declares. `header` renames columns on the way out (the lab's renamed column).TyreCompany._lab_files · world/domains/tyre.py:618
TyreCompany._partner · world/domains/tyre.py:653
no test names it

world/domains/tyre_gold.py

The tyre world's gold judge: published gold against the oracle's gold for the day, and the incidents gold owns. The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
_rows
function, line 51
A table gold has not published yet reads as no rows (the comparison then shows what is missing).TyreGoldJudge._otif · world/domains/tyre_gold.py:80
TyreGoldJudge._scrap · world/domains/tyre_gold.py:100
TyreGoldJudge._sales · world/domains/tyre_gold.py:119
TyreGoldJudge._today · world/domains/tyre_gold.py:183
no test names it
_f
function, line 61
TyreGoldJudge._otif · world/domains/tyre_gold.py:85
TyreGoldJudge._scrap · world/domains/tyre_gold.py:105
TyreGoldJudge._sales · world/domains/tyre_gold.py:125
no test names it
TyreGoldJudge
class, line 65
gold_judge_for · world/domains/__init__.py:33test_twin_engine.py
TyreGoldJudge.__init__
method, line 66
none found in the codeno test names it
TyreGoldJudge.compare
method, line 70
none found in the codetest_profiling.py, test_silver_stages.py and 4 more
TyreGoldJudge._otif
method, line 79
TyreGoldJudge.compare · world/domains/tyre_gold.py:74no test names it
TyreGoldJudge._scrap
method, line 99
TyreGoldJudge.compare · world/domains/tyre_gold.py:75no test names it
TyreGoldJudge._sales
method, line 117
TyreGoldJudge.compare · world/domains/tyre_gold.py:76no test names it
TyreGoldJudge.judge
method, line 159
none found in the codetest_end_to_end.py, test_explain.py and 3 more
TyreGoldJudge._v
method, line 174
TyreGoldJudge._today · world/domains/tyre_gold.py:186
TyreGoldJudge._later · world/domains/tyre_gold.py:230
no test names it
TyreGoldJudge._today
method, line 177
TyreGoldJudge.judge · world/domains/tyre_gold.py:163no test names it
TyreGoldJudge._later
method, line 220
TyreGoldJudge.judge · world/domains/tyre_gold.py:168no test names it

world/domains/tyre_oracle.py

The tyre world's oracle: per simulated day, what a correct platform holds at bronze, silver and gold, and what each certified metric must say. Computed only from the world's own truth (R9, SIM-01). The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
day_oracle
function, line 22
TyreCompany.oracle · world/domains/tyre.py:800no test names it
measures
function, line 42
The dataset manifest's own reconciliation measures, so the oracle and the platform count the same things._silver · world/domains/tyre_oracle.py:62test_semantic_governance.py, gold_helpers.py and 17 more
_silver
function, line 52
day_oracle · world/domains/tyre_oracle.py:32no test names it
_local_date
function, line 91
_hit · world/domains/tyre_oracle.py:148
_sales · world/domains/tyre_oracle.py:204
no test names it
_otif
function, line 95
day_oracle · world/domains/tyre_oracle.py:24no test names it
_hit
function, line 147
_otif · world/domains/tyre_oracle.py:104no test names it
_scrap
function, line 152
day_oracle · world/domains/tyre_oracle.py:25no test names it
_sales
function, line 191
day_oracle · world/domains/tyre_oracle.py:26no test names it
_sales.cell
function, line 198
_sales · world/domains/tyre_oracle.py:206no test names it
_sales.reported_by
function, line 222
_sales · world/domains/tyre_oracle.py:226no test names it
_where
function, line 246
`region = 'south' AND promised month = 2026-11` -> {"region": "south", "promised month": "2026-11"}.known_answers · world/domains/tyre_oracle.py:264no test names it
known_answers
function, line 255
Every known answer the metric views carry (ADR-022), beside what the world produced for the same question. The questions and values are read from the metric view files, so the oracle never restates them.day_oracle · world/domains/tyre_oracle.py:35test_semantic_governance.py, test_end_to_end.py and 3 more
_pct
function, line 281
_otif · world/domains/tyre_oracle.py:127
_scrap · world/domains/tyre_oracle.py:169
no test names it

world/dwd.py

Reads a DWD world (dwd/v0) and the specification it cites: dataset manifests and their ODCS contracts. The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
DwdError
class, line 20
apply_calendar · world/dwd.py:73
_set_paths · world/dwd.py:111
load · world/dwd.py:132
test_world_calendar.py, test_world_clinical.py
Dataset
class, line 25
load · world/dwd.py:138
module level · world/dwd.py:41 (value)
test_postgres_to_delta.py, test_adf_generator.py and 2 more
Dataset.table_name
method, line 33
read_back · scripts/run_world.py:129 (value)
World.write · world/engine.py:137 (value)
test_obs_pipeline_events.py, test_bronze_to_silver.py and 4 more
Dwd
class, line 38
load · world/dwd.py:124no test names it
Dwd.systems
method, line 45
none found in the codetest_world_calendar.py
Dwd.kind_of
method, line 48
change_feeds · scripts/run_platform.py:228 (by name)
mover.move · scripts/run_platform.py:240 (by name)
main.live_rows · scripts/run_platform.py:481 (by name)
read_back · scripts/run_world.py:115 (by name)
World.prepare · world/engine.py:81 (by name)
World._check · world/engine.py:111 (by name)
test_gold_harness.py, test_hop_reports.py and 4 more
Dwd.in_system
method, line 51
World.prepare · world/engine.py:82 (by name)no test names it
_yaml
function, line 55
load · world/dwd.py:120no test names it
apply_calendar
function, line 67
A named calendar from the world's `calendars:` block moves incidents to other days (for a short run that still meets every incident). Every incident must be moved, a moved key must be `day` or one of its day params, and the order of days muload · world/dwd.py:122test_world_calendar.py, test_world_clinical.py
_set_paths
function, line 97
`world:` in a calendar changes existing settings by dotted path (systems.partner_drop.file_window_days); a path that is not already in the world, or a value of another type, is an error.apply_calendar · world/dwd.py:93no test names it
load
function, line 118
none found in the codeno test names it
_table
function, line 147
load · world/dwd.py:138no test names it

world/engine.py

The world engine: runs the clock a day at a time, asks the domain model what its source systems did that day, writes it into the mock sources through their ports, and saves the oracle's totals for the day. The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
Emission
class, line 24
Everything the sources did on one world day, in commit or arrival order within each list.ClinicalTrial.day · world/domains/clinical.py:259
TyreCompany.day · world/domains/tyre.py:181
test_world_clinical.py, test_world_tyre.py
DomainModel
class, line 40
none found in the codeno test names it
DomainModel.day
method, line 43
run_checks · realms/databricks/tasks/checks.py:24 (value)
step_prepare · realms/databricks/tasks/main.py:82 (value)
probe_platform · realms/databricks/tasks/main.py:101 (value)
step_land · realms/databricks/tasks/main.py:113 (value)
write_ops_page · scripts/run_platform.py:133 (value)
main.housekeeping · scripts/run_platform.py:512 (value)
and 17 more
no test names it
DomainModel.oracle
method, line 45
main.on_day · scripts/run_platform.py:582 (value)
World.step · world/engine.py:96 (by name)
test_end_to_end.py, test_explain.py and 15 more
DomainModel.incidents
method, line 47
World.finish · world/engine.py:107 (by name)test_end_to_end.py, test_explain.py and 3 more
CorrectionSink
class, line 50
Where people record corrections: the metadata store's corrections table (ADR-017), never a source system.none found in the codeno test names it
CorrectionSink.record_corrections
method, line 53
StampingRunLog.record_corrections · adapters/memory_runlog.py:132 (by name)
withdraw · recovery.py:23 (by name)
World.write · world/engine.py:145 (by name)
test_gold_harness.py, test_meta_store.py
Sinks
class, line 57
sinks · scripts/run_world.py:85
Harness.build · twin/runner.py:93
test_ingest_world.py, test_semantic_metrics.py and 5 more
WorldError
class, line 68
World.__init__ · world/engine.py:77
World._check · world/engine.py:112
World.write · world/engine.py:142
test_world_clinical.py, test_world_tyre.py
World
class, line 72
main · scripts/run_platform.py:444
main · scripts/run_world.py:175
Harness.build · twin/runner.py:95
test_ingest_world.py, test_semantic_metrics.py and 5 more
World.__init__
method, line 73
none found in the codeno test names it
World.prepare
method, line 79
World.run · world/engine.py:85
run_days · ingest/daybyday.py:119 (by name)
test_world_tyre.py
World.run
method, line 84
none found in the codeno test names it
World.step
method, line 90
One world day: the sources' output written through the ports, then the oracle's totals saved. Days run in order from 1 after prepare(), so a caller can run the platform between two days.World.run · world/engine.py:86
MemoryMetaStore.log_step · adapters/memory_meta.py:198 (value)
PostgresMetaStore.log_step · adapters/postgres_meta.py:158 (value)
SparkRunLog.write · adapters/spark_delta.py:117 (value)
steps_table · obs/ops.py:188 (value)
step_durations_table · obs/ops.py:230 (value)
and 5 more
no test names it
World.finish
method, line 104
World.run · world/engine.py:87test_gold_engine.py, test_meta_store.py and 2 more
World._check
method, line 110
World.write · world/engine.py:124no test names it
World.write
method, line 116
Route each output to its port. Returns rows written per dataset (what the sources hold new today).World.step · world/engine.py:95gold_helpers.py, test_cloud_adapters.py and 31 more
World.write.add
function, line 120
World.write · world/engine.py:126no test names it

world/oracle.py

The oracle: what silver must hold, computed from the world's own record, never from the platform's logs. The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
expected_current
function, line 10
Current orders after applying every change the platform should have accepted, newest change sequence wins.run_checks · realms/databricks/tasks/checks.py:32test_slice1_local.py
judge_silver
function, line 26
oracle silver-agrees-with-world: count, keys, amount total and status per order.run_checks · realms/databricks/tasks/checks.py:32test_slice1_local.py

world/shop.py

The clothing shop's orders database, as a change feed, for slice 1 (data-platform-catalog slices/01-orders/world.yaml). The simulated company

DefinitionWhat it does (its own first sentence)Called byNamed in tests
Change
class, line 21
ShopWorld._deliver · world/shop.py:90no test names it
DayOutput
class, line 28
ShopWorld._day · world/shop.py:60no test names it
ShopWorld
class, line 34
run_checks · realms/databricks/tasks/checks.py:23
step_prepare · realms/databricks/tasks/main.py:82
test_cloud_adapters.py, test_slice1_local.py
ShopWorld.__init__
method, line 35
none found in the codeno test names it
ShopWorld.window
method, line 50
ShopWorld._day · world/shop.py:75
module level · realms/databricks/v1/tasks/hop.py:45 (value)
run_ingest · scripts/run_hop.py:61 (value)
run_silver · scripts/run_hop.py:71 (value)
run_gold · scripts/run_hop.py:78 (value)
PostgresMetaStore.log_file · adapters/postgres_meta.py:163 (value)
and 18 more
test_bundle.py, gold_helpers.py and 28 more
ShopWorld.run
method, line 53
none found in the codeno test names it
ShopWorld._day
method, line 59
ShopWorld.run · world/shop.py:55no test names it
ShopWorld._deliver
method, line 87
ShopWorld._day · world/shop.py:78no test names it
ShopWorld._next
method, line 92
ShopWorld._new_orders · world/shop.py:108
ShopWorld._progress · world/shop.py:118
ShopWorld._force_cancel · world/shop.py:130
ShopWorld._deletes · world/shop.py:134
ShopWorld._split_change · world/shop.py:143
no test names it
ShopWorld._new_orders
method, line 97
ShopWorld._day · world/shop.py:61no test names it
ShopWorld._progress
method, line 111
ShopWorld._day · world/shop.py:61no test names it
ShopWorld._planned
method, line 123
ShopWorld._day · world/shop.py:65no test names it
ShopWorld._force_cancel
method, line 126
Make sure enough day-1 orders are cancelled for the planned delete to have something to delete.ShopWorld._day · world/shop.py:66no test names it
ShopWorld._deletes
method, line 132
ShopWorld._day · world/shop.py:70no test names it
ShopWorld._split_change
method, line 140
For one day-2 order still 'placed': two changes happen; the newer is sent now, the older is held back.ShopWorld._day · world/shop.py:68no test names it
ShopWorld.late_order
method, line 151
detectors · realms/databricks/tasks/checks.py:83 (by name)test_slice1_local.py
ShopWorld.deleted_orders
method, line 154
detectors · realms/databricks/tasks/checks.py:78 (by name)test_slice1_local.py