Nested Knowledge

Bringing Systematic Review to Life

User Tools

Site Tools


wiki:autolit:screening:inclusionpredictionmodel

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
wiki:autolit:screening:inclusionpredictionmodel [2024/07/24 16:51]
jthurnham [Robot Screener]
wiki:autolit:screening:inclusionpredictionmodel [2024/09/23 11:59] (current)
jthurnham [Interpreting Robot Screener]
Line 10: Line 10:
  
 The below guidance is specifically for using Robot Screener, for information on training the model for probability generation only and general information on how the model works see [[wiki:autolit:screening:model|Using and Interpreting the Screening Model.]] The below guidance is specifically for using Robot Screener, for information on training the model for probability generation only and general information on how the model works see [[wiki:autolit:screening:model|Using and Interpreting the Screening Model.]]
 +
 +
 +----
  
 ===== Robot Screener ===== ===== Robot Screener =====
Line 31: Line 34:
 ===== User Guide ===== ===== User Guide =====
  
-==== Running the Screening Model ====+==== Settings ====
  
-To learn about configuration settingswhich enable you to toggle Manual updating vs. Automatic and Displayed vs. Hidden, see the [[:wiki:autolit:admin:configure#inclusion_prediction_model|Settings page]].+To turn on Robot Screenerhead to Nest Settings --> Screening Model, toggle on Robot Screener
  
-In its default setting, the Screening Model must be run manually. To do so, click "Train Screening Model" on the Screening panel:+{{ :undefined:screenshot_2024-07-24_at_17.53.25.png?nolink |}}
  
-{{  :undefined:4screen.png?nolink&  }}+Not displayedYou must be in a Dual Screening mode to use Robot Screener.
  
-Once the modal opensclick "Train New Model.+Want to use Automatic Training for use in manual screening instead? [[wiki:autolit:screening:model|Learn more here.]] 
 + 
 +---- 
 + 
 +==== Meeting the Threshold ==== 
 + 
 +When toggling Robot Screener, you'll be presented with an instructional modal
 + 
 +{{ :undefined:screenshot_2024-07-24_at_17.57.44.png?nolink |}} 
 + 
 +Highlighted in red are the requirements for training the screening modeland the actual numbers based on the progress made in your nest. You will not be able to turn on Robot Screener until these minimum requirements are met.
  
 <WRAP center round important 60%> <WRAP center round important 60%>
-To provide the model with sufficient information to begin understanding your reviewwe require **50 total adjudicated screening decisions with 10 advancements or inclusions**  before the model can be trainedIf there is insufficient evidence to train the model, complete more adjudicated screening (2 reviewers and 1 adjudicator) until the "Train New Model" button becomes available.+Before Robot Screener can be turned on, 50 adjudicated screening decisions with 10 advancements/inclusions must be madeAfter this is met and the Robot is turned on, it will continue to train on further adjudicated screening decisions made.
 </WRAP> </WRAP>
  
-It may take a minute to trainafter which it will populate histogram on the left. From then oneach record will show a probability of inclusion or advancement:+Once trained and turned on, the Robot is assigning both inclusion probabilities and actual screening decisions to the remainder of records in the queue. CurrentlyRobot Screener does not assign exclusion reasons, so decisions are displayed as "Advance"/"Include" or "Robot Excluded". The records that Robot Screener makes decision on will still need an additional human to screen these records as a second reviewer, and a human adjudicator to make the final decision on these records. This means that each record will always have two pairs of eyes to review.
  
-{{  :undefined:2screen.png?nolink&  }}+----
  
 +
 +==== Interpreting Robot Screener ====
 +
 +At any time, you may wish to view how the screening model is performing. To view the model performance, navigate to Nested Settings --> Screening model --> View Screening model. 
 +
 +{{ :undefined:screenshot_2024-07-24_at_18.13.41.png?nolink |}}
 +
 +This will display a histogram under the "Predictions" tab, a table of various Cross Validation statistics displaying history of previous trainings of the model, and an explanation as to how to interpret these values. Note: the history of trained models is displayed for informational purposes only, and not versions that can be reverted back to. Retraining the model does not guarantee improved statistics and performance.
 +
 +You can also view the Robot Screener recommendations in the Screening model modal. Select "Advance"/"Include" to view studies the Robot has advanced/included, or "Exclude" for excluded studies-- these are both shortcuts that take you to Study Inspector to show you the corresponding subsets of studies. Otherwise, the filter can be manually added from Study Inspector. From this modal, you can also delete the model if you wish to start again from scratch.
 +
 +With Predictions toggled:
 +
 +{{ :undefined:screenshot_2024-09-23_at_12.56.51.png?nolink |}}
 +
 +With Cross Validation toggled:
 +
 +{{ :undefined:screenshot_2024-09-23_at_12.57.00.png?nolink |}}
 +
 +[[wiki:autolit:screening:model#interpreting_the_model|Learn more about interpreting the model, its performance and how it works here.]]
  
 ---- ----
  
 +
 +==== Improving Robot Screener ====
 +
 +The best way to improve Robot Screener, is to adjudicate records, since these are the decisions it trains on. We recommend, if you can, have your adjudicator make their final decisions on the Adjudicate Screening page after every 50 studies are screened for best model performance. For reference, the following is what adjudicators will see for records that have one human and one Robot Screener decision applied:
 +
 +{{ :undefined:screenshot_2024-07-24_at_18.18.39.png?nolink |}}
 +
 +----
 ===== Robot Screener Validation Studies ===== ===== Robot Screener Validation Studies =====
  
wiki/autolit/screening/inclusionpredictionmodel.1721839865.txt.gz · Last modified: 2024/07/24 16:51 by jthurnham