CancerVision

Table of contents

• PROJECT-TEMPLATE
  • Description
  • Prerequisites
  • Getting started
  • Usage
    • Generate Documentation Site
  • Testing
  • Team
    • License

Description

CancerVision is an AI project that uses computer vision and deep learning to segment brain tumors from MRI scans. It identifies tumor regions such as the core, edema, and enhancing areas to support medical analysis and treatment planning. The aim is to build accurate models that reduce manual work and improve consistency in diagnosis.

Prerequisites

• Git: Ensure that git is installed on your machine. Download Git
• Python 3.12: Required for the project. Download Python
• UV: Used for managing Python environments. Install UV
• Docker (optional): For DevContainer development. Download Docker

Getting started

1. Clone the repository:

   git clone https://github.com/CogitoNTNU/CancerVision
   cd CancerVision

2. Install dependencies:

   uv sync

3. Resources:

   • https://www.slicer.org/
   • https://zenodo.org/records/11199559
   • https://github.com/SverreNystad/computer-vision/blob/main/docs/TDT4265_project_2025_v1.0.pdf

1. Set up pre commit (only for development):

   uv run pre-commit install

Usage

To run the project, run the following command from the root directory of the project:

Generate Documentation Site

To build and preview the documentation site locally:

uv run mkdocs build
uv run mkdocs serve

This will build the documentation and start a local server at http://127.0.0.1:8000/ where you can browse the docs and API reference. Get the documentation according to the lastes commit on main by viewing the gh-pages branch on GitHub: https://cogitontnu.github.io/PROJECT-TEMPLATE/.

Testing

To run the test suite, run the following command from the root directory of the project:

uv run pytest --doctest-modules --cov=src --cov-report=html

Team

This project would not have been possible without the hard work and dedication of all of the contributors. Thank you for the time and effort you have put into making this project a reality.

License

---

Distributed under the MIT License. See LICENSE for more information.