EBSILON®Professional Online Documentation
EbsScript / EbsScript Interface Units / InterfaceUnit-Solar
In This Topic
    InterfaceUnit-Solar
    In This Topic

    InterfaceUnit - Solar

    The functions of this interface unit provide the direct access to the algorithms of solar component 117. The function calls including the input and output variables are documented in the unit @Solar

     

    Name

    Purpose

    Arguments

    Return value

    Example

    solGetPosition

    retrieves the sun altitude and the
    azimuth angle sun

    Input

    1: INTEGER: Solar algorithm (for details see Unit Solar)

    2: INTEGER: Timing flag (0 - solar time, 1 - local time)

    3: REAL: date and time (in DATE format)

    4: REAL: Latitude (-90 ° to 90 °)

    5: REAL: longitude (-180 ° to 180 °)

    6: REAL: time zone (-12h to 12h)

    7: REAL: pressure (bar)

    8: REAL: Ambient temperature (° C)

    Output

    9: REAL: Sun altitude

    10: REAL: azimuth angle sun

    SolarDataResultEnum (INTEGER
    Enumeration, Details 
    see Unit Solar)

     

    solGetIncidenceAngles

     

    retrieves the incident angle and the 
    Track  / Transversal angle

    Input

    1: REAL: Sun altitude

    2: REAL: azimuth angle sun

    3: REAL: azimuth angle solar panel

    4: REAL: Tilt angle solar panel to the horizon

    Output

    5: Real: angle of incidence

    6: REAL: Transverse angle

    SolarDataResultEnum (INTEGER
    Enumeration, Details 
    see Unit Solar)

    solGetPositionAndIncidenceAngles

     

    retrieves the
    - sun altitude
    - azimuth angle sun
    - incident angle
    - Track  / Transversal angle

    Input

    1: INTEGER: Solar algorithm (for details see Unit Solar)

    2: INTEGER: Timing flag (0 - solar time,
            1 - local time)

    3: REAL: date and time (in DATE format)

    4: REAL: Latitude (-90 ° to 90 °)

    5: REAL: longitude (-180 ° to 180 °)

    6: REAL: time zone (-12h to 12h)

    7: REAL: pressure (bar)

    8: REAL: Ambient temperature (° C)

    9: REAL: azimuth angle solar panel

    10: REAL: Inclination angle solar panel to the horizon

    Output

    11: REAL: Sun altitude

    12: REAL: azimuth angle sun

    13: REAL: angle of incidence

    14: REAL: transversal angle

    SolarDataResultEnum (INTEGER
    Enumeration, Details 
    see Unit Solar)

    solGetPositionOfSun

     

    calls solGetPosition with inputs from
    Comp 117 (comp containing
    solar data )

    retrieves the

    - sun altitude
    - azimuth angle sun

    Input

    1: EBSCOMP117: EBSILON component data 117
    2: REAL: Pressure, bar, used for refraction correction and ambient pressure

    Output

    3: REAL:
        sun altitude
    4: REAL:
       azimuth angle sun

    SolarDataResultEnum (INTEGER
    Enumeration, Details 
    see Unit Solar)

    solGetPositionAndIncidenceAnglesOfSun

     

    calls  solGetPosition and 
    solGetIncidenceAngles with inputs from Comp 117 (comp containing
    solar data)
    retrieves the

    - sun altitude
    - azimuth angle sun
    - incident angle
    - Track  / Transversal angle

    Input

    1: EBSCOMP117: EBSILON component data 117

    2: REAL: Pressure, bar, used for refraction correction and ambient pressure

    Output

    3: REAL: Sun altitude

    4: REAL:
        Azimuth angle -
         Sun

    5: REAL: angle of
        incidence

    6: REAL: Transverse   
        angle

    SolarDataResultEnum (INTEGER
    Enumeration, Details 
    see Unit Solar)

    solSetPositionAndIncidenceAnglesOfSun

     

    calls solGetPosition und solGetIncidenceAngles input / output from and to Comp 117 (comp containing solar data)
    input and output to and from Comp 117 (solar data (Sun)
    Input / Output

    1: EBSCOMP117: EBSILON component data 117

    Input

    2: REAL: Pressure, bar, used for refraction correction and ambient pressure
    SolarDataResultEnum (INTEGER
    Enumeration, Details 
    see Unit Solar)

    solGetIncidenceAnglesOfSunAndOrientation

     

    calls solGetIncidenceAngles ,
    with calculation of elev/ azim by
    Comp 117 ( (solar data))
    retrieves the
    - incident angle
    - Track  / Transversal angle
    calculated from comp 117 ( (solar data)

    Input

    1: EBSCOMP117: EBSILON component data 117

    2: REAL: Pressure, bar, used for refraction correction and ambient pressure

    3: REAL: azimuth angle solar panel

    4: REAL: Tilt angle solar panel to the horizon

    Output

    5: REAL: angle of incidence

    6: REAL: Transverse angle

    SolarDataResultEnum (INTEGER
    Enumeration, Details 
    see Unit Solar)