© 2022-2024 Copyright SES AI
Author: Daniel Cogswell
Email: danielcogswell@ses.ai
Python module and command line tool for reading and converting Neware nda and ndax battery cycling files. Auxiliary temperature fields are currently supported in both formats.
To install from the PyPi package repository:
pip install NewareNDA
To install the development branch directly from Github:
pip install git+https://github.com/Solid-Energy-Systems/NewareNDA.git@development
To install from source, clone this repository and run:
cd NewareNDA
pip install .
import NewareNDA
df = NewareNDA.read('filename.nda')
usage: NewareNDA-cli [-h]
[-f {csv,excel,feather,hdf,json,parquet,pickle,stata}]
[-s] [-v]
[-l {CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,DEBUG,NOTSET}]
[-c {chg,dchg,auto}]
in_file out_file
Script for converting Neware NDA files to other file formats. The default
output format is csv. Other formats may require installing additional
packages.
positional arguments:
in_file input file
out_file output file
options:
-h, --help show this help message and exit
-f {csv,excel,feather,hdf,json,parquet,pickle,stata}, --format {csv,excel,feather,hdf,json,parquet,pickle,stata}
-s, --software_cycle_number
Generate the cycle number field to match old versions
of BTSDA.
-v, --version show version
-l {CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,DEBUG,NOTSET}, --log_level {CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,DEBUG,NOTSET}
Set the logging level for NewareNDA
-c {chg,dchg,auto}, --cycle_mode {chg,dchg,auto}
Selects how the cycle is incremented.
If you encounter a key error, it is often the case that your file has a hardware setting that we have not seen before. Usually it is a quick fix that requires comparing output from BTSDA with values extracted by NewareNDA. Please start a new Github Issue and we will help debug.