{"id":32176327,"url":"https://github.com/bmad-sim/pytao","last_synced_at":"2026-01-16T13:32:58.304Z","repository":{"id":43860732,"uuid":"335029544","full_name":"bmad-sim/pytao","owner":"bmad-sim","description":"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.","archived":false,"fork":false,"pushed_at":"2026-01-14T17:10:03.000Z","size":4475648,"stargazers_count":11,"open_issues_count":16,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-01-14T21:19:11.256Z","etag":null,"topics":["bmad","simulation","tao"],"latest_commit_sha":null,"homepage":"https://bmad-sim.github.io/pytao","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bmad-sim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["DavidSagan","ChristopherMayes"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2021-02-01T17:30:12.000Z","updated_at":"2026-01-14T17:06:50.000Z","dependencies_parsed_at":"2023-01-25T23:16:53.127Z","dependency_job_id":"e18bc939-8552-4630-b5ed-bcf947bae69d","html_url":"https://github.com/bmad-sim/pytao","commit_stats":null,"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/bmad-sim/pytao","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmad-sim%2Fpytao","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmad-sim%2Fpytao/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmad-sim%2Fpytao/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmad-sim%2Fpytao/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bmad-sim","download_url":"https://codeload.github.com/bmad-sim/pytao/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmad-sim%2Fpytao/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479033,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bmad","simulation","tao"],"created_at":"2025-10-21T19:58:04.202Z","updated_at":"2026-01-16T13:32:58.283Z","avatar_url":"https://github.com/bmad-sim.png","language":"Python","funding_links":["https://github.com/sponsors/DavidSagan","https://github.com/sponsors/ChristopherMayes"],"categories":[],"sub_categories":[],"readme":"# PyTao\n\n[PyTao](\u003c(https://bmad-sim.github.io/pytao/index.html)\u003e) is Python interface for [Tao](https://www.classe.cornell.edu/bmad/tao.html), which is based on the Bmad subroutine library for relativistic charged–particle and X-ray simulations in accelerators and storage rings.\n\nDocumentation for Bmad and Tao, as well as information for downloading the code if needed is given on the [Bmad website](https://www.classe.cornell.edu/bmad).\n\n| **`Documentation`**                                                                                                         |\n| --------------------------------------------------------------------------------------------------------------------------- |\n| [![Documentation](https://img.shields.io/badge/pytao-examples-green.svg)](https://bmad-sim.github.io/pytao/examples/basic/) |\n| [![Documentation](https://img.shields.io/badge/api-reference-blue.svg)](https://bmad-sim.github.io/pytao/api/pytao/)        |\n\n## Installation\n\nSee the [PyTao installation instructions](https://bmad-sim.github.io/pytao/user_docs/index.html) for details. The preferred installation method is using conda:\n\n```\nconda install -c conda-forge pytao\n```\n\nCurrently 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).\n\n## Current Build status and Release Info\n\n\u003ctable\u003e\u003ctr\u003e\u003ctd\u003eAll platforms:\u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://dev.azure.com/conda-forge/feedstock-builds/_build/latest?definitionId=12517\u0026branchName=master\"\u003e\n        \u003cimg src=\"https://dev.azure.com/conda-forge/feedstock-builds/_apis/build/status/pytao-feedstock?branchName=master\"\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n| Name                                                                                                           | Downloads                                                                                                           | Version                                                                                                           | Platforms                                                                                                           |\n| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |\n| [![Conda Recipe](https://img.shields.io/badge/recipe-pytao-green.svg)](https://anaconda.org/conda-forge/pytao) | [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/pytao.svg)](https://anaconda.org/conda-forge/pytao) | [![Conda Version](https://img.shields.io/conda/vn/conda-forge/pytao.svg)](https://anaconda.org/conda-forge/pytao) | [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/pytao.svg)](https://anaconda.org/conda-forge/pytao) |\n\n## Resources\n\n[Bmad website](https://www.classe.cornell.edu/bmad)\n\n## Quickstart\n\nStart a quick PyTao session with IPython using:\n\n```bash\n$ pytao -init tao.init\n----------------------------------------------------------\nInitializing Tao object with the following: -init tao.init\nType`tao.` and hit tab to see available commands.\n----------------------------------------------------------\n\nIn [1]: tao\nOut[1]: \u003cTao init='-init tao.init' so_lib='/path/to/libtao.so'\u003e\n```\n\nTo use PyTao's plotting with Matplotlib (`\"mpl\"`, alternatively Bokeh `\"bokeh\"`), use the `--pyplot` argument.\n\n```bash\n$ pytao --pyplot=mpl -init \"$ACC_ROOT_DIR/bmad-doc/tao_examples/cbeta_cell/tao.init\"\n------------------------------------------------------------------------------------------------------\nInitializing Tao object with: -init /Users/klauer/Repos/bmad/bmad-doc/tao_examples/cbeta_cell/tao.init\n\nType `tao.` and hit tab to see available commands.\n------------------------------------------------------------------------------------------------------\n\n* Matplotlib mode configured. Pyplot available as `plt`. *\n```\n\nStart pytao's GUI from the command-line with:\n\n```bash\npytao-gui -init tao.init\n```\n\n## Release process\n\nTo release a new PyTao version with updated bindings for the Fortran functions:\n\n1. Activate a conda environment with `bmad` installed with the target version\n2. Double-check that bmad is updated in the environment via `conda list |grep bmad`\n3. Run `bash scripts/bump_minimum_version.sh`\n4. Commit, push, merge PR, tag, ...\n\n## License\n\n[GNU General Public License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmad-sim%2Fpytao","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbmad-sim%2Fpytao","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmad-sim%2Fpytao/lists"}