hccinfhir 0.0.3__tar.gz → 0.0.4__tar.gz

{hccinfhir-0.0.3 → hccinfhir-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: hccinfhir
-Version: 0.0.3
+Version: 0.0.4
 Summary: HCC Algorithm for FHIR Resources
 Project-URL: Homepage, https://github.com/mimilabs/hccinfhir
 Project-URL: Issues, https://github.com/mimilabs/hccinfhir/issues
@@ -45,7 +45,26 @@ sld = [{
 }, ...]
 ```
 
-For more details on the SLD format, see the `models.py` file.
+Or, for direct risk score calculation from a list of diagnosis codes, you only need the model name, diagnosis codes, and basic demographic factors:
+
+```python
+from hccinfhir.model_calculate import calculate_raf
+
+diagnosis_codes = ['E119', 'I509']  # Diabetes without complications, Heart failure
+age = 67
+sex = 'F'
+model_name = "CMS-HCC Model V24"
+
+result = calculate_raf(
+   diagnosis_codes=diagnosis_codes,
+   model_name=model_name,
+   age=age,
+   sex=sex
+)
+```
+
+
+For more details on the SLD format, see the `datamodels.py` file.
 
 ## Core Components
 
@@ -71,21 +90,33 @@ filtered_sld = apply_filter(sld_list)
 ```
 
 
-### 3. Logic Module (In Development)
+### 3. Logic Module 
 Implements core HCC calculation logic:
 - Maps diagnosis codes to HCC categories
 - Applies hierarchical rules and interactions
 - Calculates final RAF scores
 - Integrates with standard CMS data files
 
-## Usage
+```python
+from hccinfhir.model_calculate import calculate_raf
+
+diagnosis_codes = ['E119', 'I509']  # Diabetes without complications, Heart failure
+result = calculate_raf(
+   diagnosis_codes=diagnosis_codes,
+   model_name="CMS-HCC Model V24",
+   age=67,
+   sex='F'
+)
+```
+
+### 4. Running HCC on FHIR data
+
 ```python
 from hccinfhir import HCCInFHIR
 
 hcc_processor = HCCInFHIR()
-sld_list = hcc_processor.extract_sld_list(eob_list)
-filtered_sld = hcc_processor.apply_filters(sld_list)  # future
-raf_details = hcc_processor.calculate_raf(filtered_sld, demographic_data)  # future
+
+result = hcc_processor.run(eob_list, demographic_data)
 ```
 
 ## Testing
@@ -172,6 +203,33 @@ $ python3 -m pytest tests/*
 3. Add support for allowed_amount in 837 if available in different segments
 4. Consider adding more robust error handling in both implementations
 
+## Data Files
+
+`ra_dx_to_cc_mapping_2025.csv`
+```sql
+SELECT diagnosis_code, cc, model_name 
+FROM ra_dx_to_cc_mapping 
+WHERE year = 2025 and model_type = 'Initial';
+```
+
+`ra_hierarchies_2025.csv`
+```sql
+SELECT cc_parent, 
+  cc_child, 
+  model_domain, 
+  model_version, 
+  model_fullname
+FROM ra_hierarchies
+WHERE eff_last_date > '2025-01-01';
+```
+
+`ra_coefficients_2025.csv`
+```sql
+SELECT coefficient, value, model_domain, model_version 
+FROM ra_coefficients 
+WHERE eff_last_date > '2025-01-01';
+```   
+
 ## Contributing
 Join us at [mimilabs](https://mimilabs.ai/signup). Reference data available in MIMILabs data lakehouse.
 

{hccinfhir-0.0.3 → hccinfhir-0.0.4}/README.md

@@ -31,7 +31,26 @@ sld = [{
 }, ...]
 ```
 
-For more details on the SLD format, see the `models.py` file.
+Or, for direct risk score calculation from a list of diagnosis codes, you only need the model name, diagnosis codes, and basic demographic factors:
+
+```python
+from hccinfhir.model_calculate import calculate_raf
+
+diagnosis_codes = ['E119', 'I509']  # Diabetes without complications, Heart failure
+age = 67
+sex = 'F'
+model_name = "CMS-HCC Model V24"
+
+result = calculate_raf(
+   diagnosis_codes=diagnosis_codes,
+   model_name=model_name,
+   age=age,
+   sex=sex
+)
+```
+
+
+For more details on the SLD format, see the `datamodels.py` file.
 
 ## Core Components
 
@@ -57,21 +76,33 @@ filtered_sld = apply_filter(sld_list)
 ```
 
 
-### 3. Logic Module (In Development)
+### 3. Logic Module 
 Implements core HCC calculation logic:
 - Maps diagnosis codes to HCC categories
 - Applies hierarchical rules and interactions
 - Calculates final RAF scores
 - Integrates with standard CMS data files
 
-## Usage
+```python
+from hccinfhir.model_calculate import calculate_raf
+
+diagnosis_codes = ['E119', 'I509']  # Diabetes without complications, Heart failure
+result = calculate_raf(
+   diagnosis_codes=diagnosis_codes,
+   model_name="CMS-HCC Model V24",
+   age=67,
+   sex='F'
+)
+```
+
+### 4. Running HCC on FHIR data
+
 ```python
 from hccinfhir import HCCInFHIR
 
 hcc_processor = HCCInFHIR()
-sld_list = hcc_processor.extract_sld_list(eob_list)
-filtered_sld = hcc_processor.apply_filters(sld_list)  # future
-raf_details = hcc_processor.calculate_raf(filtered_sld, demographic_data)  # future
+
+result = hcc_processor.run(eob_list, demographic_data)
 ```
 
 ## Testing
@@ -158,6 +189,33 @@ $ python3 -m pytest tests/*
 3. Add support for allowed_amount in 837 if available in different segments
 4. Consider adding more robust error handling in both implementations
 
+## Data Files
+
+`ra_dx_to_cc_mapping_2025.csv`
+```sql
+SELECT diagnosis_code, cc, model_name 
+FROM ra_dx_to_cc_mapping 
+WHERE year = 2025 and model_type = 'Initial';
+```
+
+`ra_hierarchies_2025.csv`
+```sql
+SELECT cc_parent, 
+  cc_child, 
+  model_domain, 
+  model_version, 
+  model_fullname
+FROM ra_hierarchies
+WHERE eff_last_date > '2025-01-01';
+```
+
+`ra_coefficients_2025.csv`
+```sql
+SELECT coefficient, value, model_domain, model_version 
+FROM ra_coefficients 
+WHERE eff_last_date > '2025-01-01';
+```   
+
 ## Contributing
 Join us at [mimilabs](https://mimilabs.ai/signup). Reference data available in MIMILabs data lakehouse.