Skip to main content

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:

  1. Graph a 2D Pressure Field in cylindrical coordinate space of given transducer and medium properties.
  2. Display the 2D graph as a pressure or an intensity based on a given initial pressure.
  3. Graph a 1D Temperature Vector over Time for a given transducer, medium, heating scheme, and FTCS model.
  4. Load premade CSV files for graphing and computation of the above.
  5. 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

temp4hifu-0.1.3.tar.gz (12.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

temp4hifu-0.1.3-py3-none-any.whl (12.0 kB view details)

Uploaded Python 3

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

Hashes for temp4hifu-0.1.3.tar.gz
Algorithm Hash digest
SHA256 c90881339186838b64991c9d5652d16b2aaa7baa6152937067c08114c651db8a
MD5 ae02fb9c427f938c8b1cc7c313fe4370
BLAKE2b-256 60ba7104873f40347813821ca740b6426e8ebc6969a9ae546bf0707a336c2436

See more details on using hashes here.

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

Hashes for temp4hifu-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 6e385284a31a337579c34028a7b4ead8edc8cfc8d2e9c313fc989b4db96a4224
MD5 0854cc11e334aaf06abfed17ac5c148f
BLAKE2b-256 50f85fad64dbc1a9773c398ebffba2f02f4b839d3344be5afb793e895dd09bcf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page