mscore 25.0.0__tar.gz → 25.0.4__tar.gz

{mscore-25.0.0 → mscore-25.0.4}/PKG-INFO

@@ -1,158 +1,151 @@
-Metadata-Version: 2.1
-Name: mscore
-Version: 25.0.0
-Summary: MScore: Risk Scores Made Easy
-Home-page: https://github.com/elevendatacorp/mscore.git
-Author: RAM Development Team
-Author-email: RAM Development Team <dev@riskadjustmentmodel.com>
-Project-URL: Homepage, https://riskadjustmentmodel.com/mscore-product
-Project-URL: Bug Tracker, https://github.com/elevendatacorp/mscore/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: pandas
-Requires-Dist: pyarrow
-Requires-Dist: numpy
-Requires-Dist: requests
-Requires-Dist: getmac
-Requires-Dist: cython
-Requires-Dist: pydantic
-Requires-Dist: cryptography
-Requires-Dist: sourcedefender
-
-<p align="center"><a href="https://www.riskadjustmentmodel.com/" target="_blank">
-    <img src="https://ram-site-assets-pub.s3.amazonaws.com/images/mscore_logo_white_space.png">
-</a></p>
-
----
-
-M<span style="font-size:.8em;">SCORE</span>™ is a python package designed to streamline the CMS-HCC model risk score calculation process for health plans and providers participating in Medicare Advantage and value-based care. It provides a SAS®-free alternative to produce HCCs and risk scores. It streamlines your data processing for enhanced accessibility and allows you to keep your data secure in-house, so you can focus on execution of your risk adjustment strategy.
-
-## Features
-- **Implement Anywhere**: M<span style="font-size:.8em;">SCORE</span>™ unlocks multiple integration opportunities including real-time scoring, embedding in EHR or enterprise data warehouse, incorporating into cloud applications, and traditional batch scoring.
-- **SAS<sup><span style="font-size:.8em;">&reg;</span></sup>-Free**:  Create HCC and risk scores without SAS<sup><span style="font-size:.8em;">&reg;</span></sup> software, reduce software license costs and the headache of recoding and maintaining the software in another programming language.
-- **Enhanced Output**:  M<span style="font-size:.8em;">SCORE</span>™ provides the numeric relative factor value for each HCC assigned to a person allowing for a deeper understanding of how each factor contributes to an individual's overall risk score.
-- **Reliable**: Validated on over 1 million plus enrollees. M<span style="font-size:.8em;">SCORE</span>™ is rigorously tested and updated with each HCC model release.
-- **CMS-HCC Model Support**: Supports HCC models V22, V24, and V28, covering payment years 2021-2024 with upgrades for each release from CMS (Initial, Mid-Year, Final).
-- **Easy to Set Up & Maintain**: Easily installed and upgraded using pip, Python's standard package manager.
-- **Platform Compatibility**: Compatible with Windows, Mac, and Linux operating systems.
-- **Optimized Performance**: Efficient processing with fast runtimes, ensuring quick and accurate risk score calculations.
-- **Improved Data Security**: Securely process personal health information within your organization's IT infrastructure.
-
-
-## Installation
-
-    pip install mscore
-
-## Registration
-
-Registration is required to use the <code>mscore</code> package.  Please visit https://riskadjustmentmodel.com/registration to create user account and obtain a license key.
-
-## Trial License
-
-After you've installed <code>mscore</code>, run the following command to activate your free 90-day trial. An internet connection is required to activate & run the package.
-
-    mscore -a <license key>
-
-## Subscribe
-
-To use M<span style="font-size:.8em;">SCORE</span>™ for internal business operations beyond the 90-day trial period, a pay-as-you-go subscription and payment method is needed. Please set up your payment method in our [customer portal](https://riskadjustmentmodel.com/account/login/) on the billing tab. To license M<span style="font-size:.8em;">SCORE</span>™ for commercial purposes other than internal business operations, please [contact us](https://riskadjustmentmodel.com/contact-us) directly for alternative licensing.
-
-For more information on pricing, please see our product page.  If you do not see a price you like, then please email us so we can discuss your requirements.
-
-Academic users are eligible for a free license of our software. Please [contact us](https://riskadjustmentmodel.com/contact-us) to obtain your complimentary academic license.
-
-
-## Basic Use
-
-Before you can run your scores, you will need to generate an authorization token object.
-
-```python
-import sourcedefender  #This package is required at the top
-from mscore import AuthorizeLicense, MScore
-
-auth = AuthorizeLicense(staging_key).validate()
-```
-> **<span style="color:orange">_NOTE:_</span>** You must import sourcedefender at the top of every package that imports MScore.
-
-The <code>mscore</code> class requires 7 arguments in order to run with 2 optional arguments.
-
-### Required
-* <code>authorizer</code> - The authorization token obtained when <span style="font-family:courier-new">AuthroizeLicense</span> is ran
-* <code>year</code> 
-* <code>version</code>
-* <code>model</code> 
-* <code>person_data</code> (Pandas DataFrame, csv, or parquet file)
-* <code>diag_data</code> (Pandas DataFrame, csv, or parquet file)
-* <code>columns</code> 
-
-### Optional
-* <code>rf-output</code> (boolean) - Generates a file of your scores Relative Factors
-* <code>dev</code> (boolean) - Runs the application in 'Development' mode
-
- **_NOTE:_**  The example below assumes you already have a [Pandas](https://pandas.pydata.org/) DataFrame generated for your person and diagnosis datasets.
-If you don't have this data yet and want to test <code>mscore</code>, download our synthetic data files here:
-* [Person File](https://mph-static-site.s3.amazonaws.com/static/tutorial-files/person.csv)
-* [Diagnosis File](https://mph-static-site.s3.amazonaws.com/static/tutorial-files/diag.csv)
-
-
-```python
-import sourcedefender
-import pandas as pd
-from mscore import AuthorizeLicense, MScore
-
-# Generate DataFrames if using our test files
-person_df = pd.read_csv('person.csv')
-diag_df = pd.read_csv('diag.csv')
-
-auth = AuthorizeLicense(staging_key).validate()
-
-model = MScore(
-    authorizer = auth,
-    year = '2024', 
-    version = 'V24',
-    model = 'CMS-HCC',
-    person_data = person_df,
-    diag_data = diag_df,
-    columns = 'all-fields',
-    rf_output = True,
-)
-
-v24_2024_scores = model.score_mscore()
-
-print(v24_2024_scores.risk_scores)
-print(v24_2024_scores.relative_factors)
-```
-The resulting 'v24_2024_scores' output is a data model object of pandas.DataFrames. You can access your risk scores or relative factors data sets by calling the respective model name from the grouped data model. 
-- <span style="font-family:courier-new">v24_2024_scores.risk_scores</span>
-- <span style="font-family:courier-new">v24_2024_scores.relative_factors</span>
-
-From here you can proceed to use the risk score or relative factor DataFrames for further downstream processing or utilize the [Pandas](https://pandas.pydata.org/docs/user_guide/index.html) built-in methods to save to a file type of your choosing.
-
-### Supported Data
-The <code>mscore</code> class attributes, <code>person_data</code> and <code>diag_data</code>, will accept a Pandas.DataFrame object, CSV or Parquet filepath directly without the need to load your input data to DataFrame first. The resulting outputs will be a Pandas DataFrame object.
-
-### Supported Environments
-
-M<span style="font-size:.8em;">SCORE</span>™ is designed to be universally compatible, ensuring seamless integration across various platforms.
-
-•	Operating Systems:  Windows, macOS, Linux
-•	Python Versions: 3.10 or greater (both 32-bit and 64-bit architectures)
-
-If your required environment is not listed, please contact us as support@riskadjustmentmodel.com for an alternate solution.
-
-## User Resources
-For a more in-depth dive into all available model options, arguments, and reference documents, visit our [User Guides](https://riskadjustmentmodel.com/resources/user-guides).
-
-## Support
-
-We are experts in Risk Adjustment and we're here to help. Whether it's general questions, billing, or integration support, please [contact us](https://riskadjustmentmodel.com/contact-us)📧. We are here to make risk scoring easy.
-
-## Stay Connected
-
-Please [subscribe](https://riskadjustmentmodel.com/articles#userEmail) to our newsletter, to receive updates on new M<span style="font-size:.8em;">SCORE</span>™ features, model releases, tutorials, and to stay up-to-date on the latest news in risk adjustment. 
-
-## Legal
-
-To review the M<span style="font-size:.8em;">SCORE</span>™ license agreement, please visit [EULA](https://riskadjustmentmodel.com/legal/eula) webpage.
+Metadata-Version: 2.1
+Name: mscore
+Version: 25.0.4
+Summary: MScore: Risk Scores Made Easy
+Home-page: https://github.com/elevendatacorp/mscore.git
+Author: RAM Development Team
+Author-email: RAM Development Team <dev@riskadjustmentmodel.com>
+Project-URL: Homepage, https://riskadjustmentmodel.com/mscore-product
+Project-URL: Bug Tracker, https://github.com/elevendatacorp/mscore/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+<p align="center">
+    <a href="https://www.riskadjustmentmodel.com/" target="_blank">
+        <img src="https://ram-site-assets-pub.s3.us-east-1.amazonaws.com/images/mscore_registered_logo_updated_subtitle.png">
+    </a>
+</p>
+
+---
+
+M<span style="font-size:.8em;">SCORE<sup>®</sup></span> is a python package designed to streamline the CMS-HCC model risk score calculation process for health plans and providers participating in Medicare Advantage and value-based care. It provides a SAS®-free alternative to produce HCCs and risk scores. It streamlines your data processing for enhanced accessibility and allows you to keep your data secure in-house, so you can focus on execution of your risk adjustment strategy.
+
+## Features
+- **Implement Anywhere**: M<span style="font-size:.8em;">SCORE<sup>®</sup></span> unlocks multiple integration opportunities including real-time scoring, embedding in EHR or enterprise data warehouse, incorporating into cloud applications, and traditional batch scoring.
+- **SAS<sup><span style="font-size:.8em;">&reg;</span></sup>-Free**:  Create HCC and risk scores without SAS<sup><span style="font-size:.8em;">&reg;</span></sup> software, reduce software license costs and the headache of recoding and maintaining the software in another programming language.
+- **Enhanced Output**:  M<span style="font-size:.8em;">SCORE<sup>®</sup></span> provides the numeric relative factor value for each HCC assigned to a person allowing for a deeper understanding of how each factor contributes to an individual's overall risk score.
+- **Reliable**: Validated on over 1 million plus enrollees. M<span style="font-size:.8em;">SCORE<sup>®</sup></span> is rigorously tested and updated with each HCC model release.
+- **CMS-HCC Model Support**: Supports HCC models V22, V24, and V28, covering payment years 2021-2025 with upgrades for each release from CMS (Initial, Mid-Year, Final).
+- **Easy to Set Up & Maintain**: Easily installed and upgraded using pip, Python's standard package manager.
+- **Platform Compatibility**: Compatible with Windows, Mac, and Linux operating systems.
+- **Optimized Performance**: Efficient processing with fast runtimes, ensuring quick and accurate risk score calculations.
+- **Improved Data Security**: Securely process personal health information within your organization's IT infrastructure.
+
+
+## Installation
+
+    pip install mscore
+
+## Registration
+
+Registration is required to use the <code>mscore</code> package.  Please visit https://riskadjustmentmodel.com/registration to create user account and obtain a license key.
+
+## Trial License
+
+After you've installed <code>mscore</code>, run the following command to activate your free 30-day trial. An internet connection is required to activate & run the package.
+
+    mscore -a <license key>
+
+## Subscribe
+
+To use M<span style="font-size:.8em;">SCORE<sup>®</sup></span> for internal business operations beyond the 30-day trial period, a pay-as-you-go subscription and payment method is needed. Please set up your payment method in our [customer portal](https://riskadjustmentmodel.com/account/login/) on the billing tab. To license M<span style="font-size:.8em;">SCORE<sup>®</sup></span> for commercial purposes other than internal business operations, please [contact us](https://riskadjustmentmodel.com/contact-us) directly for alternative licensing.
+
+For more information on pricing, please see our product page.  If you do not see a price you like, then please email us so we can discuss your requirements.
+
+Academic users are eligible for a free license of our software. Please [contact us](https://riskadjustmentmodel.com/contact-us) to obtain your complimentary academic license.
+
+
+## Basic Use
+
+Before you can run your scores, you will need to generate an authorization token object.
+
+```python
+import sourcedefender  #This package is required at the top
+from mscore import AuthorizeLicense, MScore
+
+auth = AuthorizeLicense(staging_key).validate()
+```
+> **<span style="color:orange">_NOTE:_</span>** You must import sourcedefender at the top of every package that imports MScore.
+
+The <code>mscore</code> class requires 7 arguments in order to run with 2 optional arguments.
+
+### Required
+* <code>authorizer</code> - The authorization token obtained when <span style="font-family:courier-new">AuthroizeLicense</span> is ran
+* <code>year</code> 
+* <code>version</code>
+* <code>model</code> 
+* <code>person_data</code> (Pandas DataFrame, csv, or parquet file)
+* <code>diag_data</code> (Pandas DataFrame, csv, or parquet file)
+* <code>columns</code> 
+
+### Optional
+* <code>rf-output</code> (boolean) - Generates a file of your scores Relative Factors
+* <code>dev</code> (boolean) - Runs the application in 'Development' mode
+
+ **_NOTE:_**  The example below assumes you already have a [Pandas](https://pandas.pydata.org/) DataFrame generated for your person and diagnosis datasets.
+If you don't have this data yet and want to test <code>mscore</code>, download our synthetic data files here:
+* [Person File](https://mph-static-site.s3.amazonaws.com/static/tutorial-files/person.csv)
+* [Diagnosis File](https://mph-static-site.s3.amazonaws.com/static/tutorial-files/diag.csv)
+
+
+```python
+import sourcedefender
+import pandas as pd
+from mscore import AuthorizeLicense, MScore
+
+# Generate DataFrames if using our test files
+person_df = pd.read_csv('person.csv')
+diag_df = pd.read_csv('diag.csv')
+
+auth = AuthorizeLicense(staging_key).validate()
+
+model = MScore(
+    authorizer = auth,
+    year = '2024', 
+    version = 'V24',
+    model = 'CMS-HCC',
+    person_data = person_df,
+    diag_data = diag_df,
+    columns = 'all-fields',
+    rf_output = True,
+)
+
+v24_2024_scores = model.score_mscore()
+
+print(v24_2024_scores.risk_scores)
+print(v24_2024_scores.relative_factors)
+```
+The resulting 'v24_2024_scores' output is a data model object of pandas.DataFrames. You can access your risk scores or relative factors data sets by calling the respective model name from the grouped data model. 
+- <span style="font-family:courier-new">v24_2024_scores.risk_scores</span>
+- <span style="font-family:courier-new">v24_2024_scores.relative_factors</span>
+
+From here you can proceed to use the risk score or relative factor DataFrames for further downstream processing or utilize the [Pandas](https://pandas.pydata.org/docs/user_guide/index.html) built-in methods to save to a file type of your choosing.
+
+### Supported Data
+The <code>mscore</code> class attributes, <code>person_data</code> and <code>diag_data</code>, will accept a Pandas.DataFrame object, CSV or Parquet filepath directly without the need to load your input data to DataFrame first. The resulting outputs will be a Pandas DataFrame object.
+
+### Supported Environments
+
+M<span style="font-size:.8em;">SCORE<sup>®</sup></span> is designed to be universally compatible, ensuring seamless integration across various platforms.
+
+•	Operating Systems:  Windows, macOS, Linux
+•	Python Versions: 3.10 or greater (both 32-bit and 64-bit architectures)
+
+If your required environment is not listed, please contact us as support@riskadjustmentmodel.com for an alternate solution.
+
+## User Resources
+For a more in-depth dive into all available model options, arguments, and reference documents, visit our [User Guides](https://riskadjustmentmodel.com/resources/user-guides).
+
+## Support
+
+We are experts in Risk Adjustment and we're here to help. Whether it's general questions, billing, or integration support, please [contact us](https://riskadjustmentmodel.com/contact-us)📧. We are here to make risk scoring easy.
+
+## Stay Connected
+
+Please [subscribe](https://riskadjustmentmodel.com/articles#userEmail) to our newsletter, to receive updates on new M<span style="font-size:.8em;">SCORE<sup>®</sup></span> features, model releases, tutorials, and to stay up-to-date on the latest news in risk adjustment. 
+
+## Legal
+
+To review the M<span style="font-size:.8em;">SCORE<sup>®</sup></span> license agreement, please visit [EULA](https://riskadjustmentmodel.com/legal/eula) webpage.

{mscore-25.0.0 → mscore-25.0.4}/mscore/__init__.pye

@@ -1,61 +1,60 @@
----BEGIN PYE FILE---
-?xs8yw=-%~arI6N8WsJJ
-iEq4>vPyJHQk8a?X3EQ5
-?*TsJz2(cM58Ovcu^x+j
-N%H~=8sc4*N=1_DDgAJB
-M3B(hFT|1vA^WQWmdr^c
-f^K9E%rAIgb`1~P6SebA
-?EsgI=d&bZI6;L|5MvhI
-0j=ES&;x+;&%JCepm!Tf
-DIAv;pvFo2aL)H&7B;q}
-^Jaq2cfEq=;fPEz9U<))
-xzH|Ol_YNteO{TTau!4K
-n|dgn8xRAB0r38HO6o^9
-Q^8=FsiiX{7suX;fkaKb
-%rK|4LY}l{e!&a+6!@{F
-hrLUC!)myZWnc*-)S;uX
-Cz;GI@QOJYtf8(uql_CH
-^1&I54cfmAzKr}T^^E0y
-ad+RXrd|UTZ~fpC-@;N(
-1xPpf_FphX79qfp@F^8m
-nfM7l{&qi>v)>WWU7sQx
-kFT<aV2$v<VjWpv0C8UK
-T`W(gYeME9@q6T%N9ctb
-B%1RG;klT5Gka@A=9B!W
-ZhuK{%y+=ra`SpMh_*-*
-JY#OrlVSK#2upb}OP-3k
-DO9EwVqxrd9U|YS1;v;3
-IPf;x!D=ajST5UM|C_|=
-s0j*MT3udDR@|exgaeB@
-D|vd_V*7KCqbk5tgDb?T
-81BsRM};ZhC1AN8<}8NK
->%vCrdQ<NJ)%U}<zcI#n
-yo~}Py{I#K%->Tjn|ker
-2fjTJMJTu%1oZqBlMiE`
-76%q@rU5K;mSf{x)H1UD
-jQ@x1%!$6BVGN=*q6rBb
-DZ(7TKDUwlg1hVlo?x?U
-KmFKu%#b5&DWO|TB$8B4
-Tr8JAz971+9)4&8C!EPg
-+BK6lLxF;Ea7XtLv!QY>
-bqJ&TK!OCXqUguE_E~vv
-k2pW}sc=vB=T`7|a)+B!
-!993^qH)Lvh*><noPU7h
-xNo}Ah2jz~&*ij{d<V($
-@QV7>v}7EH2qt`cSp%u#
-JhAt%q3T=PR7&n+@Hj`D
-edNSE+GwJcmp<=m)%Flr
-=#%mNT_j;KDxd+i`z>Bx
-fR6;vd1rX~S2K_7&xiXq
-5iM*2PsO%k5ALrpS*GiW
-Wt!*(rrsp<Q0X**q#XpM
-U^q_JW<)Y2Ffje&9RhWN
-6%y0&lA>8YKcv(Yj7DdU
-SDs$d1KPE8Iw)m;nCn(e
->MOaCzP@rtUy-}wDevgD
-DGb~bqM&BFLfy-A^!~`^
-GQ$zf9NYf$O6%*(1!HI0
-Pq40ro_|52vi6ZL{dl7S
-wVlLa?}>GnJF?TuhE5Wj
-a7c733-Q&Yl-2
+---BEGIN PYE FILE---
+?xs8yw=-%~arI6N8WsJJ
+j&Hn`vPyJHQk8a?X3EQ5
+?*TsJz2(cM58Ovcu^x+j
+N%H~=8sc4*N=1_DDgAJB
+M3B(hFT|1vA^WQWmdr^c
+f^K9E%rAIgb`1~P6SebA
+?EsgI=d&bZI6;L|5MvhI
+0j=ES&;x+;&%JCepm!Tf
+DIAv;pvFo2aL)H&7B;q}
+^Jaq2ce#S+;fPEz9U<))
+xzH|Ol_YNteO{TTau!4K
+n|dgn8xRAB0r38HO6o^9
+Q^8=FsiiX{7suX;fkaKb
+%rK|4LY}l{e!&a+6!@{F
+hrLUC!)myZWnc*-)S;uX
+Cz;GI@QOJYtf8(uql_CH
+^1&I54cfmAzKr}T^^E0y
+ad+RXrd|UTZ~fpC-@;N(
+1xPpf_FphX79qfp@F^8m
+nfM7l{&qi>v)>WWU7sQx
+kFT<aV2$v<VjWpv0C8UK
+T`W(gYeME9@q6T%N9ctb
+B%1RG;klT5Gka@A=9B!W
+ZhuK{%y+=ra`SpMh_*-*
+JY#OrlVSK#2upb}OP-3k
+DO9EwVqxrd9U|YS1;v;3
+IPf;x!D=ajST5UM|C_|=
+s0j*MT3udDR@|exgaeB@
+D|vd_V*7KCqbk5tgDb?T
+81BsRM};ZhC1AN8<}8NK
+>%vCrdQ<NJ)%U}<zcI#n
+yo~}Py{I#K%->Tjn|ker
+2fjTJMJTu%1oZqBlMiE`
+76%q@rU5K;mSf{x)H1UD
+jQ@x1%!$6BVGN=*q6rBb
+DZ(7TKDUwlg1hVlo?x?U
+KmFKu%#b5&DWO|TB$8B4
+Tr8JAz971+9)4&8C!EPg
++BK6lLxF;Ea7XtLv!QY>
+bqJ&TK!OCXqUguE_E~vv
+k2pW}sc=vB=T`7|a)+B!
+!993^qH)Lvh*><noPU7h
+xNo}Ah2jz~&*ij{d<V($
+@QV7>v}7EH2qt`cSp%u#
+JhAt%q3T=PR7&n+@Hj`D
+edNSE+GwJcmp<=m)%Flr
+=#%mNT_j;KDxd+i`z>Bx
+fR6;vd1rX~S2K_7&xiXq
+5iM*2PsO%k5ALrpS*GiW
+Wt!*(rrsp<Q0X**q#XpM
+U^q_JW<)Y2Ffje&9RhWN
+6%y0&lA>8YKcv(Yj7DdU
+SDs$d1KPE8Iw)m;nCn(e
+>MOaCzP@rtUy-}wDevgD
+DGb~bqM&BFLfy-A^!~`^
+GQ$zf9NYf$O6%*(1!HI0
+Pq40ro_|52vi6ZL{dl7S
+v75ta)0RV&DzRk;j!}L
 ----END PYE FILE----

{mscore-25.0.0 → mscore-25.0.4}/mscore/__main__.py

@@ -1,5 +1,5 @@
-import sourcedefender
-try:
-   from . import activate
-except Exception as e:
-   pass
+import sourcedefender
+try:
+   from . import activate
+except Exception as e:
+   pass