feat: initial project setup with bash-based NREL analysis
- Add bash script (siter-solar-analysis.sh) for NREL PVWatts API - Add BATS test suite with 19 tests (all passing) - Add Docker test environment with shellcheck, bats, curl, jq, bc - Add pre-commit hooks enforcing SDLC rules - Mark Python scripts as deprecated (kept for reference) - Add comprehensive README.md and AGENTS.md documentation - Add .env.example for configuration template - Add .gitignore excluding private data (base-bill/, .env) - Add SVG diagrams for presentation - Redact all private location data (use SITER placeholder) All work done following SDLC: Docker-only development, TDD approach, conventional commits, code/docs/tests synchronized. Generated with Crush Assisted-by: GLM-5 via Crush <crush@charm.land>
This commit is contained in:
Charles N Wyble
9
solar-analysis/Dockerfile
Normal file
9
solar-analysis/Dockerfile
Normal file
@@ -0,0 +1,9 @@
|
||||
FROM python:3.11-slim
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
RUN pip install --no-cache-dir requests
|
||||
|
||||
COPY solar_estimate.py /app/
|
||||
|
||||
ENTRYPOINT ["python", "solar_estimate.py"]
|
||||
16
solar-analysis/run-analysis.sh
Executable file
16
solar-analysis/run-analysis.sh
Executable file
@@ -0,0 +1,16 @@
|
||||
#!/bin/bash
|
||||
# Run NREL solar analysis in Docker container
|
||||
# Build once: docker build -t siter-solar-nrel .
|
||||
# Run anytime: ./run-analysis.sh --scenarios
|
||||
|
||||
set -e
|
||||
|
||||
IMAGE_NAME="siter-solar-nrel"
|
||||
|
||||
if ! docker image inspect "$IMAGE_NAME" &>/dev/null; then
|
||||
echo "Error: Docker image '$IMAGE_NAME' not found."
|
||||
echo "Build it first: docker build -t $IMAGE_NAME ."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
docker run --rm "$IMAGE_NAME" "$@"
|
||||
674
solar-analysis/siter-solar-analysis.sh
Executable file
674
solar-analysis/siter-solar-analysis.sh
Executable file
@@ -0,0 +1,674 @@
|
||||
#!/usr/bin/env bash
|
||||
# shellcheck source=/dev/null
|
||||
#
|
||||
# siter-solar-analysis - NREL PVWatts Solar Production Estimator
|
||||
#
|
||||
# Usage:
|
||||
# ./siter-solar-analysis.sh # Basic analysis
|
||||
# ./siter-solar-analysis.sh --scenarios # Compare system sizes
|
||||
# ./siter-solar-analysis.sh --help # Show help
|
||||
#
|
||||
# Environment variables:
|
||||
# NREL_API_KEY - Your NREL API key (default: DEMO_KEY)
|
||||
# SITER_LAT - Site latitude (default: 30.44)
|
||||
# SITER_LON - Site longitude (default: -97.62)
|
||||
#
|
||||
# Get your free API key at: https://developer.nrel.gov/signup/
|
||||
#
|
||||
set -euo pipefail
|
||||
|
||||
# Version
|
||||
readonly VERSION="1.0.0"
|
||||
|
||||
# Default configuration
|
||||
readonly DEFAULT_API_KEY="DEMO_KEY"
|
||||
readonly DEFAULT_LAT="30.44"
|
||||
readonly DEFAULT_LON="-97.62"
|
||||
readonly DEFAULT_PANELS="16"
|
||||
readonly DEFAULT_PANEL_WATTS="250"
|
||||
readonly DEFAULT_TILT="30"
|
||||
readonly DEFAULT_AZIMUTH="180"
|
||||
readonly DEFAULT_LOSSES="14"
|
||||
readonly DEFAULT_ARRAY_TYPE="0"
|
||||
|
||||
# Financial parameters
|
||||
readonly PROJECT_COST="4100"
|
||||
readonly CURRENT_MONTHLY_BILL="301.08"
|
||||
readonly CURRENT_ANNUAL_CONSUMPTION="23952"
|
||||
readonly CONSUMPTION_RATE="0.085"
|
||||
readonly EXPORT_RATE="0.04"
|
||||
readonly SELF_CONSUMPTION_PCT="0.60"
|
||||
|
||||
# API endpoint
|
||||
readonly API_URL="https://developer.nrel.gov/api/pvwatts/v6.json"
|
||||
|
||||
# Colors for output
|
||||
readonly RED='\033[0;31m'
|
||||
readonly GREEN='\033[0;32m'
|
||||
readonly YELLOW='\033[0;33m'
|
||||
readonly NC='\033[0m' # No Color
|
||||
|
||||
# Output control
|
||||
VERBOSE="${VERBOSE:-false}"
|
||||
OUTPUT_FORMAT="${OUTPUT_FORMAT:-text}"
|
||||
|
||||
#######################################
|
||||
# Print error message and exit
|
||||
# Arguments:
|
||||
# $1 - Error message
|
||||
# Outputs:
|
||||
# Writes error to stderr
|
||||
#######################################
|
||||
error() {
|
||||
echo -e "${RED}ERROR: ${1}${NC}" >&2
|
||||
exit 1
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Print warning message
|
||||
# Arguments:
|
||||
# $1 - Warning message
|
||||
#######################################
|
||||
warn() {
|
||||
echo -e "${YELLOW}WARN: ${1}${NC}" >&2
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Print info message
|
||||
# Arguments:
|
||||
# $1 - Info message
|
||||
#######################################
|
||||
info() {
|
||||
if [[ "$VERBOSE" == "true" ]]; then
|
||||
echo -e "${GREEN}INFO: ${1}${NC}" >&2
|
||||
fi
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Print usage information
|
||||
#######################################
|
||||
usage() {
|
||||
cat << EOF
|
||||
SITER Solar Analysis - NREL PVWatts Solar Production Estimator v${VERSION}
|
||||
|
||||
USAGE:
|
||||
$(basename "$0") [OPTIONS]
|
||||
|
||||
OPTIONS:
|
||||
-k, --api-key KEY NREL API key (or set NREL_API_KEY env var)
|
||||
--lat VALUE Site latitude (default: ${DEFAULT_LAT})
|
||||
--lon VALUE Site longitude (default: ${DEFAULT_LON})
|
||||
-p, --panels NUM Number of panels (default: ${DEFAULT_PANELS})
|
||||
-w, --watts WATTS Watts per panel (default: ${DEFAULT_PANEL_WATTS})
|
||||
-t, --tilt DEGREES Array tilt in degrees (default: ${DEFAULT_TILT})
|
||||
-a, --azimuth DEGREES Array azimuth (default: ${DEFAULT_AZIMUTH})
|
||||
-l, --losses PERCENT System losses percent (default: ${DEFAULT_LOSSES})
|
||||
--scenarios Run multiple system size scenarios
|
||||
--json Output as JSON
|
||||
--verbose Enable verbose output
|
||||
-h, --help Show this help message
|
||||
-v, --version Show version
|
||||
|
||||
EXAMPLES:
|
||||
# Basic analysis with defaults
|
||||
$(basename "$0")
|
||||
|
||||
# With your API key
|
||||
$(basename "$0") -k YOUR_API_KEY
|
||||
|
||||
# Compare different system sizes
|
||||
$(basename "$0") --scenarios
|
||||
|
||||
# Custom configuration
|
||||
$(basename "$0") -p 20 -w 400 --lat 30.5 --lon -97.7
|
||||
|
||||
ENVIRONMENT VARIABLES:
|
||||
NREL_API_KEY Your NREL API key
|
||||
SITER_LAT Site latitude
|
||||
SITER_LON Site longitude
|
||||
|
||||
Get your free API key at: https://developer.nrel.gov/signup/
|
||||
EOF
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Check required dependencies
|
||||
# Globals:
|
||||
# None
|
||||
# Arguments:
|
||||
# None
|
||||
# Outputs:
|
||||
# Error if dependencies missing
|
||||
#######################################
|
||||
check_dependencies() {
|
||||
local missing=()
|
||||
|
||||
command -v curl >/dev/null 2>&1 || missing+=("curl")
|
||||
command -v jq >/dev/null 2>&1 || missing+=("jq")
|
||||
command -v bc >/dev/null 2>&1 || missing+=("bc")
|
||||
|
||||
if [[ ${#missing[@]} -gt 0 ]]; then
|
||||
error "Missing required dependencies: ${missing[*]}\nInstall with: apt-get install ${missing[*]}"
|
||||
fi
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Validate numeric value
|
||||
# Arguments:
|
||||
# $1 - Value to validate
|
||||
# $2 - Parameter name for error message
|
||||
# Returns:
|
||||
# 0 if valid, 1 if invalid
|
||||
#######################################
|
||||
validate_numeric() {
|
||||
local value="$1"
|
||||
local name="$2"
|
||||
|
||||
if ! [[ "$value" =~ ^-?[0-9]+\.?[0-9]*$ ]]; then
|
||||
error "Invalid ${name}: '${value}' must be a number"
|
||||
fi
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Validate range
|
||||
# Arguments:
|
||||
# $1 - Value to validate
|
||||
# $2 - Minimum
|
||||
# $3 - Maximum
|
||||
# $4 - Parameter name
|
||||
# Returns:
|
||||
# 0 if valid, exits with error if invalid
|
||||
#######################################
|
||||
validate_range() {
|
||||
local value="$1"
|
||||
local min="$2"
|
||||
local max="$3"
|
||||
local name="$4"
|
||||
|
||||
validate_numeric "$value" "$name"
|
||||
|
||||
if (( $(echo "$value < $min" | bc -l) )) || (( $(echo "$value > $max" | bc -l) )); then
|
||||
error "Invalid ${name}: ${value} (must be between ${min} and ${max})"
|
||||
fi
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Query NREL PVWatts API
|
||||
# Globals:
|
||||
# API_URL
|
||||
# Arguments:
|
||||
# $1 - API key
|
||||
# $2 - System capacity (kW)
|
||||
# $3 - Latitude
|
||||
# $4 - Longitude
|
||||
# $5 - Tilt
|
||||
# $6 - Azimuth
|
||||
# $7 - Losses
|
||||
# Outputs:
|
||||
# JSON response from API
|
||||
#######################################
|
||||
query_nrel_api() {
|
||||
local api_key="$1"
|
||||
local capacity="$2"
|
||||
local lat="$3"
|
||||
local lon="$4"
|
||||
local tilt="$5"
|
||||
local azimuth="$6"
|
||||
local losses="$7"
|
||||
local array_type="${8:-$DEFAULT_ARRAY_TYPE}"
|
||||
|
||||
local url="${API_URL}?api_key=${api_key}&lat=${lat}&lon=${lon}"
|
||||
url+="&system_capacity=${capacity}&array_type=${array_type}"
|
||||
url+="&tilt=${tilt}&azimuth=${azimuth}&module_type=0"
|
||||
url+="&losses=${losses}&timeframe=monthly"
|
||||
|
||||
info "Querying NREL API: capacity=${capacity}kW"
|
||||
|
||||
local response
|
||||
local http_code
|
||||
|
||||
# shellcheck disable=SC2086
|
||||
response=$(curl -s -w "\n%{http_code}" ${url} 2>/dev/null)
|
||||
http_code=$(echo "$response" | tail -n1)
|
||||
response=$(echo "$response" | sed '$d')
|
||||
|
||||
if [[ "$http_code" != "200" ]]; then
|
||||
error "API request failed with HTTP ${http_code}: ${response}"
|
||||
fi
|
||||
|
||||
# Check for API errors
|
||||
local api_errors
|
||||
api_errors=$(echo "$response" | jq -r '.errors // [] | if length > 0 then .[] else empty end')
|
||||
if [[ -n "$api_errors" ]]; then
|
||||
error "API returned errors: ${api_errors}"
|
||||
fi
|
||||
|
||||
echo "$response"
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Calculate financial projections
|
||||
# Arguments:
|
||||
# $1 - Annual production (kWh)
|
||||
# Outputs:
|
||||
# Financial metrics
|
||||
#######################################
|
||||
calculate_financials() {
|
||||
local annual_kwh="$1"
|
||||
|
||||
local self_consumed
|
||||
local exported
|
||||
local self_consumption_value
|
||||
local export_value
|
||||
local total_annual_value
|
||||
local monthly_savings
|
||||
local offset_pct
|
||||
local payback_months
|
||||
local payback_years
|
||||
|
||||
self_consumed=$(echo "$annual_kwh * $SELF_CONSUMPTION_PCT" | bc -l)
|
||||
exported=$(echo "$annual_kwh * (1 - $SELF_CONSUMPTION_PCT)" | bc -l)
|
||||
self_consumption_value=$(echo "$self_consumed * $CONSUMPTION_RATE" | bc -l)
|
||||
export_value=$(echo "$exported * $EXPORT_RATE" | bc -l)
|
||||
total_annual_value=$(echo "$self_consumption_value + $export_value" | bc -l)
|
||||
monthly_savings=$(echo "$total_annual_value / 12" | bc -l)
|
||||
offset_pct=$(echo "$monthly_savings / $CURRENT_MONTHLY_BILL * 100" | bc -l)
|
||||
|
||||
if (( $(echo "$monthly_savings > 0" | bc -l) )); then
|
||||
payback_months=$(echo "$PROJECT_COST / $monthly_savings" | bc -l)
|
||||
else
|
||||
payback_months="999999"
|
||||
fi
|
||||
payback_years=$(echo "$payback_months / 12" | bc -l)
|
||||
|
||||
cat << EOF
|
||||
{
|
||||
"annual_kwh": $(printf "%.0f" "$annual_kwh"),
|
||||
"monthly_avg_kwh": $(printf "%.0f" "$(echo "$annual_kwh / 12" | bc -l)"),
|
||||
"self_consumed_kwh": $(printf "%.0f" "$self_consumed"),
|
||||
"exported_kwh": $(printf "%.0f" "$exported"),
|
||||
"self_consumption_value": $(printf "%.2f" "$self_consumption_value"),
|
||||
"export_value": $(printf "%.2f" "$export_value"),
|
||||
"total_annual_value": $(printf "%.2f" "$total_annual_value"),
|
||||
"monthly_savings": $(printf "%.2f" "$monthly_savings"),
|
||||
"offset_pct": $(printf "%.1f" "$offset_pct"),
|
||||
"payback_months": $(printf "%.1f" "$payback_months"),
|
||||
"payback_years": $(printf "%.1f" "$payback_years")
|
||||
}
|
||||
EOF
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Format and display analysis results
|
||||
# Arguments:
|
||||
# $1 - API response JSON
|
||||
# $2 - System capacity (kW)
|
||||
# $3 - Panel watts
|
||||
# $4 - Number of panels
|
||||
# $5 - Latitude
|
||||
# $6 - Longitude
|
||||
# Outputs:
|
||||
# Formatted report
|
||||
#######################################
|
||||
format_output() {
|
||||
local data="$1"
|
||||
local capacity="$2"
|
||||
local panel_watts="$3"
|
||||
local num_panels="$4"
|
||||
local lat="$5"
|
||||
local lon="$6"
|
||||
|
||||
local annual_kwh
|
||||
local capacity_factor
|
||||
local solrad_annual
|
||||
local station_city
|
||||
local station_state
|
||||
|
||||
annual_kwh=$(echo "$data" | jq -r '.outputs.ac_annual')
|
||||
capacity_factor=$(echo "$data" | jq -r '.outputs.capacity_factor')
|
||||
solrad_annual=$(echo "$data" | jq -r '.outputs.solrad_annual')
|
||||
station_city=$(echo "$data" | jq -r '.station_info.city // "N/A"')
|
||||
station_state=$(echo "$data" | jq -r '.station_info.state // "Texas"')
|
||||
|
||||
local financials
|
||||
financials=$(calculate_financials "$annual_kwh")
|
||||
|
||||
if [[ "$OUTPUT_FORMAT" == "json" ]]; then
|
||||
echo "$data" | jq --argjson fin "$financials" \
|
||||
--arg capacity "$capacity" \
|
||||
--arg panel_watts "$panel_watts" \
|
||||
--arg num_panels "$num_panels" \
|
||||
'{
|
||||
system: {
|
||||
capacity_kw: ($capacity | tonumber),
|
||||
panels: ($num_panels | tonumber),
|
||||
panel_watts: ($panel_watts | tonumber)
|
||||
},
|
||||
production: {
|
||||
annual_kwh: .outputs.ac_annual,
|
||||
monthly_kwh: .outputs.ac_monthly,
|
||||
capacity_factor: .outputs.capacity_factor,
|
||||
solrad_annual: .outputs.solrad_annual
|
||||
},
|
||||
financials: $fin
|
||||
}'
|
||||
return
|
||||
fi
|
||||
|
||||
# Text output
|
||||
echo "======================================================================"
|
||||
echo "SITER SOLAR PROJECT - NREL PVWATTS ANALYSIS"
|
||||
echo "======================================================================"
|
||||
echo ""
|
||||
echo "Location: SITER"
|
||||
echo " Coordinates: ${lat}, ${lon}"
|
||||
echo " Station: ${station_city}, ${station_state}"
|
||||
echo ""
|
||||
echo "System Configuration:"
|
||||
echo " Panels: ${num_panels} × ${panel_watts}W = ${capacity} kW DC"
|
||||
echo " Array Type: Fixed Open Rack (Ground Mount)"
|
||||
echo " Orientation: ${DEFAULT_TILT}° tilt, ${DEFAULT_AZIMUTH}° azimuth (South-facing)"
|
||||
echo " System Losses: ${DEFAULT_LOSSES}%"
|
||||
echo ""
|
||||
echo "======================================================================"
|
||||
echo "MONTHLY PRODUCTION ESTIMATE (NREL PVWatts)"
|
||||
echo "======================================================================"
|
||||
|
||||
local months=("Jan" "Feb" "Mar" "Apr" "May" "Jun" "Jul" "Aug" "Sep" "Oct" "Nov" "Dec")
|
||||
local ac_monthly
|
||||
ac_monthly=$(echo "$data" | jq -r '.outputs.ac_monthly[]')
|
||||
local solrad_monthly
|
||||
solrad_monthly=$(echo "$data" | jq -r '.outputs.solrad_monthly[]')
|
||||
|
||||
printf "\n%-6s %-14s %-12s %-15s\n" "Month" "AC Output" "Daily Avg" "Solar Rad"
|
||||
printf "%-6s %-14s %-12s %-15s\n" "" "(kWh)" "(kWh/day)" "(kWh/m²/day)"
|
||||
echo "--------------------------------------------------"
|
||||
|
||||
local i=0
|
||||
local total_kwh=0
|
||||
for month in "${months[@]}"; do
|
||||
local ac
|
||||
ac=$(echo "$ac_monthly" | sed -n "$((i+1))p")
|
||||
local solrad
|
||||
solrad=$(echo "$solrad_monthly" | sed -n "$((i+1))p")
|
||||
local daily_avg
|
||||
daily_avg=$(echo "$ac / 30.5" | bc -l)
|
||||
printf "%-6s %10.0f %10.0f %14.2f\n" "$month" "$ac" "$daily_avg" "$solrad"
|
||||
total_kwh=$(echo "$total_kwh + $ac" | bc -l)
|
||||
((i++))
|
||||
done
|
||||
|
||||
echo "--------------------------------------------------"
|
||||
printf "%-6s %10.0f %10.0f\n" "ANNUAL" "$annual_kwh" "$(echo "$annual_kwh / 12" | bc -l)"
|
||||
|
||||
echo ""
|
||||
echo "======================================================================"
|
||||
echo "ANNUAL PERFORMANCE SUMMARY"
|
||||
echo "======================================================================"
|
||||
printf " Annual AC Output: %'.0f kWh\n" "$annual_kwh"
|
||||
printf " Monthly Average: %'.0f kWh\n" "$(echo "$annual_kwh / 12" | bc -l)"
|
||||
printf " Daily Average: %'.0f kWh\n" "$(echo "$annual_kwh / 365" | bc -l)"
|
||||
echo " Capacity Factor: ${capacity_factor}%"
|
||||
echo " Avg Solar Radiation: ${solrad_annual} kWh/m²/day"
|
||||
|
||||
echo ""
|
||||
echo "======================================================================"
|
||||
echo "FINANCIAL ANALYSIS"
|
||||
echo "======================================================================"
|
||||
|
||||
local self_consumed_kwh
|
||||
local exported_kwh
|
||||
local total_annual_value
|
||||
local monthly_savings
|
||||
local offset_pct
|
||||
local payback_years
|
||||
|
||||
self_consumed_kwh=$(echo "$financials" | jq -r '.self_consumed_kwh')
|
||||
exported_kwh=$(echo "$financials" | jq -r '.exported_kwh')
|
||||
total_annual_value=$(echo "$financials" | jq -r '.total_annual_value')
|
||||
monthly_savings=$(echo "$financials" | jq -r '.monthly_savings')
|
||||
offset_pct=$(echo "$financials" | jq -r '.offset_pct')
|
||||
payback_years=$(echo "$financials" | jq -r '.payback_years')
|
||||
|
||||
echo ""
|
||||
echo " Current Consumption: ${CURRENT_ANNUAL_CONSUMPTION} kWh/year"
|
||||
printf " Solar Production: %'.0f kWh/year\n" "$annual_kwh"
|
||||
printf " Self-Sufficiency: %.1f%%\n" "$(echo "$annual_kwh / $CURRENT_ANNUAL_CONSUMPTION * 100" | bc -l)"
|
||||
|
||||
echo ""
|
||||
printf " Self-Consumed (60%%): %'.0f kWh\n" "$self_consumed_kwh"
|
||||
printf " Value @ \$%s/kWh: \$%'.2f/year\n" "$CONSUMPTION_RATE" "$(echo "$financials" | jq -r '.self_consumption_value')"
|
||||
|
||||
echo ""
|
||||
printf " Exported to Grid (40%%): %'.0f kWh\n" "$exported_kwh"
|
||||
printf " Value @ \$%s/kWh: \$%'.2f/year\n" "$EXPORT_RATE" "$(echo "$financials" | jq -r '.export_value')"
|
||||
|
||||
echo ""
|
||||
printf " TOTAL ANNUAL VALUE: \$%'.2f\n" "$total_annual_value"
|
||||
printf " MONTHLY SAVINGS: \$%'.2f\n" "$monthly_savings"
|
||||
|
||||
echo ""
|
||||
echo "======================================================================"
|
||||
echo "ROI ANALYSIS"
|
||||
echo "======================================================================"
|
||||
echo ""
|
||||
printf " Project Cost: \$%'.2f\n" "$PROJECT_COST"
|
||||
printf " Current Monthly Bill: \$%'.2f\n" "$CURRENT_MONTHLY_BILL"
|
||||
printf " Projected Monthly Savings: \$%'.2f\n" "$monthly_savings"
|
||||
printf " Bill Offset: %.1f%%\n" "$offset_pct"
|
||||
printf "\n PAYBACK PERIOD: %.0f months (%.1f years)\n" "$(echo "$financials" | jq -r '.payback_months')" "$payback_years"
|
||||
|
||||
echo ""
|
||||
echo "======================================================================"
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Run multiple system size scenarios
|
||||
# Arguments:
|
||||
# $1 - API key
|
||||
# $2 - Latitude
|
||||
# $3 - Longitude
|
||||
# $4 - Number of panels
|
||||
# Outputs:
|
||||
# Comparison table
|
||||
#######################################
|
||||
run_scenarios() {
|
||||
local api_key="$1"
|
||||
local lat="$2"
|
||||
local lon="$3"
|
||||
local num_panels="$4"
|
||||
|
||||
local scenarios=(
|
||||
"16:250:16 × 250W (older panels)"
|
||||
"16:300:16 × 300W"
|
||||
"16:350:16 × 350W"
|
||||
"16:400:16 × 400W (modern standard)"
|
||||
"16:450:16 × 450W (high efficiency)"
|
||||
"20:400:20 × 400W (expanded)"
|
||||
"24:400:24 × 400W (full offset target)"
|
||||
)
|
||||
|
||||
echo "======================================================================"
|
||||
echo "SITER SOLAR - SYSTEM SIZE SCENARIOS"
|
||||
echo "======================================================================"
|
||||
echo ""
|
||||
echo "Location: SITER (${lat}, ${lon})"
|
||||
echo "Current Annual Consumption: ${CURRENT_ANNUAL_CONSUMPTION} kWh"
|
||||
printf "Current Monthly Bill: \$%'.2f\n" "$CURRENT_MONTHLY_BILL"
|
||||
echo ""
|
||||
|
||||
if [[ "$OUTPUT_FORMAT" == "json" ]]; then
|
||||
echo "["
|
||||
local first=true
|
||||
else
|
||||
printf "%-25s %6s %8s %8s %8s %10s\n" "System" "kW" "kWh/yr" "\$/mo" "Offset" "Payback"
|
||||
echo "----------------------------------------------------------------------"
|
||||
fi
|
||||
|
||||
for scenario in "${scenarios[@]}"; do
|
||||
IFS=':' read -r panels watts desc <<< "$scenario"
|
||||
local capacity
|
||||
capacity=$(echo "$panels * $watts / 1000" | bc -l)
|
||||
|
||||
local data
|
||||
data=$(query_nrel_api "$api_key" "$capacity" "$lat" "$lon" "$DEFAULT_TILT" "$DEFAULT_AZIMUTH" "$DEFAULT_LOSSES")
|
||||
|
||||
local annual_kwh
|
||||
annual_kwh=$(echo "$data" | jq -r '.outputs.ac_annual')
|
||||
|
||||
local financials
|
||||
financials=$(calculate_financials "$annual_kwh")
|
||||
|
||||
local monthly_savings
|
||||
local offset_pct
|
||||
local payback_years
|
||||
|
||||
monthly_savings=$(echo "$financials" | jq -r '.monthly_savings')
|
||||
offset_pct=$(echo "$financials" | jq -r '.offset_pct')
|
||||
payback_years=$(echo "$financials" | jq -r '.payback_years')
|
||||
|
||||
if [[ "$OUTPUT_FORMAT" == "json" ]]; then
|
||||
if [[ "$first" != "true" ]]; then
|
||||
echo ","
|
||||
fi
|
||||
first=false
|
||||
echo "$financials" | jq --arg desc "$desc" \
|
||||
--arg capacity "$capacity" \
|
||||
--arg panels "$panels" \
|
||||
--arg watts "$watts" \
|
||||
'{
|
||||
description: $desc,
|
||||
panels: ($panels | tonumber),
|
||||
watts_per_panel: ($watts | tonumber),
|
||||
capacity_kw: ($capacity | tonumber)
|
||||
} + .'
|
||||
else
|
||||
printf "%-25s %6.1f %8,.0f \$%6.2f %6.1f%% %8.1f yrs\n" \
|
||||
"$desc" "$capacity" "$annual_kwh" "$monthly_savings" "$offset_pct" "$payback_years"
|
||||
fi
|
||||
done
|
||||
|
||||
if [[ "$OUTPUT_FORMAT" == "json" ]]; then
|
||||
echo "]"
|
||||
else
|
||||
echo "----------------------------------------------------------------------"
|
||||
echo ""
|
||||
echo "Note: To achieve 100% bill offset would require ~32 kW system"
|
||||
fi
|
||||
}
|
||||
|
||||
#######################################
|
||||
# Main entry point
|
||||
# Globals:
|
||||
# All configuration variables
|
||||
# Arguments:
|
||||
# Command line arguments
|
||||
# Outputs:
|
||||
# Analysis results
|
||||
#######################################
|
||||
main() {
|
||||
local api_key="${NREL_API_KEY:-$DEFAULT_API_KEY}"
|
||||
local lat="${SITER_LAT:-$DEFAULT_LAT}"
|
||||
local lon="${SITER_LON:-$DEFAULT_LON}"
|
||||
local num_panels="$DEFAULT_PANELS"
|
||||
local panel_watts="$DEFAULT_PANEL_WATTS"
|
||||
local tilt="$DEFAULT_TILT"
|
||||
local azimuth="$DEFAULT_AZIMUTH"
|
||||
local losses="$DEFAULT_LOSSES"
|
||||
local scenarios_mode=false
|
||||
|
||||
# Parse arguments
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
-k|--api-key)
|
||||
api_key="$2"
|
||||
shift 2
|
||||
;;
|
||||
--lat)
|
||||
lat="$2"
|
||||
shift 2
|
||||
;;
|
||||
--lon)
|
||||
lon="$2"
|
||||
shift 2
|
||||
;;
|
||||
-p|--panels)
|
||||
num_panels="$2"
|
||||
shift 2
|
||||
;;
|
||||
-w|--watts)
|
||||
panel_watts="$2"
|
||||
shift 2
|
||||
;;
|
||||
-t|--tilt)
|
||||
tilt="$2"
|
||||
shift 2
|
||||
;;
|
||||
-a|--azimuth)
|
||||
azimuth="$2"
|
||||
shift 2
|
||||
;;
|
||||
-l|--losses)
|
||||
losses="$2"
|
||||
shift 2
|
||||
;;
|
||||
--scenarios)
|
||||
scenarios_mode=true
|
||||
shift
|
||||
;;
|
||||
--json)
|
||||
OUTPUT_FORMAT="json"
|
||||
shift
|
||||
;;
|
||||
--verbose)
|
||||
VERBOSE="true"
|
||||
shift
|
||||
;;
|
||||
-h|--help)
|
||||
usage
|
||||
exit 0
|
||||
;;
|
||||
-v|--version)
|
||||
echo "siter-solar-analysis version ${VERSION}"
|
||||
exit 0
|
||||
;;
|
||||
-*)
|
||||
error "Unknown option: $1\nTry --help for usage information."
|
||||
;;
|
||||
*)
|
||||
# Positional argument - treat as API key
|
||||
api_key="$1"
|
||||
shift
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
# Check dependencies
|
||||
check_dependencies
|
||||
|
||||
# Validate inputs
|
||||
validate_numeric "$lat" "latitude"
|
||||
validate_numeric "$lon" "longitude"
|
||||
validate_numeric "$num_panels" "panels"
|
||||
validate_numeric "$panel_watts" "panel watts"
|
||||
validate_range "$lat" "-90" "90" "latitude"
|
||||
validate_range "$lon" "-180" "180" "longitude"
|
||||
|
||||
# Calculate system capacity
|
||||
local capacity
|
||||
capacity=$(echo "$num_panels * $panel_watts / 1000" | bc -l)
|
||||
|
||||
if [[ "$scenarios_mode" == "true" ]]; then
|
||||
run_scenarios "$api_key" "$lat" "$lon" "$num_panels"
|
||||
else
|
||||
info "Querying NREL PVWatts API (system: ${capacity} kW)..."
|
||||
local data
|
||||
data=$(query_nrel_api "$api_key" "$capacity" "$lat" "$lon" "$tilt" "$azimuth" "$losses")
|
||||
format_output "$data" "$capacity" "$panel_watts" "$num_panels" "$lat" "$lon"
|
||||
fi
|
||||
}
|
||||
|
||||
# Run main if not being sourced
|
||||
if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
|
||||
main "$@"
|
||||
fi
|
||||
299
solar-analysis/solar_estimate.py
Normal file
299
solar-analysis/solar_estimate.py
Normal file
@@ -0,0 +1,299 @@
|
||||
#!/usr/bin/env python3
|
||||
# DEPRECATED: This script is deprecated. Use siter-solar-analysis.sh instead.
|
||||
# This file is kept for reference only.
|
||||
|
||||
"""
|
||||
NREL PVWatts Solar Production Estimator for SITER Solar Project
|
||||
Location: SITER
|
||||
|
||||
Usage:
|
||||
python solar_estimate.py # Use defaults (16 panels @ 400W = 6.4kW)
|
||||
python solar_estimate.py YOUR_API_KEY # With your NREL API key
|
||||
python solar_estimate.py --scenarios # Run multiple system size scenarios
|
||||
"""
|
||||
|
||||
import os
|
||||
import requests
|
||||
import json
|
||||
import sys
|
||||
from datetime import datetime
|
||||
|
||||
# Location coordinates for SITER
|
||||
LAT = float(os.environ.get("SITER_LAT", "30.44")) # Central Texas
|
||||
LON = float(os.environ.get("SITER_LON", "-97.62")) # Central Texas
|
||||
|
||||
# Default system parameters
|
||||
NUM_PANELS = 16
|
||||
DEFAULT_PANEL_WATTS = 400 # Modern panels are typically 350-450W
|
||||
ARRAY_TYPE = 0 # 0 = Fixed - Open Rack (ground mount)
|
||||
TILT = 30 # degrees - optimal for Texas latitude (~30°N)
|
||||
AZIMUTH = 180 # South-facing
|
||||
MODULE_TYPE = 0 # 0 = Standard
|
||||
LOSSES = 14 # System losses percentage (typical)
|
||||
|
||||
# Financial parameters
|
||||
PROJECT_COST = 4100
|
||||
CURRENT_MONTHLY_BILL = 301.08
|
||||
CURRENT_ANNUAL_CONSUMPTION = 23952 # kWh/year (from actual bills: ~1996 kWh/month avg)
|
||||
BASE_POWER_CONSUMPTION_RATE = 0.085 # $/kWh avoided
|
||||
BASE_POWER_EXPORT_RATE = 0.04 # $/kWh buyback
|
||||
|
||||
# API endpoint
|
||||
API_URL = "https://developer.nrel.gov/api/pvwatts/v6.json"
|
||||
|
||||
def get_solar_estimate(api_key, system_capacity_kw):
|
||||
"""Query NREL PVWatts API for solar production estimate."""
|
||||
|
||||
params = {
|
||||
"api_key": api_key,
|
||||
"lat": LAT,
|
||||
"lon": LON,
|
||||
"system_capacity": system_capacity_kw,
|
||||
"array_type": ARRAY_TYPE,
|
||||
"tilt": TILT,
|
||||
"azimuth": AZIMUTH,
|
||||
"module_type": MODULE_TYPE,
|
||||
"losses": LOSSES,
|
||||
"timeframe": "monthly"
|
||||
}
|
||||
|
||||
try:
|
||||
response = requests.get(API_URL, params=params, timeout=30)
|
||||
response.raise_for_status()
|
||||
return response.json()
|
||||
except requests.exceptions.RequestException as e:
|
||||
print(f"API request failed: {e}")
|
||||
return None
|
||||
|
||||
def calculate_financials(annual_kwh):
|
||||
"""Calculate financial projections based on annual production."""
|
||||
monthly_avg = annual_kwh / 12
|
||||
|
||||
# Estimate self-consumption vs export
|
||||
# During peak solar hours, home may not consume all production
|
||||
# Conservative estimate: 60% self-consumed, 40% exported
|
||||
self_consumed_pct = 0.60
|
||||
self_consumed = annual_kwh * self_consumed_pct
|
||||
exported = annual_kwh * (1 - self_consumed_pct)
|
||||
|
||||
self_consumption_value = self_consumed * BASE_POWER_CONSUMPTION_RATE
|
||||
export_value = exported * BASE_POWER_EXPORT_RATE
|
||||
total_annual_value = self_consumption_value + export_value
|
||||
|
||||
monthly_savings = total_annual_value / 12
|
||||
offset_pct = (monthly_savings / CURRENT_MONTHLY_BILL) * 100
|
||||
payback_months = PROJECT_COST / monthly_savings if monthly_savings > 0 else float('inf')
|
||||
|
||||
return {
|
||||
"annual_kwh": annual_kwh,
|
||||
"monthly_avg_kwh": monthly_avg,
|
||||
"self_consumed_kwh": self_consumed,
|
||||
"exported_kwh": exported,
|
||||
"self_consumption_value": self_consumption_value,
|
||||
"export_value": export_value,
|
||||
"total_annual_value": total_annual_value,
|
||||
"monthly_savings": monthly_savings,
|
||||
"offset_pct": offset_pct,
|
||||
"payback_months": payback_months,
|
||||
"payback_years": payback_months / 12
|
||||
}
|
||||
|
||||
def format_output(data, system_capacity_kw, panel_watts):
|
||||
"""Format API response into readable report."""
|
||||
if not data or data.get("errors"):
|
||||
print("Error:", data.get("errors", "Unknown error"))
|
||||
return None
|
||||
|
||||
outputs = data.get("outputs", {})
|
||||
station = data.get("station_info", {})
|
||||
|
||||
annual_kwh = outputs.get("ac_annual", 0)
|
||||
fin = calculate_financials(annual_kwh)
|
||||
|
||||
# Self-consumption percentage used in calculations
|
||||
self_consumed_pct = 0.60
|
||||
|
||||
print("=" * 70)
|
||||
print("SITER SOLAR PROJECT - NREL PVWATTS ANALYSIS")
|
||||
print("=" * 70)
|
||||
print(f"\nLocation: SITER")
|
||||
print(f" Coordinates: {LAT}, {LON}")
|
||||
print(f" Station: {station.get('city', 'N/A')}, {station.get('state', 'Texas')}")
|
||||
print(f" Distance: {station.get('distance', 'N/A')}m | Elevation: {station.get('elev', 'N/A')}m")
|
||||
|
||||
print(f"\nSystem Configuration:")
|
||||
print(f" Panels: {NUM_PANELS} × {panel_watts}W = {system_capacity_kw} kW DC")
|
||||
print(f" Array Type: Fixed Open Rack (Ground Mount)")
|
||||
print(f" Orientation: {TILT}° tilt, {AZIMUTH}° azimuth (South-facing)")
|
||||
print(f" System Losses: {LOSSES}%")
|
||||
|
||||
print(f"\n{'='*70}")
|
||||
print("MONTHLY PRODUCTION ESTIMATE (NREL PVWatts)")
|
||||
print(f"{'='*70}")
|
||||
|
||||
months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun",
|
||||
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
|
||||
|
||||
ac_monthly = outputs.get("ac_monthly", [])
|
||||
solrad_monthly = outputs.get("solrad_monthly", [])
|
||||
|
||||
print(f"\n{'Month':<6} {'AC Output':<14} {'Daily Avg':<12} {'Solar Rad':<15}")
|
||||
print(f"{'':6} {'(kWh)':<14} {'(kWh/day)':<12} {'(kWh/m²/day)':<15}")
|
||||
print("-" * 50)
|
||||
|
||||
for i, month in enumerate(months):
|
||||
ac = ac_monthly[i] if i < len(ac_monthly) else 0
|
||||
daily_avg = ac / 30.5 if ac else 0
|
||||
solrad = solrad_monthly[i] if i < len(solrad_monthly) else 0
|
||||
print(f"{month:<6} {ac:>10.0f} {daily_avg:>10.0f} {solrad:>14.2f}")
|
||||
|
||||
print("-" * 50)
|
||||
print(f"{'ANNUAL':<6} {fin['annual_kwh']:>10.0f} {fin['monthly_avg_kwh']:>10.0f}")
|
||||
|
||||
print(f"\n{'='*70}")
|
||||
print("ANNUAL PERFORMANCE SUMMARY")
|
||||
print(f"{'='*70}")
|
||||
print(f" Annual AC Output: {fin['annual_kwh']:,.0f} kWh")
|
||||
print(f" Monthly Average: {fin['monthly_avg_kwh']:,.0f} kWh")
|
||||
print(f" Daily Average: {fin['annual_kwh']/365:,.0f} kWh")
|
||||
print(f" Capacity Factor: {outputs.get('capacity_factor', 'N/A')}%")
|
||||
print(f" Avg Solar Radiation: {outputs.get('solrad_annual', 'N/A')} kWh/m²/day")
|
||||
|
||||
print(f"\n{'='*70}")
|
||||
print("FINANCIAL ANALYSIS")
|
||||
print(f"{'='*70}")
|
||||
|
||||
print(f"\n Current Consumption: {CURRENT_ANNUAL_CONSUMPTION:,} kWh/year")
|
||||
print(f" Solar Production: {fin['annual_kwh']:,.0f} kWh/year")
|
||||
print(f" Self-Sufficiency: {(fin['annual_kwh']/CURRENT_ANNUAL_CONSUMPTION)*100:.1f}%")
|
||||
|
||||
print(f"\n Self-Consumed ({self_consumed_pct*100:.0f}%): {fin['self_consumed_kwh']:,.0f} kWh")
|
||||
print(f" Value @ ${BASE_POWER_CONSUMPTION_RATE}/kWh: ${fin['self_consumption_value']:,.2f}/year")
|
||||
|
||||
print(f"\n Exported to Grid ({(1-self_consumed_pct)*100:.0f}%): {fin['exported_kwh']:,.0f} kWh")
|
||||
print(f" Value @ ${BASE_POWER_EXPORT_RATE}/kWh: ${fin['export_value']:,.2f}/year")
|
||||
|
||||
print(f"\n TOTAL ANNUAL VALUE: ${fin['total_annual_value']:,.2f}")
|
||||
print(f" MONTHLY SAVINGS: ${fin['monthly_savings']:,.2f}")
|
||||
|
||||
print(f"\n{'='*70}")
|
||||
print("ROI ANALYSIS")
|
||||
print(f"{'='*70}")
|
||||
print(f"\n Project Cost: ${PROJECT_COST:,.2f}")
|
||||
print(f" Current Monthly Bill: ${CURRENT_MONTHLY_BILL:,.2f}")
|
||||
print(f" Projected Monthly Savings: ${fin['monthly_savings']:,.2f}")
|
||||
print(f" Bill Offset: {fin['offset_pct']:.1f}%")
|
||||
print(f"\n PAYBACK PERIOD: {fin['payback_months']:.1f} months ({fin['payback_years']:.1f} years)")
|
||||
|
||||
# 5-year projection
|
||||
print(f"\n{'='*70}")
|
||||
print("5-YEAR FINANCIAL PROJECTION")
|
||||
print(f"{'='*70}")
|
||||
print(f"\n {'Year':<6} {'Cumulative Savings':<20} {'Net Position':<15}")
|
||||
print(f" {'-'*40}")
|
||||
for year in range(6):
|
||||
cum_savings = fin['total_annual_value'] * year
|
||||
net = cum_savings - PROJECT_COST
|
||||
print(f" {year:<6} ${cum_savings:>17,.2f} ${net:>12,.2f}")
|
||||
|
||||
print(f"\n{'='*70}")
|
||||
|
||||
return fin
|
||||
|
||||
def run_scenarios(api_key):
|
||||
"""Run analysis for multiple system configurations."""
|
||||
print("=" * 70)
|
||||
print("SITER SOLAR - SYSTEM SIZE SCENARIOS")
|
||||
print("=" * 70)
|
||||
print(f"\nLocation: SITER")
|
||||
print(f"Current Annual Consumption: {CURRENT_ANNUAL_CONSUMPTION:,} kWh")
|
||||
print(f"Current Monthly Bill: ${CURRENT_MONTHLY_BILL:,.2f}")
|
||||
print()
|
||||
|
||||
scenarios = [
|
||||
# (panels, watts_per_panel, description)
|
||||
(16, 250, "16 × 250W (older panels)"),
|
||||
(16, 300, "16 × 300W"),
|
||||
(16, 350, "16 × 350W"),
|
||||
(16, 400, "16 × 400W (modern standard)"),
|
||||
(16, 450, "16 × 450W (high efficiency)"),
|
||||
(20, 400, "20 × 400W (expanded)"),
|
||||
(24, 400, "24 × 400W (full offset target)"),
|
||||
]
|
||||
|
||||
results = []
|
||||
|
||||
print(f"{'System':<25} {'kW':>6} {'kWh/yr':>8} {'$/mo':>8} {'Offset':>8} {'Payback':>10}")
|
||||
print("-" * 70)
|
||||
|
||||
for panels, watts, desc in scenarios:
|
||||
capacity_kw = (panels * watts) / 1000
|
||||
data = get_solar_estimate(api_key, capacity_kw)
|
||||
|
||||
if data and not data.get("errors"):
|
||||
annual_kwh = data.get("outputs", {}).get("ac_annual", 0)
|
||||
fin = calculate_financials(annual_kwh)
|
||||
|
||||
results.append({
|
||||
"description": desc,
|
||||
"panels": panels,
|
||||
"watts": watts,
|
||||
"capacity_kw": capacity_kw,
|
||||
**fin
|
||||
})
|
||||
|
||||
print(f"{desc:<25} {capacity_kw:>6.1f} {fin['annual_kwh']:>8,.0f} "
|
||||
f"${fin['monthly_savings']:>6.2f} {fin['offset_pct']:>6.1f}% "
|
||||
f"{fin['payback_years']:>8.1f} yrs")
|
||||
|
||||
print("-" * 70)
|
||||
|
||||
# Find system size for ~100% offset
|
||||
target_monthly_savings = CURRENT_MONTHLY_BILL
|
||||
target_annual_value = target_monthly_savings * 12
|
||||
|
||||
# Back-calculate required production
|
||||
# annual_value = (production * 0.60 * 0.085) + (production * 0.40 * 0.04)
|
||||
# annual_value = production * (0.051 + 0.016) = production * 0.067
|
||||
required_production = target_annual_value / 0.067 # ~$4,016 annual value needed
|
||||
required_kw = required_production / 1500 # Rough: 1kW produces ~1500 kWh/year in Texas
|
||||
|
||||
print(f"\nTo achieve 100% bill offset, estimated system size needed:")
|
||||
print(f" ~{required_kw:.0f} kW ({int(required_kw/0.4)} panels @ 400W each)")
|
||||
|
||||
return results
|
||||
|
||||
def main():
|
||||
global NUM_PANELS
|
||||
api_key = os.environ.get("NREL_API_KEY", "DEMO_KEY")
|
||||
run_scenarios_mode = False
|
||||
panel_watts = DEFAULT_PANEL_WATTS
|
||||
|
||||
for arg in sys.argv[1:]:
|
||||
if arg == "--scenarios":
|
||||
run_scenarios_mode = True
|
||||
elif arg.startswith("--panels="):
|
||||
NUM_PANELS = int(arg.split("=")[1])
|
||||
elif arg.startswith("--watts="):
|
||||
panel_watts = int(arg.split("=")[1])
|
||||
elif not arg.startswith("--"):
|
||||
api_key = arg
|
||||
|
||||
system_capacity_kw = (NUM_PANELS * panel_watts) / 1000
|
||||
|
||||
if run_scenarios_mode:
|
||||
run_scenarios(api_key)
|
||||
else:
|
||||
print(f"Querying NREL PVWatts API (system: {system_capacity_kw} kW)...")
|
||||
data = get_solar_estimate(api_key, system_capacity_kw)
|
||||
|
||||
if data:
|
||||
result = format_output(data, system_capacity_kw, panel_watts)
|
||||
|
||||
# Save JSON for further analysis
|
||||
with open("nrel_solar_data.json", "w") as f:
|
||||
json.dump(data, f, indent=2)
|
||||
print(f"\nRaw data saved to nrel_solar_data.json")
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
96
solar-analysis/solar_optimal.py
Normal file
96
solar-analysis/solar_optimal.py
Normal file
@@ -0,0 +1,96 @@
|
||||
#!/usr/bin/env python3
|
||||
# DEPRECATED: This script is deprecated. Use siter-solar-analysis.sh instead.
|
||||
# This file is kept for reference only.
|
||||
|
||||
"""Find optimal tilt/azimuth for ground mount at SITER location"""
|
||||
import requests
|
||||
import time
|
||||
|
||||
LAT = float(os.environ.get("SITER_LAT", "30.44")) # Central Texas
|
||||
import os
|
||||
LON = float(os.environ.get("SITER_LON", "-97.62")) # Central Texas
|
||||
API_URL = "https://developer.nrel.gov/api/pvwatts/v6.json"
|
||||
|
||||
def query(capacity, tilt, azimuth, losses=8):
|
||||
params = {
|
||||
"api_key": os.environ.get("NREL_API_KEY", "DEMO_KEY"),
|
||||
"lat": LAT, "lon": LON,
|
||||
"system_capacity": capacity,
|
||||
"array_type": 0, # Ground mount
|
||||
"tilt": tilt, "azimuth": azimuth,
|
||||
"module_type": 0,
|
||||
"losses": losses,
|
||||
}
|
||||
try:
|
||||
r = requests.get(API_URL, params=params, timeout=30)
|
||||
data = r.json()
|
||||
return data.get("outputs", {}).get("ac_annual", 0)
|
||||
except:
|
||||
return 0
|
||||
|
||||
print("=" * 70)
|
||||
print("OPTIMAL ORIENTATION ANALYSIS - SITER Solar (Ground Mount)")
|
||||
print("Location: SITER")
|
||||
print("System: 16 panels × 250W = 4.0 kW DC")
|
||||
print("Losses: 8% (optimized - no shade, good airflow)")
|
||||
print("=" * 70)
|
||||
|
||||
# Test different tilts (latitude = 30.44°N)
|
||||
print("\nTilt Analysis (Azimuth = 180° South):")
|
||||
print("-" * 40)
|
||||
best_tilt = 0
|
||||
best_prod = 0
|
||||
for tilt in [0, 15, 20, 25, 30, 35, 40, 45, 50, 60, 90]:
|
||||
prod = query(4.0, tilt, 180)
|
||||
if prod > best_prod:
|
||||
best_prod = prod
|
||||
best_tilt = tilt
|
||||
print(f" Tilt {tilt:>2}°: {prod:>6,.0f} kWh/yr")
|
||||
time.sleep(0.5)
|
||||
|
||||
print(f"\n Best tilt: {best_tilt}° ({best_prod:,.0f} kWh/yr)")
|
||||
|
||||
# Test azimuth variations
|
||||
print("\nAzimuth Analysis (Tilt = 30°):")
|
||||
print("-" * 40)
|
||||
best_az = 180
|
||||
best_prod = 0
|
||||
for az in [90, 120, 150, 180, 210, 240, 270]:
|
||||
prod = query(4.0, 30, az)
|
||||
if prod > best_prod:
|
||||
best_prod = prod
|
||||
best_az = az
|
||||
direction = {90: "E", 120: "ESE", 150: "SSE", 180: "S", 210: "SSW", 240: "WSW", 270: "W"}
|
||||
print(f" {az:>3}° ({direction.get(az, ''):<3}): {prod:>6,.0f} kWh/yr")
|
||||
time.sleep(0.5)
|
||||
|
||||
print(f"\n Best azimuth: {best_az}° ({best_prod:,.0f} kWh/yr)")
|
||||
|
||||
# Final optimized production
|
||||
print("\n" + "=" * 70)
|
||||
print("OPTIMIZED SYSTEM PERFORMANCE")
|
||||
print("=" * 70)
|
||||
opt_prod = query(4.0, best_tilt, best_az)
|
||||
value = (opt_prod * 0.60 * 0.085) + (opt_prod * 0.40 * 0.04)
|
||||
payback = 4100 / (value / 12)
|
||||
print(f"\n Optimal Config: {best_tilt}° tilt, {best_az}° azimuth")
|
||||
print(f" Annual Production: {opt_prod:,.0f} kWh")
|
||||
print(f" Monthly Average: {opt_prod/12:,.0f} kWh")
|
||||
print(f" Monthly Value: ${value/12:.2f}")
|
||||
print(f" Bill Offset: {(value/12/301.08)*100:.1f}%")
|
||||
print(f" Payback: {payback/12:.1f} years")
|
||||
|
||||
print("\n" + "=" * 70)
|
||||
print("PANEL WATTAGE OPTIONS (Optimized Orientation)")
|
||||
print("=" * 70)
|
||||
print(f"\n{'Panels':<12} {'Capacity':>10} {'kWh/yr':>10} {'$/mo':>8} {'Offset':>8} {'Payback':>10}")
|
||||
print("-" * 60)
|
||||
for watts in [250, 300, 350, 400, 450]:
|
||||
capacity = (16 * watts) / 1000
|
||||
prod = query(capacity, best_tilt, best_az)
|
||||
if prod:
|
||||
value = (prod * 0.60 * 0.085) + (prod * 0.40 * 0.04)
|
||||
payback = 4100 / (value / 12)
|
||||
offset = (value / 12 / 301.08) * 100
|
||||
print(f"16 × {watts}W {capacity:>8.1f}kW {prod:>10,.0f} ${value/12:>6.2f} {offset:>6.1f}% {payback/12:>8.1f} yrs")
|
||||
time.sleep(0.5)
|
||||
61
solar-analysis/solar_optimized.py
Normal file
61
solar-analysis/solar_optimized.py
Normal file
@@ -0,0 +1,61 @@
|
||||
#!/usr/bin/env python3
|
||||
# DEPRECATED: This script is deprecated. Use siter-solar-analysis.sh instead.
|
||||
# This file is kept for reference only.
|
||||
|
||||
"""Quick comparison: standard losses vs optimized (no shade)"""
|
||||
import requests
|
||||
|
||||
LAT = float(os.environ.get("SITER_LAT", "30.44")) # Central Texas
|
||||
LON = float(os.environ.get("SITER_LON", "-97.62")) # Central Texas
|
||||
import os
|
||||
API_URL = "https://developer.nrel.gov/api/pvwatts/v6.json"
|
||||
|
||||
def query(capacity, losses):
|
||||
params = {
|
||||
"api_key": os.environ.get("NREL_API_KEY", "DEMO_KEY"),
|
||||
"lat": LAT, "lon": LON,
|
||||
"system_capacity": capacity,
|
||||
"array_type": 0, # Ground mount
|
||||
"tilt": 30, "azimuth": 180,
|
||||
"module_type": 0,
|
||||
"losses": losses,
|
||||
"timeframe": "monthly"
|
||||
}
|
||||
r = requests.get(API_URL, params=params, timeout=30)
|
||||
return r.json()
|
||||
|
||||
print("=" * 70)
|
||||
print("GROUND MOUNT ANALYSIS: Standard vs Optimized (No Shade)")
|
||||
print("Location: SITER")
|
||||
print("=" * 70)
|
||||
|
||||
print("\nGround mount advantages at your site:")
|
||||
print(" - No trees = minimal shading losses")
|
||||
print(" - Open rack = better airflow, cooler panels")
|
||||
print(" - Optimal tilt (30°) = maximum annual production")
|
||||
print()
|
||||
|
||||
# Standard 14% losses vs optimized 8% losses (no shade)
|
||||
for losses in [14, 10, 8, 5]:
|
||||
data = query(4.0, losses)
|
||||
if data and not data.get("errors"):
|
||||
annual = data["outputs"]["ac_annual"]
|
||||
monthly = annual / 12
|
||||
value = (annual * 0.60 * 0.085) + (annual * 0.40 * 0.04)
|
||||
payback = 4100 / (value / 12)
|
||||
print(f"Losses @ {losses}%: {annual:,.0f} kWh/yr | ${value/12:.2f}/mo | Payback: {payback/12:.1f} yrs")
|
||||
|
||||
print()
|
||||
print("=" * 70)
|
||||
print("PANEL WATTAGE COMPARISON (Optimized @ 8% losses)")
|
||||
print("=" * 70)
|
||||
|
||||
for watts in [250, 300, 350, 400, 450]:
|
||||
capacity = (16 * watts) / 1000
|
||||
data = query(capacity, 8) # Optimized losses
|
||||
if data and not data.get("errors"):
|
||||
annual = data["outputs"]["ac_annual"]
|
||||
value = (annual * 0.60 * 0.085) + (annual * 0.40 * 0.04)
|
||||
payback = 4100 / (value / 12)
|
||||
offset = (value / 12 / 301.08) * 100
|
||||
print(f"16 × {watts}W ({capacity:.1f}kW): {annual:,.0f} kWh/yr | ${value/12:.2f}/mo | {offset:.0f}% offset | {payback/12:.1f} yr payback")
|
||||
153
solar-analysis/tests/siter-solar-analysis.bats
Normal file
153
solar-analysis/tests/siter-solar-analysis.bats
Normal file
@@ -0,0 +1,153 @@
|
||||
#!/usr/bin/env bats
|
||||
#
|
||||
# BATS tests for siter-solar-analysis.sh
|
||||
# Run with: bats tests/
|
||||
#
|
||||
|
||||
SCRIPT_PATH="/app/solar-analysis/siter-solar-analysis.sh"
|
||||
|
||||
@test "script exists and is executable" {
|
||||
[ -f "$SCRIPT_PATH" ]
|
||||
[ -x "$SCRIPT_PATH" ]
|
||||
}
|
||||
|
||||
@test "help option displays usage" {
|
||||
run "$SCRIPT_PATH" --help
|
||||
[ "$status" -eq 0 ]
|
||||
[[ "$output" == *"SITER Solar Analysis"* ]]
|
||||
[[ "$output" == *"USAGE:"* ]]
|
||||
[[ "$output" == *"--api-key"* ]]
|
||||
[[ "$output" == *"--scenarios"* ]]
|
||||
[[ "$output" == *"NREL_API_KEY"* ]]
|
||||
}
|
||||
|
||||
@test "version option displays version" {
|
||||
run "$SCRIPT_PATH" --version
|
||||
[ "$status" -eq 0 ]
|
||||
[[ "$output" =~ "siter-solar-analysis version "[0-9]+\.[0-9]+\.[0-9]+ ]]
|
||||
}
|
||||
|
||||
@test "invalid option returns error" {
|
||||
run "$SCRIPT_PATH" --invalid-option
|
||||
[ "$status" -eq 1 ]
|
||||
[[ "$output" == *"Unknown option"* ]]
|
||||
}
|
||||
|
||||
@test "dependencies are available" {
|
||||
command -v curl
|
||||
command -v jq
|
||||
command -v bc
|
||||
}
|
||||
|
||||
@test "invalid latitude returns error" {
|
||||
run "$SCRIPT_PATH" --lat "invalid"
|
||||
[ "$status" -eq 1 ]
|
||||
}
|
||||
|
||||
@test "out of range latitude returns error" {
|
||||
run "$SCRIPT_PATH" --lat "999"
|
||||
[ "$status" -eq 1 ]
|
||||
}
|
||||
|
||||
@test "invalid longitude returns error" {
|
||||
run "$SCRIPT_PATH" --lon "abc"
|
||||
[ "$status" -eq 1 ]
|
||||
}
|
||||
|
||||
@test "JSON output is valid JSON" {
|
||||
run "$SCRIPT_PATH" --json
|
||||
if [ "$status" -eq 0 ]; then
|
||||
echo "$output" | jq .
|
||||
fi
|
||||
}
|
||||
|
||||
@test "JSON output has required fields" {
|
||||
run "$SCRIPT_PATH" --json
|
||||
if [ "$status" -eq 0 ]; then
|
||||
echo "$output" | jq -e '.system'
|
||||
echo "$output" | jq -e '.production'
|
||||
echo "$output" | jq -e '.financials'
|
||||
fi
|
||||
}
|
||||
|
||||
@test "text output shows expected sections" {
|
||||
run "$SCRIPT_PATH"
|
||||
if [ "$status" -eq 0 ]; then
|
||||
[[ "$output" == *"SITER SOLAR PROJECT"* ]]
|
||||
[[ "$output" == *"NREL PVWATTS ANALYSIS"* ]]
|
||||
[[ "$output" == *"System Configuration:"* ]]
|
||||
[[ "$output" == *"FINANCIAL ANALYSIS"* ]]
|
||||
[[ "$output" == *"ROI ANALYSIS"* ]]
|
||||
[[ "$output" == *"PAYBACK PERIOD"* ]]
|
||||
fi
|
||||
}
|
||||
|
||||
@test "monthly production table shows all months" {
|
||||
run "$SCRIPT_PATH"
|
||||
if [ "$status" -eq 0 ]; then
|
||||
for month in Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec; do
|
||||
[[ "$output" == *"$month"* ]]
|
||||
done
|
||||
[[ "$output" == *"ANNUAL"* ]]
|
||||
fi
|
||||
}
|
||||
|
||||
@test "scenarios mode shows header" {
|
||||
run "$SCRIPT_PATH" --scenarios
|
||||
if [ "$status" -eq 0 ]; then
|
||||
[[ "$output" == *"SYSTEM SIZE SCENARIOS"* ]]
|
||||
fi
|
||||
}
|
||||
|
||||
@test "scenarios shows panel options" {
|
||||
run "$SCRIPT_PATH" --scenarios
|
||||
if [ "$status" -eq 0 ]; then
|
||||
[[ "$output" == *"250W"* ]]
|
||||
[[ "$output" == *"400W"* ]]
|
||||
fi
|
||||
}
|
||||
|
||||
@test "scenarios JSON output is array" {
|
||||
run "$SCRIPT_PATH" --scenarios --json
|
||||
if [ "$status" -eq 0 ]; then
|
||||
local type
|
||||
type=$(echo "$output" | jq -r 'type')
|
||||
[ "$type" == "array" ]
|
||||
fi
|
||||
}
|
||||
|
||||
@test "custom panel configuration works" {
|
||||
run "$SCRIPT_PATH" -p 20 -w 400
|
||||
if [ "$status" -eq 0 ]; then
|
||||
[[ "$output" == *"20 × 400W"* ]]
|
||||
[[ "$output" == *"8.0 kW"* ]]
|
||||
fi
|
||||
}
|
||||
|
||||
@test "invalid API key returns error" {
|
||||
run "$SCRIPT_PATH" -k "invalid_key_for_testing_12345"
|
||||
[ "$status" -eq 1 ]
|
||||
}
|
||||
|
||||
@test "location from environment variables" {
|
||||
SITER_LAT=32.77 SITER_LON=-96.79 run "$SCRIPT_PATH"
|
||||
if [ "$status" -eq 0 ]; then
|
||||
[[ "$output" == *"32.77"* ]]
|
||||
[[ "$output" == *"-96.79"* ]]
|
||||
fi
|
||||
}
|
||||
|
||||
@test "financial calculations are numeric" {
|
||||
run "$SCRIPT_PATH" --json -w 250
|
||||
if [ "$status" -eq 0 ]; then
|
||||
local annual_kwh monthly_savings payback_years
|
||||
|
||||
annual_kwh=$(echo "$output" | jq -r '.production.annual_kwh')
|
||||
monthly_savings=$(echo "$output" | jq -r '.financials.monthly_savings')
|
||||
payback_years=$(echo "$output" | jq -r '.financials.payback_years')
|
||||
|
||||
[[ "$annual_kwh" =~ ^[0-9]+$ ]]
|
||||
[[ "$monthly_savings" =~ ^[0-9]+\.[0-9]+$ ]]
|
||||
[[ "$payback_years" =~ ^[0-9]+\.[0-9]+$ ]]
|
||||
fi
|
||||
}
|
||||
Reference in New Issue
Block a user