https://github.com/hyperspy/holospy-demos

HoloSpy Jupyter Notebook demos
https://github.com/hyperspy/holospy-demos

data-analysis data-visualization electron-holography hyperspy materials-science multi-dimensional physical-sciences tutorial

Last synced: 3 days ago
JSON representation

HoloSpy Jupyter Notebook demos

• Host: GitHub
• URL: https://github.com/hyperspy/holospy-demos
• Owner: hyperspy
• Created: 2023-08-30T08:32:47.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-08-30T08:34:06.000Z (over 1 year ago)
• Last Synced: 2024-11-18T22:02:22.664Z (2 months ago)
• Topics: data-analysis, data-visualization, electron-holography, hyperspy, materials-science, multi-dimensional, physical-sciences, tutorial
• Language: Jupyter Notebook
• Homepage: https://hyperspy.org/holospy
• Size: 9.7 MB
• Stars: 2
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Holospy demos

[![Live demos (Binder)](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/hyperspy/holospy-demos/main)

[![Notebook Viewer (nbviewer)](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg?sanitize=true)](https://nbviewer.ipython.org/github/hyperspy/holospy-demos/tree/main/)

[![Documentation Status](https://readthedocs.org/projects/holospy/badge/?version=stable)](https://holospy.readthedocs.io/en/stable/?badge=stable)

## Introduction

This repository contains [Jupyter Notebooks](https://jupyter.org/) to demo and learn

how to process electron holography data with [Holospy](https://holospy.readthedocs.io). For

learning purposes, we recommend to use them alongside the 

[HoloSpy User Guide](https://holospy.readthedocs.io).

The root folder contains notebooks concerning general HyperSpy features while

the subfolders contain notebooks for specific signals and other more specialized

analyses.

## Visualising and running the demos.

### (Interactive) Running the demos online

[![Live demos (Binder)](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/hyperspy/holospy-demos/main)

Follow [this link](https://mybinder.org/v2/gh/hyperspy/holospy-demos/main)

or click the "launch binder" banner above to run the the demos on 

[mybinder.org](https://mybinder.org/). The demos will run remotely, 

and one can experiment with HyperSpy in a Jupyter notebook with no need 

to install or configure any software locally.

**Note:** depending on the remote server load, the interactive binder demo may 

take up to several minutes to load. For a quicker (but non-interactive) 

visualization, see below.

### (Non-interactive) Visualizing the demos online

[![Notebook Viewer (nbviewer)](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg?sanitize=true)](http://nbviewer.ipython.org/github/hyperspy/holospy-demos/tree/main/)

Follow [this link](http://nbviewer.ipython.org/github/hyperspy/holospy-demos/tree/main/) 

or click on the "render nbviewer" banner above

to display the demos with the 

[Jupyter Notebook viewer](http://nbviewer.jupyter.org). 

[nbviewer](http://nbviewer.jupyter.org/) will allow you to view the notebooks online,

but you will not be able to change them or evaluate any code, like is possible with the 

[binder](https://mybinder.org/v2/gh/hyperspy/holospy-demos/main).

### Running and visualizing the demos locally

To run the demo notebooks locally, 

clone or download the [demos repository](https://github.com/hyperspy/holospy-demos) 

to your local

machine, install HyperSpy and

[Jupyter Lab](http://jupyterlab.readthedocs.io/en/latest/) or 

[Jupyter Notebook](https://jupyter-notebook.readthedocs.io/en/stable/)

and use either of Jupyter tools to run the notebooks.

#### (For developers) Testing the demos locally

To test the demos, install

[nbval](http://github.com/computationalmodelling/nbval) and

[py.test](https://pytest.org/) and run

```bash

$ py.test

```

To help visualize differences/errors, install

[nbdime](http://github.com/jupyter/nbdime) as well, and run the test with

```bash

$ py.test --nbdime

```

## Contributing

To contribute new demos or improvements to the current ones fork the demos

repository and send us a pull request. See the 

[HyperSpy Developer Guide](http://hyperspy.org/hyperspy-doc/current/dev_guide.html) 

for more details on how to contribute to HyperSpy.

For issues and discussions fill a new

issue in [the demos github repository](https://github.com/hyperspy/holospy-demos)

or discuss it in [HyperSpy's gitter chat](https://gitter.im/hyperspy/hyperspy).