Skip to content

Attributing circumsolar irradiance to diffuse or direct POA #2874

Open

Description

@AdamRJensen

Transposition models split the diffuse irradiance into several components, including circumsolar, isotropic and horizon brightening. The main output of a transposition model is the irradiance on a tilted surace, poa_global, and its component, including poa_direct, poa_diffuse, poa_sky_diffuse, poa_ground_diffuse.

pvlib's general purpose transposition function (get_total_irradiance) attibutes the circumsolar irradiance in poa_sky_diffuse.

In contrast, pvlib's two view factor models infinite sheds and ANTS-2D attribute the circumsolar irradiance to poa_direct.

The argument for including circumsolar in poa_sky_diffuse is that it is measured diffuse irradiance. The argument for including circumsolar in poa_direct is that the irradiance originates from around the sun disk and thus is treated as direct irradiance when transposing irradiance or estimating angle of incidence losses.

Activity

  1. cwhanse commented on Sep 29, 2026

    @cwhanse
    Member

    Some external context:

    From PVsyst https://www.pvsyst.com/help/physical-models-used/irradiation-models/transposition-model.html#accuracy-and-validations:

    Two different uses of the circumsolar irradiance in the simulation
    Up to PVsyst V6.7.9, circumsolar irradiance was always combined with isotropic diffuse irradiance for shading and IAM calculations. From V6.8.0, a new treatment was introduced that handles circumsolar irradiance separately. This new transposition required explicit user activation. Since PVsyst V7.0, the new transposition is the default.

    I don't know what the "new treatment" is.

  2. markcampanelli commented on Sep 29, 2026

    @markcampanelli
    Contributor

    I think this issue was mentioned here: #2801 (comment)

    "...we should try to indicate when, say, the circumsolar or horizon components are considered "concentrated", because that may affect how downstream consumers compute with the provided values. Including this info here seems to me like a stretch, but considering the downstream consumers NOW might shed some more light on if this would be worth the additional complexity."

  3. adriesse commented on Sep 30, 2026

    @adriesse
    Member

    The reality of circumsolar diffuse is that it's neither isotropic nor concentrated near the sun, so which way you lean can rightly depend on the application.

  4. cwhanse commented on Sep 30, 2026

    @cwhanse
    Member

    it's neither isotropic nor concentrated near the sun

    Can you elaborate on the second point? I thought circumsolar was concentrated in an annulus around the sun.

  5. adriesse commented on Sep 30, 2026

    @adriesse
    Member

    it's neither isotropic nor concentrated near the sun

    Can you elaborate on the second point? I thought circumsolar was concentrated in an annulus around the sun.

    Yes, around the sun, but not necessarily all near the sun as shown in this simulated sky:

    Image
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions