Nested Knowledge

Bringing Systematic Review to Life

User Tools

Site Tools


Study Inspector

The Study Inspector is a search, filter, and edit page for all studies in your nest. From Study Inspector, you can perform any action (Screen, Tag, Extract, or Critical Appraisal analysis) on individual references, and also edit any study's bibliographic information. You can also use Bulk Actions, download/export content from your nest, and use our Exploration tools on studies in the nest.

Finding and Filtering in Study Inspector:

Inspector filters are a way to sort and search all studies within a nest by a given attribute, action performed or position within the workflow. They can be used in tandem with bulk actions to assign an action to a specific group of studies such as bulk exclusion of studies or reviewing metadata of a certain subset of studies.

From the Nest menu, click on “Study Inspector.”

2. Filter the Study Inspector

Click on “Add Filter” or begin typing what you would like to filter by. You can filter by TIAB (Title and Abstract text), author, date, status (such as Screening Status, which filters to included, excluded, or unscreened), or tag. The “Add Filter” drop-down ( red circle ) enables you to construct your own filter; if you simply start typing in the text box to the right ( red box ), the page will predict the filter you would like to construct, and you can select based on the options presented.

You can use multiple filters, which are layered on top of each other (e.g. filtering to “Screening Status: Included” and “Title/Abstract: Randomized” will filter to all included articles with the word “randomized” in the title or abstract). Filtering the Study Inspector also enables you to use Bulk Actions on the studies to which you have filtered. For a detailed list of the types of filters available, check out the Study Inspector Filters page.

Adjusting the Columns in Inspector

You can select the columns that you want to view in Inspector by clicking on the three dots to the far right of the Inspector header row.

Click on any of the following to add them as columns in Inspector:

  • Title
  • Author
  • Abstract
  • Publication Year
  • Journal
  • Volume
  • Issue
  • Pages
  • Time of Retrieval
  • Final Screening Status
  • If a Dual Mode is turned on, Your Screening Status
  • Tagging - module status
  • Extraction - module status
  • Critical Appraisal - module status
  • Inclusion Probability
  • Tags - list of tags applied
  • DOI
  • PubMed ID
  • Embase ID
  • External ID
  • NCT ID
  • Ref ID
  • Full Text Status
  • Author List
  • Full Citation (JAMA format)
  • Primary Report

Click on any column that has a check mark next to it (indicating it is a current column) to remove it. Make sure to avoid adding too many columns to limit crowding!

Quick Guide: Download and Bulk Actions

Inspector is the location for two very important activities: Downloading/exporting and completing Bulk Actions.

Download from Inspector

Download enables you to download content from your nest–either for all studies, or for a specific set of studies you filter to. For full instructions, see here.

Quick Guide:

  • First, apply all filters to determine which records will be exported.
  • Then, make sure that you have the Columns in Inspector you want exported. The Inspector columns will all be exported into any CSV output!
  • Only once filters and columns are ready, Click Download in the upper right.
  • Select the content that you want exported (e.g. to get metadata, click Studies. to get tags, click Tags).
  • If relevant, provide any other details (e.g. if you want a RIS file for Studies instead of a CSV, or whether you want Tables to export for Tags).
  • Click “Download” within the modal. Your file should appear in your local Downloads!

Bulk Actions

Bulk Actions allow you to complete certain steps (changing screening status, uploading full texts, editing module status, etc.) on studies; for full instructions, see here.

Quick Guide:

  • First, apply all filters that narrow in on the studies you want to complete an action on! If you 'bulk act' before filtering, you will execute the action on a wider range of studies than intended.
  • Then, click Bulk Actions in the upper right.
  • Select your Bulk Action of interest – e.g., if you want to bulk-alter Screening Decisions, select “Update Screening”.
  • If Updating Screening, Tags, Module Status, or importing Full Texts, follow the instructions in the modal. For example, if altering a Screening Decision, you may need to select “Full Text Screening” and “Final Decisions” if you are in Dual, Two-pass mode.
  • Complete the bulk action and wait for the job to complete. Optionally, you can click out of the progress modal; the job will continue in the background.

Completing Actions on Individual Studies in Inspector

1. Opening the Study Modal

Once you have filtered to the list of studies of interest, you can screen, tag, or extract by clicking on the study in question; this opens the Study Modal. The modal opens to the module that was selected as the preset; so, if you opened the Screening Study Inspector, for instance, you will be able to screen the study in question.

2. Completing Actions

The modal enables you to Screen, Tag, and MA Extract the study that you have opened. In the modal, the actions are completed in the same way they are completed in the sequential screen/tag/extract modes. Here, you can see a study that is opened to the Screening module; the screening actions ( red square ) indicates that this study has been included. Once you complete an action, you can click the arrow keys to the left and right of the modal ( red circles ) to move up and down the list of studies available in Study Inspector.

You can unscreen a single study by going to Study Inspector and then opening the screening tab in the Study Modal. If you click on the “i” icon next to the screening decision, you can “unscreen” that study to put it back in the screening queue to review later.

3. Toggling Modules

To switch between modules, toggle the buttons in the upper right of the modal ( red outline ). Regardless of how you opened Study Inspector, you can Screen, Tag, and/or Extract within the modal. Note: If the Nest is in Dual Screening mode, you will have a fourth option of Adjudication shown as a toggling option (black outline) if you have Admin privileges; this page is not available to users.

Warning: If the Nest is in Dual Screening mode, changes made in the Screening module will not alter the final/adjudicated Screening Status of the study. Instead, the change will queue another user screening decision to be adjudicated. To alter final/adjudicated Screening Status from the Study Modal, an Admin must use the Adjudication module to select a finalized option.

5. Marking Modules Complete/Incomplete for Individual Records

Marking a module “Complete” removes it from the queue in the corresponding module and marking a module “Incomplete” puts the record back into the queue in the corresponding module. Regardless of module status, records are always editable in Study Inspector. This is specific to the Tagging, Extraction and Critical Appraisal modules.

To do this, you can filter to a group of studies and use Bulk Actions (above) and you can also do this within individual studies. Under each menu, open the “History” tab, select Module Status Dropdown and select Complete or Incomplete.

6. Edit Bibliographic Information

To edit the bibliographic information associated with a study, find it in Inspector. In the Abstract view, select the “Edit” button next to the Bibliographic Fields. In the modal that pops up, edit any of the Bibliographic Fields.

7. Using Nested Knowledge's Reference ID (Ref ID)

Nested Knowledge automatically generates a Ref ID for every record that can be used for filtering, bulk actions, and allocation. See details here.

Explore from Inspector

If you have questions about the contents across your included records, you can use Explore from Inspector, where the RoboPICO, Topic Modeling, and Keyword frequency can be applied to any subset of studies from your nest.

Note: Anytime there is a module box with the adjustable icon, you can drag to adjust the width of the box depending on your preference.

wiki/autolit/utilities/inspector.txt · Last modified: 2023/10/16 13:35 by jthurnham