Edit & export

One the user has either imported a CSV/VXP file or created their own analytical breathing curve, it will be displayed on the Edit & export tab. This tab contains a multitude of operations to apply to crop and edit fragments from a breathing curve. The main functionalities are cropping, editing the time-domain (e.g. speeding up/slowing down the curve), editing the amplitude (scaling, shifting and thresholding), as well as inserting breath holds. Once the user is satisfied with the editing process, the fragment can be exported either as a CSV (raw table data) or GCODE file (e.g. as input to drive motion in phantoms).

The following image shows an initial overview of the Edit & export tab. On the left are the panels to apply the editing operations, and export the curve. On the right the amplitude of the curve is displayed as a function of time, together with sliders to select a specific range.

Cropping

In order to select a specific fragment from the curve:

Change the slider position to select the desired range
If information about the individual breathing cycles (e.g. phase, instance) is available, the user can check the the Clip to whole cycles option. This option will trim the the "loose" ends of the curve and return only the full cycles.
Press Crop, after which the curve will be cropped to the selected range (Note: the time information will be reset, starting from zero)

Operations

Multiple operations are included to change the overall morphology of the breathing curve:

The Scale frequency operation can be used to speed up or slow down the breathing curve, either by decreasing or increasing the interpolation value relative to one.
The Scale amplitude operation is used to scale the amplitude of the curve by multiplication with the set value.
The Shift amplitude operation is used to shift the amplitude up or down (only if Set min value to zero is unchecked)
The Max. amplitude threshold will clip the amplitude values that are higher than the set threshold (e.g. to avoid amplitude values that cannot be executed by motors).
The Set min value to zero option will shift the curve so that the minimum value is set to zero (only relative amplitude changes)

The following image shows the resulting curve after applying a scale frequency factor of 0.5, scale amplitude factor of 2.0, shift value of -10.0 and a max. amplitude threshold of 43.0. Note that the total time is reduced from 100 s (100,000 ms) to 50 s (50,000 ms), and the values are clipped to a maximum amplitude of 43.0 mm (compared to the initial curve displayed at the top of this page).

Breath hold

The current implementation of AMIGOpy enables the user to insert a breath hold in the breathing curve. This requires information regarding the individual breathing cycles to be present (e.g. phase or instance). In a future edition, this requirement might not be needed anymore.

Check the Apply breath hold option to enable the breath hold functionality
Put in the start timestamp to insert the breath hold. This should be in the unit of the X-axis that is selected (either time in ms or s).
Select the duration of the breath hold in seconds

After pressing Apply operations the breath holds will be inserted at the maximum breathing cycle amplitude, closest to the provided start timestamp input.

Undo

If at any point the user is not satisfied with the applied changes, the Undo button enables the user to revert the latest operation applied to the curve.

Export

The edited fragment (as displayed in the right panel) can be exported either as a CSV or GCODE file.

Select the number of times the fragment is to be copied (e.g. multiple consecutive fragments might be required when using the curve as input during measurements)

To ensure the curve is smooth, the last breathing cycle in the fragment is scaled to the amplitude of the first cycle. This is required to avoid discontinuities that could results in problems when using the breathing curve as input to drive motion.

Put in the filename of the output file
By pressing the Export CSV button, the raw data (as displayed on the Import & create tab) with the applied edits is exported to a CSV file.
By pressing the Export GCODE button, the data is processed to calculate the velocity (derivative of the amplitude), and acceleration (derivative of the velocity) of the breathing signal. Additionally, the speed (absolute value of the velocity in [mm/min] is calculated, as this is required to be used as input to drive motion. The amplitude, velocity, acceleration and speed are then exported to a CSV and GCODE file.

Page updated

Google Sites

Report abuse