Skip to content

Commit aa372f1

Browse files
committed
Improve documentation of chemistry topics.
1 parent a31cc41 commit aa372f1

1 file changed

Lines changed: 15 additions & 1 deletion

File tree

doc/en/Topics/Chemistry/index.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,20 @@ For example, the entry for `"H"`, hydrogen, is
2020
["H", [
2121
["Name", [ ["en", "hydrogen"], ["fi", "vety"] ]],
2222
["AtomicNumber", 1],
23-
["AtomicMass", 1.008]
23+
["AtomicMass", 1.008],
24+
["CPKHexColor", "FFFFFF"],
25+
["ElectronConfiguration", "1s1"],
26+
["Electronegativity", 2.2],
27+
["AtomicRadius", 120],
28+
["IonizationEnergy", 13.598],
29+
["ElectronAffinity", 0.754],
30+
["OxidationStates","+1, -1"],
31+
["StandardState", "Gas"],
32+
["MeltingPoint", 13.81],
33+
["BoilingPoint", 20.28],
34+
["Density", 0.00008988],
35+
["GroupBlock", "Nonmetal"],
36+
["YearDiscovered", 1766],
2437
]]
2538
````
2639

@@ -36,6 +49,7 @@ Notes.
3649
1. Names of elements are always given as strings. E.g. to access data for hydrogen use `"H"`.
3750
2. Field names are always given as strings, e.g. `"AtomicMass"` is a string (not an atom `AtomicMass`).
3851
3. The utility functions filter the `"Name"` field to give the name of the element with the local language selection. STACK uses the global `%_STACK_LANG` variable. If no local name is defined the `"Name"` in English is returned. If you really want _all_ the data, just use `assoc(element, %_STACK_CHEM_ELEMENTS)` rather than ` chem_data_all(element)`.
52+
4. Note that, for efficiency reasons, data is stored in flat table and the above arrays are reconstructed from the flat table, the list of field names and any languages available. Language data is separated which makes it easier to add a new language. Chemical names are _not_ part of Moodle's normal language pack and need to be added explicitly to `chemistry.mac`. See [github](https://github.com/maths/moodle-qtype_stack/blob/master/stack/maxima/contrib/chemistry.mac) for examples. As of Nov 2025, English, Finnish and German names are available.
3953

4054
TODO: write a maxima function which gives an annotated atomic symbol in LaTeX, based on the chemical data e.g. \(^{25}_{12}\mbox{Mg}^{2+}\).
4155

0 commit comments

Comments
 (0)