xsuite/xtrack: Xtrack version 0.104.2

Changes

• Added new generic transform elements: Rotation, Translation, and TimeDelay. Rotation using radians to specify angles.
• Refactor survey behavior: shifts and rotations are propagated through the element-level _propagate_survey method instead of survey-level ref_shift_* / ref_rot_* columns, which are removed.
• Line.attr['ks'] generalized to include own ks, parent ks, and the average of ks_profile[0] / ks_profile[1].
• Fix in Multipole fringe: normal/skew fringe strengths scaled by particle chi.
• Radiation-analysis Twiss reuses the already computed closed orbit when recomputing the R matrix for damping rates.
• Fix: Composer placement with from_anchor='center' / 'centre' for thin-element groups.
• Environment.place(..., at='string') is now interpreted as at=0, from_='string' when 'string' is an element name.
• Line.extend(...) accepts either a line Line or a list of strings.
• Line.get_table(), SurveyTable, and Twiss strengths output include a prototype column.
• View delegates __iter__ and __contains__ to the viewed object.
• Added Line.xcoll and Environment.xcoll facades that delegate to xcoll if installed.
• Added Environment.xfields facade for beam-beam helper operations.
• RFMultipole supports radian fields phase, phase_n, and phase_s; tracking sums them with legacy degree fields where both exist.
• LossLocationRefinement recognizes the new Rotation and Translation elements.

Deprecations

• compute_* methods and functions deprecated in favour of get_* Line.compute_R_matrix(...) -> Line.get_R_matrix(...), xtrack.twiss.compute_R_matrix(...) -> xtrack.twiss.get_R_matrix(...), Line.compute_T_matrix(...) -> Line.get_T_matrix(...), xtrack.twiss.compute_T_matrix_line(...) -> xtrack.twiss.get_T_matrix_line(...), xtrack.linear_normal_form.compute_linear_normal_form(...) -> xtrack.linear_normal_form.get_linear_normal_form(...), xtrack.survey.compute_survey(...) -> xtrack.survey.get_survey(...). ApertureModel.compute_max_aperture_sigma_bisection(...) -> get_max_aperture_sigma_bisection(...), compute_max_aperture_sigma_rays(...) -> get_max_aperture_sigma_rays(...), compute_max_aperture_sigma_exact(...) -> get_max_aperture_sigma_exact(...), compute_beam_envelopes_at_sigma(...) -> get_beam_envelopes_at_sigma(...).
• Legacy transform elements are deprecated: XYShift -> Translation, ZetaShift -> TimeDelay, XRotation -> Rotation(rot_x_rad=...), YRotation -> Rotation(rot_y_rad=...), SRotation -> Rotation(rot_s_rad=...).
• Degree-based RF phase fields are deprecated in favour of radian-based fields: Cavity.lag -> Cavity.phase, CrabCavity.lag -> CrabCavity.phase, RFMultipole.lag -> RFMultipole.phase, RFMultipole.pn -> RFMultipole.phase_n, RFMultipole.ps -> RFMultipole.phase_s.
• Builder deprecated in favour of Composer: Line.builder -> Line.composer, Environment.new_builder(...) -> Environment.new_line(..., compose=True), Builder / xtrack.builder -> Composer / xtrack.composer.
• Legacy line-inspection APIs are deprecated in favour of table-based access: Line.to_pandas(...) -> Line.get_table(...), Line.get_s_position(...) and Line.get_s_elements(...) -> Line.get_table() position columns, Line.get_elements_of_type(...) -> tt = line.get_table(); tt.rows.match(element_type='...').
• Legacy variable-value shortcuts are deprecated in favour of direct item access or vars.val: Environment.varval[...] / Environment.vv[...] -> Environment[...] or Environment.vars.val[...], Line.varval[...] / Line.vv[...] -> Line[...] or Line.vars.val[...].
• Legacy Xcoll and Xfields entry points are deprecated in favour of facade namespaces: Line.scattering -> Line.xcoll.scattering, Line.collimators -> Line.xcoll.collimators, Environment.install_beambeam_interactions(...) -> Environment.xfields.install_beambeam_interactions(...), Environment.configure_beambeam_interactions(...) -> Environment.xfields.configure_beambeam_interactions(...), Environment.apply_filling_pattern(...) -> Environment.xfields.apply_filling_pattern(...).
• Environment.from_madx(...) is deprecated in favour of xtrack.load(...); if cpymad is required, use Line.from_madx_sequence(...) and import lines into an Environment.
• Legacy View inspection helpers are deprecated in favour of .xdeps inspection: View.get_value(...) -> .xdeps.value, View.get_expr(...) -> .xdeps.expr, View.get_info(...) -> .xdeps.info().
• Legacy table fields are deprecated in favour of renamed fields: SurveyTable.p0 -> SurveyTable.XYZ, SurveyTable.W -> SurveyTable.E_matrix, TwissTable.angle_rad -> TwissTable.angle.

Full Changelog: https://github.com/xsuite/xtrack/compare/v0.104.1...v0.104.2