Manual

version: V1.2.3

Overview

HELIS is software designed to estimate the helical parameters based on Cryo-ET data.

The software contains two levels fo functions, tomogram-level and filament-level

  • Tomogram-level: tomogram visualization, coarse filament picking, et al.
  • Filament-level: filament modification, helical parameter estimation, et al.

In the Tuning filament mode, the filament-level functions are accessible, otherwise the tomogram-level functions are available.

The graphical user interface (GUI) of HELIS consists of two main regions

  • Control Panel: left part of the GUI, includes buttons and a list box for managing filament data
  • Visualization Area: right part of the GUI, displays the tomograms and filaments (switch by clicking the tabs).
    • Tomogram View: displays the slices of the tomogram and the filament axes, allowing users to coarsely determine and check the filament positions.
    • Filament View: contains three sub-views: the averaging cylindrical surface, the cross-section, and the unrolled Fourier spectrum. These sub-views collectively provide intuitive insights into the selected filament, enabling users to precisely tune filament axis positions and determine helical symmetry.

main_tomogram_view main_filament_view

Load Data

Tomo button: select and load a tomogram file.

  • Only .mrc files are supported.
  • This step is required for subsequent operations.

Fila button: select and load a filament information file.

  • This should be a .mat file generated by HELIS.
  • If filament positions already exist, this step can be skipped.

load_data

After successfully loading the tomogram and filament information, the tomogram view will display slices of the loaded tomogram, and the filament list box will list the existing filaments.

Observe Tomograms and Filaments

and arrow buttons: switch up and down the displayed layer

Layer idx box: editable, the index of the displayed layer

Flip Contrast button: flip the tomogram contrast.

  • This affects only the display in the GUI and does not modify the original data.

Filament list box: select filament

  • Click any item in the Filaments list box to select the corresponding filament.

Show button: display all filaments simultaneously.

observe_data

Edit Filaments

Add Filament button: enter filament-adding mode.

  • Click on the tomogram layer to pick filament axis points in order.
  • Undo button: cancel the previous point selection.
  • Accept button: save the selected points as a new filament and exit filament-adding mode.
    • The new filament will appear in the Filaments list box.
  • Close button: discard the current selections and exit filament-adding mode.

Delete button: remove the selected filament.

Save button: save all filaments to a specified file.

edit_filaments

Tune Filaments

Enter & Exit Filament Tuning Mode

Tune Filament button: enter filament-tuning mode for the selected filament.

  • Any subsequent operations will modify the selected filament.
  • Right-click to select Set extracting parameters for setting key filament extracting parameters.

Update button: save modifications and refresh the filament view.

Abort button: discard all changes since the last update.

Finish Tuning button: discard unsaved changes and exit tuning mode.

enter_tuning_mode

Observe the Filament View

Filament tab: switch to the filament view.

  • Contains three sub-views: unrolled surface, cross-section, and cylindrical Fourier spectrum.
  • Click on unrolled surface to display corresponding cross-section.
  • The cross-section sub-view shows the average of several adjacent sections.

Section Pos box: specify the section's position.

Avg Num box: control the number of sections to be averaged.

Inner Rad and Outer Rad boxes: define filament's inner and outer radii.

  • Displayed as two rings in the filament section figure.

observe_filament_view

Select the Target Filament Point

Next Pt and Prev Pt buttons: navigate between points.

  • Tomogram view and filament view are synchronized.

select_points

Edit Filament Points

Add Pt button: enter point-adding mode.

  • Click on tomogram layer or cross-section to add new point.
  • New point will be added to nearest end or between closest points.
  • GUI exits point-adding mode automatically after adding.

Mov Pt button: enter point-moving mode.

  • Click on tomogram layer or cross-section to move selected point.
  • GUI exits point-moving mode automatically after moving.

Rmv Pt button: delete selected point.

Cancel button: exit point-adding or point-moving mode.

Note: Click Update after making changes to refresh the filament view.

edit_points

Automatically Trace and Center Filaments

Thres box: set threshold for tracing.

Trace button: trace the current filament.

  • Use tomogram layers to verify results.

Centering button: automatically find filament center.

  • Uses extracted filament density map.
  • Ignores newly added points.
  • Update filament before auto-centering.

tracing_and_centering

Determine the Helical Parameters

Adjust the Shown Fourier Spectrum

Rmv Bg button: remove background from spectrum.

Gamma box: adjust logarithm constant.

Seg Size and Seg Step boxes: define segment length and step size for spectrum averaging.

Max Ord box: adjust horizontal width.

Δn and ΔL boxes: define search range for vector optimization.

a* and b* boxes: display reciprocal primitive vectors (read-only).

  • Star number, rise, and twist show corresponding helical parameters.

spectrum parameters

Determine Reciprocal Primitive Vectors and Helical Parameters

Set Va and Set Vb buttons: manually set 1st or 2nd reciprocal primitive vectors.

  • Select points on Fourier spectrum.

Opt Vs button: optimize manually specified vectors.

set RPVs

Averaging

Avg Surf button: average the unrolled surface.

View Control Plane: check to show corresponding graphics.

Base pt edit box: set the reference point for lattice.

  • lattice lines and lattice points will be shown according to the base point.
  • surface point extraction will based on the base point.

extr surf pts button: export the position and euler angles of asymmetric units.

  • Useful in the down-stream tasks, like sub-tomogram averaging.

extr axial pts button: export the position of points in filament axis.

  • Useful in the for down-stream tasks, like sub-tomogram averaging.

SF-STA button: reconstruct SF-STA of tuned filament.

averaging

Calculation of Polarity Score

Polarity Estimation button: calculate the polarity score.

  • Select the reference map and the STA map of current filament to calculate.
  • The result will be shown in Polarity score edit box in the bottom-right part of the GUI.
Xueming Li Lab all right reserved,powered by GitbookThe latest date modified: 2025-04-07 20:33:39

results matching ""

    No results matching ""