Skip to content

v3.1.0

Choose a tag to compare

@NCCU-Schultz-Lab NCCU-Schultz-Lab released this 06 Nov 16:22
· 18 commits to main since this release
13aa265

EaglePlot now also runs in your browser, with nothing to install:
https://the-schultz-lab.github.io/eagleplot/app/. This release also makes the GUI much
faster, gives it a simpler first screen, and fixes JCAMP-DX loading, which was broken in
3.0.0 for anyone with the current jcamp package.

Added

  • EaglePlot runs in your browser:
    the-schultz-lab.github.io/eagleplot/app/
    .
    Nothing to install and nothing uploaded: your data stays on your computer, which makes it
    usable on laptops where you can't install software. It takes 15–30 seconds to start.
    Features that can't work in a browser are turned off with an explanation instead of
    failing: loading a whole folder, downloading from NIST (the page links to NIST instead),
    and changing the theme. Settings, presets and workflows are kept in the browser. The
    documentation site and README link to it. Every change to the app is tested in a real
    browser before it is published (packaging/web/, scripts/web/smoke.js).
  • EAGLEPLOT_CONFIG_DIR sets the folder that holds config.json (saved defaults,
    presets and workflows). Unset, it stays where it was.

Changed

  • A "Get started" Home page. With no data loaded, Home offers three example datasets,
    each a single click away from a plot in Quick Plot, plus buttons to upload a file or
    browse all examples, instead of "Datasets 0 · Plots 0 · Analyses 0".
  • Quick Plot shows the plot on the first screen. Dataset, library and plot type sit in
    one row with a Style presets button, and the dataset size and plot description share
    one line. On a 1366×768 laptop the plot used to start below the bottom of the screen.
    All pages have less empty space at the top.
  • Clearer menu names: Basic is now Quick Plot, Multiplot Dashboard, Single
    Analysis Tools and Batch Batch Analysis. Page addresses are unchanged, so
    bookmarks still work.
  • The sidebar's About box starts closed, and on phones the sidebar starts closed.
  • Quick Plot is much faster and easier to use.
    • Settings sit on the left and the plot on the right, so you see each change as you
      make it. The plot stays in view while the settings scroll.
    • Live preview: the plot redraws as you change settings (toggle it off if you prefer).
      Generate Plot still saves the plot to the plot history.
    • Changing a setting now updates only the settings and plot area, not the whole page.
      In a test with a line plot, the time from a change to seeing it on the plot fell from
      about 1.3 s to about 0.6 s.
    • Downloads are created only when you ask for one. Before, every click re-created the
      plot as PNG at 150, 300 and 600 dpi, SVG and PDF, whether or not you were downloading.
      The export panel now has one format menu and one Download button.
    • A marker appears as soon as you click a point on an interactive plot.
  • Export Results is much faster. It used to re-create every saved plot as PNG (150 and
    300 dpi), SVG and PDF, and re-save the dataset as CSV and JSON, on every click: 1.2 s per
    click with three saved plots, now 0.03 s. Files are now created only when you download them.
  • PDF report: on current Streamlit it is one click, and the report is built when you
    press Download PDF Report. On older Streamlit the download button no longer
    disappears after the next click.
  • Batch Analysis: results stay on screen after you run a tool. Before, they disappeared
    at the next click, including when you clicked Download CSV.
  • Molecular Viz: the HTML and frequency-table exports are one click (Streamlit 1.52+),
    instead of "Export", then "Download", with the button disappearing afterwards.
  • Analysis Tools is faster. Each tool now updates on its own, so changing a setting or
    running a tool no longer reloads the whole page. A setting change takes about 0.23 s
    instead of about 0.38 s. A result from one tool stays on screen while you use another, and
    downloading the peak report no longer clears it.
  • Multi-Plot Dashboard:
    • Each panel has its own settings, shown above its plot. Editing a panel redraws only that
      panel, and the dashboard updates live after Generate Dashboard: a title edit shows up
      in about 0.4 s, where before you had to press Generate again.
    • The dashboard stays on screen when you change something or download it.
    • Turning shared axes off restores each panel's own axis limits.
  • Advanced Plotting: each tab updates on its own, so a change in one tab no longer
    clears the plot in another. The interactive HTML file (about 5 MB) is created only when
    you download it, and the plot stays on screen afterwards.
  • Plots are drawn at 150 dpi, as Quick Plot already was (other pages used 200), at
    about half the cost to draw. Unchanged Multi-Plot Dashboard panels are no longer
    redrawn when the page refreshes: a refresh of a 2×2 dashboard takes about 0.4 s instead
    of 1 s.
  • A missing optional package (for example h5py for HDF5 files) is reported with what to
    install, and where installing isn't possible, says so.

Fixed

  • JCAMP-DX files (.jdx, .dx) load again. With jcamp 1.3 installed, every such file
    failed with "the jcamp package is required". jcamp is now part of the formats extra
    (pip install "eagleplot[formats]").
  • Quick Plot's dataset CSV download was named name.csv.csv.
  • Multi-Plot Dashboard: the combined PNG and PDF downloads work. Before, pressing either
    button made the dashboard disappear without downloading anything.