Skip to content

User Guide

This guide will help you understand how to use RADIS for managing and searching radiology reports.

How RADIS Works

RADIS acts as a centralized repository for radiology reports, providing powerful search capabilities and organizational tools:

  1. Reports are stored with structured metadata (patient info, study details, modalities, etc.)
  2. You search using natural language queries with optional filters
  3. RADIS processes your query using advanced search algorithms (BM25, semantic, or hybrid search)
  4. You receive ranked results matching your criteria
  5. You organize reports into collections, add notes, and subscribe to searches

Functionalities Overview

When you log into RADIS, you'll see the main/homepage with several sections:

  • Search: Search for reports using text queries and filters
  • Collections: Organize reports into custom collections
  • Subscriptions: Set up notifications for new matching reports
  • Notes: View and manage notes you've added to reports
  • Extractions: AI-powered analysis and filtering
  • Chats: Interactive chat interface with AI

Main Features

1. Search Reports

The search feature is the core of RADIS, allowing you to find relevant reports quickly:

  1. Navigate to the "Search" section
  2. Enter your search query in the search box
  3. Apply filters as needed (language, modality, date range, patient demographics)
  4. Review the search results

Search Syntax

  • Case-insensitive: Search terms are not case-sensitive
  • AND queries: All terms must match (implicit AND between terms)
  • OR operator: Use capital OR between terms (e.g., "fracture OR lesion")
  • Phrases: Use quotes for exact matches (e.g., "lung cancer")
  • Exclusion: Use minus sign to exclude terms (e.g., "-metastasis")

Available Filters

  • Language: Filter by report language
  • Modalities: Filter by imaging modality (CT, MRI, X-ray, etc.)
  • Study Date: Filter by date range
  • Study Description: Filter by study description
  • Patient Sex: Filter by patient sex (M/F/U)
  • Patient Age: Filter by age range
  • Patient ID: Search for specific patient ID

2. Collections

Collections allow you to organize reports for easy access:

  1. Go to the "Collections" section to view your collections
  2. Click "Create Collection" to create a new collection
  3. Add reports to collections by clicking the collection button on report panels
  4. View collection contents by clicking on the collection name

Collections are useful for:

  • Grouping cases for research or review
  • Creating teaching file collections
  • Organizing reports by project or study

3. Notes

Add personal notes to reports for additional context:

  1. Open a report detail view
  2. Click the notes button to add or edit notes
  3. View all your notes in the "Notes" section
  4. Notes are private to your user account

4. Subscriptions

Set up subscriptions to be notified when new reports match your criteria:

  1. Navigate to the "Subscriptions" section
  2. Click "Add Subscription" to set up a new subscription

  3. Enter the Subscription Name and add filter questions.

  4. Write each question and select Accept when answer is Yes or No.\

  5. Add extraction fields by specifying the following for each field:

    • Name
    • Output Type (Boolean, Text, or Numeric)
    • Description

  6. Choose to receive email notifications

  7. New matching reports will be tracked and you'll receive notifications

5. Extraction

  • Create extraction jobs to analyze multiple reports.
  • Add extraction fields by specifying the following for each field:
  • Name
  • Output Type (Boolean, Text, or Numeric)
  • Description
  • In the next step, search query will be automatically generated based on these fields, which you can then review and refine.

6. Chats (AI Assistant)

If enabled, the Chats feature provides an interactive AI assistant:

  • Ask questions about reports in natural language
  • Get contextual answers based on report content
  • Useful for exploring report data interactively

RADIS Client

RADIS Client is a Python library that provides programmatic access to RADIS features without using the web interface.

To use the RADIS Client, you must have an API token provided by an administrator. For instructions on generating an API token, refer to the Admin Guide.