PyTao
PyTao is Python interface for Tao, which is based on the Bmad subroutine library for relativistic charged–particle and X-ray simulations in accelerators and storage rings.
Documentation for Bmad and Tao, as well as information for downloading the code if needed is given on the Bmad website.
Documentation |
|---|
 |
 |
Installation
See the PyTao installation instructions for details. The preferred installation method is using conda:
conda install -c conda-forge pytao
Currently PyTao requires an installed Bmad distribution compiled with the ACC_ENABLE_SHARED="Y" or ACC_ENABLE_SHARED_ONLY="Y" flag. This can be set in the bmad_dist/util/dist_prefs file (the default setting is fine).
Current Build status and Release Info
| All platforms: |
|
| Name | Downloads | Version | Platforms |
|---|---|---|---|
 |
 |
 |
 |
Resources
Quickstart
Start a quick PyTao session with IPython using:
$ pytao -init tao.init
----------------------------------------------------------
Initializing Tao object with the following: -init tao.init
Type`tao.` and hit tab to see available commands.
----------------------------------------------------------
In [1]: tao
Out[1]: <Tao init='-init tao.init' so_lib='/path/to/libtao.so'>
To use PyTao's plotting with Matplotlib ("mpl", alternatively Bokeh "bokeh"), use the --pyplot argument.
$ pytao --pyplot=mpl -init "$ACC_ROOT_DIR/bmad-doc/tao_examples/cbeta_cell/tao.init"
------------------------------------------------------------------------------------------------------
Initializing Tao object with: -init /Users/klauer/Repos/bmad/bmad-doc/tao_examples/cbeta_cell/tao.init
Type `tao.` and hit tab to see available commands.
------------------------------------------------------------------------------------------------------
* Matplotlib mode configured. Pyplot available as `plt`. *
Logging
PyTao stays quiet by default. To see its log output, call pytao.configure_logging:
import pytao
pytao.configure_logging(level="DEBUG")
On the command line, use --pylog (e.g. pytao --pylog DEBUG -init tao.init). See the
logging documentation for the full details,
including writing to a file and controlling how Tao's own message levels map to Python logging.
Release process
To release a new PyTao version with updated bindings for the Fortran functions:
- Activate a conda environment with
bmadinstalled with the target version - Double-check that bmad is updated in the environment via
conda list |grep bmad - Run
bash scripts/bump_minimum_version.sh - Commit, push, merge PR, tag, ...
License
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pytao-1.2.2.tar.gz.
File metadata
- Download URL: pytao-1.2.2.tar.gz
- Upload date:
- Size: 351.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9e3ffbdd48fade8515a150ac2318053af36bed329d4ce2731023e78d24bfdc44
|
|
| MD5 |
d792262967939f3b964af096ea0118bd
|
|
| BLAKE2b-256 |
d37fe19d0ffd86e7f77d3b6c531a18f335739d17332d0c754232e26ab884f383
|
