Standard
PNST 984-2024 and PNST 1044-2025: the extended hierarchical state machine language and the CyberiadaML-GraphML document format.
Cyberiada diagrams follow the preliminary national standards (PNST) of Russia of the series “Cyber-physical systems. National cyber-physical platform”. The standards were developed by the Kruzhok Association and submitted by the Technical Committee for Standardization TC 194 “Cyber-physical systems”.
| Part | Standard | Subject |
|---|---|---|
| 1 | PNST 982-2024 | General provisions |
| 2 | PNST 983-2024 | Terms and definitions |
| 3 | PNST 984-2024 | Extended hierarchical state machine programming |
| 4 | PNST 1044-2025 | Document format for extended hierarchical state machine diagrams |
PNST 984-2024
“Cyber-physical systems. National cyber-physical platform. Part 3. Extended hierarchical state machine programming”. Approved by the order of Rosstandart of 27 December 2024 No. 124-pnst, valid from 1 February 2025.
The standard defines the graphical language of extended hierarchical state machine (HSM) diagrams: the states and their nesting, the pseudostates, the transitions, the events, the actions, the comments and how they are drawn. The language is based on Harel statecharts as formalised by UML (ISO/IEC 19505-2) and extended with the events and the actions of the target platform. A diagram can be run by a machine or translated into a program in C/C++, Python and other languages.
The text of the standard in Markdown (in Russian): PNST_984-2024.md.
PNST 1044-2025
“Cyber-physical systems. National cyber-physical platform. Part 4. Extended hierarchical state machine programming. Document format for extended hierarchical state machine diagrams”.
The standard describes the CyberiadaML-GraphML (CGML) format — an XML document based on GraphML and independent of the target platform. A document can be edited, shown, run or translated into other languages.
- The base: the graph format, the document elements (the state machine, the states, the transitions, the comments, the metadata), the diagram geometry.
- The “HSM completeness” extension: submachines, history, entry and exit points, hidden decomposition, comment links.
- The “display” extension: extended geometry, colour marking, comment formatting.
- The “target platforms” extension: machine-readable names, initialisation, dynamic components.
The text of the standard in Markdown (in Russian): PNST_1044-2025.md.
The FA extension
ПРИМС:КА (in Russian) is a project document that extends PNST 984 and PNST 1044 to deterministic finite automata, Mealy and Moore machines included. An automaton is a subset of HSM: simple and composite states, the initial and the final states, external transitions and comments; the input and the output alphabets are declared in the document. Automata are drawn in the finite automaton mode of CyberiadaPro and run by fa-dispatcher-py.
Conformance
The cyberiadaml-compat-tests suite checks that a document conforms to PNST 1044-2025, and that a library reads and writes documents correctly and rejects the wrong ones.
| Profile | What it checks |
|---|---|
| CORE | the base of the format (sections 5–7), mandatory |
| EXT-COMPLETENESS | the “HSM completeness” extension (section 8) |
| EXT-DISPLAY | the “display” extension (section 9) |
| EXT-PLATFORM | the “target platforms” extension (section 10) |
| EXT-FA | the FA extension |
cgmlval— the document validator (Python 3, no dependencies):python3 -m cgmlval validate diagram.graphmlThe RELAX NG schema of the format.
The comparison of the libraries in C, Python, TypeScript and C# on the same documents.