How lucianono/shelteralloc_thesis works
Project type and purpose
• ShelterAlloc_Thesis is a standalone Python desktop application (built with PyQt/PySide) that reads community and shelter data from Excel, runs optimization (shelter‐allocation and routing), and produces reports (Excel & HTML maps).
• It is organized around a graphical UI, core optimization/modeling logic, a simple file‐based data layer (Excel + JSON cache), and report generation.
File structure
• Top‐level directories:
• DataSets – raw Excel data inputs (community, shelter, distance matrices)
• ProgramSrc – all source code, UI definitions (.ui), compiled resources, templates
• Tests – unit/functional tests for the optimization and various prototypes
• Thesis Final Manuscript / Thesis Proposal Manuscript – documentation (outside runtime scope)
• In ProgramSrc:
• UI layer: *.ui files + generated ui_*.py, index.py (app entry), main.py (PyInstaller spec)
• Controller modules: dashboard_ui.py, entityManagement*.py, helpDialog.py, solveSettings.py, solvingProgress.py
• Domain/Logic: DataSetsModel.py, distanceComputer.py, pathfinder.py, optimizedRouting.py, BNTModelPenalized.py
• Settings & config: modelSettings.py + .ui, solveSettings.py + .ui, cache folder (JSON)
• Reporting: shelterAllocationReport.py (Excel template), map.html & optimized-routes-map.html
• Resources: resources.qrc → resources_rc.py
README for insights
• README is minimal; project name confirms focus on “Shelter Allocation” as part of a thesis.