车同轨,书同文,行同伦。
This repository is the public method repository for the clinical database standardization project.
It provides:
- directory contracts
- policy-registry contracts
- database-specific critical semantics contracts
- Layer 3 retained-output layout governance
- database lineage and version tracking
- onboarding playbooks
- public workflow entrypoints
- release governance and release-note surfaces
- generated public exports and coverage summaries
- GitHub-safe public variable-card contracts
- early standard-system MVP draft specs
- public database scaffolding entrypoints
- reusable scripts
- Layer 1 database skeletons
- public tutorials
- detailed public review checklists
It does not provide:
- raw database files
- local parquet copies
- patient-level Layer 2 to Layer 5 outputs
- Read
docs/GETTING_STARTED.md. - Check
docs/DATABASE_LINEAGE_AND_VERSION_MATRIX.md. - Read
docs/STANDARD_SYSTEM_MATURITY_ROADMAP.mdto understand how the current repository baseline grows into a stricter standard system. - Read
docs/standard_system_mvp/VARIABLE_CLASS_LANDSCAPE_AND_ROLLOUT.mdfor the current variable-class map and rollout order. - Read
docs/standard_system_mvp/README.mdfor the current governed MVP batch and runtime-evidence surface. - Read the class-2 bundle under
docs/standard_system_mvp, including the class definition, current closure, total closure review, MIMIC expansion decision, duration-summary approvals, Amsterdam next ICU and ICU/MCU admission approvals, baseline-snapshot approvals, grouped/proxy split approval, first window-summary approval, Amsterdam first-day urine-output candidate/formal review, Amsterdam hospital-LOS candidate boundary review, and BMI derived-baseline candidate/formal reviews. - Read the class-3 and opening class-5 bundle under
docs/standard_system_mvp, including the first binary-state approval, Amsterdam same-name candidate/formal review for invasive mechanical ventilation active, the MIMIC respiratory-support single-status expansions through NIV, HFNC, supplemental oxygen, and tracheostomy, the Amsterdam respiratory-support third-layer audit, the cross-database vasopressor-support and RRT active approvals, and the MIMIC plus Amsterdam RRT child split into CRRT-family, non-CRRT, and exact modality episode layers. - Read
docs/standard_system_mvp/CLASS1_FIRST_BATCH_APPROVAL_SUMMARY.mdfor the first formal content-approval closure of the reviewedMIMIC-IV-3.1class-1 batch. - Read
docs/standard_system_mvp/STD_HEART_RATE_FORMAL_APPROVAL_REVIEW.mdfor the current formal approval review ofstd_heart_rate. - Read
docs/standard_system_mvp/CLASS1_CURRENT_APPROVAL_CLOSURE.mdfor the current broader 11-variable class-1 closure state. - Install dependencies with
pip install -r requirements.txt. - Place your officially obtained source data into the expected sibling local-work path
Methods/Clinical_Database/local_work/Layer 1/<database>/...outside this public repository. - Read
Framework_Guideline/Layer3_Directory_Contract.mdbefore creating retained Layer 3 outputs. - Run the public workflow entrypoints in
scripts/public_workflow.py. - Use
prepare-release,validate-layer3-layout, andcheck-public-repositoryto keep the public release surface coherent.
docs/GETTING_STARTED.mddocs/CURRENT_STAGE_COMPLETION_STANDARD.mddocs/DATABASE_LINEAGE_AND_VERSION_MATRIX.mddocs/STANDARD_SYSTEM_MATURITY_ROADMAP.mddocs/standard_system_mvp/README.mddocs/standard_system_mvp/VARIABLE_CLASS_LANDSCAPE_AND_ROLLOUT.mddocs/standard_system_mvp/variable_classes/baseline_summary_window_numeric/README.mddocs/standard_system_mvp/CLASS2_FIRST_MVP_SELECTION.mddocs/standard_system_mvp/CLASS2_CURRENT_APPROVAL_CLOSURE.mddocs/standard_system_mvp/CLASS2_TOTAL_CLOSURE_REVIEW_AND_MIMIC_EXPANSION_DECISION.mddocs/standard_system_mvp/STD_ICU_LOS_DAYS_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_HOSPITAL_LOS_DAYS_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_HOSPITAL_LOS_DAYS_AMSTERDAM_CANDIDATE_REVIEW.mddocs/standard_system_mvp/STD_DAYS_TO_NEXT_ICU_ADMISSION_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_DAYS_TO_NEXT_ICU_MCU_ADMISSION_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_WEIGHT_ADMISSION_BASELINE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_WEIGHT_ICU_BASELINE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_BMI_ADMISSION_BASELINE_CANDIDATE_REVIEW.mddocs/standard_system_mvp/STD_BMI_ICU_BASELINE_CANDIDATE_REVIEW.mddocs/standard_system_mvp/STD_BMI_ADMISSION_BASELINE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_BMI_ICU_BASELINE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_WEIGHT_ADMISSION_BASELINE_AMSTERDAM_CANDIDATE_REVIEW.mddocs/standard_system_mvp/STD_WEIGHT_ICU_BASELINE_GROUPED_PROXY_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_FIRST_DAY_URINE_OUTPUT_SUMMARY_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_FIRST_DAY_URINE_OUTPUT_SUMMARY_AMSTERDAM_CANDIDATE_REVIEW.mddocs/standard_system_mvp/STD_FIRST_DAY_URINE_OUTPUT_SUMMARY_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_INVASIVE_MECHANICAL_VENTILATION_ACTIVE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_INVASIVE_MECHANICAL_VENTILATION_ACTIVE_AMSTERDAM_CANDIDATE_REVIEW.mddocs/standard_system_mvp/STD_INVASIVE_MECHANICAL_VENTILATION_ACTIVE_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/AMSTERDAM_RESPIRATORY_SUPPORT_FAMILY_SOURCE_AUDIT_REVIEW.mddocs/standard_system_mvp/STD_NONINVASIVE_VENTILATION_ACTIVE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_NONINVASIVE_VENTILATION_ACTIVE_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_HIGH_FLOW_NASAL_CANNULA_ACTIVE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_HIGH_FLOW_NASAL_CANNULA_ACTIVE_AMSTERDAM_CANDIDATE_REVIEW.mddocs/standard_system_mvp/STD_SUPPLEMENTAL_OXYGEN_ACTIVE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_SUPPLEMENTAL_OXYGEN_ACTIVE_AMSTERDAM_CANDIDATE_REVIEW.mddocs/standard_system_mvp/STD_TRACHEOSTOMY_STATUS_ACTIVE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_TRACHEOSTOMY_STATUS_ACTIVE_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_VASOPRESSOR_SUPPORT_ACTIVE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_VASOPRESSOR_SUPPORT_ACTIVE_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_RRT_ACTIVE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_RRT_ACTIVE_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_CRRT_FAMILY_ACTIVE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_CRRT_FAMILY_ACTIVE_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_NON_CRRT_RRT_ACTIVE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_NON_CRRT_RRT_ACTIVE_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_RRT_MODALITY_EPISODE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/STD_RRT_MODALITY_EPISODE_AMSTERDAM_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/CLASS1_FIRST_BATCH_APPROVAL_SUMMARY.mddocs/standard_system_mvp/STD_HEART_RATE_FORMAL_APPROVAL_REVIEW.mddocs/standard_system_mvp/CLASS1_CURRENT_APPROVAL_CLOSURE.mddocs/standard_system_mvp/variable_classes/event_level_numeric_primary_source/README.mddocs/standard_system_mvp/std_heart_rate/variable_spec.jsondocs/standard_system_mvp/std_heart_rate/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_heart_rate/mapping_spec_amsterdamumcdb_1_0_2.jsondocs/standard_system_mvp/std_heart_rate/execution.pydocs/standard_system_mvp/std_icu_los_days/variable_spec.jsondocs/standard_system_mvp/std_icu_los_days/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_icu_los_days/mapping_spec_amsterdamumcdb_1_0_2.jsondocs/standard_system_mvp/std_icu_los_days/execution.pydocs/standard_system_mvp/std_hospital_los_days/variable_spec.jsondocs/standard_system_mvp/std_hospital_los_days/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_hospital_los_days/execution.pydocs/standard_system_mvp/std_days_to_next_icu_admission/variable_spec.jsondocs/standard_system_mvp/std_days_to_next_icu_admission/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_days_to_next_icu_admission/mapping_spec_amsterdamumcdb_1_0_2.jsondocs/standard_system_mvp/std_days_to_next_icu_admission/execution.pydocs/standard_system_mvp/std_weight_admission_baseline/variable_spec.jsondocs/standard_system_mvp/std_weight_admission_baseline/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_weight_admission_baseline/execution.pydocs/standard_system_mvp/std_weight_icu_baseline/variable_spec.jsondocs/standard_system_mvp/std_weight_icu_baseline/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_weight_icu_baseline/execution.pydocs/standard_system_mvp/std_weight_icu_baseline_grouped_proxy/variable_spec.jsondocs/standard_system_mvp/std_weight_icu_baseline_grouped_proxy/mapping_spec_amsterdamumcdb_1_0_2.jsondocs/standard_system_mvp/std_weight_icu_baseline_grouped_proxy/execution.pydocs/standard_system_mvp/std_first_day_urine_output_summary/variable_spec.jsondocs/standard_system_mvp/std_first_day_urine_output_summary/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_first_day_urine_output_summary/mapping_spec_amsterdamumcdb_1_0_2.jsondocs/standard_system_mvp/std_first_day_urine_output_summary/execution.pydocs/standard_system_mvp/std_noninvasive_ventilation_active/variable_spec.jsondocs/standard_system_mvp/std_noninvasive_ventilation_active/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_noninvasive_ventilation_active/mapping_spec_amsterdamumcdb_1_0_2.jsondocs/standard_system_mvp/std_noninvasive_ventilation_active/execution.pydocs/standard_system_mvp/std_high_flow_nasal_cannula_active/variable_spec.jsondocs/standard_system_mvp/std_high_flow_nasal_cannula_active/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_high_flow_nasal_cannula_active/execution.pydocs/standard_system_mvp/std_supplemental_oxygen_active/variable_spec.jsondocs/standard_system_mvp/std_supplemental_oxygen_active/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_supplemental_oxygen_active/execution.pydocs/standard_system_mvp/std_tracheostomy_status_active/variable_spec.jsondocs/standard_system_mvp/std_tracheostomy_status_active/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_tracheostomy_status_active/mapping_spec_amsterdamumcdb_1_0_2.jsondocs/standard_system_mvp/std_tracheostomy_status_active/execution.pydocs/standard_system_mvp/std_vasopressor_support_active/variable_spec.jsondocs/standard_system_mvp/std_vasopressor_support_active/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_vasopressor_support_active/mapping_spec_amsterdamumcdb_1_0_2.jsondocs/standard_system_mvp/std_vasopressor_support_active/execution.pydocs/standard_system_mvp/std_rrt_active/variable_spec.jsondocs/standard_system_mvp/std_rrt_active/mapping_spec_mimic_iv_3_1.jsondocs/standard_system_mvp/std_rrt_active/mapping_spec_amsterdamumcdb_1_0_2.jsondocs/standard_system_mvp/std_rrt_active/execution.pydocs/database_catalog.jsondocs/layer3_directory_policy.jsondocs/release_safe_manifest.jsondocs/PUBLIC_INVENTORY.mddocs/PUBLIC_REPOSITORY_DETAILED_REVIEW_CHECKLIST.mddocs/public_exports/README.mddocs/onboarding/README.mddocs/onboarding/families/README.mddocs/tutorials/README.mddocs/NEXT_STAGE_PUBLIC_METHOD_REPOSITORY_CHECKLIST.mdFramework_Guideline/Layer1_Directory_Contract.mdFramework_Guideline/Layer3_Directory_Contract.mdFramework_Guideline/CrossDatabase_Variable_Harmonization_Contract.mdFramework_Guideline/Database_Critical_Semantics_Contract.mdFramework_Guideline/Database_Family_NewVersion_Admission_Contract.mdFramework_Guideline/AmsterdamUMCdb_TimeSemantics_Contract.mdFramework_Guideline/ID_Normalization_Contract.mdFramework_Guideline/MIMICIV_SourcePackageAndModuleBoundary_Contract.mdFramework_Guideline/Layer5_PublicVariableCard_Contract.mdFramework_Guideline/PolicyRegistry_Contract.mdFramework_Guideline/ReleaseSafe_Manifest_ReleaseGovernance_Contract.mdFramework_Guideline/Script_Placement_Contract.mdFramework_Guideline/StandardSystem_RuntimeEvidence_Contract.mdFramework_Guideline/StandardVariableClass_BaselineSummaryWindowNumeric_Contract.mdFramework_Guideline/StandardVariableClass_EventLevelNumericPrimarySource_Contract.mddocs/std_variable_cards/README.mddocs/RELEASE_CHANGELOG.mddocs/releases/README.mdrequirements.txtscripts/public_workflow.pyscripts/check_public_repository.pyscripts/export_public_metadata.pyscripts/prepare_public_release.pyscripts/scaffold_public_database.pyscripts/standard_system_mvp_engine.pyscripts/validate_standard_system_reproducibility.pyscripts/validate_standard_system_runtime.pyscripts/layer5/check_local_id_semantics.pyscripts/layer1/convert_amsterdam_raw_unpacked_to_parquet.pyscripts/generate_layer4_layer5_excel_templates.pyscripts/layer1/download_mimic_note_to_layer1.pyscripts/layer1/reconstruct_mimic_note_raw_unpacked_from_parquet.pyscripts/layer1/unpack_mimic_raw_original_to_raw_unpacked.pyscripts/layer1/convert_mimic_raw_unpacked_to_parquet.pyscripts/layer1/unpack_mimic_echo_raw_original_to_raw_unpacked.pyscripts/layer1/convert_mimic_echo_raw_unpacked_to_parquet.pyscripts/layer4/validate_policy_registry.pyscripts/layer5/export_layer3_filtered_preview.pyscripts/layer5/summarize_layer3_numeric_asset.py