snowexsql


Namesnowexsql JSON
Version 1.0.0 PyPI version JSON
download
home_pageNone
SummarySQL Database software for SnowEx data
upload_time2025-10-23 20:38:32
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseGNU
keywords database snow snowex sql
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ====================
Welcome to snowexsql
====================

.. image:: https://readthedocs.org/projects/snowexsql/badge/?version=latest
    :target: https://snowexsql.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

.. image:: https://img.shields.io/github/workflow/status/SnowEx/snowexsql/snowexsql
    :target: https://github.com/SnowEx/snowexsql/actions/workflows/main.yml
    :alt: Testing Status

.. image:: https://img.shields.io/pypi/v/snowexsql.svg
    :target: https://pypi.org/project/snowexsql/
    :alt: Code Coverage

.. image:: https://codecov.io/gh/SnowEx/snowexsql/graph/badge.svg?token=B27OKGBOTR
    :target: https://codecov.io/gh/SnowEx/snowexsql

About
-----
Database access and tools for using the `SnowEx database`_. This tool is
simply a client for accessing the database using python

.. _SnowEx database: https://www.github.com/SnowEx/snowex_db

WARNING - This is under active development in preparation for SnowEx Hackweek.  Use at your own risk.  Data will change as it is QA/QC'd and the end goal is for all data in this database to be pulled from NSIDC.  The goal is for this to become a community database open to all. 


Features
--------

* Database access for SnowEx Database
* Analysis tools
* Useful conversions to pandas and geopandas
* Lots of examples_

.. _examples: https://snowexsql.readthedocs.io/en/latest/gallery/index.html


Installing
----------
If you are just planning on using the database, then only install the
python package instructions below.

I just want to use it
---------------------
Install using pip:

.. code-block::

    pip install snowexsql

I want data fast
-----------------
A programmatic API has been created for fast and standard
access to Point and Layer data. There are two examples_ covering the
features and usage of the api. See the specific api_ documentation for
detailed description.

.. _api: https://snowexsql.readthedocs.io/en/latest/api.html

.. code-block:: python

    from snowexsql.api import PointMeasurements, LayerMeasurements
    # The main functions we will use are `from_area` and `from_filter` like this
    df = PointMeasurements.from_filter(
        date=date(2020, 5, 28), instrument='camera'
    )
    print(df.head())

I need help
------------
Jump over to `our discussion forum <https://github.com/SnowEx/snowexsql/discussions>`_ 
and get help from our community.


I want to contribute
---------------------
Thank you for the interest!

Our community follows the |Contributor Covenant|

.. |Contributor Covenant| image:: https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg
  :target: code_of_conduct.md
.. _contribution guide: https://snowexsql.readthedocs.io/en/latest/community/contributing.html

Have a look at our `contribution guide`_ and see the many ways to get involved!

Documentation
-------------

There is a whole host of resources for users in the documentation. It has been
setup for you to preview in your browser.

In there you will find:

* Examples of database use
* Database structure
* API to the python package snowexsql
* Links to other resources
* Notes about the data uploaded
* And more!

To see the documentation in your browser:

**Warning**: To see the examples/gallery, the snowex db needs to be up. Otherwise they will be left with the
last image submitted to GitHub.

.. code-block:: bash

  make docs

DOI
---
.. |HW22| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.7618102.svg 
   :target: https://doi.org/10.5281/zenodo.7618102
.. |HW24| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.13312706.svg
  :target: https://doi.org/10.5281/zenodo.13312706

* `SnowEx Hackweek 2022 <https://snowex-2022.hackweek.io/intro.html>`_ - |HW22|  
* `SnowEx Hackweek 2024 <https://snowex-2024.hackweek.io/intro.html>`_ - |HW24|

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "snowexsql",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "database, snow, snowex, sql",
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/b1/04/9b68f55373086e636e871ab550c72b7f19e5619f2ba0f2afcaaf33e1aef7/snowexsql-1.0.0.tar.gz",
    "platform": null,
    "description": "====================\nWelcome to snowexsql\n====================\n\n.. image:: https://readthedocs.org/projects/snowexsql/badge/?version=latest\n    :target: https://snowexsql.readthedocs.io/en/latest/?badge=latest\n    :alt: Documentation Status\n\n.. image:: https://img.shields.io/github/workflow/status/SnowEx/snowexsql/snowexsql\n    :target: https://github.com/SnowEx/snowexsql/actions/workflows/main.yml\n    :alt: Testing Status\n\n.. image:: https://img.shields.io/pypi/v/snowexsql.svg\n    :target: https://pypi.org/project/snowexsql/\n    :alt: Code Coverage\n\n.. image:: https://codecov.io/gh/SnowEx/snowexsql/graph/badge.svg?token=B27OKGBOTR\n    :target: https://codecov.io/gh/SnowEx/snowexsql\n\nAbout\n-----\nDatabase access and tools for using the `SnowEx database`_. This tool is\nsimply a client for accessing the database using python\n\n.. _SnowEx database: https://www.github.com/SnowEx/snowex_db\n\nWARNING - This is under active development in preparation for SnowEx Hackweek.  Use at your own risk.  Data will change as it is QA/QC'd and the end goal is for all data in this database to be pulled from NSIDC.  The goal is for this to become a community database open to all. \n\n\nFeatures\n--------\n\n* Database access for SnowEx Database\n* Analysis tools\n* Useful conversions to pandas and geopandas\n* Lots of examples_\n\n.. _examples: https://snowexsql.readthedocs.io/en/latest/gallery/index.html\n\n\nInstalling\n----------\nIf you are just planning on using the database, then only install the\npython package instructions below.\n\nI just want to use it\n---------------------\nInstall using pip:\n\n.. code-block::\n\n    pip install snowexsql\n\nI want data fast\n-----------------\nA programmatic API has been created for fast and standard\naccess to Point and Layer data. There are two examples_ covering the\nfeatures and usage of the api. See the specific api_ documentation for\ndetailed description.\n\n.. _api: https://snowexsql.readthedocs.io/en/latest/api.html\n\n.. code-block:: python\n\n    from snowexsql.api import PointMeasurements, LayerMeasurements\n    # The main functions we will use are `from_area` and `from_filter` like this\n    df = PointMeasurements.from_filter(\n        date=date(2020, 5, 28), instrument='camera'\n    )\n    print(df.head())\n\nI need help\n------------\nJump over to `our discussion forum <https://github.com/SnowEx/snowexsql/discussions>`_ \nand get help from our community.\n\n\nI want to contribute\n---------------------\nThank you for the interest!\n\nOur community follows the |Contributor Covenant|\n\n.. |Contributor Covenant| image:: https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg\n  :target: code_of_conduct.md\n.. _contribution guide: https://snowexsql.readthedocs.io/en/latest/community/contributing.html\n\nHave a look at our `contribution guide`_ and see the many ways to get involved!\n\nDocumentation\n-------------\n\nThere is a whole host of resources for users in the documentation. It has been\nsetup for you to preview in your browser.\n\nIn there you will find:\n\n* Examples of database use\n* Database structure\n* API to the python package snowexsql\n* Links to other resources\n* Notes about the data uploaded\n* And more!\n\nTo see the documentation in your browser:\n\n**Warning**: To see the examples/gallery, the snowex db needs to be up. Otherwise they will be left with the\nlast image submitted to GitHub.\n\n.. code-block:: bash\n\n  make docs\n\nDOI\n---\n.. |HW22| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.7618102.svg \n   :target: https://doi.org/10.5281/zenodo.7618102\n.. |HW24| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.13312706.svg\n  :target: https://doi.org/10.5281/zenodo.13312706\n\n* `SnowEx Hackweek 2022 <https://snowex-2022.hackweek.io/intro.html>`_ - |HW22|  \n* `SnowEx Hackweek 2024 <https://snowex-2024.hackweek.io/intro.html>`_ - |HW24|\n",
    "bugtrack_url": null,
    "license": "GNU",
    "summary": "SQL Database software for SnowEx data",
    "version": "1.0.0",
    "project_urls": {
        "Documentation": "https://snowexsql.readthedocs.io",
        "Homepage": "https://github.com/SnowEx/snowexsql",
        "Issues": "https://github.com/SnowEx/snowexsql/issues",
        "Repository": "https://github.com/SnowEx/snowexsql.git"
    },
    "split_keywords": [
        "database",
        " snow",
        " snowex",
        " sql"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "a43aa46cc6fdd8d3c641c03691dce5deaac7035dd689bfe1c4a3cba44f67bd22",
                "md5": "48f2aff777612d28fe933668b494fad0",
                "sha256": "40197d0c056dbcb01356394b7f49a245851ef0a244079fdbee448fc4c8fe1491"
            },
            "downloads": -1,
            "filename": "snowexsql-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "48f2aff777612d28fe933668b494fad0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 32707,
            "upload_time": "2025-10-23T20:38:30",
            "upload_time_iso_8601": "2025-10-23T20:38:30.980235Z",
            "url": "https://files.pythonhosted.org/packages/a4/3a/a46cc6fdd8d3c641c03691dce5deaac7035dd689bfe1c4a3cba44f67bd22/snowexsql-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b1049b68f55373086e636e871ab550c72b7f19e5619f2ba0f2afcaaf33e1aef7",
                "md5": "0cbd4b3c3f6ce426d545d22f2bae36c8",
                "sha256": "4533d9212d37255ebd3bc8fbee9ec5515471bd0184fc07ff647a3756dafd6c62"
            },
            "downloads": -1,
            "filename": "snowexsql-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "0cbd4b3c3f6ce426d545d22f2bae36c8",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 6310730,
            "upload_time": "2025-10-23T20:38:32",
            "upload_time_iso_8601": "2025-10-23T20:38:32.635954Z",
            "url": "https://files.pythonhosted.org/packages/b1/04/9b68f55373086e636e871ab550c72b7f19e5619f2ba0f2afcaaf33e1aef7/snowexsql-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-23 20:38:32",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "SnowEx",
    "github_project": "snowexsql",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "snowexsql"
}
        
Elapsed time: 2.06638s