{
    "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": "=======================================================================\nGoogle Earth Engine ASCE Standardized Reference Evapotranspiration (ET)\n=======================================================================\n\n|version| |build|\n\nGoogle Earth Engine (GEE) functions for computing daily and hourly reference ET.\n\nUsage\n=====\n\nDaily\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 <https://www.usbr.gov/pn/agrimet/agrimetmap/falnda.html>`__.\nThe necessary unit conversions are shown on the input values.\nThe raw input data is available `here <https://www.usbr.gov/pn-bin/daily.pl?station=FALN&year=2015&month=7&day=1&year=2015&month=7&day=1&pcode=ETRS&pcode=MN&pcode=MX&pcode=SR&pcode=YM&pcode=UA>`__.\n\n.. code-block:: console\n\n    import math\n    import ee\n    import geerefet\n\n    # Unit conversions\n    tmin_c = (66.65 - 32) * (5.0 / 9)                          # F -> C\n    tmax_c = (102.80 - 32) * (5.0 / 9)                         # F -> C\n    tdew_c = (57.26 - 32) * (5.0 / 9)                          # F -> C\n    ea = 0.6108 * math.exp(17.27 * tdew_c / (tdew_c + 237.3))  # kPa\n    rs = (674.07 * 0.041868)                                   # Langleys -> MJ m-2 d-1\n    uz = 4.80 * 0.44704                                        # mpg -> m s-1\n    lat = 39.4575                                              # degrees\n\n    etr = geerefet.Daily(\n        tmin=tmin_c, tmax=tmax_c, ea=ea, rs=rs, uz=uz, zw=3, elev=1208.5,\n        lat=lat, doy=182).etr().getInfo()\n\n    print('ETr: {:.2f} mm'.format(float(etr)))\n\nHourly\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 <https://www.usbr.gov/pn/agrimet/agrimetmap/falnda.html>`__.\nThe necessary unit conversions are shown on the input values.\nThe raw input data is available `here <https://www.usbr.gov/pn-bin/instant.pl?station=FALN&year=2015&month=7&day=1&year=2015&month=7&day=1&pcode=OB&pcode=EA&pcode=WS&pcode=SI&print_hourly=1>`__\n\n.. code-block:: console\n\n    import math\n    import ee\n    import geerefet\n\n    # Unit conversions\n    tmean_c = (91.80 - 32) * (5.0 / 9)           # F -> C\n    ea = 1.20                                    # kPa\n    rs = (61.16 * 0.041868)                      # Langleys -> MJ m-2 h-1\n    uz = 3.33 * 0.44704                          # mph -> m s-1\n    lat = 39.4575                                # degrees\n    lon = -118.77388                             # degrees\n\n    etr = geerefet.Hourly(\n        tmean=tmean_c, ea=ea, rs=rs, uz=uz, zw=3, elev=1208.5,\n        lat=lat, lon=lon_radians, doy=182, time=18).etr().getInfo()\n\n    print('ETr: {:.2f} mm'.format(float(etr)))\n\nGRIDMET\n-------\n\nA helper function for computing daily ETo and ETr for `GRIDMET <http://www.climatologylab.org/gridmet.html>`__ images is available.\n\n.. code-block:: console\n\n    import ee\n    import geerefet\n\n    gridmet_img = ee.Image(ee.ImageCollection('IDAHO_EPSCOR/GRIDMET').first())\n    etr = geerefet.Daily.gridmet(gridmet_img).etr().getInfo()\n\n    print('ETr: {:.2f} mm'.format(float(etr)))\n\nNLDAS\n-----\n\nHelper functions for computing daily/hourly ETo/ETr for `NLDAS <https://ldas.gsfc.nasa.gov/nldas/NLDAS2forcing.php>`__ images are available.\n\nFor the daily function, the NLDAS collection must be filtered to a single 24 hour period.\n\n.. code-block:: console\n\n    import ee\n    import geerefet\n\n    nldas_coll = ee.ImageCollection('NASA/NLDAS/FORA0125_H002')\\\n        .filterDate('2017-07-01', '2017-07-02)\n    etr = geerefet.Daily.nldas(nldas_coll).etr().getInfo()\n\n    print('ETr: {:.2f} mm'.format(float(etr)))\n\n.. code-block:: console\n\n    import ee\n    import geerefet\n\n    nldas_img = ee.Image(ee.ImageCollection('NASA/NLDAS/FORA0125_H002').first())\n    etr = geerefet.Hourly.nldas(nldas_img).etr().getInfo()\n\n    print('ETr: {:.2f} mm'.format(float(etr)))\n\nInput Parameters\n================\n\nRequired Parameters (hourly & daily)\n------------------------------------\n\n========  ===================  =================================================\nVariable  Type                 Description [units]\n========  ===================  =================================================\nea        ee.Image             Actual vapor pressure [kPa]\nrs        ee.Image             Incoming shortwave solar radiation [MJ m-2 day-1]\nuz        ee.Image             Wind speed [m s-1]\nzw        ee.Number            Wind speed height [m]\nelev      ee.Image, ee.Number  Elevation [m]\nlat       ee.Image, ee.Number  Latitude [degrees]\ndoy       ee.Image, ee.Number  Day of year\n========  ===================  =================================================\n\nRequired Daily Parameters\n-------------------------\n\n========  ===================  =================================================\nVariable  Type                 Description [units]\n========  ===================  =================================================\ntmin      ee.Image             Minimum daily temperature [C]\ntmax      ee.Image             Maximum daily temperature [C]\n========  ===================  =================================================\n\nRequired Hourly Parameters\n--------------------------\n\n========  ===================  =================================================\nVariable  Type                 Description [units]\n========  ===================  =================================================\ntmean     ee.Image             Average hourly temperature [C]\nlon       ee.Image, ee.Number  Longitude [degrees]\ntime      ee.Number            UTC hour at start of time period\n========  ===================  =================================================\n\nOptional Parameters\n-------------------\n\n========  ===================  ====================================================\nVariable  Type                 Description [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 (default)\n                               * 'simple' -- Simplified clear sky solar formulation (Eq. 19)\n                               * 'array' -- Read Rso values from \"rso\" function parameter\n\nrso       ee.Image, ee.Number  | Clear sky solar radiation [MJ m-2 day-1]\n\n                               * Only needed if rso_type is 'array'\n                               * Defaults to None if not set\n\n========  ===================  ====================================================\n\nIssues\n======\n\nCurrently the user must handle all of the file I/O and unit conversions.\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\nASCE vs. RefET\n==============\n\nTODO: Discuss the differences between \"asce\" and \"refet\" methods.\n\nInstallation\n============\n\nTo install the RefET-GEE python module:\n\n.. code-block:: console\n\n    pip install geerefet\n\nValidation\n==========\n\nPlease see the `validation document <VALIDATION.md>`__ 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 * `earthengine-api <https://github.com/google/earthengine-api>`__\n\nModules needed to run the test suite:\n\n * `pandas <http://pandas.pydata.org>`__\n * `pytest <https://docs.pytest.org/en/latest/>`__\n * `pytz <http://pythonhosted.org/pytz/>`__\n\nReferences\n==========\n\nASCE-EWRI Standardized Reference Evapotranspiration Equation (2005)\n\n * `Report <http://www.kimberly.uidaho.edu/water/asceewri/ascestzdetmain2005.pdf>`__\n * `Appendix <http://www.kimberly.uidaho.edu/water/asceewri/appendix.pdf>`__\n\n.. |build| image:: https://travis-ci.org/cgmorton/RefET-GEE.svg?branch=master\n   :alt: Build status\n   :target: https://travis-ci.org/cgmorton/RefET-GEE\n.. |version| image:: https://badge.fury.io/py/geerefet.svg\n   :alt: Latest version on PyPI\n   :target: https://badge.fury.io/py/geerefet",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "https://github.com/cgmorton/RefET-GEE/archive/v0.1.9.tar.gz",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/cgmorton/RefET-GEE",
        "keywords": "RefET Evapotranspiration GEE",
        "license": "Apache",
        "maintainer": "",
        "maintainer_email": "",
        "name": "geerefet",
        "package_url": "https://pypi.org/project/geerefet/",
        "platform": "",
        "project_url": "https://pypi.org/project/geerefet/",
        "project_urls": {
            "Download": "https://github.com/cgmorton/RefET-GEE/archive/v0.1.9.tar.gz",
            "Homepage": "https://github.com/cgmorton/RefET-GEE"
        },
        "release_url": "https://pypi.org/project/geerefet/0.1.9/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Google Earth Engine ASCE Standardized Reference Evapotranspiration Functions",
        "version": "0.1.9"
    },
    "last_serial": 3897665,
    "releases": {
        "0.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ad6695d13e09074b8a14c8edcd0e8319",
                    "sha256": "e56abe8649d4e9a74d2ea82bfdc1440a9bb7beffa94fb55fba73ee812f7b3666"
                },
                "downloads": -1,
                "filename": "geerefet-0.1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "ad6695d13e09074b8a14c8edcd0e8319",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 10842,
                "upload_time": "2018-04-19T06:35:57",
                "url": "https://files.pythonhosted.org/packages/d2/e0/795874e957f18895365e022256cbc9416e8b63e2f98f567ec4e03a48bf4a/geerefet-0.1.0.tar.gz"
            }
        ],
        "0.1.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "f60bbe7be240aa5a2c1b1bba12ced532",
                    "sha256": "0bbbc73e99fb8b6c2f23ba49e35421f93236052ad280ff8aaace64001023a321"
                },
                "downloads": -1,
                "filename": "geerefet-0.1.5.tar.gz",
                "has_sig": false,
                "md5_digest": "f60bbe7be240aa5a2c1b1bba12ced532",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 24481,
                "upload_time": "2018-04-19T07:26:33",
                "url": "https://files.pythonhosted.org/packages/71/46/c059a8b2fcef830b477936afdaf7ecc7c70531f3b88630bb525d114c6e30/geerefet-0.1.5.tar.gz"
            }
        ],
        "0.1.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "8c2a1427e09304f78c199439a69cd9e9",
                    "sha256": "353e2bc3ce48aff81f9916fb5b5731065ba3841629e6abb48dc700f3840e966f"
                },
                "downloads": -1,
                "filename": "geerefet-0.1.6.tar.gz",
                "has_sig": false,
                "md5_digest": "8c2a1427e09304f78c199439a69cd9e9",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 24789,
                "upload_time": "2018-04-24T04:19:31",
                "url": "https://files.pythonhosted.org/packages/7b/9d/f1c60f8964266a6d548b7dd85fe95720d717d1bac1365dfd8b96ac0d847d/geerefet-0.1.6.tar.gz"
            }
        ],
        "0.1.7": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c302998035db011c3b1ddbecf1f32159",
                    "sha256": "47b349b25e987c0dce3e5deb63d1037975922643f7256775bfa0fcc7b8445cd4"
                },
                "downloads": -1,
                "filename": "geerefet-0.1.7.tar.gz",
                "has_sig": false,
                "md5_digest": "c302998035db011c3b1ddbecf1f32159",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 15945,
                "upload_time": "2018-05-11T14:17:38",
                "url": "https://files.pythonhosted.org/packages/7e/4f/0ecdb8225c8e94e2e418f7cb95415a5bfa1df4c52afedd874ba0eea37932/geerefet-0.1.7.tar.gz"
            }
        ],
        "0.1.9": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "a02c7750db8f044a969f9753e7502bb3",
                    "sha256": "b1c46618e3da5425dbc27d825c4455d92e8e9b826267a29c68789e8f83135641"
                },
                "downloads": -1,
                "filename": "geerefet-0.1.9.tar.gz",
                "has_sig": false,
                "md5_digest": "a02c7750db8f044a969f9753e7502bb3",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 16796,
                "upload_time": "2018-05-25T05:54:33",
                "url": "https://files.pythonhosted.org/packages/90/b8/165465ad1022b71d4ad1193377f205328276bdf49d709afbc73ebd2b7774/geerefet-0.1.9.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "a02c7750db8f044a969f9753e7502bb3",
                "sha256": "b1c46618e3da5425dbc27d825c4455d92e8e9b826267a29c68789e8f83135641"
            },
            "downloads": -1,
            "filename": "geerefet-0.1.9.tar.gz",
            "has_sig": false,
            "md5_digest": "a02c7750db8f044a969f9753e7502bb3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 16796,
            "upload_time": "2018-05-25T05:54:33",
            "url": "https://files.pythonhosted.org/packages/90/b8/165465ad1022b71d4ad1193377f205328276bdf49d709afbc73ebd2b7774/geerefet-0.1.9.tar.gz"
        }
    ]
}