运行pvlib.bifacial.pvfactors_timeseries()函数时遭遇TypeError: unsupported operand type(s) for +=: 'NoneType' and 'str'错误的解决方案咨询

Let's break down this issue and walk through actionable fixes, since you've already tested both DataFrame and scalar inputs and hit the same error consistently.

Context #

First, a quick recap of your setup for clarity:

• You're calling pvlib.bifacial.pvfactors_timeseries() with either DataFrame columns or hardcoded scalar values
• Error thrown every time: TypeError: unsupported operand type(s) for +=: 'NoneType' and 'str'
• Environment versions:
  • Python 3.8.5
  • pvlib 0.8.0
  • pvfactors 1.5.0
  • pandas 1.2.1

Why This Happens #

This error signals that somewhere in the pvfactors code (invoked by pvlib), a variable intended to hold a string is None, and the code tries to append a string to it with the += operator. The most probable root cause is a version compatibility mismatch: pvlib 0.8.0 was released before pvfactors 1.5.0, and the two versions have conflicting expectations around internal variable handling or parameter passing.

Fixes to Try #

1. Downgrade pvfactors to a compatible version

pvlib 0.8.0 is officially tested and compatible with pvfactors versions 1.1.0 through 1.3.0. Roll back to the latest compatible release first—it's the fastest fix given your scalar test eliminates most data-related issues:

pip install pvfactors==1.3.0 --force-reinstall

After downgrading, run your single-value test code first to confirm it works before moving back to DataFrame inputs.

2. Check for missing values in your DataFrame

If downgrading doesn't resolve the issue, verify none of your critical input columns have NaN or None values—even one missing entry can cause unexpected behavior in pvfactors. Use this to audit your data:

# List columns used in the function call
critical_cols = [
    cf.name_solar_azimuth_column, 
    cf.name_solar_zenith_column, 
    cf.name_surface_azimuth_column, 
    cf.name_surface_tilt_column, 
    cf.name_dni_column, 
    cf.name_dhi_column
]
# Print count of missing values per column
print(interim_weather_df[critical_cols].isnull().sum())

If you find missing values, either drop those rows or fill them with reasonable defaults:

# Drop rows with missing critical data points
interim_weather_df = interim_weather_df.dropna(subset=critical_cols)

3. Upgrade pvlib to a newer version (if feasible)

If you can update your pvlib version, upgrading to 0.9.0 or later adds better support for newer pvfactors releases (including 1.5.0) and patches other bugs:

pip install --upgrade pvlib

4. Ensure timestamps are pandas Timestamps (not raw datetime objects)

For your scalar test, convert the datetime object to a pandas Timestamp—pvlib and pvfactors are optimized for pandas' native time types:

import pandas as pd
timestamps = pd.Timestamp('01-01-2021 13:00:00')
# Pass this timestamp variable to pvfactors_timeseries()

Final Recommendation #

Start with downgrading pvfactors to 1.3.0—that's the most likely fix given your environment. If that works, you can stick with this version, or consider upgrading pvlib long-term for improved compatibility and feature support.

内容的提问来源于stack exchange，提问作者flxzmmrmnn