Skip to content
scipython.com

Character tables

Character tables for the molecular point groups, with the functions that transform as each row. They are also available as JSON, through the API.

The API

The character tables on these pages come from a public API that provides a JSON object. No API key is required, and a web page can call it directly from the browser. Its address is https://charabanc.scipython.com.

This section documents the API requests and responses; it can be tried out at the interactive documentation, and there is an OpenAPI description for tools that can read one.

Requests

Each of these links to a live response.

/v1/point-groups
Every group, with its names and order.
/v1/point-groups/C3v
A whole table.
/v1/point-groups/C3v/irreps/E
One row.
/v1/point-groups/C3v/classes/2C3
One column.
/v1/point-groups/C3v/irreps/E/classes/2C3
One character.
/v1/point-groups/C3v/functions?degree=2
The functions listed against each row. Without a filter you get all of them. degree selects by degree, where rotations count as 1, and kind selects translation, rotation, quadratic or cubic (though no table lists cubic functions yet).

Names

The names in a request are case-sensitive, use only ASCII characters and will not change. Each table gives them as the id of its classes and irreps. They follow these rules:

  • Groups use the Schoenflies symbol, with ∞ as inf, for example: C2v, D3h, Dinfh.
  • Classes use the column heading. σ becomes sigma, ′ becomes p, ∞ becomes inf, and a subscript letter or a power follows _, for example: 2C3, 3sigma_v, C3_2, 2C2p, 2Cinf_phi.
  • Irreps use the row label. Greek letters are spelled out, ′ and ″ become p and pp, and + and − become _plus and _minus, for example: A1g, E2pp, Pi_u, Sigma_g_plus.

Examples using Python

The decomposition formula determines how many times an irrep with characters \chi_i appears in a reducible representation with characters \chi:

n_i = \frac{1}{h} \sum_c g_c \, \chi_i^*(c) \, \chi(c)

where h is the order of the group and g_c is the number of operations in class c. This program applies it to the 3N=12 atomic displacements of ammonia, in the group C_{3\mathrm{v}}.

python
import json
from urllib.request import urlopen

url = "https://charabanc.scipython.com/v1/point-groups/C3v"
with urlopen(url) as response:
    group = json.load(response)["group"]

# The characters of the 3N atomic displacements of NH3, by class.
reducible = {"E": 12, "2C3": 0, "3sigma_v": 2}

for irrep in group["irreps"]:
    total = 0
    for klass, character in zip(group["classes"], irrep["characters"]):
        total += klass["size"] * character["re"] * reducible[klass["id"]]
    print(irrep["id"], round(total / group["order"]))
Output
A1 3
A2 1
E 4

So the displacements span 3A_1 + A_2 + 4E. Taking away the translations, x, y, z, which span A_1 + E, and the rotations, R_x, R_y, R_z, which span A_2 + E, leaves the vibrations: 2A_1 + 2E.

JSON response

Every response is a JSON object that includes meta, which gives the version of the data and its licence. This is the answer to the request for one character:

json
{
  "meta": {"data_version": "0.1.0", "licence": "CC-BY-4.0"},
  "group": "C3v",
  "entry": {
    "irrep": "E",
    "class": "2C3",
    "character": {
      "kind": "number",
      "re": -1.0,
      "im": 0.0,
      "exact": {"n": 1, "terms": [[-1, 0]]},
      "latex": "-1"
    },
    "components": []
  }
}

A whole table is in group, which has these keys:

id, text, latex
The group's name: for requests, as plain text and for typesetting. Classes and irreps have the same three keys.
hermann_mauguin, hermann_mauguin_latex
The Hermann–Mauguin symbol, or null if the table does not give one.
order
The number of operations, or null for an infinite group.
classes
The columns, in order. Each has a size, the number of operations in the class, and a representative, which states one of those operations exactly. For example, {"type": "rotation", "axis": [0, 0, 1], "turns": [1, 3]} is a third of a turn about z. A key that does not apply to an operation is null.
irreps
The rows, in order. Each has a dimension, its characters in the same order as classes, its components and its functions, which are described below.
generators
Operations that generate the group, in the same form as representative. The list is empty for an infinite group.
definitions
The symbols that the table uses, such as \varepsilon = \exp(2\pi\mathrm{i}/n).
notes
The table's footnotes, which explain its conventions, with maths in LaTeX between \( and \).
truncated
true if the group has more irreps than the table lists.

Characters

In a character, re and im give its value to 12 decimal places, and latex is the form printed in the table. exact gives the value without rounding, as a sum of roots of unity: each [c, p] in terms stands for c \exp(2\pi\mathrm{i}p/n). So {"n": 5, "terms": [[1, 1], [1, 4]]} is \exp(2\pi\mathrm{i}/5) + \exp(8\pi\mathrm{i}/5) = 2\cos 72^\circ.

Complex pairs. Rows such as E in C_3 are printed as two lines in a bracket. Their characters hold the sum of the two lines, which is real, and components holds the lines themselves. Each line is an irrep in its own right, so the reduction formula needs a line rather than the sum. In every other row, components is empty.

Infinite groups. In C_{\infty\mathrm{v}} and D_{\infty\mathrm{h}}, the table lists only the first irreps. A class with infinitely many operations has a size of null, and a class whose parameter is "phi" depends on an angle \phi. Some characters in such a column are functions of the angle, with a kind of "function", and others are still numbers, so check kind for each one. A function stands for amplitude × cos(multiple × \phi), so {"kind": "function", "amplitude": 2, "multiple": 1, ...} is 2\cos\phi.

Functions

A row's functions lists the sets of functions that transform together as that row. A set has a kind, a degree, text and latex for the whole set, and a basis with one function for each dimension of the row.

A polynomial in the basis has terms, where each [c, [i, j, k]] stands for c\,x^i y^j z^k, so x^2 - y^2 is [[1, [2, 0, 0]], [-1, [0, 2, 0]]]. A rotation has an axis instead.

Errors and caching

The API accepts only GET requests. An unknown name gets a 404 and an invalid filter a 422, with the reason in detail. Successful answers can be cached for an hour.

Licence and changes

The data is under the CC BY 4.0 licence, so it can be reused freely with credit to this site.

The service is new. The names of groups, classes and irreps are permanent, but the rest of the JSON may change before it settles.