Skip to main content

Python based interface module for communication with the ScioSpec Electrical Impedance Tomography (EIT) device.

Project description

sciopy

This package offers the serial interface for communication with an EIT device from ScioSpec. Commands can be written serially and the system response can be read out. With the current version, it is possible to start and stop measurements with defined burst counts and to read out the measurement data. In addition, the measurement data is packed into a data class for better further processing.

Install Requirements

All requirements are provided inside the requirements.txt. To install them navigate inside the sciopy directory and type:

pip3 install -r requirements.txt # Linux, macOS, Windows
pip install -r requirements.txt  # Windows

Run Example Script

For a single measurement, you can simply run the example scripts using the command:

python measurement_n_el_16.py

This script establishes a serial connection to the ScioSpec device, sends the measurement configuration, and starts a measurement with a burst count of 10. For a successful measurement, you have to plug in the 16 electrodes to the port "channel 1-16" at the ScioSpec device. For saving the data, set save = True and insert a valid s_path to the scio_spec_measurement_config at the beginning of the script.

The second provided example script prep_data_for_ml.py can be used for the conversion of a finished measurement. This script creates a new folder with the ending _prepared and puts together the potential values and object positions for all measurements. This could be useful for later application of machine learning.

Explanation of stored files (.npz)

  • potential matrix (e.g. variable P) is a 16x16 matrix (n_el=16). If you visualize it using from sciopy import plot_potential_matrix you can recognize the used excitation pattern or if an electrode is a defect.
  • p_with_exc is the matrix P with the excitation electrodes
  • p_without_exc is the matrix P without the excitation electrodes
  • abs_p_norm_without_ext is the matrix, normalized between (I think) 0-1 without the excitation electrodes.
  • v_with_ext is the computed voltage from the potential values containing the excitation electrodes
  • v_without_ext is the computed voltage from the potential values without the excitation electrodes
  • abs_v_norm_without_ext is the voltage data, normalized between 0-1 without the excitation electrodes.
  • config contains some information regarding the measurement procedure.

TBD

  • Communication using LAN connection.
  • Measurements using 48, 64 electrodes.
  • Adjacent and opposite injection pattern combination.
  • Measurements using 32 electrodes.
  • Parsing measurements of 32 electrodes.
  • Adjacent and opposite drive patterns for 32 electrodes.
  • Measurement using 16 electrodes in opposite and adjacent injection pattern.

Contact

Email: jacob.thoenes@uni-rostock.de

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

sciopy-0.6.4.8-py3-none-any.whl (28.9 kB view hashes)

Uploaded Python 3

Supported by

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