Skip to content

Krazete/antscoper

Repository files navigation

Antscoper

Antscoper is a tool for viewing the class schedule of every single classroom and lecture hall at UCI. It can be used to easily find vacant classrooms to use as study rooms or theater rooms.

Please note that rooms are typically closed on weekends and holidays. On days when rooms are open, they are usually open from 7am to 10pm. Rooms are sometimes reserved (especially before exams), so be prepared to leave a vacant classroom if asked.

Also note the website doesn't consider Finals Week schedules. Antscoper will be inaccurate during these times.

Inner Workings

Map

Data

Map data is taken from the same source that UCI's official Interactive Map uses. Antscoper calls the CDN for data on every visit. If it fails to load, Antscoper uses geo_backup.json instead.

Display

Antscoper displays the map via Leaflet, which the official UCI map also relies on. To run a local copy of Antscoper, you must also download Leaflet and include it in the root directory.

Schedules

Daily Updates

Room schedules are scraped daily from WebSOC every day at 6am. Every scraping of WebSOC deletes all previously recorded schedules.

Database

Antscoper was initialized with all of WebSOC's data, meaning its database includes rooms from 1990 to now. The website only shows rooms which have had some schedule in this year or the past year. Rooms whose latest activity was two years ago or more are assumed to be presently nonexistent. The entire database can be accessed from data.json, though this is avoided due to quota limits. If the database ever fails to load, Antscoper uses database_backup.json instead.

Legend

The legend displays schedules from the database. Due to quota limits, the legend will not activate until a query is entered in the search box. Clicking a map popup also automatically enters a query and thus activates the legend. An active legend will show schedule information for the relevant building on the selected day.

A query must consist of a building's abbreviated name. The full building name will likely not bring up any results. All results are stored until the page is closed.

Efficiency

The day after announcing this project on Reddit, there were 178 users and 209 sessions with an average duration of 38 seconds (according to Google Analytics). The screenshot below displays daily quota usage which resulted from this day.

About

A tool for finding vacant classrooms and lecture halls in UCI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published