Skip to content

Changelog

All notable changes to alx-heor are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Planned

  • Optum data source support
  • Komodo data source support (Snowflake)
  • Loopback data source support
  • MDV (Japan) data source support

[0.5.0] - 2025-01-15

Added

  • Cohort module with declarative criteria specification
  • get_cohort() - main entry point for cohort building
  • CohortCriteria - complete specification of inclusion/exclusion
  • DiagnosisCriteria - diagnosis-based criteria with time windows
  • ProcedureCriteria - procedure-based criteria
  • MedicationCriteria - medication-based criteria (generic name, NDC, J-code)
  • EnrollmentCriteria - continuous enrollment requirements

  • CohortResult - structured results with attrition tracking

  • Enrollment module with gap analysis

  • get_enrollment() - fetch enrollment data
  • calculate_enrollment_gaps() - gap analysis relative to index date
  • filter_continuous_enrollment() - filter by gap threshold
  • get_censor_dates() - censoring for survival analysis

  • analyze_enrollment() - all-in-one enrollment analysis

  • Medications module with treatment analysis

  • lookup_medications() - NDC/J-code lookup by generic name
  • get_treatment_claims() - treatment claims for cohort
  • assign_medication_category() - categorize by therapeutic class
  • identify_treatment_episodes() - detect treatment episodes
  • calculate_pdc() - adherence calculation

  • classify_payer_type() - payer classification

  • Documentation site (MkDocs with Material theme)

  • API reference with auto-generated docstrings
  • Tutorials for cohort, enrollment, medication analysis
  • Data sources reference

Changed

  • Reorganized module exports with __all__
  • Enhanced docstrings with NumPy format

[0.4.0] - 2025-01-10

Added

  • Claims module with get_claims() and build_claims_sql()
  • Demographics filtering with add_demographics() and filter_demographics()
  • Index date calculation with get_index_dates()

Changed

  • Configuration-driven column mapping via get_source_config()

[0.3.0] - 2025-01-05

Added

  • Data source configuration registry (SOURCES)
  • Column mappings for IQVIA, Optum, Komodo
  • get_source_config() and list_sources() functions

[0.2.0] - 2024-12-20

Added

  • Database module with RedshiftConnection
  • query() method for executing SQL
  • get_tables() and get_columns() for schema exploration
  • format_in_clause() utility

[0.1.0] - 2024-12-15

Added

  • Initial project structure
  • Package configuration with pyproject.toml
  • Basic imports and module layout