{ "info": { "author": "S. Filhol,G. Sutter", "author_email": "simon.filhol@geo.uio.no", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy" ], "description": "\n# Snowpyt: an open-source library to visualize snowpits in Python\nSimon Filhol, November 2016, copyright under the MIT license terms, see the License.txt file\n\nLAST MODIFIED: March 2018 (or see date on github file history)\n\nFeel free to contribute to the project!!!! Many new features can be added...\n\n## To do:\n\n### High Priority\n\n- write function to save and load pit to and from pickle format (currently not working)\n- make ground appear to comfirm the user that the pit reached ground. add note about ground type.\n\n### Low priority \n- specify the figure size and adjust font size in respect\n- render the medatadata text better, convert date to a readable date\n- put option to adjust figure size to desired size and dpi. Return axis variable from plotting function for more advanced plotting if needed (i.e. multiple samples)\n- add option to save pits in Pickle format or CSV\n- add option to save figure in matplotlib format\n- add option to plot when multiple sample columns are given.\n\n\n\n## Objective\nThe objective of this library is to provide visualization tool for snowpit data. \nStarted for the need of the Svalbard Snow Research group, this package should evolve\n to include more snowpit type and visualization scheme. \n\nThe snow grain classification follows the guidelines provided by the UNESCO \n[International Classification for Seasonal Snow on the Ground](http://unesdoc.unesco.org/images/0018/001864/186462e.pdf) \n(Fierz et al., 2009)\n\nFierz, C., Amstrong, R.L., Durand, Y., Etchevers, P., Greene, E., McClung, D.M., Nishimura, K., Satyawali, P.K. and Sokratov, S.A. 2009.The International Classification for Seasonal Snow on the Ground. IHP-VII Technical Documents in \nHydrology N\u00b083, IACS Contribution N\u00b01, UNESCO-IHP, Paris. \n\n## Installation\n\n### Last stable version from the Pypi repository\n\nSimply run the following in your terminal:\n```bash\npip install snowpyt\n```\n### Last development version for contributing to the project:\n\nClone the github repository to a local directory using the following command in your terminal\n\n```bash\ngit clone https://github.com/ArcticSnow/snowpyt.git\n```\nor by downloading the package\n\nThe branch 'master' consists of the latest stable version. Other develepment versions are included in other git branches.\n\nThe package contains all the functions to plot the Snowpyt if library requirements are met. It also contains data samples to test the library. Message us to be added as a contributor, then if you can also modify the code to your own convenience with the following steps:\n\nTo work on a development version and keep using the latest change install it with the following\n```bash\npip install -e [path2folder/snowpyt]\n```\nand to upload latest change to Pypi.org, simply:\n\n1. change the version number in the file `snowpyt/__version__.py`\n2. run from a terminal from the snowpyt folder, given your `$HOME/.pyc` is correctly set:\n\n```bash\npython setup.py upload\n```\n\n### requirements\n\nPython 2.7.9 with the following libraries:\n- [numpy](http://www.numpy.org/)\n- [matplotlib](http://matplotlib.org/)\n- [pandas](http://pandas.pydata.org/)\n- xlrd\n- xlm\n\n## Use\n\n1. There are three ways to import data into Snowpyt:\n\n 1. digitalize your pit with https://niviz.org/ and export your pit as a CAAMLv6 (This format follows an international standard for snowpit). Them use the import_caamlv6() function.\n\n More information about the [CAAML format](http://caaml.org/)\n\n 2. digitalize you snowpit using the excel file template in the [excel file example here](https://github.com/ArcticSnow/snowpyt/blob/master/snowpyt/data_example/20170209_Finse_snowpit.xlsx). Save the excel or libreoffice file in .xslx format (default Excel format).\n\n 3. input directly data into the snowpit class object\n\n \u200b\n\n3. Example:\n\n```python\nfrom snowpyt import pit_class as pc\n\n############################################################\n# Example 1 - using a caamlv6 file:\n\n\n\np = pc.Snowpit()\np.caaml_file= '[PATH TO YOUR FILE].caaml'\np.import_caamlv6()\np.plot(plot_order=['density', 'temperature', 'stratigraphy', 'hardness'])\n\np.plot(metadata=True)\np.plot(plot_order=['density', 'temperature', 'stratigraphy','crystal size'])\n\n# import isotope values (dD, dO18, d-ex)\np.sample_file = '[PATH TO YOUR FILE].csv'\np.import_sample_csv()\n\np.plot(plot_order=['dD', 'd18O','d-ex', 'hardness'])\n\n```\n\nThe isotope `.csv` file should be following this format:\n```\nnumber,height_top,height_bot,dD,d18O,dxs,ice_type\n0,94,93.0,-57.55,-8.16,7.73,S\n1,93,89.8,-61.56,-8.76,8.54,S\n2,89.8,86.6,-75.45,-10.64,9.68,S\n```\n\n4. All the data table are loaded as a Pandas dataframe or Numpy arrays within the snowpyt class object\n\nType the following in your Python console to see the loaded datatable:\n```python\nmypit.table\n\n```\nThis allows for custom plotting using the library of your choice on top of the existing plotting function\n\n6. Extra Sample Values\n\nExtra column of sample values can be added to the excel file. **Column name must be unique**\n\nThe current plotting functions will not plot these extra columns, only the first one. However the values are loaded via pandas in the table as a dataframe (see 5.)\n\n\n\n\n## Want to contribute?\nOnce you have cloned the project to your home directory, create a git branch and here you go. When your edits are stable, merge with the master branch. See this neat tutorial about git branching and merging, [here](https://git-scm.com/book/en/v2/Git-Branching-Basic-Branching-and-Merging)\n\n### List of Contributor\n- Simon Filhol\n- Guillaume Sutter\n- [add your name]\n\n## Example\n![Example snowpit](snowpyt/Standard_pit.png)\n\n\n\n\n\n\n\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ArcticSnow/snowpyt", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "snowpyt", "package_url": "https://pypi.org/project/snowpyt/", "platform": "", "project_url": "https://pypi.org/project/snowpyt/", "project_urls": { "Homepage": "https://github.com/ArcticSnow/snowpyt" }, "release_url": "https://pypi.org/project/snowpyt/0.2.2/", "requires_dist": [ "matplotlib", "pandas", "numpy" ], "requires_python": ">=3.6.0", "summary": "A Python project to visualize snowpit", "version": "0.2.2" }, "last_serial": 5617830, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "a38e20867c58da9bcc20ad3032d19763", "sha256": "f819c8f31d065370c6a7b32634d0ea1f7e3351000b5a905791bcf0b9579ff5cd" }, "downloads": -1, "filename": "snowpyt-0.0.1.tar.gz", "has_sig": false, "md5_digest": "a38e20867c58da9bcc20ad3032d19763", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1342657, "upload_time": "2017-06-16T13:50:04", "url": "https://files.pythonhosted.org/packages/bc/08/27061e9662cb1105594fa985b6378afd42794cfd2f498344e5b34cc27edf/snowpyt-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "8d8e3d9ca9f5e5ec0a80c305392c9a73", "sha256": "6853024875d89b17f4bfc69a9049985008909c4aeb980e7689a0200a11cbe881" }, "downloads": -1, "filename": "snowpyt-0.0.2-py2-none-any.whl", "has_sig": false, "md5_digest": "8d8e3d9ca9f5e5ec0a80c305392c9a73", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 1350704, "upload_time": "2017-06-30T15:35:42", "url": "https://files.pythonhosted.org/packages/56/1f/86b55c76dacaddd5d9ea63ce143e5a003995c4060a81a144b2bdd5d2cdba/snowpyt-0.0.2-py2-none-any.whl" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "ad2d21daa5dcd2f12dad0c13191b5e8b", "sha256": "bc41269c85ae7fe134a1e1f35909aa6cf6280222cdb5d6e698b7d6dcac7e4fc2" }, "downloads": -1, "filename": "snowpyt-0.1.0-py2-none-any.whl", "has_sig": false, "md5_digest": "ad2d21daa5dcd2f12dad0c13191b5e8b", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 1350701, "upload_time": "2017-06-30T15:38:52", "url": "https://files.pythonhosted.org/packages/03/ec/8a854418006dc21a00d09e37d14ff1ef578901ed950e14778ee2cb4f0b28/snowpyt-0.1.0-py2-none-any.whl" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "477c3c78321d4c42f846077a0bb8c2de", "sha256": "712b5cf37634934ee0d638aff549f4f5bb2aa4330bbdf17245d4060e5b9af7c2" }, "downloads": -1, "filename": "snowpyt-0.1.1-py2-none-any.whl", "has_sig": false, "md5_digest": "477c3c78321d4c42f846077a0bb8c2de", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 1350707, "upload_time": "2017-06-30T15:45:23", "url": "https://files.pythonhosted.org/packages/f0/7c/e21aa347480ef1db81c2876dbef1c733c6bf2d19cfc68caa9fddedb4a7d7/snowpyt-0.1.1-py2-none-any.whl" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "b5ea2bed068ac46a165bfbe77ecdd0e3", "sha256": "6e50264df06b42e0aebffdbf31df7ab5a9acf35c020dfebdcfe85b3c47945d7b" }, "downloads": -1, "filename": "snowpyt-0.1.2-py2-none-any.whl", "has_sig": false, "md5_digest": "b5ea2bed068ac46a165bfbe77ecdd0e3", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 1518525, "upload_time": "2017-06-30T15:53:57", "url": "https://files.pythonhosted.org/packages/aa/5e/24ce1404fd0909cbfda84f5a8326a4843da8c051f7d44b2463b295c047bc/snowpyt-0.1.2-py2-none-any.whl" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "f80a63fff2a33fcc6cd1fd2de236d856", "sha256": "a596336b531e41c6bf0980c0d1bd3646b9e41bac197f74b869ba9cc366fc0cbb" }, "downloads": -1, "filename": "snowpyt-0.1.3.tar.gz", "has_sig": false, "md5_digest": "f80a63fff2a33fcc6cd1fd2de236d856", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2054590, "upload_time": "2017-09-07T06:45:23", "url": "https://files.pythonhosted.org/packages/3e/a4/77e52906e99feaf8001f78fdc8fd2a16c271d13b45a5b57366567f002bc2/snowpyt-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "fff4b6b8897b22fdd70f512b36cd3929", "sha256": "72444bb018916696f1eb6d79cc275c67db797cdf03f9ab9a82400320662524b1" }, "downloads": -1, "filename": "snowpyt-0.1.4.tar.gz", "has_sig": false, "md5_digest": "fff4b6b8897b22fdd70f512b36cd3929", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2054589, "upload_time": "2017-09-11T10:54:07", "url": "https://files.pythonhosted.org/packages/f2/7c/4493e09852d2856b94f0d716938eb00fd0c232abf1667ee4a3cbf4d27471/snowpyt-0.1.4.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "0f4a302581a3edfddec33cbfc0a4db12", "sha256": "bd88ea8de95d71ae7b27bbea2d9651e7655e249260cc295c8bb4fe539f7c257a" }, "downloads": -1, "filename": "snowpyt-0.1.5.tar.gz", "has_sig": false, "md5_digest": "0f4a302581a3edfddec33cbfc0a4db12", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2054642, "upload_time": "2017-10-02T12:41:22", "url": "https://files.pythonhosted.org/packages/a2/4b/09cf7ec201d9ca0b2e7f0ba963f406a09af03fbc3d56fa5842637e536f9a/snowpyt-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "3e4c2036b3fff05a0ccdcaa454b62ca2", "sha256": "e4beb00a1765f534caea8327c4eb0c1141826ce84e3965d1e7ac96f16895ff8a" }, "downloads": -1, "filename": "snowpyt-0.1.6.tar.gz", "has_sig": false, "md5_digest": "3e4c2036b3fff05a0ccdcaa454b62ca2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 233070, "upload_time": "2017-10-02T15:09:46", "url": "https://files.pythonhosted.org/packages/10/9d/c412a5022e421cb1566106a56ec3e4a56c75eb4bcefaf426eeb02ed0d056/snowpyt-0.1.6.tar.gz" } ], "0.1.64": [ { "comment_text": "", "digests": { "md5": "d44efacb130b395ed85a9fc6a652e265", "sha256": "3c60e1f1e2974d68f4a8dec96dfa341b45565c70705c847bcc13aa33787c1371" }, "downloads": -1, "filename": "snowpyt-0.1.64.tar.gz", "has_sig": false, "md5_digest": "d44efacb130b395ed85a9fc6a652e265", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 233435, "upload_time": "2017-10-02T15:23:56", "url": "https://files.pythonhosted.org/packages/2a/13/157094825854955248e7182233388b787b3da9cac3944abe8209a3d2ab0f/snowpyt-0.1.64.tar.gz" } ], "0.1.65": [ { "comment_text": "", "digests": { "md5": "3e72e0bed0e5ef35e73dfeea99c75474", "sha256": "9e8d3fcb3ce3ad28d0a1ab1f9e963a66fca6f6f07f30571a2393fe3f227fed3f" }, "downloads": -1, "filename": "snowpyt-0.1.65.tar.gz", "has_sig": false, "md5_digest": "3e72e0bed0e5ef35e73dfeea99c75474", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 233759, "upload_time": "2017-11-08T16:50:06", "url": "https://files.pythonhosted.org/packages/6e/82/8592aae0a46fe33f3402baca915ed00cbf3c026a08561c05c08316491ef3/snowpyt-0.1.65.tar.gz" } ], "0.1.66": [ { "comment_text": "", "digests": { "md5": "5dc96c79f0c74daeef7e641e2275ac2c", "sha256": "61e2e6475f6a845a424c7cdf3cf2eb436a82879c7a2fdfb427dd1b86c4308903" }, "downloads": -1, "filename": "snowpyt-0.1.66.tar.gz", "has_sig": false, "md5_digest": "5dc96c79f0c74daeef7e641e2275ac2c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 233927, "upload_time": "2017-11-08T17:30:32", "url": "https://files.pythonhosted.org/packages/77/50/2d78c161eb57201d2d35d2292f30dea1f3b1135dc84167277ca77939953d/snowpyt-0.1.66.tar.gz" } ], "0.1.67": [ { "comment_text": "", "digests": { "md5": "93cd09845198dc6916a3ff4510e02666", "sha256": "fe8b7e0fea73f83c43e2f22d7d324c7cd697543ddbb6184c52c09c0deeba6a05" }, "downloads": -1, "filename": "snowpyt-0.1.67.tar.gz", "has_sig": false, "md5_digest": "93cd09845198dc6916a3ff4510e02666", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 234151, "upload_time": "2018-01-19T08:04:35", "url": "https://files.pythonhosted.org/packages/64/45/e674a365598ca39fabb7bd14b6d3b71b36d561889c79e4fe397804143c0a/snowpyt-0.1.67.tar.gz" } ], "0.1.70": [ { "comment_text": "", "digests": { "md5": "22db70e11b043cdedc0b4d182bf95384", "sha256": "3057c9f18d62c947e284e544b175d2e832f8b41fa1ee1db950fdced1499df3b4" }, "downloads": -1, "filename": "snowpyt-0.1.70.tar.gz", "has_sig": false, "md5_digest": "22db70e11b043cdedc0b4d182bf95384", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 235927, "upload_time": "2018-03-14T19:12:10", "url": "https://files.pythonhosted.org/packages/6d/22/d38972027329956933e4bbd20f8a5ffad1af31920301f2446dbc31d3fad5/snowpyt-0.1.70.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "bfbc40ebfff5ad900ca487c86293a940", "sha256": "f30b335227c5b0290702c7548fdd3dc840ffcd584e72e8d5a1e03c2826edfb4b" }, "downloads": -1, "filename": "snowpyt-0.2.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "bfbc40ebfff5ad900ca487c86293a940", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=3.6.0", "size": 220562, "upload_time": "2019-08-01T08:12:42", "url": "https://files.pythonhosted.org/packages/67/59/a8f528e3cb09173d28fe9acf935c0d9a8f524b2af476c538a36f91437aca/snowpyt-0.2.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1c357dc0be5d705870300151d31757d7", "sha256": "7f8b249c047328e38be9f1aec58bdfbad5f813fa919b36d30e98af0732bb63e1" }, "downloads": -1, "filename": "snowpyt-0.2.1.tar.gz", "has_sig": false, "md5_digest": "1c357dc0be5d705870300151d31757d7", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 219876, "upload_time": "2019-08-01T08:12:45", "url": "https://files.pythonhosted.org/packages/d6/76/0c06d75f956719d6bcab08799b8c12de63c239888b5163b24ccbd7c9da25/snowpyt-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "58895875213eeb4ad220f05d27643de2", "sha256": "4e2eeed81565209d68ea303cf4722bef4fd6c09c36a8596648a84531a11cd599" }, "downloads": -1, "filename": "snowpyt-0.2.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "58895875213eeb4ad220f05d27643de2", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=3.6.0", "size": 220352, "upload_time": "2019-08-01T09:49:14", "url": "https://files.pythonhosted.org/packages/7a/f1/b080d2a99b265a7f0cfb032874fd5a72b1c11d75a5a14d7f181ea5f2a721/snowpyt-0.2.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9dd1211845436ac61bdb5ee99c17bfc6", "sha256": "d45bb5e8e2fd1ad8f02f42306b4069698bda7640f7ef01096bd1dfd2a4b0af2f" }, "downloads": -1, "filename": "snowpyt-0.2.2.tar.gz", "has_sig": false, "md5_digest": "9dd1211845436ac61bdb5ee99c17bfc6", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 219715, "upload_time": "2019-08-01T09:49:16", "url": "https://files.pythonhosted.org/packages/b7/25/144719ea21223461094416a3ffda805db708f5d8b4802b8b1a74952d605e/snowpyt-0.2.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "58895875213eeb4ad220f05d27643de2", "sha256": "4e2eeed81565209d68ea303cf4722bef4fd6c09c36a8596648a84531a11cd599" }, "downloads": -1, "filename": "snowpyt-0.2.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "58895875213eeb4ad220f05d27643de2", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=3.6.0", "size": 220352, "upload_time": "2019-08-01T09:49:14", "url": "https://files.pythonhosted.org/packages/7a/f1/b080d2a99b265a7f0cfb032874fd5a72b1c11d75a5a14d7f181ea5f2a721/snowpyt-0.2.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9dd1211845436ac61bdb5ee99c17bfc6", "sha256": "d45bb5e8e2fd1ad8f02f42306b4069698bda7640f7ef01096bd1dfd2a4b0af2f" }, "downloads": -1, "filename": "snowpyt-0.2.2.tar.gz", "has_sig": false, "md5_digest": "9dd1211845436ac61bdb5ee99c17bfc6", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 219715, "upload_time": "2019-08-01T09:49:16", "url": "https://files.pythonhosted.org/packages/b7/25/144719ea21223461094416a3ffda805db708f5d8b4802b8b1a74952d605e/snowpyt-0.2.2.tar.gz" } ] }