Getting started:

To get the most of this guide, we recommend downloading our synthesized Person and Diagnosis data so you can get started right away with testing out the application.

• The Diagnosis file Download
• The Person file Download

To get started, visit our customer Portal and create an account. On the Menu panel select MSCORE™ and download the version of the application best suited for your Operating System (OS). Your license key, required to activate the application, is also provided on this page. An email will also be sent to the registered address with your license key.

Quick Start:

Once the application is downloaded, you can access it by navigating to its location using your preferred terminal and specifying the necessary arguments to run your first score!

Diagnosis File

Upload file by providing the full file path name. A Diagnosis file is required for Model execution. Accepted input format is CSV. This field can be entered manually; however, we recommend using the browser button for streamlined navigation and to eliminate user input errors.

Required Diagnosis input file format:

Person File

Upload file by providing the full file path name. A Person file is required for Model execution. Accepted input format is CSV. This field can be entered manually; however, we recommend using the browser button for streamlined navigation and to eliminate user input errors.

Required Person input file format:

Output Directory

Enter the location where you want scored results saved. This field can be entered manually; however, we recommend using the browser button for streamlined navigation and to eliminate user input errors.

Output File Name

Name your score file in the Output File Name field. Do not add the file extension.

Output File Type

Currently only the CSV format is available.

Model Type

Select a Model Type from the dropdown. Currently only the CMS-HCC Model is supported in the application.

Model Version

Select a Model Version (V22, V24, or V28) from the dropdown.

Model Year

Select a Model Year (2021, 2022, 2023, 2024, 2025) from the dropdown.

Select Columns to Include in Output

Select columns (Scores Only, Scores & Demography, Scores, Demography & HCC, Scores, Demography, HCC & CC, Scores, HCC & Interactions, or All Fields) to include on your output scored file.

Once all selections are made, click on Run Scores, and navigate to your designated Output Directory to view results. A window will open notifying you that the scoring is complete and includes the file name and location. Output data will be provided in one of the following formats depending on the selected Model Version listed at the end of this document.

Generate Score Relative Factors Output

MSCORE™ Version: 23.02.01 and up supports the option to report all Relative Factors which make up an individual person's raw risk score.

Check the box to have a separate Relative Factor report generated to your designated Output Directory.

Python Package Index (PyPI) Tutorial:

MSCORE™ 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: MSCORE™ unlocks multiple integration opportunities including real-time scoring, embedding in EHR or enterprise data warehouse, incorporating into cloud applications, and traditional batch scoring.

• SAS®-Free: Create HCC and risk scores without SAS® software. Reduce software license costs and avoid the headache of re-coding and maintaining software in another programming language.

• Enhanced Output: MSCORE™ 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. MSCORE™ 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 Mac, Windows 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 mscore package. Please log in or register on this site to create a user account and receive a license key.

Trial License

After you've installed mscore, 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 MSCORE™ 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 on the billing tab. To license MSCORE™ for commercial purposes other than internal business operations, please 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 to obtain your complimentary academic license.

Basic Use

Before you can run your scores, you will need to generate an authorization token object.

                
import sourcedefender  #This package is required at the top
                
from  mscore import AuthorizeLicense, MScore,
                
auth = AuthorizeLicense(license_key).validate()
            

Required

• authorizer - The authorization token obtained when AuthroizeLicense is ran
• year
• version
• model
• person_data (Pandas DataFrame, csv, or parquet file)
• diag_data (Pandas DataFrame, csv, or parquet file)
• columns

Optional

• rf-output (boolean) - Generates a file of your scores Relative Factors
• dev (boolean) - Runs the application in 'Development' mode

• Person File
• Diagnosis File

                    
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(license_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.

• v24_2024_scores.risk_scores
• v24_2024_scores.relative_factors

From here you can proceed to use the risk score or relative factor DataFrames for further downstream processing or utilize the Pandas built-in methods to save to a file type of your choosing.

Supported Data

The mscore class attributes, person_data and diag_data, 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

MSCORE™ is designed to be universally compatible, ensuring seamless integration across various platforms.

• Operating Systems: Mac, Windows and 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.

Command Line Interface Tutorial:

The Command Line Interface (CLI) Application is recognized for its robustness, offering the ability to effortlessly load directly into your data warehouse and seamlessly integrate across various systems.

Open linux terminal and navigate to the location of the application. To skip this step, provide the full file path location when you input arguments.

A list of accepted input arguments are available using --help command.

• Linux: ./Mscore --help

The below input arguments are required to run the application:

• --person_data
• --diag_data
• --year
• --version
• --model
• --columns
• --output_dir
• --file_name
• --relative_factors
• --file_ext

Linux:

Output File Format:

The table below maps all of the potential columns available in the output file. Depending on your model version and column output selection, the amount and order of the columns may vary. You can find which columns to expect, for each model version selected, on the Model column in the table below.

For example, running the V24 model will produce a column named "D" on the output file. The V22 model does not use this column so it will not be present on the output file if selected.

Model HCCs:

Select a model version to display the HCCs or download a copy for your records.

CMS-HCC Version 22 (V22)

CMS-HCC Version 24 (V24)

CMS-HCC Version 28 (V28)

Performance Notice & Requirements:

As with any data-processing-intensive application, larger input datasets require higher system resources, particularly in terms of RAM/memory.

Minimum System Requirements for PyPI:

Minimum System Requirements for CLI:

Support and Stay Connected:

We are experts in Risk Adjustment and we're here to help. Whether it's general questions, billing, or integration support, please contact us📧. We are here to make risk scoring easy.

Please subscribe to our newsletter, to receive updates on new MSCORE™ features, model releases, tutorials, and to stay up-to-date on the latest news in risk adjustment.