Back to Oriel
Oriel

Your first project, in ten minutes.

This page takes you from a fresh install to your first results. Choose your kind of project to see the steps that suit it. For everything else, open Help → Oriel User Guide in the app.

Show the steps for

For interviews, focus groups, documents and other data you code yourself.

For reviewing published qualitative studies, with extraction, appraisal and CERQual.

For building and testing a programme theory from your data or from published studies.

For process, implementation and behavioural evaluations of a programme, with frameworks such as the TDF, COM-B and CFIR.

  1. Install Oriel

    Download Oriel for Mac or Windows. The first time you open it, your computer warns that it can’t check who made it, so follow the one-off steps on the download page.

    Download and install steps
  2. Try an example Optional

    On the Welcome screen, choose Open an example project…, pick one and click Open example. Everything in it is fictional, so you can try anything without worrying about your own data.

    The Qualitative analysis example has coded interviews, cases, queries and memos.

    The Realist review example has studies ready to extract and appraise.

    The Realist review example has a programme theory whose CMOCs already have evidence.

    The Behavioural and implementation evaluation example evaluates brief alcohol advice at three practices, with COM-B and CFIR codes and two linked logic models.

    The Oriel Welcome screen, with New project and Open project buttons on the left and recent projects on the right
    The Welcome screen.
  3. Create your project

    Click New project… and work through three short steps: Purpose, Methods and theory, and Sharing and saving.

    Choose Qualitative analysis. You can name your method, such as reflexive thematic analysis, in Analytic approach (optional).

    Choose Evidence synthesis and tick Qualitative evidence synthesis. This switches on Study review tools.

    For an evaluation, choose Intervention or programme evaluation and tick Realist. For a review, choose Evidence synthesis and tick Realist review. On the next step, tick Create an initial programme theory now.

    Choose Intervention or programme evaluation and tick what you want to look at: Process, Implementation, Behavioural, or several. On Methods and theory, you can choose a framework under Add a framework to start with, such as the Theoretical Domains Framework or CFIR, to add its codes.

    Leave anything you’re unsure about as it is, since you can change most choices later. Then click Choose save location… to save your project file.

    The New project dialog, asking what the project is for, with cards for qualitative analysis, programme evaluation and evidence synthesis
    Choosing a purpose for a new project.
  4. Bring in your data

    Click + beside Sources in the sidebar and choose Import files…, or drag files and folders into the window.

    Oriel reads Word, PDF and text files, spreadsheets, audio, video and images. To transcribe a recording on your own computer, open it and click Transcribe….

    Import the papers you’ve included. Each file becomes its own study, listed under Studies in the Review section of the sidebar.

    Bring in interviews, field notes and recordings, or study PDFs for a review. To rate how trustworthy and useful a source is, right-click it and choose Rigour and relevance….

    Bring in interviews, field notes, documents and recordings. Click + beside Cases to add a case for each site or participant, so you can compare them later.

    The Oriel main window, with sources in the sidebar on the left, an interview transcript in the centre and the Codes panel on the right
    Sources on the left, your open item in the centre, codes on the right.
  5. Code your first passage

    Open a source and select a passage. The Quick codes card appears beside it.

    Type a code name, then choose a match or Create “…”. The passage gets a coloured mark, and the code’s count goes up.

    A selected passage in an interview, with the Quick codes card beside it listing codes to choose from
    The Quick codes card beside a selected passage.
  6. Look across your coding

    Open Codes or Excerpts in the sidebar to read coded passages together. Use Queries to search words or compare codes across sources and cases.

  7. Write it up

    Note ideas in Memos as you go. When you’re ready, write Findings with the evidence behind them, and turn your work into a document from Reports.

  8. Choose your templates

    Open Extraction and appraisal templates in the Review section and choose the forms every reviewer uses. Edit a starter template or make your own.

  9. Extract and appraise each study

    Open a study and fill in its Extraction tab, with the report beside the form, then its Appraisal tab. Choose Submit my review when you’re done.

    Working with a second reviewer? Agree your values on the study’s Reconcile tab.

    A study's Extraction tab, with the extraction form on the left and the report open beside it on the right
    Extracting a study with its report beside the form.
  10. Build your findings

    Code the reports with Quick codes to draw out themes. To support a finding, select a passage, right-click and choose Add as evidence for finding…. Oriel records which study it came from.

  11. Judge your confidence

    On a finding’s Confidence (CERQual) tab, judge Methodological limitations, Coherence, Adequacy and Relevance, choose an overall confidence, then click Save judgement.

    The judgement is always yours, and Oriel shows each study’s appraisal beside your judgement.

    A finding's Confidence (CERQual) tab, with the four components, the overall confidence and the appraisals of contributing studies
    Recording a CERQual judgement for a finding.
  12. Write your CMOCs

    Open your theory under Models in the sidebar and choose New CMOC…. Give it a short label and a statement, then write its context, mechanism and outcome.

  13. Link evidence to your CMOCs

    Open a source and switch the Codes panel to CMOCs. Select a passage, then in the Quick codes card choose the CMOC, the part the passage speaks to, and a stance: Supports, Contradicts, Refines or Informs.

    An interview open beside the CMOCs panel, which lists each CMOC with its context, mechanism and outcome
    The panel switched to CMOCs beside an interview.
  14. Test and refine your theory

    When your CMOCs are ready, choose Start testing round… on the theory page. On the Testing tab, use Queue to judge each CMOC against its evidence: Confirm, Refine…, Refute… or Set aside….

    The Testing tab of a programme theory, with untested CMOCs on the left and a CMOC's evidence and verdict buttons on the right
    Judging CMOCs one at a time in the testing queue.
  15. Write it up

    Write Findings with the evidence behind them, keep rival accounts in Alternative explanations, and turn your work into a document from Reports.

  16. Follow the stages on Project home

    Project home guides you through five stages, from Frame the evaluation to Report and reflect. Click a stage to see its guidance and the tools that suit it.

    Write your questions in Project brief and questions, then choose one on Project home to focus the guidance on it.

  17. Code or summarise each source

    Code passages with Quick codes, using your framework’s codes alongside your own. To capture a source quickly instead, open it and click Summarise source, then write a short summary under each heading. You can do both.

    Compare summaries side by side in Summary matrix.

    An interview with the Source summary panel open beside it, showing a summary, reviewer notes and supporting passages
    Summarising a source beside its text.
  18. Analyse with a framework Optional

    Click + beside Queries and choose Framework analysis…. A Behavioural diagnosis shows where your coding falls across the Theoretical Domains Framework, case by case.

    With CFIR, rate each construct for each case, then use Compare groups to set sites or groups side by side.

    A CFIR construct rating analysis, with a row for each construct, a column for each case and a panel for rating the chosen cell
    Rating CFIR constructs for each case.
  19. Build a logic model Optional

    Click + beside Models and choose a format. An Implementation research logic model links determinants, strategies, mechanisms and outcomes. A Behaviour change logic model shows how the programme changes a behaviour. You can link the two where they meet.

  20. Keep delivery and adaptation records

    Note what was delivered and what changed, with dates. Open Records under Notes, click New record… and choose a template, such as Delivery record, Adaptation record or, with ERIC added, Implementation strategy.

  21. Write it up

    Open Develop and review findings on Project home for guidance on interpreting each kind of evaluation. Write Findings with their evidence, keep rival accounts in Alternative explanations, and draft your report from Reports.

  22. Keep it safe, or share it

    Oriel saves as you work and makes backups automatically. For a copy of your own, choose File → Back up now….

    To work with colleagues, click Collaborate and choose a folder you already share, such as OneDrive, Dropbox or a network drive.

Three ways to find your way.

  • Go to anything

    Press ⌘ K (Ctrl K on Windows) and type part of a name to open a source, code or setting.

  • Back and forward

    The arrows at the top retrace your steps, like a web browser.

  • Guided tours

    Short tours point out each area the first time you open it. Replay them from Help → Guided tours….