The Raw Converter allows the conversion of raw binary data into one of the supported multi-slice image formats.
To convert images select
Raw Data Converter ...
File menu: .
The Raw Converter window will now appear:
The Raw Converter allows you to create one single-slice or multi-slice image from one or more input files. Each of the input files may contain pixel values for one or more slices of the output image.
First, select the input file(s) from which the pixel values will be extracted by pressing the button. A file chooser will now pop up. To select more than one input file, follow the instructions in the file chooser description.
Next select the type of binary data in your input files. If you select the wrong type for your data, the resulting images will be unusable. Choose:
Bytefor signed 8-bit integer data.
Ubytefor unsigned 8-bit integer data.
Shortfor signed 16-bit integer data.
UShortfor unsigned 16-bit integer data.
Intfor signed 32-bit integer data.
Uintfor unsigned 32-bit integer data.
Longfor signed 64-bit integer data.
RGBfor red,green,blue 3×8-bit data.
BGRfor blue,green,red 3×8-bit data.
Floatfor 32-bit floating point data.
Doublefor 64-bit floating point (double precision) data.
Next select the byte order for the input data, either:
Little Endianfor data typically originating on a PC (MS Windows or Linux or Intel-based Macintosh).
Big Endianfor data typically originating on a Sun/SPARC or SGI workstation.
Note: the actual byte order depends not only on the type of computer, but also on the software it runs to produce the image data. If you're not sure of the binary format or byte order of your data, contact the person from whom the data originated, or the manufacturer of the equipment that produced the data (or just experiment with Jim).
If the pixel values do not start at the beginning of your binary
input files, or if there is additional data between the data for
individual slices, then enter the data offsets (in bytes) in the
Data offset fields:
In the example above, the data for the first slice of the image starts at an offset of 1024 bytes into the input files(s), and there are 512 bytes of non-image data between slices in the input file(s). If each file contains only one slice of image data, then the second offset value is ignored.
Now tell the Raw Converter how to combine the input data into images. Specify:
The number of slices is detected automatically.
or the pixel sizes directly:
In this example Jim is being told either that pixels are 0.96 mm square, or that the field of view is 250 mm square.
Now choose the format of the image to be created. Select:
"Auto", then Jim will choose the most appropriate pixel type. If you choose a pixel type that is incompatible with the sort of raw input data, then an error will appear. If you choose a pixel type that is not supported by the file format of the output image, then an error will also appear.
Raw Converterwhat imaging plane your data is most like (Axial, Sagittal or Coronal). If you don't know, don't care, or there are various imaging planes in the data, leave this as
When ready, press the button to begin conversion of your raw data files.
Depending on whether your selection , the converted image will either be loaded into Jim, or a file chooser will pop up for you to enter an file name for the new image.
Depending on the datatype you have selected for the output image, you may receive a pop-up message warning that the input data may need to be clipped to fit into the data range of the output image. For example, if you select Short as the input datatype, and UByte as the output pixel type, then you will see:
Since short (16-bit) values range from -32768 to 32767, it is not possible to store these within the range of unsigned byte values (range: 0 to 255). If "Clip if necessary" is selected, the pixel values in the input data above 255 will be set to a value of 255, and those below 0 will be set to 0 in the output image.
Click the button when you have finished with the Raw Converter.