read_BioRad_PIC

Synopsis

Reads a Bio-Rad PIC file and outputs a uniform scalar field.

Parameters

Name Type Description UI Control

filename string name of the PIC file to be loaded UIfiledialog

Output Port

Name Type Description

out_fld Mesh_Unif+Node_Data output field containing the data in the PIC file.
out_obj DataObject directly renderable output object.

Description

This module reads a Bio-Rad PIC file specified by the user via a file browser, and outputs a field corresponding to the data in the file. Bio-Rad PIC files contain 3D confocal microscope images, i.e. 3D scalar uniform fields. read_BioRad_PIC outputs a 3D scalar uniform field and a renderable version of the field.

This module performs the byte reordering necessary for it to work correctly on either big or little endian platforms.

Parameters

filename

The filename of the Bio-Rad PIC file that should be read.

Output Ports

out_fld

The output 3D scalar uniform field generated from the data in the Bio-rad PIC file.

out_obj

The directly renderable output of the read_BioRad_PIC macro. This contains a DataObject object that can be rendered by the standard data viewers.

Utility Macros

The User Macro read_BioRad_PIC combines the Functional Macro Read_BioRad_PIC and the User Interface Macro Read_PIC_UI. In turn the Functional Macro Read_BioRad_PIC combines the low-level module read_PIC_core with the field mapping module, scalar_uniform_field.

Example

An example application Read_BioRad_PIC_Eg is provided that reads a Bio-Rad PIC file and produces a maximum intensity projection. A sample Bio-Rad PIC file, flea3.pic, is provided with the distribution of this module.

Files

iac_proj/PIC_IO/pio_macs.v contains the User Macro read_BioRad_PIC, the Functional Macro Read_BioRad_PIC, the User Interface Macro Read_PIC_UI and the Example Application Read_BioRad_PIC_Eg.

Other Notes

The read_BioRad_PIC macro does not check that the file specified by the user is a valid Bio-Rad PIC file. If it is not then errors can occur.

The read_BioRad_PIC macro ignores notes, which are sometimes appended to PIC files.

The read_BioRad_PIC macro will only handle 8-bit images. 16-bit and 24-bit images are not handled correctly.

The AVS5 module read_BioRad_PIC (available from the IAC) can also be used to read Bio-Rad PIC files.

This project does not contain any C or Fortran code and hence does not need to be compiled.

Author

<A HREF="http://www.cs.uwa.edu.au/~chrisp">Chris Pudney</A>
Biomedical Confocal Microscopy Research Centre
<A HREF="http://www.pharm.uwa.edu.au">Department of Pharmacology</A>
<A HREF="http://www.uwa.edu.au">The University of Western Australia</A>
Nedlands, W.A. 6907
AUSTRALIA
E-mail:<A HREF="mailto:cpudney@alphapharm.pharm.uwa.edu.au">cpudney@alphapharm.pharm.uwa.edu.au</A>
Phone, Fax: (+61 8) 9346 4571, (+618) 9346 3469

Modifications

Rob Fletcher, Andrew Dodd

Contact

International AVS Centre
Manchester Visualization Centre
Manchester Computing
University of Manchester
Oxford Road
Manchester
United Kingdom
M13 9PL

See Also

read_PIC_core, read_BioRad_PIC (AVS5 IAC module)