Caution
US ATLAS documents and code samples hosted in this repository are visible to the general public. Please do not put personal identifiable information, usernames and passwords, or methods to access restricted US ATLAS and ATLAS (international) resources in this area.
US ATLAS hosts three shared Tier 3 computing spaces at BNL, SLAC, and UChicago, also known as Analysis Facilities (AF). These three facilities are available to all US ATLAS physicists and computer scientists. They are organized and managed to support US ATLAS users' need for computing resources including login, interactive and batch jobs, access to ATLAS data, private data storage, etc.
The AFs also support a wide variety of tools specific for analysis, including ATLAS/CERN software in CVMFS, Grid middleware, Rucio clients, Machine Learning packages, MPI, Jupyter Lab with PyROOT, XCache with auto data discovery, GPUs, etc. The three facilities are backed by staff to support software environments, unix systems and storage.
View the facility usage dashboard
The deployed documentation is available at usatlas.github.io/af-docs and covers:
- User Onboarding — Applying for accounts at BNL, SLAC, and UChicago
- Quickstart Guides — Walkthroughs for accessing the Analysis Facilities
- Machine Learning Containers — Information and use of ML containers
- ATLAS Containers — Information and use of ATLAS containers
- Data Storing, Accessing, and Sharing — Using ATLAS data at AFs
- Jupyter at Analysis Facilities — Jupyter and how to use it at AFs
- Data Analysis Tutorials — Step-by-step tutorials on using AFs for analyses
- Containers — Container-based data processing at AFs
- Using VSCode — Guide on using Visual Studio Code at AFs
- FAQ — Answers to frequently asked questions
- Claude Code Skills — AI workflow assistant skills for Claude Code users
Corrections and improvements are welcome. To contribute:
- Fork this repository
- Edit the relevant files in the
docs/directory - Open a pull request against
mainwith a brief description of what you changed
For small fixes (typos, broken links, outdated info) just open a PR directly. For larger changes, consider opening an issue first to discuss the approach.
See the Getting Help page for support options and how to reach the ATLAS AF team.