{ "info": { "author": "Charles Morton", "author_email": "charles.g.morton@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: Apache Software License", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6" ], "description": "===================================================\nASCE Standardized Reference Evapotranspiration (ET)\n===================================================\n\n|version| |build|\n\nNumPy functions for computing daily and hourly reference ET following the ASCE Standardized Reference Evapotranspiration Equations (`ASCE 2005 `_).\n\nUsage\n=====\n\nDaily Example\n-------------\n\nThe following demonstrates how to compute a single daily ETr value using weather data for 2015-07-01 from the `Fallon, NV AgriMet station `__.\nThe necessary unit conversions are shown on the input values.\nThe raw input data is available `here `__.\n\n.. code-block:: console\n\n import math\n import refet\n\n # Compute actual vapor pressure from Tdew\n tdew_c = (49.84 - 32) * (5.0 / 9) # F -> C\n ea = 0.6108 * math.exp(17.27 * tdew_c / (tdew_c + 237.3)) # kPa\n # ea = refet.calcs._saturated_vapor_pressure(tdew_c)\n\n etr = refet.Daily(\n tmin=66.65, tmax=102.80, ea=ea, rs=674.07, uz=4.80, zw=3, elev=1208.5,\n lat=39.4575, doy=182, method='asce',\n input_units={'tmin': 'F', 'tmax': 'F', 'rs': 'Langleys', 'uz': 'mph',\n 'lat': 'deg'}\n ).etr()\n\n print('ETr: {:.2f} mm'.format(float(etr)))\n\nHourly Example\n--------------\n\nThe following demonstrates how to compute a single hourly ETr value using weather data for 18:00 UTC (11:00 AM PDT) on 2015-07-01 from the `Fallon, NV AgriMet station `__.\nThe necessary unit conversions are shown on the input values.\nThe raw input data is available `here `__\n\n.. code-block:: console\n\n import refet\n\n etr = refet.Hourly(\n tmean=91.80, ea=1.20 , rs=61.16, uz=3.33, zw=3, elev=1208.5,\n lat=39.4575, lon=-118.77388, doy=182, time=18, method='asce',\n input_units={'tmean': 'F', 'rs': 'Langleys', 'uz': 'mph', 'lat': 'deg'}\n ).etr()\n\n print('ETr: {:.2f} mm'.format(float(etr)))\n\n\nInput Parameters\n================\n\nRequired Parameters (hourly & daily)\n------------------------------------\n\n======== ========== ====================================================\nVariable Type Description [default units]\n======== ========== ====================================================\nea ndarray Actual vapor pressure [kPa]\nrs ndarray Incoming shortwave solar radiation [MJ m-2 day-1]\nuz ndarray Wind speed [m s-1]\nzw float Wind speed height [m]\nelev ndarray Elevation [m]\nlat ndarray Latitude [degrees]\ndoy ndarray Day of year\n======== ========== ====================================================\n\nRequired Daily Parameters\n-------------------------\n\n======== ========== ====================================================\nVariable Type Description [default units]\n======== ========== ====================================================\ntmin ndarray Minimum daily temperature [C]\ntmax ndarray Maximum daily temperature [C]\n======== ========== ====================================================\n\nRequired Hourly Parameters\n--------------------------\n\n======== ========== ====================================================\nVariable Type Description [default units]\n======== ========== ====================================================\ntmean ndarray Average hourly temperature [C]\nlon ndarray Longitude [degrees]\ntime ndarray UTC hour at start of time period\n======== ========== ====================================================\n\nOptional Parameters\n-------------------\n\n=========== ========== ====================================================\nVariable Type Description [default units]\n=========== ========== ====================================================\nmethod str | Calculation method\n\n * 'asce' -- Calculations will follow ASCE-EWRI 2005 (default)\n * 'refet' -- Calculations will follow RefET software\n\nrso_type str | Override default clear sky solar radiation (Rso) calculation\n | Defaults to None if not set\n\n * 'full' -- Full clear sky solar formulation\n * 'simple' -- Simplified clear sky solar formulation\n * 'array' -- Read Rso values from \"rso\" function parameter\n\nrso array_like | Clear sky solar radiation [MJ m-2 day-1]\n\n * Only used if rso_type == 'array'\n * Defaults to None if not set\n\ninput_units dict | Override default input unit types\n | Input values will be converted to default unit types\n\n=========== ========== ====================================================\n\nIssues\n======\n\nThe functions have **not** been tested for inputs with different shapes/sizes and the broadcasting may not work correctly.\n\nCurrently the user must handle all of the file I/O and unit conversions.\n\nThe user must handle all QA/QC of the input data and no missing data will be filled.\n\nCloudiness Fraction (hourly)\n----------------------------\n\nThe cloudiness fraction (fcd) is computed as the ratio of the measured solar radiation (Rs) to the theoretical clear sky solar radiation (Rso). This ratio cannot be computed directly at night since Rso is 0. ASCE-EWRI 2005 suggests computing a representative nighttime fcd based on the fcd at sunset and/or sunrise.\n\nIn the RefET module fcd is hard coded to 1 for all time steps with very low sun angles since the hourly reference ET is computed independently for each time step.\n\nCalculation Method - ASCE vs. RefET\n===================================\n\nThe main difference between the two \"methods\" is that the \"asce\" method attempts to follow the equations in `ASCE 2005 `_, whereas the \"refet\" method attempts to follow the calculations of the `RefET Software `__ as closely as possible. The output between these methods is generally negligible (if not identical for realistic numbers of significant digits). Note that the default is set to \"asce\" to best match the calculations a user would expect to have happen. The \"refet\" method was added in order to help validate to the RefET Software.\n\nInstallation\n============\n\nThe RefET python module can be installed with conda or pip:\n\n.. code-block:: console\n\n conda install refet\n\nValidation\n==========\n\nPlease see the `validation document `__ for additional details on the source of the test values and the comparison of the functions to the Ref-ET software.\n\nDependencies\n============\n\n * `numpy `__\n\nModules needed to run the test suite:\n\n * `pandas `__\n * `pytest `__\n * `pytz `__\n\nReferences\n==========\n\n.. _references:\n\n.. [ASCE2005]\n | ASCE-EWRI (2005). The ASCE standardized reference evapotranspiration equation.\n | `https://ascelibrary.org/doi/book/10.1061/9780784408056 `__\n\n.. |build| image:: https://travis-ci.org/WSWUP/RefET.svg?branch=master\n :alt: Build status\n :target: https://travis-ci.org/WSWUP/RefET\n.. |version| image:: https://badge.fury.io/py/refet.svg\n :alt: Latest version on PyPI\n :target: https://badge.fury.io/py/refet", "description_content_type": "", "docs_url": null, "download_url": "https://github.com/WSWUP/RefET/archive/v0.3.10.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/WSWUP/RefET", "keywords": "RefET Evapotranspiration", "license": "Apache", "maintainer": "", "maintainer_email": "", "name": "refet", "package_url": "https://pypi.org/project/refet/", "platform": "", "project_url": "https://pypi.org/project/refet/", "project_urls": { "Download": "https://github.com/WSWUP/RefET/archive/v0.3.10.tar.gz", "Homepage": "https://github.com/WSWUP/RefET" }, "release_url": "https://pypi.org/project/refet/0.3.10/", "requires_dist": null, "requires_python": "", "summary": "ASCE Standardized Reference Evapotranspiration Functions", "version": "0.3.10" }, "last_serial": 4871473, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "ae7adf0330bc43f416dc2520b32886fa", "sha256": "a803493ea4566c19d371af6b3c26f111a2387fd2e1d1cbf3fd3adde15322ac79" }, "downloads": -1, "filename": "RefET-0.0.1.tar.gz", "has_sig": false, "md5_digest": "ae7adf0330bc43f416dc2520b32886fa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7172, "upload_time": "2017-12-07T03:19:42", "url": "https://files.pythonhosted.org/packages/2c/c3/05016a62fe1e07e309892ff9a63d4793cb4965ab8bd4f803d05ae79aa94a/RefET-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "de68df8e4e79a445cc003bc46b5be0bb", "sha256": "f0ab0986d72c294644fbe7f3fce033bbee44293b19f59b14979ebc9d21b801e4" }, "downloads": -1, "filename": "RefET-0.0.2.tar.gz", "has_sig": false, "md5_digest": "de68df8e4e79a445cc003bc46b5be0bb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7860, "upload_time": "2017-12-07T20:47:01", "url": "https://files.pythonhosted.org/packages/2e/64/9a6c86a08ec54f3a683e5bc33d5b654c04e4e9db966e464094abf62699c8/RefET-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "b8a3771e9762a9670d078ff9841ab834", "sha256": "c0d230f89e286c89a3a8aad559d1a2095eab91321353cc8e47b2330a434597f0" }, "downloads": -1, "filename": "refET-0.0.3.tar.gz", "has_sig": false, "md5_digest": "b8a3771e9762a9670d078ff9841ab834", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12555, "upload_time": "2017-12-10T23:42:39", "url": "https://files.pythonhosted.org/packages/51/e4/c74179a7472e4037b7358806d2d92b6341ac989e8e0bd75a3f8a1e8e6e36/refET-0.0.3.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "b445d63c74f94b153e574f301b4eefe9", "sha256": "a25c5798210bc949eeb0d2e078f143a790dc532bf2bb250935fdb4f86fc60324" }, "downloads": -1, "filename": "refET-0.1.0.tar.gz", "has_sig": false, "md5_digest": "b445d63c74f94b153e574f301b4eefe9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12489, "upload_time": "2017-12-14T22:51:05", "url": "https://files.pythonhosted.org/packages/80/91/8f0ec30ea6c1280aeef82693d9900d7a57a99e5d1a8eb56781bc83c81dbe/refET-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "ce2582b26a084fb97b004284e8812d7f", "sha256": "26fd5d0c2a895b204e864f85577afb8aef25fa1f91dfa0f757ca68431bb2ea2c" }, "downloads": -1, "filename": "refET-0.2.0.tar.gz", "has_sig": false, "md5_digest": "ce2582b26a084fb97b004284e8812d7f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9592, "upload_time": "2018-03-02T00:45:38", "url": "https://files.pythonhosted.org/packages/65/6a/37974c343f06bf16f728129abe70fe90a348854fdeb2835bf8772ec50e58/refET-0.2.0.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "c820b6cd10712d6ffed0dffa65a9796e", "sha256": "59a854cee9299b02c1cafeac8ec34b4154806d208019385647abf03afa3136f3" }, "downloads": -1, "filename": "refET-0.2.3.tar.gz", "has_sig": false, "md5_digest": "c820b6cd10712d6ffed0dffa65a9796e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9973, "upload_time": "2018-03-06T23:36:49", "url": "https://files.pythonhosted.org/packages/9c/07/e07b62ff36df6766dd03a6854b0cbc72fc13f8035c498bf7353de66e2f3a/refET-0.2.3.tar.gz" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "b9c9e7a15cf4fa72b8dd95ac38b93a80", "sha256": "368309c31503b7014ab7d02a1e3dddbf227bbf546bf2d806e3eafb8b8d6b9e74" }, "downloads": -1, "filename": "refET-0.2.4.tar.gz", "has_sig": false, "md5_digest": "b9c9e7a15cf4fa72b8dd95ac38b93a80", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12287, "upload_time": "2018-04-20T18:43:58", "url": "https://files.pythonhosted.org/packages/7c/22/3160b91e0623004e8ea8dde903124d6749aee73e71ebad4a401f8408bd72/refET-0.2.4.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "8d548b8eeb3c114173e5c3bde87ac7c6", "sha256": "5f02540af07f5f56fc0df0d3ee18444be6c13f237db11ab0a46c4fabc05f4a70" }, "downloads": -1, "filename": "refET-0.3.0.tar.gz", "has_sig": false, "md5_digest": "8d548b8eeb3c114173e5c3bde87ac7c6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12264, "upload_time": "2018-04-20T21:01:20", "url": "https://files.pythonhosted.org/packages/40/9c/3a351222cc15c82dfd22304b576cb8f57b909ce5a964c8ce5ef73e27cf69/refET-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "d2b8efcd98564cadce9456ddabab9697", "sha256": "29ece4e7d21f042b6707797abfcb925bdc27103caaf81dcb1943d259cf2d601c" }, "downloads": -1, "filename": "refET-0.3.1.tar.gz", "has_sig": false, "md5_digest": "d2b8efcd98564cadce9456ddabab9697", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12734, "upload_time": "2018-04-20T21:24:25", "url": "https://files.pythonhosted.org/packages/5a/78/f8cb64d24ecb36b03ec49da0a8d174504a3baaff72538d1dcba365d71f29/refET-0.3.1.tar.gz" } ], "0.3.10": [ { "comment_text": "", "digests": { "md5": "25de91999dbcba7e66f6659452f5c0b0", "sha256": "2f2f558fc8c1ed62462a434bdf542fb8081ea69c7c216ff7c3214457a14e9c4d" }, "downloads": -1, "filename": "refet-0.3.10.tar.gz", "has_sig": false, "md5_digest": "25de91999dbcba7e66f6659452f5c0b0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 35879, "upload_time": "2019-02-26T20:53:15", "url": "https://files.pythonhosted.org/packages/dc/35/a828e628edf1b31713d4a01626ae0da22dc969ff96b09f57135955d299cb/refet-0.3.10.tar.gz" } ], "0.3.2": [ { "comment_text": "", "digests": { "md5": "3a74c4c9f16d9e22cf89dc5ce34b0d1b", "sha256": "9f90ba565e84d6a8f54a5d6f4349f37a75bea23be821a40d26d8dba16637bf6c" }, "downloads": -1, "filename": "refET-0.3.2.tar.gz", "has_sig": false, "md5_digest": "3a74c4c9f16d9e22cf89dc5ce34b0d1b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12726, "upload_time": "2018-04-24T04:31:16", "url": "https://files.pythonhosted.org/packages/ac/45/8a59a79cda391c9a9ee305dc75682882cbf3f411b74e1d7bc8a2303124cd/refET-0.3.2.tar.gz" } ], "0.3.3": [ { "comment_text": "", "digests": { "md5": "dd3adf9a1df9333b69d24162c435591a", "sha256": "8498271fd0c8dc06809de94d2a5e20f58f473d76cf8c7b01feffbe72c9aa5cf9" }, "downloads": -1, "filename": "refet-0.3.3.tar.gz", "has_sig": false, "md5_digest": "dd3adf9a1df9333b69d24162c435591a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12736, "upload_time": "2018-05-02T16:14:34", "url": "https://files.pythonhosted.org/packages/39/30/f3448b14769b0d719e1bd972783a458cef7d2087cd27581adf299d5b8b69/refet-0.3.3.tar.gz" } ], "0.3.4": [ { "comment_text": "", "digests": { "md5": "e59bed0e22af06fad822b2a586d48be6", "sha256": "031d2c44af0f0b2e5f6dabaddb7ea89ef4c7bd1646c6f2f7242a9502b6324455" }, "downloads": -1, "filename": "refet-0.3.4.tar.gz", "has_sig": false, "md5_digest": "e59bed0e22af06fad822b2a586d48be6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12640, "upload_time": "2018-05-02T17:17:52", "url": "https://files.pythonhosted.org/packages/12/ee/c5f86f463c668951ab89e1c4bb95fe64699e81e844addf3d505639c6c292/refet-0.3.4.tar.gz" } ], "0.3.5": [ { "comment_text": "", "digests": { "md5": "1ca36b2678c2509bd5951cb1d3893cbe", "sha256": "643b1cae82a6667f9fb3786d7f4345eef64041427693ac0426ddbd29750deb99" }, "downloads": -1, "filename": "refet-0.3.5.tar.gz", "has_sig": false, "md5_digest": "1ca36b2678c2509bd5951cb1d3893cbe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13323, "upload_time": "2018-05-11T03:06:15", "url": "https://files.pythonhosted.org/packages/5f/30/7aa0d9cee1739e1e5d23c8d188bf54e1263286bb5e66f05fc4b502d3888f/refet-0.3.5.tar.gz" } ], "0.3.7": [ { "comment_text": "", "digests": { "md5": "dc901caa7bee8bbd846cfb36436f5ee4", "sha256": "1b614ffbdaa44bcdb1869d8c2095583e6509a0cb6be952d643893a4f55dce220" }, "downloads": -1, "filename": "refet-0.3.7.tar.gz", "has_sig": false, "md5_digest": "dc901caa7bee8bbd846cfb36436f5ee4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13526, "upload_time": "2018-08-29T19:18:07", "url": "https://files.pythonhosted.org/packages/bf/66/5d1fc42ddea93b2edbbdab07389d45dcbb638adb6ed3c62cade3670a6f2b/refet-0.3.7.tar.gz" } ], "0.3.8": [ { "comment_text": "", "digests": { "md5": "3654586efd89e3f2113621c3bac6c5dc", "sha256": "81a6630db3d2a9fc4db70b67b84e8de10e9a2198ec77bdb36a031e15633b55db" }, "downloads": -1, "filename": "refet-0.3.8.tar.gz", "has_sig": false, "md5_digest": "3654586efd89e3f2113621c3bac6c5dc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34116, "upload_time": "2019-02-02T19:15:03", "url": "https://files.pythonhosted.org/packages/65/1c/7c945f536ed4fbe3b68d03c96b59bd12697d88a386a75e3c78aa19a7e927/refet-0.3.8.tar.gz" } ], "0.3.9": [ { "comment_text": "", "digests": { "md5": "8a41ef9798365dbf8599856aee6dc758", "sha256": "a0def55e54a35394aac74bab2bc039a2bf2570148ef3230aba14d5999b35b1d3" }, "downloads": -1, "filename": "refet-0.3.9.tar.gz", "has_sig": false, "md5_digest": "8a41ef9798365dbf8599856aee6dc758", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34436, "upload_time": "2019-02-02T23:18:35", "url": "https://files.pythonhosted.org/packages/49/1f/7154814936840e4d59be7d3d8e416e1455d68976c25c5fb98785830e1ebc/refet-0.3.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "25de91999dbcba7e66f6659452f5c0b0", "sha256": "2f2f558fc8c1ed62462a434bdf542fb8081ea69c7c216ff7c3214457a14e9c4d" }, "downloads": -1, "filename": "refet-0.3.10.tar.gz", "has_sig": false, "md5_digest": "25de91999dbcba7e66f6659452f5c0b0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 35879, "upload_time": "2019-02-26T20:53:15", "url": "https://files.pythonhosted.org/packages/dc/35/a828e628edf1b31713d4a01626ae0da22dc969ff96b09f57135955d299cb/refet-0.3.10.tar.gz" } ] }