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 |
|---|
 |
 |
Installation
See the PyTao installation instructions for details. The preferred installation method is using conda, which includes everything you need to run PyTao (including Bmad itself):
conda install -c conda-forge pytao
Current Build status and Release Info
| 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.
For developers: the 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
Metadata
2 maintainers
Release files for pytao 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pytao-1.3.0.tar.gz | 384.9 kB | Details |
Release files / pytao-1.3.0.tar.gz
| Download URL | pytao-1.3.0.tar.gz |
|---|---|
| Size | 384.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b16614e0112e7343f9567af9227efb5168e8d0fda44cc95321221bfb9bb389a4
|
|
BLAKE2b-256 checksum How to use checksums |
e14a7799d983f4d128e0c0b9bca0874e91cc3c574b6ce5bed40a0067333aabe3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
