Swepy is a basic user interface to load and analyse shear wave elastography files recorded with Hologic Supersonic machines.
The script works with DICOM files and is optimised for Mach30 machines but should work with other machines from the Mach range. Scans from Aixplorer machines also seem to be compatible but have not yet been tested thoroughly.
The analysis currently consists in a graphical preview of the elastography measurements for each frame (violin plots), and calculations of mean and median values.
Results can be exported to a csv or xlsx file.
NB: For now, the analysis only works for cine loops.
The scripts run with Python 3.8. All package dependencies are listed in requirements.txt.
- Clone this repository
- Install dependencies
- Run the
swepy/start.pyfile to start the user interface - Load a DICOM file containing an image sequence (generally a video clip, takes a few seconds)
- Enter the following parameters found on the image frame:
- acquisition frequency of SWE frames (
SWE fhzparameter) - maximal scale value (
max. scaleparameter, in kPa or m/s)
- acquisition frequency of SWE frames (
- (optional) Change ROI size or shape
- Press
Analyse - Find results preview and export interface in the
Resultstab.
- Export to a
csvorxlsxfile
I am grateful to Neil Cronin (University of Jyväskylä) for his input early in the project.
I also thank Valentin Doguet, Antoine Nordez and Aurélie Sarcher (Nantes Université) for sharing their experience and views,
based on the development or utilisation of the excellent ElastoGUI.
swepy is a project developed at the Norwegian School of Sport Sciences. If needed, this code can be referenced from the cff file of this repository, or as follows:
@software{Seynnes_swepy_2023,
author = {Seynnes, Olivier},
license = {MIT},
month = apr,
title = {{swepy}},
url = {https://github.com/oseynnes/swepy},
year = {2023}
}