Skip to content

YueGroup/carbon-electrolyte-interface

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Carbon–Electrolyte Interface Toolkit

This repository contains molecular simulation inputs, analysis scripts, and data processing tools used in:

“How Surface Functionalization Controls Confined Electrolyte Structure and Dynamics at Graphene Interfaces”
Lyndon T. M. Hess, Nhi P. T. Nguyen, et al.
Cornell University

Project Overview

This study explores how chemical functionalization of graphene surfaces modulates the structure and dynamics of confined aqueous NaCl electrolytes. Using molecular dynamics (MD) simulations, we investigate a matrix of functional group types (–COOH, –OH, =O, –CH₃), surface coverages, and electrolyte concentrations.

We also introduce carbonstructures, an open-source Python tool developed to generate functionalized graphene structures for simulation.

Repository Structure

carbon-electrolyte-interface/
├── simulation/       # LAMMPS input scripts and run templates
├── analysis/         # Python scripts to analyze trajectories
├── figures/          # Publication-ready figures
├── requirements.txt  # Python dependencies for simulation and analysis
├── .gitignore        # Ignored files (e.g., dumps, logs)
└── README.md         # This file

Dependencies

Python tool:

carbonstructures

This external package was used to build functionalized graphene surfaces. Clone and install from its own repository if needed.

Usage

1. Structure Generation

Use carbonstructures to generate graphene sheets with desired functional groups and coverage.

2. Simulation

Use the files in simulation/ to run LAMMPS MD simulations. Example job scripts are provided for HPC environments.

3. Analysis

Run scripts in analysis/ to compute:

  • Water and ion density profiles
  • Interfacial and bulk diffusion coefficients
  • Figure generation (e.g., heatmaps, line plots)

Figures

All plots shown in the manuscript are available in figures/. Each figure corresponds to a panel in the Results & Discussion section. See figures/README.md for descriptions.

License

This repository is released under the MIT License. See LICENSE file for details.

Citation & Data Availability

If you use this toolkit or structure generation method in your work, please cite:

Hess, Nguyen, et al. Tuning Interfacial Electrolyte Structure and Dynamics via Surface Functionalization of Graphene. 2025.

All data and scripts are available via this GitHub repository. For questions, contact:

shuwen.yue@cornell.edu

About

Simulation and analysis scripts for graphene–electrolyte interface study

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 82.0%
  • Shell 18.0%