pvlib.zip光伏能源模拟

README ------ NREL provides a C implementation of the solar position algorithm described in [Reda, I.; Andreas, A. (2003). Solar Position Algorithm for Solar Radiation Applications. 55 pp.; NREL Report No. TP-560-34302](http://www.nrel.gov/docs/fy08osti/34302.pdf). This folder contains the files required to make SPA C code accessible to the `pvlib-python` package. We use the Cython package to wrap the NREL SPA implementation. ** Due to licensing issues, the SPA C files can _not_ be distributed with `pvlib-python`. You must download the SPA C files from the [NREL website](https://midcdmz.nrel.gov/spa/). ** Download the `spa.c` and `spa.h` files from NREL, and copy them into the `pvlib/spa_c_files` directory. When the extension is built, the ``timezone`` field in the SPA C files is replaced with `time_zone` to avoid a nameclash with the function `__timezone` that is redefined by Python>=3.5. This issue is [Python bug 24643](https://bugs.python.org/issue24643). There are a total of 5 files needed to compile the C code, described below: * `spa.c`: original C code from NREL * `spa.h`: header file for spa.c * `cspa_py.pxd`: a cython header file which essentially tells cython which parts of the main header file to pay attention to * `spa_py.pyx`: the cython code used to define both functions in the python namespace. NOTE: It is possible to provide user access to other paramters of the SPA algorithm through modifying this file * `setup.py`: a distutils file which performs the compiling of the cython code The cython compilation process produces two files: * `spa_py.c`: an intermediate cython c file * `spa_py.so` or `spa_py.<cpyver-plat>.pyd`: the python module which can be imported into a namespace To create the SPA Python extension, use the following shell command inside this folder: $ python setup.py build_ext --inplace There are four optional keyword arguments `delta_ut1=0`, `slope=30.0`, `azm_rotation=-10`, `atmos_refract` that effect four optional return values `incidence`, `suntransit`, `sunrise`, and `sunset`. If not given, the defaults shown are used. There is an example in `spa_py_example.py` that contains a test function called `spa_calc_example` that users can use to check that the result is consistent with expected values: >>> from spa_py_example import spa_calc_example >>> r = spa_calc_example() { 'year': 2004, 'month': 10, 'day': 17, 'hour': 12, 'minute': 30, 'second': 30.0, 'delta_ut1': 0.0, 'delta_t': 67.0, 'time_zone': -7.0, 'longitude': -105.1786, 'latitude': 39.742476, 'elevation': 1830.14, 'pressure': 820.0, 'temperature': 11.0, 'slope': 30.0, 'azm_rotation': -10.0, 'atmos_refract': 0.5667, 'function': 3, 'e0': 39.59209464796398, 'e': 39.60858878898177, 'zenith': 50.39141121101823, 'azimuth_astro': 14.311961805946808, 'azimuth': 194.3119618059468, 'incidence': 25.42168493680471, 'suntransit': 11.765833793714224, 'sunrise': 6.22578372122376, 'sunset': 17.320379610556166 }