Use Case 1: Layout Generation for Cesr Simulations

1. Characteristic Information
   • Goal in context: Survey information on magnet placement is converted into an accurate layout file for computer simulations. Have only local sections of the ring be affected by local changes in magnet placement.
   • Scope: System: layout generation app
   • Level: Summary
   • Preconditions: Magnet locations must be measured.
   • Success end condition: An accurate layout is produced that is compatible with the simulation software.
   • Failed end condition: The produced layout is not an accurate representation of real magnet positions.
   • Primary actor: Cesr simulator.
   • Trigger: Change in accelerator's magnet positions.
2. Main Success Scenario
   1. Read in bend survey data.
   2. Get the endpoints of the bends and thus the endpoints of the straight sections in the ring.
   3. Find the positions of all elements relative to the straight line connecting the bends.
   4. Transform the positions to a coordinate format that the simulation requires.
   5. Generate a layout file with the element positions with the transverse coordinates zeroed for design simulations.
3. Extensions
   • 5a. Generate a second layout file with the exact positions, including transverse offsets.
4. Variations
5. Related Information
   • Priority: High
   • Performance Target:
   • Frequency: Roughly 3 per year
   • Superordinate use case:
   • Subordinate use case:
   • Channel to primary actor:
   • Secondary actor: Magnet surveyor
   • Channel to secondary actors: Data file of measurements
6. Schedule
7. Open Issues