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.
- C1 character table
- Cs character table
- Ci character table
- C2 character table
- C3 character table
- C4 character table
- C5 character table
- C6 character table
- C7 character table
- C8 character table
- D2 character table
- D3 character table
- D4 character table
- D5 character table
- D6 character table
- C2v character table
- C3v character table
- C4v character table
- C5v character table
- C6v character table
- C2h character table
- C3h character table
- C4h character table
- C5h character table
- C6h character table
- D2h character table
- D3h character table
- D4h character table
- D5h character table
- D6h character table
- D2d character table
- D3d character table
- D4d character table
- D5d character table
- D6d character table
- S4 character table
- S6 character table
- S8 character table
- T character table
- Td character table
- Th character table
- O character table
- Oh character table
- I character table
- Ih character table
- C∞v character table
- D∞h character table
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.
degreeselects by degree, where rotations count as 1, andkindselectstranslation,rotation,quadraticorcubic(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, ′ becomesp, ∞ becomesinf, 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
pandpp, and + and − become_plusand_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:
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}}.
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"]))
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:
{
"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
nullif the table does not give one. order- The number of operations, or
nullfor an infinite group. classes- The columns, in order. Each has a
size, the number of operations in the class, and arepresentative, 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 isnull. irreps- The rows, in order. Each has a
dimension, itscharactersin the same order asclasses, itscomponentsand itsfunctions, 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\). truncatedtrueif 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.