Tutorial on beamline simulations at the Bay Area Light Sources Joint Users' Meeting

Oasys2

Download Oasys 2: https://www.aps.anl.gov/Science/Scientific-Software/OASYS
–>direct link: https://github.com/oasys-kit/OASYS2/wiki

Beamline models (Oasys 2.0)

ALS 5.3.1 (R&D): ALS 05.3.1 Shadow4-Oasys2.ows

ALS-U 7.01 (COSMIC):  ALS-U 07.0.1 COSMIC Upgrade Shadow4-Oasys2

SSRL BL 18 (HAXPES) : ssrl_bl18_haxpes_LE111_2026_09_20.ows

–>aberrations for SSRL 10 VKB mirror: vkbmirror_oasys.txt 

Spectra

Download spectra (Windows/Mac): https://spectrax.org/spectra/

Online app: https://spectrax.org/spectra/app/12.2/

Heatload (Spectra & Oasys)

Spectra file for SSRL BL10:  SSRL_BL10.json

Oasys file for SSRL BL10: HeatLoad SSRL BL10-2 M0.ows

CXRO website – X-ray reflectivity of a thick mirror https://henke.lbl.gov/optical_constants/mirror2.html
-> from https://henke.lbl.gov/optical_constants/

Aberrations

aberrations for SSRL 10 VKB mirror: vkbmirror_oasys.txt 

Shadow4 & beamline scripts

https://github.com/oasys-kit/shadow4

pip install shadow4

Shadow4 scripting tutotial: https://github.com/whorwhey/shadow4_scripting_tutorial 

Colab (online python) notebooks: https://drive.google.com/drive/folders/1cp_eNQJs2yk6pHcAmEi1z_ricdRKXwXT?usp=drive_link 

Calculation spreadsheet

BALS Soft x-ray beamline calculations sheet

Presentations

Using Oasys 2.0 for raytracing: Beamline simulation workshop - Intro and using Oasys 2.0 (A Islegen-Wojdyla, Sept 2026).pptx

Calculating Photon Absorption Heat Loads (Mattew Church): Calculating Photon Absorption Heat Loads.pptx

Example Beamline in OASYS2.0 – BL18 HAXPES (Thomas Rabedeau): ssrl_bl18_demo_2026_09_20.pptx

Scripting with Shadow4: Francis_BL_sim_tutorial_20260920.pptx