Skip to content

Track Options

Roman Chernyatchik edited this page Dec 17, 2018 · 4 revisions

Track Options

This section shows how to change track options and reorder them. You can use mouse or only keyboard for most of actions shown in this section. Using only keyboard is more productive compared to doing all things with mouse.

View Settings

Tracks could have Title, Axis and Legend.

alt text

You could turn on/off showing title, axis, legend and browser grid using Main Menu | View menu section.

Select Track

You can select the desired track using two ways:

  • Using Mouse: Click on required track using Mouse Left Button

    alt text

  • Using Keyboard: Press or keyboard keys until the required track has been selected.

Clear Tracks Selection

Press Esc keyboard key to unselect all tracks.

alt text

Or you could use Main Menu | Edit | Clear Tracks Selection

Rename Track

You can rename a track using two ways:

  • Using Mouse:

    • Open track context menu (click on required track using Mouse Right Button) and select Title... menu item.

      alt text

    • Change track title and press OK

      alt text

  • Using Keyboard:

    • Select required track (using or keys)

      alt text

    • Press Enter (or Return) keyboard key

      alt text

    • Change track title and press Enter (or Return) to save changes or Esc to cancel.

Change Color

You can change track color using two ways:

  • Using Mouse:

    • Open track context menu (click on required track using Mouse Right Button) and select Color... menu item.

    • Select new color in Choose a color dialog and press OK

      alt text

  • Using Keyboard:

    • Select required track (using or keys)

    • Press Space to open track context menu

    • Select Color... menu item and press Enter (or Return).

    • Select new color in Choose a color dialog and press OK

      alt text

Change Track Height

You can change track height using two ways:

  • Using Mouse:

    • Open track context menu (click on required track using Mouse Right Button) and select Track Height... menu item.

    • Select new track height in pixels in Track Height dialog and press OK

      alt text

  • Using Keyboard:

    • Select required track (using or keys)

    • Press Space to open track context menu

    • Select Track Height... menu item and press Enter (or Return).

    • Enter new track height in pixels in Track Height and press OK

      alt text

Track AutoScale vs Fixed Scale Modes

For signal tracks (BIGWIG or WIG) JBR auto-scales track signal value according to max and min value in visible range by default. The minimal value is 1 pixels height, the maximum value is track height. This helps to compare signal shape for different tracks even if the signal is not normalized among the tracks.

E.g. at the screen shot the max value is 2786.862 and the minimal value is 0.995

alt text

Instead of auto-scale you can manually set min, max signal value thresholds. It allows to get same scale for any genome range, trim outlier values and do not scale noise in small ranges.

You can change min/max thresholds using

  • Using Mouse:

    • Open track context menu (click on required track using Mouse Right Button) and select Scales Min... or Scales Max.. menu items.

    • Select new signal threshold in Scales Max / Scales Min dialog and press OK

      alt text

  • Using Keyboard:

    • Select required track (using or keys)

    • Press Space to open track context menu

    • Select Scales Min... or Scales Max.. menu item and press Enter (or Return).

    • Enter new signal threshold in Scales Max / Scales Min and press OK

      alt text

E.g. let's set scales maximum 300 and minimum to 0: Auto scaled signal:

alt text

Changed scale signal:

alt text

To unset custom max/min scales use Autoscale action in track context menu.

Remove Track

You can remove track from session using

  • Using Mouse: Open track context menu (click on required track using Mouse Right Button) and select Remove Selected Track menu item.

    • Select new signal threshold in Scales Max / Scales Min dialog and press OK
  • Using Keyboard:

    • Linux/Windows: Alt + Delete / Alt + Backspace
    • MacOS: Option ⌥ + Delete

This action does not delete track file.

Show in Explorer / Finder

You can open track file in Explored (MacOS: Finder) using Show in Explorer (Show in Finder) track context menu item. This menu item is grayed for URL based tracks.

About Track

Information about track could be shown using About Track action in track context menu. The information depends on track type.

E.g.:

  • BIGWIG track

    alt text

  • Peaks tracks

    alt text

Reorder Tracks

  • Using Mouse:

    • Hold Control (Windows, Linux) or Command ⌘ (MacOS) keyboard key
    • Press and hold Mouse Left Button
    • Move mouse up/down and JBR will show track insertion position using thick red line
  • Using Keyboard:

    • Select required track (using or keys)
    • Move track up/down using Alt + / (Windows, Linux) or Option ⌥ + / (MacOS) keyboard keys.

E.g. move green track up:

  • Before moving:

    alt text

  • Select green track and move it up:

    alt text

  • Result:

    alt text

Using keyboard you can move a group of selected tracks.

Multiple Tracks Operations

Tracks reordering and context menu actions could be applied to selected tracks group.

Select Multiple Tracks

Two ways is possible:

  • Using Mouse:

    • Click first track using Left Mouse Button

      alt text

    • Hold Shift keyboard key

    • Click last track using Left Mouse Button

  • Using Keyboard:

    • Select first track (using or keys)
    • Hold Shift and press / keyboard keys to select/deselect tacks

    alt text

Add / Remove Track To Selected Group

To add/remove track to selected group hold Control (Windows, Linux) or Command ⌘ (MacOS) keyboard key and click on track using Left Mouse button.

E.g.: let's add the last track to selection:

alt text

Result:

alt text

Context Menu Actions for Multiple Tracks

JBR highlights with red color and (*) menu items if selected tracks have different values for the menu item. E.g. selected tracks has different titles and colors, so we get Color...(*) and Title...(*) menu items.

alt text

Context actions changes all selected tracks using same value for all tracks. E.g. if you press Color...(*) and select green color, all selected tracks will become green. If tracks have different values, dialogs for changing values show value of first track as a default choice. In the above example default choice for Color...(*) will be light blue.

alt text

BIGWIG Tracks Additional Actions

For BigWig tracks you could set signal log scale using context menu Scale item.

E.g.:

  • Normal scale

    alt text

  • Log10 scale

    alt text

BED-like Tracks Additional Actions

Auto-scale and custom scales min/max values are applied to scores if applicable. By default values auto scaled to whole track (not current range) min and 80-th percentile score values.

Region Color

If BED-like track file contains color assigned to each region you could choose whether to use colors provided by the file or use fixed color instead. Use Region Color item in track context menu.

Region Label

Peak names are shown as region labels by default. If peak name column is missing or empty JBR will use show region scores instead.

alt text

You could choose whether to show region Score or Name using Region Label submenu in track context menu. alt text

E.g. region score is used instead of region name. alt text

BED format assumes that scores are stored in the 5-th column. You could choose any other column using Region Score Column submenu. It could be useful if you know which column contains p-value or q-value and you'd like to visualize them in browser.

alt text

Transparency as Significance Level

Normally score column is associated with peak significance level in BED-like files. The scores are not p-values (or q-values) but are values of some function applied to them. You could read about meaning of score column in the documentation of the tool used to create your BED-like files. Usually the higher score the more significant value is. JBR could draw less significant peaks as transparent and more significant peaks as opaque.

JBR auto-scales transparency level according to the file scores distribution. JBR use track scale to get min score and max score values. In auto-scale mode max score is 80-th percentile. Scores less than or equal to the min value are almost transparent. Scores greater than or equal to the max value are opaque. Scores between the min and max values have linearly scaled transparency levels.

alt text

Clone this wiki locally