prototype-multi-modality-assistant repository on the MIDA organization.
MIMBCD-UI is a Research Project that deals with the use of a recently proposed technique in literature: Deep Convolutional Neural Networks (CNNs). These deep networks will incorporate information from several different modes by a User Interface (UI) implemented based on our Prototype Breast Screening repository. The hereby repository is a mirror of our Prototype Breast Screening repository which is an Open Source Project with the goal to deliver an example of web based medical imaging platform for the breast cancer diagnosis. We also have several demos to see in our YouTube Channel, please follow us.
First of all, you will need NodeJS installed locally on your machine. This project needs both npm and http-server dependencies to install and run the core project. If you do not have those installed please follow the INSTALL instructions.
The following assumes you will be using a git version control for this repository, storing thanks to GitHub. First, Download and Install git. Our system needs to be integrated with WADO-URI servers, DICOMWeb servers or any HTTP based server that returns a DICOM P10 instances. We suggest you to use an Orthanc server, since it is a simple and powerful standalone DICOM server by providing a RESTful API.
You can download a latest version or you can use our own sample of an Orthanc version with our examples of patient images. The instructions to use our solution are as follows.
1.1.1. Clone the DICOM Server repository:
git clone git@github.com:MIMBCD-UI/dicom-server.git
1.1.2. Go inside the project folder:
cd dicom-server/
1.2.1. Install the local dependencies:
npm install
1.2.2. You can now Run the project, just follow the next section.
1.3.1. Inside the project folder:
cd dicom-server
1.3.2. Start the DICOM Server (Orthanc) for MacOS:
npm run start:multi
OR
cd ..
cd dicom-server/orthancAndPluginsOSX.stable/
./startOrthanc.command
NOTE: If you are not using MacOS, for instance, if you are using Windows or Debian you have a documentation for that. Just follow the Windows or Debian documentations. You also have several other options.
1.3.3. Open the link:
localhost:8248
NOTE: If you need some help see the Demo.
Our main server uses NodeJS and has several dependencies. For the following steps you must have already installed both NodeJS and npm in your machine.
2.1.1. Clone the project repository:
git clone git@github.com:MIMBCD-UI/prototype-multi-modality-assistant.git
2.1.2. Go inside the project folder:
cd prototype-multi-modality-assistant/
2.2.1. Install the local dependencies:
npm install
2.2.2. You can now Run the project, just follow the next section.
2.3.1. Inside the project folder:
cd prototype-multi-modality-assistant/
2.3.2. If you have already run the DICOM Server on a previous section, please jump to the 2.3.3. point, otherwise do:
npm run dicom-server
2.3.3. Run the code:
npm run build:multi
2.3.4. Start the project:
npm run start:multi
2.3.5. Open the link:
localhost:8286/src/public/index.html
Access-Control-Allow-Origin is a CORS (Cross-Origin Resource Sharing) header. If you want to know How does Access-Control-Allow-Origin header work? follow the link.
- To deal with the CORS issue it is necessary to open Google Chrome with
--disable-web-securityflag on:
open /Applications/Google\ Chrome.app --args --disable-web-security --user-data-dir
- Or install the CORS plugin for Google Chrome.
For more information about the MIMBCD-UI Project just follow the link. Pieces of information about details of this repository are also in a wiki. This prototype was developed using several libraries and dependencies. Despite that all libraries had their importance and supported the development, one of it was of chief importance. The CornerstoneJS library and secondary libraries, respectively, are supporting this prototype. We Acknowledge all people involved in the path.
Copyright © 2017 Instituto Superior Técnico (IST)
The prototype-multi-modality-assistant repository is distributed under the terms of both Academic License and Commercial License, for academic and commercial purpose, respectively. For more information regarding the License of the hereby repository, just follow both ACADEMIC and COMMERCIAL files.
A special thanks to Chris Hafey, the propelling person of CornerstoneJS, who also developed the cornerstoneDemo. Not forgetting the three supporters of the CornerstoneJS library, Aloïs Dreyfus, Danny Brown and Erik Ziegler. We also would like to give a special thanks to Erik Ziegler who support several issues during this path.