Read DICOM Project
------------------

The Read DICOM project allows DICOM V3 files to be read into AVS/Express.
It is based on the Papyrus 3.71 toolkit developed by the Digital Imaging Unit
of the University Hospital of Geneva.  The Papyrus 3 file format is an
implementation of the DICOM V3 standard file format.  The Papyrus toolkit
was developed to allow this implementation to be read.  More information can
be found at http://www.expasy.ch/UIN/html1/projects/papyrus/papyrus.html.
The Digital Imaging Unit can be found at http://www.expasy.ch/UIN/.

The source code of the Papyrus 3.71 toolkit is supplied and fully integrated 
in the Project.

Installation Instructions
-------------------------

This directory ( iac_proj/rd_dicom/ ) contains all the V code, HTML
documentation, and installation information for the Read DICOM
project "ReadDicom".

The directory should be placed into your existing project directory, which
should already contain the IAC Project File structure, i.e., the iac_proj/,
iac_lib/ and v/ directories.

The file INSTALL contains information on how to edit the existing IAC
files: a single line addition to the iac_proj/iac_proj.v file, to add
the new project, and two single line additions to two of the iac_lib/
files (in this instance data_io.v and examples.v) to add a link to the
User Macro and the Example Application from the top-level IAC
library page.

Once the files have been correctly installed, the low-level module of the new
project must be compiled. If you opt to leave the process unspecified, it will
by default use the "express" process. Doing so means the module may be
compiled by using one of the following commands in the top-level directory of
your project (whilst AVS/Express is not running):

	base -comp_proc express -exit
or
	make -f express.mk

Using the 'make' command, requires that the express.mk file already
exists, and has been updated accordingly.

If you modify the ReadDicom project, and elect to specify the process
as "user" or another user-defined process, then the module may be compiled
without having to exit the AVS/Express application. Use the following command
in the VCP to compile the module:

	$compile IAC_PROJ.ReadDicom.ReadDicomMods

Users of the Developer's Edition may select the module in the 
relevant Templates library, and choose 'compile' from the Project menu.


Files
-----

The following files can be found in the iac_proj/thresh/ directory.

INSTALL 	Contains installation instructions for editing the iac_proj.v
		and iac_lib/ data_io.v and examples.v files. This file should
		not be edited as the future installation script will use this
		file.

rd_dicom.c      Contains all the C code for this module.

Papyrus3/*	Source and header files of the Papyrus 3.71 toolkit including all
		the necessary Makefiles to generatr the Papyrus library.

rd_dicom.v      Creates the IAC_PROJ.ReadDICOM library.

rddidata.v 	Creates the ReadDICOMData library containing the definitions 
		of the groups Patient, General_Study, General_Series, Image_Series, 
		General_Equipment, DICOM_Header and DICOM_Volume.
		
rddilib.v 	Creates the ReadDICOMLib library that integrates the Papyrus 3.71
		toolkit.
		
rddimods.v 	Creates the ReadDICOMMods library containing the low-level
		module read_DCMLIST  and read_dicom_files.

rddimacs.v	Creates the ReadDicomMacs library containing the user
		macro ReadDICOM and the UI macros ReadDICOMPatientUI, 
		ReadDICOMStudyUI, ReadDICOMSeriesUI, ReadDICOMEquipmentUI and 
		ReadDCMLISTUI.
 
rddimacs.v	Creates the ReadDicomApps library containing the example
		applications ImageDicomEg, TileDicomEg and IsosurfaceDicomEg.

doc_mod.html	HTML documentation for the read_DCMLIST and 
		read_dicom_files module.

doc_umac.html	HTML documentation for the ReadDICOM User Macro.

changes.html	HTML documentation for the changes to previous ReadDICOM 
		versions.

COPYRIGHT	Copyright notice.

README		This file.


Generated Files
---------------

When the project is compiled, the following files will be generated. Once
completed, you may safely remove these files; any future recompilations
will regenerate these files.

gen.h		AVS/Express generated header file.

gen.cxx		AVS/Express generated source code.

rd_dicom.obj	Intermediate object file.

gen.obj		Intermediate object file.

