Skip to content

Control Bar Features

The control bar at the top provides tools for data management, selection, export, and import.

Control bar overview

1. Projection Selector

Switch between different dimensionality reduction methods:

Projection dropdown

MethodBest For
PCAInitial overview, finding outliers
UMAPGeneral exploration, balanced view
t-SNEFinding clusters
PaCMAPFast alternative to t-SNE
MDSPreserving distances

Different projections reveal different patterns - try switching between them!

2. Color By (Annotation Selector)

Choose which annotation to use for coloring points:

Color By dropdown

Available annotations depend on your dataset (taxonomy, family, function, etc.).

Find specific proteins by ID:

  1. Click inside the search box or press ⌘/Ctrl + K to focus it
  2. Type a protein ID or partial match
  3. Select from suggestions
  4. Protein is selected in the scatterplot

Multiple IDs

Paste multiple IDs at once (newline or space separated) and all matching proteins will be selected. Useful for re-selecting a previously exported subset.

4. Select Button

Enable box selection mode to select multiple proteins at once. See the Box Selection section for details.

5. Clear Button

Click Clear (or press Escape) to remove all current selections. Pressing Escape again will exit selection mode.

6. Isolate Button

Isolate focuses on selected proteins by hiding all others:

  1. Select one or more proteins (using search, click, or box select)
  2. Click Isolate
  3. Only selected proteins remain visible
  4. Click Reset (appears when isolated) to restore all proteins

Use Case

Isolate is useful for examining relationships within a specific protein subset - hiding unrelated proteins reduces visual clutter.

7. Filter Button

Filter shows only proteins matching specific annotation criteria:

  1. Click Filter to open the filter menu
  2. Select one or more annotations to filter by (e.g., taxonomy, family)
  3. Choose specific values for each annotation
  4. Click Apply

Filtered proteins are highlighted with a custom color scheme.

Isolate vs Filter

  • Isolate: Works with selected proteins - hides everything else
  • Filter: Works with annotation values - highlights matches, dims non-matches

Use Isolate for ad-hoc selections (like search results). Use Filter for annotation-based queries (like "show all kinases").

8. Export

Click Export to save your visualization:

Export options

FormatDescription
PNGRaster image
PDFVector image
JSONFull data for isolated proteins
Protein IDsText file with newline-separated identifiers

9. Import

Click Import to load a .parquetbundle file from your computer.

You can also drag & drop files directly onto the scatterplot.

Tips

  • Compare projections: Patterns that appear in multiple projections are more reliable
  • Use search: Quickly find known proteins to orient yourself
  • Export often: Save interesting views for later

Next Steps

Released under the Apache 2.0 License.