Skip to content

Cyclara 0.8.0

Choose a tag to compare

View all tags
@asajeevan asajeevan released this 20 Oct 18:30
· 13 commits to main since this release
Immutable release. Only release title and notes can be modified.
v0.8.0
1463d92

Free software (GPL-3.0-or-later) that turns battery cycling data into checked numbers and journal-ready figures. It reads BioLogic EC-Lab .mpr and .mpt files and the text or Excel exports of Arbin, Maccor, Neware, BaSyTec, Novonix, PEC and Landt cyclers, and learns any other cycler's export from one file.

New in 0.8.0

  • Several plateaus. Every dQ/dE peak gets the capacity under it, its partner in the opposite branch of the same cycle (within 200 mV) or the status unpaired, and the cycles in which it is seen (first cycle only, appears from cycle k). Nothing is labelled reversible or irreversible: that judgement stays with you. The average potential of a branch is the capacity-weighted mean of its plateau potentials.
  • Evolution view and two new figures: dQ/dE of every cycle as a colour map, and as 3D surfaces (charge and discharge).
  • Large files: a million-row EC-Lab export opens in a few seconds; other cyclers' exports are read in chunks with the progress shown, up to 2 GB.
  • Help > How the numbers are calculated: every quantity in plain words and in full, with the settings of the open file and a methods paragraph to copy.
  • Help > Cite Cyclara: the reference, BibTeX, CITATION.cff or a methods sentence, one click each.
  • Fixed: files over 100 000 rows raised an error in the time plots; the average voltage was described as energy-weighted (it is charge-weighted; the numbers were always right).

Install

Windows 10 (version 1903 or later) or 11, 64-bit: run Cyclara-0.8.0-Setup.exe, then Next, Install, Finish. No administrator password is needed, and it installs over 0.7.0. The first time, SmartScreen may say "Windows protected your PC", because the installer is not signed with a paid certificate: click More info, then Run anyway.

macOS 14 or later: unzip Cyclara-0.8.0-macOS-AppleSilicon.zip (M1 to M4) or Cyclara-0.8.0-macOS-Intel.zip, drag Cyclara.app to Applications and open it. The first time, macOS says it cannot verify the app: click Done, then System Settings > Privacy & Security > Open Anyway, and open it again. On macOS 14, right-click the app and choose Open.

The handout (Cyclara_handout_v0.8.0.pdf) shows every step with pictures.

Check your download

Download only from this page. If someone sends you the file another way, compare its SHA-256 with this list (also attached as SHA256SUMS.txt):

7182922082ba701e517987f18c7a285464a54b4e2a503788d38d8e7ca43d2070  Cyclara-0.8.0-Setup.exe
20ab5b3d96153f5b10118e2e5ffccf3776a85759180b8f97f705f616fc528fb3  Cyclara-0.8.0-macOS-AppleSilicon.zip
fc4ad59cb0ae7da111e5d424677eff7c7cdd8c537837c555c6767b8d74d54dd1  Cyclara-0.8.0-macOS-Intel.zip
12e639bab09db54edfe321e7c6cb5318c9e1c3bd65731bf2e52d3983389d5d18  Cyclara_handout_v0.8.0.pdf
  • Windows, PowerShell: Get-FileHash .\Cyclara-0.8.0-Setup.exe
  • Windows, Command Prompt: certutil -hashfile Cyclara-0.8.0-Setup.exe SHA256
  • macOS, Terminal: shasum -a 256 ~/Downloads/Cyclara-0.8.0-macOS-AppleSilicon.zip
  • With the GitHub CLI, against GitHub's signed record of this release: gh release verify-asset v0.8.0 Cyclara-0.8.0-Setup.exe -R asajeevan/electrochem-toolkit

Tested

The installers were built from a clean checkout of commit c7014cc, on which all 925 tests pass on Linux. The Windows program, run with its bundled Python under Wine, passes its own suite of 920 tests, and this installer was checked under Wine by installing it over 0.7.0, opening every view and uninstalling it. The tag v0.8.0 is on the next commit, 1463d92, which adds only these checksums and the build evidence under docs/, none of which is inside the installers. Not yet run on a physical Windows PC or Mac: reports are welcome through Help > Report a problem.

Cite

Shyma Sajeevan, A. (2026). Cyclara: traceable analysis of battery cycling data (Version 0.8.0) [Computer software]. https://github.com/asajeevan/electrochem-toolkit

Assets 8
Loading