noaaco2


Namenoaaco2 JSON
Version 0.0.4 PyPI version JSON
download
home_pagehttps://github.com/y-takefuji/noaaco2
SummaryA package for displaying co2 graph based on NOAA
upload_time2024-04-22 08:22:02
maintainerNone
docs_urlNone
authoryoshiyasu takefuji
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # noaaco2
[![Open in Code Ocean](https://codeocean.com/codeocean-assets/badge/open-in-code-ocean.svg)](https://codeocean.com/capsule/1444046/tree)

Takefuji Y. (2022) noaaco2: PyPI application for displaying a CO2 graph based on NOAA [Source Code]. https://doi.org/10.24433/CO.7957917.v1

This is under review.

This is a tutorial to debut a PyPI application and to validate software reproducibility for climate professions.

noaaco2 is a PyPI application that scrapes the latest dataset from NOAA via the Internet and 
displays a graph for a specified number of months.

The PyPI environment allows PyPI applications to run on Windows, MacOS, and Linux operating systems.
As long as Python is installed on the system, you can use it without being aware of the operating system.

noaaco2 scrapes the latest csv file from the following NOAA site:

ftp://aftp.cmdl.noaa.gov/products/trends/co2/co2_mm_mlo.csv
<pre>
# --------------------------------------------------------------------							
# USE OF NOAA GML DATA							
#							
# These data are made freely available to the public and the							
# scientific community in the belief that their wide dissemination							
# will lead to greater understanding and new scientific insights.							
...
# Scripps data downloaded from http://scrippsco2.ucsd.edu/data/atmospheric_co2							
# Monthly values are corrected to center of month based on average seasonal							
# cycle. Missing days can be asymmetric which would produce a high or low bias.							
# Missing months have been interpolated	 for NOAA data indicated by negative stdev						
# and uncertainty. We have no information for SIO data about Ndays	 stdv	 unc					
# so that they are also indicated by negative numbers							
# Monthly values are corrected to center of month based on average seasonal,,,,,,,
# cycle. Missing days can be asymmetric which would produce a high or low bias.,,,,,,,
# Missing months have been interpolated, for NOAA data indicated by negative stdev,,,,,,
# and uncertainty. We have no information for SIO data about Ndays, stdv, unc,,,,,
# so that they are also indicated by negative numbers,,,,,,,
year,month,decimal date,average,interpolated,trend,ndays,
1958,3,1958.2027,315.7,314.43,-1,-9.99,-0.99
1958,4,1958.2877,317.45,315.16,-1,-9.99,-0.99
1958,5,1958.3699,317.51,314.71,-1,-9.99,-0.99
...
</pre>

noaaco2 can generate a graph with specified months and save it in result.csv and noaaco2.png.

In order to run noaaco2 application, Python must be installed on your system.
# How to install Python and noaaco2
<pre>
Follow the Python installation steps for Windows, WSL on Windows, MacOS, and Linux operating systems.
1. Download a right installation file from miniconda site:
https://docs.conda.io/en/latest/miniconda.html

2. X-server installation may be needed.
For Windows 11 or 10,WSL on Windows 11 or 10, MacOS, X-server must be installed.
X-server for Windows and WSL on Windows, install VcXsrv Windows X Server.
You can download it from the following site:
https://sourceforge.net/projects/vcxsrv/
For MacOS, you must install XQuartz via Homebrew or brew command.
For Linux operating systems, X-server is ready so that you don't need to install it.

3. PyPI libraries and applications can be installed by the pip installation command.
($) sign indicates the prompt from your system in the terminal. Open the terminal.
And enter the following command to install noaaco2 application.
$ pip install noaaco2
Since noaaco2 uses PyPI libraries such as numpy, pandas and matplotlib, you must install them.
$ pip install numpy pandas matplotlib
noaaco2 uses bash commands such as wget command so that you must install it.
$ sudo apt install wget
</pre>
# How to run noaaco2
noaaco2 takes a single parameter for specifying the number of months. 
Without the number of months, noaaco2 shows a graph with all months in the dataset.

$ noaaco2 \<number-of-months\>

or

$ noaaco2

For example, 24 months, run the following command.

$ noaaco2 24

<img src='https://github.com/y-takefuji/noaaco2/raw/main/noaaco2.png' width=850 height=340 >
 



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/y-takefuji/noaaco2",
    "name": "noaaco2",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "yoshiyasu takefuji",
    "author_email": "takefuji@keio.jp",
    "download_url": "https://files.pythonhosted.org/packages/9f/f1/3cc8fcb6680c70d6d4dfe18223e023ff4dae4ff408dbf5d5f411fc5b41f8/noaaco2-0.0.4.tar.gz",
    "platform": null,
    "description": "# noaaco2\n[![Open in Code Ocean](https://codeocean.com/codeocean-assets/badge/open-in-code-ocean.svg)](https://codeocean.com/capsule/1444046/tree)\n\nTakefuji Y. (2022) noaaco2: PyPI application for displaying a CO2 graph based on NOAA [Source Code]. https://doi.org/10.24433/CO.7957917.v1\n\nThis is under review.\n\nThis is a tutorial to debut a PyPI application and to validate software reproducibility for climate professions.\n\nnoaaco2 is a PyPI application that scrapes the latest dataset from NOAA via the Internet and \ndisplays a graph for a specified number of months.\n\nThe PyPI environment allows PyPI applications to run on Windows, MacOS, and Linux operating systems.\nAs long as Python is installed on the system, you can use it without being aware of the operating system.\n\nnoaaco2 scrapes the latest csv file from the following NOAA site:\n\nftp://aftp.cmdl.noaa.gov/products/trends/co2/co2_mm_mlo.csv\n<pre>\n# --------------------------------------------------------------------\t\t\t\t\t\t\t\n# USE OF NOAA GML DATA\t\t\t\t\t\t\t\n#\t\t\t\t\t\t\t\n# These data are made freely available to the public and the\t\t\t\t\t\t\t\n# scientific community in the belief that their wide dissemination\t\t\t\t\t\t\t\n# will lead to greater understanding and new scientific insights.\t\t\t\t\t\t\t\n...\n# Scripps data downloaded from http://scrippsco2.ucsd.edu/data/atmospheric_co2\t\t\t\t\t\t\t\n# Monthly values are corrected to center of month based on average seasonal\t\t\t\t\t\t\t\n# cycle. Missing days can be asymmetric which would produce a high or low bias.\t\t\t\t\t\t\t\n# Missing months have been interpolated\t for NOAA data indicated by negative stdev\t\t\t\t\t\t\n# and uncertainty. We have no information for SIO data about Ndays\t stdv\t unc\t\t\t\t\t\n# so that they are also indicated by negative numbers\t\t\t\t\t\t\t\n# Monthly values are corrected to center of month based on average seasonal,,,,,,,\n# cycle. Missing days can be asymmetric which would produce a high or low bias.,,,,,,,\n# Missing months have been interpolated, for NOAA data indicated by negative stdev,,,,,,\n# and uncertainty. We have no information for SIO data about Ndays, stdv, unc,,,,,\n# so that they are also indicated by negative numbers,,,,,,,\nyear,month,decimal date,average,interpolated,trend,ndays,\n1958,3,1958.2027,315.7,314.43,-1,-9.99,-0.99\n1958,4,1958.2877,317.45,315.16,-1,-9.99,-0.99\n1958,5,1958.3699,317.51,314.71,-1,-9.99,-0.99\n...\n</pre>\n\nnoaaco2 can generate a graph with specified months and save it in result.csv and noaaco2.png.\n\nIn order to run noaaco2 application, Python must be installed on your system.\n# How to install Python and noaaco2\n<pre>\nFollow the Python installation steps for Windows, WSL on Windows, MacOS, and Linux operating systems.\n1. Download a right installation file from miniconda site:\nhttps://docs.conda.io/en/latest/miniconda.html\n\n2. X-server installation may be needed.\nFor Windows 11 or 10,WSL on Windows 11 or 10, MacOS, X-server must be installed.\nX-server for Windows and WSL on Windows, install VcXsrv Windows X Server.\nYou can download it from the following site:\nhttps://sourceforge.net/projects/vcxsrv/\nFor MacOS, you must install XQuartz via Homebrew or brew command.\nFor Linux operating systems, X-server is ready so that you don't need to install it.\n\n3. PyPI libraries and applications can be installed by the pip installation command.\n($) sign indicates the prompt from your system in the terminal. Open the terminal.\nAnd enter the following command to install noaaco2 application.\n$ pip install noaaco2\nSince noaaco2 uses PyPI libraries such as numpy, pandas and matplotlib, you must install them.\n$ pip install numpy pandas matplotlib\nnoaaco2 uses bash commands such as wget command so that you must install it.\n$ sudo apt install wget\n</pre>\n# How to run noaaco2\nnoaaco2 takes a single parameter for specifying the number of months. \nWithout the number of months, noaaco2 shows a graph with all months in the dataset.\n\n$ noaaco2 \\<number-of-months\\>\n\nor\n\n$ noaaco2\n\nFor example, 24 months, run the following command.\n\n$ noaaco2 24\n\n<img src='https://github.com/y-takefuji/noaaco2/raw/main/noaaco2.png' width=850 height=340 >\n \n\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A package for displaying co2 graph based on NOAA",
    "version": "0.0.4",
    "project_urls": {
        "Bug Tracker": "https://github.com/y-takefuji/noaaco2",
        "Homepage": "https://github.com/y-takefuji/noaaco2"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e68096db88229ece36d5e27addf6f36481dc04decc6ee15cc77a0a2250b61c9b",
                "md5": "b9a3740d3dddcec33fe4e414838865e9",
                "sha256": "e8c3348d7b451e3ebe21d258a9e06b441d856916c38d8de4bf7eb1c11e7f104d"
            },
            "downloads": -1,
            "filename": "noaaco2-0.0.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b9a3740d3dddcec33fe4e414838865e9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 3829,
            "upload_time": "2024-04-22T08:22:00",
            "upload_time_iso_8601": "2024-04-22T08:22:00.793725Z",
            "url": "https://files.pythonhosted.org/packages/e6/80/96db88229ece36d5e27addf6f36481dc04decc6ee15cc77a0a2250b61c9b/noaaco2-0.0.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9ff13cc8fcb6680c70d6d4dfe18223e023ff4dae4ff408dbf5d5f411fc5b41f8",
                "md5": "08f4aec0e84a6b77a2c01595fd883f4e",
                "sha256": "848185fab136303c32a4a5130dec713faa71a8bae4a61c6aab2775424a915534"
            },
            "downloads": -1,
            "filename": "noaaco2-0.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "08f4aec0e84a6b77a2c01595fd883f4e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 3662,
            "upload_time": "2024-04-22T08:22:02",
            "upload_time_iso_8601": "2024-04-22T08:22:02.431462Z",
            "url": "https://files.pythonhosted.org/packages/9f/f1/3cc8fcb6680c70d6d4dfe18223e023ff4dae4ff408dbf5d5f411fc5b41f8/noaaco2-0.0.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-22 08:22:02",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "y-takefuji",
    "github_project": "noaaco2",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "noaaco2"
}
        
Elapsed time: 0.23076s