===========================================
IsenDose: Patient CT Dose Monitoring Server
===========================================

-------------
Introduction:
-------------

Description: 
- System for storing Patient CT radiation dose information into a searchable database.

Requirements:
- Orthanc (tested on 0.8.6)
- Webserver + PHP (tested on Bitnami WAPP stack)
- External router (tested on Syngo.Via)

Workflow:
- External router receives patient protocol series from CT scanner
	* SIEMENS: Series Description == Patient Protocol
	* TOSHIBA: (No identifying information - as far as I can tell)
	* PHILIPS: NOT SUPPORTED
	* GE: Series Description == Dose Report
- External router sends ONLY the patient protocol series to Orthanc
- Orthanc calls a LUA script that activates storeDoseData.php with instance{id} (storeDoseData.php?instance={id})
- storeDoseData.php retrieves relevant metadata through /simplified-tags (patient name, id, etc)
- storeDoseData.php retrieves totalDLP:
	* SIEMENS: Performs OCR on 6000-3000 (overlay data)
	* TOSHIBA: Performs OCR on 7fe0-0010 (pixel data)
	* PHILIPS: NOT SUPPORTED
	* GE: Retrieves TotalDLP from 0040-0310
- storeDoseData.php stores in text-based data file in CSV format
- User browses dose.php (front-end to the data file) - Filtering is possible.
- viewer.php will return PNG file:
	* SIEMENS: Created from scratch using 6000-3000 (overlay data)
	* TOSHIBA: Orthanc /preview
	* PHILIPS: NOT SUPPORTED
	* GE: Orthanc /preview
	
-----------------------------
Installation & Configuration:
-----------------------------

* NOTE: ONLY FULLY TESTED ON A SIEMENS CT SCANNER. SUPPORT FOR TOSHIBA & GE ARE PRESENT BUT UNTESTED. 
	PHILIPS AND OTHERS ARE NOT SUPPORTED UNTIL SOMEBODY CAN SEND ME SOME SAMPLE FILES. *

- Install Orthanc, webserver + php

- Copy storeDoseData.php, viewer.php and dose.php to web folder (e.g. htdocs\dose)

- Edit $orthanc in storeDoseData.php and viewer.php

- Edit $dataFile in storeDoseData.php and dose.php (You may need to create an empty textfile with proper permissions for this step.)

- Copy storeDoseData.lua to Orthanc folder

- Edit storeDoseData.lua to point to your web folder:

	(e.g. local answer = HttpGet('http://localhost/dose/storeDoseData.php?instance=' .. instanceId))

- Edit configuration.json:

	"LuaScripts" : [
		"./storeDoseData.lua"

	],


- Restart Orthanc

- Browse to dose.php (e.g. http://localhost/dose/dose.php)

--------
Support:
--------
Orthanc Google Group: https://groups.google.com/forum/#!forum/orthanc-users

IsenDose developed by Emsy Chan. Free for non-commercial use.