instructions.txt

### Summary for Dashboard Navigation

This tool helps you to explore and analyze radiomics data extracted from the segmentations. You can apply various heuristics to filter out problematic data, and visualize the results.

#### Navigation and Features:

**Page Selection**:
   - **Summary**: Shows the summary in pass percentage of each heurisitic as if applied individually.
   - **Plots**: Shows detailed visualizations and data filtering options.

**Filters**:
   - **Radiomics Feature**: Allows selection from a variety of radiomics features such as Volume from Voxel Summation, Mean, Variance, etc. for specific analytical criteria.
   - **Body Part**: Enables targeted analysis by selecting the desired anatomical region.
   - **Laterality**: Provides the ability to specify the laterality (left or right) for applicable organ systems.
   - **Segmentation Completeness**: Offers a dropdown menu to filter segmentations based on their completion status.
   - **Laterality Check**: Includes a dropdown menu to assess the pass/fail status of laterality checks.
   - **Minimum of 5 mL**: Facilitates filtering of segmentations with a volume of at least 5 milliliters, classified as either passed or failed.
   - **Connected Volumes**: Lets users set a threshold for the maximum number of connected components they wish to allow in their analysis.
   - **Voxel Number**: Provides a slider bar to filter data based on a range of voxel numbers present in the imaging data.
   - **Radiomics Feature Values**: Allows users to set a range for values of selected radiomics features to refine analysis.
   - **Select column to sort by**: Enables users to organize the displayed data by sorting any column present within it.
   - **Sort in descending order**: Gives users the option to sort data in either descending or ascending order.
   - **Page Number**: Allows users to navigate through the dataset. Only 10 rows are displayed at a time for easy viewing.
   - **Download the filtered dataset**: Provides the option to download the dataset as a CSV file  after applying the desired filters.

**Filtered Data Display**:
   - Views a paginated table of filtered data. Please use 'sortby' filter in the sidebar to sort the underlying data.
   - Includes direct links to the OHIF viewer for each StudyInstanceUID.
   - Use StudyInstanceUID in combination with Source CT scan's seriesNumber to view the scan of interest.

**Visualizations**:
   - **Violin Plots**: Shows the distribution of the standard deviation of the selected radiomics feature before and after filtering.
   - **[UpSet Plots](https://ieeexplore.ieee.org/document/6876017)**: Visualize intersections of passed and failed qualitative checks.

#### Using the Dashboard:

1. **Select the desired page** from the sidebar.
2. **Apply filters** as needed using the sidebar options to narrow down your dataset.
   
   - **Note**: Please change to a different bodyPart to reset the filters or when you encounter an error message, while we continue improving this dashboard.

3. **View and analyze the data** in the main panel through tables and plots.
4. **Download the filtered data** for offline analysis.