How does simulated annealing solve IEP and keep-apart rules offline?
When you enter a roster and seating rules, an in-browser optimization engine tests up to 1,600 desk swaps in memory to minimize placement conflicts. Student names, vision or IEP front-row lists, and behavioral separation pairs remain inside your tab with zero external network calls.
Manually arranging thirty desks when four learners need front-zone access, five pairs clash, and two English learners need peer buddies quickly creates circular trade-offs. Separating one talkative pod often pushes an accommodated student out of Row 1.
To balance competing constraints, solveSeatingChart runs a simulated annealing combinatorial optimization algorithm cooling temperature from 12 down to 0.15 via Math.exp(-delta / temp) across three weighted rules.
- Front-zone priority (
50 + 25ypenalty): Names in Preferential front-zone seats (vision / IEP) incur heavy penalties outsideisFrontZone, scaled by distanceyfrom the board. - Keep-apart separation (
45penalty): Pairs in Keep apart pairs sharing a pod (podId) or sitting within Euclidean distance1.65 * max(w, h)are pushed apart. - Peer-buddy pairing (
30penalty): Partners in Pair together (peer buddies / language support) are pulled into adjacent seats or shared table pods.
Comparing rows, partner pairs, pods, lab tables, and U-shapes
Switching Desk layout recalculates normalized room coordinates, seat codes, front-zone flags, and neighbor graphs automatically. Before mapping group tables, you can also generate snake-drafted cooperative learning groups balanced by readiness tier for 4-desk pods or 6-desk pods.
| Desk layout | Seat codes | Neighbor proximity rule | Front-zone (isFrontZone) seats |
|---|---|---|---|
| Traditional rows | R1C1..R10C10 |
Euclidean radius < 1.65 desk widths |
Full Row 1 nearest whiteboard |
| Partner pairs | R1C1..R10C10 (3.2% aisle) |
Shared 2-desk pair plus close neighbors |
Full Row 1 across paired columns |
| 4-desk pods | T1-1..Tn-4 (2 x 2 quads) |
All 4 desks in pod Tn are neighbors |
Front row of table pods (T1..T3) |
| 6-desk pods | T1-1..Tn-6 (2 x 3 pods) |
All 6 desks in pod Tn are neighbors |
Front row of six-seat clusters |
| U-shape seminar | L1..n, B1..n, R1..n |
Adjacent arm pairs and corner radius | Front seats L1, L2, R1, R2 |
| Science lab tables | Lab1-1..LabN-4 |
All 4 stools sharing bench LabN |
Front two benches Lab1 and Lab2 |
Keeping IEP accommodations and separation notes off printed maps
Printed seating charts sit on open lecterns, travel inside substitute binders, and hang near classroom doors during the first week of school. Displaying medical, vision, 504, IEP, or behavioral notes beside student names on visible maps risks exposing protected records.
Processing rosters and preferential seating inside local tab memory
Under the U.S. Department of Education FERPA privacy guide, personally identifiable student education records require strict safeguards against unauthorized third-party disclosure. Using a local browser seating chart maker avoids cloud sign-ups and external roster uploads altogether.
Every spreadsheet read, constraint check, and PDF export runs inside local JavaScript memory and edu.worker.ts. Closing the browser tab clears your roster and accommodation lists immediately.
Preventing confidential tags from leaking onto wall or binder charts
The panel heading Private local seating rules (never printed on chart) reflects a strict output boundary. While front-zone, keep-apart, and buddy lists steer seat assignment, neither the vector PDF generator nor the CSV exporter ever writes those rules into downloaded files.
Each desk box prints only its neutral coordinate code (R1C3, T2-4, Lab1-2) in 7 pt gray type above the student’s bold name. Nobody reading a substitute folder can tell which seats fulfilled formal accommodations.
Why print a 180-degree podium view for substitute teachers?
Standard charts place the whiteboard at the top of the page, forcing a teacher standing at the front lectern to flip left and right mentally while taking attendance. Choosing 2-page packet (both views) under PDF perspective prints both the student-facing map and a 180-degree mirrored podium map in one landscape PDF.
On the mirrored page, every desk coordinate transforms via 1 - x - w and 1 - y - h while FRONT OF ROOM / WHITEBOARD & TEACHER PODIUM moves to the bottom edge. Holding that sheet behind the lectern aligns the lower-right box on paper with the physical desk to your front right.
Consistent with the Family Educational Rights and Privacy Act FAQ, substitute folders stay compliant when they share operational seat locations without disability annotations. For new semester homerooms, you can also print folded tent desk nameplates from the same roster so students spot their assigned pods quickly.
Tip: Click Flip to teacher podium view above Interactive classroom map before making manual desk swaps so left and right match your view from the front lectern.
Interactive desk swaps, reproducible seeds, and CSV roster imports
Automated optimization resolves complex rule clashes quickly, and two-click manual swaps let you polish individual seat choices afterward. Combining gradebook imports with deterministic seeds makes rotating six class sections straightforward.
Importing gradebook CSV and Excel sheets up to 15 MB
Dropping a .csv, .tsv, .txt, or .xlsx roster up to 15 MB (15,000,000 bytes) loads Column A names directly into Student roster (one per line). Spreadsheets following the RFC 4180 comma-separated values specification keep apostrophes and hyphenated surnames intact while skipping Student Name headers.
In Traditional rows and Partner pairs, set Rows (2–10) and Columns (2–10) to match your room grid. Pod, lab-table, and U-shape geometries add extra tables automatically whenever enrollment exceeds 20 learners.
Fine-tuning desks with two-click swaps and deterministic seeds
Status badges above the floor map report filled seats (20 / 20 desks filled) and met rules (5/5 rules satisfied). Clicking any two desks exchanges their occupants in place without reshuffling surrounding pods, and Arrangement seed (fall-unit-1) reproduces the exact layout whenever needed; pair your finished maps with weekly period timetables without block overlaps inside your prep binder.
Printing landscape classroom floor plans for clipboards and binders
Floor plans render as crisp landscape vector PDFs (792 x 612 pt on US Letter (landscape) or 841.89 x 595.28 pt on A4 (landscape)) with 34 pt margins and Helvetica fonts. Student names wrap across two centered lines at 8.5 pt or 9.5 pt bold without clipping.
Choosing US Letter or A4 landscape geometry and empty-desk visibility
Keeping Show empty desks checked outlines vacant seats in 96% light gray with coordinate badges (R5C6) so you see open spots for incoming transfer students. Unchecking Show empty desks hides unused slots when your physical room has uneven row lengths.
Pick Standard view (front at top) when projecting the PDF on the classroom screen on day one. Select Substitute podium view (180°) or 2-page packet (both views) when printing clipboard copies for roll call and lab safety checks.
Using exported seat-code CSV tables for lab inventory and testing
Clicking Export seat map CSV saves a four-column UTF-8 sheet (Seat Label, Group / Pod, Front Zone, and Student Name) ordered by desk code. Science teachers use those rows to match microscope numbers or Chromebook slots to exact desks, and proctors running midterms from the same grid can open full-screen invigilator room clocks on the front screen.