-------------------------------------------------------------------------------
Preamble
-------------------------------------------------------------------------------
Hardware, software and results generated from testing the performance of a bone
segmentation algorithm implemented in both hardware and software for segmenting
bone in medical images.

The bone segmentation algorithm used was one described by Haas et al.
(doi: 10.1088/0031-9155/53/6/017). The algorithm was implemented in full in
software and a simplified version was developed for hardware implementation,
which was implemented in both hardware and software.

The software algorithms were executed on a 2.6GHz Intel Core i5-3230M CPU,
while the hardware system was implemented on a Xilinx Zynq Z7020 device on an
AvNet ZedBoard development board.

3D image data in the form of computed tomography (CT) and cone beam CT (CBCT)
scans of patients receiving external beam radiotheray for bladder cancer were
obtained from Edinburgh Cancer Centre (n=132) and used as the input data.

The time taken to process each image volume and each slice of each image volume
was recorded for each of the three implementations.

-------------------------------------------------------------------------------
Inventory
-------------------------------------------------------------------------------
    hls.zip:        contains scripts used to generate the IP cores in the ip
                    directory from the C++ source code in the ip_src directory

    input_data.zip: contains a description of the image data used as input to
                    generate the results in the results directory. The image
                    data itself is not included as it was obtained from 
                    Edinburgh Cancer Centre under terms prohibiting its further
                    sharing.

    ip.zip:         contains the IP cores used in the system and generated from
                    the C++ source code in the ip_src directory

    ip_src.zip:     contains C++ source code used to synthesise the IP cores in
                    the ip directory and used in the system

    sw.zip:         contains C++ source code used to generate the software 
                    results for comparison with the performance of the hardware
                    system

    vivado.zip:     contains a TCL script to recreate the hardware system used
                    to produce this data using Xilinx Vivado v.2017.2; also 
                    contains the software application run on that system to
                    produce this data