USPSTF-collection

USPSTF Recommendations Collection

Knowledge objects

This collection implements 8 knowledge objects, using KGrid 2.0 model, for the following published USPSTF recommendations:

Type	Year	Topic Name	Age Group	Grade	Category	Links
Screening	2019	Abdominal Aortic Aneurysm: Screening	Adult, Senior	B, C, D, I	Cardiovascular Disorders (Heart and Vascular Diseases)	Knowledge object information page,USPSTF page
Counseling	2020	Healthy Diet and Physical Activity for Cardiovascular Disease Prevention in Adults With Cardiovascular Risk Factors: Behavioral Counseling Interventions	Adult, Senior	B	Cardiovascular Disorders (Heart and Vascular Diseases), Development and Behavior	Knowledge object information page,USPSTF page
Counseling	2021	Healthy Weight and Weight Gain In Pregnancy: Behavioral Counseling Interventions	Adolescent, Adult	B	Development and Behavior, Metabolic, nutritional, and Endocrine Conditions, Obstetric and Gynecologic Conditions	Knowledge object information page,USPSTF page
Counseling	2024	High Body Mass Index in Children and Adolescents: Interventions	Adolescent, Pediatric	B	Metabolic, nutritional, and Endocrine Conditions	Knowledge object information page,USPSTF page
Screening	2021	Hypertension in Adults: Screening	Adult, Senior	A	Cardiovascular Disorders (Heart and Vascular Diseases)	Knowledge object information page,USPSTF page
Screening	2021	Prediabetes and Type 2 Diabetes: Screening	Adult, Senior	B	Metabolic, nutritional, and Endocrine Conditions	Knowledge object information page,USPSTF page
Preventive medication	2022	Statin Use for the Primary Prevention of Cardiovascular Disease in Adults: Preventive Medication	Adult, Senior	B, C, I	Cardiovascular Disorders (Heart and Vascular Diseases)	Knowledge object information page,USPSTF page
Counseling	2018	Weight Loss to Prevent Obesity-Related Morbidity and Mortality in Adults: Behavioral Interventions	Adult, Senior	B	Metabolic, nutritional, and Endocrine Conditions	Knowledge object information page,USPSTF page

See knowledge object information page or the USPSTF page link for more detail on each knowledge object.

Demo app

Demo app 1, using a python activator knowledgebase

The USPSTF collection Demo App 1, located in the demo folder, leverages the knowledge objects in this repository via a Python Activator Knowledgebase deployed on Heroku. This app delivers precision prevention by providing tailored preventive recommendations for individual patients.

Running the demo app 1 localy

This requires a running activator that activates the USPSTF knowledge objects, and the link is set in the JavaScript code of the demo app. For development purposes, open the demo folder in terminal and run a local virtual server with the following command:

python -m http.server 8001

Then access the demo page at: http://localhost:8001/

Demo app 2, using an SDK-built Knowledgebase

This demo app integrates the USPSTF Collection knowledge objects, included in a knowledgebase, directly in the code. The knowledgebase is created using the KGrid-SDK and (published as a python package)[https://pypi.org/project/kgrid-sdk/], eliminating the need for a separate deployment.

Running the demo app 2 locally in a development environment

Follow these steps to run the app locally:

Change the active directory to the root of the app
```
cd path/to/demo/app
```
Activate the Poetry virtual environment
```
poetry shell
```
Install project dependencies
```
poetry install
```
Set the FLASK_APP environment variable with the path to the Flask app definition
```
export FLASK_APP=sdk_demo.app:app 
```
Execute the Flask app
```
flask run 
```
Then, access the demo app at http://127.0.0.1:5000 in your browser.

How to use these knowledge objects

Knowledge object information page

To open knowledge object information page, open a knowledge object directory (we recommend using Visual Studio Code). Then run a localvirtual server using

python -m http.server 8001

and the access http://localhost:8001/ in your browser.

Using python activator

Install the python activator. Run and point it to the manifest file in this repo:

pip install "python-activator[cli]@https://github.com/kgrid/python-activator/releases/download/0.8/python_activator-0.8-py3-none-any.whl"

ORG_KGRID_PYTHON_ACTIVATOR_MANIFEST_PATH=https://github.com/kgrid-objects/USPSTF-collection/releases/download/1.0/manifest.json python-activator run

Then you can access the python activator at http://127.0.0.1:8000

You can try the python activator with USPSTF collection here.

Using command line interface

For the knowledge objects which implement a CLI service, install the knowledge object that you would like to use, for example:

pip install https://github.com/kgrid-objects/USPSTF-collection/archive/refs/heads/main.zip#subdirectory=abdominal-aortic-aneurysm-screening

Then run the command and pass the input values for a patient:

abdominal-aortic-aneurysm-screening -a 42 -g 1

Using API service

Install the KO that you want to use.

pip install https://github.com/kgrid-objects/USPSTF-collection/archive/refs/heads/main.zip#subdirectory=abdominal-aortic-aneurysm-screening

Install uvicorn in your environment

pip install uvicorn

Then use uvicorn to run the api service, for example

uvicorn abdominal_aortic_aneurysm_screening.abdominal_aortic_aneurysm_screening:app

Then you can use the swagger editor at http://127.0.0.1:8000 or send post requests to http://127.0.0.1:8000/check-inclusion with a request body like

{
"age":20,
"gender": 0,
"has_never_smoked":false
}

Using the knowledge objects directly in the code

See the KGrid python SDK for an example of how to use KGrid SDK to create a knowledgebase utilizing USPSTF collection knowledge objects directly in the code and how to use the knowledgebase in an application.