Tutorials

If you are new to penguins, then this is the place to start: each tutorial covers a bite-sized piece, and can be read in sequence.

To follow along with the tutorials, you will need one 1D and one 2D dataset which have already been processed in TopSpin (note that penguins only works with Bruker data). If you don’t have some data on hand, you can click here to download some sample data. Unzip that directory, then open a terminal and cd into that directory.

• Tutorial 1: Reading data
  • Importing spectra: pg.read()
  • Accessing spectrum parameters
• Tutorial 2: Plotting data
  • The three stages of plotting
  • A minimal 1D example
  • A minimal 2D example
  • Axis labels and titles
• Tutorial 3: Customising 1D plots
  • Bounds
  • Colours and other aesthetics
• Tutorial 4: Plotting multiple 1Ds
  • Staging multiple spectra
  • Adding a legend
  • Horizontal and vertical offsets
  • voffset and stacked
• Tutorial 5: Customising 2D plots
  • Contour levels and colours
  • Bounds
• Tutorial 6: Subplots
  • Getting to know subplots2d()
  • The ax keyword argument
  • For loops and zip()
  • Labelling axes
• Tutorial 7: Using matplotlib
  • Accessing Figures and Axes

Intermediate tutorials (to be written):

• Interfacing with matplotlib

• Processing datasets (TODO) (projections, sums, magnitude mode, integration)