University Financial Aid Optimization

Repository Structure

UNIVERSITY-AID/
├── data/
│   ├── processed/
│   │   └── aid_analysis_data.csv
│   └── raw/
│       ├── hd2022.csv
│       ├── sfa2122_rv.csv
│       └── sfa2122.csv
├── results/
│   ├── 03_exploratory_aid_distributions.png
│   ├── 03_exploratory_coverage_generosity_tradeoff.png
│   ├── 03_exploratory_student_need_analysis.png
│   ├── 04_validation_bootstrap_private_inst_ratio.png
│   ├── 04_validation_bootstrap_public_coverage.png
│   ├── 04_validation_regional_analysis.png
│   ├── 04_validation_selectivity_analysis.png
│   ├── 04_validation_size_analysis.png
│   ├── 04_validation_test_boxplot.png
│   ├── 05_visualization_main_results.png
│   ├── inverse_optimization_results.json
│   └── validation_results.json
└── src/
    ├── __pycache__/
    ├── __init__.py
    ├── download_data.py
    ├── exploratory_analysis.py
    ├── inverse_optimization.py
    ├── prepare_data.py
    ├── validate_results.py
    └── visualize_results.py
├── config.py
├── requirements.txt
├── run_analysis.py

Reproducibility

Requirements

Install dependencies:

pip install -r requirements.txt

Running the Analysis

Execute the main analysis:

python run_analysis.py

Individual Scripts

• src/download_data.py - Data acquisition
• src/prepare_data.py - Data preprocessing
• src/exploratory_analysis.py - Exploratory data analysis
• src/inverse_optimization.py - Optimization algorithms
• src/validate_results.py - Results validation
• src/visualize_results.py - Generate visualizations

Data

• Raw data: Located in data/raw/
• Processed data: Located in data/processed/
• Results: Analysis outputs in results/

Outputs

• Visualization files (PNG format) in results/
• Analysis results (JSON format) in results/