ORASR

Overview

Operational reasoning-action safety routing for selecting safe clinical action pathways under uncertainty.

This repository is part of an eight-repository clinical decision-support research portfolio. Current status: manuscript or component package in preparation. The repository role is manuscript.

Standard Repository Layout

Path	Purpose
src/	Package source code: orasr
tests/	Unit, smoke, and behavior checks
scripts/	Reproducibility and export scripts
examples/	Runnable examples and demonstrations
figures/, visualizations/, outputs/, results/	Generated visual and result artifacts
data/, models/, evaluation/	Dataset, model, and evaluation assets when used by this repo
FIGURE_MANIFEST.csv	Curated figure inventory for manuscript or component evidence
pyproject.toml, setup.py, requirements.txt, pytest.ini	Python package and test configuration

Architecture Flow

flowchart LR
    A[Input data or scenario] --> B[Core package logic]
    B --> C[Safety and quality checks]
    C --> D[Metrics and audit outputs]
    D --> E[Curated figures and result artifacts]

Loading

Core Logic

• Receive risk and action request.
• Check pathway constraints.
• Select route with safety override.
• Record reasoning and audit outputs.

Key Formulas And Rules

• Route r* = argmax_r U(r | risk, constraints)
• Safety override: r = SAFE if constraint violation is detected
• Pathway tier: FAST, NORMAL, or SAFE from thresholded risk

Data, Results, Charts, And Graphs

The curated visual set is controlled by FIGURE_MANIFEST.csv and currently lists 2 figure entries. The manifest links figure IDs, roles, source scripts, source data, captions, sections, timestamps, and export DPI.

ID	Role	PNG	PDF
ORASR-F1	manuscript	figures\orasr_pathway_architecture.png	figures\orasr_pathway_architecture.pdf
ORASR-F2	manuscript	figures\orasr_risk_pathway_map.png	figures\orasr_risk_pathway_map.pdf

Reproduce

cd D:\PhD-NU\Manuscript\GitHub\ORASR
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .
python -m pytest -q

If figure-generation scripts are present, run the matching script listed in FIGURE_MANIFEST.csv from the repository root.

Verification Criteria

• Root metadata and package files are present.
• Source paths follow src/<package>/... where the package shape allows it.
• Tests pass with python -m pytest -q.
• Curated figures are listed in FIGURE_MANIFEST.csv rather than inferred from every raw image file.
• Manuscript status wording stays conservative: in preparation, implementation, supplementary, or reproducibility/component evidence as appropriate.
• No local manuscript path, external assistant wording, or software metadata block is kept in the repository text.

Portfolio Relationship

Repository	Role
BASICS-CDSS	Beyond-accuracy evaluation methodology
TRI-X	Framework-level package
ORASR	Routing and safety-action component
DRAS-5	Dynamic risk-state component
SAFE-Gate	Safety-gated ensemble framework
SynDX	Synthetic validation and explainability evidence
SURgul	SRGL/governance reproducibility component
TRI-X-CDSS	Integration and implementation package

Contact

Chatchai Tritham
Department of Computer Science and Information Technology, Faculty of Science, Naresuan University, Phitsanulok 65000, Thailand
Email: chatchait66@nu.ac.th
ORCID: 0000-0001-7899-228X

Chakkrit Snae Namahoot
Department of Computer Science and Information Technology, Faculty of Science, Naresuan University, Phitsanulok 65000, Thailand
Email: chakkrits@nu.ac.th
ORCID: 0000-0003-4660-4590