docs(readme): Start adding documentation for React version
No files matched your search
@@ -0,0 +1,40 @@
|
||||
# Add a Logo to the Viewer
|
||||
|
||||
The OHIF Framework provides [**ohif-header**](https://github.com/OHIF/Viewers/tree/master/Packages/ohif-header) package to add a header into application layout. **ohif-header** package is designed as a [custom block helper](http://blazejs.org/api/spacebars.html#Custom-Block-Helpers) named **header** to define your own header context.
|
||||
|
||||
If you would like to add SVG logo to header please follow these steps.
|
||||
|
||||
1. Add your SVG logo into public folder.
|
||||
|
||||
2. Add **header** content block which will be located on the top of the application layout into your application's main template. You can also pass some parameters to **header** content block to customize the header.
|
||||
|
||||
* headerClasses: the list of classes which will be applied to header element
|
||||
* brandHref: the url of the logo to link
|
||||
|
||||
{% raw %}
|
||||
``` html
|
||||
{{#header headerClasses="header-big bg-blue" brandHref="your logo link"}}
|
||||
...
|
||||
{{/header}}
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
3. Create a section called as **brand** in **header** content block and add your logo content which is displayed on the left side of the header as default into section **brand**.
|
||||
|
||||
{% raw %}
|
||||
``` html
|
||||
{{#header}}
|
||||
{{#section "brand"}}
|
||||
<!-- Add logo image -->
|
||||
<svg>
|
||||
<use xlink:href="/yourLogo.svg"}}></use>
|
||||
</svg>
|
||||
|
||||
<!-- Add logo text -->
|
||||
<div>Logo Text</div>
|
||||
{{/section}}
|
||||
{{/header}}
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
For example, see how it works in [OHIF Viewer](https://github.com/OHIF/Viewers/blob/master/OHIFViewer/client/components/ohifViewer/ohifViewer.html#L2)
|
||||
@@ -0,0 +1,22 @@
|
||||
# Add a Tool to the Viewer
|
||||
|
||||
To add a tool to the Viewer there are a few steps:
|
||||
|
||||
1. Add the tool itself to the repository.
|
||||
|
||||
If you're using something from Cornerstone Tools you can skip this step.
|
||||
|
||||
Some examples of custom tools can be found in the lesion tracker: https://github.com/OHIF/Viewers/tree/master/Packages/ohif-lesiontracker/client/compatibility
|
||||
|
||||
2. Add the toolbar button itself to the array of tools in the Toolbar:
|
||||
https://github.com/OHIF/Viewers/blob/574a6d02b090b8b2f020430c5919f8377b8316c6/OHIFViewer/client/components/toolbarSection/toolbarSection.js
|
||||
|
||||
3. **A:** Add it to the toolManager (if it's a tool, such as length / angle):
|
||||
|
||||
https://github.com/OHIF/Viewers/blob/574a6d02b090b8b2f020430c5919f8377b8316c6/Packages/lesiontracker/client/tools.js#L2
|
||||
|
||||
** --- OR --- **
|
||||
|
||||
**B:** Add it to the functionList if it's a command (e.g. toggle CINE play, or Invert the current viewport):
|
||||
|
||||
https://github.com/OHIF/Viewers/blob/574a6d02b090b8b2f020430c5919f8377b8316c6/OHIFViewer/client/components/viewer/viewer.js#L12
|
||||
@@ -0,0 +1,28 @@
|
||||
##### Looking for your Deploy Preview? - <a onclick="function redirect() { window.location.href='/demo/'; } redirect();">Deploy Preview for Viewer</a>
|
||||
|
||||
# Introduction
|
||||
|
||||
The [Open Health Imaging Foundation](https://www.ohif.org) is developing an open source framework for constructing web-based medical imaging applications. The application framework is built using modern HTML / CSS / JavaScript and uses [Cornerstone](https://cornerstonejs.org/) at its core to display and manipulate medical images. It is built with Meteor, a Node.js-based full-stack JavaScript platform.
|
||||
|
||||
This documentation concerns the OHIF framework itself and its three example applications: the OHIF Viewer, Lesion Tracker, and the Standalone Viewer.
|
||||
|
||||
## The **OHIF Viewer**: A general purpose DICOM Viewer ([demo](http://viewer.ohif.org/))
|
||||
|
||||

|
||||
|
||||
The Open Health Imaging Foundation intends to provide a simple general purpose DICOM Viewer which can be easily extended for specific uses. The primary purpose of the OHIF Viewer is to serve as a testing ground for the underlying packages and the [Cornerstone](https://cornerstonejs.org/) family of libraries.
|
||||
|
||||
## **Lesion Tracker**: An oncology-focused imaging application ([demo](http://lesiontracker.ohif.org/))
|
||||
|
||||

|
||||
|
||||
The Lesion Tracker is designed to facilitate quantitative assessments of tumour burden over time. It is similar in scope to the ePAD Imaging Platform (https://epad.stanford.edu/), developed at Stanford Medicine.
|
||||
|
||||
## Study List & DICOM Connectivity
|
||||

|
||||
|
||||
The solution provides a study list and other resources for connecting to PACS and other Image Archives through standard communication approaches (DICOM Web, DICOM Messages).
|
||||
|
||||
## Standalone Viewer ([demo](ohif-viewer.s3-website.eu-central-1.amazonaws.com/?url=https://raw.githubusercontent.com/OHIF/Viewers/master/StandaloneViewer/etc/sampleDICOM.json))
|
||||
|
||||
The Standalone Viewer offers only the client-side portions of the OHIF Viewer with the Study List pages removed. This single-page viewer can be hosted as a static site (e.g. on Amazon S3, Azure Blob Storage, or Github Pages), and easily integrated with existing back-end DICOM storage systems. Alternative [Cornerstone](https://cornerstonejs.org/) Image Loaders can be included to allow your viewer to support non-DICOM objects (e.g. PNG, JPEG).
|
||||
@@ -0,0 +1,60 @@
|
||||
# OHIF Viewers
|
||||
|
||||
- Essentials
|
||||
- [Installation](essentials/installation.md)
|
||||
- [Getting Started](essentials/getting-started.md)
|
||||
- [Architecture](essentials/architecture.md)
|
||||
- [Configuration](essentials/configuration.md)
|
||||
- [Troubleshooting](essentials/troubleshooting.md)
|
||||
- Connecting to Image Archives
|
||||
- [What are my options?](connecting-to-image-archives/options.md)
|
||||
- [DICOM Web](connecting-to-image-archives/dicomweb.md)
|
||||
- [DICOM Message Service Element](connecting-to-image-archives/dimse.md)
|
||||
- Examples
|
||||
- [dcm4chee w/ Docker](connecting-to-image-archives/dcm4chee-with-docker.md)
|
||||
- [Orthanc w/ Docker](connecting-to-image-archives/orthanc-with-docker.md)
|
||||
- [Osirix](connecting-to-image-archives/osirix.md)
|
||||
- Data Organization
|
||||
- [Data Hierarchy](data/data-hierarchy.md)
|
||||
- [Image Viewport](data/image-viewport.md)
|
||||
- Viewport Layout
|
||||
- [Layout Management](layout/layout-management.md)
|
||||
- [Hanging Protocols](layout/hanging-protocols.md)
|
||||
- Packages
|
||||
- [Measurements Package (ohif-measurements)](packages/measurements.md)
|
||||
- Deployment
|
||||
- [Building for Production](deployment/building-for-production.md)
|
||||
- [Security](deployment/security.md)
|
||||
- I Want To...
|
||||
- [Add a Tool to the Viewer](I-want-to/add-a-tool-to-the-viewer.md)
|
||||
- [Add a Logo to the Viewer](I-want-to/add-a-logo-to-the-viewer.md)
|
||||
----
|
||||
|
||||
- Example Applications
|
||||
- [OHIF Viewer](example-applications/ohif-viewer.md)
|
||||
- [Lesion Tracker](example-applications/lesion-tracker.md)
|
||||
- [Standalone Viewer](example-applications/standalone-viewer.md)
|
||||
|
||||
----
|
||||
- Standalone Viewer Integration
|
||||
- [Usage](standalone-viewer/usage.md)
|
||||
|
||||
----
|
||||
- Lesion Tracker
|
||||
- [User Manual](lesion-tracker/user-manual.md)
|
||||
- [Installation on Windows](lesion-tracker/installation-on-windows.md)
|
||||
- [Manage Studies in Orthanc](lesion-tracker/manage-studies-in-orthanc.md)
|
||||
- [User Accounts](lesion-tracker/user-accounts.md)
|
||||
- [Study and Timepoint Management](lesion-tracker/study-and-timepoint-management.md)
|
||||
- [Using the Viewer](lesion-tracker/using-the-viewer.md)
|
||||
- [User Preferences](lesion-tracker/user-preferences.md)
|
||||
- [Server Management](lesion-tracker/server-management.md)
|
||||
- [Audit Trail](lesion-tracker/audit-trail.md)
|
||||
|
||||
----
|
||||
- FAQ
|
||||
- [General](faq/general.md)
|
||||
- [Technical](faq/technical.md)
|
||||
|
||||
----
|
||||
- [Contributing](contributing.md)
|
||||
@@ -0,0 +1 @@
|
||||
docs.ohif.org
|
||||
|
After Width: | Height: | Size: 585 KiB |
|
After Width: | Height: | Size: 227 KiB |
|
After Width: | Height: | Size: 107 KiB |
|
After Width: | Height: | Size: 311 KiB |
|
After Width: | Height: | Size: 26 KiB |
|
After Width: | Height: | Size: 733 KiB |
|
After Width: | Height: | Size: 517 KiB |
|
After Width: | Height: | Size: 424 KiB |
|
After Width: | Height: | Size: 457 KiB |
|
After Width: | Height: | Size: 257 KiB |
|
After Width: | Height: | Size: 318 KiB |
|
After Width: | Height: | Size: 305 KiB |
|
After Width: | Height: | Size: 315 KiB |
|
After Width: | Height: | Size: 28 KiB |
|
After Width: | Height: | Size: 595 KiB |
|
After Width: | Height: | Size: 576 KiB |
|
After Width: | Height: | Size: 411 KiB |
|
After Width: | Height: | Size: 12 KiB |
|
After Width: | Height: | Size: 34 KiB |
|
After Width: | Height: | Size: 13 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 8.8 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 36 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 13 KiB |
|
After Width: | Height: | Size: 47 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 29 KiB |
|
After Width: | Height: | Size: 320 KiB |
|
After Width: | Height: | Size: 521 KiB |
|
After Width: | Height: | Size: 180 KiB |
|
After Width: | Height: | Size: 29 KiB |
|
After Width: | Height: | Size: 303 KiB |
|
After Width: | Height: | Size: 292 KiB |
|
After Width: | Height: | Size: 306 KiB |
|
After Width: | Height: | Size: 30 KiB |
|
After Width: | Height: | Size: 241 KiB |
|
After Width: | Height: | Size: 314 KiB |
|
After Width: | Height: | Size: 34 KiB |
|
After Width: | Height: | Size: 135 KiB |
|
After Width: | Height: | Size: 150 KiB |
|
After Width: | Height: | Size: 117 KiB |
|
After Width: | Height: | Size: 34 KiB |
|
After Width: | Height: | Size: 43 KiB |
|
After Width: | Height: | Size: 40 KiB |
|
After Width: | Height: | Size: 402 KiB |
|
After Width: | Height: | Size: 292 KiB |
|
After Width: | Height: | Size: 118 KiB |
|
After Width: | Height: | Size: 150 KiB |
|
After Width: | Height: | Size: 414 KiB |
|
After Width: | Height: | Size: 329 KiB |
|
After Width: | Height: | Size: 329 KiB |
|
After Width: | Height: | Size: 311 KiB |
|
After Width: | Height: | Size: 311 KiB |
|
After Width: | Height: | Size: 485 KiB |
|
After Width: | Height: | Size: 113 KiB |
|
After Width: | Height: | Size: 319 KiB |
|
After Width: | Height: | Size: 787 KiB |
|
After Width: | Height: | Size: 424 KiB |
|
After Width: | Height: | Size: 501 KiB |
|
After Width: | Height: | Size: 104 KiB |
|
After Width: | Height: | Size: 313 KiB |
|
After Width: | Height: | Size: 292 KiB |
|
After Width: | Height: | Size: 457 KiB |
|
After Width: | Height: | Size: 292 KiB |
|
After Width: | Height: | Size: 457 KiB |
|
After Width: | Height: | Size: 289 KiB |
|
After Width: | Height: | Size: 312 KiB |
|
After Width: | Height: | Size: 336 KiB |
|
After Width: | Height: | Size: 454 KiB |
|
After Width: | Height: | Size: 99 KiB |
|
After Width: | Height: | Size: 144 KiB |
|
After Width: | Height: | Size: 440 KiB |
|
After Width: | Height: | Size: 444 KiB |
|
After Width: | Height: | Size: 154 KiB |
|
After Width: | Height: | Size: 493 KiB |
|
After Width: | Height: | Size: 440 KiB |
|
After Width: | Height: | Size: 662 KiB |
|
After Width: | Height: | Size: 104 KiB |
@@ -0,0 +1,49 @@
|
||||
{
|
||||
"title": "OHIF",
|
||||
"description": "Documentation for the OHIF framework",
|
||||
"gitbook": ">3.0.0",
|
||||
"plugins": [
|
||||
"edit-link",
|
||||
"theme-cornerstone",
|
||||
"-fontsettings",
|
||||
"github",
|
||||
"ga",
|
||||
"sitemap",
|
||||
"anchors"
|
||||
],
|
||||
"pluginsConfig": {
|
||||
"edit-link": {
|
||||
"base": "https://github.com/OHIF/Viewers/edit/master/docs",
|
||||
"label": "Edit This Page"
|
||||
},
|
||||
"github": {
|
||||
"url": "https://github.com/OHIF/Viewers"
|
||||
},
|
||||
"ga": {
|
||||
"token": "UA-110573590-2"
|
||||
},
|
||||
"sitemap": {
|
||||
"hostname": "https://docs.ohif.org"
|
||||
},
|
||||
"versions": {
|
||||
"gitbookConfigURL": "https://raw.githubusercontent.com/OHIF/Viewers/master/docs/book.json",
|
||||
"options": [
|
||||
{
|
||||
"value": "https://docs.ohif.org/history/v1/",
|
||||
"text": "Version 1.0.0 (Meteor)",
|
||||
"selected": true
|
||||
},
|
||||
{
|
||||
"value": "https://docs.ohif.org/",
|
||||
"text": "Version 2.0.0"
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"links": {
|
||||
"sharing": {
|
||||
"facebook": false,
|
||||
"twitter": false
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,41 @@
|
||||
# DCM4CHEE with Docker
|
||||
|
||||
1. Install Docker (https://www.docker.com/)
|
||||
2. Follow the DCM4CHEE Guidelines for Running on Docker.
|
||||
|
||||
The easiest path is to use Docker-Compose which will start and stop multiple containers for you. There are excellent instructions provided by the DCM4CHEE team on the 'light archive' repository:
|
||||
|
||||
https://github.com/dcm4che/dcm4chee-arc-light/wiki/Running-on-Docker#use-docker-compose
|
||||
|
||||
* Create docker-compose.yml and docker-compose.env files
|
||||
* Start the containers:
|
||||
|
||||
```` bash
|
||||
docker-compose start
|
||||
````
|
||||
|
||||
**Note:** If you are running this on Mac OSX you will probably need to change the default docker-compose.yml file slightly. Specifically, the paths that refer to /var/local/ will likely need to be changed to /opt/
|
||||
|
||||
3. Run the OHIF Viewer or Lesion Tracker using the dcm4cheeDIMSE.json configuration file
|
||||
|
||||
````bash
|
||||
cd OHIFViewer
|
||||
PACKAGE_DIRS="../Packages" meteor --settings ../config/dcm4cheeDIMSE.json
|
||||
````
|
||||
|
||||
## Web Service URLs from DCM4CHEE:
|
||||
Original source here: https://github.com/dcm4che/dcm4chee-arc-light/wiki/Running-on-Docker#web-service-urls
|
||||
|
||||
> - Archive UI: <http://localhost:8080/dcm4chee-arc/ui> - if secured, login with
|
||||
|
||||
> Username | Password | Role
|
||||
> --- | --- | ---
|
||||
> `user` | `user` | `user`
|
||||
> `admin` | `admin` | `user` + `admin`
|
||||
> - Keycloak Administration Console: <http://localhost:8080/auth>, login with Username: `admin`, Password: `admin`.
|
||||
> - Wildfly Administration Console: <http://localhost:9990>, login with Username: `admin`, Password: `admin`.
|
||||
> - Kibana UI: <http://localhost:5601>
|
||||
> - DICOM QIDO-RS Base URL: <http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/rs>
|
||||
> - DICOM STOW-RS Base URL: <http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/rs>
|
||||
> - DICOM WADO-RS Base URL: <http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/rs>
|
||||
> - DICOM WADO-URI: <http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/wado>
|
||||
@@ -0,0 +1,3 @@
|
||||
# DICOM Web
|
||||
|
||||
[DICOMWeb](https://en.wikipedia.org/wiki/DICOMweb) refers to RESTful DICOM Services and is a recently standardized set of guidelines for exchanging medical images and imaging metadata over the internet. Not all archives fully support it yet, but it is gaining wider adoption.
|
||||
@@ -0,0 +1,3 @@
|
||||
# DICOM Message Service Element
|
||||
|
||||
DIMSE Stands for [DICOM Message Service Element](http://dicom.nema.org/medical/dicom/current/output/chtml/part07/chapter_7.html) and is the standard method through which DICOM archives communicate. We support this messaging standard for the retrieval of study, series, and instance metadata because it is widely support. For certain PACS systems, it also (currently) provides faster query results than DICOMWeb.
|
||||
@@ -0,0 +1,3 @@
|
||||
# Connecting to Image Archives
|
||||
|
||||
We support DIMSE and DICOMWeb. Which one to use is up to you and depends on your PACS system. DICOMWeb requires no setup on the PACS-side whatsoever, whereas DIMSE may require you to add the 'OHIFDCM' aeTitle to the known DICOM Modalities of your Archive. This is the case for Orthanc, for example (See https://github.com/OHIF/Viewers/wiki/Orthanc-with-DIMSE).
|
||||
@@ -0,0 +1,33 @@
|
||||
# Orthanc with Docker
|
||||
|
||||
Depending on whether or not you want uploaded studies to persist in Orthanc after Docker has been closed, there are two different methods for starting the Docker image:
|
||||
|
||||
## Temporary data storage
|
||||
This command will start an instance of the jodogne/orthanc-plugins Docker image. *All data will be removed when the instance is stopped!*
|
||||
|
||||
````
|
||||
docker run --rm -p 4242:4242 -p 8042:8042 jodogne/orthanc-plugins
|
||||
````
|
||||
|
||||
## Persistent data storage
|
||||
In order to allow your data to persist after the instance is stopped, you first need to create an image and attached data volume with Docker. The steps are as follows:
|
||||
|
||||
1. Create a persistent data volume for Orthanc to use
|
||||
|
||||
````
|
||||
docker create --name sampledata -v /sampledata jodogne/orthanc-plugins
|
||||
````
|
||||
|
||||
**Note: On Windows, you need to use an absolute path for the data volume, like so:**
|
||||
|
||||
````
|
||||
docker create --name sampledata -v '//C/Users/erik/sampledata' jodogne/orthanc-plugins
|
||||
````
|
||||
|
||||
2. Run Orthanc from Docker with the data volume attached
|
||||
|
||||
````
|
||||
docker run --volumes-from sampledata -p 4242:4242 -p 8042:8042 jodogne/orthanc-plugins
|
||||
````
|
||||
|
||||
3. Upload your data and it will be persisted
|
||||
@@ -0,0 +1,3 @@
|
||||
# Example: Osirix
|
||||
|
||||
...
|
||||
@@ -0,0 +1,32 @@
|
||||
# Contributing
|
||||
|
||||
### I would like to contribute code - how do I do this?
|
||||
|
||||
Fork the repository, make your change and submit a pull request.
|
||||
|
||||
### Any guidance on submitting changes?
|
||||
|
||||
While we do appreciate code contributions, triaging and integrating contributed code changes can be very time consuming. Please consider the following tips when working on your pull requests:
|
||||
|
||||
- Functionality is appropriate for the repository. Consider posting on the forum if you are not sure.
|
||||
- Code quality is acceptable. We don't have coding standards defined, but make sure it passes ESLint and looks like the rest of the code in the repository.
|
||||
- Quality of design is acceptable. This is a bit subjective so you should consider posting on the forum for specific guidance.
|
||||
- The scope of the pull request is not too large. Please consider separate pull requests for each feature as big pull requests are very time consuming to understand.
|
||||
|
||||
We will provide feedback on your pull requests as soon as possible. Following the tips above will help ensure your changes are reviewed.
|
||||
|
||||
### Testing contribution pull requests
|
||||
|
||||
OHIF uses [netlify](netlify.com) so that pull requests are autogenerated and available for testing.
|
||||
|
||||
For example, [this url](https://deploy-preview-237--ohif.netlify.com/viewer/?url=https://s3.eu-central-1.amazonaws.com/ohif-viewer/sampleDICOM.json) allows you to test [pull request 237, the request that created this FAQ entry,](https://github.com/OHIF/Viewers/pull/237) using data pulled from Amazon S3.
|
||||
|
||||
Replacing the number 237 in the link below with your pull request number should let you test it as well and you can use this link for discussions on github without requiring reviewers to download and build your branch.
|
||||
```
|
||||
https://deploy-preview-237--ohif.netlify.com/viewer/?url=https://s3.eu-central-1.amazonaws.com/ohif-viewer/sampleDICOM.json
|
||||
```
|
||||
|
||||
If you have made a documentation change, a link like this will let you preview the gitbook generated by the pull request:
|
||||
```
|
||||
https://deploy-preview-237--ohif.netlify.com/contributing.html
|
||||
```
|
||||
@@ -0,0 +1,5 @@
|
||||
# Data Hierarchy
|
||||
|
||||
## Studies, Series, Instances, Frames
|
||||
|
||||
## Display Sets
|
||||
@@ -0,0 +1,5 @@
|
||||
# Image Viewport
|
||||
|
||||
### Main Viewport Component
|
||||
|
||||
The [imageViewerViewport](https://github.com/OHIF/Viewers/tree/master/Packages/ohif-viewerbase/client/components/viewer/imageViewerViewport) component
|
||||
@@ -0,0 +1 @@
|
||||
# Measurements and Annotations
|
||||
@@ -0,0 +1 @@
|
||||
# Tool Management
|
||||
@@ -0,0 +1,152 @@
|
||||
# Building for Production
|
||||
|
||||
**This tutorial considers the current folder as `OHIFViewer/`**.
|
||||
|
||||
### Dependencies
|
||||
|
||||
First, you need to have installed:
|
||||
|
||||
- [Node.js](https://nodejs.org/) and [NPM](https://www.npmjs.com/)
|
||||
- [Meteor](https://www.meteor.com/)
|
||||
- [MongoDB](https://www.mongodb.com/)
|
||||
|
||||
**MongoDB** is actually **not required** if you have a **remote MongoDB**. If your database is **local** then you need to have it running.
|
||||
|
||||
### Check your packages
|
||||
|
||||
Inside of the viewer folder make sure NPM packages are updated for production:
|
||||
|
||||
```bash
|
||||
npm install --production
|
||||
```
|
||||
|
||||
### Building
|
||||
|
||||
There are two ways of building OHIF Viewer for a specific DICOM server: **Automatically** or **Manually**.
|
||||
|
||||
For both, we use the `meteor build` (check it's [docs](https://guide.meteor.com/deployment.html#custom-deployment)) app and **Orthanc Dicom Web Server**.
|
||||
|
||||
For `meteor build` it's necessary to inform an output folder `myOutputFolder`.
|
||||
**Remember to change `myOutputFolder` to your folder location.**
|
||||
|
||||
OHIF Viewer will be built using **Orthanc DICOM Web server** configuration file `../config/orthancDICOMWeb.json` to set `METEOR_SETTINGS` environment var.
|
||||
|
||||
*To run with another server, just point to the corresponding `.json` located in `config` folder or create your own.*
|
||||
|
||||
#### Build automatically
|
||||
|
||||
After this step, go directly to [Prepare to run production build](#prepare-to-run-production-build).
|
||||
|
||||
##### Non-windows users
|
||||
|
||||
```bash
|
||||
METEOR_PACKAGE_DIRS="../Packages" METEOR_SETTINGS=$(cat ../config/orthancDICOMWeb.json) meteor build --directory myOutputFolder
|
||||
```
|
||||
|
||||
##### Windows users
|
||||
|
||||
Since there is no `cat` command in Windows `cmd`, use Windows `PowerShell` (at least version 3.0) instead.
|
||||
|
||||
In `PowerShell`, open a new shell as an `admin`:
|
||||
|
||||
```bash
|
||||
Start-Process powershell -Verb runAs
|
||||
```
|
||||
|
||||
Then:
|
||||
|
||||
**Remember to change `OHIFViewerFolderLocation` to OHIFViewer's folder location.**
|
||||
|
||||
```bash
|
||||
cd OHIFViewerFolderLocation
|
||||
$settings = Get-Content ..\config\orthancDICOMWeb.json -Raw
|
||||
$settings = $settings -replace "`n","" -replace "`r","" -replace " ",""
|
||||
[Environment]::SetEnvironmentVariable("METEOR_SETTINGS", $settings, "Machine")
|
||||
SET METEOR_PACKAGE_DIRS="../Packages"
|
||||
meteor build --directory myOutputFolder
|
||||
```
|
||||
|
||||
#### Build manually
|
||||
|
||||
OHIF Viewer will be built normally, but with no DICOM Server information, which needs to be added when running the build. This is described in [Manually adding DICOM Server to the Viewer](#manually-adding-dicom-server-to-the-viewer).
|
||||
|
||||
##### Non-windows users
|
||||
|
||||
```bash
|
||||
METEOR_PACKAGE_DIRS="../Packages" meteor build --directory myOutputFolder
|
||||
```
|
||||
|
||||
##### Windows users in `cmd`
|
||||
|
||||
```bash
|
||||
SET METEOR_PACKAGE_DIRS="../Packages"
|
||||
meteor build --directory myOutputFolder
|
||||
```
|
||||
|
||||
### Prepare to run production build
|
||||
|
||||
If everything went ok, `meteor build` created a `bundle` folder inside `myOutputFolder`.
|
||||
|
||||
**Remember to change `myOutputFolder` to your folder location.**
|
||||
|
||||
Go to that folder:
|
||||
|
||||
```bash
|
||||
cd myOutputFolder/bundle
|
||||
```
|
||||
|
||||
Now install the **NPM dependencies**:
|
||||
|
||||
```bash
|
||||
cd programs/server
|
||||
npm install
|
||||
```
|
||||
|
||||
### To run production build
|
||||
|
||||
Go back to the `bundle` folder:
|
||||
|
||||
```bash
|
||||
cd ../..
|
||||
```
|
||||
or (**Remember to change `myOutputFolder` to your folder location.**):
|
||||
|
||||
```bash
|
||||
cd myOutputFolder/bundle
|
||||
```
|
||||
|
||||
3 environment variables are set before running Node.js:
|
||||
- `MONGO_URL`: is the url to MongoDB. If it's **local**, you need to have it running
|
||||
- `ROOT_URL`: the hostname where you can access your Viewer in the browser
|
||||
- `PORT`: the port the Viewer will run
|
||||
|
||||
This way, the Viewer can be accessed in `http://localhost:3000`, with MongoDB running locally using 27017 port (it's default).
|
||||
|
||||
##### Non-windows users
|
||||
|
||||
```bash
|
||||
MONGO_URL=mongodb://localhost:27017/myapp ROOT_URL=http://localhost PORT=3000 node main.js
|
||||
```
|
||||
|
||||
##### Windows users in `cmd`
|
||||
|
||||
```bash
|
||||
SET MONGO_URL=mongodb://localhost:27017/myapp
|
||||
SET ROOT_URL=http://localhost
|
||||
SET PORT=3000
|
||||
node main.js
|
||||
```
|
||||
|
||||
### Manually adding DICOM Server to the Viewer
|
||||
|
||||
If DICOM Server was configured automatically during the building process, skip this step.
|
||||
|
||||
Access the viewer `http://localhost:3000` and toggle the **Options** menu, located at top right corner. Select **Server Information** option.
|
||||
|
||||
In **Server Information** dialog click on **Add a new server** button and fill the fields accordingly to the DICOM Server to be added.
|
||||
|
||||
In case of doubts about any field in this dialog, use `config/orthancDICOMWeb.json` as reference.
|
||||
|
||||
After filling the form, click on the **Save** button and the new server will be listed. Make sure to activate it by clicking on the left most button (a checkbox button) in the **Actions** column.
|
||||
|
||||
Refresh the page and Viewer will be connected to the DICOM Server.
|
||||
@@ -0,0 +1 @@
|
||||
# Security
|
||||