Performing Schedule25 Optimizer Runs

After you prepare your environment by following the instructions in Optimizer Setup, you're ready to place classes with the Optimizer. Each of these steps is described in greater detail below.

Step

Explanation

Create event and location searchesDecide which sections need to be placed by the Optimizer and which rooms are appropriate for them.
Start a new runChoose a name for your Optimizer run and configure its settings.
Run the Prepare Data stepThe Optimizer uses your event and location searches to capture data. You should not make any changes in 25Live after this point.
Run the Optimization stepThe Optimizer makes recommendations based on departmental preferences, individual class requirements, and overall placement.
Use the Meeting Pattern GridUse a drag and drop grid to adjust these recommendations to your satisfaction.
Accept and assign Optimizer resultsFinalize the results by assigning them in 25Live.

Create Event and Location Searches

Every Optimizer run requires two searches:

  • An event search consisting of all the sections you want to place
  • A location search consisting of all the valid rooms for these sections

Save these searches in 25Live before continuing with the Optimizer. See the "Using Advanced Search Options" section in Searching for Events, Locations, Organizations, Resources, and Contacts for instructions on how to create and save searches.

Best Practices for Event and Location Searches

Your event search should include only the sections that need placement. Consider using "missing location assignment" in your search terms to filter out anything that has already been assigned a location.

Typically your location search should only include general assignment classrooms and not specialized facilities like laboratories unless you are using the Optimizer to place lab classes.

Start a New Run

  1. In X25 Analytics, go to Optimizer > Manage Runs.
  2. Click the Add a Run button to begin.
    Image: Click Add a Run in the Optimizer tab under Manage Runs
  3. In the screen that opens, enter a name for the run and configure the rest of the settings as described in Schedule25 Optimizer Settings.

    A screen to define Optimizer run settingsDetails when adding a new run

  4. Click Save to save the run.

Run the Prepare Data Step

The Optimizer functions by taking a snapshot of data from 25Live and making calculations based on that snapshot. The "Prepare Data" step is when you create that snapshot.

Once you perform this step, all schedulers should freeze their work. You should avoid making any changes to these classes in 25Live or your SIS so that they don't get out of sync with the snapshot you just took. Otherwise, the calculations will be inaccurate.

  1. On the Manage Runs page, select the run you just created and click Start.
  2. With the Prepare screen open, click Run Prepare. The Optimizer will take a short time to analyze the event and location searches you specified. Usually, this lasts under a minute.
    Count of fatal errors, errors, and warningsImage: Schedule25 preparation results display any fatal errors and/or warnings.


  3. When it is finished, you are presented with a list of errors and warnings based on your input data including, potentially, any of the following:
    1. Fatal errors must be resolved before the run can proceed. Fatal errors include problems with your event/location searches or an issue with your Schedule25 license.
    2. Errors that won't prevent the run from continuing but will affect your results. Errors include things like location preferences or requirements that can't be met by any location in your location search results.
    3. Warnings that won't prevent the run from continuing but may affect your results. Warnings include potential problems that may or may not be intentional, such as sections with zero headcounts.
  4. Make adjustments in 25Live to your events, locations, and organizations as necessary, then run the Prepare Data step again.

Run the Optimization Step

In this step, the Optimizer will perform its calculations. No assignments will be made in 25Live and nothing will be sent back to the SIS yet.

  1. On the Manage Runs page, select your desired run and click Start.
  2. Click the Optimize button at the top of the pop-up window to move to the Optimization step.
  3. Click the Optimize button on the right to perform the optimization calculations. Usually, this lasts under a minute.
    Optimize viewImage: Schedule25 results summary
  4. When the optimization is finished, you will see a summary of the placement results.
    1. Placed classes include the Optimizer's suggested assignments.
    2. Not placed includes classes that potentially could have been placed, but there were not enough available rooms.
    3. Impossible to place indicates classes whose preferences were so strict that there were zero available rooms.
  5. Click View Report to download the availability report, a summary of what location availability would be after all placements are accepted.

(Optional) Use the Meeting Pattern Grid

You can adjust the results of the Optimizer's suggested placements before you accept them using the Meeting Pattern Grid in 25Live. Visit that page for detailed instructions on navigating and using this tool.

As with the Optimize step, the actions you take here are not final. Nothing will be assigned in 25Live and nothing will be sent to the SIS until you accept the results.

  1. In 25Live, open the Meeting Pattern Grid from the upper right menu.
  2. Select the run whose results you wish to alter. The events will be displayed in a grid-like the one below.
    Meeting Pattern Grid
    25Live's Meeting Pattern Grid
  3. Click and drag events to new locations. Take special note of the UNASSIGNED row at the top of locations, which contains all events which were marked Not Placed or Impossible to Place in the previous step.
  4. When you are satisfied, use the Send to Optimizer button to save your changes. These will be reflected in the Assign step of the Optimizer,

Accept and Assign Optimizer Results

Up to this point, the Optimizer's results are just suggestions. In this step, you'll finalize the assignments and make them real in 25Live.

  1. On the Manage Runs page, select your desired run and click Start.
  2. Click the Assign button at the top of the pop-up window to move to the assignment step.
  3. The results of the Optimizer's suggestions will be summarized below. If you edited the run using the Meeting Pattern Grid, your changes are included. results include:
    1. Suggested Assignments
    2. Accepted Assignments
    3. Not Placed
    4. Impossible to Place
    5. Messages
  4. Click View Report to download the placement report, a spreadsheet of all the Optimizer results grouped by their status.
  5. Click any of the result totals to display a list of matching classes. Select Suggested Assignments to begin accepting results.
    Assign step suggested assignmentsImage: Schedule25 placement results.
  6. Select the placements you wish to accept:
    1. Check individual classes with the checkbox on the left
    2. Select the entire results with Check All
    3. Click classes while holding SHIFT or CTRL on your keyboard to highlight them, then click Check List to select the highlighted rows
  7. Click Assign to make assignments in 25Live. Depending on the number of classes selected, this may take some time.
  8. After their assignments are made, classes appear in the Accepted Assignments results area. You may click Unassign in that area to remove the assignment in 25Live.
A Note About Numbers

You might notice a slight discrepancy in the total number of classes on this step compared to the results on the Optimize step.

When two events are bound together (as is the case for cross-listed or back-to-back sections) the Optimizer treats them as a unit and they count as a single "placement" for purposes of the algorithm's calculations.

On the Assign step, each event is listed separately regardless of whether it is bound to another event. Therefore, the number of events listed in those lists is greater than the "placed classes" displayed in the optimization step summary.