How to work with Scoring Groups

Interaction with the List of Scoring Groups

1. There are 4 columns: name, bundles, modified and menus.

• Name - title of the scoring group (short and internal form)
• Bundles - the name of the bundle which the scoring group is based on.
• Modified - creation time or last change.
• Menus - icon with more options.

2. The search for the necessary Scoring Group is carried out using the Scoring group name, which can be entered in the search bar.
3. There is a pagination on the page. Only 25 scoring group’s data are displayed. After scrolling down, other 25 scoring groups appear.
4. Scoring groups are sorted by the modified column in descending order by default.
   The data can be sorted in ascending or descending order by clicking:

• on the name column header - sort scoring groups in Z - A order, by next click- scoring groups in A - Z order
• on the modified column header - sort scoring groups from the earliest to the latest order, by next click - from the latest to the earliest order.

Create New Scoring Group

1. Start with the Scoring Group at the left-hand navigation.
2. Press the blue button + Scoring Group at the top right corner of the screen.
3. Fill the required Names(Internal, Full and Short ) and the Description.
4. Press the Create button

● For Internal Name use full version of Prom and the abbreviation in parentheses or a logical section from a validated source. Internal Name is displayed on:
- [Admin Portal] Scoring Group overview screen (admin’s portal) as lower name in normal font
- [Investigator Portal] Report Builder (Legend Tab).
● Full name is displayed on [Admin Portal] Scoring Group in the Details tab.
● Short Name is displayed on:
- [Admin Portal] Scoring Group overview screen as upper name in bold font;
- [Investigator Portal] Circles Details page;
- [Patient Portal] Scores page.
● Description contains information on the construction of the formula, setting limits and fences, and about bundles. Description is displayed on:
- [Patient Portal] Scores page in Scoring Group Details.

Add Bundle to the Scoring Group

1. Click on the one of the Scoring Group.
2. Fill the required Bundle name on the search bar.
3. Press +Add.

You can use the same Bundle in any Scoring group.

Archive Bundle

Archiving is allowed when NO cases were created. Otherwise, the system will warn you that archiving is not available for the selected bundle.

Important!
Before archiving:
1. Add the right bundle to the scoring group
2. Remove from the formula the question tags of the bundle that you want to archive
3. Archive the irrelevant bundle

To archive the bundle:

1. Go to Scoring Groups and select* the required one from the list

         *Use Search field to find the required SG faster

2. Click three dots next to the required bundle and select Archive

‍

3. Confirm archiving the bundle by pressing YES

If you have problems with archiving the bundle in a new scoring group, check that the field "Formula" is not empty.
To fix the issue, you must:
1. Either add the right bundle to the formula and then archive the wrong bundle OR
2. Add the tag from the wrong bundle to the formula (save the formula) and then archive the bundle. The wrong tags will automatically be removed from the formula

‍

‍

Set Bundle In Use

1. Navigate to Scoring Groups and select the required one from the list

2. Switch on the toggle Show archived  

3. Click three dots next to the required bundle and select Set In Use

          *Archived bundles are marked gray

‍

Edit and Localize Scoring Group Details

1. Click on the one of the Scoring Group.
2. Select the Details at the top left corner of the screen.
3. Select the Language and change the Data.
4. Click SAVE.

Configure Scoring Group

1. Click on the one of the Scoring Group.
2. Press +Add next to the Question.
3. Use Сalculator to figure out the formula.
4. Set Limits and Fences.
5. Press SAVE.

● Formula Builder is a field for creating formulas using the questions from the bundle and keypad.
● On the inCytes™ platform, the administrator has the ability to build formulas with multiplication, division, addition, and subtraction. Formulas using decimal fractional numbers, actions with brackets are supported.
● The calculation of the formula is based on a bundle that is divided into questions with tags. Each question has its own score by which the formula is counted.
● The graph display of the scoring group is limited to billions.
● There is a certain order of actions in expressions without brackets:
     - the actions are performed in order from left to right,
     - multiplication and division are performed first, and then addition and subtraction.
● And actions with brackets:
     - first, the action is performed in brackets, while multiplication and division are also performed in order from left to right, then addition and subtraction.

Applying special functions to scoring groups

There are situations when we may need to calculate the average result in scoring groups.

E.g., the formula for SRS 30, SRS 22 is:  Sum of Responses/ Number of questions answered

In this case, you can apply a special AVERAGE function - divide the total result into the required number of questions.

How to apply AVERAGE function to the formula:

1. Extend the Calculator by switching on the toggle Extended mode at the top right of the Formula Builder field

• Switching on the toggle opens a separate area to work with Average function
• If you open the Extended mode for the first time or the “Average” formula has been removed before, the text format of the formula from the ‘regular’ formula builder is displayed. You can either edit the displayed formula or remove it and build the new one from scratch

Two formulas – from regular and extended mode - exist autonomously and can be absolutely different. The last saved formula is applied to the scoring group. (The scoring group is counted by the last saved formula)

Build the formula according to the following template: avg(n)(tag1, tag2, …, tag{n}), where

• avg(n): n - the number of questions included into the formula
• tag1, tag2, tag{n} - the questions included into the formula

Building the formula from scratch:

1. Click AVG in the field Functions. In the formula Builder, avg2( will appear.

2. Replace “2” with the number of questions which are going to be included in the formula
3. Click ADD+ to add the required question to the formula. Repeat the actions until you add all the required questions

the questions are separated from each other with the help of commas

5. Close the bracket at the end of the formula
6. If the system warns you about Invalid expression, click somewhere in the empty space
7. Click SAVE

Editing the formula:

1. Place the cursor at the very beginning of the formula and click AVG in the field Functions. Proceed with the other formula adjustments

2. Place the cursor into the specific location in the formula and start correcting the formula by typing or deleting the required characters from your keyboard

3. Click SAVE when ready

Deleting the formula with AVERAGE function:

1. Switch on the extended mode in the Formula Builder
2. Delete the formula from the Formula Builder
3. Click somewhere in the empty space and click SAVE‍

Search Question for Formula Builder

1. Click on the one of the Scoring Group.
2. Fill the required Question name or Tag on the search bar.
3. Press +Add.

How to Set Limits and Fences

● Limits - maximum and minimum values on the graph for the Y axis. Limits are set relative to the maximum and minimum values of the formula. Based on them, the boundaries of graphs for a specific formula are constructed.
● Fences - the boundaries beyond which the doctor will receive alerts.

Remove Scoring Group

Display and Localization

1. The patient can see the result of counting the scores as a Total score after creating a case on investigators portal to understand treatment progress. It’s displayed on the graph in the Scores section on the patient portal.

‍

If the Scoring Group Details (Short name and Description) was localized to the preferable patient’s language, e.g. if the translation to that language was inserted when localizing the Scoring Group Details, then the Scoring Group Details are displayed according to the patient portal language settings.

If the Scoring Group Details was not translated to the preferable language, then the patient sees the English version.

2. An investigator is able to see scoring group on:

1) Case Detail page by clicking on View Patient’s Results

2) Exported files from Circle details and Report Builder. The investigators can see the scores and the Total score of the scoring group. Scoring group has its own sequence number and represented as 'SG'+[ScoringGroupId] → Name of Scoring Group

3. An inCytes™ administrator is able to see scoring group on:

• Scoring groups Formula page

How my changes impact the existing cases

1. Adding a new question to Bundle

Adding a new question to Bundle will affect both the existing and future cases. Such question will be automatically added to all instances of bundle (survey view, protocol view, scoring group view).

2. Editing formula

The changes performed to Formula Builder will affect future cases, but scoring group results will not be automatically recalculated. To update the scoring group results for each particular existing case, all completed surveys within the case should be edited and resaved.

• In order to correct an error in the formula (for example, in the middle), the inCytes™ administrator will have to delete all the elements before this error.

3. Removing a question from Bundle

• Removing a question from a Bundle is an undesirable action, because this action may lead to a change in the Total Score in the scoring group for the survey and observational protocol. If such question was used in Formula Builder, it should be manually removed from it. Such action will require scoring group recalculation for existing cases (see point 2 above).

Frequently Asked Questions (F.A.Q)

1. Is it possible not to show some scoring groups for my patients?

Yes, it is. You can turn on the toggle switch “Hide on Patient portal”.

5. What if there are optional questions in the scoring group?

• If the patient answered at least one of the questions used in the Total Score calculation and did not answer any optional question. In this case, the result of this optional question uses a value of 0 when calculating the Total Score.

Pay Attention! In this case, using 0 value can cause an error in the entire formula (e.g. division by 0). Try to avoid such situations!

• If the scoring group consists only of optional questions and the patient has not answered all of them, then the graph will be empty.