Skip to main content

Methods for Observational Inference and Robust Analysis of Interventions in Scientific Experimentation. Multi-domain scientific computing toolkit hosting the MRM framework for Canadian carceral, police, and oversight data, with general-purpose causal inference, signal processing, cryptography, spatial statistics, statistical physics, and psychometrics modules.

Project description

MOIRAIS

Methods for Observational Inference and Robust Analysis of Interventions in Scientific Experimentation

A multi-domain scientific computing toolkit (Python and R) for observational inference, with sociolegal, signal-processing, cryptographic, spatial-statistics, statistical-physics, and psychometrics modules. Hosts the MRM framework as a primary application for Canadian carceral, police, and oversight data analysis.

License: GPL v2 PyPI version Python 3.10+ Software DOI Paper DOI

Installation

Python (PyPI)

pip install moirais

R (CRAN)

install.packages("moirais")

R (r-universe; nightly binary builds)

install.packages(
  "moirais",
  repos = c(
    hadesllm = "https://hadesllm.r-universe.dev",
    CRAN     = "https://cloud.r-project.org"
  )
)

Quick start

import moirais

# Load a built-in dataset
df = moirais.load_dataset("otis-2025")

# Run an MRM module on OTIS data
from moirais.otis_all_analyze import analyze_a01_mrm
result = analyze_a01_mrm(df)
print(result)

Documentation

Full documentation is at hadesllm.github.io/moirais.

Citation

If you use MOIRAIS in your research, please cite the software and the companion paper that describes it. Where applicable to your work, also cite the MRM framework paper and the Hawkes-process methodology paper.

# Software (the toolkit itself)
Ruhela, V. S. (2026). MOIRAIS Toolkit: Methods for Observational Inference
and Robust Analysis of Interventions in Scientific Experimentation
(v0.1.0.post3) [Software]. Zenodo.
https://doi.org/10.5281/zenodo.20111233

# Companion paper (introduces the toolkit)
Ruhela, V. S. (2026). MOIRAIS: A Multi-Domain Scientific Computing
Toolkit for Observational Inference, with Sociolegal, Signal-Processing,
Cryptographic, and Spatial-Statistics Modules. Zenodo.
https://doi.org/10.5281/zenodo.20096350

# MRM framework paper
Ruhela, V. S. (2026). The MRM Framework: A Multi-Source Statistical
Foundation for Canadian Carceral, Police, and Oversight Data, Implemented
as MRM Modules in MOIRAIS. Zenodo.
https://doi.org/10.5281/zenodo.20096075

# Hawkes-process methodology paper
Ruhela, V. S. (2026). Criminological Hawkes Process via MOIRAIS:
Markovian and Non-Markovian Self-Exciting Point Processes for Toronto
Crime. Zenodo.
https://doi.org/10.5281/zenodo.20102198

See CITATION.cff for machine-readable citation metadata.

Acknowledgments

AI assistance

MOIRAIS was developed with substantial assistance from frontier AI assistants. The author retains full responsibility for the code, the methods, and the scientific claims; AI assistance accelerated implementation but does not change the attribution of the work.

  • Claude — Anthropic. Anthropic's Claude family (Opus, Sonnet, and Haiku across the 4.x generation) was used extensively throughout development for code generation, refactoring, documentation, code review, and design discussions. Use was supported by Anthropic research-credit programs.

  • Gemini and Vertex AI — Google. Google's Gemini 2.5 models (Pro and Flash) on the Vertex AI platform were used extensively for additional code generation, cross-checking Claude-generated code, multi-modal data analysis, and prototype evaluation. Use was supported by Google research-credit programs.

Funding and infrastructure

  • Anthropic — Claude API research credits.

  • Google — Gemini / Vertex AI research credits.

  • The author thanks Glenn McNamara — a 35-year career with the Ontario Government — for his methodological mentorship. He brings distribution theory, applied-statistics intuition for administrative data, and the judgment that grounds much of this framework. Glenn is the M in MRM (McNamara-Ruhela-Medina) (catalyst).

  • The author thanks Prof. Angela Zorro Medina, Centre for Criminology and Sociolegal Studies, University of Toronto, who is the author's supervisor, methodological instructor, the domain-expert reviewer of the preliminary methodological approach, and a knowledge user of the framework. The methodological lineage MRM follows is established in her work on anti-gang legislation (Zorro Medina, 2023, The Effect of Anti-Gang Laws on Crime and Social Control) — staggered two-way-fixed-effects identification, formal leads-and-lags Granger-causality diagnostics for parallel trends, multi-source data-integration over five jurisdictional sources, deterrence / routine-activities / certainty mechanism categorisation, and the inequality-effects-of-criminal-law framing — all of which directly shape MRM's empirical-statistical spine. Prof. Medina is the M in MRM (supervisor & reviewer).

Data acknowledgments

Several MRM analyses use Statistics Canada and Health Canada Public Use Microdata Files (PUMFs) — including the Canadian Cannabis Survey (CCS), the Canadian Student Alcohol and Drugs Survey (CSADS), the Canadian Substance Use Survey (CSUS), the Canadian Alcohol and Drugs Survey (CADS, 2019; doi.org/10.25318/132500052021001-eng), and the Canadian Postsecondary Education Alcohol and Drug Use Survey (CPADS) — along with Public Health Agency of Canada (PHAC) and Canadian Institute for Health Information (CIHI) aggregates. Although the analyses use Statistics Canada and Health Canada data, the analyses, interpretations, and conclusions are those of the author and do not represent the views of Statistics Canada or Health Canada. Ontario open data (OTIS, A01-RCDD release; via data.ontario.ca) and Toronto Police Service open data are used under the same standard disclaimer.

License

MOIRAIS is released under the GNU General Public License v2 (GPL-2.0-only); see LICENSE. The licensing matrix for individual components is documented in LICENSING.md.

Reporting issues / security

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

moirais-0.1.0.post4.tar.gz (7.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

moirais-0.1.0.post4-py3-none-any.whl (37.9 MB view details)

Uploaded Python 3

File details

Details for the file moirais-0.1.0.post4.tar.gz.

File metadata

  • Download URL: moirais-0.1.0.post4.tar.gz
  • Upload date:
  • Size: 7.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for moirais-0.1.0.post4.tar.gz
Algorithm Hash digest
SHA256 f09a961f6843e48cd751a3b28510e5bb816e4cac43cc384460b0529f8125545b
MD5 4c757efb21f7e2a91d7fcfe851885831
BLAKE2b-256 94969b3883ee8871de364aeabe892e321e06f5b636fc3d58f86a3c72eae7a59d

See more details on using hashes here.

Provenance

The following attestation bundles were made for moirais-0.1.0.post4.tar.gz:

Publisher: pypi-publish.yml on hadesllm/moirais

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file moirais-0.1.0.post4-py3-none-any.whl.

File metadata

  • Download URL: moirais-0.1.0.post4-py3-none-any.whl
  • Upload date:
  • Size: 37.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for moirais-0.1.0.post4-py3-none-any.whl
Algorithm Hash digest
SHA256 36597c8cccc9e3b8dbda77da9e6a11bcc97819dee560841e7b7fa063ea396417
MD5 8f90215a4f84d268e3c67746df1d5995
BLAKE2b-256 150fb1d16189f116c13772b5b4065f386b1fa75ea57bd5d37d665482bc8c0969

See more details on using hashes here.

Provenance

The following attestation bundles were made for moirais-0.1.0.post4-py3-none-any.whl:

Publisher: pypi-publish.yml on hadesllm/moirais

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page