The Subjects page of the PHC allows you to search for any subjects within your project by using a filtering system.
Filtering options are available on the left side of the Subjects screen (Standard, Advanced, and Cohorts), and the results of your filtering are presented in a Subjects table on the right half of the screen.
The colored oval above the Subjects table tells how many subjects match your chosen filter(s). If no filters are chosen, the table will show all subjects in your project.
Filters help you sift through all subjects in your project to find only the subjects you want displayed. Filter categories can be expanded (clicking the "+" sign) to see more filtering options, or collapsed (clicking the "x").
When you select a filter (checkbox), the Subjects table will automatically update to show all subjects that match the filters selected and the number in the colored oval above the table will update to reflect the new filter. The number beside the filter category selected represents the number of subjects matching that filters.
You can set an unlimited amount of filters in Subjects.
Filters remain intact within the same browser, across different login sessions or even if you click away from that page.
Filter Tree - The Filter Tree is a layout of your selected filters and their Logical Operators. Filter Trees are found on the Advanced tab of the Subjects page.
Logical Operator - A Logical Operator is the root of the filter tree. Each Logical Operator represents a grouping of filters (one or more filters) you've selected. Logical Operator conditions can be set to:
- "Subjects in EVERY sub-filter" (show me anyone who meets this filter AND this other filter)
"Subjects in ANY sub-filter" (show me any anyone who meets this filter OR this other filter)
"Subjects in NOT IN ANY sub-filter" (show me anyone who does NOT meet this filter)
And - In regards to filters, the word And refers to the subject(s) who match both the criteria of one group/filter and another group/filter. To set the And command for the filters in your filter tree, go to the Logical Operator Settings (in the Advanced filter tab) and select “Subjects in EVERY sub-filter”. E.g., If you select filters for male subjects, subjects who smoke, and subjects who do not smoke your table will show no subjects because a subject cannot be both a smoker AND a non-smoker at the same time.
Or - In regards to filters, the word Or refers to the subject(s) who match either the criteria of one group/filter or another group/filter. To set an Or command for the filters in your filter tree, go to the Logical Operator Settings (found in the Advanced tab) and select “Subjects in ANY sub-filter”. E.g., If you select filters for male subjects, subjects who smoke, and subjects who do not smoke, your table will display all males that answered yes to either of those questions.)
Not - In regards to filters, the word Not refers to any subjects that do not meet the selected filter. To set the Not command for the filters in your filter tree, go to the Logical Operator Settings (found in the Advanced tab) and select “Subjects in NOT IN ANY sub-filter”.
There are three filtering option tabs on the left side of the Subjects Explorer screen:
- Standard - The filter options in this tab are simple with only one Logical Operator. You can click checkboxes, select from dropdown menus, and input values to define these basic filters.
- Advanced - The filter options in this tab allows you to make more complex filters with multiple Logical Operators. You can also see the filter tree and adjust whether you want to your filters to be "Anded" (meeting one filter and another), "Ored" (meeting either one filter or another), or "Not" (not meeting the filter criteria).
- Cohorts - The options in this tab allow you to filter using existing cohorts, as well as update, create, or remove a cohort.
Action Buttons are clickable buttons that perform an action on the selected subjects in your project. Action Buttons are located above the Subjects table.
To use an Action Button:
- In the Subjects table, select the subjects you want to perform the the action on by clicking the checkbox beside their name. You can also select all subjects in the table by clicking the checkbox in the header of the table.
- Click the Action Button that corresponds with the action you wish to perform.
- Invite - Invites users to share their data
- Invite via LIFE Extend (Android/iOS)
- Invite via PHC (Web)
- Assign Survey
- Assign Consent
- Create Cohort
- Add to Cohort
- Remove from Cohort
- Delete Subject - Only users with
Delete DataABAC privileges can do this – this cannot be undone) Clicking this will delete the subject for the project. You will be asked a challenge question to ensure you don't accidentally delete a subject as this cannot be undone.
- Invite - Invites users to share their data
Configuring the Subjects Table¶
Users with the
Administer Layouts ABAC privilege can configure the settings for the Subjects Table. Editing is done by clicking on the settings gear icon in the top right corner of the Subjects page. The Subject Table Configuration page will open. This page has options to configure the Table Columns and select which Row Actions you wish to display.
Here you can determine what users will see in the Subject viewer. Clicking the plus sign "+" lets you add a column beneath the column. Clicking the ellipses "..." lets you edit a column name, move a column up, move a column down, or delete a column.
To add a Table Column:
- Determine where you want the new column to be located in the table list and click the plus sign "+" next to the column above where you want the new column to be located.
From the list that opens, select your new column. Options include:
- Subject ID
- First Name
- Last Name
This will now appear below the column in which you had clicked the plus sign.
Click the "X" in the top right of the Subjects Table Configuration to close it. The Subjects table will now include your new column and any data affiliated with it.
To edit, move up, move down, or remove a column:
- Click on the ellipses "..." beside the table column name you wish to edit, move, or delete.
From the list that opens, select from:
- edit column – lets you edit the name of the column header
- move column up – the column will change places with the column above it
- move column down – the column will change places with the column below it
- delete column – removes the column from the Subjects Viewer
Users with the
Administer Layouts ABAC privilege can also select what Row Actions or viewing options are available for each subject (these are the icons to the right of each subject in the Subjects table). Options include:
- View in Subject Viewer
- View in Subject Viewer in a new tab
- View in Omics Explorer
- View qualifying advanced filters for subject – if you’ve used advanced filters and click this icon, you can enter the Advanced tab of Subjects and view the filter tree. The qualifying filters have a colored frame around them (see .gif below).