medsci-skills 4.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +50 -0
- package/README.md +602 -0
- package/README_FIRST.md +27 -0
- package/bin/medsci-skills.js +159 -0
- package/installers/install-macos.command +19 -0
- package/installers/install-windows.cmd +26 -0
- package/installers/install-windows.ps1 +17 -0
- package/installers/install.py +218 -0
- package/metadata/skills_catalog.json +452 -0
- package/package.json +48 -0
- package/skills/academic-aio/SKILL.md +408 -0
- package/skills/academic-aio/references/case_studies/kjr_mllm_2025.md +82 -0
- package/skills/academic-aio/references/checklists/AIO_GENERAL.md +354 -0
- package/skills/academic-aio/references/journal_summarybox_templates.yaml +126 -0
- package/skills/academic-aio/references/oac_funding_checklist.yaml +129 -0
- package/skills/academic-aio/references/reporting_guideline_mapping.md +39 -0
- package/skills/academic-aio/references/schema_markup_templates/CodeRepository.jsonld +32 -0
- package/skills/academic-aio/references/schema_markup_templates/Dataset.jsonld +36 -0
- package/skills/academic-aio/references/schema_markup_templates/Person.jsonld +30 -0
- package/skills/academic-aio/references/schema_markup_templates/README.md +43 -0
- package/skills/academic-aio/references/schema_markup_templates/ScholarlyArticle.jsonld +55 -0
- package/skills/academic-aio/scripts/batch_metadata_audit.py +169 -0
- package/skills/academic-aio/scripts/validate_schema.py +118 -0
- package/skills/academic-aio/skill.yml +36 -0
- package/skills/academic-aio/templates/aio_audit_checklist.md.j2 +108 -0
- package/skills/add-journal/SKILL.md +482 -0
- package/skills/add-journal/skill.yml +33 -0
- package/skills/analyze-stats/SKILL.md +598 -0
- package/skills/analyze-stats/references/analysis_guides/missing_data.md +109 -0
- package/skills/analyze-stats/references/analysis_guides/nhis_icd10_mapping.md +247 -0
- package/skills/analyze-stats/references/analysis_guides/propensity_score.md +132 -0
- package/skills/analyze-stats/references/analysis_guides/regression.md +115 -0
- package/skills/analyze-stats/references/analysis_guides/repeated_measures.md +160 -0
- package/skills/analyze-stats/references/analysis_guides/survey_weighted.md +366 -0
- package/skills/analyze-stats/references/analysis_guides/test_selection.md +86 -0
- package/skills/analyze-stats/references/style/figure_style.mplstyle +69 -0
- package/skills/analyze-stats/references/style/theme_publication.R +147 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/ajr.yaml +51 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/european_radiology.yaml +55 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/jama.yaml +66 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/lancet.yaml +57 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/nejm.yaml +51 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/radiology.yaml +66 -0
- package/skills/analyze-stats/references/table-standards/table-standards.md +287 -0
- package/skills/analyze-stats/references/table-standards/table-types/diagnostic_accuracy.md +36 -0
- package/skills/analyze-stats/references/table-standards/table-types/meta_analysis.md +58 -0
- package/skills/analyze-stats/references/table-standards/table-types/model_comparison.md +36 -0
- package/skills/analyze-stats/references/table-standards/table-types/regression_results.md +50 -0
- package/skills/analyze-stats/references/table-standards/table-types/table1_demographics.md +51 -0
- package/skills/analyze-stats/references/table-standards/tool-comparison.md +79 -0
- package/skills/analyze-stats/references/templates/agreement_analysis.py +436 -0
- package/skills/analyze-stats/references/templates/dca_plot.R +237 -0
- package/skills/analyze-stats/references/templates/diagnostic_accuracy.py +401 -0
- package/skills/analyze-stats/references/templates/dta_meta_analysis.R +384 -0
- package/skills/analyze-stats/references/templates/forest_plot.py +412 -0
- package/skills/analyze-stats/references/templates/likert_summary.py +356 -0
- package/skills/analyze-stats/references/templates/meta_analysis.R +365 -0
- package/skills/analyze-stats/references/templates/propensity_score.py +478 -0
- package/skills/analyze-stats/references/templates/regression.py +425 -0
- package/skills/analyze-stats/references/templates/repeated_measures.py +434 -0
- package/skills/analyze-stats/references/templates/sample_size.R +382 -0
- package/skills/analyze-stats/references/templates/survey_weighted_analysis.py +411 -0
- package/skills/analyze-stats/references/templates/survival_analysis.py +325 -0
- package/skills/analyze-stats/references/templates/table1_demographics.py +287 -0
- package/skills/analyze-stats/scripts/check_generated_code.py +335 -0
- package/skills/analyze-stats/skill.yml +38 -0
- package/skills/analyze-stats/tests/fixtures/gen_bad.R +16 -0
- package/skills/analyze-stats/tests/fixtures/gen_bad.py +24 -0
- package/skills/analyze-stats/tests/fixtures/gen_clean.py +21 -0
- package/skills/analyze-stats/tests/test_generated_code.sh +59 -0
- package/skills/analyze-stats/tests/test_survival_template.sh +53 -0
- package/skills/author-strategy/SKILL.md +117 -0
- package/skills/author-strategy/analyze_patterns.py +303 -0
- package/skills/author-strategy/fetch_pubmed.py +374 -0
- package/skills/author-strategy/skill.yml +34 -0
- package/skills/batch-cohort/SKILL.md +223 -0
- package/skills/batch-cohort/references/base_template_knhanes.R +210 -0
- package/skills/batch-cohort/references/batch_template_generator.R +222 -0
- package/skills/batch-cohort/references/variable_coding_registry.md +136 -0
- package/skills/batch-cohort/skill.yml +35 -0
- package/skills/calc-sample-size/SKILL.md +491 -0
- package/skills/calc-sample-size/references/formulas.md +655 -0
- package/skills/calc-sample-size/references/observational_cohort.md +49 -0
- package/skills/calc-sample-size/skill.yml +51 -0
- package/skills/check-reporting/SKILL.md +534 -0
- package/skills/check-reporting/references/LICENSES.md +41 -0
- package/skills/check-reporting/references/checklists/AMSTAR2.md +54 -0
- package/skills/check-reporting/references/checklists/ARRIVE_2.md +234 -0
- package/skills/check-reporting/references/checklists/CARE.md +102 -0
- package/skills/check-reporting/references/checklists/CLAIM_2024.md +128 -0
- package/skills/check-reporting/references/checklists/CLEAR.md +113 -0
- package/skills/check-reporting/references/checklists/CONSORT.md +86 -0
- package/skills/check-reporting/references/checklists/COSMIN_RoB.md +136 -0
- package/skills/check-reporting/references/checklists/GRRAS.md +61 -0
- package/skills/check-reporting/references/checklists/MI_CLEAR_LLM.md +167 -0
- package/skills/check-reporting/references/checklists/MOOSE.md +85 -0
- package/skills/check-reporting/references/checklists/NOS.md +88 -0
- package/skills/check-reporting/references/checklists/PRISMA_2020.md +135 -0
- package/skills/check-reporting/references/checklists/PRISMA_DTA.md +36 -0
- package/skills/check-reporting/references/checklists/PRISMA_P.md +56 -0
- package/skills/check-reporting/references/checklists/PROBAST.md +75 -0
- package/skills/check-reporting/references/checklists/PROBAST_AI.md +130 -0
- package/skills/check-reporting/references/checklists/QUADAS2.md +77 -0
- package/skills/check-reporting/references/checklists/QUADAS_C.md +131 -0
- package/skills/check-reporting/references/checklists/ROBINS_E.md +179 -0
- package/skills/check-reporting/references/checklists/ROBINS_I.md +87 -0
- package/skills/check-reporting/references/checklists/ROBIS.md +114 -0
- package/skills/check-reporting/references/checklists/ROB_ME.md +126 -0
- package/skills/check-reporting/references/checklists/RoB2.md +79 -0
- package/skills/check-reporting/references/checklists/RoB_NMA.md +96 -0
- package/skills/check-reporting/references/checklists/SPIRIT.md +112 -0
- package/skills/check-reporting/references/checklists/SQUIRE_2.md +68 -0
- package/skills/check-reporting/references/checklists/STARD.md +129 -0
- package/skills/check-reporting/references/checklists/STARD_AI.md +211 -0
- package/skills/check-reporting/references/checklists/STROBE.md +80 -0
- package/skills/check-reporting/references/checklists/SWiM.md +33 -0
- package/skills/check-reporting/references/checklists/TRIPOD.md +157 -0
- package/skills/check-reporting/references/checklists/TRIPOD_AI.md +140 -0
- package/skills/check-reporting/references/step4c_registration_timing.md +93 -0
- package/skills/check-reporting/references/step4d_prisma_figure_audit.md +137 -0
- package/skills/check-reporting/scripts/check_checklist_exists.py +183 -0
- package/skills/check-reporting/scripts/check_checklist_version.py +168 -0
- package/skills/check-reporting/scripts/check_framework_naming.py +206 -0
- package/skills/check-reporting/scripts/check_prisma_figure.py +209 -0
- package/skills/check-reporting/scripts/prisma_cascade_check.py +274 -0
- package/skills/check-reporting/skill.yml +41 -0
- package/skills/check-reporting/tests/fixtures/framework_bad.md +8 -0
- package/skills/check-reporting/tests/fixtures/framework_clean.md +7 -0
- package/skills/check-reporting/tests/test_checklist_fail_fast.sh +77 -0
- package/skills/check-reporting/tests/test_checklist_version.sh +72 -0
- package/skills/check-reporting/tests/test_framework_naming.sh +45 -0
- package/skills/check-reporting/tests/test_prisma_cascade.sh +104 -0
- package/skills/clean-data/SKILL.md +180 -0
- package/skills/clean-data/references/cleaning_patterns.md +299 -0
- package/skills/clean-data/references/profiling_template.py +304 -0
- package/skills/clean-data/scripts/check_structural_zero.py +174 -0
- package/skills/clean-data/skill.yml +35 -0
- package/skills/clean-data/tests/fixtures/smoking.csv +8 -0
- package/skills/clean-data/tests/test_structural_zero.sh +49 -0
- package/skills/cross-national/SKILL.md +264 -0
- package/skills/cross-national/skill.yml +37 -0
- package/skills/define-variables/SKILL.md +146 -0
- package/skills/define-variables/references/common_definitions.md +190 -0
- package/skills/define-variables/skill.yml +34 -0
- package/skills/define-variables/templates/variable_operationalization.md +64 -0
- package/skills/deidentify/SKILL.md +203 -0
- package/skills/deidentify/deidentify.py +1224 -0
- package/skills/deidentify/locales/_template.json +45 -0
- package/skills/deidentify/locales/au.json +43 -0
- package/skills/deidentify/locales/ca.json +44 -0
- package/skills/deidentify/locales/cn.json +47 -0
- package/skills/deidentify/locales/de.json +48 -0
- package/skills/deidentify/locales/fr.json +48 -0
- package/skills/deidentify/locales/in.json +48 -0
- package/skills/deidentify/locales/jp.json +48 -0
- package/skills/deidentify/locales/kr.json +48 -0
- package/skills/deidentify/locales/uk.json +45 -0
- package/skills/deidentify/locales/us.json +43 -0
- package/skills/deidentify/references/date_shift_guide.md +82 -0
- package/skills/deidentify/references/hipaa_18_identifiers.md +48 -0
- package/skills/deidentify/references/korean_phi_patterns.md +135 -0
- package/skills/deidentify/skill.yml +43 -0
- package/skills/deidentify/tests/README.md +26 -0
- package/skills/deidentify/tests/test_clean.csv +16 -0
- package/skills/deidentify/tests/test_edge_cases.csv +11 -0
- package/skills/deidentify/tests/test_phi_korean.csv +11 -0
- package/skills/design-ai-benchmarking/SKILL.md +214 -0
- package/skills/design-ai-benchmarking/references/benchmark_export_schema.json +69 -0
- package/skills/design-ai-benchmarking/references/elicitation_rubric_template.md +37 -0
- package/skills/design-ai-benchmarking/skill.yml +38 -0
- package/skills/design-study/SKILL.md +298 -0
- package/skills/design-study/skill.yml +33 -0
- package/skills/fill-icmje-coi/SKILL.md +216 -0
- package/skills/fill-icmje-coi/scripts/fill_icmje_coi.py +140 -0
- package/skills/fill-icmje-coi/skill.yml +35 -0
- package/skills/fill-icmje-coi/templates/icmje_coi_seed_synthetic.docx +0 -0
- package/skills/fill-protocol/SKILL.md +248 -0
- package/skills/fill-protocol/examples/example_irb_template.yaml +53 -0
- package/skills/fill-protocol/references/best_practices.md +121 -0
- package/skills/fill-protocol/scripts/doc_to_docx.py +111 -0
- package/skills/fill-protocol/scripts/fill_form.py +611 -0
- package/skills/fill-protocol/scripts/inspect_template.py +61 -0
- package/skills/fill-protocol/setup.sh +162 -0
- package/skills/fill-protocol/skill.yml +37 -0
- package/skills/find-cohort-gap/SKILL.md +309 -0
- package/skills/find-cohort-gap/references/cohort_profile_template.md +93 -0
- package/skills/find-cohort-gap/references/onepager_template.md +84 -0
- package/skills/find-cohort-gap/references/pattern_scoring_rubric.md +169 -0
- package/skills/find-cohort-gap/references/saturation_query_templates.md +143 -0
- package/skills/find-cohort-gap/skill.yml +35 -0
- package/skills/find-journal/POLICY.md +87 -0
- package/skills/find-journal/SKILL.md +340 -0
- package/skills/find-journal/references/journal_profiles/AJNR.md +29 -0
- package/skills/find-journal/references/journal_profiles/AJR.md +30 -0
- package/skills/find-journal/references/journal_profiles/Abdominal_Radiology.md +30 -0
- package/skills/find-journal/references/journal_profiles/Academic_Radiology.md +30 -0
- package/skills/find-journal/references/journal_profiles/Annals_of_Internal_Medicine.md +33 -0
- package/skills/find-journal/references/journal_profiles/Artificial_Intelligence_in_Medicine.md +28 -0
- package/skills/find-journal/references/journal_profiles/BMC_Medicine.md +31 -0
- package/skills/find-journal/references/journal_profiles/British_Journal_of_Radiology.md +39 -0
- package/skills/find-journal/references/journal_profiles/CVIR.md +30 -0
- package/skills/find-journal/references/journal_profiles/Chest.md +39 -0
- package/skills/find-journal/references/journal_profiles/Clinical_Radiology.md +30 -0
- package/skills/find-journal/references/journal_profiles/Clinical_and_Molecular_Hepatology.md +32 -0
- package/skills/find-journal/references/journal_profiles/Diabetes_Metabolism_Journal.md +36 -0
- package/skills/find-journal/references/journal_profiles/Diagnostic_and_Interventional_Radiology.md +32 -0
- package/skills/find-journal/references/journal_profiles/Endocrinology_and_Metabolism.md +37 -0
- package/skills/find-journal/references/journal_profiles/European_Journal_of_Preventive_Cardiology.md +39 -0
- package/skills/find-journal/references/journal_profiles/European_Radiology.md +29 -0
- package/skills/find-journal/references/journal_profiles/Hepatology_Communications.md +40 -0
- package/skills/find-journal/references/journal_profiles/Hepatology_International.md +37 -0
- package/skills/find-journal/references/journal_profiles/IEEE_JBHI.md +28 -0
- package/skills/find-journal/references/journal_profiles/IEEE_TMI.md +28 -0
- package/skills/find-journal/references/journal_profiles/INSI.md +29 -0
- package/skills/find-journal/references/journal_profiles/Investigative_Radiology.md +25 -0
- package/skills/find-journal/references/journal_profiles/JACC_Advances.md +41 -0
- package/skills/find-journal/references/journal_profiles/JACC_Asia.md +30 -0
- package/skills/find-journal/references/journal_profiles/JACR.md +28 -0
- package/skills/find-journal/references/journal_profiles/JAMA.md +40 -0
- package/skills/find-journal/references/journal_profiles/JAMA_Network_Open.md +30 -0
- package/skills/find-journal/references/journal_profiles/JCSM.md +39 -0
- package/skills/find-journal/references/journal_profiles/JKMS.md +32 -0
- package/skills/find-journal/references/journal_profiles/JMIR.md +29 -0
- package/skills/find-journal/references/journal_profiles/JMIR_Medical_Education.md +29 -0
- package/skills/find-journal/references/journal_profiles/JNIS.md +35 -0
- package/skills/find-journal/references/journal_profiles/JVIR.md +31 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Biomedical_Informatics.md +29 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Clinical_Endocrinology_and_Metabolism.md +40 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Magnetic_Resonance_Imaging.md +30 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Nuclear_Medicine.md +31 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Stroke.md +32 -0
- package/skills/find-journal/references/journal_profiles/KJR.md +38 -0
- package/skills/find-journal/references/journal_profiles/Korean_Circulation_Journal.md +38 -0
- package/skills/find-journal/references/journal_profiles/Korean_Journal_of_Internal_Medicine.md +36 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Diabetes_and_Endocrinology.md +40 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Gastroenterology_and_Hepatology.md +49 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Infectious_Diseases.md +38 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Neurology.md +39 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Oncology.md +40 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Psychiatry.md +38 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Public_Health.md +30 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Respiratory_Medicine.md +39 -0
- package/skills/find-journal/references/journal_profiles/Liver_International.md +33 -0
- package/skills/find-journal/references/journal_profiles/Medical_Image_Analysis.md +28 -0
- package/skills/find-journal/references/journal_profiles/NEJM.md +33 -0
- package/skills/find-journal/references/journal_profiles/Nature_Machine_Intelligence.md +31 -0
- package/skills/find-journal/references/journal_profiles/Nature_Medicine.md +39 -0
- package/skills/find-journal/references/journal_profiles/Neuroradiology.md +31 -0
- package/skills/find-journal/references/journal_profiles/Nutrition_Metabolism_and_Cardiovascular_Diseases.md +39 -0
- package/skills/find-journal/references/journal_profiles/PLOS_Medicine.md +32 -0
- package/skills/find-journal/references/journal_profiles/RYAI.md +28 -0
- package/skills/find-journal/references/journal_profiles/Radiology.md +29 -0
- package/skills/find-journal/references/journal_profiles/Skeletal_Radiology.md +31 -0
- package/skills/find-journal/references/journal_profiles/Stroke.md +37 -0
- package/skills/find-journal/references/journal_profiles/The_BMJ.md +31 -0
- package/skills/find-journal/references/journal_profiles/The_Lancet.md +31 -0
- package/skills/find-journal/references/journal_profiles/The_Lancet_Digital_Health.md +29 -0
- package/skills/find-journal/references/journal_profiles/World_Journal_of_Hepatology.md +53 -0
- package/skills/find-journal/references/journal_profiles/npj_Digital_Medicine.md +29 -0
- package/skills/find-journal/skill.yml +34 -0
- package/skills/fulltext-retrieval/SKILL.md +174 -0
- package/skills/fulltext-retrieval/fetch_oa.py +433 -0
- package/skills/fulltext-retrieval/pdf_to_md.py +160 -0
- package/skills/fulltext-retrieval/skill.yml +41 -0
- package/skills/generate-codebook/SKILL.md +155 -0
- package/skills/generate-codebook/references/codebook_schema.md +76 -0
- package/skills/generate-codebook/scripts/generate_codebook.py +278 -0
- package/skills/generate-codebook/skill.yml +35 -0
- package/skills/generate-codebook/tests/test_generate_codebook.sh +76 -0
- package/skills/grant-builder/SKILL.md +251 -0
- package/skills/grant-builder/skill.yml +34 -0
- package/skills/humanize/SKILL.md +251 -0
- package/skills/humanize/references/ai_patterns.md +571 -0
- package/skills/humanize/skill.yml +33 -0
- package/skills/intake-project/SKILL.md +264 -0
- package/skills/intake-project/skill.yml +34 -0
- package/skills/lit-sync/SKILL.md +448 -0
- package/skills/lit-sync/references/locale/ko/note_templates.md +110 -0
- package/skills/lit-sync/skill.yml +52 -0
- package/skills/lit-sync/tests/test_poll_logic.sh +92 -0
- package/skills/ma-scout/SKILL.md +640 -0
- package/skills/ma-scout/references/project_readme_template.md +95 -0
- package/skills/ma-scout/references/project_readme_template_ko.md +82 -0
- package/skills/ma-scout/skill.yml +33 -0
- package/skills/make-figures/SKILL.md +957 -0
- package/skills/make-figures/references/critic_rubrics/data_plot.md +166 -0
- package/skills/make-figures/references/critic_rubrics/flow_diagram.md +169 -0
- package/skills/make-figures/references/design_principles.md +181 -0
- package/skills/make-figures/references/exemplar_diagrams/README.md +65 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/README.md +15 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/template_input.yaml +37 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/template_output.pdf +0 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/template_output.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/template_output_600.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/other/other_02.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/other/other_02.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/other/other_02_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/README.md +15 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_01.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_01.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_01_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_03.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_03.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_03_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_04.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_04.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_04_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_05.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_05.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_05_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_06.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_06.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_06_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_07.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_07.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_07_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_08.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_08.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_08_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_09.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_09.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_09_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_10.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_10.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_10_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/README.md +15 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/template_input.yaml +47 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/template_output.pdf +0 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/template_output.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/template_output_600.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/README.md +15 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/template_input.yaml +40 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/template_output.pdf +0 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/template_output.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/template_output_600.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_input.yaml +43 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_input_pptx.yaml +43 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_output.pdf +0 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_output.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_output.pptx +0 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_output_600.png +0 -0
- package/skills/make-figures/references/figure_specs.md +291 -0
- package/skills/make-figures/references/flow_diagram_lessons.md +164 -0
- package/skills/make-figures/references/jacc_central_illustration_principles.md +91 -0
- package/skills/make-figures/references/medical_illustration_sources.md +98 -0
- package/skills/make-figures/references/pipeline_concepts_medical_ai.md +240 -0
- package/skills/make-figures/references/reporting_guideline_figure_map.md +104 -0
- package/skills/make-figures/references/visual_abstract_templates/european_radiology.pptx +0 -0
- package/skills/make-figures/references/visual_abstract_templates/jacc_central_illustration.pptx +0 -0
- package/skills/make-figures/references/visual_abstract_templates/medsci_default.pptx +0 -0
- package/skills/make-figures/references/visual_abstract_templates/template_guide.md +114 -0
- package/skills/make-figures/scripts/build_jacc_template.py +77 -0
- package/skills/make-figures/scripts/build_prisma2020_template.py +371 -0
- package/skills/make-figures/scripts/build_strobe_template.py +351 -0
- package/skills/make-figures/scripts/critic_figure.py +264 -0
- package/skills/make-figures/scripts/derive_figure_legend_counts.py +138 -0
- package/skills/make-figures/scripts/extract_exemplar_from_pdf.py +186 -0
- package/skills/make-figures/scripts/fetch_official_templates.sh +88 -0
- package/skills/make-figures/scripts/fill_prisma_template.py +142 -0
- package/skills/make-figures/scripts/generate_flow_diagram.R +133 -0
- package/skills/make-figures/scripts/generate_image.py +99 -0
- package/skills/make-figures/scripts/generate_visual_abstract.py +438 -0
- package/skills/make-figures/scripts/validate_pptx_mac_compat.py +233 -0
- package/skills/make-figures/skill.yml +52 -0
- package/skills/make-figures/templates/official/NOTES.md +62 -0
- package/skills/make-figures/templates/official/consort2010/CONSORT_2025_editable_checklist.docx +0 -0
- package/skills/make-figures/templates/official/consort2010/CONSORT_2025_flow_diagram.docx +0 -0
- package/skills/make-figures/templates/official/prisma2020/PRISMA_2020_flow_new_v1.pptx +0 -0
- package/skills/make-figures/templates/official/prisma2020/PRISMA_2020_flow_new_v2.pptx +0 -0
- package/skills/make-figures/templates/official/prisma2020/PRISMA_2020_flow_updated_v2.pptx +0 -0
- package/skills/make-figures/templates/official/spirit2013/SPIRIT_2025_editable_checklist.docx +0 -0
- package/skills/make-figures/templates/official/spirit2013/SPIRIT_2025_participant_timeline.docx +0 -0
- package/skills/make-figures/templates/official/stard2015/STARD_2015_checklist.docx +0 -0
- package/skills/make-figures/templates/official/stard2015/STARD_2015_flow_diagram.pdf +0 -0
- package/skills/make-figures/tests/fixtures/figure1_flow.yaml +8 -0
- package/skills/make-figures/tests/fixtures/manuscript_ok.md +9 -0
- package/skills/make-figures/tests/fixtures/manuscript_stale.md +4 -0
- package/skills/make-figures/tests/test_legend_reconcile.sh +36 -0
- package/skills/manage-project/SKILL.md +358 -0
- package/skills/manage-project/references/pre_submission_checklist.md +53 -0
- package/skills/manage-project/references/project_state_template.json +37 -0
- package/skills/manage-project/references/scaffold_templates.md +118 -0
- package/skills/manage-project/references/status_output_format.md +44 -0
- package/skills/manage-project/references/timeline_example.md +20 -0
- package/skills/manage-project/skill.yml +36 -0
- package/skills/manage-project/templates/SSOT.yaml.template +41 -0
- package/skills/manage-refs/LICENSE.zotero-mcp +21 -0
- package/skills/manage-refs/NOTICE.md +29 -0
- package/skills/manage-refs/SKILL.md +289 -0
- package/skills/manage-refs/citation_styles/README.md +40 -0
- package/skills/manage-refs/citation_styles/american-journal-of-roentgenology.csl +211 -0
- package/skills/manage-refs/citation_styles/cardiovascular-and-interventional-radiology.csl +19 -0
- package/skills/manage-refs/citation_styles/european-radiology.csl +19 -0
- package/skills/manage-refs/citation_styles/journal-of-cachexia-sarcopenia-and-muscle.csl +150 -0
- package/skills/manage-refs/citation_styles/journal-of-korean-medical-science-strict.csl +533 -0
- package/skills/manage-refs/citation_styles/journal-of-korean-medical-science.csl +16 -0
- package/skills/manage-refs/citation_styles/korean-journal-of-radiology.csl +155 -0
- package/skills/manage-refs/citation_styles/nature.csl +189 -0
- package/skills/manage-refs/citation_styles/nlm-citation-sequence.csl +535 -0
- package/skills/manage-refs/citation_styles/radiology.csl +228 -0
- package/skills/manage-refs/citation_styles/springer-basic-brackets.csl +187 -0
- package/skills/manage-refs/citation_styles/springer-vancouver-brackets.csl +276 -0
- package/skills/manage-refs/citation_styles/vancouver-superscript.csl +536 -0
- package/skills/manage-refs/citation_styles/vancouver.csl +535 -0
- package/skills/manage-refs/references/REFERENCE_STYLE_SPECS.md +59 -0
- package/skills/manage-refs/references/check_xref_symptoms.md +35 -0
- package/skills/manage-refs/scripts/_vendor_citation_writer.py +600 -0
- package/skills/manage-refs/scripts/check_citation_keys.py +112 -0
- package/skills/manage-refs/scripts/check_csl_render.py +102 -0
- package/skills/manage-refs/scripts/check_xref.py +633 -0
- package/skills/manage-refs/scripts/fill_journal_abbrev.py +104 -0
- package/skills/manage-refs/scripts/inject_zotero_cwyw.py +133 -0
- package/skills/manage-refs/scripts/md_marker_convert.py +193 -0
- package/skills/manage-refs/scripts/pre_submission_gate.sh +238 -0
- package/skills/manage-refs/scripts/render_pandoc.sh +88 -0
- package/skills/manage-refs/skill.yml +70 -0
- package/skills/manage-refs/tests/fixtures/pre_submission_gate/README.md +32 -0
- package/skills/manage-refs/tests/fixtures/pre_submission_gate/manuscript.md +10 -0
- package/skills/manage-refs/tests/fixtures/pre_submission_gate/refs.bib +34 -0
- package/skills/manage-refs/tests/fixtures/pre_submission_gate/run.sh +117 -0
- package/skills/manage-refs/tests/test_vN_docx_check.sh +145 -0
- package/skills/meta-analysis/SKILL.md +739 -0
- package/skills/meta-analysis/references/LICENSES.md +21 -0
- package/skills/meta-analysis/references/PROSPERO_template.md +221 -0
- package/skills/meta-analysis/references/ai_pre_screening_template.py +245 -0
- package/skills/meta-analysis/references/checklists/JBI_Case_Series.md +45 -0
- package/skills/meta-analysis/references/checklists/NOS.md +88 -0
- package/skills/meta-analysis/references/checklists/PRISMA_DTA.md +36 -0
- package/skills/meta-analysis/references/checklists/PROBAST.md +75 -0
- package/skills/meta-analysis/references/checklists/QUADAS2.md +77 -0
- package/skills/meta-analysis/references/checklists/ROBINS_I.md +87 -0
- package/skills/meta-analysis/references/checklists/RoB2.md +79 -0
- package/skills/meta-analysis/references/data_integrity_checklist.md +57 -0
- package/skills/meta-analysis/references/icmje_coi_guide.md +181 -0
- package/skills/meta-analysis/references/phase10_recovery.md +136 -0
- package/skills/meta-analysis/references/phase4_km_composite.md +58 -0
- package/skills/meta-analysis/references/phase6_statistical_synthesis.md +148 -0
- package/skills/meta-analysis/references/phase9_circulation.md +84 -0
- package/skills/meta-analysis/references/post_submission_release_ops.md +41 -0
- package/skills/meta-analysis/references/r_templates.md +132 -0
- package/skills/meta-analysis/references/review_orchestration.md +40 -0
- package/skills/meta-analysis/references/submission_package_drift.md +71 -0
- package/skills/meta-analysis/scripts/check_pool_consistency.py +201 -0
- package/skills/meta-analysis/scripts/cohort_overlap_check.py +242 -0
- package/skills/meta-analysis/scripts/dta_extraction_qc.py +137 -0
- package/skills/meta-analysis/scripts/screening_reconcile.py +160 -0
- package/skills/meta-analysis/skill.yml +47 -0
- package/skills/meta-analysis/templates/FINAL_POOL_LOCK.yaml.template +70 -0
- package/skills/meta-analysis/templates/extraction_form_v2.md +129 -0
- package/skills/meta-analysis/templates/supplementary_8file_checklist.md +94 -0
- package/skills/meta-analysis/tests/test_pool_consistency.sh +123 -0
- package/skills/orchestrate/SKILL.md +501 -0
- package/skills/orchestrate/references/dialogue_nodes.md +196 -0
- package/skills/orchestrate/references/report_template.md +109 -0
- package/skills/orchestrate/references/report_template_ko.md +88 -0
- package/skills/orchestrate/skill.yml +44 -0
- package/skills/peer-review/SKILL.md +381 -0
- package/skills/peer-review/references/aczel_2021_reviewer2_patterns.md +88 -0
- package/skills/peer-review/references/domain-probes/ai_overclaiming.md +47 -0
- package/skills/peer-review/references/domain-probes/narrative_review.md +44 -0
- package/skills/peer-review/references/domain-probes/observational_confounding.md +48 -0
- package/skills/peer-review/references/domain-probes/radiomics.md +38 -0
- package/skills/peer-review/references/domain-probes/sr_ma.md +87 -0
- package/skills/peer-review/references/domain-probes/survival_prognostic.md +68 -0
- package/skills/peer-review/references/exemplar_reviews/README.md +43 -0
- package/skills/peer-review/references/exemplar_reviews/ai_overclaiming.md +47 -0
- package/skills/peer-review/references/exemplar_reviews/calibration_missing.md +44 -0
- package/skills/peer-review/references/exemplar_reviews/data_leakage.md +48 -0
- package/skills/peer-review/references/exemplar_reviews/reference_standard_validity.md +45 -0
- package/skills/peer-review/references/narrative_review_audit.md +67 -0
- package/skills/peer-review/references/reviewer_calibration/README.md +34 -0
- package/skills/peer-review/references/reviewer_calibration/compliance_floor.md +52 -0
- package/skills/peer-review/references/reviewer_profiles/AJR.md +82 -0
- package/skills/peer-review/references/reviewer_profiles/EURE.md +64 -0
- package/skills/peer-review/references/reviewer_profiles/INSI.md +57 -0
- package/skills/peer-review/references/reviewer_profiles/KJR.md +100 -0
- package/skills/peer-review/references/reviewer_profiles/README.md +32 -0
- package/skills/peer-review/references/reviewer_profiles/RYAI.md +86 -0
- package/skills/peer-review/skill.yml +39 -0
- package/skills/present-paper/SKILL.md +675 -0
- package/skills/present-paper/references/critic_rubrics/slide.md +155 -0
- package/skills/present-paper/references/generate_pptx_templates.py +604 -0
- package/skills/present-paper/references/medical_presentation_templates.md +277 -0
- package/skills/present-paper/references/slide_design_principles.md +202 -0
- package/skills/present-paper/references/slide_visual_styles/nature_lancet.md +168 -0
- package/skills/present-paper/references/workflow-checklist.md +109 -0
- package/skills/present-paper/scripts/extract_pdf_figures.py +243 -0
- package/skills/present-paper/scripts/inject_pronunciation_notes.py +178 -0
- package/skills/present-paper/scripts/inject_speaker_notes.py +133 -0
- package/skills/present-paper/scripts/strip_notes_for_sharing.py +140 -0
- package/skills/present-paper/scripts/trim_caption.py +271 -0
- package/skills/present-paper/skill.yml +41 -0
- package/skills/present-paper/templates/build_pptx_nature_lancet.py +688 -0
- package/skills/publish-skill/SKILL.md +370 -0
- package/skills/publish-skill/references/license-compatibility-matrix.md +132 -0
- package/skills/publish-skill/references/pii-patterns.md +130 -0
- package/skills/publish-skill/scripts/audit_skill.sh +278 -0
- package/skills/publish-skill/skill.yml +35 -0
- package/skills/render-pdf-doc/SKILL.md +146 -0
- package/skills/render-pdf-doc/references/known_pitfalls.md +53 -0
- package/skills/render-pdf-doc/references/pandoc_korean_cheatsheet.md +77 -0
- package/skills/render-pdf-doc/scripts/check_deps.sh +42 -0
- package/skills/render-pdf-doc/scripts/infer_colwidths.py +164 -0
- package/skills/render-pdf-doc/scripts/render_pdf.sh +98 -0
- package/skills/render-pdf-doc/skill.yml +57 -0
- package/skills/render-pdf-doc/templates/anchor-doc.md +27 -0
- package/skills/render-pdf-doc/templates/anchor-doc_ko.md +25 -0
- package/skills/render-pdf-doc/templates/briefing-handout.md +33 -0
- package/skills/render-pdf-doc/templates/briefing-handout_ko.md +31 -0
- package/skills/render-pdf-doc/templates/proposal-cover.md +33 -0
- package/skills/render-pdf-doc/templates/proposal-cover_ko.md +31 -0
- package/skills/render-pdf-doc/templates/reference-table.md +22 -0
- package/skills/render-pdf-doc/templates/reference-table_ko.md +20 -0
- package/skills/replicate-study/SKILL.md +150 -0
- package/skills/replicate-study/references/harmonization_3country.csv +47 -0
- package/skills/replicate-study/references/harmonization_knhanes_nhanes.csv +68 -0
- package/skills/replicate-study/references/methodology_extraction_template.md +134 -0
- package/skills/replicate-study/skill.yml +37 -0
- package/skills/review-paper/SKILL.md +104 -0
- package/skills/review-paper/references/macro_skeleton.md +6 -0
- package/skills/review-paper/skill.yml +25 -0
- package/skills/revise/SKILL.md +515 -0
- package/skills/revise/references/r2r_voice.md +346 -0
- package/skills/revise/skill.yml +43 -0
- package/skills/search-lit/SKILL.md +443 -0
- package/skills/search-lit/references/parse_pubmed.py +326 -0
- package/skills/search-lit/references/pubmed_eutils.sh +111 -0
- package/skills/search-lit/skill.yml +46 -0
- package/skills/self-review/SKILL.md +1045 -0
- package/skills/self-review/references/domain-probes/ai_overclaiming.md +47 -0
- package/skills/self-review/references/domain-probes/narrative_review.md +44 -0
- package/skills/self-review/references/domain-probes/observational_confounding.md +48 -0
- package/skills/self-review/references/domain-probes/radiomics.md +38 -0
- package/skills/self-review/references/domain-probes/sr_ma.md +87 -0
- package/skills/self-review/references/domain-probes/survival_prognostic.md +68 -0
- package/skills/self-review/references/exemplar_findings/README.md +43 -0
- package/skills/self-review/references/exemplar_findings/cohort_arithmetic_mismatch.md +35 -0
- package/skills/self-review/references/exemplar_findings/estimand_drift_posthoc_primary.md +39 -0
- package/skills/self-review/references/exemplar_findings/scope_overreach_cross_sectional.md +35 -0
- package/skills/self-review/references/exemplar_findings/unadjusted_confounder.md +36 -0
- package/skills/self-review/references/panel_review_template.md +177 -0
- package/skills/self-review/scripts/check_artifact_coverage.py +301 -0
- package/skills/self-review/scripts/check_claim_artifact.py +248 -0
- package/skills/self-review/scripts/check_classical_style.py +185 -0
- package/skills/self-review/scripts/check_cohort_arithmetic.py +481 -0
- package/skills/self-review/scripts/check_confounding_completeness.py +287 -0
- package/skills/self-review/scripts/check_panel_diversity.py +336 -0
- package/skills/self-review/scripts/check_reference_adequacy.py +392 -0
- package/skills/self-review/scripts/check_reviewer_team_consistency.py +412 -0
- package/skills/self-review/scripts/check_scope_coherence.py +177 -0
- package/skills/self-review/skill.yml +47 -0
- package/skills/self-review/tests/fixtures/claim_manuscript.md +17 -0
- package/skills/self-review/tests/fixtures/claim_prereg.md +6 -0
- package/skills/self-review/tests/fixtures/cohort_bad.md +21 -0
- package/skills/self-review/tests/fixtures/cohort_clean.md +21 -0
- package/skills/self-review/tests/fixtures/cohort_partition.csv +5 -0
- package/skills/self-review/tests/fixtures/coverage_analysis/31_delong_nested_added_value.csv +3 -0
- package/skills/self-review/tests/fixtures/coverage_analysis/table1_demographics.csv +3 -0
- package/skills/self-review/tests/fixtures/coverage_clean.md +13 -0
- package/skills/self-review/tests/fixtures/coverage_manuscript.md +11 -0
- package/skills/self-review/tests/fixtures/panel_collapse.json +27 -0
- package/skills/self-review/tests/fixtures/panel_good.json +32 -0
- package/skills/self-review/tests/fixtures/panel_monoculture.json +32 -0
- package/skills/self-review/tests/fixtures/refadeq_letter.md +13 -0
- package/skills/self-review/tests/fixtures/refadeq_original_fixed.md +42 -0
- package/skills/self-review/tests/fixtures/refadeq_original_uncited.md +40 -0
- package/skills/self-review/tests/fixtures/scope_bad.md +9 -0
- package/skills/self-review/tests/fixtures/scope_clean.md +8 -0
- package/skills/self-review/tests/fixtures/scope_surrogate.md +8 -0
- package/skills/self-review/tests/fixtures/style_bad.md +13 -0
- package/skills/self-review/tests/fixtures/style_clean.md +11 -0
- package/skills/self-review/tests/fixtures/table1_by_exposure.csv +11 -0
- package/skills/self-review/tests/test_artifact_coverage.sh +44 -0
- package/skills/self-review/tests/test_claim_artifact.sh +50 -0
- package/skills/self-review/tests/test_classical_style.sh +44 -0
- package/skills/self-review/tests/test_cohort_arithmetic.sh +49 -0
- package/skills/self-review/tests/test_confounding_completeness.sh +66 -0
- package/skills/self-review/tests/test_panel_diversity.sh +55 -0
- package/skills/self-review/tests/test_panel_mode.sh +69 -0
- package/skills/self-review/tests/test_reference_adequacy.sh +68 -0
- package/skills/self-review/tests/test_reviewer_team_consistency.sh +138 -0
- package/skills/self-review/tests/test_scope_coherence.sh +46 -0
- package/skills/setup-medsci/SKILL.md +110 -0
- package/skills/setup-medsci/references/setup-checklist.md +51 -0
- package/skills/setup-medsci/skill.yml +30 -0
- package/skills/sync-submission/SKILL.md +382 -0
- package/skills/sync-submission/scripts/author_registry_example.yaml +36 -0
- package/skills/sync-submission/scripts/blind_sweep.py +203 -0
- package/skills/sync-submission/scripts/check_asset_anonymization.py +300 -0
- package/skills/sync-submission/scripts/check_cross_artifact_stale.py +211 -0
- package/skills/sync-submission/scripts/cover_letter_drift_check.py +451 -0
- package/skills/sync-submission/scripts/cross_document_n_check.py +486 -0
- package/skills/sync-submission/scripts/detect_copy_divergence.py +136 -0
- package/skills/sync-submission/scripts/preflight_gate.py +458 -0
- package/skills/sync-submission/scripts/scope_drift_check.py +362 -0
- package/skills/sync-submission/scripts/sync_submission.py +169 -0
- package/skills/sync-submission/skill.yml +43 -0
- package/skills/sync-submission/tests/fixtures/copy_ok.md +5 -0
- package/skills/sync-submission/tests/fixtures/copy_stale.md +5 -0
- package/skills/sync-submission/tests/fixtures/ssot.md +5 -0
- package/skills/sync-submission/tests/test_asset_anonymization.sh +99 -0
- package/skills/sync-submission/tests/test_copy_divergence.sh +44 -0
- package/skills/sync-submission/tests/test_cross_artifact_stale.sh +80 -0
- package/skills/sync-submission/tests/test_cross_document_n.sh +132 -0
- package/skills/sync-submission/tests/test_preflight_gate.sh +112 -0
- package/skills/sync-submission/tests/test_scope_drift.sh +122 -0
- package/skills/sync-submission/tests/test_vN_docx_assertion.sh +51 -0
- package/skills/verify-refs/SKILL.md +177 -0
- package/skills/verify-refs/references/manual_checkpoint_guide.md +100 -0
- package/skills/verify-refs/scripts/verify_cli.sh +62 -0
- package/skills/verify-refs/scripts/verify_refs.py +782 -0
- package/skills/verify-refs/skill.yml +44 -0
- package/skills/verify-refs/tests/fixtures/pagination_placeholder.bib +17 -0
- package/skills/verify-refs/tests/test_pagination_placeholder.sh +42 -0
- package/skills/version-dataset/SKILL.md +143 -0
- package/skills/version-dataset/references/manifest_schema.md +72 -0
- package/skills/version-dataset/scripts/version_dataset.py +242 -0
- package/skills/version-dataset/skill.yml +35 -0
- package/skills/version-dataset/tests/test_version_dataset.sh +52 -0
- package/skills/write-paper/SKILL.md +1148 -0
- package/skills/write-paper/references/exemplar_methods/README.md +38 -0
- package/skills/write-paper/references/exemplar_methods/ai_validation_tripod_claim.md +47 -0
- package/skills/write-paper/references/exemplar_methods/diagnostic_accuracy_stard.md +50 -0
- package/skills/write-paper/references/exemplar_methods/observational_cohort_strobe.md +43 -0
- package/skills/write-paper/references/journal_profiles/AJNR.md +185 -0
- package/skills/write-paper/references/journal_profiles/AJR.md +149 -0
- package/skills/write-paper/references/journal_profiles/Abdominal_Radiology.md +139 -0
- package/skills/write-paper/references/journal_profiles/Academic_Radiology.md +90 -0
- package/skills/write-paper/references/journal_profiles/Annals_of_Internal_Medicine.md +150 -0
- package/skills/write-paper/references/journal_profiles/Artificial_Intelligence_in_Medicine.md +82 -0
- package/skills/write-paper/references/journal_profiles/British_Journal_of_Radiology.md +161 -0
- package/skills/write-paper/references/journal_profiles/CVIR.md +157 -0
- package/skills/write-paper/references/journal_profiles/Chest.md +270 -0
- package/skills/write-paper/references/journal_profiles/Clinical_Radiology.md +160 -0
- package/skills/write-paper/references/journal_profiles/Clinical_and_Molecular_Hepatology.md +147 -0
- package/skills/write-paper/references/journal_profiles/Diabetes_Metabolism_Journal.md +163 -0
- package/skills/write-paper/references/journal_profiles/Diagnostic_and_Interventional_Radiology.md +216 -0
- package/skills/write-paper/references/journal_profiles/Endocrinology_and_Metabolism.md +167 -0
- package/skills/write-paper/references/journal_profiles/European_Journal_of_Preventive_Cardiology.md +192 -0
- package/skills/write-paper/references/journal_profiles/European_Radiology.md +159 -0
- package/skills/write-paper/references/journal_profiles/Hepatology_Communications.md +110 -0
- package/skills/write-paper/references/journal_profiles/Hepatology_International.md +106 -0
- package/skills/write-paper/references/journal_profiles/IEEE_TMI.md +180 -0
- package/skills/write-paper/references/journal_profiles/INSI.md +163 -0
- package/skills/write-paper/references/journal_profiles/Investigative_Radiology.md +86 -0
- package/skills/write-paper/references/journal_profiles/JACC_Advances.md +197 -0
- package/skills/write-paper/references/journal_profiles/JACC_Asia.md +168 -0
- package/skills/write-paper/references/journal_profiles/JACR.md +87 -0
- package/skills/write-paper/references/journal_profiles/JAMA.md +188 -0
- package/skills/write-paper/references/journal_profiles/JAMA_Network_Open.md +170 -0
- package/skills/write-paper/references/journal_profiles/JCSM.md +266 -0
- package/skills/write-paper/references/journal_profiles/JKMS.md +201 -0
- package/skills/write-paper/references/journal_profiles/JMIR.md +88 -0
- package/skills/write-paper/references/journal_profiles/JMIR_Medical_Education.md +86 -0
- package/skills/write-paper/references/journal_profiles/JNIS.md +227 -0
- package/skills/write-paper/references/journal_profiles/JVIR.md +158 -0
- package/skills/write-paper/references/journal_profiles/Journal_of_Clinical_Endocrinology_and_Metabolism.md +191 -0
- package/skills/write-paper/references/journal_profiles/Journal_of_Stroke.md +176 -0
- package/skills/write-paper/references/journal_profiles/KJR.md +185 -0
- package/skills/write-paper/references/journal_profiles/Korean_Circulation_Journal.md +184 -0
- package/skills/write-paper/references/journal_profiles/Korean_Journal_of_Internal_Medicine.md +178 -0
- package/skills/write-paper/references/journal_profiles/Lancet_Gastroenterology_and_Hepatology.md +127 -0
- package/skills/write-paper/references/journal_profiles/Liver_International.md +165 -0
- package/skills/write-paper/references/journal_profiles/Medical_Image_Analysis.md +147 -0
- package/skills/write-paper/references/journal_profiles/NEJM.md +147 -0
- package/skills/write-paper/references/journal_profiles/Nature_Medicine.md +181 -0
- package/skills/write-paper/references/journal_profiles/Neuroradiology.md +151 -0
- package/skills/write-paper/references/journal_profiles/Nutrition_Metabolism_and_Cardiovascular_Diseases.md +184 -0
- package/skills/write-paper/references/journal_profiles/PLOS_Medicine.md +166 -0
- package/skills/write-paper/references/journal_profiles/RYAI.md +124 -0
- package/skills/write-paper/references/journal_profiles/Radiology.md +173 -0
- package/skills/write-paper/references/journal_profiles/Skeletal_Radiology.md +135 -0
- package/skills/write-paper/references/journal_profiles/Stroke.md +210 -0
- package/skills/write-paper/references/journal_profiles/The_BMJ.md +121 -0
- package/skills/write-paper/references/journal_profiles/The_Lancet.md +112 -0
- package/skills/write-paper/references/journal_profiles/The_Lancet_Digital_Health.md +104 -0
- package/skills/write-paper/references/journal_profiles/World_Journal_of_Hepatology.md +106 -0
- package/skills/write-paper/references/journal_profiles/npj_Digital_Medicine.md +93 -0
- package/skills/write-paper/references/paper_types/ai_validation.md +270 -0
- package/skills/write-paper/references/paper_types/animal_study.md +194 -0
- package/skills/write-paper/references/paper_types/case_report.md +237 -0
- package/skills/write-paper/references/paper_types/cross_national.md +328 -0
- package/skills/write-paper/references/paper_types/letter.md +127 -0
- package/skills/write-paper/references/paper_types/meta_analysis.md +181 -0
- package/skills/write-paper/references/paper_types/nhis_cohort.md +297 -0
- package/skills/write-paper/references/paper_types/original_article.md +221 -0
- package/skills/write-paper/references/paper_types/technical_note.md +131 -0
- package/skills/write-paper/references/section_guides/discussion.md +155 -0
- package/skills/write-paper/references/section_guides/introduction.md +108 -0
- package/skills/write-paper/references/section_guides/methods.md +144 -0
- package/skills/write-paper/references/section_guides/results.md +113 -0
- package/skills/write-paper/references/section_guides/step7_1_classical_qc.md +67 -0
- package/skills/write-paper/references/section_guides/step7_4a_audit_recovery.md +74 -0
- package/skills/write-paper/references/section_guides/title_abstract.md +123 -0
- package/skills/write-paper/references/section_templates/methods_statistical.md +147 -0
- package/skills/write-paper/scripts/check_placeholders.py +182 -0
- package/skills/write-paper/skill.yml +48 -0
- package/skills/write-paper/tests/test_placeholders.sh +107 -0
- package/skills/write-protocol/SKILL.md +243 -0
- package/skills/write-protocol/references/ethics_checklist.md +150 -0
- package/skills/write-protocol/references/protocol_template.md +304 -0
- package/skills/write-protocol/skill.yml +34 -0
|
@@ -0,0 +1,436 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Template: Inter-rater Agreement Analysis
|
|
3
|
+
Calculates Cohen's/Fleiss' kappa, ICC, and Krippendorff's alpha with bootstrap CIs.
|
|
4
|
+
Generates Bland-Altman plots for continuous measurements.
|
|
5
|
+
|
|
6
|
+
Usage:
|
|
7
|
+
Modify the CONFIGURATION section below, then run:
|
|
8
|
+
python agreement_analysis.py
|
|
9
|
+
|
|
10
|
+
Input: CSV with rows=items, columns=raters (or long format)
|
|
11
|
+
Output: agreement_table.csv, bland_altman.pdf/.png, summary text
|
|
12
|
+
"""
|
|
13
|
+
|
|
14
|
+
# === REPRODUCIBILITY HEADER ===
|
|
15
|
+
import sys
|
|
16
|
+
import os
|
|
17
|
+
import datetime
|
|
18
|
+
import numpy as np
|
|
19
|
+
import pandas as pd
|
|
20
|
+
from scipy import stats
|
|
21
|
+
|
|
22
|
+
np.random.seed(42)
|
|
23
|
+
print(f"Date: {datetime.date.today()}")
|
|
24
|
+
print(f"Python: {sys.version}")
|
|
25
|
+
print(f"numpy: {np.__version__}, pandas: {pd.__version__}, scipy: {stats.scipy.__version__}")
|
|
26
|
+
|
|
27
|
+
import matplotlib
|
|
28
|
+
matplotlib.use("Agg")
|
|
29
|
+
import matplotlib.pyplot as plt
|
|
30
|
+
|
|
31
|
+
STYLE_PATH = os.path.expanduser(
|
|
32
|
+
"~/.claude/skills/analyze-stats/references/style/figure_style.mplstyle"
|
|
33
|
+
)
|
|
34
|
+
if os.path.exists(STYLE_PATH):
|
|
35
|
+
plt.style.use(STYLE_PATH)
|
|
36
|
+
|
|
37
|
+
print()
|
|
38
|
+
|
|
39
|
+
# === CONFIGURATION (modify for your study) ===
|
|
40
|
+
INPUT_FILE = "data.csv" # Path to input data
|
|
41
|
+
OUTPUT_DIR = "." # Output directory
|
|
42
|
+
RATER_COLS = [] # Column names for each rater (wide format)
|
|
43
|
+
DATA_TYPE = "auto" # "categorical", "ordinal", "continuous", or "auto"
|
|
44
|
+
BOOTSTRAP_N = 1000 # Number of bootstrap iterations for CIs
|
|
45
|
+
ALPHA = 0.05 # Significance level
|
|
46
|
+
# ==============================================
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def load_data(filepath: str) -> pd.DataFrame:
|
|
50
|
+
"""Load CSV or Excel file."""
|
|
51
|
+
if filepath.endswith((".xlsx", ".xls")):
|
|
52
|
+
return pd.read_excel(filepath)
|
|
53
|
+
return pd.read_csv(filepath)
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
def detect_data_type(df: pd.DataFrame, cols: list) -> str:
|
|
57
|
+
"""Auto-detect whether ratings are categorical, ordinal, or continuous."""
|
|
58
|
+
combined = pd.concat([df[c] for c in cols], ignore_index=True).dropna()
|
|
59
|
+
n_unique = combined.nunique()
|
|
60
|
+
|
|
61
|
+
if combined.dtype == object or combined.dtype.name == "category":
|
|
62
|
+
return "categorical"
|
|
63
|
+
if n_unique <= 10 and all(combined == combined.astype(int)):
|
|
64
|
+
return "ordinal"
|
|
65
|
+
return "continuous"
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
def interpret_kappa(kappa: float) -> str:
|
|
69
|
+
"""Interpret kappa using Landis & Koch (1977) guidelines."""
|
|
70
|
+
if kappa < 0:
|
|
71
|
+
return "poor"
|
|
72
|
+
if kappa < 0.20:
|
|
73
|
+
return "slight"
|
|
74
|
+
if kappa < 0.40:
|
|
75
|
+
return "fair"
|
|
76
|
+
if kappa < 0.60:
|
|
77
|
+
return "moderate"
|
|
78
|
+
if kappa < 0.80:
|
|
79
|
+
return "substantial"
|
|
80
|
+
return "almost perfect"
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
def interpret_icc(icc: float) -> str:
|
|
84
|
+
"""Interpret ICC using Cicchetti (1994) guidelines."""
|
|
85
|
+
if icc < 0.40:
|
|
86
|
+
return "poor"
|
|
87
|
+
if icc < 0.60:
|
|
88
|
+
return "fair"
|
|
89
|
+
if icc < 0.75:
|
|
90
|
+
return "good"
|
|
91
|
+
return "excellent"
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
def cohens_kappa(r1: np.ndarray, r2: np.ndarray) -> float:
|
|
95
|
+
"""Cohen's kappa for 2 raters, categorical data."""
|
|
96
|
+
from sklearn.metrics import cohen_kappa_score
|
|
97
|
+
return cohen_kappa_score(r1, r2)
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
def cohens_weighted_kappa(r1: np.ndarray, r2: np.ndarray,
|
|
101
|
+
weights: str = "linear") -> float:
|
|
102
|
+
"""Weighted Cohen's kappa for ordinal data."""
|
|
103
|
+
from sklearn.metrics import cohen_kappa_score
|
|
104
|
+
return cohen_kappa_score(r1, r2, weights=weights)
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
def fleiss_kappa(rating_matrix: np.ndarray) -> float:
|
|
108
|
+
"""Fleiss' kappa for multiple raters, categorical data.
|
|
109
|
+
|
|
110
|
+
Args:
|
|
111
|
+
rating_matrix: n_items x n_categories matrix of category counts per item
|
|
112
|
+
"""
|
|
113
|
+
n_items, n_categories = rating_matrix.shape
|
|
114
|
+
n_raters = int(rating_matrix.sum(axis=1)[0])
|
|
115
|
+
|
|
116
|
+
p_j = rating_matrix.sum(axis=0) / (n_items * n_raters)
|
|
117
|
+
P_i = (rating_matrix**2).sum(axis=1) - n_raters
|
|
118
|
+
P_i = P_i / (n_raters * (n_raters - 1))
|
|
119
|
+
|
|
120
|
+
P_bar = P_i.mean()
|
|
121
|
+
P_e = (p_j**2).sum()
|
|
122
|
+
|
|
123
|
+
if P_e == 1:
|
|
124
|
+
return 1.0
|
|
125
|
+
return (P_bar - P_e) / (1 - P_e)
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
def compute_icc(df: pd.DataFrame, cols: list,
|
|
129
|
+
model: str = "two-way", type_: str = "agreement") -> float:
|
|
130
|
+
"""Compute Intraclass Correlation Coefficient.
|
|
131
|
+
|
|
132
|
+
Args:
|
|
133
|
+
model: "one-way", "two-way" (random), or "two-way-mixed"
|
|
134
|
+
type_: "consistency" or "agreement" (only for two-way)
|
|
135
|
+
Returns: ICC value
|
|
136
|
+
"""
|
|
137
|
+
ratings = df[cols].values
|
|
138
|
+
n_subjects, n_raters = ratings.shape
|
|
139
|
+
|
|
140
|
+
grand_mean = ratings.mean()
|
|
141
|
+
|
|
142
|
+
ss_total = np.sum((ratings - grand_mean) ** 2)
|
|
143
|
+
row_means = ratings.mean(axis=1)
|
|
144
|
+
col_means = ratings.mean(axis=0)
|
|
145
|
+
|
|
146
|
+
ss_rows = n_raters * np.sum((row_means - grand_mean) ** 2)
|
|
147
|
+
ss_cols = n_subjects * np.sum((col_means - grand_mean) ** 2)
|
|
148
|
+
ss_error = ss_total - ss_rows - ss_cols
|
|
149
|
+
|
|
150
|
+
ms_rows = ss_rows / (n_subjects - 1)
|
|
151
|
+
ms_cols = ss_cols / (n_raters - 1) if n_raters > 1 else 0
|
|
152
|
+
ms_error = ss_error / ((n_subjects - 1) * (n_raters - 1)) if (n_subjects > 1 and n_raters > 1) else 0
|
|
153
|
+
|
|
154
|
+
if model == "one-way":
|
|
155
|
+
ms_within = (ss_total - ss_rows) / (n_subjects * (n_raters - 1))
|
|
156
|
+
icc = (ms_rows - ms_within) / (ms_rows + (n_raters - 1) * ms_within)
|
|
157
|
+
elif model in ("two-way", "two-way-mixed"):
|
|
158
|
+
if type_ == "agreement":
|
|
159
|
+
icc = (ms_rows - ms_error) / (
|
|
160
|
+
ms_rows + (n_raters - 1) * ms_error +
|
|
161
|
+
n_raters * (ms_cols - ms_error) / n_subjects
|
|
162
|
+
)
|
|
163
|
+
else: # consistency
|
|
164
|
+
icc = (ms_rows - ms_error) / (ms_rows + (n_raters - 1) * ms_error)
|
|
165
|
+
else:
|
|
166
|
+
raise ValueError(f"Unknown model: {model}")
|
|
167
|
+
|
|
168
|
+
return icc
|
|
169
|
+
|
|
170
|
+
|
|
171
|
+
def bootstrap_ci(data: pd.DataFrame, cols: list, metric_func,
|
|
172
|
+
n_bootstrap: int = 1000, alpha: float = 0.05,
|
|
173
|
+
**kwargs) -> tuple:
|
|
174
|
+
"""Bootstrap confidence interval for any agreement metric."""
|
|
175
|
+
n = len(data)
|
|
176
|
+
boot_values = []
|
|
177
|
+
|
|
178
|
+
for _ in range(n_bootstrap):
|
|
179
|
+
idx = np.random.choice(n, size=n, replace=True)
|
|
180
|
+
boot_data = data.iloc[idx]
|
|
181
|
+
try:
|
|
182
|
+
val = metric_func(boot_data, cols, **kwargs)
|
|
183
|
+
if np.isfinite(val):
|
|
184
|
+
boot_values.append(val)
|
|
185
|
+
except Exception:
|
|
186
|
+
continue
|
|
187
|
+
|
|
188
|
+
if len(boot_values) < 10:
|
|
189
|
+
return (np.nan, np.nan)
|
|
190
|
+
|
|
191
|
+
boot_values = np.array(boot_values)
|
|
192
|
+
ci_lo = np.percentile(boot_values, 100 * alpha / 2)
|
|
193
|
+
ci_hi = np.percentile(boot_values, 100 * (1 - alpha / 2))
|
|
194
|
+
return (ci_lo, ci_hi)
|
|
195
|
+
|
|
196
|
+
|
|
197
|
+
def bland_altman_plot(r1: np.ndarray, r2: np.ndarray,
|
|
198
|
+
name1: str, name2: str, output_dir: str) -> dict:
|
|
199
|
+
"""Generate Bland-Altman plot for two continuous raters."""
|
|
200
|
+
mean_vals = (r1 + r2) / 2
|
|
201
|
+
diff_vals = r1 - r2
|
|
202
|
+
mean_diff = diff_vals.mean()
|
|
203
|
+
std_diff = diff_vals.std(ddof=1)
|
|
204
|
+
|
|
205
|
+
loa_upper = mean_diff + 1.96 * std_diff
|
|
206
|
+
loa_lower = mean_diff - 1.96 * std_diff
|
|
207
|
+
|
|
208
|
+
fig, ax = plt.subplots(figsize=(3.5, 3.5))
|
|
209
|
+
ax.scatter(mean_vals, diff_vals, s=15, alpha=0.6, color="#0072B2", edgecolors="none")
|
|
210
|
+
ax.axhline(mean_diff, color="#D55E00", linewidth=1, label=f"Mean: {mean_diff:.2f}")
|
|
211
|
+
ax.axhline(loa_upper, color="#D55E00", linewidth=0.8, linestyle="--",
|
|
212
|
+
label=f"+1.96 SD: {loa_upper:.2f}")
|
|
213
|
+
ax.axhline(loa_lower, color="#D55E00", linewidth=0.8, linestyle="--",
|
|
214
|
+
label=f"-1.96 SD: {loa_lower:.2f}")
|
|
215
|
+
ax.set_xlabel(f"Mean of {name1} and {name2}")
|
|
216
|
+
ax.set_ylabel(f"Difference ({name1} - {name2})")
|
|
217
|
+
ax.legend(fontsize=7, loc="upper right")
|
|
218
|
+
|
|
219
|
+
fig.tight_layout()
|
|
220
|
+
pdf_path = os.path.join(output_dir, "bland_altman.pdf")
|
|
221
|
+
png_path = os.path.join(output_dir, "bland_altman.png")
|
|
222
|
+
fig.savefig(pdf_path, format="pdf", bbox_inches="tight")
|
|
223
|
+
fig.savefig(png_path, format="png", dpi=300, bbox_inches="tight")
|
|
224
|
+
plt.close(fig)
|
|
225
|
+
print(f"Saved: {pdf_path}")
|
|
226
|
+
print(f"Saved: {png_path}")
|
|
227
|
+
|
|
228
|
+
return {
|
|
229
|
+
"mean_diff": mean_diff,
|
|
230
|
+
"sd_diff": std_diff,
|
|
231
|
+
"loa_lower": loa_lower,
|
|
232
|
+
"loa_upper": loa_upper,
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
|
|
236
|
+
def _icc_for_bootstrap(data, cols, model="two-way", type_="agreement"):
|
|
237
|
+
"""Wrapper for ICC to use with bootstrap_ci."""
|
|
238
|
+
return compute_icc(data, cols, model=model, type_=type_)
|
|
239
|
+
|
|
240
|
+
|
|
241
|
+
def _kappa_for_bootstrap_2raters(data, cols):
|
|
242
|
+
"""Wrapper for Cohen's kappa to use with bootstrap_ci."""
|
|
243
|
+
r1 = data[cols[0]].values
|
|
244
|
+
r2 = data[cols[1]].values
|
|
245
|
+
mask = ~(pd.isna(r1) | pd.isna(r2))
|
|
246
|
+
if mask.sum() < 2:
|
|
247
|
+
return np.nan
|
|
248
|
+
return cohens_kappa(r1[mask], r2[mask])
|
|
249
|
+
|
|
250
|
+
|
|
251
|
+
def analyze_categorical(df: pd.DataFrame, cols: list, output_dir: str) -> list:
|
|
252
|
+
"""Run agreement analysis for categorical data."""
|
|
253
|
+
results = []
|
|
254
|
+
n_raters = len(cols)
|
|
255
|
+
n_items = len(df)
|
|
256
|
+
|
|
257
|
+
if n_raters == 2:
|
|
258
|
+
r1 = df[cols[0]].values
|
|
259
|
+
r2 = df[cols[1]].values
|
|
260
|
+
mask = ~(pd.isna(r1) | pd.isna(r2))
|
|
261
|
+
r1_clean, r2_clean = r1[mask], r2[mask]
|
|
262
|
+
|
|
263
|
+
kappa = cohens_kappa(r1_clean, r2_clean)
|
|
264
|
+
ci_lo, ci_hi = bootstrap_ci(df, cols, _kappa_for_bootstrap_2raters,
|
|
265
|
+
n_bootstrap=BOOTSTRAP_N, alpha=ALPHA)
|
|
266
|
+
|
|
267
|
+
results.append({
|
|
268
|
+
"Metric": "Cohen's kappa",
|
|
269
|
+
"Value": f"{kappa:.3f}",
|
|
270
|
+
"95% CI": f"({ci_lo:.3f}-{ci_hi:.3f})",
|
|
271
|
+
"Interpretation": interpret_kappa(kappa),
|
|
272
|
+
"n_items": int(mask.sum()),
|
|
273
|
+
"n_raters": 2,
|
|
274
|
+
})
|
|
275
|
+
|
|
276
|
+
pct_agree = np.mean(r1_clean == r2_clean)
|
|
277
|
+
results.append({
|
|
278
|
+
"Metric": "Percent agreement",
|
|
279
|
+
"Value": f"{pct_agree:.3f}",
|
|
280
|
+
"95% CI": "",
|
|
281
|
+
"Interpretation": "",
|
|
282
|
+
"n_items": int(mask.sum()),
|
|
283
|
+
"n_raters": 2,
|
|
284
|
+
})
|
|
285
|
+
else:
|
|
286
|
+
categories = sorted(set(pd.concat([df[c] for c in cols]).dropna().unique()))
|
|
287
|
+
rating_counts = np.zeros((n_items, len(categories)))
|
|
288
|
+
for i in range(n_items):
|
|
289
|
+
for c in cols:
|
|
290
|
+
val = df[c].iloc[i]
|
|
291
|
+
if pd.notna(val) and val in categories:
|
|
292
|
+
rating_counts[i, categories.index(val)] += 1
|
|
293
|
+
|
|
294
|
+
fk = fleiss_kappa(rating_counts)
|
|
295
|
+
results.append({
|
|
296
|
+
"Metric": "Fleiss' kappa",
|
|
297
|
+
"Value": f"{fk:.3f}",
|
|
298
|
+
"95% CI": "",
|
|
299
|
+
"Interpretation": interpret_kappa(fk),
|
|
300
|
+
"n_items": n_items,
|
|
301
|
+
"n_raters": n_raters,
|
|
302
|
+
})
|
|
303
|
+
|
|
304
|
+
return results
|
|
305
|
+
|
|
306
|
+
|
|
307
|
+
def analyze_continuous(df: pd.DataFrame, cols: list, output_dir: str) -> list:
|
|
308
|
+
"""Run agreement analysis for continuous data."""
|
|
309
|
+
results = []
|
|
310
|
+
n_raters = len(cols)
|
|
311
|
+
|
|
312
|
+
for type_ in ["agreement", "consistency"]:
|
|
313
|
+
icc = compute_icc(df, cols, model="two-way", type_=type_)
|
|
314
|
+
ci_lo, ci_hi = bootstrap_ci(df, cols, _icc_for_bootstrap,
|
|
315
|
+
n_bootstrap=BOOTSTRAP_N, alpha=ALPHA,
|
|
316
|
+
model="two-way", type_=type_)
|
|
317
|
+
label = f"ICC (two-way, {type_})"
|
|
318
|
+
results.append({
|
|
319
|
+
"Metric": label,
|
|
320
|
+
"Value": f"{icc:.3f}",
|
|
321
|
+
"95% CI": f"({ci_lo:.3f}-{ci_hi:.3f})",
|
|
322
|
+
"Interpretation": interpret_icc(icc),
|
|
323
|
+
"n_items": len(df),
|
|
324
|
+
"n_raters": n_raters,
|
|
325
|
+
})
|
|
326
|
+
|
|
327
|
+
if n_raters == 2:
|
|
328
|
+
r1 = df[cols[0]].values.astype(float)
|
|
329
|
+
r2 = df[cols[1]].values.astype(float)
|
|
330
|
+
mask = ~(np.isnan(r1) | np.isnan(r2))
|
|
331
|
+
ba = bland_altman_plot(r1[mask], r2[mask], cols[0], cols[1], output_dir)
|
|
332
|
+
results.append({
|
|
333
|
+
"Metric": "Bland-Altman mean diff",
|
|
334
|
+
"Value": f"{ba['mean_diff']:.3f}",
|
|
335
|
+
"95% CI": f"LoA: ({ba['loa_lower']:.3f}-{ba['loa_upper']:.3f})",
|
|
336
|
+
"Interpretation": "",
|
|
337
|
+
"n_items": int(mask.sum()),
|
|
338
|
+
"n_raters": 2,
|
|
339
|
+
})
|
|
340
|
+
|
|
341
|
+
return results
|
|
342
|
+
|
|
343
|
+
|
|
344
|
+
def analyze_ordinal(df: pd.DataFrame, cols: list, output_dir: str) -> list:
|
|
345
|
+
"""Run agreement analysis for ordinal data (weighted kappa + ICC)."""
|
|
346
|
+
results = []
|
|
347
|
+
|
|
348
|
+
if len(cols) == 2:
|
|
349
|
+
r1 = df[cols[0]].values
|
|
350
|
+
r2 = df[cols[1]].values
|
|
351
|
+
mask = ~(pd.isna(r1) | pd.isna(r2))
|
|
352
|
+
r1_clean, r2_clean = r1[mask], r2[mask]
|
|
353
|
+
|
|
354
|
+
for weight in ["linear", "quadratic"]:
|
|
355
|
+
wk = cohens_weighted_kappa(r1_clean, r2_clean, weights=weight)
|
|
356
|
+
results.append({
|
|
357
|
+
"Metric": f"Weighted kappa ({weight})",
|
|
358
|
+
"Value": f"{wk:.3f}",
|
|
359
|
+
"95% CI": "",
|
|
360
|
+
"Interpretation": interpret_kappa(wk),
|
|
361
|
+
"n_items": int(mask.sum()),
|
|
362
|
+
"n_raters": 2,
|
|
363
|
+
})
|
|
364
|
+
|
|
365
|
+
results.extend(analyze_continuous(df, cols, output_dir))
|
|
366
|
+
return results
|
|
367
|
+
|
|
368
|
+
|
|
369
|
+
def save_results(results: list, output_dir: str) -> None:
|
|
370
|
+
"""Save agreement metrics as CSV and print formatted output."""
|
|
371
|
+
df = pd.DataFrame(results)
|
|
372
|
+
csv_path = os.path.join(output_dir, "agreement_table.csv")
|
|
373
|
+
df.to_csv(csv_path, index=False)
|
|
374
|
+
print(f"\nSaved: {csv_path}")
|
|
375
|
+
print("\n--- Agreement Analysis Results ---\n")
|
|
376
|
+
print(df.to_markdown(index=False))
|
|
377
|
+
|
|
378
|
+
|
|
379
|
+
def print_results_text(results: list, data_type: str) -> None:
|
|
380
|
+
"""Print manuscript-ready text for Results section."""
|
|
381
|
+
print("\n--- Results Text (copy-paste ready) ---\n")
|
|
382
|
+
|
|
383
|
+
for r in results:
|
|
384
|
+
metric = r["Metric"]
|
|
385
|
+
value = r["Value"]
|
|
386
|
+
ci = r.get("95% CI", "")
|
|
387
|
+
interp = r.get("Interpretation", "")
|
|
388
|
+
n_items = r.get("n_items", "")
|
|
389
|
+
n_raters = r.get("n_raters", "")
|
|
390
|
+
|
|
391
|
+
text = f"{metric} was {value}"
|
|
392
|
+
if ci:
|
|
393
|
+
text += f" (95% CI: {ci})"
|
|
394
|
+
if interp:
|
|
395
|
+
text += f", indicating {interp} agreement"
|
|
396
|
+
text += f" (n = {n_items} items, {n_raters} raters)."
|
|
397
|
+
print(text)
|
|
398
|
+
print()
|
|
399
|
+
|
|
400
|
+
|
|
401
|
+
# === MAIN ===
|
|
402
|
+
if __name__ == "__main__":
|
|
403
|
+
print("=" * 60)
|
|
404
|
+
print("Inter-rater Agreement Analysis")
|
|
405
|
+
print("=" * 60)
|
|
406
|
+
|
|
407
|
+
df = load_data(INPUT_FILE)
|
|
408
|
+
print(f"\nLoaded: {INPUT_FILE} ({df.shape[0]} rows, {df.shape[1]} columns)")
|
|
409
|
+
|
|
410
|
+
if not RATER_COLS:
|
|
411
|
+
RATER_COLS = [c for c in df.columns if c.lower().startswith("rater")]
|
|
412
|
+
if not RATER_COLS:
|
|
413
|
+
RATER_COLS = list(df.columns)
|
|
414
|
+
print(f"Using rater columns: {RATER_COLS}")
|
|
415
|
+
|
|
416
|
+
if DATA_TYPE == "auto":
|
|
417
|
+
DATA_TYPE = detect_data_type(df, RATER_COLS)
|
|
418
|
+
print(f"Data type: {DATA_TYPE}")
|
|
419
|
+
print(f"Items: {len(df)}, Raters: {len(RATER_COLS)}")
|
|
420
|
+
|
|
421
|
+
for col in RATER_COLS:
|
|
422
|
+
n_miss = df[col].isna().sum()
|
|
423
|
+
if n_miss > 0:
|
|
424
|
+
print(f" Missing in {col}: {n_miss} ({100*n_miss/len(df):.1f}%)")
|
|
425
|
+
|
|
426
|
+
if DATA_TYPE == "categorical":
|
|
427
|
+
results = analyze_categorical(df, RATER_COLS, OUTPUT_DIR)
|
|
428
|
+
elif DATA_TYPE == "ordinal":
|
|
429
|
+
results = analyze_ordinal(df, RATER_COLS, OUTPUT_DIR)
|
|
430
|
+
elif DATA_TYPE == "continuous":
|
|
431
|
+
results = analyze_continuous(df, RATER_COLS, OUTPUT_DIR)
|
|
432
|
+
else:
|
|
433
|
+
raise ValueError(f"Unknown data type: {DATA_TYPE}")
|
|
434
|
+
|
|
435
|
+
save_results(results, OUTPUT_DIR)
|
|
436
|
+
print_results_text(results, DATA_TYPE)
|
|
@@ -0,0 +1,237 @@
|
|
|
1
|
+
#!/usr/bin/env Rscript
|
|
2
|
+
# dca_plot.R — Decision Curve Analysis
|
|
3
|
+
# =====================================
|
|
4
|
+
# Generates DCA plots showing net benefit vs threshold probability.
|
|
5
|
+
# Compares models against treat-all and treat-none strategies.
|
|
6
|
+
#
|
|
7
|
+
# Dependencies: dcurves, ggplot2, dplyr
|
|
8
|
+
# Install: install.packages(c("dcurves", "ggplot2", "dplyr"))
|
|
9
|
+
#
|
|
10
|
+
# Input: Data frame with binary outcome + one or more prediction scores
|
|
11
|
+
#
|
|
12
|
+
# Usage:
|
|
13
|
+
# Rscript dca_plot.R --input predictions.csv --outcome event \
|
|
14
|
+
# --models model1_prob model2_prob --output dca_results
|
|
15
|
+
|
|
16
|
+
set.seed(42)
|
|
17
|
+
suppressPackageStartupMessages({
|
|
18
|
+
library(dcurves)
|
|
19
|
+
library(ggplot2)
|
|
20
|
+
library(dplyr)
|
|
21
|
+
})
|
|
22
|
+
|
|
23
|
+
cat(sprintf("dca_plot.R | Date: %s | R: %s\n",
|
|
24
|
+
format(Sys.Date()), R.version$version.string))
|
|
25
|
+
cat(sprintf("dcurves: %s | ggplot2: %s\n\n",
|
|
26
|
+
packageVersion("dcurves"), packageVersion("ggplot2")))
|
|
27
|
+
|
|
28
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
29
|
+
# CONFIGURATION — Edit for your analysis
|
|
30
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
31
|
+
|
|
32
|
+
CONFIG <- list(
|
|
33
|
+
input_file = "predictions.csv", # CSV with outcome and model probabilities
|
|
34
|
+
outcome_col = "event", # Binary outcome column (0/1)
|
|
35
|
+
model_cols = c("model1", "model2"), # Probability score columns
|
|
36
|
+
model_labels = c("AI Model", "Radiologist Score"), # Labels for legend
|
|
37
|
+
threshold_lo = 0.05, # Lower threshold for DCA
|
|
38
|
+
threshold_hi = 0.50, # Upper threshold for DCA
|
|
39
|
+
output_prefix = "dca"
|
|
40
|
+
)
|
|
41
|
+
|
|
42
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
43
|
+
# EXAMPLE DATA — Replace with real data
|
|
44
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
45
|
+
|
|
46
|
+
set.seed(42)
|
|
47
|
+
n <- 400
|
|
48
|
+
example_data <- data.frame(
|
|
49
|
+
event = rbinom(n, 1, prob = 0.25),
|
|
50
|
+
model1 = plogis(rnorm(n, mean = 0.8, sd = 1.2)),
|
|
51
|
+
model2 = plogis(rnorm(n, mean = 0.3, sd = 1.0))
|
|
52
|
+
)
|
|
53
|
+
# Add some correlation between outcome and predictions
|
|
54
|
+
example_data$model1 <- plogis(
|
|
55
|
+
qlogis(example_data$model1) + example_data$event * 1.5
|
|
56
|
+
)
|
|
57
|
+
example_data$model2 <- plogis(
|
|
58
|
+
qlogis(example_data$model2) + example_data$event * 1.0
|
|
59
|
+
)
|
|
60
|
+
|
|
61
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
62
|
+
# LOAD DATA
|
|
63
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
64
|
+
|
|
65
|
+
load_data <- function(config) {
|
|
66
|
+
if (file.exists(config$input_file)) {
|
|
67
|
+
df <- read.csv(config$input_file, stringsAsFactors = FALSE)
|
|
68
|
+
cat(sprintf("Loaded: %s (N = %d)\n\n", config$input_file, nrow(df)))
|
|
69
|
+
|
|
70
|
+
# Validate
|
|
71
|
+
for (col in c(config$outcome_col, config$model_cols)) {
|
|
72
|
+
if (!col %in% names(df)) {
|
|
73
|
+
stop(sprintf("Column '%s' not found in %s", col, config$input_file))
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
return(df)
|
|
77
|
+
} else {
|
|
78
|
+
cat("Input file not found. Using built-in example data.\n\n")
|
|
79
|
+
return(example_data)
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
df <- load_data(CONFIG)
|
|
84
|
+
|
|
85
|
+
# Rename columns for dcurves
|
|
86
|
+
outcome_var <- CONFIG$outcome_col
|
|
87
|
+
model_cols <- CONFIG$model_cols
|
|
88
|
+
|
|
89
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
90
|
+
# RUN DCA
|
|
91
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
92
|
+
|
|
93
|
+
cat("═══ DECISION CURVE ANALYSIS ════════════════════════════════════════════\n")
|
|
94
|
+
|
|
95
|
+
# Build formula dynamically
|
|
96
|
+
formula_str <- paste(outcome_var, "~",
|
|
97
|
+
paste(model_cols, collapse = " + "))
|
|
98
|
+
dca_formula <- as.formula(formula_str)
|
|
99
|
+
|
|
100
|
+
dca_result <- dca(
|
|
101
|
+
formula = dca_formula,
|
|
102
|
+
data = df,
|
|
103
|
+
thresholds = seq(CONFIG$threshold_lo, CONFIG$threshold_hi, by = 0.01),
|
|
104
|
+
as_probability = model_cols # our columns are already probabilities
|
|
105
|
+
)
|
|
106
|
+
|
|
107
|
+
# ── Print net benefit at key thresholds ───────────────────────────────────────
|
|
108
|
+
cat("\nNet Benefit at Selected Thresholds:\n")
|
|
109
|
+
key_thresholds <- c(0.10, 0.20, 0.30, 0.40, 0.50)
|
|
110
|
+
|
|
111
|
+
nb_summary <- dca_result$dca %>%
|
|
112
|
+
filter(threshold %in% key_thresholds) %>%
|
|
113
|
+
select(label, threshold, net_benefit) %>%
|
|
114
|
+
tidyr::pivot_wider(names_from = label, values_from = net_benefit)
|
|
115
|
+
|
|
116
|
+
print(nb_summary, digits = 3)
|
|
117
|
+
|
|
118
|
+
# ── Standardized net benefit ──────────────────────────────────────────────────
|
|
119
|
+
# NB_std = (NB_model - NB_treat-all) / (p / (1 - p))
|
|
120
|
+
# where p = event prevalence
|
|
121
|
+
|
|
122
|
+
p_event <- mean(df[[outcome_var]], na.rm = TRUE)
|
|
123
|
+
cat(sprintf("\nEvent prevalence: %.1f%%\n", p_event * 100))
|
|
124
|
+
|
|
125
|
+
# ── Interventions avoided per 100 ────────────────────────────────────────────
|
|
126
|
+
cat("\nInterventions Avoided per 100 Patients (vs treat-all):\n")
|
|
127
|
+
ia_summary <- dca_result$dca %>%
|
|
128
|
+
filter(threshold %in% key_thresholds, !label %in% c("All", "None")) %>%
|
|
129
|
+
mutate(
|
|
130
|
+
nb_all = dca_result$dca$net_benefit[
|
|
131
|
+
dca_result$dca$label == "All" &
|
|
132
|
+
dca_result$dca$threshold %in% threshold
|
|
133
|
+
][match(threshold, key_thresholds)],
|
|
134
|
+
ia_per_100 = (nb_all - net_benefit) / (threshold / (1 - threshold)) * 100
|
|
135
|
+
) %>%
|
|
136
|
+
select(label, threshold, net_benefit, ia_per_100)
|
|
137
|
+
|
|
138
|
+
print(ia_summary, digits = 2)
|
|
139
|
+
|
|
140
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
141
|
+
# PLOT — Standard DCA plot
|
|
142
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
143
|
+
|
|
144
|
+
# Wong colorblind-safe palette
|
|
145
|
+
MODEL_COLORS <- c(
|
|
146
|
+
"#0072B2", # blue — model 1
|
|
147
|
+
"#D55E00", # vermillion — model 2
|
|
148
|
+
"#009E73", # green — model 3 (if present)
|
|
149
|
+
"#E69F00" # orange — model 4 (if present)
|
|
150
|
+
)
|
|
151
|
+
|
|
152
|
+
# Build label-color mapping (exclude "All" and "None" built-ins)
|
|
153
|
+
model_labels_full <- c(CONFIG$model_labels)
|
|
154
|
+
color_map <- c(
|
|
155
|
+
setNames(MODEL_COLORS[seq_along(CONFIG$model_cols)], CONFIG$model_cols),
|
|
156
|
+
"All" = "#888888",
|
|
157
|
+
"None" = "#000000"
|
|
158
|
+
)
|
|
159
|
+
|
|
160
|
+
# Rename model labels for display
|
|
161
|
+
dca_plot_data <- dca_result$dca %>%
|
|
162
|
+
mutate(label = case_when(
|
|
163
|
+
label %in% CONFIG$model_cols ~
|
|
164
|
+
CONFIG$model_labels[match(label, CONFIG$model_cols)],
|
|
165
|
+
TRUE ~ label
|
|
166
|
+
))
|
|
167
|
+
|
|
168
|
+
# Color map with renamed labels
|
|
169
|
+
color_map_renamed <- c(
|
|
170
|
+
setNames(MODEL_COLORS[seq_along(CONFIG$model_labels)], CONFIG$model_labels),
|
|
171
|
+
"All" = "#888888",
|
|
172
|
+
"None" = "#000000"
|
|
173
|
+
)
|
|
174
|
+
|
|
175
|
+
p_dca <- ggplot(dca_plot_data,
|
|
176
|
+
aes(x = threshold, y = net_benefit,
|
|
177
|
+
color = label, linetype = label)) +
|
|
178
|
+
geom_line(linewidth = 1.0, na.rm = TRUE) +
|
|
179
|
+
scale_color_manual(values = color_map_renamed, name = NULL) +
|
|
180
|
+
scale_linetype_manual(
|
|
181
|
+
values = c(
|
|
182
|
+
setNames(rep("solid", length(CONFIG$model_labels)), CONFIG$model_labels),
|
|
183
|
+
"All" = "dashed", "None" = "dotted"
|
|
184
|
+
),
|
|
185
|
+
name = NULL
|
|
186
|
+
) +
|
|
187
|
+
scale_x_continuous(
|
|
188
|
+
limits = c(CONFIG$threshold_lo, CONFIG$threshold_hi),
|
|
189
|
+
labels = scales::percent_format(accuracy = 1)
|
|
190
|
+
) +
|
|
191
|
+
scale_y_continuous(
|
|
192
|
+
limits = c(
|
|
193
|
+
-0.05,
|
|
194
|
+
max(dca_result$dca$net_benefit, na.rm = TRUE) * 1.1
|
|
195
|
+
)
|
|
196
|
+
) +
|
|
197
|
+
geom_hline(yintercept = 0, linetype = "solid", color = "#CCCCCC",
|
|
198
|
+
linewidth = 0.5) +
|
|
199
|
+
labs(
|
|
200
|
+
x = "Threshold probability",
|
|
201
|
+
y = "Net benefit",
|
|
202
|
+
title = "Decision Curve Analysis"
|
|
203
|
+
) +
|
|
204
|
+
theme_classic(base_size = 9, base_family = "Arial") +
|
|
205
|
+
theme(
|
|
206
|
+
legend.position = "bottom",
|
|
207
|
+
legend.text = element_text(size = 8),
|
|
208
|
+
axis.title = element_text(size = 9),
|
|
209
|
+
axis.text = element_text(size = 8),
|
|
210
|
+
plot.title = element_text(size = 10, face = "bold"),
|
|
211
|
+
panel.grid.major.y = element_line(color = "#EEEEEE", linewidth = 0.4)
|
|
212
|
+
)
|
|
213
|
+
|
|
214
|
+
# Save
|
|
215
|
+
for (ext in c("pdf", "png")) {
|
|
216
|
+
outfile <- paste0(CONFIG$output_prefix, "_dca.", ext)
|
|
217
|
+
dpi <- if (ext == "png") 300 else NULL
|
|
218
|
+
ggsave(outfile, plot = p_dca, width = 5.5, height = 4.0,
|
|
219
|
+
dpi = dpi, bg = "white")
|
|
220
|
+
cat(sprintf("Saved: %s\n", outfile))
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
224
|
+
# SAVE NUMERIC RESULTS
|
|
225
|
+
# ══════════════════════════════════════════════════════════════════════════════
|
|
226
|
+
|
|
227
|
+
results_file <- paste0(CONFIG$output_prefix, "_results.csv")
|
|
228
|
+
write.csv(dca_result$dca, results_file, row.names = FALSE)
|
|
229
|
+
cat(sprintf("Saved: %s\n", results_file))
|
|
230
|
+
|
|
231
|
+
# ── Session info ───────────────────────────────────────────────────────────────
|
|
232
|
+
cat("\n── Session Info ─────────────────────────────────────────────────────\n")
|
|
233
|
+
for (pkg in c("dcurves", "ggplot2", "dplyr")) {
|
|
234
|
+
cat(sprintf(" %-12s %s\n", pkg, packageVersion(pkg)))
|
|
235
|
+
}
|
|
236
|
+
cat(sprintf("Date: %s\n", format(Sys.time())))
|
|
237
|
+
cat("DCA analysis complete.\n")
|