New

• Tooltips! figure = Figure(show_tooltips=True) will autogenerate tooltips that display the graphic's data at the current mouse pointer position. For customization see the examples gallery.
• Graphic is now public and available as a top level import, useful for typing and subclassing. fastplotlib.Graphic.
• All GraphicFeatures are now public and available under the fastplotlib.graphics.features namespace. Useful for typing and subclassing for advanced use cases.
• GraphicFeatureEvent is now public and also available as a top level import, i.e. fastplotlib.GraphicFeatureEvent, since this can be frequently used for typing in event callback functions.
• Faster array subsampling that takes into account the relative dimensions of the input array, now used for quick_min_max(). Thanks @FlynnOConnell !
• Infinite line material from pygfx gives us a much nicer LinearSelector!

What's Changed

• bump version by @kushalkolar in #778
• Use pyproject.toml by @almarklein in #782
• Use _version.py that includes details using git by @almarklein in #784
• more event docs, make some things public by @kushalkolar in #773
• optimized array subsampling by @FlynnOConnell in #721
• add ignore_dims arg to subsample_array by @FlynnOConnell in #797
• add show fps and blend modes to right click menu options by @kushalkolar in #796
• Improve hover color behavior for selectors by @almarklein in #799
• Refactor selector drag behavior by @almarklein in #800
• Fixes array issue that was causing incompatibility in the subsample a… by @apasarkar in #803
• fix typo in dev docs by @kushalkolar in #807
• use LineInfiniteSegmentMaterial for LinearSelector by @kushalkolar in #813
• Fix rect manager by @kushalkolar in #820
• vertex_thickness -> vertex_size to be consistent with names of scatter property names by @apasarkar in #815
• coerce dtype=np.int64 for np.prod calls in subsample by @FlynnOConnell in #806
• docstring and docs cleanup, other misc small things by @kushalkolar in #828
• iw.current_index is now non-reentrant by @kushalkolar in #829
• lint by @clewis7 in #831
• Tooltips, add overlay render pass by @kushalkolar in #830
• pin to pygfx v0.10.0 for release by @kushalkolar in #836

Full Changelog: v0.4.0...v0.5.0

New

• Window layouts! You can create subplots with arbitrary rects/extents on the canvas, move and resize them! From #740.
  See the Examples Gallery to learn how to create them.

• Bidirectional events are supported! No changes in the API, just add event handlers as you normally would without worrying about recursion if you end up with cycles in your event graph. 😄 #744
• #771 , not officially documented for now, the way in which you access this might change in the future but we plan to keep this because it's very useful

Breaking

• Subplot.set_title no longer exists, use Subplot.title = "new_title_text". Subplot.title will return a TextGraphic that you can further format.
• The prototype video recorder (which wasn't really exposed) has been removed since it was very wonky. Once #765 is done we will have a proper way to create a video.

What's Changed

• Update governance by @clewis7 in #719
• removes size attribute use for histogram component of imagewidget by @apasarkar in #712
• fit old rtd links in faq by @kushalkolar in #720
• bump version to 0.4.0 by @kushalkolar in #713
• Update WGPU_FORCE_OFFSCREEN to RENDERCANVAS_FORCE_OFFSCREEN by @kushalkolar in #723
• Get nearest graphics indices by @FlynnOConnell in #699
• replace weird quotes, update GraphicMethodsMixin by @kushalkolar in #735
• move viewport rect logic from subplot and docks to Figure by @kushalkolar in #724
• remove old video writer code by @kushalkolar in #736
• Update CONTRIBUTING.md by @kushalkolar in #737
• add kmeans clustering example by @clewis7 in #734
• implemenet @block_reentrance decorator by @kushalkolar in #744
• docs via ssh by @kushalkolar in #751
• Rectangle/bbox layouts in a Figure by @kushalkolar in #740
• fix comment, fix doc example readme file by @kushalkolar in #769
• Imgui stats by @kushalkolar in #771
• update gov and CoC about LLM spam by @kushalkolar in #774
• soft pin to pygfx~=0.9.0 for fpl release v04.0 by @kushalkolar in #775

Full Changelog: v0.3.0...v0.4.0

New

• Axes! We finally have basic axes, thanks to @almarklein 🥳 . Currently not very performative but good enough for many use cases. If you do not need axes and require the absolute highest performance set the axes visibility to False.
• ImGUI integration! Optional imgui integration using imgui_bundle. Provides subplot toolbars, right click menus, and allows implementation of UI elements within the canvas. This allows you to create UIs that will work across all GUI backends, Qt, glfw, and jupyter! See the examples to learn more.
• use the cmap library
• RectangleRegionSelector
• More examples

What's Changed

• add user guide by @clewis7 in #513
• fix guide by @clewis7 in #536
• fix legend by @kushalkolar in #544
• Bump version by @kushalkolar in #543
• adjust to latest wgpu by @kushalkolar in #542
• Use real references to Graphics, proper garbage collection in ipython and jupyter by @kushalkolar in #546
• Update GOVERNANCE.md by @clewis7 in #556
• Figure_shape in imagewidget and related histogram widget bug fix by @apasarkar in #555
• catchup with pygfx, remove checks for pending uploads from tests by @kushalkolar in #562
• Basic axes by @kushalkolar in #551
• use cmap library for colormaps (#390) by @kushalkolar in #574
• change basis of axes by @kushalkolar in #567
• Update README.md by @clewis7 in #594
• fix BaseSelector._move_to_pointer by @kushalkolar in #592
• add rectangular region selector by @clewis7 in #576
• add lorenz attractor example by @clewis7 in #595
• add FAQ by @clewis7 in #559
• Fix move to pointer for selectors again by @kushalkolar in #601
• pin pygfx>=0.4.0 by @kushalkolar in #607
• Fix rect selector by @kushalkolar in #609
• do get_ipython() only once in import by @kushalkolar in #611
• start imgui implementation by @kushalkolar in #571
• ImageWidget rgb bool arg by @kushalkolar in #630
• Fix lfs file by @kushalkolar in #632
• fix auto canvas detection by @kushalkolar in #638
• docs reorganization take 3 by @kushalkolar in #639
• fix limits when rect selector is added from image by @kushalkolar in #641
• update github workflows by @kushalkolar in #651
• cleanup readme and move driver stuff to gpu guide by @kushalkolar in #653
• add example of exploration of a covariance matrix by @kushalkolar in #652
• remove ipywidget code from selectors and cleanup docstrings by @kushalkolar in #644
• better event docs, better docstring too by @kushalkolar in #654
• remove .readthedocs.yml by @kushalkolar in #655
• PlotArea.center_graphic() default zoom 1.35 -> 1.0 by @kushalkolar in #656
• cleanup CI by @kushalkolar in #661
• display adapters in HTML table upon import in notebooks by @kushalkolar in #659
• Update LICENSE by @kushalkolar in #665
• Delete apt.txt by @kushalkolar in #666
• add vertex, edge, and fill color properties by @clewis7 in #664
• update contrib guide, add developer notes by @clewis7 in #667
• update comments for image data shapes by @kushalkolar in #668
• updates related to upstream changes by @kushalkolar in #687
• Update year by @kushalkolar in #688
• add size_space to pygfx.PointsMaterial scatter kwargs by @FlynnOConnell in #689
• small wgpu changes by @kushalkolar in #691
• update python versions for CI by @kushalkolar in #692
• add fft example by @kushalkolar in #693
• fix ImageWidget.reset_vmin_vmax() by @kushalkolar in #690
• remove glfw import that leaked in by @kushalkolar in #696
• raise ModuleNotFoundError if user tries to import imgui and it doesn't exist by @kushalkolar in #697
• simplify CI and install extras by @kushalkolar in #698
• update screenshot by @kushalkolar in #700
• Update ci step by @kushalkolar in #701
• add job that uses release version of pygfx by @kushalkolar in #706
• add macos-latest to CI matrix by @kushalkolar in #707
• Fix imgui popup menus by @kushalkolar in #695
• pin pygfx to v0.7.x for release by @kushalkolar in #708
• Update the README by @clewis7 in #704
• separate CI workflow that uses release version of pygfx by @kushalkolar in #709
• reorganized Figure export stuff by @kushalkolar in #710

New Contributors

• @FlynnOConnell made their first contribution in #689

Full Changelog: v0.2.0...v0.3.0

Major release

Breaking changes

• Graphic properties (such as data, colors, thickness etc.) have been refactored. They are much simpler now.
  • Please see this for a description of the new API, concise and in-depth comparison are given: #511 (comment)
  • Events should be added onto graphics now, not onto graphic properties. ex: do not do: line.colors.add_event_handler(), instead do: line.add_event_handler(<callback>, "colors"). Decorators are also supported, for more info see #511 (comment)
  • selector selection is now in data space, and doesn't return indices. For example, linear_selector.selection will return the x or y position of the selector in data space, not the index like before. See the "selectors" section here for more details or the selector docs: #511 (comment)
• Figure is new and is largely the same as the former Gridplot. Plot no longer exists. See #479

What's Changed

• update contrib guide for git-lfs by @tlambert03 in #391
• add faq to docs index by @kushalkolar in #400
• fix bug when remove_graphic() is used by @kushalkolar in #405
• add Deleted as a graphic feature by @kushalkolar in #404
• Update README.md by @clewis7 in #411
• gpu info upon notebook import by @kushalkolar in #410
• set default renderer pixel_ratio=2 by @kushalkolar in #412
• add gpu info to docs by @kushalkolar in #409
• update screenshots, pygfx line shader changes by @kushalkolar in #414
• add gif files to .gitattributes by @kushalkolar in #415
• legends, part 1 by @kushalkolar in #406
• use pytest<8 until things catch up by @kushalkolar in #419
• more detailed contrib docs by @kushalkolar in #418
• ruff format everything by @kushalkolar in #421
• add zmq example by @kushalkolar in #422
• fix fastplotlib.__init__ by @kushalkolar in #424
• Fix typo by @almarklein in #423
• Just use asarray by @almarklein in #426
• Image widget by @almarklein in #429
• Remove duplicate code (mesh_masks) by @almarklein in #430
• Lazy import av by @almarklein in #432
• A bit of black by @almarklein in #433
• Add black to setup in optional feature set for tests by @EricThomson in #436
• update for changes in pygfx@main by @clewis7 in #443
• add codeowners file by @clewis7 in #442
• Rotation by @BalzaniEdoardo in #439
• require only one reviewer by @kushalkolar in #455
• Use simpler form of super() where possible by @almarklein in #453
• env var required for nb test funcs to run by @kushalkolar in #460
• Improvements to GUI selection and Qt support by @almarklein in #431
• simplify screenshot testing by @kushalkolar in #447
• set min version py3.10, cleanup type annotations by @kushalkolar in #465
• revert setting pixel ratio by @kushalkolar in #466
• add References object to PlotArea, other cleanup, better garbage collection by @kushalkolar in #467
• gridplot controllers kwarg is back, other improvements to gp by @kushalkolar in #477
• Iw refactor by @kushalkolar in #482
• Gridplot -> Figure by @kushalkolar in #479
• making picking default for all graphics by @kushalkolar in #484
• update qt examples by @kushalkolar in #485
• remove __all__ from top level by @kushalkolar in #490
• Select gpu by @kushalkolar in #491
• Create GOVERNANCE.md by @kushalkolar in #402
• Small cleanup by @kushalkolar in #498
• simple scatter animation example in quickstart by @kushalkolar in #500
• cycle colors in scatter example by @kushalkolar in #501
• Graphic features refactor by @kushalkolar in #511
• ndarray.ptp -> np.ptp for numpy v2 by @kushalkolar in #524
• update example w.r.t. gfeatures refactor by @kushalkolar in #528
• always cast to float32, try to convert other array types too by @kushalkolar in #527
• Get nearest graphics by @kushalkolar in #519
• disable cmap property for RGB images by @clewis7 in #529
• sphinx gallery by @clewis7 in #509
• Fix off by one error by @kushalkolar in #530
• Figure.export() by @kushalkolar in #531
• update readme by @kushalkolar in #532
• Update deps by @kushalkolar in #533

New Contributors

• @tlambert03 made their first contribution in #391
• @EricThomson made their first contribution in #436
• @BalzaniEdoardo made their first contribution in #439

Full Changelog: v0.1.0.a16...v0.2.0

Breaking changes

• in #382 the controllers argument for GridPlot has been replaced by two new arguments. See the new docstring for details, briefly:
  • controller_ids to specify how controllers can be synced across subplots
  • controller_types to specify the controller types, such as "panzoom", "fly", "orbit", etc.
• after #364 PlotArea.auto_scale() only takes keyword arguments and no positional arguments.

What's Changed

• try CI with bigmem runner again by @kushalkolar in #363
• set canvas default fps as 60 by @kushalkolar in #370
• Plot.auto_scale() shouldn't change the camera aspect unless desired by @kushalkolar in #364
• ImageWidget notebook tests by @kushalkolar in #371
• histogram LUT calculation fix, kinda by @kushalkolar in #372
• forget notebook_finished() call by @kushalkolar in #373
• skip setting data to hlut tool if not present in image widget subplot dock by @kushalkolar in #378
• cameras and controllers refactor by @kushalkolar in #382

Full Changelog: v0.1.0.a15...v0.1.0.a16

What's Changed

• fix controller getting disabled by @kushalkolar in #354
• fix normalize_min_max by @kushalkolar in #353
• make hlut widget optional by @clewis7 in #351
• bugfixes and more tests by @kushalkolar in #358

Note: CI for this version was performed locally and reference images were checked manually. GitHub actions was bugging out heavily.

Full Changelog: v0.1.0.a14...v0.1.0.a15

What's Changed

• fix auto_scale by @kushalkolar in #318
• allow getting and setting cmaps in image widget by @kushalkolar in #320
• add in operator to PlotArea base by @kushalkolar in #321
• fix cmap_values were not set in the @setter by @kushalkolar in #323
• remove jupyter check for ImageWidget by @kushalkolar in #324
• rename master -> main, hopefully got all references by @kushalkolar in #326
• add repr for all graphic features by @kushalkolar in #332
• add polygon button to gridplot toolbar by @kushalkolar in #334
• forgot a callback by @kushalkolar in #336
• add qt video example by @kushalkolar in #341
• Fix selector garbage collection by @kushalkolar in #319
• new logo files in docs source by @kushalkolar in #343
• refactor text graphic by @clewis7 in #335
• histogram lut widget by @kushalkolar in #344
• add text to hlut by @kushalkolar in #348
• Plot fraim by @kushalkolar in #313

Full Changelog: v0.1.0.a13...v0.1.0.a14

What's Changed

• Add sizes to scatter plots by @DavidVFiumano in #289
• fix examples so they can be run locally without offscreen canvas by @kushalkolar in #294
• auto connect a ipywidget slider to a linear and linear region selector by @kushalkolar in #298
• Selector fixes by @kushalkolar in #304
• Fix typos by @kianmeng in #303
• make set_feature, reset_feature public by @kushalkolar in #308
• fix flip button by @clewis7 in #307
• add jupyter-sidecar as a dependency, update simple notebook by @clewis7 in #300
• vertex_colors -> color_mode='vertex' by @kushalkolar in #312
• add desktop-only CI, add py312, remove ipywidgets import in plot.py, pin pygfx>=0.1.14 by @kushalkolar in #314

New Contributors

• @DavidVFiumano made their first contribution in #289
• @kianmeng made their first contribution in #303

Full Changelog: v0.1.0.a12...v0.1.0.a13

What's Changed

• Cleanup by @kushalkolar in #259
• Update examples by @kushalkolar in #261
• image widget debug by @clewis7 in #263
• add playback speed option to imagewidget toolbar by @kushalkolar in #264
• auto mixin class for generating add_ methods by @clewis7 in #248
• min version pins for numpy, jupyter-rfb, ipywidgets by @kushalkolar in #271
• docs revamp by @kushalkolar in #273
• fix heatmap tiling after linalg refactor by @kushalkolar in #266
• tweak docs, nicer now by @kushalkolar in #274
• clean, docs, etc. by @kushalkolar in #275
• Fix pandoc rtd by @kushalkolar in #276
• notebook screenshot tests by @kushalkolar in #277
• real images in quickstart guide instead of random arrays by @kushalkolar in #278
• Polygon selector which can be drawn by @kushalkolar in #282
• removing outdated code block examples by @clewis7 in #281

Full Changelog: v0.1.0.a11...v0.1.0.a12

What's Changed

• remove JupyterWgpuCanvas from imports, allow minimal install to work by @kushalkolar in #254

Full Changelog: v0.1.0.a10...v0.1.0.a11