originec 0.1.3

Electrochemical data processing for OriginPro

OriginEC

A Python tool for visualizing and analyzing electrochemical measurement data using OriginPro.

Overview

OriginEC is a tool that automatically processes data obtained from electrochemical measurement devices (Gamry, BioLogic EC-Lab) and creates graphs in OriginPro. Data processing can be easily performed through a GUI interface.

Features

• Cyclic Voltammetry (CV) Data Processing

  • Import and process CV data from Gamry format (.DTA, .txt)
  • Import and process CV data from BioLogic EC-Lab format
  • Normalization to current density by electrode area
  • Automatic scaling
  • Graph creation in OriginPro

• Charge/Discharge Data Processing (BioLogic EC-Lab)

  • Import charge/discharge data from EC-Lab
  • Automatic separation of charge and discharge cycles
  • Automatic cycle number calculation
  • Charge/discharge curve creation in OriginPro

• GUI Interface

  • File selection
  • Processing method selection (CV_Gamry, CV_Biologic, ChDis_ECLab)
  • Parameter input (electrode diameter, scan rate, etc.)

Requirements

• Python >= 3.11
• OriginPro (must be installed)

Dependencies

• originpro >= 1.1.14
• pandas >= 2.3.3
• numpy >= 2.4.1
• scipy >= 1.17.0
• FreeSimpleGUI >= 5.2.0.post1

Installation

pip install originec

Or install from source:

git clone https://github.com/tomooki/originec.git
cd originec
poetry install

Usage

Launch in GUI Mode

Method 1: Command line (easiest after installation)

originec

Method 2: Python module

python -m originec

Method 3: From OriginPro Python Console

import originec
originec.launch()

Method 4: Direct import

from originec.origin_UI import main
main()

Method 5: Using launcher script Place launch_originec.py in Origin's User Files folder, then run from Origin's Script Window or Python Console:

exec(open('launch_originec.py').read())

Programmatic Usage

Processing Gamry CV Data

from originec.CV.cvorigin import CVMakerGamry

# Specify list of file paths
file_list = ["path/to/file1.DTA", "path/to/file2.DTA"]

# Normalize to current density by specifying electrode diameter (mm)
diameter = 3.0  # 3mm diameter electrode
CVMakerGamry(file_list, diameter=diameter)

Processing BioLogic CV Data

from originec.CV.cvorigin import CVMakerBiologic

# Copy data to clipboard from BioLogic EC-Lab (Alt+D) before running
CVMakerBiologic()

Processing BioLogic Charge/Discharge Data

from originec.Biologic.chdis_bio import ECLabChDisMaker

# Copy data to clipboard from EC-Lab before running
ECLabChDisMaker()

Data Formats

Gamry Format

• .DTA files: Gamry raw data files
• .txt files: Tab-delimited exported data

BioLogic EC-Lab Format

• Data copied to clipboard from EC-Lab using Alt+D
• CV data: Potential (Ewe/V) and current (I/mA, I/A, I/μA, etc.)
• Charge/discharge data: Capacity (Capacity/mA.h/g) and potential (E/V)

License

Please contact the project owner regarding the license for this project.

Author

tomooki ([e-mail])

Version

0.1.0