Supercell program

version 2.x

a combinatorial structure-generation approach for the local-level modeling of atomic substitutions and partial occupancies in crystals.

Tutorial Download

News

24-05-2026

Supercell v2.1.2 (maintenance release) Mostly a maintenance update: dependencies and packages were refreshed, several minor bugs were fixed, and benchmarks/tests show performance improved by almost 30%. New native builds are now published for Linux ARM64 (Ubuntu) and for macOS Intel and Apple Silicon separately. The x86_64 Linux binary from the site targets AVX-capable CPUs (any x86_64 from 2011 onward) and is built to run on Ubuntu 18.04+, Debian 10+, RHEL 8+ and openSUSE Leap 15.x+. Download here.

03-08-2024

Supercell v2.1.1 (minor improvement) External dependencies updated, minor bugs fixed. Download program here.

Read More…

Background

A supercell approach is a very old, universal and theoretically clean method for approximation of materials with point disorder1. But the method applies mostly to some particular cases, like low amount of impurity (one per supercell) or random disorder with special quasirandom structure (SQS) approximation2, because the number of derivative structures is one in these cases. In general, the number of derivative structures is high enough to be generated “by hand”. There are some programs, which can help to generate derivative structures (see review). We believe that supercell program is the best choice, because the software was created to solve most of the technical problems of supercell approximation. The program includes algorithms for structure manipulation, supercell generation, permutations of atoms and vacancies, charge balancing, detecting symmetry-equivalent structures, electrostatic energy calculations and sampling output derivative structures. The software works with CIF files, therefore it is compatible with most of DFT software ( VASP, CASTEP, Wien2k etc). It has a powerful command line interface and works out-of-the-box on Linux, macOS and Windows platforms. The correctness of the program was verified by available literature data. The documentation includes an open-access paper, program interface manual, tutorial and a variety of examples.


  1. Buerger, M. J. (1947). J. Chem. Phys., 15(1), 1–16. ↩︎

  2. Zunger, A., Wei, S. H., Ferreira, L. G., & Bernard, J. E. (1990). PRL, 65(3), 353–356. ↩︎

Supercell

Quickstart
 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
 # Create new folder and go to it
 mkdir supercell-start && cd supercell-start
 
 # Download program itself and unzip it (files: supercell, README)
 wget https://orex.github.io/supercell/external/exe/supercell-linux.tar.gz -O - | tar -xzvf -
 
 # Download example
 wget https://raw.githubusercontent.com/orex/supercell/master/data/examples/Ca2Al2SiO7/Ca2Al2SiO7.cif
 
 # Run the program
 ./supercell -i Ca2Al2SiO7.cif -m -v 2 -s 1x1x2 -o cell1x1x2
 
 # <--- and you will get 10 structures, represented
 # <--- in the animation on the left side

Step-by-step for newcomers

Step 1
FAQ

Check FAQ to see what supercell is about.

Read more...
Step 2
Supercell paper

Check supercell paper to obtain overall idea about the program and its application.

Read more...
Step 3
Install the program

Get the program. Use the easiest option with compiled binaries for your OS. Linux is recommended.

Read more...
Step 4
Try the program

Try the program using Ca2Al2SiO7 example.

Read more...

Learn more

Whats new 2.x

Supercell 2.x is a major supercell release with significant performance boost, multithreading support and code improvement and refactoring.

Download and install

Using supercell is as easy as one-two-three. Check this page to learn different methods of obtaining and using the program.

Supercell archive

Using supercell is as easy as one-two-three. Check this page to learn different methods of obtaining and using the program.

Documentation

The Tutorial is a handbook for supercell users. All features of supercell are illustrated by examples, which are sorted by complexity. The Manual describes all commands in the CLI.

Benchmark

The supercell program is the fastest solution which can approach the largest enumeration problems.

Publication list

List of publications that use/cite the program.

Troubleshooting

If you have a problem with supercell program, please check a piece of advice here.