Nested Knowledge

Bringing Systematic Review to Life

User Tools

Site Tools


wiki:autolit:search:clinicaltrials

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:search:clinicaltrials [2022/07/17 16:35]
kevinkallmes
wiki:autolit:search:clinicaltrials [2024/03/12 15:41] (current)
kevinkallmes [Integration with NK]
Line 3: Line 3:
 This doc describes how to use Boolean search to retrieve records from ClinicalTrials.gov. This doc describes how to use Boolean search to retrieve records from ClinicalTrials.gov.
  
-===== Quick Start =====+{{youtube>ejUoLC-P7eY}} 
 + 
 +<WRAP center round info 60%> To perform a ClinicalTrials.gov search into your nest, you can either 1. Write a query from scratch, or 2. Copy and paste the query from a search in ClinicalTrials.gov. Guidance for both options is given below. </WRAP> 
 + 
 +===== How to write a ClinicalTrials.gov query =====
  
 Use AND/OR/NOT, in combination with keywords to narrow in on trials of interest. [[https://clinicaltrials.gov/ct2/results?cond=&term=dizziness+AND+NOT+exhaustion+AND+stroke&cntry=&state=&city=&dist=|For example]]: Use AND/OR/NOT, in combination with keywords to narrow in on trials of interest. [[https://clinicaltrials.gov/ct2/results?cond=&term=dizziness+AND+NOT+exhaustion+AND+stroke&cntry=&state=&city=&dist=|For example]]:
Line 11: Line 15:
 will retrieve trials with the word "dizziness" and "stroke" contained //somewhere// in the record: the trial title, description, interventions, conditions, or several other fields; trials with "exhaustion" mentioned anywhere will be excluded from results. Use parentheses if the logical operators become numerous and ambiguous, and use quotes if your keywords contain spaces. will retrieve trials with the word "dizziness" and "stroke" contained //somewhere// in the record: the trial title, description, interventions, conditions, or several other fields; trials with "exhaustion" mentioned anywhere will be excluded from results. Use parentheses if the logical operators become numerous and ambiguous, and use quotes if your keywords contain spaces.
  
-To generate a more precise search than the Basic Search outlined above, use AREA to search specific fields. If you wanted to [[https://clinicaltrials.gov/ct2/results?cond=AREA[ConditionSearch]dizziness+AND+NOT+AREA[ConditionSearch]exhaustion+AND+AREA[ConditionSearch]stroke&term=&cntry=&state=&city=&dist=|limit our search]] to only trials with these keywords as Conditions being studied:+To generate a more precise search than the Basic Search outlined above, use AREA to search specific fields. If you wanted to [[https://clinicaltrials.gov/search?term=AREA[ConditionSearch]dizziness AND NOT AREA[ConditionSearch]exhaustion AND AREA[ConditionSearch]stroke|limit your search]] to only trials with these keywords as Conditions being studied:
  
 ''AREA[ConditionSearch]dizziness AND NOT AREA[ConditionSearch]exhaustion AND AREA[ConditionSearch]stroke'' ''AREA[ConditionSearch]dizziness AND NOT AREA[ConditionSearch]exhaustion AND AREA[ConditionSearch]stroke''
Line 17: Line 21:
 The syntax for AREA searches is simply AREA[//area name//]//search//. Common area names include: The syntax for AREA searches is simply AREA[//area name//]//search//. Common area names include:
  
-   * **BasicSearch:** This is the default, when no AREA is specified. It searches all of the common fields within trials +   * **BasicSearch:**  This is the default, when no AREA is specified. It searches all of the common fields within trials 
-  * **ConditionSearch:** Searches indexed conditions, condition MeSH terms, the title, and keywords +  * **ConditionSearch:**  Searches indexed conditions, condition MeSH terms, the title, and keywords 
-  * **InterventionSearch:** Searches indexed interventions, intervention MeSH terms, arm labels, keywords, and more +  * **InterventionSearch:**  Searches indexed interventions, intervention MeSH terms, arm labels, keywords, and more 
-  * **OutcomeSearch:** Searches all outcome fields registered (Primary, Secondary, and Other) +  * **OutcomeSearch:**  Searches all outcome fields registered (Primary, Secondary, and Other) 
-  * **TitleSearch:** Searches the trial name & acronym +  * **TitleSearch:**  Searches the trial name & acronym 
- +In action, [[https://clinicaltrials.gov/ct2/results?cond=AREA[ConditionSearch]stroke+AND+AREA[InterventionSearch]TREVO+AND+AREA[OutcomeSearch]mortality&term=&cntry=&state=&city=&dist=|here's a search]] for trials assessing mortality of stroke patients treated with the Trevo device:
-In action, [[https://clinicaltrials.gov/ct2/results?cond=AREA[ConditionSearch]stroke+AND+AREA[InterventionSearch]TREVO+AND+AREA[OutcomeSearch]mortality&term=&cntry=&state=&city=&dist=|here we search]] for trials assessing mortality of stroke patients treated with the Trevo device:+
  
 ''AREA[ConditionSearch]stroke AND AREA[InterventionSearch]Trevo AND AREA[OutcomeSearch]mortality'' ''AREA[ConditionSearch]stroke AND AREA[InterventionSearch]Trevo AND AREA[OutcomeSearch]mortality''
  
-===== Testing your Search Before Import =====+===== Testing your Search Before Running =====
  
-You may wish to inspect the quality or volume of results retrieved prior to running an [[:wiki:autolit:search:execute|API Import]] on Nested Knowledge. To test your search, copy paste the search string+You may wish to inspect the quality or volume of results retrieved prior to running an [[:wiki:autolit:search:execute|API Import]] on Nested Knowledge. To test your search, copy paste the search string into [[https://www.clinicaltrials.gov|https://www.clinicaltrials.gov]] in the "Other Terms" text input. Note that if you are using [[https://classic.clinicaltrials.gov/|"Classic ClinicalTrials.gov]](will be going offline in 2024), results will be different (+/- 1% in our experience), due to searching differences between the versions. Nested Knowledge API integration uses the newer version.
- +
-  * For [[https://www.clinicaltrials.gov|https://www.clinicaltrials.gov]]: Into the "Other Terms" text input +
-  * For [[https://beta.clinicaltrials.gov/|https://beta.clinicaltrials.gov/]]: Into the "Keywords" text input+
  
 {{:wiki:autolit:search:ctgov_test.png?nolink&  }} {{:wiki:autolit:search:ctgov_test.png?nolink&  }}
Line 38: Line 38:
 ===== AREAs ===== ===== AREAs =====
  
-ClinicalTrials.gov publishes a full list of AREAs that may be searched & which fields are included in that AREA [[https://www.clinicaltrials.gov/api/info/search_areas?fmt=XML|here]]. While BasicSearch, ConditionSearch, InterventionSearch, and OutcomeSearch are most common, field-level AREAs like DesignAllocation and OverallStatus may be useful for certain review types or protocols. [[https://clinicaltrials.gov/ct2/results?cond=&term=AREA[DesignAllocation]Randomized+AND+AREA[OverallStatus]Completed+AND+AREA[InterventionSearch]Trevo&cntry=&state=&city=&dist=|For example]], to retrieve completed randomized trials of the Trevo device:+ClinicalTrials.gov publishes a full list of AREAs that may be searched & which fields are included in that AREA [[https://www.clinicaltrials.gov/data-api/about-api/search-areas|here]]. While BasicSearch, ConditionSearch, InterventionSearch, and OutcomeSearch are most common, field-level AREAs like DesignAllocation and OverallStatus may be useful for certain review types or protocols. [[https://clinicaltrials.gov/ct2/results?cond=&term=AREA[DesignAllocation]Randomized+AND+AREA[OverallStatus]Completed+AND+AREA[InterventionSearch]Trevo&cntry=&state=&city=&dist=|For example]], to retrieve completed randomized trials of the Trevo device:
  
 ''AREA[DesignAllocation]Randomized AND AREA[OverallStatus]Completed AND AREA[InterventionSearch]Trevo'' ''AREA[DesignAllocation]Randomized AND AREA[OverallStatus]Completed AND AREA[InterventionSearch]Trevo''
Line 47: Line 47:
  
 ''AREA[ConditionSearch]COVID-19 and AREA[StartDate]RANGE[01/01/2022, MAX]'' ''AREA[ConditionSearch]COVID-19 and AREA[StartDate]RANGE[01/01/2022, MAX]''
 +
 +===== Alternative Option: Copy Query from ClinicalTrials.gov =====
 +
 +If you have already performed a search in ClinicalTrials.gov, and simply want to copy that query into Literature Search so it continues updating on your schedule, follow these steps:
 +
 +  - Input search terms as normal and click "Search"
 +
 +{{  :undefined:ctgov.png?nolink&  }}
 +
 +  - In the search bars at the top click "Advanced Search"
 +
 +{{  :undefined:advaned.png?nolink&  }}
 +
 +  - Then click "Expert Search" in the top right
 +
 +{{  :undefined:expertsearch.png?nolink&  }}
 +
 +  - Your query will then be displayed in the correct format. Copy and paste this into the automatic search in NK.
 +
 +{{  :undefined:acesearch.png?nolink&  }}
 +
 +===== Integration with NK =====
 +
 +You can conduct searches of clinicaltrials.gov on the [[:wiki:autolit:search:execute|Search]] module of the NK platform. Results from this search will automatically mark papers as [[:wiki:autolit:screening:relatedreports|]].
 +
  
wiki/autolit/search/clinicaltrials.1658075740.txt.gz · Last modified: 2022/07/17 16:35 by kevinkallmes