Skip to main content

A package of tools for large-scale EV charging research.

Project description

Build Status Codacy Badge Code style: black DOI

ACN Portal

The ACN Portal is a suite of research tools developed at Caltech to accelerate the pace of large-scale EV charging research. Checkout the documentation at


The ACN-Data Dataset is a collection of EV charging sessions collected at Caltech and NASA's Jet Propulsion Laboratory (JPL). This basic Python client simplifies the process of pulling data from his dataset via its public API.


ACN-Sim is a simulation environment for large-scale EV charging algorithms. It interfaces with ACN-Data to provide access to realistic test cases based on actual user behavior.


algorithms is a package of common EV charging algorithms which can be used for comparison when evaluating new algorithms.

This package is intended to be populated by the community. If you have a promising EV charging algorithm, please implement it as a subclass of BasicAlgorithm and send a pull request.


Download or clone this repository. Navigate to its root directory. Install using pip.

pip install .


See the tutorials directory for jupyter notebooks that you can run to learn some of the functionality of acnportal. These tutorials are also included on the readthedocs page. Additional demos and case studies can be found at We also have a video series of acnportal demos, which can be found at TODO.

Running Tests

Tests may be run after installation by executing

python -m unittest discover -v

Remove -v after discover to suppress verbose output.


If you're submitting a bug report, feature request, question, or documentation suggestion, please submit the issue through Github and follow the templates outlined there.

If you are contributing code to the project, please view the contributing guidelines here.


Contact the ACN Research Portal team at with any questions, or submit a question through Github issues.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

acnportal-0.3.2.tar.gz (91.9 kB view hashes)

Uploaded source

Built Distribution

acnportal-0.3.2-py3-none-any.whl (118.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page