Getting started

Binder examples

You can run a demo of psy-view in your webbrowser by clicking mybinder-demo. This will show you a remote desktop (after some time for launching the server) where you can test psy-view (and the psyplot-gui) for different test files.

Uploading your own data

You can also upload your own data to visualize it on the binder instance. Once you see the remote desktop, your URL will be something like https://hub.gke2.mybinder.org/user/psyplot-psy-view-.../desktop/?token=....

  1. open a new tab

  2. take the URL from the previous tab and replace the last part from the url (desktop/?token=...) with tree/Desktop).

  3. Now click the Upload button and select the file you want to upload

  4. Upload the file

  5. The file you uploaded will now appear on the desktop in the previous tab

Run it locally

Congratulations! You successfully installed psy-view on your system (if not, head over to Installation).

This small example shows you, how to make a simple georeferenced plot. You can use the demo.nc file for this demo.

Start the GUI from the command line via:

psy-view demo.nc

A widget will open that looks like

_images/docs-getting-started-ds_widget.png

You see a button for the t2m variable: t2m. Click it, and it opens a plot like this:

_images/docs-getting-started-example.png

Now use the btn_cmap button to select a different colormap, edit the projection via the btn_proj button, or update the dimensions via the navigation buttons: btn_prev, btn_next, btn_animate_backward and btn_animate_forward.

More documentation about the GUI elements is provided in our User guide. And if you are interested in the python code, checkout the API reference.