hccinfhir 0.2.2__tar.gz → 0.2.4__tar.gz
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.
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/PKG-INFO +7 -5
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/README.md +6 -4
- hccinfhir-0.2.4/hccinfhir/data/ph_race_and_ethnicity_cdc_v1.3.csv +1325 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/datamodels.py +123 -6
- hccinfhir-0.2.4/hccinfhir/extractor_834.py +756 -0
- hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_02.txt +1 -0
- hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_03.txt +1 -0
- hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_04.txt +1 -0
- hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_05.txt +1 -0
- hccinfhir-0.2.4/hccinfhir/sample_files/sample_834_06.txt +1 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/utils.py +40 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/pyproject.toml +1 -1
- hccinfhir-0.2.2/hccinfhir/extractor_834.py +0 -511
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/.gitignore +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/LICENSE +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/__init__.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/constants.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/__init__.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/hcc_is_chronic.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/hcc_is_chronic_without_esrd_model.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_coefficients_2025.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_coefficients_2026.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_dx_to_cc_2025.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_dx_to_cc_2026.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_eligible_cpt_hcpcs_2023.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_eligible_cpt_hcpcs_2024.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_eligible_cpt_hcpcs_2025.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_eligible_cpt_hcpcs_2026.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_hierarchies_2025.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_hierarchies_2026.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/data/ra_labels_2026.csv +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/defaults.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/extractor.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/extractor_837.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/extractor_fhir.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/filter.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/hccinfhir.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_calculate.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_coefficients.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_demographics.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_dx_to_cc.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_hierarchies.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/model_interactions.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/__init__.py +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_834_01.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_0.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_1.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_10.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_11.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_12.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_2.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_3.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_4.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_5.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_6.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_7.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_8.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_837_9.txt +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_eob_1.json +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_eob_2.json +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_eob_200.ndjson +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/sample_files/sample_eob_3.json +0 -0
- {hccinfhir-0.2.2 → hccinfhir-0.2.4}/hccinfhir/samples.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.3
|
|
2
2
|
Name: hccinfhir
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.4
|
|
4
4
|
Summary: HCC Algorithm for FHIR Resources
|
|
5
5
|
Project-URL: Homepage, https://github.com/mimilabs/hccinfhir
|
|
6
6
|
Project-URL: Issues, https://github.com/mimilabs/hccinfhir/issues
|
|
@@ -80,7 +80,7 @@ print(f"HCCs: {result.hcc_list}")
|
|
|
80
80
|
- **Custom Data Files**: Full support for custom coefficients, mappings, and hierarchies
|
|
81
81
|
- **Flexible File Resolution**: Absolute paths, relative paths, or bundled data files
|
|
82
82
|
- **Type-Safe**: Built on Pydantic with full type hints
|
|
83
|
-
- **Well-Tested**:
|
|
83
|
+
- **Well-Tested**: 189 comprehensive tests covering all features
|
|
84
84
|
|
|
85
85
|
## 📊 Data Sources & Use Cases
|
|
86
86
|
|
|
@@ -95,6 +95,7 @@ print(f"HCCs: {result.hcc_list}")
|
|
|
95
95
|
- **Use Case**: Extract dual eligibility status, detect Medicaid coverage loss
|
|
96
96
|
- **Features**: California DHCS aid code mapping, Medicare status codes, coverage tracking
|
|
97
97
|
- **Output**: Demographics with accurate dual eligibility for risk calculations
|
|
98
|
+
- **Architecture**: See [834 Parsing Documentation](./README_PARSING834.md) for transaction structure and parsing logic
|
|
98
99
|
|
|
99
100
|
### 3. **FHIR ExplanationOfBenefit Resources**
|
|
100
101
|
- **Input**: FHIR EOB from CMS Blue Button 2.0 / BCDA API
|
|
@@ -1037,8 +1038,8 @@ result = processor.run([eob], demographics) # Note: [eob] not eob
|
|
|
1037
1038
|
claim = get_837_sample(0) # Cases 0-12 (returns string)
|
|
1038
1039
|
claims = get_837_sample_list([0, 1, 2]) # Returns list
|
|
1039
1040
|
|
|
1040
|
-
# X12 834 enrollment samples
|
|
1041
|
-
enrollment_834 = get_834_sample(1) #
|
|
1041
|
+
# X12 834 enrollment samples (6 CA DHCS scenarios)
|
|
1042
|
+
enrollment_834 = get_834_sample(1) # Cases 1-6 available (returns string)
|
|
1042
1043
|
|
|
1043
1044
|
# List all available samples
|
|
1044
1045
|
info = list_available_samples()
|
|
@@ -1056,7 +1057,7 @@ hatch shell
|
|
|
1056
1057
|
# Install in development mode
|
|
1057
1058
|
pip install -e .
|
|
1058
1059
|
|
|
1059
|
-
# Run all tests (
|
|
1060
|
+
# Run all tests (189 tests)
|
|
1060
1061
|
pytest tests/
|
|
1061
1062
|
|
|
1062
1063
|
# Run specific test file
|
|
@@ -1073,6 +1074,7 @@ Apache License 2.0. See [LICENSE](LICENSE) for details.
|
|
|
1073
1074
|
## 📞 Support
|
|
1074
1075
|
|
|
1075
1076
|
- **Claude Code Documentation**: [CLAUDE.md](./CLAUDE.md) - Comprehensive developer guide
|
|
1077
|
+
- **834 Parsing Architecture**: [README_PARSING834.md](./README_PARSING834.md) - X12 834 transaction structure and parsing logic
|
|
1076
1078
|
- **Issues**: [GitHub Issues](https://github.com/mimilabs/hccinfhir/issues)
|
|
1077
1079
|
|
|
1078
1080
|
## 👥 Contributors
|
|
@@ -65,7 +65,7 @@ print(f"HCCs: {result.hcc_list}")
|
|
|
65
65
|
- **Custom Data Files**: Full support for custom coefficients, mappings, and hierarchies
|
|
66
66
|
- **Flexible File Resolution**: Absolute paths, relative paths, or bundled data files
|
|
67
67
|
- **Type-Safe**: Built on Pydantic with full type hints
|
|
68
|
-
- **Well-Tested**:
|
|
68
|
+
- **Well-Tested**: 189 comprehensive tests covering all features
|
|
69
69
|
|
|
70
70
|
## 📊 Data Sources & Use Cases
|
|
71
71
|
|
|
@@ -80,6 +80,7 @@ print(f"HCCs: {result.hcc_list}")
|
|
|
80
80
|
- **Use Case**: Extract dual eligibility status, detect Medicaid coverage loss
|
|
81
81
|
- **Features**: California DHCS aid code mapping, Medicare status codes, coverage tracking
|
|
82
82
|
- **Output**: Demographics with accurate dual eligibility for risk calculations
|
|
83
|
+
- **Architecture**: See [834 Parsing Documentation](./README_PARSING834.md) for transaction structure and parsing logic
|
|
83
84
|
|
|
84
85
|
### 3. **FHIR ExplanationOfBenefit Resources**
|
|
85
86
|
- **Input**: FHIR EOB from CMS Blue Button 2.0 / BCDA API
|
|
@@ -1022,8 +1023,8 @@ result = processor.run([eob], demographics) # Note: [eob] not eob
|
|
|
1022
1023
|
claim = get_837_sample(0) # Cases 0-12 (returns string)
|
|
1023
1024
|
claims = get_837_sample_list([0, 1, 2]) # Returns list
|
|
1024
1025
|
|
|
1025
|
-
# X12 834 enrollment samples
|
|
1026
|
-
enrollment_834 = get_834_sample(1) #
|
|
1026
|
+
# X12 834 enrollment samples (6 CA DHCS scenarios)
|
|
1027
|
+
enrollment_834 = get_834_sample(1) # Cases 1-6 available (returns string)
|
|
1027
1028
|
|
|
1028
1029
|
# List all available samples
|
|
1029
1030
|
info = list_available_samples()
|
|
@@ -1041,7 +1042,7 @@ hatch shell
|
|
|
1041
1042
|
# Install in development mode
|
|
1042
1043
|
pip install -e .
|
|
1043
1044
|
|
|
1044
|
-
# Run all tests (
|
|
1045
|
+
# Run all tests (189 tests)
|
|
1045
1046
|
pytest tests/
|
|
1046
1047
|
|
|
1047
1048
|
# Run specific test file
|
|
@@ -1058,6 +1059,7 @@ Apache License 2.0. See [LICENSE](LICENSE) for details.
|
|
|
1058
1059
|
## 📞 Support
|
|
1059
1060
|
|
|
1060
1061
|
- **Claude Code Documentation**: [CLAUDE.md](./CLAUDE.md) - Comprehensive developer guide
|
|
1062
|
+
- **834 Parsing Architecture**: [README_PARSING834.md](./README_PARSING834.md) - X12 834 transaction structure and parsing logic
|
|
1061
1063
|
- **Issues**: [GitHub Issues](https://github.com/mimilabs/hccinfhir/issues)
|
|
1062
1064
|
|
|
1063
1065
|
## 👥 Contributors
|