Mercurial > hg > orthanc-book
diff Sphinx/source/faq/matlab.rst @ 34:922f5c7192c6
matlab
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Wed, 20 Jul 2016 14:18:47 +0200 |
parents | |
children | cb712e9d9187 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Sphinx/source/faq/matlab.rst Wed Jul 20 14:18:47 2016 +0200 @@ -0,0 +1,43 @@ +Interfacing with Matlab and Octave +================================== + +Thanks to the REST API of Orthanc, it is easy to access DICOM images +from Matlab or Octave, as depicted in the following sample image: + +.. image:: ../images/Matlab.png + :align: center + :width: 470px + +Both Matlab and Octave have access to HTTP servers thanks to their +built-in `urlread() function +<http://nl.mathworks.com/help/matlab/ref/urlread.html>`__. Once must +simply install a Matlab/Octave library to decode JSON files. The +`JSONlab toolkit +<http://www.mathworks.com/matlabcentral/fileexchange/33381-jsonlab--a-toolbox-to-encode-decode-json-files>`__ +works perfectly to this end. + +.. highlight:: matlab + +Using JSONlab, the following code will download and display a DICOM image:: + + SERIES = 'ae164c84-e5bd0366-ba937a6d-65414092-f294d6b6'; + URL = 'http://orthanc.chu.ulg.ac.be/demo'; + + # Get information about the instances in this DICOM series + instances = loadjson(urlread([ URL '/series/' SERIES '/instances' ])); + + # Select one slice from the series + instance = instances{1,1}.ID + + # Decode the slice with Orthanc thanks to the "/matlab" URI + slice = eval(urlread([ URL '/instances/' instance '/matlab' ])); + + # Compute the maximum value in this slice + max(max(slice)) + + # Display the slice + imagesc(slice) + + # Annotate the graph with the patient name and ID + tags = loadjson(urlread([ URL '/instances/' instance '/tags?simplify' ])); + title([ 'This is a slice from patient ' tags.PatientID ' (' tags.PatientName ')' ])