Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Library for reading, editing and writing DICOM files, as well as handling DICOM network communication. Written in the Ruby language.
tag: v0.7

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
CHANGELOG
COPYING
DOCUMENTATION
README
rakefile.rb

README

RUBY DICOM
======================

SUMMARY
--------

This is a small and simple library for handling DICOM in Ruby. DICOM (Digital Imaging
and Communications in Medicine) is a standard for handling, storing, printing,
and transmitting information in medical imaging. It includes a file format definition
and a network communications protocol. Ruby DICOM supports reading from, editing and
writing to this file format. It also features experimental support for network
communication modalities like query, move, sending and receiving files.

BASIC USAGE
-----------

require "dicom"
# Read file:
dcm = DICOM::DObject.new("myFile.dcm")
# Display some key information about the file:
dcm.print_properties()
# Print all tags to screen:
dcm.print(true)
# Retrieve a data element value:
name = dcm.get_value("0010.0010")
# Retrieve pixel data:
pixels = dcm.get_value("7FE0.0010")
# Load pixel data to a RMagick object and display it on screen:
image = dcm.get_image_magick()
image[0].display
# Load pixel data to a NArray object and display it on screen:
image = dcm.get_image_narray()
NImage.show image[0,true,true]
# Send a local file to a server (PACS) over the network:
node = DICOM::DClient.new("10.1.25.200", 104)
node.send("myFile.dcm")

Tip:
When playing around with Ruby DICOM in irb, you may be annoyed
with all the information that is printed to screen, regardless
if you have specified verbose as false. This is because in irb
every variable loaded in the program is automatically printed.
A hack to avoid this effect is to append ";0" after a command.
Example:
dcm = DICOM::DObject.new("myFile.dcm") ;0

COPYRIGHT
---------

Copyright 2008-2010 Christoffer Lervåg

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.


ABOUT ME
--------

Name:
Christoffer Lervåg

Location:
Oslo, Norway

Email:
chris.lervag [@nospam] @gmail.com
Please don't hesitate to email me if have any thoughts about this project!

Something went wrong with that request. Please try again.