Skip to content

πŸ“Š A Shiny dashboard forecasting U.S. office leasing activity post-COVID, built for Penn State DataFest 2025.

Notifications You must be signed in to change notification settings

Migueldesanta/2025datafest

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

45 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏒 City Leasing Forecast & Market Explorer

License: CC BY-NC-SA 4.0 Lifecycle: experimental Year: 2025 Status: new app

An interactive Shiny dashboard for analyzing U.S. office leasing trends and forecasting 2025 Q1 leasing activity using machine learning. This project was developed as part of the 2025 ASA DataFest at Penn State University, a national data science competition organized by the American Statistical Association.


πŸ“Œ Project Objective

To identify the most competitive and investment-ready U.S. cities in the post-COVID leasing market using trend scoring and forecasting models.


πŸ“ Structure

The dashboard includes four interactive pages:

  1. Home – Project overview and team
  2. Method – Data, feature engineering, and model methodology
  3. Market Overview – Heatmap and 3D trend score visualizations
  4. Trend Forecast – Leasing growth forecast for 2025 Q1
πŸ“ Root Directory
β”‚
β”œβ”€β”€ πŸ“‚ docs/                # Project documentation and screenshots
β”‚   └── page.png           # Page-level screenshots
β”‚
β”œβ”€β”€ πŸ“‚ R/                   # Custom R scripts used in data processing and modeling
β”‚   β”œβ”€β”€ build_features.R    # Feature engineering pipeline
β”‚   β”œβ”€β”€ train_model.R       # Model training and forecasting
β”‚   └── trend_scoring.R     # Market trend score calculation
β”‚
β”œβ”€β”€ app.R                  # Main Shiny app UI + server code
β”œβ”€β”€ DESCRIPTION            # App metadata (title, author, license, etc.)
β”œβ”€β”€ CODEOWNERS             # GitHub file to auto-assign code reviewers
β”œβ”€β”€ .gitignore             # Files and folders to ignore in version control
β”œβ”€β”€ .lintr                 # Linting rules for R code style

🧠 Methods Summary

  • Data Period: 2021 Q4 to 2024 Q4
  • Trend Score: Composite Z-score using rent, vacancy, occupancy, unemployment, and leased SF
  • Model: XGBoost regression on lagged features
  • Target: Forecast 2025 Q1 leased square footage

πŸ“Έ Screenshots

🏠 Page 1 – Home

Page 1

πŸ› οΈ Page 2 – Methodology

Page 2

🌍 Page 3 – Market Overview

Page 3

πŸ“ˆ Page 4 – Trend Forecast

Page 4


πŸ‘₯ Team


πŸ”’ Data Availability

Due to data licensing agreements and privacy considerations, the original leasing dataset used in this project has been removed from the repository.

The app and code remain accessible for reference, but full functionality (e.g., trend scoring and forecasting) requires the proprietary source data, which is not publicly distributed.

If you are a competition judge, instructor, or reviewer seeking access, please contact the project team directly.


🧾 Acknowledgements

This repository was forked and adapted from the EducationShinyAppTeam/App_Template, originally created by the Education Shiny App Team for instructional and research use.

We thank the original authors for providing the structural foundation for our project.


πŸ“„ License

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) license.

You are free to:

  • Share β€” copy and redistribute the material in any medium or format
  • Adapt β€” remix, transform, and build upon the material

Under the following terms:

  • Attribution (BY): You must give appropriate credit and indicate if changes were made.
  • NonCommercial (NC): You may not use the material for commercial purposes.
  • ShareAlike (SA): If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

πŸ”— License details: https://creativecommons.org/licenses/by-nc-sa/4.0/


About

πŸ“Š A Shiny dashboard forecasting U.S. office leasing activity post-COVID, built for Penn State DataFest 2025.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages