A JSON based lattice file format
Project description
LatticeJSON
LatticeJSON is a JSON based lattice file format. JSON is able to describe complex data structures, has a human readable syntax and is available in all common programming language. It is therefore an appropriate choice to characterize the magnetic lattice of a particle accelerator.
Specification
This repository contains the Specification of LatticeJSON in form of a JSON Schema.
Example
A LatticeJSON file for a FODO lattice:
{
"version": "2.2",
"title": "FODO Lattice",
"info": "This is the simplest possible strong focusing lattice.",
"root": "ring",
"elements": {
"d1": ["Drift", {"length": 0.55}],
"q1": ["Quadrupole", {"length": 0.2, "k1": 1.2}],
"q2": ["Quadrupole", {"length": 0.4, "k1": -1.2}],
"b1": ["Dipole", {"length": 1.5, "angle": 0.392701, "e1": 0.1963505, "e2": 0.1963505}]
},
"lattices": {
"cell": ["q1", "d1", "b1", "d1", "q2", "d1", "b1", "d1", "q1"],
"ring": ["cell", "cell", "cell", "cell", "cell", "cell", "cell", "cell"]
}
}
LatticeJSON CLI
This repository also contains a Python based command-line tool which is able validate and convert LatticeJSON files into other common lattice file formats and vice versa.
You can install and update it using pip or pipenv:
pip install -U latticejson
Validate a LatticeJSON file:
latticejson validate /path/to/lattice.json
Convert an elegant lattice file to the LatticeJSON format:
latticejson convert --to json /path/to/lattice.lte
Autoformat one or more LatticeJSON files:
latticejson autoformat /path/to/lattice.json ...
To activate Bash completion add
eval "$(_LATTICEJSON_COMPLETE=source latticejson)"
to your .bashrc
. Or, create an activation script with:
_LATTICEJSON_COMPLETE=source latticejson > latticejson-complete.sh
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for LatticeJSON-0.1.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ba495aee6d33332c36f8a6aeae3ec2cb7367b5c73dcae6aaeb1d8607d330f8ee |
|
MD5 | 417db1e04162cd725ef9cd8eebb84f2a |
|
BLAKE2b-256 | eb0b0b7f13034021e2a81d5ecb12f0e4522659093ceb62288816f4d7f4456fed |