A Python package designed to estimate the temperature increase due to high intensity focused ultrasound (HIFU) excitation
Project description
TEMP4HIFU
Author: Gerald Lee
Final Project, BIOEN 537: Computational System Biology. University of Washington, Seattle
A Python package designed to estimate the temperature increase due to high intensity focused ultrasound (HIFU) excitation.
BACKGROUND
High Intensity Focused Ultrasound (HIFU) and Focused Ultrasound (FUS) are used for thermal treatment of cells such as for cancer treatment. The generated increase of temperature during HIFU thermal treatment must be within safety guidelines for human use (44 degrees Celsius), which is essential for FDA approval and compliance. Accurate predictions of temperature bioeffects must be demonstrated through computational simulations before applications ex vivo and in vivo. Computational simulations requires modeling for both HIFU/FUS pressure fields and then the Bioheat equation; not complicated individually, but when combined can be tricky to navigate based on initial conditions.
Provided here is a tool to estimate bioheat from HIFU, usable as a GUI or importable as functions for integration with other code. The GUI provides an entry-friendly visualization of many aspects of bioheat due to HIFU. In this package, the heat input generated by HIFU is governed by the pressure output by the ultrasound transducer defined in the cylindrical space. The bioheat model solution is governed by a Forward Time Centered Space (FTCS) finite element model. The given assumptions are that the system is axissymetric and linear in nature, and the bioheat equation does not consider blood perfusion and assumes heat propagates instantaneously.
INSTALLATION AND USE
pip install temp4hifu
PRE-REQUISITES
Ensure you have the following additional Python packages installed into your machine: 1. numpy 2. pandas 3. dash Please pip install these packages as well.
GUI
SEE EXAMPLE SCRIPTS import temp4hifu.startApp temp4hifu.startApp
Then follow the server link to view the application. NOTE: To kill the app in terminal, CTRL+C
INDIVIDUAL FUNCTIONS
SEE EXAMPLE SCRIPTS from temp4hifu import setParam, calculateBioheat, calculateRayleighIntegral setParam.setMedium(INPUT_ARG) calculateRayleighIntegral.generateField(INPUT_ARG) calculateBioheat.generateVector(INPUT_ARG)
GUI COMPONENTS AND FUNCTION NOTES
The GUI is able to perform and sustain the following actions:
- Graph a 2D Pressure Field in cylindrical coordinate space of given transducer and medium properties.
- Display the 2D graph as a pressure or an intensity based on a given initial pressure.
- Graph a 1D Temperature Vector over Time for a given transducer, medium, heating scheme, and FTCS model.
- Load premade CSV files for graphing and computation of the above.
- Calls on the three other module functions as listed below
The function setParam.setMedium provides a small list of propagation media to select from as a preset, as well as provides custom input as needed. The export is either a preset dictionary of the properties for Water, Glycerol, Egg White, or Castor Oil, or a custom dictionary of values of the user's choosing.
The function calculateRayleighIntegral.generateField allows the calculation of a pressure field using the Rayleigh Integral in cylindrical coordinate (Z,R) space, and outputs a 2D list of pressure values, a 1D list of Z-axis values, and a 1D list of R-axis values.
Using the outputs from the first function, the function calculateBioheat.generateVector allows for the calculation the temperature based on a heating and cooling scheme for at a specific point in the (Z,R) space, and outputs a 1D list of temperature values and a 1D list of time values. Optionally, this function also exports the 2D list of heat Q, calculated based on the intensity from the pressure field and the parameters given previously.
Author's Notes
This package was intended to include addtional components such as different models to calculate pressure (the KZK and Westervelt equations) in the nonlinear space. Accompanying this, would be more complicated bioheat models that would better represent the temperature propagating through the human body. Due to the limited scope of the project, the package was designed for linear use only.
RESOURCES
Github Link == https://github.com/C2H5OH-Consumer/temp4hifu Contains Sample Scripts using Juypter: sampleScript_loadFunctions.ipynb sampleScript_loadGUI.ipynb
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file temp4hifu-0.1.3.tar.gz.
File metadata
- Download URL: temp4hifu-0.1.3.tar.gz
- Upload date:
- Size: 12.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.0.1 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c90881339186838b64991c9d5652d16b2aaa7baa6152937067c08114c651db8a
|
|
| MD5 |
ae02fb9c427f938c8b1cc7c313fe4370
|
|
| BLAKE2b-256 |
60ba7104873f40347813821ca740b6426e8ebc6969a9ae546bf0707a336c2436
|
File details
Details for the file temp4hifu-0.1.3-py3-none-any.whl.
File metadata
- Download URL: temp4hifu-0.1.3-py3-none-any.whl
- Upload date:
- Size: 12.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.0.1 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6e385284a31a337579c34028a7b4ead8edc8cfc8d2e9c313fc989b4db96a4224
|
|
| MD5 |
0854cc11e334aaf06abfed17ac5c148f
|
|
| BLAKE2b-256 |
50f85fad64dbc1a9773c398ebffba2f02f4b839d3344be5afb793e895dd09bcf
|