Module ImportFrom alias Import alias Assign NameStore Call AttributeLoad NameLoad attr Str Import alias identifier Import alias identifier ImportFrom alias alias ImportFrom alias ImportFrom alias ImportFrom alias alias ClassDef bases NameLoad body Expr Str FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam defaults Num Num Num NameLoad BinOpDiv Num Num kwarg body Assign AttributeStore NameLoad attr NameLoad Assign AttributeStore NameLoad attr NameLoad Assign AttributeStore NameLoad attr NameLoad Assign AttributeStore NameLoad attr NameLoad Assign AttributeStore NameLoad attr NameLoad Expr Call AttributeLoad Call NameLoad NameLoad NameLoad attr NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam defaults body Assign NameStore Call NameLoad NameLoad NameLoad AttributeLoad NameLoad attr AttributeLoad NameLoad attr AttributeLoad NameLoad attr AttributeLoad NameLoad attr AttributeLoad NameLoad attr Return NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam defaults NameLoad NameLoad NameLoad kwarg body Expr Str If CompareIs NameLoad NameLoad body Assign NameStore Call NameLoad NameLoad NameLoad NameLoad Return Call NameLoad keyword NameLoad keyword NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults NameLoad NameLoad Str kwarg body Expr Str Assign NameStore Call AttributeLoad NameLoad attr Str AttributeLoad NameLoad attr Assign NameStore Call AttributeLoad NameLoad attr Str AttributeLoad NameLoad attr TryExcept body Assign NameStore SubscriptLoad NameLoad Index Str handlers ExceptHandler type NameLoad body Assign NameStore AttributeLoad NameLoad attr TryExcept body Assign NameStore SubscriptLoad NameLoad Index Str handlers ExceptHandler type NameLoad body Assign NameStore AttributeLoad NameLoad attr If CompareIs NameLoad NameLoad body Assign NameStore Call AttributeLoad NameLoad attr AttributeLoad NameLoad attr Assign NameStore Call AttributeLoad NameLoad attr NameLoad keyword AttributeLoad NameLoad attr If CompareIs NameLoad NameLoad body Assign NameStore Call AttributeLoad NameLoad attr NameLoad Return Call AttributeLoad NameLoad attr NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad keyword NameLoad keyword NameLoad keyword NameLoad keyword AttributeLoad NameLoad attr NameLoad decorator_list decorator_list ClassDef bases NameLoad NameLoad body Expr Str FunctionDef arguments args NameParam NameParam NameParam defaults NameLoad NameLoad kwarg body If CompareIsNot NameLoad NameLoad body Assign NameStore AttributeLoad NameLoad attr orelse Assign NameStore Dict If CompareIsNot NameLoad NameLoad body Assign NameStore AttributeLoad NameLoad attr orelse Assign NameStore Dict Assign NameStore Call NameLoad BinOpAdd BinOpAdd Call NameLoad Call AttributeLoad NameLoad attr Call NameLoad Call AttributeLoad NameLoad attr Call NameLoad Call AttributeLoad NameLoad attr Expr Call AttributeLoad Call NameLoad NameLoad NameLoad attr NameLoad decorator_list decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults Num Num Num NameLoad BinOpDiv Num Num body Expr Str Expr Call AttributeLoad NameLoad attr Str Expr Call AttributeLoad NameLoad attr BinOpAdd Str Str NameLoad NameLoad NameLoad NameLoad NameLoad Expr Call AttributeLoad NameLoad attr Str Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr TryExcept body Expr Call AttributeLoad AttributeLoad AttributeLoad NameLoad attr attr attr AttributeLoad NameLoad attr AttributeLoad NameLoad attr handlers ExceptHandler type NameLoad body Raise Call NameLoad BinOpAdd Str Str Assign NameStore AttributeLoad NameLoad attr Assign NameStore BinOpSub NameLoad Num Assign NameStore BinOpSub Num NameLoad Assign NameStore BinOpMult Call NameLoad NameLoad Call NameLoad NameLoad Assign NameStore BinOpMult Call NameLoad NameLoad Call NameLoad NameLoad Assign NameStore Call NameLoad NameLoad Assign NameStore BinOpSub NameLoad Num Expr Call AttributeLoad NameLoad attr Str NameLoad Assign NameStore BinOpSub BinOpMult NameLoad Call NameLoad NameLoad BinOpMult NameLoad Call NameLoad NameLoad Assign NameStore BinOpSub BinOpAdd BinOpMult BinOpMult NameLoad Call NameLoad NameLoad Call NameLoad NameLoad BinOpMult BinOpMult NameLoad Call NameLoad NameLoad Call NameLoad NameLoad BinOpMult NameLoad Call NameLoad NameLoad Assign NameStore BinOpAdd BinOpAdd BinOpMult BinOpMult NameLoad Call NameLoad NameLoad Call NameLoad NameLoad BinOpMult BinOpMult NameLoad Call NameLoad NameLoad Call NameLoad NameLoad BinOpMult NameLoad Call NameLoad NameLoad Assign NameStore Call AttributeLoad NameLoad attr BinOpSub Num Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr NameLoad NameLoad keyword NameLoad Assign SubscriptStore NameLoad Index CompareLtE NameLoad Num AttributeLoad NameLoad attr If NameLoad body Expr Call AttributeLoad NameLoad attr Str Assign NameStore BinOpDiv Num NameLoad Assign NameStore Call AttributeLoad NameLoad attr BinOpMult NameLoad Call NameLoad NameLoad Num Assign NameStore Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr NameLoad Assign NameStore CompareLt NameLoad Num Assign NameStore Call AttributeLoad NameLoad attr keyword NameLoad Assign SubscriptStore NameLoad Index UnaryOpInvert NameLoad BinOpSub SubscriptLoad NameLoad Index UnaryOpInvert NameLoad SubscriptLoad NameLoad Index UnaryOpInvert NameLoad Assign SubscriptStore NameLoad Index NameLoad BinOpAdd SubscriptLoad NameLoad Index NameLoad SubscriptLoad NameLoad Index NameLoad orelse Expr Call AttributeLoad NameLoad attr Str Assign NameStore NameLoad Assign NameStore Call AttributeLoad NameLoad attr Assign SubscriptStore NameLoad Index CompareGt NameLoad NameLoad NameLoad Assign SubscriptStore NameLoad Index CompareLt NameLoad UnaryOpUSub NameLoad UnaryOpUSub NameLoad Assign NameStore Call AttributeLoad NameLoad attr ListLoad Call NameLoad NameLoad BinOpMult NameLoad Num Call NameLoad NameLoad Assign NameStore Call AttributeLoad NameLoad attr ListLoad NameLoad NameLoad NameLoad Assign NameStore Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr BinOpMult NameLoad NameLoad keyword Num Assign NameStore Call AttributeLoad NameLoad attr NameLoad keyword NameLoad Assign NameStore Call AttributeLoad NameLoad attr ListLoad ListLoad Num Num Num ListLoad Num Call NameLoad UnaryOpUSub NameLoad UnaryOpUSub Call NameLoad UnaryOpUSub NameLoad ListLoad Num Call NameLoad UnaryOpUSub NameLoad Call NameLoad UnaryOpUSub NameLoad Expr Call AttributeLoad NameLoad attr Str NameLoad Assign NameStore AttributeLoad Call AttributeLoad NameLoad attr NameLoad NameLoad attr Expr Call AttributeLoad NameLoad attr Str NameLoad Assign NameStore AttributeLoad Call AttributeLoad NameLoad attr ListLoad SubscriptLoad NameLoad ExtSlice Slice Index Num SubscriptLoad NameLoad ExtSlice Slice Index Num BinOpMult SubscriptLoad NameLoad ExtSlice Slice Index Num Num attr Expr Call AttributeLoad NameLoad attr Str NameLoad Assign NameStore Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr BinOpPow NameLoad Num keyword Num Assign NameStore Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr BinOpPow NameLoad Num keyword Num Expr Call AttributeLoad NameLoad attr Str NameLoad NameLoad Assign NameStore CompareNotEq NameLoad Num Assign SubscriptStore NameLoad Index NameLoad AttributeLoad BinOpDiv AttributeLoad SubscriptLoad NameLoad Index NameLoad attr SubscriptLoad NameLoad Index NameLoad attr Expr Call AttributeLoad NameLoad attr Str NameLoad Assign NameStore Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr SubscriptLoad NameLoad ExtSlice Slice Index Num SubscriptLoad NameLoad ExtSlice Slice Index Num keyword NameLoad Assign NameStore BinOpAdd BinOpSub Num NameLoad NameLoad AugAssignAdd SubscriptStore NameLoad Index CompareLt NameLoad Num Num AugAssignSub SubscriptStore NameLoad Index CompareGtE NameLoad Num Num Assign NameStore BinOpSub Num Call AttributeLoad NameLoad attr Call AttributeLoad NameLoad attr Call AttributeLoad Call AttributeLoad NameLoad attr BinOpMult NameLoad NameLoad keyword NameLoad attr keyword Num Assign NameStore Call AttributeLoad NameLoad attr Dict Str Str Str Str NameLoad NameLoad NameLoad NameLoad keyword NameLoad Assign SubscriptStore NameLoad Index CompareGt NameLoad Num AttributeLoad NameLoad attr Return NameLoad decorator_list
N/A __future__ division N/A logging N/A pvl_logger N/A N/A logging getLogger pvlib N/A numpy np N/A pandas pd pvlib.tools cosd sind pvlib.pvsystem PVSystem pvlib.location Location pvlib irradiance atmosphere SingleAxisTracker N/A PVSystem N/A N/A 
    Inherits all of the PV modeling methods from PVSystem.
     __init__ N/A N/A self axis_tilt axis_azimuth max_angle backtrack gcr N/A 0 0 90 True N/A 2.0 7.0 kwargs N/A N/A N/A self axis_tilt axis_tilt N/A N/A self axis_azimuth axis_azimuth N/A N/A self max_angle max_angle N/A N/A self backtrack backtrack N/A N/A self gcr gcr N/A N/A N/A N/A super SingleAxisTracker self __init__ kwargs N/A singleaxis N/A N/A self apparent_zenith apparent_azimuth N/A N/A N/A tracking_data N/A singleaxis apparent_zenith apparent_azimuth N/A self axis_tilt N/A self axis_azimuth N/A self max_angle N/A self backtrack N/A self gcr N/A tracking_data N/A localize N/A N/A self location latitude longitude N/A None None None kwargs N/A N/A Creates a :py:class:`LocalizedSingleAxisTracker`
        object using this object and location data.
        Must supply either location object or
        latitude, longitude, and any location kwargs
        
        Parameters
        ----------
        location : None or Location
        latitude : None or float
        longitude : None or float
        **kwargs : see Location
        
        Returns
        -------
        localized_system : LocalizedSingleAxisTracker
         N/A N/A location None N/A N/A location N/A Location latitude longitude kwargs N/A N/A LocalizedSingleAxisTracker pvsystem self location location N/A get_irradiance N/A N/A self dni ghi dhi dni_extra airmass model N/A None None haydavies kwargs N/A N/A 
        Uses the :func:`irradiance.total_irrad` function to calculate
        the plane of array irradiance components on a tilted surface
        defined by 
        ``self.surface_tilt``, ``self.surface_azimuth``, and
        ``self.albedo``.
        
        Parameters
        ----------
        solar_zenith : float or Series.
            Solar zenith angle.
        solar_azimuth : float or Series.
            Solar azimuth angle.
        dni : float or Series
            Direct Normal Irradiance
        ghi : float or Series
            Global horizontal irradiance
        dhi : float or Series
            Diffuse horizontal irradiance
        dni_extra : float or Series
            Extraterrestrial direct normal irradiance
        airmass : float or Series
            Airmass
        model : String
            Irradiance model.
        
        **kwargs
            Passed to :func:`irradiance.total_irrad`.
        
        Returns
        -------
        poa_irradiance : DataFrame
            Column names are: ``total, beam, sky, ground``.
         N/A surface_tilt N/A N/A kwargs pop surface_tilt N/A self surface_tilt N/A surface_azimuth N/A N/A kwargs pop surface_azimuth N/A self surface_azimuth N/A N/A N/A solar_zenith N/A kwargs N/A solar_zenith N/A N/A N/A KeyError N/A N/A solar_zenith N/A self solar_zenith N/A N/A N/A solar_azimuth N/A kwargs N/A solar_azimuth N/A N/A N/A KeyError N/A N/A solar_azimuth N/A self solar_azimuth N/A N/A dni_extra None N/A N/A dni_extra N/A N/A irradiance extraradiation N/A solar_zenith index N/A dni_extra N/A N/A pd Series dni_extra index N/A solar_zenith index N/A N/A airmass None N/A N/A airmass N/A N/A atmosphere relativeairmass solar_zenith N/A N/A N/A irradiance total_irrad surface_tilt surface_azimuth solar_zenith solar_azimuth dni ghi dhi dni_extra dni_extra airmass airmass model model albedo N/A self albedo kwargs N/A N/A LocalizedSingleAxisTracker N/A SingleAxisTracker Location N/A N/A Highly experimental. __init__ N/A N/A self pvsystem location N/A None None kwargs N/A N/A N/A pvsystem None N/A N/A pv_dict N/A pvsystem __dict__ N/A N/A pv_dict N/A N/A N/A location None N/A N/A loc_dict N/A location __dict__ N/A N/A loc_dict N/A N/A new_kwargs N/A dict N/A N/A N/A list N/A N/A pv_dict items N/A list N/A N/A loc_dict items N/A list N/A N/A kwargs items N/A N/A N/A N/A super LocalizedSingleAxisTracker self __init__ new_kwargs N/A N/A singleaxis N/A N/A apparent_zenith apparent_azimuth axis_tilt axis_azimuth max_angle backtrack gcr N/A 0 0 90 True N/A 2.0 7.0 N/A N/A 
    Determine the rotation angle of a single axis tracker using the
    equations in [1] when given a particular sun zenith and azimuth angle.
    backtracking may be specified, and if so, a ground coverage ratio is 
    required.

    Rotation angle is determined in a panel-oriented coordinate system.
    The tracker azimuth axis_azimuth defines the positive y-axis;
    the positive x-axis is 90 degress clockwise from the y-axis 
    and parallel to the earth surface, and the positive z-axis is 
    normal and oriented towards the sun.
    Rotation angle tracker_theta indicates tracker position relative to horizontal:
    tracker_theta = 0 is horizontal, and positive tracker_theta is a clockwise rotation
    around the y axis in the x, y, z coordinate system.
    For example, if tracker azimuth axis_azimuth is 180 (oriented south), 
    tracker_theta = 30 is a rotation of 30 degrees towards the west, 
    and tracker_theta = -90 is a rotation to the vertical plane facing east.

    Parameters
    ----------
    apparent_zenith : Series
        Solar apparent zenith angles in decimal degrees. 
    
    apparent_azimuth : Series
        Solar apparent azimuth angles in decimal degrees.
    
    axis_tilt : float
        The tilt of the axis of rotation
        (i.e, the y-axis defined by axis_azimuth) with respect to horizontal, 
        in decimal degrees.
    
    axis_azimuth : float
        A value denoting the compass direction along which
        the axis of rotation lies.
        Measured in decimal degrees East of North. 
    
    max_angle : float
        A value denoting the maximum rotation angle, in
        decimal degrees, of the one-axis tracker from its horizontal position
        (horizontal if axis_tilt = 0). 
        A max_angle of 90 degrees allows the tracker to rotate to a vertical
        position to point the panel towards a horizon.  
        max_angle of 180 degrees allows for full rotation.
    
    backtrack : bool
        Controls whether the tracker has the
        capability to "backtrack" to avoid row-to-row shading. 
        False denotes no backtrack capability. 
        True denotes backtrack capability. 
    
    gcr : float
        A value denoting the ground coverage ratio of a tracker
        system which utilizes backtracking; i.e. the ratio between the PV
        array surface area to total ground area. A tracker system with modules 2
        meters wide, centered on the tracking axis, with 6 meters between the
        tracking axes has a gcr of 2/6=0.333. If gcr is not provided, a gcr
        of 2/7 is default. gcr must be <=1.

    Returns
    -------
    DataFrame with the following columns:
    
    * tracker_theta: The rotation angle of the tracker.  
        tracker_theta = 0 is horizontal, and positive rotation angles are
        clockwise.
    * aoi: The angle-of-incidence of direct irradiance onto the
        rotated panel surface.
    * surface_tilt: The angle between the panel surface and the earth
        surface, accounting for panel rotation.
    * surface_azimuth: The azimuth of the rotated panel, determined by 
        projecting the vector normal to the panel's surface to the earth's
        surface.

    References
    ----------
    [1] Lorenzo, E et al., 2011, "Tracking and back-tracking", Prog. in 
    Photovoltaics: Research and Applications, v. 19, pp. 747-753.
     N/A N/A N/A pvl_logger debug tracking.singleaxis N/A N/A N/A pvl_logger debug N/A axis_tilt=%s, axis_azimuth=%s, max_angle=%s,  backtrack=%s, gcr=%.3f axis_tilt axis_azimuth max_angle backtrack gcr N/A N/A N/A pvl_logger debug 
apparent_zenith=
%s
apparent_azimuth=
%s N/A N/A apparent_zenith head N/A N/A apparent_azimuth head N/A N/A N/A N/A N/A N/A N/A pd util testing assert_index_equal N/A apparent_azimuth index N/A apparent_zenith index N/A N/A N/A AssertionError N/A N/A N/A ValueError N/A apparent_azimuth.index and  apparent_zenith.index must match. N/A times N/A apparent_azimuth index N/A az N/A apparent_azimuth 180 N/A apparent_elevation N/A 90 apparent_zenith N/A x N/A N/A cosd apparent_elevation N/A sind az N/A y N/A N/A cosd apparent_elevation N/A cosd az N/A z N/A sind apparent_elevation N/A axis_azimuth_south N/A axis_azimuth 180 N/A N/A N/A pvl_logger debug axis_azimuth_south=%s axis_azimuth_south N/A xp N/A N/A x N/A cosd axis_azimuth_south N/A y N/A sind axis_azimuth_south N/A yp N/A N/A N/A N/A x N/A cosd axis_tilt N/A sind axis_azimuth_south N/A N/A y N/A cosd axis_tilt N/A cosd axis_azimuth_south N/A z N/A sind axis_tilt N/A zp N/A N/A N/A N/A x N/A sind axis_tilt N/A sind axis_azimuth_south N/A N/A y N/A sind axis_tilt N/A cosd axis_azimuth_south N/A z N/A cosd axis_tilt N/A wid N/A N/A pd Series N/A 90 N/A N/A np degrees N/A N/A np arctan2 zp xp index times N/A N/A wid N/A N/A zp 0 N/A np nan N/A backtrack N/A N/A N/A N/A pvl_logger debug applying backtracking N/A axes_distance N/A 1 gcr N/A temp N/A N/A np minimum N/A axes_distance N/A cosd wid 1 N/A wc N/A N/A np degrees N/A N/A np arccos temp N/A v N/A wid 0 N/A widc N/A N/A pd Series index times N/A N/A widc N/A N/A v N/A N/A wid N/A N/A v N/A wc N/A N/A v N/A N/A widc N/A v N/A N/A wid N/A v N/A wc N/A v N/A N/A N/A N/A pvl_logger debug no backtracking N/A widc wid N/A tracker_theta N/A N/A widc copy N/A N/A tracker_theta N/A N/A tracker_theta max_angle max_angle N/A N/A tracker_theta N/A N/A tracker_theta N/A max_angle N/A max_angle N/A panel_norm N/A N/A np array N/A N/A sind tracker_theta N/A tracker_theta 0 N/A cosd tracker_theta N/A sun_vec N/A N/A np array N/A xp yp zp N/A aoi N/A N/A np degrees N/A N/A np arccos N/A N/A np abs N/A N/A np sum N/A sun_vec panel_norm axis 0 N/A aoi N/A N/A pd Series aoi index times N/A rot_x N/A N/A np array N/A N/A 1 0 0 N/A 0 N/A cosd N/A axis_tilt N/A N/A sind N/A axis_tilt N/A 0 N/A sind N/A axis_tilt N/A cosd N/A axis_tilt N/A N/A N/A pvl_logger debug rot_x=
%s rot_x N/A panel_norm_earth N/A N/A N/A np dot rot_x panel_norm T N/A N/A N/A pvl_logger debug panel_norm_earth=%s panel_norm_earth N/A projected_normal N/A N/A N/A np array N/A N/A panel_norm_earth N/A N/A N/A 0 N/A panel_norm_earth N/A N/A N/A 1 N/A N/A panel_norm_earth N/A N/A N/A 2 0 T N/A N/A N/A pvl_logger debug projected_normal=%s projected_normal N/A panel_norm_earth_mag N/A N/A np sqrt N/A N/A np nansum N/A panel_norm_earth 2 axis 1 N/A projected_normal_mag N/A N/A np sqrt N/A N/A np nansum N/A projected_normal 2 axis 1 N/A N/A N/A pvl_logger debug panel_norm_earth_mag=%s, projected_normal_mag=%s panel_norm_earth_mag projected_normal_mag N/A non_zeros N/A projected_normal_mag 0 N/A N/A projected_normal N/A non_zeros N/A N/A N/A N/A projected_normal N/A non_zeros T N/A projected_normal_mag N/A non_zeros T N/A N/A N/A pvl_logger debug renormalized projected_normal=%s projected_normal N/A surface_azimuth N/A N/A pd Series N/A N/A np degrees N/A N/A np arctan2 N/A projected_normal N/A N/A N/A 1 N/A projected_normal N/A N/A N/A 0 index times N/A surface_azimuth N/A N/A 90 surface_azimuth axis_azimuth N/A N/A surface_azimuth N/A N/A surface_azimuth 0 360 N/A N/A surface_azimuth N/A N/A surface_azimuth 360 360 N/A surface_tilt N/A 90 N/A N/A np degrees N/A N/A np arccos N/A N/A N/A N/A pd DataFrame N/A panel_norm_earth projected_normal index times sum axis 1 N/A df_out N/A N/A pd DataFrame N/A tracker_theta aoi surface_azimuth surface_tilt tracker_theta aoi surface_azimuth surface_tilt index times N/A N/A df_out N/A N/A apparent_zenith 90 N/A np nan N/A df_out N/A