Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Various README suggestions #826

Merged
merged 8 commits into from
Jun 14, 2024
Merged

Various README suggestions #826

Changes from 3 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
72e88ec
README suggestions.
trexfeathers Jun 12, 2024
e84f52c
README refactor pantry.
trexfeathers Jun 12, 2024
b5828d6
More README suggestions.
trexfeathers Jun 12, 2024
7f23fa2
Revert "README refactor pantry."
trexfeathers Jun 14, 2024
c250390
Restore click for code hint.
trexfeathers Jun 14, 2024
1abe1eb
Better shop window.
trexfeathers Jun 14, 2024
6fcfed9
Even better shop window.
trexfeathers Jun 14, 2024
9d551ff
Even better shop window.
trexfeathers Jun 14, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
70 changes: 36 additions & 34 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,11 @@
| 🛡️ Status | [![scitools](https://img.shields.io/badge/scitools-ownership%20pending-yellow)](https://github.com/bjlittle/geovista/issues/167) |
| | |

<p align="center">
<img src="https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/ww3-tri.png" height="250">
<br>
<a href="#wavewatch-iii"><b>Less than 20 lines of Python!</b></a>
</p>
bjlittle marked this conversation as resolved.
Show resolved Hide resolved

## Motivation

Expand All @@ -40,22 +45,19 @@ et al, which specialise in preparing your spatial data for visualisation. Rather
choice of tool to you the user, as we want GeoVista to remain as flexible and open-ended as possible to the entire
Scientific Python community.

Simply put, "*GeoVista is to PyVista*", as "*Cartopy is to Matplotlib*". Well, that's the aspiration.
Simply put, "*GeoVista is to PyVista*", as "*[Cartopy](https://scitools.org.uk/cartopy/docs/latest/) is to
bjlittle marked this conversation as resolved.
Show resolved Hide resolved
[Matplotlib](https://matplotlib.org/stable/index.html)*". Well, that's the aspiration.

## Installation

GeoVista is available on both [conda-forge](https://anaconda.org/conda-forge/geovista) and [PyPI](https://pypi.org/project/geovista/).

We recommend using [mamba](https://github.com/mamba-org/mamba) to install GeoVista 👍
We recommend using [conda](https://docs.conda.io/projects/conda/en/latest/index.html) to install GeoVista 👍

### Mamba
### Conda

GeoVista is available on [conda-forge](https://anaconda.org/conda-forge/geovista), and can be easily installed with
[mamba](https://github.com/mamba-org/mamba):
```shell
mamba install -c conda-forge geovista
```
or alternatively with [conda](https://docs.conda.io/projects/conda/en/latest/index.html):
[conda](https://docs.conda.io/projects/conda/en/latest/index.html):
bjlittle marked this conversation as resolved.
Show resolved Hide resolved
```shell
conda install -c conda-forge geovista
```
Expand Down Expand Up @@ -90,7 +92,7 @@ cd geovista
```
Create the `geovista-dev` conda development environment:
```shell
mamba env create --file requirements/geovista.yml
conda env create --file requirements/geovista.yml
```
Now activate the environment and install the `main` development branch of GeoVista:
```shell
Expand Down Expand Up @@ -142,11 +144,11 @@ base layer, and the gorgeous perceptually uniform [cmocean balance](https://matp
colormap.

<details>
<summary>🗒 </summary>
<summary>🗒 click for code</summary>
bjlittle marked this conversation as resolved.
Show resolved Hide resolved

```python
import geovista as gv
from geovista.pantry import ww3_global_tri
from geovista.pantry.data import ww3_global_tri
bjlittle marked this conversation as resolved.
Show resolved Hide resolved
import geovista.theme

# Load the sample data.
Expand All @@ -170,21 +172,21 @@ plotter.show()
```
</details>

![ww3-tri](https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/ww3-tri.png)
<p align="center"><img src="https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/ww3-tri.png" height="400"></p>

#### Finite Volume Community Ocean Model

Now, let's visualise the bathymetry of the
[Plymouth Sound and Tamar River](https://www.google.com/maps/place/Plymouth+Sound/@50.3337382,-4.2215988,12z/data=!4m5!3m4!1s0x486c93516bbce307:0xded7654eaf4f8f83!8m2!3d50.3638359!4d-4.1441365)
from an [FVCOM](http://fvcom.smast.umassd.edu/fvcom/) **unstructured** mesh, as kindly provided by the
from an [FVCOM](https://www.fvcom.org/) **unstructured** mesh, as kindly provided by the
[Plymouth Marine Laboratory](https://pml.ac.uk/) using the lush [cmocean deep](https://matplotlib.org/cmocean/#deep) colormap.

<details>
<summary>🗒 </summary>
<summary>🗒 click for code</summary>

```python
import geovista as gv
from geovista.pantry import fvcom_tamar
from geovista.pantry.data import fvcom_tamar
import geovista.theme

# Load the sample data.
Expand Down Expand Up @@ -213,7 +215,7 @@ plotter.show()
```
</details>

![tamar](https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/tamar.png)
<p align="center"><img src="https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/tamar.png" height="400"></p>

#### CF UGRID

Expand All @@ -231,11 +233,11 @@ In the meantime, let's showcase our basic projection support with some high-reso
base layer.

<details>
<summary>🗒 </summary>
<summary>🗒 click for code</summary>

```python
import geovista as gv
from geovista.pantry import lam_pacific
from geovista.pantry.data import lam_pacific
import geovista.theme

# Load the sample data.
Expand All @@ -262,7 +264,7 @@ plotter.show()
```
</details>

![lam-mollweide](https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/lam-moll.png)
<p align="center"><img src="https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/lam-moll.png" height="400"></p>

Using the same **unstructured** LAM data, reproject to
[Equidistant Cylindrical](https://proj.org/operations/projections/eqc.html) but this time using a
Expand All @@ -273,13 +275,13 @@ and a
base layer.

<details>
<summary>🗒 </summary>
<summary>🗒 click for code</summary>

```python
import cartopy.crs as ccrs

import geovista as gv
from geovista.pantry import lam_pacific
from geovista.pantry.data import lam_pacific
import geovista.theme

# Load the sample data.
Expand All @@ -306,7 +308,7 @@ plotter.show()
```
</details>

![lam-mollweide](https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/lam-eqc.png)
<p align="center"><img src="https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/lam-eqc.png" height="400"></p>

#### LFRic Cube-Sphere

Expand All @@ -317,11 +319,11 @@ Now render a [Met Office LFRic](https://www.metoffice.gov.uk/research/approach/m
[cmocean thermal](https://matplotlib.org/cmocean/#thermal) colormap.

<details>
<summary>🗒 </summary>
<summary>🗒 click for code</summary>

```python
import geovista as gv
from geovista.pantry import lfric_sst
from geovista.pantry.data import lfric_sst
import geovista.theme

# Load the sample data.
Expand All @@ -346,7 +348,7 @@ plotter.show()
```
</details>

![lam-mollweide](https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/lfric-robin.png)
<p align="center"><img src="https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/lfric-robin.png" height="400"></p>

#### UM ORCA2

Expand All @@ -356,11 +358,11 @@ using Met Office Unified Model (UM) ORCA2 Sea Water Potential Temperature data,
[1:50m Natural Earth I](https://www.naturalearthdata.com/downloads/50m-raster-data/50m-natural-earth-1/) base layer.

<details>
<summary>🗒 </summary>
<summary>🗒 click for code</summary>

```python
import geovista as gv
from geovista.pantry import um_orca2
from geovista.pantry.data import um_orca2
import geovista.theme

# Load sample data.
Expand All @@ -384,7 +386,7 @@ plotter.show()
```
</details>

![um-orca](https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/um-orca.png)
<p align="center"><img src="https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/um-orca.png" height="400"></p>

#### OISST AVHRR

Expand All @@ -394,11 +396,11 @@ Now let's render a [NOAA/NCEI Optimum Interpolation SST](https://www.ncei.noaa.g
[NASA Blue Marble](https://visibleearth.nasa.gov/collection/1484/blue-marble) base layer.

<details>
<summary>🗒 </summary>
<summary>🗒 click for code</summary>

```python
import geovista as gv
from geovista.pantry import oisst_avhrr_sst
from geovista.pantry.data import oisst_avhrr_sst
import geovista.theme

# Load sample data.
Expand All @@ -422,7 +424,7 @@ plotter.show()
```
</details>

![oisst-avhrr](https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/oisst-avhrr.png)
<p align="center"><img src="https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/oisst-avhrr.png" height="400"></p>

#### DYNAMICO

Expand All @@ -434,11 +436,11 @@ model uses hexagonal and pentagonal cells, and is a new dynamical core for
[10m Natural Earth coastlines](https://www.naturalearthdata.com/downloads/10m-physical-vectors/10m-coastline/).

<details>
<summary>🗒 </summary>
<summary>🗒 click for code</summary>

```python
import geovista as gv
from geovista.pantry import dynamico
from geovista.pantry.data import dynamico
import geovista.theme

# Load sample data.
Expand All @@ -457,7 +459,7 @@ plotter.show()
```
</details>

![dynamico-icosahedral](https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/dynamico-icosahedral.png)
<p align="center"><img src="https://raw.githubusercontent.com/bjlittle/geovista-media/2023.09.1/media/readme/dynamico-icosahedral.png" height="400"></p>

## Unreal Reels

Expand Down
Loading