RM 5 Tutorial
RM 5 Tutorial
1 Tutorial
updated February 2011
Welcome to the RevMan Tutorial. This tutorial is designed to give Cochrane review
authors an introduction to the process of writing a Cochrane systematic review of a
healthcare intervention using RevMan.
The tutorial does not provide all the information necessary to write a Cochrane
review, and does not address other types of Cochrane systematic reviews, such as
reviews of diagnostic test accuracy studies or overviews of reviews. For detailed
guidance on how to conduct a Cochrane systematic review of an intervention, please
refer to the Cochrane Handbook for Systematic Reviews of Interventions, available
from the RevMan Help menu.
Later parts of this tutorial rely on activities completed in the earlier sections, so we
recommend you start from the beginning. If you wish to skip ahead, click on the
relevant section in the Contents list. Completing the entire tutorial takes about 3 to 4
hours.
If you have technical questions regarding RevMan software, please contact the
Cochrane Information Management System team at http://ims.cochrane.org/revman.
Other questions related to preparing protocols or reviews in RevMan should be
directed to the relevant Cochrane Review Group.
1
PART 1 – Getting started......................................................................................... 4
Opening your review................................................................................................... 4
Setting up user details ................................................................................................ 5
The RevMan 5.1 interface........................................................................................... 5
Saving a review ........................................................................................................... 7
Adding authors to a review......................................................................................... 7
Accessing the Cochrane Handbook of Systematic Reviews of Interventions.............. 8
PART 2 – Working with text ...................................................................................... 9
Adding text to a review............................................................................................... 9
Formatting text ......................................................................................................... 10
Making changes to headings..................................................................................... 10
Adding notes ............................................................................................................. 11
Tracking changes in the text ..................................................................................... 12
Checking your spelling .............................................................................................. 13
PART 3 – Adding studies and references ................................................................. 14
Adding studies to a review........................................................................................ 14
Adding references to a study.................................................................................... 15
Editing an existing reference .................................................................................... 16
Importing references from a text file ....................................................................... 17
Moving references .................................................................................................... 18
Adding links to references in the text....................................................................... 20
Removing a link......................................................................................................... 20
Adding multiple links automatically.......................................................................... 21
PART 4 ‐ Tables ....................................................................................................... 21
Characteristics of included studies table .................................................................. 21
Risk of bias table ....................................................................................................... 22
Characteristics of excluded studies .......................................................................... 24
Additional tables ....................................................................................................... 24
PART 5 ‐ Data and analyses ..................................................................................... 25
Adding comparisons and outcomes.......................................................................... 25
Entering dichotomous data ...................................................................................... 27
Changing outcome properties .................................................................................. 29
Adding subgroups ..................................................................................................... 31
Copying an outcome or comparison......................................................................... 32
Adding a continuous outcome.................................................................................. 33
Using the Calculator for intervention reviews.......................................................... 34
Entering data from different scales measuring the same outcome......................... 35
Using generic inverse variance ................................................................................. 36
Identifying the outcomes for which a study had provided data .............................. 38
Adding a figure to your review ................................................................................. 38
Publication bias and funnel plots.............................................................................. 39
Risk of bias graphs and summaries........................................................................... 40
PRISMA flowchart ..................................................................................................... 40
PART 6 – Finishing the review ................................................................................. 41
Summary of findings tables ...................................................................................... 41
2
Adding an appendix .................................................................................................. 42
Validating a review.................................................................................................... 42
Submitting a review for editorial approval............................................................... 43
3
PART 1 – Getting started
Opening your review
All Cochrane reviews are stored in Archie, The Cochrane Collaboration’s central server
for managing documents and contacts details. When you have registered a review
with a Cochrane Review Group, they will set up a user account for you in Archie. To
work on your review, you will need to find your review online in Archie and check it
out into RevMan using the My Reviews button on the toolbar. Doing this opens a
new window which provides information on the location of your reviews and what
the next task for your review is. In this window you can check a review out by
selecting the title and clicking the Check Out button.
Before going ahead it is important to make sure that RevMan is currently in ‘Standard’
mode rather than ‘Non‐Cochrane’ mode. ‘Non‐Cochrane’ mode is a preference that
allows users to specify that they are using RevMan to author reviews that will not be
published in The Cochrane Library. In ‘Non‐Cochrane’ mode, all Cochrane‐specific
functions like check in/out and connection settings to Archie are absent from the
interface. To complete this tutorial you need to be in ‘Standard’ RevMan mode.
1. From Tools menu on the toolbar, select Preferences which will open the
Preferences window.
2. Under User mode on the General tab, confirm that the Non‐Cochrane mode
option is NOT checked.
3. If the Non‐Cochrane mode option is checked, uncheck it and click OK. A
warning will appear indicating that “Not all changes may take effect until you
restart the program”. Click OK, and Exit out of RevMan and restart it.
4. If the Non‐Cochrane mode option is NOT checked, simply click OK.
For this tutorial we will use a sample review called ‘Caffeine for daytime drowsiness’.
Instead of checking the review out of Archie, it has been provided as an additional file
with RevMan 5.1.
1. From the File menu, select Open, or click the Open button on the toolbar.
2. Find the folder where RevMan was installed on your computer. If you are
using Windows and accepted the default installation location, this will be
C:\\Program Files\Review Manager 5.1. If you are using Mac OS or Linux, the
tutorial files are copied to a subfolder of your home directory named ‘RevMan
tutorial’.
3. Open the doc folder, and then the tutorial folder.
4. Select the file ‘Caffeine for daytime drowsiness.rm5’.
5. Click Open.
Note: It is possible to create a new review in RevMan by selecting New from the File menu, or
clicking the New button on the toolbar. Be aware that if you create a review yourself, you
cannot check it into Archie or use it for publication in The Cochrane Library.
4
Setting up user details
If you will be using RevMan regularly on the same computer, you may wish to enter
your user details (such as your name). RevMan will attach these user details to any
editing done using track changes so that co‐authors and editors can easily identify
who has made the changes. Open your user details by selecting Preferences from the
Tools menu. Enter your name directly or click Choose to find your details in Archie.
Note: You will need to set up RevMan access to Archie via the internet. In the Preferences window,
open the Connection tab. Click the Wizard button to set up your connection, or enter your
Archie user name and password directly and click the Next button to test the connection. You
may need to enter proxy server details. Consult the RevMan 5.1 Help or your local IT support
for more information.
5
In the outline pane, you can use the key icon next to each heading to expand and
collapse subheadings. In the content pane, use the symbol.
By default, your new review is at the protocol stage, indicating that you are planning
the methods for a review. Sections of a review that are not required at the protocol
stage (but will be needed later for your completed review) appear as inactive (light
grey) in both the outline pane and the content pane.
Note: You can tell the stage of a review by looking for the protocol or review icon at the top
left of the outline pane.
When you undertake a Cochrane review, the protocol must be completed and
submitted for publication before moving on to the review stage. For this tutorial, to
convert the file from the protocol stage to review stage, use the following directions:
6
6. Click OK. Note that all of the section headings of the review are now activated
(there are no light grey section headings).
Saving a review
When you have finished working on a review from Archie, we recommend that you
always save the review by checking it back into Archie using the Check In button
on the toolbar. This ensures the most recent version of your review is safely stored
and can always be accessed from Archie by your co‐authors and editors.
We recommend that you do not keep saved reviews on your computer, to avoid
confusion with different versions. Be careful not to use a version of your review from
your computer if a more recent version is available in Archie. If for some reason you
do need to save a review to your computer, such as this tutorial review which is not
from Archie, go to the File menu and select Save As, or click the Save button on
the toolbar. You can open a saved review by going to the File menu and selecting
Open, or clicking the Open button on the toolbar.
RevMan also creates automatic backups of your review. See the Help menu for
information on retrieving a backup file.
1. If not already visible, in the content pane, click the icon next to the Review
information heading to show further subheadings.
2. Click the icon to open the Authors section. Note that three authors have
already been added to this review.
3. In the outline pane, click the key icon next to Review information.
4. Select the Authors heading.
5. Click the Add Author button on the outline pane toolbar to open the New
Author Wizard.
6. Select Add a local record (name only) that can be linked to Archie later. Click
Next.
7. Enter your name in the First Name and Family Name fields.
8. Click Finish. You will now see your name listed next to the other authors of the
review. Note that no affiliation is available for your name. Affiliations can only
be added from records in Archie.
7
Note: Many of the functions in RevMan which involve selecting a button on the outline pane toolbar
can also be achieved by right‐clicking the sub‐headings in the outline pane and selecting the
function from the drop‐down list. For example, rather than clicking the Add Author
button on the outline pane toolbar to open the New Author Wizard, you can also right‐click
the Author sub‐heading and select Add Author from the drop‐down list.
Under the author details in both the outline and content panes you will note that a
Contact person can be specified for the review. By default, this is the first author, but
another person (who may or may not be an author of the review) can be nominated
by selecting the Contact person heading in the outline pane and clicking the Edit
Contact Person button on the outline pane toolbar. The contact person must be
listed in Archie.
Note: To add new people to Archie or to make changes to contact details, please contact your
Managing Editor.
8
1. In the outline pane, if it is not already expanded, click the key icon next to
the Main text heading.
2. Click on the word Abstract.
3. In the content pane, click the Handbook button (or right click and select
Handbook). Note that the Cochrane Handbook of Systematic Reviews of
Interventions window has opened at the section with guidance on what to
write in the abstract of the review.
4. Close the Cochrane Handbook of Systematic Reviews of Interventions
window.
9
Formatting text
RevMan text formatting options are available from the toolbar, including bold ,
italics , underline , superscript , subscript , and highlighting text similar
to most other word processing software. You cannot change the font or type size, as
these are standard for all Cochrane reviews.
The Insert Symbol button allows you to insert symbols into the text of the review,
including in tables and author names. You can also insert a non‐breaking space.
RevMan also allows bulleted and numbered lists , including multi‐level lists.
1. In the outline pane, click the key icon next to Main text to reveal the
subheadings.
2. Click the key icon next to Background.
3. Any heading with the icon is optional and can be deactivated. Right‐click the
How the intervention might work heading and select Deactivate Heading
(alternatively, select the heading How the intervention might work then click
the button on the outline pane toolbar and select Deactivate Heading from
the drop down menu).
4. Note that the heading appears deactivated (light grey) in the outline pane and
the text of the heading has been removed from the content pane.
5. In the content pane, click to place the cursor at the end of the text in the
Description of the condition section and press Enter to create a new line.
10
6. On the toolbar, you will see a drop‐down box showing the text style currently
in use. By default, text is in the Normal style. Click the drop‐down arrow and
select Heading 3.
7. Type the text ‘International context’. Note that formatting of Heading 3 is bold
and italics.
8. Press Enter again. Note that the new blank line is in the Normal style again.
Adding notes
You can add notes to assist in drafting the review. These notes will not appear in the
published version of the review.
1. In the content pane, make sure the cursor is still in the Background section.
2. Click the Notes button on the outline pane toolbar (NOT the Notes button
in the content pane). This will open the Notes window.
3. Enter a note, ‘This text needs revision.’ You will see the user details you
entered in the Preferences window at the beginning of the tutorial appears at
the bottom of the Notes window.
4. Click the Close button to save the note and close the window.
5. A yellow Note icon appears next to the relevant heading in both the
content pane and outline pane.
6. To see all the notes for a review while you are working, go to the View menu
and select Notes. A separate window pane will appear below the content pane
showing the notes for each section.
7. In the content pane, click to place the cursor back in the Background section.
The notes area will automatically display the note you have entered in that
section.
8. Click the down arrow icon at the top left of the notes area to minimise it, or
go to the View menu and select Notes to close the notes pane.
9. In the content pane, click the Note icon to open the Notes window again.
10. Click Delete to delete the note.
11
Tracking changes in the text
RevMan has a Track Changes system to help you manage editing in the text.
1. From the Tools menu, select Track Changes, or click the Track Changes
button on the toolbar. Note that the Track Changes button is now activated.
2. In the content pane, go to the Background section and replace the word
‘problem’ with the word ‘condition’. The old text will appear in red with a line
through it, and the new text will appear in green.
3. In the same section of the review, change the word ‘productivity’ to ‘function’.
Leave the cursor in the text after your changes.
4. From the Tools menu, select Accept or Reject Changes. This will open the
Accept or Reject Changes window.
5. In the window you just opened, click the Find button with the arrow pointing
left to search backwards toward the beginning of your document.
12
6. The first change found will be the word ‘function’. The word will be
highlighted in the content pane. You may need to move the Accept or Reject
Changes window out of the way to see the highlighted section of text. Click
Accept to accept the change.
7. RevMan will automatically find the next change and highlight the relevant
text. Click Accept again to accept the deletion of the word ‘productivity’.
8. Reject the rest of the changes you made by clicking the Reject All button.
9. Click OK.
10. In the content pane, change the word ‘problem’ to ‘condition’ again.
11. Hover the mouse pointer over the change. A popup message will appear
showing the user details and when the change was made.
12. Left‐click and drag the cursor over both the added word and deleted word,
then right click on the text you have selected and select Accept Changes.
13. Turn off the Track Changes feature by clicking the Track Changes button on
the toolbar.
13
6. Open the Tools menu and select the Check Spelling option. This will open the
Check Spelling window.
7. Depending where your cursor was placed, RevMan may ask whether you wish
to continue checking from the beginning of the document. Click Yes.
8. RevMan will highlight the spelling mistake and suggest ‘common’ as the
correct spelling. Click Change.
Note: The Check Spelling tool cannot correct spelling errors in some sections of the review text,
such as author’s names and contact details or the Data and Analyses section.
9. A notice will appear to say that the spell check is complete. Click OK.
10. Click OK again to close the Check Spelling window.
11. To check spelling continuously while you type, go to the Tools menu and
select Check Spelling as You Type, or click the Check Spelling as You Type
button on the toolbar.
12. Delete the ‘m’ from ‘common’ again, and click to place the cursor elsewhere in
the text. The spelling mistake will be underlined in red.
13. To correct the word, right‐click it and select the correct spelling from the
options available.
In the outline pane, click the key icon next to Studies and references.
1. Click the key icon next to the Reference to studies section.
2. Select Included studies and click the Add Study button on the outline pane
toolbar. This will open the New Study Wizard.
3. Enter the Study ID ‘Morrocona 1998’ and click Next.
4. From the Data source drop‐down list, choose Published and unpublished
data. Click Next.
5. The year the study was conducted will appear by default as ‘1998’. Click Next.
14
6. If your study has an ID number, such as a trial registration number or
document ID, you can enter it here by clicking the Add Identifier button,
selecting an ID type from the drop‐down list, and entering the ID.
7. Click Next.
8. Select Add another study in the same section and click Continue.
9. Repeat steps 3‐8 and add the following studies to the tutorial review:
Norscafe 1998
Oohlahlazza 1998
Kahve‐Paradiso 2002
10. When you have added the details for the last study, select Nothing and click
Finish.
11. In the outline pane, click the key symbol next to Included Studies to see the
new studies listed.
15
Note: You can right‐click in the Journal/book/source field and select Choose from list… to select
your journal from a list of titles. If your journal does not appear on this list and a number of
references in your review were published in this journal, you can right‐click in the
Journal/book/source field and select Edit custom journals list… which will open a text file
where you can create a custom list of journal titles. This text file will need to be saved each
time a new journal title is added to your custom list, and you can use this file to copy and
paste the relevant journal title into the Journal/book/source field for each reference.
5. Click Next. As for a study, you will have the option to add an ID number for the
reference, such as a MEDLINE reference number.
6. Click Finish. The reference will now appear in the content pane. In the outline
pane, click the key symbol next to Morrocona 1998 to see the new
reference listed.
Note: To add an Other reference to your review, select Additional references in the outline pane
and follow steps 2 to 6 above. You will need to give your reference a Reference ID, which
should have the same format as a Study ID (first author and year of publication).
1. In the outline pane, double‐click the reference listed under the Morrocona
1998 study (or right‐click and select Edit Reference). This will open a new tab
in the content pane showing all the details you entered.
2. Open the Reference Type drop‐down box and change the type from ‘Journal
article’ to ‘Book’. Note that the fields have changed and some rows are now
shaded. Shaded rows will not appear in your published review.
3. Change the reference information to the following (you may need to scroll
down to see some of these fields):
16
Authors: Morrocona MM, Smith A, Jones FH
Journal/book/source: The effects of caffeine on alertness
Date of publication: 1998
Publisher Name: Grinder Press
City of publication: London
4. At the bottom of the reference tab, note that the reference is displayed as it
will appear in the published review. Note that this display changes as you
make the changes to the reference. Check that the reference appears
correctly.
5. Go to the tab header and click the button next to the first author’s name to
close the reference tab (do not click the button at the top right corner as
this will close the review).
Note: For further details on how to enter different reference types, see the RevMan Help or the
Cochrane Style Guide, available from the Help menu.
Note: For details on how to generate a text file, see the help files in your reference management
software. RevMan can read text files created from most major reference management
software using the RIS format. You may need to check that you are using a RevMan filter
when exporting your references to a text file.
1. Go to the File menu and select Import, then References. This will open the
Import References Wizard.
17
2. Click Next.
3. RevMan should automatically open the same folder we used to open the
sample review: c:\\program files\review manager 5\doc\tutorial. Select the
file ‘Study References.txt’ and click Open.
4. You will see a preview of the text file. Click Next.
5. By default, RevMan Format is selected as the format of the text file (other
options include RIS, PubMed MEDLINE or Vancouver formats). Click Next.
6. By default, RevMan will save references to the Classification pending
references section, under Other References in the outline pane. References in
this section will not appear in the published review (for this reason they are
shown in grey). Click Next.
7. If you wish, you can assign different locations for each individual reference, or
exclude specific references from the text file while importing the rest. For this
tutorial, leave the settings as they are and click Finish.
8. RevMan will report that 6 references have been imported. Click OK.
9. In the outline pane, use the key icons to open the Other references section
and then the Classification pending references section. You will see the
references you imported.
Moving references
There are several ways to move references to the appropriate study.
1. In the outline pane, in the Classification pending references section, select the
reference Norscafe 1998.
2. From the Edit menu, select Cut or click the Cut button on the toolbar.
3. Use the key icons to open the Included studies section, and open the
Norscafe 1998 study. An [Empty] reference has been added here. To add a
reference manually, you can edit the empty reference using the instructions in
the previous section.
4. Select the Norscafe 1998 study.
18
5. From the Edit menu, select Paste, or click the Paste button on the toolbar.
6. The reference will be deleted from the Classification pending references
section and added to the Norscafe 1998 study. Note that the [Empty]
reference has gone.
7. Go to Classification pending references and right‐click Deliciozza 2004.
8. Select Move to, then Included studies. As there was no study with a name
matching the reference, RevMan will automatically create a new study in the
Included studies section with the ID Deliciozza 2004.
9. Go to the Classification pending references section and select Kahve‐Paradiso
2002.
10. Click and drag the reference to the Kahve‐Paradiso 2002 study.
11. Repeat step 10 to move the remaining references to the corresponding
studies. Note that both the imported Morrocona 1998 and Morrocona 2007
references can be moved to the Morrocona 1998 study.
12. In the outline pane, click the key icons to open the Included studies section,
and then open the Morrocona 1998 study.
13. Select the first reference and double‐click to open the reference tab.
14. In the content pane, check the This is the primary reference for the study box.
15. In the outline pane, note that the book icon beside the primary reference
appears in black , and the icons beside the other references are grey .
16. In the content pane, note that clicking the green arrows enables you to
switch between the edit screens for each reference for a particular study.
19
Adding links to references in the text
Rather than typing citations in the text or including footnotes, RevMan allows you to
include active hyperlinks to references in the text of your review.
1. In the content pane, scroll up to find the Description of the condition section.
2. Click to place the cursor after the word ‘life’.
3. From the Format menu, select Insert Link, or click the Insert Link button on
the toolbar. This will open the Insert Link window.
4. Note that by default the studies are listed in alphabetical order, but can be
listed chronologically (i.e. by year of publication) by selecting Sort
chronologically.
5. From the list, select the study Morrocona 1998. Note that you can use this
same method to link to included and excluded studies, figures, tables, sections
of the review text and external web links.
6. Click OK. You will see a blue hyperlink to the reference appear in the text. This
link will be active after the review is published in The Cochrane Library.
7. Add a space before the link and parentheses ( ) before and after the link, so
that it appears as “…quality of life (Morrocona 1998).”
Note: You can insert more than one link in the text at a time. To do this, follow steps 1‐6 above, but
at step 5, hold the ‘Shift’ key down on your keyboard before selecting the study links you
want to insert in the text.
Removing a link
To remove a link you have already inserted in a review, you can either delete it as you
would any other text, or use the Remove Link feature.
1. In the content pane, click to place the cursor in the link to Morrocona 1998.
20
2. Click the Remove Link button on the toolbar, or right‐click and select
Remove Link. Note that the text is no longer blue.
1. In the content pane, select the sentence in the Description of the condition
section, including the text ‘(Morrocona 1998)’.
2. From the Tools menu, select Find and Mark Links. The blue reference link has
again been created.
Note: If you do not select a section of text before using the Find and Mark Links tool, RevMan will
give you the option to check the whole review. Note that this tool will only search through
text that is expanded (that is, visible in the content pane). Click the icon next to a section
heading to expand and see the text.
PART 4 ‐ Tables
Now that you have included references to studies in your review, you can add a
description of each study. This is done in the text of the review, and also in two
standard tables: the Characteristics of included studies table and Risk of bias table.
1. In the outline pane, use the key icon to expand the Tables heading, then the
Characteristics of studies heading and the Characteristics of included studies
heading. You will see a list of the studies you have created.
2. Select the Deliciozza 2004 study.
3. In the content pane, you will see the same study shown. If it is not already
expanded, click the icon next to Deliciozza 2004 to show the Characteristics
of included studies table.
4. Type or copy and paste the following text into the characteristics table:
21
6. Type or copy and paste the following text into the Characteristics of included
studies table:
1. In the content pane, under the Characteristics of included studies table, find
the Risk of bias table heading (you may need to click the icon).
2. Click the Properties icon next to the Risk of bias table heading.
3. You will see all items have a tick symbol next to them, indicating that they
are included in the table by default.
4. For Blinding and Incomplete outcome data addressed, RevMan allows you to
add separate information for each outcome or group of outcomes.
5. Select Incomplete outcome data addressed and click the Add button next to
the Outcome Group list.
6. Put the cursor in the first row of this list and delete the default text, ‘All
outcomes’, and enter ‘At 12 weeks or less’.
7. Repeat step 6 for the second row in this table and enter ‘After 12 weeks’.
8. Click OK when you are finished.
9. In the content pane, the Risk of bias table will now include separate rows on
Incomplete outcome data addressed for the two specified time points.
22
10. Using the information in the table below about the domain Allocation
concealment for each of the included studies, set each of the drop‐down
boxes in the five Risk of bias tables to Low risk, High risk or Unclear risk and
type or copy and paste the text under the Support for judgement column into
the corresponding box in each Risk of bias table.
11. For this tutorial, do not modify any of the other risk of bias domains in the Risk
of bias tables.
Note: In the content pane, below the Characteristics of included studies and the Risk of bias tables,
there is a place to add footnotes for these tables.
23
Characteristics of excluded studies
Studies identified in your search that do not meet the inclusion criteria of the review
may be listed under Characteristics of excluded studies, along with the reason each
study was excluded. You do not need to list every study identified by your search, but
it is useful to list those which might appear to readers to meet your inclusion criteria.
Note: Footnotes can be added below the Table for Characteristics of Excluded Studies.
Additional tables
Additional information can be included in table format either in the text of the
review, in an appendix or as an Additional table.
24
To add an Additional table that will appear at the end of the published review:
1. In the outline pane, under the Tables heading, select Additional tables.
2. Click the Add Table button on the outline pane toolbar. This will open the
New Additional Table Wizard.
3. Enter the title, ‘Decaffeinated coffee: chemical information’.
4. Click Next.
5. Accept Create the table using RevMan’s table editor as your next action, and
click Next.
6. Accept the default number of rows and columns and click Finish. In the
content pane, you will see the table in the Additional tables section. You can
now enter text directly into the table.
7. In the outline pane, click the key icon to see the new table listed under
Additional tables.
Note: Tables created in another program (e.g., Microsoft Word) can be copied and pasted into
RevMan 5.1. To do this, you need to copy the table to the clipboard in the other program (e.g., in
Microsoft Word, highlight the table and click ‘Copy’, then in RevMan 5.1, repeat steps 1‐4 above and at
Step 5, select Paste in table copied from another program.
25
measured. For this example, ‘headache’ will be the outcome. For this example,
headache is a dichotomous outcome, meaning there are only two possible results:
headache or no headache.
9. Click Next.
10. Accept the default analysis details RevMan will use. Click Next.
11. Accept the default graph details RevMan will use. Click Next.
12. For your next action, select Add study data for the new outcome. Click
Continue. This will open the New Study Data Wizard.
26
Note: You can also open the New Study Data Wizard by selecting an outcome in the outline pane
and clicking the Add Study Data button.
11. RevMan will automatically calculate the risk ratio and 95% confidence interval
for each study and the pooled values for all the studies. Use the scroll bar
under the data table to scroll right and see these results.
27
12. The results are also displayed in a forest plot. The risk ratio for each study is
shown as blue square, and with a horizontal line showing the confidence
interval. The pooled result for all studies is shown as a black diamond.
13. At the bottom of the screen under the forest plot is a sliding scale. Click and
drag the white controller on the scale to change the scale of the forest plot.
Set the scale to a range of 0.02 to 50.
14. RevMan calculates a weight for each study (for dichotomous outcomes this is
based on the size of the study and the number of events). This determines
how much each individual study contributes to the pooled estimate.
15. At the bottom of the Study or Subgroup column in the results table, RevMan
will calculate measures of heterogeneity: the Chi2 and I2 statistics. For random
effects analysis, the Tau2 statistic is also presented. In the top row of the table,
use the mouse to click and drag the column border to show these statistics.
16. At the bottom of the screen under the results table is space to enter
footnotes. In the results table, select the Morrocona 1998 study. In the
Footnote field, enter the text ‘Unpublished data provided by author’.
17. At the top of the content pane, click the Text of review tab. Note that under
the heading Data and analyses, RevMan has added a table with a brief
summary of the results for this outcome, including the number of studies and
participants and the summary statistic.
18. Scroll up to the Results section of the review.
19. Click the icon to open the Results section, and then the Effects of
interventions section.
20. Click to place the cursor in the Effects of interventions section, and enter the
text ‘Caffeine significantly increased the occurrence of headache.’
21. From the Format menu, select Insert Analysis Results. This will open the
Insert Analysis Results window.
22. Select Headache and click OK. RevMan will copy the pooled result of the
Headache outcome into the text of the review. You can edit the text as
needed.
28
23. You can split the RevMan screen to see different sections of text. From the
View menu, select Split Text of Review. Note that the content pane is now
split in half.
24. Move the cursor to the bottom half of the screen and scroll down to the Data
and analyses section so that you can see the table with the brief summary of
results for the Headache outcome.
25. Check that the effect estimate reported in the table in the bottom half of the
split screen is the same as that which you inserted into the Effects of
interventions section in the top half of the split screen.
26. Turn the split screen feature off by repeating step 23 (i.e. from the View
menu, select Split Text of Review).
29
9. Click Apply. Note that the forest plot labels have changed.
Note: By default, RevMan assumes that outcomes are bad (e.g. headache). If you are measuring a
good outcome (e.g. alertness), swap the graph labels so that the opposite side favours the
treatment group.
30
changed. Click this button again to change the results to Risk Ratio format.
Click this button one more time to return the results to Risk Difference format.
20. In the content pane, click the Change To: Fixed Effect button on the tool
bar above the forest plot. Note that the results in the table and forest plot
have changed from a random‐effects analysis to a fixed‐effect analysis.
Note: There are different methodological and statistical rationales for performing a fixed‐effect as
opposed to a random‐effects meta‐analysis. For more information, see the Cochrane
Handbook for Systematic Reviews of Interventions, available from the Help menu.
Adding subgroups
RevMan allows you to divide outcomes into subgroups. You can add the subgroups
when you first create an outcome, or add subgroups to an existing outcome.
1. In the outline pane, right‐click the Headache outcome and select Introduce
Subgroup. A subgroup will appear in the outline pane with the default name
‘New subgroup’. All the included studies will be listed under the new
subgroup.
2. In the outline pane, select the New Subgroup, then right‐click and select
Rename Subgroup.
3. Enter the name ‘One caffeine dose’. Click elsewhere to close the editing box.
4. In the outline pane, select the Headache outcome and click the Add Subgroup
button on the outline pane toolbar. This will open the New Subgroup
Wizard.
5. Enter the Name ‘Two caffeine doses’ for the new subgroup and click Next.
31
6. For your next action, select Edit the new subgroup and click Finish. Note that
there is now a separate section in the data table for each subgroup.
7. In outline pane, click the key icon to see the studies listed under the One
caffeine dose subgroup.
8. Select the Oohlahlazza study and click the Cut button on the toolbar.
9. Select the Two caffeine doses subgroup and click the Paste button.
10. Click the key icon to see that the Oohlahlazza study now appears under the
Two caffeine doses subgroup. Note that the study has also moved in the data
table in the content pane, and the forest plot shows separate results for each
subgroup.
11. In the outline pane, select the Headache outcome and click the Properties
button on the outline pane toolbar.
12. In the Analysis Details tab, under Totals, select Subtotals only and click OK.
The forest plot now includes two black diamonds showing the summary effect
for each subgroup. Subgroup summary statistics are included in the data table.
32
9. In the outline pane, select the Migraine outcome and click the Move Up
button on the outline pane toolbar. Note that this outcome is now first on the
list, and the list has been renumbered.
33
Study Caffeinated coffee Decaffeinated coffee
Mean SD Total Mean SD Total
Deliciozza 2004 20 15.18 40 30 20.24 40
Kahve Paradiso 2002 20 9.1 65 30 8.6 67
Morrocona 1998 23 15.1 15 31 15.2 17
Norscafe 1998 19 15.5 68 36 17.3 64
11. You now have summary statistics and a forest plot for irritability. Note that the
Norscafe 1998 study shows a stronger effect than the other studies. To
conduct a sensitivity analysis, uncheck the box to the left of the Norscafe 1998
study in the data table. This will remove the study from the meta‐analysis
without deleting the entered data. Note the difference in the summary
estimate.
1. Click the Calculator button on the toolbar of the tab for the outcome,
Irritability at 30 minutes (INAS scale). This will open the Calculator window.
2. All fields in this window should be empty. Enter the following data into the
relevant fields:
34
Group Mean N SE
Caffeinated coffee 22 35 2.9
Decaffeinated coffee 32 35 2.8
3. You will notice that once this data has been entered, all other fields in the
Calculator window will be automatically calculated, including the standard
deviation for each group, which can now be entered into RevMan for the
particular study (for the purposes of this tutorial, do not enter this data into
the data table for the outcome, Irritability at 30 minutes (INAS scale).
4. Close the Calculator window by clicking Cancel.
15. You now have a summary estimate and forest plot for drowsiness. Note that
the summary estimate is not in units on the outcome scale, but units of
standard deviation. See the Cochrane Handbook for Systematic Reviews of
Interventions, available from the Help menu, for advice on interpreting these
results.
35
Using generic inverse variance
The generic inverse variance method in RevMan can be used to analyse other types of
data such as rates, time‐to‐event outcomes, hazard ratios, ordinal scales, adjusted
estimates, difference of means or ratios of means. The generic inverse variance
method requires a single estimate of effect and its standard error for each study.
11. You now have a summary estimate and forest plot for depression. You may
also add the number of participants to the results table, although this will not
affect the results. Click the Properties button in the top right corner.
12. Open the Analysis Details tab.
13. Check the Enter number of participants (Generic Inverse Variance, for display
only) option and click OK. Note that two new columns have been added to
your data table for the number of participants in the intervention and control
groups.
14. Enter the following data into the new columns:
36
Study Caffeinated coffee Decaffeinated coffee
Total Total
Deliciozza 2004 40 40
Morrocona 1998 15 17
Norscafe 1998 68 64
Note: When using the generic inverse variance method for ratio measures (e.g. hazard ratios or risk
ratios), convert the summary statistics and standard errors to the log scale before entering
into RevMan, and check the Entered data are on log scale option in the Analysis details tab
of the Properties window. RevMan will convert the results back to ordinary ratios. For more
information on these steps, see the Cochrane Handbook for Systematic Reviews of
Interventions, available from the Help menu.
You may have noted that the graph labels for the last three outcomes you added to
this review (Irritability, Drowsiness, and Depression) are currently set to the default
setting of “Favours experimental” versus “Favours control”. Rather than changing the
graph labels for each outcome individually, RevMan allows you to edit all graph labels
at the comparison level.
1. In the outline pane, double click the Caffeine versus decaffeinated coffee
comparison to open the Comparison Properties window.
2. Check the Set graph labels for all outcomes under this comparison option. In
the Left graph label box enter ‘Favours caffeine’ and in the Right graph label
box enter ‘Favours decaf’.
3. Click OK.
37
4. In the content pane, when you open each of the outcome tabs, note how the
graph labels have been modified.
1. In the outline pane, click the key icon next to Studies and references.
2. Click the key icon next to the Reference to studies section.
3. Click the key icon next to the Included studies section.
4. Select Kahve‐Paradiso 2002 and click the Edit Study button on the outline
pane toolbar. This will open a tab in the content pane for this study.
5. Under the Outcomes section of this Kahve‐Paradiso 2002 tab there is a table
indicating that this study has only provided data on two outcomes (‘Irritability
and 30 minutes’ and ‘Drowsiness at 30 minutes’).
6. In the outline pane, select Oohlahlazza 1998 and double click. Note how the
table of outcomes for this study indicates that this study provides data on
three outcomes (‘Headache’, ‘Drowsiness at 30 minutes’, and ‘Migraine’).
7. When you are finished, close the tabs for these two studies in the content
pane.
Note: For information on assessing the risk of selective reporting bias, see the Cochrane Handbook
for Systematic Reviews of Interventions, available from the Help menu.
38
4. In the outline pane, click the key icon next to the Figures heading to see that
the figure has been added.
5. In the content pane, click on the Headache outcome tab.
6. In the Norscafe study, change the number of events in the caffeinated coffee
column from 19 to 20.
7. Click on the Figure 1 tab again. Note that the numbers have been
automatically updated.
8. Click the Save As button in the top right corner of the Figure 1 tab. This
allows you to save the figure as a graphic file on your computer. Click Cancel.
9. Click the Text of Review tab. Scroll up to the Results section of your review.
10. Click the icon to open the Results section, and then the Effects of
interventions section.
11. Click to place the cursor in the Effects of interventions section.
12. Click the Insert Link button on the toolbar.
13. From the Insert Link To list, select Figure.
14. Select Figure 1 and click OK. A link to Figure 1 will now appear in the text of
the review. In the published version, a thumbnail image will appear.
39
3. To add this plot as a figure in your review, click Add as Figure. The figure will
be added in the outline pane as Figure 2. You could now add a link to this
figure in the text of the review, as you did for Figure 1.
Note: A funnel plot is not usually created for such a small number of studies. For more information
on publication bias, see the Cochrane Handbook for Systematic Reviews of Interventions,
available from the Help menu.
PRISMA flowchart
The PRISMA statement is a 27‐item checklist that aims to help authors improve
reporting of systematic reviews and meta‐analyses. Item 7 of the PRISMA statement
recommends authors to report all information sources used in the search for studies
(e.g., databases with dates of coverage, contact with study authors to identify
additional studies) and the date of the last search. A fixed template of the PRISMA
flowchart can be generated in RevMan.
40
Note: Additional text boxes can be added to the PRISMA flowchart by selecting a template text box
and clicking either of the Add exclusion , Add below , Add previous sibling , Add
following sibling , or Add above buttons above the PRISMA flowchart
1. In the outline pane, use the key icon to expand the Tables heading, and
select Summary of findings.
2. Click the Add Summary of Findings Table button on the outline pane
toolbar. This will open the New Summary of Findings Table Wizard.
3. There are two options for adding a summary of findings table to your review:
Import a complete summary of findings table from GRADEprofiler (a
separate software program designed to produce these tables).
Create the table using RevMan’s table editor
For this tutorial, select Create the table using RevMan’s table editor. Click
Next.
4. Leave the title as ‘Summary of findings. Click Next.
41
5. Rather than adding information on all outcomes of a review comparison into
the summary of findings table, it is recommended that a maximum of 7 of the
most important outcomes be included. For this tutorial, select the outcome
Migraine and click Add. Then select Headache and click Add. Finally, select
Drowsiness at 30 minutes and click Add.
6. Click Next.
7. Accept the default columns to be included in the summary of findings table.
Click Finish.
8. The template summary of findings table will be added to your review. You can
edit this template by typing directly into the table.
Note: Summary of findings tables created using GRADEprofiler software and then imported into
RevMan can be edited in RevMan as per other tables.
Adding an appendix
You can include more detailed information that is not essential to the main body of
your review in an appendix, such as detailed search strategies or statistical methods.
1. In the outline pane, select the Appendices heading (the last heading on the
list).
2. Click the Add Appendix button on the outline pane toolbar. This will open
the New Appendix Wizard.
3. Enter the Title ‘Detailed search strategies’.
4. Click Finish. In the content pane, the Appendices section will open and your
appendix title will be shown. You can now enter text in the appendix.
Validating a review
Before publication, every review should be validated to make sure all sections have
been completed and meet the requirements of The Cochrane Collaboration.
1. From the Tools menu, select Validate as You Type, or click the Validate as You
Type button on the toolbar. In the outline pane, any sections with
problems identified will be underlined.
42
2. Hover the mouse over a section underlined in red. A Validation error message
will appear. Validation errors must be corrected before publication.
3. Hover the mouse over a section underlined in blue. A Validation warning
message will appear. It is not compulsory to correct Validation warnings.
4. From the File menu, select Reports, and then Validation report. A report will
be displayed listing all the Validation errors and Validation warnings. You can
choose to copy, print or save this report.
5. Each of the Validation errors and Validation warnings are linked to the
relevant part of RevMan where editing is required. In the Validation report,
click the first error listed (i.e. Contact person). Note how the Contact person
window has opened in the content pane for you to enter the relevant details
about the contact person of the review.
6. Go back to the Validation report and click OK.
When you have made all the changes requested and the review is ready to publish,
you and all your co‐authors will need to sign the online Licence for Publication Form
and Declarations of Interest Form, available from Archie.
43