Skip to main content

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
Documentation
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
Conda Recipe Conda Downloads Conda Version Conda Platforms

Resources

Bmad website Bmad source code

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:

  1. Activate a conda environment with bmad installed with the target version
  2. Double-check that bmad is updated in the environment via conda list |grep bmad
  3. Run bash scripts/bump_minimum_version.sh
  4. Commit, push, merge PR, tag, ...

License

GNU General Public License

Metadata

Release files for pytao 1.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pytao 1.3.1
File Size Uploaded
pytao-1.3.1.tar.gz 395.0 kB Details

Release files / pytao-1.3.1.tar.gz

Download URL pytao-1.3.1.tar.gz
Size 395.0 kB
Tags Source
SHA-256 checksum
How to use checksums
e44f65740f6d299338f276a97af10007e312c7e3e531fa3169534d8b4563dd09
BLAKE2b-256 checksum
How to use checksums
7cc284d1b73a693ec9d668d0b5a12e89179bad455f2c27a2622343e550c85a01
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

1.3.2

1 release file

This release

1.3.1 This release

1 release file

1.3.0

1 release file

1.2.4

1 release file

1.2.3

1 release file

1.2.2

1 release file

1.2.1

1 release file

1.2.0

1 release file

1.1.1

1 release file

1.1.0

1 release file

1.0.6

1 release file

1.0.5

1 release file

1.0.4

1 release file

1.0.3

1 release file

1.0.2

1 release file

1.0.1

1 release file

1.0.0

1 release file

0.5.7

1 release file

0.5.6

1 release file

0.5.5

1 release file

0.5.4

1 release file

0.5.3

1 release file

0.5.2

1 release file

0.5.1

1 release file

0.5.0

1 release file

0.4.8

1 release file

0.4.7

1 release file

0.4.6

1 release file

0.4.5

1 release file

0.4.4

1 release file

0.4.3

1 release file

0.4.2

1 release file

0.4.1

1 release file

0.4.0

1 release file

0.3

1 release file

0.2.6

1 release file

0.2.5

1 release file

0.2.4

1 release file

0.2.3

1 release file

0.2.2

1 release file

0.2.1

1 release file

0.2.0

1 release file

0.1.7

1 release file

0.1.6

1 release file

0.1.5

1 release file

0.1.4

1 release file

0.1.3

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page