Skip to content
cccskills
FreePublished on GitHub

bader-charge-analysis

Use when the user asks about Bader charge analysis, charge transfer, oxidation states from DFT, or electron density partitioning.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208 stars(GitHub 208 + cccskills 0)

Run score Not tested

See how to install

Files included (1)

  • SKILL.md5.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Bader Charge Analysis

Overview

Bader analysis partitions the continuous electron density from DFT into atomic basins defined by zero-flux surfaces of the density gradient. This gives physically meaningful atomic charges and charge transfer values.

What Bader Charges Tell You

  • Charge transfer between adsorbate and surface
  • Oxidation states of atoms in a material
  • Electron donation/back-donation in catalytic bonds
  • Ionic vs covalent character of bonds

VASP Settings for Bader Analysis

Bader analysis requires fine-grid charge density output:

LAECHG = .TRUE.    # Write core charge density (AECCAR0, AECCAR2)
LCHARG = .TRUE.    # Write valence charge density (CHGCAR)
NGXF, NGYF, NGZF   # Fine FFT grid (2x default, e.g., NGXF=2*NGX)

The all-electron charge density is: AECCAR0 + AECCAR2, which is summed with the Bader code to avoid errors from pseudopotential smoothing.

MCP Workflow

Step 1: Single-point with charge output

{"tool": "catgo_workflow_engine", "arguments": {
  "action": "add_task", "workflow_id": "wf_bader",
  "task_type": "single_point",
  "params": {
    "software": "vasp",
    "ENCUT": 520,
    "LAECHG": true,
    "LCHARG": true,
    "PREC": "Accurate",
    "system_name": "charge density"
  }
}}

Step 2: Bader analysis post-processing

{"tool": "catgo_workflow_engine", "arguments": {
  "action": "add_task", "workflow_id": "wf_bader",
  "task_type": "charge_analysis",
  "depends_on": "task_sp",
  "params": {"method": "bader", "system_name": "Bader charges"}
}}

Step 3: Get results

{"tool": "catgo_workflow_engine", "arguments": {
  "action": "get_result", "workflow_id": "wf_bader", "task_id": "task_bader"
}}
{"tool": "catgo_analyze", "arguments": {
  "action": "charges", "workflow_id": "wf_bader", "task_id": "task_bader"
}}

Python API

Basic Bader Analysis

from catgo.workflow import Workflow

wf = Workflow("Bader charge - CO on Pt(111)")

inp = wf.add_task("structure_input", structure=co_pt_json)

# Relax first
opt = wf.add_task("geo_opt",
    structure=inp.output.structure,
    software="vasp", ENCUT=520)

# Single-point with charge density output
sp = wf.add_task("single_point",
    structure=opt.output.structure,
    software="vasp", ENCUT=520,
    LAECHG=True, LCHARG=True, PREC="Accurate")

# Bader post-processing
bader = wf.add_task("charge_analysis",
    chgcar=sp.output.chgcar,
    aeccar0=sp.output.aeccar0,
    aeccar2=sp.output.aeccar2,
    method="bader")

wf.submit()

Charge Transfer Analysis

# Compare charges before and after adsorption
wf = Workflow("Charge transfer analysis")

# Clean slab Bader
slab_sp = wf.add_task("single_point",
    structure=slab_opt.output.structure,
    software="vasp", ENCUT=520, LAECHG=True, LCHARG=True)
slab_bader = wf.add_task("charge_analysis",
    chgcar=slab_sp.output.chgcar,
    aeccar0=slab_sp.output.aeccar0,
    aeccar2=slab_sp.output.aeccar2)

# Slab+adsorbate Bader
ads_sp = wf.add_task("single_point",
    structure=ads_opt.output.structure,
    software="vasp", ENCUT=520, LAECHG=True, LCHARG=True)
ads_bader = wf.add_task("charge_analysis",
    chgcar=ads_sp.output.chgcar,
    aeccar0=ads_sp.output.aeccar0,
    aeccar2=ads_sp.output.aeccar2)

wf.submit()

# After completion:
# dq = q_ads(atom) - q_clean(atom) for each surface atom
# Positive dq = atom lost electrons; Negative dq = atom gained electrons

DAG Structure

structure --> geo_opt --> single_point(LAECHG) --> charge_analysis

Output Format

Bader analysis returns per-atom data:

FieldDescription
atom_index0-based atom index
elementElement symbol
bader_chargeElectrons in Bader basin
valence_electronsPOTCAR valence electron count
net_chargevalence_electrons - bader_charge (+ means cation)
volumeBader basin volume (A^3)

Interpreting Results

Common Reference Charges (VASP PAW, valence electrons)

ElementZVAL (valence e-)Typical Net Charge Range
O6-0.8 to -1.4 (oxide)
Ti4 or 10+1.5 to +2.5 (TiO2)
Pt10-0.1 to +0.3 (metallic)
C4-0.5 to +1.0 (varies)
H1+0.4 to +0.6 (on O), -0.3 (on metal)

Charge Transfer Upon Adsorption

dq_adsorbate = sum(net_charge of adsorbate atoms in slab+ads system)
             - sum(net_charge of same atoms in isolated adsorbate)
  • dq < 0: adsorbate gains electrons (acceptor, e.g., CO on Pt)
  • dq > 0: adsorbate loses electrons (donor, e.g., Na on surface)

Common Pitfalls

  1. Always use LAECHG=.TRUE. to get all-electron charge density. Bader analysis on pseudocharge (CHGCAR alone) gives wrong atomic charges because core electrons are missing.
  2. PREC=Accurate and a fine FFT grid improve Bader basin boundaries. Coarse grids can misassign charge near atomic boundaries.
  3. Bader charges are NOT formal oxidation states. They are typically smaller in magnitude (e.g., Ti in TiO2 shows +2.3, not +4).
  4. For charge transfer analysis, use the SAME computational settings for the reference and adsorbed systems.
  5. The Bader program (Henkelman group) must be available on the HPC. CatGo calls it automatically during charge_analysis post-processing.
  6. For spin-polarized systems, Bader can also partition spin density -- this gives magnetic moments per atom.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

abinit

Free

Generate and manage ABINIT DFT calculations. Use when the user requests ABINIT, or needs DFPT phonons, GW calculations, or BSE optical spectra.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

Use when the user asks to place an adsorbate molecule on a surface, find adsorption sites, or set up a surface+adsorbate model for DFT.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

Use when the user asks for adsorption energy, binding energy, or wants to compare how strongly a molecule binds to a surface.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

Use when the user asks to analyze computational results: Gibbs free energy, OER/HER/CO2RR overpotentials, adsorption energy, convergence tests, DOS/d-band analysis, or Bader charge analysis.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

Use AmberTools antechamber for molecular force field parameterization. Generates GAFF/GAFF2 parameters and AM1-BCC or RESP charges for use in AMBER or LAMMPS classical MD simulations.

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

One-shot recipes for adding, deleting, moving, and replacing individual atoms in the active CatGo viewer structure. Use whenever the user asks to "add an atom", "delete atoms", "remove this atom", "move atom N", "replace H with Li", or any single-atom edit — including "add a hydrogen on top of atom 12" / "delete atoms 5–9" / "swap the oxygen at site 3 for fluorine". Skips the discovery loop (no need to list structure tools or check adsorption sites first); goes straight to the matching `catgo_structure` action. Triggers in Chinese on 加原子, 删原子, 减原子, 移动原子, 替换原子, 增加氢, 删除氧, 把 ... 换成 ....

The English summary is being prepared. Showing the original description.

Hello-QM/catgo-LRG208Updated Oct 23, 2026

See all skills by Hello-QM

Report a problem with this skill