mscore 25.0.4__tar.gz → 25.3.0__tar.gz

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: mscore
-Version: 25.0.4
+Version: 25.3.0
 Summary: MScore: Risk Scores Made Easy
 Home-page: https://github.com/elevendatacorp/mscore.git
 Author: RAM Development Team
@@ -11,6 +11,17 @@ 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
+Dynamic: author
+Dynamic: home-page
 
 <p align="center">
     <a href="https://www.riskadjustmentmodel.com/" target="_blank">
@@ -103,23 +114,22 @@ auth = AuthorizeLicense(staging_key).validate()
 
 model = MScore(
     authorizer = auth,
-    year = '2024', 
-    version = 'V24',
+    year = '2025', 
+    version = 'V28',
     model = 'CMS-HCC',
     person_data = person_df,
     diag_data = diag_df,
     columns = 'all-fields',
-    rf_output = True,
 )
 
-v24_2024_scores = model.score_mscore()
+scores = model.score_mscore()
 
-print(v24_2024_scores.risk_scores)
-print(v24_2024_scores.relative_factors)
+print(scores.risk_scores)
+print(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>
+The resulting '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">scores.risk_scores</span>
+- <span style="font-family:courier-new">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.
 

mscore-25.3.0/README.md

@@ -0,0 +1,136 @@
+<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 = '2025', 
+    version = 'V28',
+    model = 'CMS-HCC',
+    person_data = person_df,
+    diag_data = diag_df,
+    columns = 'all-fields',
+)
+
+scores = model.score_mscore()
+
+print(scores.risk_scores)
+print(scores.relative_factors)
+```
+The resulting '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">scores.risk_scores</span>
+- <span style="font-family:courier-new">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.4 → mscore-25.3.0}/mscore/__init__.pye

@@ -1,6 +1,6 @@
 ---BEGIN PYE FILE---
 ?xs8yw=-%~arI6N8WsJJ
-j&Hn`vPyJHQk8a?X3EQ5
+h;O`=vPyJHQk8a?X3EQ5
 ?*TsJz2(cM58Ovcu^x+j
 N%H~=8sc4*N=1_DDgAJB
 M3B(hFT|1vA^WQWmdr^c
@@ -8,7 +8,7 @@ f^K9E%rAIgb`1~P6SebA
 ?EsgI=d&bZI6;L|5MvhI
 0j=ES&;x+;&%JCepm!Tf
 DIAv;pvFo2aL)H&7B;q}
-^Jaq2ce#S+;fPEz9U<))
+^Jap~cfEq=;fPEz9U<))
 xzH|Ol_YNteO{TTau!4K
 n|dgn8xRAB0r38HO6o^9
 Q^8=FsiiX{7suX;fkaKb
@@ -56,5 +56,7 @@ SDs$d1KPE8Iw)m;nCn(e
 DGb~bqM&BFLfy-A^!~`^
 GQ$zf9NYf$O6%*(1!HI0
 Pq40ro_|52vi6ZL{dl7S
-v75ta)0RV&DzRk;j!}L
+wVlLa?}>GnJF?TmheRB)
+W8<_d7wPN0jk^dv4}qr8
+js
 ----END PYE FILE----

{mscore-25.0.4 → mscore-25.3.0}/mscore/activate.pye

@@ -1,7 +1,7 @@
 ---BEGIN PYE FILE---
 t#zYF!{gsj#j-v7Bh`z?
-hA9;St4e$<RGyg%tK^1t
->L41xFjqJu&r#g5w?y`9
+fGHIMt4e$<RGyg%tK^1t
+>J}QnFjqJu&r#g5w?y`9
 wg14PfY;vL>`9+Y0x8Ai
 VH@rgn)QFly2w<;4eoXU
 HFX!t*Og*!5U}2n#{|Ue
@@ -64,49 +64,49 @@ SZ+&H5qe4#K{<qB<zl>!
 gG5Qx?l?s|WN*YrTf+*j
 $3PV@=_ME3nj{;KXec}K
 n?JHRVK$u1iEl$Vj0ZS#
-U(*igl$vd7qhsD%+a;>7
-WPMcGiaeqgk&~r3$mj?c
-Q|n^1MtI(UXB?XdJ`pC4
-mLDj=yD=1^;$MT;G#_Mv
-+nmYAZMiUKSLuTT#OT!+
-wn(B|a0tDqN@GfPPhHRt
-Zv7sC%f~KkM9GTc%4A#=
-5^;g!D99?KkGs=cwurk&
-`2bTlHI{*{Nj@9oi68x>
-m`JbEZzG+->Q=JHo)efM
-sHTFiXinDmX|$@974RBT
-Q_3D^%)bI)>@WH*qJV%L
-YtZ%33iH^U-xqAOx<yJ}
-6_k7EW+;&Vh$aVA-1+M!
-C7DC@6pbzh@)^NsvC5~P
-)|rHo8+CpgU6kW<+`p)k
-!9a1^`?gI9!1w-1<K|^r
-fo{Z-AF*m%NBd3t%w!;*
-o1@);JlNiQv$JG*!iCxT
-w0duuLr6uIMIQ>~5O$Cs
-ujaQsy-g>AIXM+~yiN?z
-K{Y(CcCMd+mWX`$CPttf
-B`EOdPEbqa%)pf`R&fNA
-9(?eu81}ygb*ugoxe>Hv
-8FL_9P<k;eQHVevZFweo
-H%GRjw`<*}%LGNl^rb01
-fzgDZ%hmdwHvsSQg@fUS
-m;r_V%U1=%FxlV_uFxS|
-RdA<gqb|xJrP$uylpi@8
-=oyjM2HaYd=P7$|tlTD5
-qkk<Rn1mC}wu&(Ze9S|B
-5qd;GB24G(6%4YgiyKN^
-#-1|45I?eZ9-$<Cm$oLd
-AK(s=Sv~x_H2$+~H)Gus
-4jxCsu;&T$*Ri<v0}0J9
-WiFTDG1b361z7gaA?VK@
-+|BByyPWPvirBBhuA-^c
-p|2t!S*!=ce=}#Q>3M)N
-7!cM%xPGGE<AfQOICMCA
-Rm&U-%>}E0H@wfS!{qSJ
-XMUDt0V*e4oYI*E4|{TH
-{NX7k4&2uF7b>id&cTBB
-CnB>wYIc@nyR9@07&o_{
-Au4c$u*8ehi{K>f_2S=c
+U(*igl$vd7qhsD%+a;&E
+b8$?|n+l{BsF?08%JmHr
+7}ag5Ol#GwZV03Ua%f}I
+>QO4|yD=1^;$MT;G#?^^
+r^uy_X#N6VexS4;+Wv|d
+nO(bGFGjVjc79D}K?l_d
+W5*Pi+W9kiM}nKz$0ImL
+R}R&>c#U`8!MXWdwurj{
+`+NshcEZT`2x?O8#beEc
+k6HYLbvvES;TVO(wI9r9
+yy<|rby30Mbh4|YF7XdX
+U)xVZjr>+Ax^Av#?au#L
+Bd)NG2-(=2-xn$P=>Sl4
+6_j$qW+;&Vh$aVA$>;Gc
+YrARn6pbzh@)^NsvC8+&
+pV!csO(6$V2$Qik-1P0r
+!3iSTy7*%l`26xt@Zd36
+l6H`u2)|cZ7qTY5m1JSv
+&+3c8Xq}pM&;4dI>iLb9
+{W&Vv5Di8521`S;RVtD=
+x5K?Vwooy+a2613`&kN}
+2skyEd7_e+ouqK;97n8o
+W_-E63oi$)kA>TQ6D)Y$
+T2zeqbie#VJNUa2%}C@S
+19LqRWo;NML5Oh$W<MP*
+D@*U^qIA)l+7m{^){rTA
+<lo5Yh>*0-a(}z4)yBN~
+)<vy@pEgF9d5@u6=bvv}
+F){OGyHdprug}uPh7J!M
+=wG^+6WSEr>Lg}*rrZit
+onj_C)u2+2;=^Z0D1{6#
+Zaxe?XA$MbP*m~m+fPb3
+p51qmO<esr9^f)1k?CCK
+AB9%Z9Brt(J+Ss7B{APx
+Uk*Chn&%1g*ZBVSMhA?2
+A}PM8R^^pH1z7gaA?VK@
++|BCp>BXc!!<PHX>#XR9
+=KNVOB-a3jeKTRU!aSCG
+UO$*S!*1WD<iShCcP2+S
+L)2I@lzXwOH@wfS!{qSJ
+XMWQ?LT`5n)~e7;TXQ#O
+y|Zq0b<C^&Jpj3c&fDJh
+Vl47+rE$49x$RJ467P42
+VP-SW&x%*jJt-gI`SI5e
 E|sRw8T`!o-c<M#&EoU
 ----END PYE FILE----

mscore-25.3.0/mscore/data_variables/__init__.pye

@@ -0,0 +1,7 @@
+---BEGIN PYE FILE---
+S{1Ws^W#b^PPF`=H8his
+G}iZPtj81O3Dvxu2NMzJ
+>-X_7z^LC|`1dQS8^oIJ
+c;+J(MoRt}3%SvUgO`Fo
+&h?w~IN4dzh$KV
+----END PYE FILE----

{mscore-25.0.4 → mscore-25.3.0}/mscore/data_variables/hcc_descriptors.pye

@@ -1,6 +1,6 @@
 ---BEGIN PYE FILE---
 2&-mmphj(rr7yv(zTi|c
-mKh}2@3c5DS5<d*(yX50
+kQpS{@3c5DS5<d*(yX50
 uV)`@#Q_cN&gFEPt6awl
 Q8~o9tz0{2@ODki@N!rk
 R)etp8qKH$-BFrO2Qqw!
@@ -992,5 +992,7 @@ sD4Chx41c7R?qNys{oC{
 HToC7rCYc2hpZm2Am~xv
 A|44C!j#2VyAKSs>oWX8
 35}p?ipUp^4*PD^r{-tb
-b(A@*xtw~vx9dl#@m*)X
+b&x-+u%Km&wE9FJHB@rl
+#!2PU820?GGf#c<;zEr!
+l~w
 ----END PYE FILE----

{mscore-25.0.4 → mscore-25.3.0}/mscore/data_variables/hierarchies.pye

@@ -1,6 +1,6 @@
 ---BEGIN PYE FILE---
 f*k4g01cQo#au&Hk}?Bo
-;29+LOTDy#($I=O1h5~j
+<{2dROTDy#($I=O1h5~j
 I47tojU6C|K^0)w41f8F
 0l8&g_}s4e{z2F%9^65B
 #sxnPa5gd%#YF9AbMcgc
@@ -404,6 +404,7 @@ XZ4qWq=roBbeDQhlPoHI
 4XR2a&z`2WThnLumHBKD
 C}l#;F^89N_Zc<z6A@S)
 Q#W(og{((T>24$5b0#I0
-=QxN{i||3KdQ}9rb<|F}
-@}4!I
+=QxN{i}XjVb7>oZcEwE$
+HkTm6GLcg{AT8pU2$;mV
+w+P&qH#Y
 ----END PYE FILE----