Skip to content

Visualizes data acquired with the matlab-qd framework

License

Notifications You must be signed in to change notification settings

mchels/FolderBrowser

Repository files navigation

FolderBrowser

Description

This project provides a GUI for visualizing data acquired with the matlab-qd framework by Anders Jellinggaard. The gui itself is a Python implementation and expansion of the gui from matlab-qd.

Features

Explore data with standard Matplotlib controls: Use standard Matplotlib controls

or with custom controls for, e.g., colormap, limits, aspect ratio: Explore data with custom controls

Copy-paste the active figure with Ctrl-C: Copy a figure with Ctrl-C

Generate code for figure with F2: Generate code for figure

Modify figure with Matplotlib commands (note that these modifications are captured by Ctrl-C, but not by F2): Modify figure with Matplotlib commands

Resize and dock to your heart's content: Resize and dock

Installation

All packages used for FolderBrowser are included in the Anaconda distribution. Get it from https://www.continuum.io/downloads with the newest Python 3 version.

If you already have Anaconda installed (with Python 3.5) but the packages are not up to date, simply run

conda update anaconda

from the terminal to update the packages.

When you have all packages installed run example.py in the examples directory.

Requirements

  • Python 3+ (tested with version 3.5)
  • Matplotlib (tested with version 1.5.3, 2.0)
  • PyQt 5 (tested with version 5.6)
  • Numpy (tested with version 1.11)

Optional packages

  • Pandas (improves loading times by a factor 2-10x, tested with version 0.18.1)

Documentation

Hotkeys

Key Function
F2 Copy code for figure to clipboard
F5 Reload file list
F6 Reload pseodocolumn file
Ctrl-c Copy figure as png
Ctrl-t Show figure properties in dialog as copyable text
Ctrl-w Close window
Ctrl-shift-o Open folder containing data
Enter Select sweep in the FileList

Known Issues

Plotting incomplete 2D data

Incomplete 2D data consists of a number of complete data rows and one partially completed data row. FolderBrowser truncates the data arrays at load-time so that a partially completed row is removed. This behavior is different from the matlab-qd gui where data is truncated at plot-time and only when making image plots. Thus, for image plots there is no observed difference for the user. For 2D data plotted as 1D, however, a partially completed row is not plotted in FolderBrowser, but is plotted in the matlab-qd gui. This behavior can be changed by padding the reshaped data array with NaN, but this may break other things, like checking whether the data is linearly varying in DataHandler.

Python 3.6

This issue appears to be fixed with Python 3.6.1 in Anaconda 4.4.0. See https://stackoverflow.com/questions/43264773/pil-dll-load-failed-specified-procedure-could-not-be-found for reference. Original issue text follows below.

2017-03-31: Anaconda's Python 3.6 distribution may give an error when starting FolderBrowser: DLL load failed: The specified module could not be found. In this case downgrade the distribution to Python 3.5 using

conda install python=3.5

from the terminal.

More

See also the TODO file.

Contact

Morten Canth Hels: mortenhels@gmail.com

About

Visualizes data acquired with the matlab-qd framework

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages