piScope

πScope

πScope is a Python-based workbench for data analysis and modeling.

Goals of piScope include:

Data browsing (scope) application for MDSplus data system (www.mdsplus.org)
Lego blocks for gluing up large simulation codes using Python
User frontend platform for Petra-M (MFEM based finite element simulation).

For the above purposes, πScope is equipped with:

a data analysis environment (= Python shell, editor, data structure browser, and Matplotlib figure)
various GUI components to work with matplotlib-based figures, which allow users to:
save/load a figure as a figure file.
edit artists using GUI palette for plot, contour, image, triplots and so on.
change panel layout via an interactive layout editor.
cut/paste of plot, axes, or an entire page.
export data from plot to Python shell with one click.
interactively annotate figure using text, arrow, lines, etc.
draw 3D (OpenGL) in a Matplotlib canvas.

πScope is also used for Petra-M finite element analysis platform built on MFEM.

Install

 pip install piScope

 or
 
 git clone git@github.com:piScope/piScope.git; cd piScope
 pip install .

Plotting commands

The following plotting commands are available. These commands are preloaded in the Python shell inside piScope GUI. From a script, users need to load them:

Inside a live piScope GUI process, plotting calls use the GUI interactive backend.
Outside piScope GUI, plotting calls use the no-GUI client backend. The backend launches piScope automatically if it is in an interactive session. Otherwise, it needs to be launched by calling launch().

Figure and axes management

figure, showpage, cla, cls, clf, subplot, isec, isection
addpage, delpage, title, suptitle, xlabel, ylabel, zlabel, clabel
xlog, ylog, zlog, clog, xlinear, ylinear, zlinear, clinear
xlim, ylim, zlim, clim, xauto, yauto, zauto, cauto
twinx, twiny, cbar, view, threed, lighting

2D plotting

plot, oplot, loglog, semilogx, semilogy, timetrace, plotc
scatter, hist, errorbar, oerrorbar, errorbarc
triplot, ispline, contour, contourf, quiver
image, specgram, spec, tripcolor, tricontour, tricontourf
axline, axlinec, axspan, axspanc, fill, fill_between, fill_betweenx
text, figtext, arrow, figarrow, legend

3D plotting

surf, surface, revolve, solid, trisurf, quiver3d, fill_between_3d

Annotation and output

property, savefig, savedata

Example

from ifigure.interactive import figure
import numpy as np
x = np.linspace(0, 10, 100); y = np.sin(x)
v = figure(size=(500, 400))  # Create viewer
v.plot(x, y)
v.title("Sine Wave")
v.xlabel("x-axis");v.ylabel("y-axis")
v.legend('curve1')
v.savefig("sine_wave.pdf") # Save the plot as a PDF

LLM sessions (experimental)

To enable an LLM agent to control a persistent piScope session, copy the entire plotting skill into that agent's user skill directory:

cp -a skills/piscope-plotting <LLM_SKILLS_DIR>/

The skill includes its instructions and scripts for launching piScope and sending commands to its server.

Directories

../python/ifigure core program
../python/ifigure/example examples
../bin/ scripts to run πScope
../tests/ plotting test routines.
../example/ example data to look in πScope

Reference

(S Shiraiwa, T Fredian, J Hillairet, J Stillerman, "πScope: Python-based scientific workbench with MDSplus data visualization tool", Fusion Engineering and Design 112, 835 (2016) https://doi.org/10.1016/j.fusengdes.2016.06.050)

Metadata

Release files for piScope 26.9.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for piScope 26.9.2
File	Size	Uploaded
piscope-26.9.2.tar.gz	1.5 MB	Sep 2, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for piScope 26.9.2
File	Interpreter	ABI	Platform	Reset
piscope-26.9.2-py3-none-any.whl 1.8 MB Sep 2, 2026	Python 3	none	any	Details

Total release size: 3.3 MB

Release files / piscope-26.9.2.tar.gz

Download URL	piscope-26.9.2.tar.gz
Size	1.5 MB
Tags	Source
SHA-256 checksum How to use checksums	`d567805e1ed874506c1523dbf80957a9b5f7e3eb8e686c1b3dc01206fb5e6fe0`
BLAKE2b-256 checksum How to use checksums	`ec6f5ccf894601f0db19479712cd056e89c98e9970a41fe7d20f5e04259582d1`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`

Release files / piscope-26.9.2-py3-none-any.whl

Download URL	piscope-26.9.2-py3-none-any.whl
Size	1.8 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`531f10dc1f94c252fce639ee0f314fd67698d22b917bdf4a7f9c69e0bfa0118b`
BLAKE2b-256 checksum How to use checksums	`d96367a1c2b7853cfad293437cb997e8ddd2ceb95b58dd773a1bf1cf67521ad1`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`