Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
outlinetrue
stylenonedecimal

 

How to access the cohort builder:

  • Click on the cohort-builder Cohort Builder button on the homepage of the OpenMRS application after logging in.

    Screen Shot 2017-08-02 at 7.01.25 PM.pngImage Removed        Image Added

About the OpenMRS cohort-builder OWA

The OpenMRS cohort-builder OWA is used to make search queries against a dataset of patients with different query options, the cohort-builder currently has 6 5 active tabs each offering the user with different option and parameters to make search queries, there are currently 6 active tabs namely:.

These are :-

  1. The Concept / Observation tab

  2. The Patient Attribute Attributes tab

  3. The Encounter tab

  4. The Program enrollment tabThe Composition tab

  5. The Saved  tab

                        Image Added

The Concept / Observation tab

This tab gives the user the option to search via concepts or observations existing in the system. Examples of concepts are blood and malaria.

  Screen Shot 2017-08-02 at 7.17.24 PM.pngImage RemovedScreen Shot 2017-08-02 at 7.17.48 PM.pngImage Removed

...

Concepts are the individual data points collected from a population of patients.  They include both questions and answers. An example here would be whole blood sample, with the question; Does the patient value have a whole blood sample?

                                 Image Added


Observations denote anything actively measured or observed during an encounter. For example a patient's weight, age or blood pressure.

                                   Image Added

The Patient Attributes tab

This tab gives the user the option to search via demographics and a person attributes

    1. Search by demographicThis allows you search for patients in a with a descriptive characteristic, in a particular sector of a population. 
      There are 5 search options namely:- 
      1. Gender allows you to select and search  - Search by gender option i. e Male or Female
      2. Age allows you to filter between ages  -  Filter patient search results by age range i.e. 0-14
      3. Birthdate allows you to filter between birth dates
      4. Alive only allows you to search for alive patients
      5. Dead only allows you to search for dead patients
      6. Search is the tab or button for the search
      Search
      1. - Filter patient search results by birthdate range ie  -   
      2. Alive - Search only for patients who are alive.
      3. Dead - Search for deceased patients.

    2. Search by person attribute: This allows you search for patients with a specific attribute. information that further describes them

      There are numerous search options namely:-

      1. Birthplace allows you to to filter by place of birth

      2. Citizenship allows you to to filter by  - Filter patient results by specifying their country of origin

      3. Civil Status

      4. Health Center allows you to to filter by similar health centers

      5. Health District allows Civil Status

      6. Health Center - Filter by details of health center attended by patients

      7. Health District allows you to to filter by similar health districtsMother’s Name allows you to to filter

      8. Mother’s Name - Filter by similar mother’s name

      9. Race allows you to to filter by similar racesTelephone number allows you to to filter  - Filter results by the patients racial background

      10. Telephone number - Filter by similar phone numbers

      11. Unknown patient

      12. Test patient

...

      1. Unknown patient

      2. Test patient

        Image Added

The Encounter tab

An encounter is a single, specific interaction between the patient and a provider.

This tab gives the user the option to search via patients encounter and the location at which they interacted with the service provider.

    1. Search by Encounter:

     This allows you search
    1.  This searches for patients with a specific type of activity or encounter

    , example of encounters are
    1. .  For example, check in, checkout, transfer, admission e.t.c. 

      There are numerous search options namely

    Of Type 
    1. : -

      1. Of Type allows you to to filter by the type of the encounter

    Location 
      1. Location allows you to to filter by the location of the encounter

      2. At

    least this many
      1. least this many allows you to to filter by the minimum encounter count

    Upto this many
      1. Upto this many allows you to to filter by the maximum encounter type

    From
      1. From -

    To
      1. To allows you to to filter by the date range in which the encounter(s) occurred.


    1. Search by Location: This allows you search for patients by the encounter location e.t.c Amani hospital, inpatient ward, isolation ward e.t.c.

    There are numerous search options namely
  • Patient belonging to allows you to to filter by the location the encounter belongs to.

  • According to method allows you to to filter by
    1.  

      Here the filters are applied according to the following:-

      1. Patients belonging to a group of encounters from a specific location.

      2. According to the timeline of the encounter

...

      1. Image Added

The

...

Composition tab

This tab gives the user the option to search via the programmes the patient is enrolled in and the patient's status in the programme.  There are numerous search options namely

    1. Program allows you to to filter by the type of the program.

    2. Workflow allows you to filter by

    3. State allows you to to filter by the location of the program

    4. In the programme allows you to to filter by the timeline the user was in the programme.

    5. Enrolled in the programme allows you to to filter by the timeline in which the user was enrolled into the program.

    6. Completed the programme allows you to to filter by the timeline in which the user completed the program.

  Screen Shot 2017-08-02 at 9.07.50 PM.pngImage Removed

The drug order tab

This tab gives the user the option to group patients according to the drugs they use.

Image Removed

  1. Search by Drug Order: This allows you search for patients in accordance with the drug order they take. There are numerous search options namely

    1. Drug(s) allows you to filter by the type of drug they take

    2. Drug Regimen allows you to filter by the drug regimen they are in. The drug regimen can be current drug regimen or a specific drug regimen.

    3. When allows you to filter by the duration one takes the drug. Eg For the last 5 months and 2 days.

    4. Date range allows you to filter by the specific date.

  2. Patient who stopped or changed a drug: This allows you search for patients who have stopped or changed a drug in accordance with a specific reason and/or generic. There are numerous search options namely

    1. When allows you to filter by the duration one takes the drug. Eg For the last 5 months and 2 days.

    2. Date range allows you to filter by the specific date.

    3. Reason for change allows you to filter by reason they stopped taking

    4. Only this drug allows you to filter by the specific drug they took

    5. Only this generic allows you to filter by generics

The Composition tab

This tab gives the user the option to search for patient via a series of set operations and relations usually between different search histories indexes, example of the operation that can be performed are

    1. And / Union

    2. Or

    3. Not

    4. Intersection

    5. !

    6. +

tab  allows a user to combine multiple cohorts using the logical operators:- 'AND' 'OR', and 'NOT'.

To use this query, you need to have query results from the other queries in your search history. These are the queries which will then be combined to yeild new results.

Example: There is a cohort of patients who weigh less than 100 KG at #1, and a cohort of patients with ages between 23 and 35 years at #2 in the search history.
You can create a query with a composition '1 AND 2' and add a brief meaningful description for the new query. To view a result for the combined queries.

 There are two input boxes on this tab  namely:

  1. Composition: This is where the operations are entered e.g (1 and 2) or not 31 AND 2 from the example above

  2. Description: This is a memorable name or description for the search composition that is being created

...

  1. . Eg. for the above example, we could add a description "Patients weight < 100, age 23 -35". (checkout image below for a visual sample).

            Image Added 

The Saved tab

 This tab gives the user the option to search for a saved cohort or definition, it has two fields namely

    1. Search Saved DefinitionsSearch Saved Definitions allows the user search for a saved definition by it’s nameSearch Saved

    2.  CohortSearch Saved Cohort allows the user search for a saved cohort by it’s name

   Screen Shot 2017-08-02 at 9.41.08 PM.pngImage Removed                            Image Added

  • The Search history: This is where an history of executed searches are saved and displayed to the user, each search can be saved either as a cohort or as a definition. There are numerous fields under this component, namely

    1. Query: This is where the name or description of the query is displayed

    2. Query Definition Options

      1. Save: This saves a definition to the database

      2. Delete: This removes a definition from the search history

    3. Results: This contains a list of all the patients contained in the search result

    4. Query Definition Options

      1. Save: This saves a cohort to the database

      2. Delete: This removes a definition from the search history

    Screen Shot 2017-08-02 at 6.31.56 PM.pngImage Removed                       Image Added

To contribute or setup this open web app please visit this Link.

...

  • Is there a limit to the number of cohorts and definitions that can be saved?

    • No there is no limit to the amount of  cohorts and definitions that can be savesaved.