Merge pull request #8 from pp-mo/better_env

Better env

Author: pp-mo

README.md

@@ -15,6 +15,32 @@ So, we also provide a "lockfile" which ties down all package versions, from whic
 known-good environment can be recreated :  
 e.g. `$ conda create --name meshtut_savefixed_env --file tutorial_conda_env_resolved.lock` 
 
+> :warning: **Important Note**  
+> For now, the latest GeoVista build in channels is not sufficient.  
+> You must also download geovista + install it, e.g. by `pip install -e .`
+### Installing Geovista :  more-or-less detailed instructions
+You need to execute commands something like this ...
+
+```bash
+$ # download
+$ cd ~/git
+$ git clone https://github.com/bjlittle/geovista.git
+$
+$ # install in the env
+$ conda activate mesh-tutorial
+$ cd ~/git/geovista
+$ pip install -e .
+  ... (lots of output) ...
+$ 
+$ # TEST that the import now works ...
+$ python -c "import geovista as gv; print(gv); print(gv.__version__)"
+<module 'geovista' from '/net/home/h05/itpp/git/geovista/src/geovista/__init__.py'>
+0.1a1.dev508
+
+$ 
+```
+
+
 ## Start the tutorial
 E.G.  
 ```
@@ -38,4 +64,26 @@ $ jupyter lab
          or http://127.0.0.1:8888/lab?token=c4ece2e59cd8c81779de0f394c421e22f258f50466cc027e
 ```
 A window should then appear in your browser.  
-Failing that, visit one of the urls displayed in the terminal output.
+Failing that, visit one of the urls displayed in the terminal output.
+
+
+## Developer notes: to build the lockfile
+The lockfile "tutorial_conda_env_resolved.lockfile" is produced from an actual environment.
+First build the env from the spec file "tutorial_conda_env.yml" ...
+
+First using a conda env with "mamba" in it : resolve the env + snapshot the package list.
+
+```bash
+$ conda activate mamba-env
+$ mamba create -n mesh-tutorial --file tutorial_conda_env.yml
+$ conda list -n mesh-tutorial --explicit >temp_condalist_explicit.txt
+```
+
+Then using a conda env with 'ssstack' in it (https://github.com/MetOffice/ssstack) : generate new 'shareable'-form lockfile.
+
+```bash
+$ conda activate ssstack-env
+$ ssstack shareable temp_condalist_explicit.txt >tutorial_conda_env_resolved.lockfile
+$ rm temp_condalist_explicit.txt
+```
+      

TEMP_notes_on_env_dev.txt

@@ -273,3 +273,54 @@ Latest overall plan :
         - and regrid
 
 
+======================
+Thurs 19th : problems with plotting stability
+(1) derived "notebooks/Sec_02_Meshes.py" from the notebook
+  - and tweaked with 
+
+INVESTIGATE...
+= testing with above Python
+= tweaking the "tutorial_conda_env.yml" + building test envs
+
+    bill's
+      pyvista = 0.36.1
+      vtk = 9.2.2
+
+    cf problem-env (existing mesh-tutorial) :
+        $ conda list | grep -i "\(vtk\|vista\)"
+        geovista                  0.1.dev1           pyhd8ed1ab_0    https://conda.anaconda.org/conda-forge
+        ipyvtklink                0.2.3              pyhd8ed1ab_0    https://conda.anaconda.org/conda-forge
+        pyvista                   0.37.0             pyhd8ed1ab_0    https://conda.anaconda.org/conda-forge
+        pyvistaqt                 0.9.0              pyhd8ed1ab_0    https://conda.anaconda.org/conda-forge
+        vtk                       9.2.5           qt_py39h1a3df09_201    https://conda.anaconda.org/conda-forge
+
+    w pyvista=0.36 ((did not fully work : window does not close, still dumps))
+        $ conda list -n meshtut_pv36 | grep -i "\(vtk\|vista\)"
+        geovista                  0.1.dev1           pyhd8ed1ab_0    conda-forge
+        ipyvtklink                0.2.3              pyhd8ed1ab_0    conda-forge
+        pyvista                   0.36.1             pyhd8ed1ab_0    conda-forge
+        pyvistaqt                 0.9.0              pyhd8ed1ab_0    conda-forge
+        vtk                       9.2.5           qt_py39h99e95b5_202    conda-forge
+
+    w vtk=9.2.2
+    LOOKS GOOD !
+        $ conda list -n meshtut_vtk9x2x2 | grep -i "\(vtk\|vista\)"
+        # packages in environment at /tmp/persistent/newconda-envs/meshtut_vtk9x2x2:
+        geovista                  0.1.dev1           pyhd8ed1ab_0    conda-forge
+        ipyvtklink                0.2.3              pyhd8ed1ab_0    conda-forge
+        pyvista                   0.37.0             pyhd8ed1ab_0    conda-forge
+        pyvistaqt                 0.9.0              pyhd8ed1ab_0    conda-forge
+        vtk                       9.2.2           qt_py39hc075ee6_205    conda-forge
+
+    updated with that, and added i-e-r
+        $ conda list -n  mesh-tutorial-revised | grep -i "\(vtk\|vista\)"
+        geovista                  0.1.dev1           pyhd8ed1ab_0    conda-forge
+        ipyvtklink                0.2.3              pyhd8ed1ab_0    conda-forge
+        pyvista                   0.37.0             pyhd8ed1ab_0    conda-forge
+        pyvistaqt                 0.9.0              pyhd8ed1ab_0    conda-forge
+        vtk                       9.2.2           qt_py39hc075ee6_205    conda-forge
+
+Now updated :
+  * tutorial_conda_env.yml 
+  * tutorial_conda_env_resolved.lockfile
+  * README

tutorial_conda_env.yml

@@ -5,9 +5,10 @@ dependencies:
   - python=3.9
   - iris
   - geovista
+  - vtk=9.2.2  # experiencing segfaults with latest version
   - jupyterlab
   - ipyvtklink
-  - jupytext
+  - jupytext=1.14.4  # changing version can cause notebook merge conflicts
   - pre-commit
-  - ugrid-checks
-
+  - iris-esmf-regrid
+  - esmpy=8.3  # iris-esmf-regrid doesn't work with latest, for some reason