NewareNDA

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.

This repository is a fork for independent development of the original NewareNDA project.

Installation

To install the latest version from the PyPi package repository:

pip install --upgrade NewareNDA

To install the development branch directly from Github:

pip install git+https://github.com/d-cogswell/NewareNDA.git@development

To install from source, clone this repository and run:

cd NewareNDA
pip install .

Usage

import NewareNDA
df = NewareNDA.read('filename.nda')

Logging

Additional test information including active mass, remarks, and BTS versions is returned via logging. The following command will print this logging information to the terminal:

import logging
logging.basicConfig()

Command-line interface:

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.

Troubleshooting

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.

Metadata

Release files for NewareNDA 2026.6.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for NewareNDA 2026.6.11
File	Size	Uploaded
newarenda-2026.6.11.tar.gz	14.2 kB	Jun 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for NewareNDA 2026.6.11
File	Interpreter	ABI	Platform	Reset
newarenda-2026.6.11-py3-none-any.whl 16.6 kB Jun 12, 2026	Python 3	none	any	Details

Total release size: 30.8 kB

Release files / newarenda-2026.6.11.tar.gz

Download URL	newarenda-2026.6.11.tar.gz
Size	14.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`10d764309bed8ab84a412d1c12b8eb42422941a39814a962f644eddfae62cfbd`
BLAKE2b-256 checksum How to use checksums	`b5e9a60effb1ff32320c8b83b65fe801f1b20f0d1e029930d4e694e8c3c408d1`
Upload date	Jun 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.2`

Release files / newarenda-2026.6.11-py3-none-any.whl

Download URL	newarenda-2026.6.11-py3-none-any.whl
Size	16.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`668fe04c596781a8560bccf6c214199706aad39881f726c655d7e4a4544dddf3`
BLAKE2b-256 checksum How to use checksums	`27e172768ea7150f9f0ebb4783427a818c9d43bb5d82ab3c91066f0481154c7d`
Upload date	Jun 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.2`