cf-plot 3.3.0__tar.gz → 3.4.0__tar.gz

{cf-plot-3.3.0 → cf_plot-3.4.0}/LICENSE.txt

@@ -1,6 +1,4 @@
-
-
-Copyright (c) <2016> <Andy Heaps NCAS>
+Copyright (c) 2025 National Centre for Atmospheric Science (NCAS)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

{cf-plot-3.3.0 → cf_plot-3.4.0}/MANIFEST.in

@@ -2,5 +2,6 @@ include MANIFEST.in
 include Changelog.md
 include README.md
 recursive-include cfplot *
+prune cfplot/test/cfplot_data
 recursive-exclude * *~ *.gz *.pyc
 

cf_plot-3.4.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.1
+Name: cf-plot
+Version: 3.4.0
+Summary: Climate contour, vector and line plots in Python
+Home-page: http://ajheaps.github.io/cf-plot
+Author: Andy Heaps and Sadie Bartholomew
+Author-email: andy.heaps@ncas.ac.uk
+Maintainer: Sadie Bartholomew
+Maintainer-email: sadie.bartholomew@ncas.ac.uk
+License: LICENSE.txt
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: cf-python>=3.17.0
+Requires-Dist: cartopy>=0.22.0
+
+# cf-plot
+
+## Code-light plotting for earth science and aligned research
+
+### Overview
+
+![cf-plot example gallery of plots](docs/source/images/new_gallery_view.png "Examples Gallery of plots made with the cf-plot library")
+
+**cf-plot allows you to produce and customise publication-quality contour,
+vector, line and more plots with the power of Python,
+[matplotlib](https://matplotlib.org/),
+[Cartopy](https://scitools.org.uk/cartopy/docs/latest/) and
+[cf-python](https://ncas-cms.github.io/cf-python/), in as few lines of code
+as possible.**
+
+It is designed to be a useful visualisation tool for environmental, earth
+and aligned sciences, for example to facilitate climate and meteorological
+research. cf-plot is developed and maintained by the
+[NCAS-CMS](https://cms.ncas.ac.uk/index.html) group, part of
+[NCAS](https://ncas.ac.uk/).
+
+
+### Brief Demonstration
+
+In as little as four lines of Python including imports and file reading,
+using `cf-plot` you can for example produce a contour plot showing a 2D
+subspace of a netCDF dataset:
+
+```python
+import cf
+import cfplot as cfp
+f = cf.read('<dataset name>.nc')[0]  # picks out a read-in field of the dataset
+cfp.con(f.subspace(time=<chosen time value>))  # creates a contour plot of the field at that time value
+```
+
+
+### Examples Gallery
+
+A gallery of outputs made with cf-plot, showcasing a range of plotting
+possibilities with links to relevant documentation pages and to example code,
+can be found
+[on this dedicated page within the documentation](https://ncas-cms.github.io/cf-plot/gallery_of_examples.html),
+as illustrated in the (static) image at the top of this document.
+
+
+### Documentation
+
+See [the cf-plot homepage](https://ncas-cms.github.io/cf-plot/)
+(`https://ncas-cms.github.io/cf-plot`) for the full online documentation.
+
+
+### Installation
+
+To install cf-plot with its required dependencies, you can use `pip`:
+
+```bash
+pip install cf-python cf-plot
+```
+
+or you can use `conda` (or similar package managers such
+as `mamba`) as follows (or equivalent):
+
+```bash
+conda install -c ncas -c conda-forge cf-python cf-plot udunits2
+```
+
+More detail about installation is provided on the
+[installation page](https://ncas-cms.github.io/cf-plot/installation.html)
+(`https://ncas-cms.github.io/cf-plot/installation.html`)
+of the documentation.
+
+### Contributing
+
+Everyone is welcome to contribute to cf-plot in the form
+of bug reports, documentation, code, design proposals, and more.
+
+Contributing guidelines will be added to the repository shortly.
+
+
+### Help: Issues, Questions, Feature Requests, etc.
+
+For any queries, see the
+[guidance page](https://ncas-cms.github.io/cf-plot/support.html)
+(`https://ncas-cms.github.io/cf-plot/support.html`).

cf_plot-3.4.0/README.md

@@ -0,0 +1,84 @@
+# cf-plot
+
+## Code-light plotting for earth science and aligned research
+
+### Overview
+
+![cf-plot example gallery of plots](docs/source/images/new_gallery_view.png "Examples Gallery of plots made with the cf-plot library")
+
+**cf-plot allows you to produce and customise publication-quality contour,
+vector, line and more plots with the power of Python,
+[matplotlib](https://matplotlib.org/),
+[Cartopy](https://scitools.org.uk/cartopy/docs/latest/) and
+[cf-python](https://ncas-cms.github.io/cf-python/), in as few lines of code
+as possible.**
+
+It is designed to be a useful visualisation tool for environmental, earth
+and aligned sciences, for example to facilitate climate and meteorological
+research. cf-plot is developed and maintained by the
+[NCAS-CMS](https://cms.ncas.ac.uk/index.html) group, part of
+[NCAS](https://ncas.ac.uk/).
+
+
+### Brief Demonstration
+
+In as little as four lines of Python including imports and file reading,
+using `cf-plot` you can for example produce a contour plot showing a 2D
+subspace of a netCDF dataset:
+
+```python
+import cf
+import cfplot as cfp
+f = cf.read('<dataset name>.nc')[0]  # picks out a read-in field of the dataset
+cfp.con(f.subspace(time=<chosen time value>))  # creates a contour plot of the field at that time value
+```
+
+
+### Examples Gallery
+
+A gallery of outputs made with cf-plot, showcasing a range of plotting
+possibilities with links to relevant documentation pages and to example code,
+can be found
+[on this dedicated page within the documentation](https://ncas-cms.github.io/cf-plot/gallery_of_examples.html),
+as illustrated in the (static) image at the top of this document.
+
+
+### Documentation
+
+See [the cf-plot homepage](https://ncas-cms.github.io/cf-plot/)
+(`https://ncas-cms.github.io/cf-plot`) for the full online documentation.
+
+
+### Installation
+
+To install cf-plot with its required dependencies, you can use `pip`:
+
+```bash
+pip install cf-python cf-plot
+```
+
+or you can use `conda` (or similar package managers such
+as `mamba`) as follows (or equivalent):
+
+```bash
+conda install -c ncas -c conda-forge cf-python cf-plot udunits2
+```
+
+More detail about installation is provided on the
+[installation page](https://ncas-cms.github.io/cf-plot/installation.html)
+(`https://ncas-cms.github.io/cf-plot/installation.html`)
+of the documentation.
+
+### Contributing
+
+Everyone is welcome to contribute to cf-plot in the form
+of bug reports, documentation, code, design proposals, and more.
+
+Contributing guidelines will be added to the repository shortly.
+
+
+### Help: Issues, Questions, Feature Requests, etc.
+
+For any queries, see the
+[guidance page](https://ncas-cms.github.io/cf-plot/support.html)
+(`https://ncas-cms.github.io/cf-plot/support.html`).

cf_plot-3.4.0/cf_plot.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.1
+Name: cf-plot
+Version: 3.4.0
+Summary: Climate contour, vector and line plots in Python
+Home-page: http://ajheaps.github.io/cf-plot
+Author: Andy Heaps and Sadie Bartholomew
+Author-email: andy.heaps@ncas.ac.uk
+Maintainer: Sadie Bartholomew
+Maintainer-email: sadie.bartholomew@ncas.ac.uk
+License: LICENSE.txt
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: cf-python>=3.17.0
+Requires-Dist: cartopy>=0.22.0
+
+# cf-plot
+
+## Code-light plotting for earth science and aligned research
+
+### Overview
+
+![cf-plot example gallery of plots](docs/source/images/new_gallery_view.png "Examples Gallery of plots made with the cf-plot library")
+
+**cf-plot allows you to produce and customise publication-quality contour,
+vector, line and more plots with the power of Python,
+[matplotlib](https://matplotlib.org/),
+[Cartopy](https://scitools.org.uk/cartopy/docs/latest/) and
+[cf-python](https://ncas-cms.github.io/cf-python/), in as few lines of code
+as possible.**
+
+It is designed to be a useful visualisation tool for environmental, earth
+and aligned sciences, for example to facilitate climate and meteorological
+research. cf-plot is developed and maintained by the
+[NCAS-CMS](https://cms.ncas.ac.uk/index.html) group, part of
+[NCAS](https://ncas.ac.uk/).
+
+
+### Brief Demonstration
+
+In as little as four lines of Python including imports and file reading,
+using `cf-plot` you can for example produce a contour plot showing a 2D
+subspace of a netCDF dataset:
+
+```python
+import cf
+import cfplot as cfp
+f = cf.read('<dataset name>.nc')[0]  # picks out a read-in field of the dataset
+cfp.con(f.subspace(time=<chosen time value>))  # creates a contour plot of the field at that time value
+```
+
+
+### Examples Gallery
+
+A gallery of outputs made with cf-plot, showcasing a range of plotting
+possibilities with links to relevant documentation pages and to example code,
+can be found
+[on this dedicated page within the documentation](https://ncas-cms.github.io/cf-plot/gallery_of_examples.html),
+as illustrated in the (static) image at the top of this document.
+
+
+### Documentation
+
+See [the cf-plot homepage](https://ncas-cms.github.io/cf-plot/)
+(`https://ncas-cms.github.io/cf-plot`) for the full online documentation.
+
+
+### Installation
+
+To install cf-plot with its required dependencies, you can use `pip`:
+
+```bash
+pip install cf-python cf-plot
+```
+
+or you can use `conda` (or similar package managers such
+as `mamba`) as follows (or equivalent):
+
+```bash
+conda install -c ncas -c conda-forge cf-python cf-plot udunits2
+```
+
+More detail about installation is provided on the
+[installation page](https://ncas-cms.github.io/cf-plot/installation.html)
+(`https://ncas-cms.github.io/cf-plot/installation.html`)
+of the documentation.
+
+### Contributing
+
+Everyone is welcome to contribute to cf-plot in the form
+of bug reports, documentation, code, design proposals, and more.
+
+Contributing guidelines will be added to the repository shortly.
+
+
+### Help: Issues, Questions, Feature Requests, etc.
+
+For any queries, see the
+[guidance page](https://ncas-cms.github.io/cf-plot/support.html)
+(`https://ncas-cms.github.io/cf-plot/support.html`).