Steinhardt bond order (property)

{
    "$id": "https://schemas.httk.org/defs/v0.1/properties/structure/steinhardt_bond_order",
    "$schema": "https://schemas.optimade.org/meta/v1.3/optimade/property_definition.json",
    "title": "Steinhardt bond order",
    "x-optimade-type": "dictionary",
    "x-optimade-definition": {
        "kind": "property",
        "version": "0.1.0",
        "format": "1.3",
        "name": "steinhardt_bond_order",
        "label": "steinhardt_bond_order_structure_httk"
    },
    "x-optimade-unit": "inapplicable",
    "x-optimade-unit-definitions": [
        {
            "$id": "https://schemas.optimade.org/defs/v1.2/units/si/general/angstrom",
            "title": "\u00e5ngstr\u00f6m",
            "symbol": "angstrom",
            "display-symbol": "\u00c5",
            "description": "A unit of length equal to 10\u207b\u00b9\u2070 meter, using the current, or one of the historical, definitions of the SI units.\n\nThe \u00e5ngstr\u00f6m unit appears in the International System of Units (SI), 1st ed. (1970) defined as \"1 \u00c5 = 0.1 nm = 10\u207b\u00b9\u2070 m\".\n\nThe \u00e5ngstr\u00f6m unit was implicitly redefined via the redefinition of the metre at the 17th CGPM meeting (1983), resolution 1.\n\n- The International System of Units (SI), 1st ed. (1970) categorizes the unit as \"temporarily admitted\" for use with the SI units.\n- The International System of Units (SI), 7th ed. (1998) changes the categorization to \"Other non-SI units currently accepted for use with the International System.\"\n- The International System of Units (SI), 8th ed. (2006) changes the categorization to \"Other non-SI units\" and adds as a clarifying footnote \"The \u00e5ngstr\u00f6m is widely used by x-ray crystallographers and structural chemists because all chemical bonds lie in the range 1 to 3 \u00e5ngstr\u00f6ms. However it has no official sanction from the CIPM or the CGPM.\"\n- The \u00e5ngstr\u00f6m is omitted in the International System of Units (SI), 9th Edition (2019).\n\nThis is a generalized definition taken to reference the current, or one of the historical, SI unit definitions.\nThis definition is intended for situations when it is not possible to be more precise, e.g., in contexts where data have been collected that uses different historical SI definitions.",
            "compatibility": [
                "https://schemas.optimade.org/defs/v1.2/units/si/1970/temporary/angstrom",
                "https://schemas.optimade.org/defs/v1.2/units/si/1983/temporary/angstrom"
            ],
            "resources": [
                {
                    "relation": "Definition in the International System of Units (SI), 1st Edition",
                    "resource-id": "https://www.bipm.org/en/publications/si-brochure"
                },
                {
                    "relation": "Redefinition of the metre at the 17th CGPM meeting (1983), resolution 1",
                    "resource-id": "https://www.bipm.org/en/committees/cg/cgpm/17-1983/resolution-1"
                },
                {
                    "relation": "Wikipedia article describing the unit",
                    "resource-id": "https://en.wikipedia.org/wiki/Angstrom"
                }
            ],
            "defining-relation": {
                "base-units": [
                    {
                        "symbol": "m",
                        "id": "https://schemas.optimade.org/defs/v1.2/units/si/general/metre"
                    }
                ],
                "base-units-expression": "m",
                "scale": {
                    "exponent": -10
                }
            },
            "x-optimade-definition": {
                "label": "angstrom_si_general",
                "kind": "unit",
                "format": "1.2",
                "version": "1.2.0",
                "name": "angstrom"
            }
        }
    ],
    "x-optimade-requirements": {
        "support": "may",
        "sortable": false,
        "query-support": "none"
    },
    "type": [
        "object",
        "null"
    ],
    "required": [
        "degree",
        "cutoff",
        "global_order",
        "local_orders",
        "coordination_numbers"
    ],
    "description": "Steinhardt bond-orientational order of a set of atoms, from spherical harmonics Y_lm of the directions of directed neighbour bonds within a cutoff. No neighbour-of-neighbour averaging and no crystalline/liquid classification is implied.\n\n**Requirements/Conventions**:\n\n- `degree` (integer) is the harmonic degree l.\n- `cutoff` (angstrom) is the neighbour cutoff, inclusive.\n- `global_order` (dimensionless, null when there are no bonds) is the bond-weighted Q_l = sqrt(4 pi / (2 l + 1) * sum_m abs(<Y_lm>_bonds)^2), pooling all directed bonds (each pair contributes both r and -r); it is identically zero (to rounding) for odd l.\n- `local_orders` (dimensionless, dimension `_httk_dim_atoms`) is the per-atom q_l, null for an atom without neighbours.\n- `coordination_numbers` (dimensionless integers, dimension `_httk_dim_atoms`) is the number of neighbour bonds per atom.\n- Atoms are in the order of the analysed positions.\n\nA null value means the quantity is not available or not recorded.",
    "properties": {
        "degree": {
            "x-optimade-type": "integer",
            "x-optimade-unit": "dimensionless",
            "type": [
                "integer"
            ]
        },
        "cutoff": {
            "x-optimade-type": "float",
            "x-optimade-unit": "angstrom",
            "type": [
                "number"
            ]
        },
        "global_order": {
            "x-optimade-type": "float",
            "x-optimade-unit": "dimensionless",
            "type": [
                "number",
                "null"
            ]
        },
        "local_orders": {
            "x-optimade-type": "list",
            "x-optimade-unit": "inapplicable",
            "x-optimade-dimensions": {
                "names": [
                    "_httk_dim_atoms"
                ],
                "sizes": [
                    null
                ]
            },
            "type": [
                "array"
            ],
            "items": {
                "x-optimade-type": "float",
                "x-optimade-unit": "dimensionless",
                "type": [
                    "number",
                    "null"
                ]
            }
        },
        "coordination_numbers": {
            "x-optimade-type": "list",
            "x-optimade-unit": "inapplicable",
            "x-optimade-dimensions": {
                "names": [
                    "_httk_dim_atoms"
                ],
                "sizes": [
                    null
                ]
            },
            "type": [
                "array"
            ],
            "items": {
                "x-optimade-type": "integer",
                "x-optimade-unit": "dimensionless",
                "type": [
                    "integer"
                ]
            }
        }
    }
}