This release changes the pygfx version pin due to upstream changes in rendercanvas and wgpu that cause CI issues, does not affect users.

It also includes a fix for how plot areas are auto scaled when controllers manage multiple cameras.

What's Changed

• update pygfx pin by @kushalkolar in #939
• Bump by @kushalkolar in #942
• better plot scaling logic by @kushalkolar in #938

Full Changelog: v0.6.0...v0.6.1

New

• ImageVolumeGraphic, #791
• VectorsGraphic, #929
• Scatter markers and other new scatter features, #913
• alpha handling, transparent objects are now pickable! #873
• PolygonSelector, #837
• Better handling of z-order for rendering, #906 .

What's Changed

• Update CODE_OF_CONDUCT.md by @kushalkolar in #879
• Tweaks to adjust to new pygfx blending by @almarklein in #838
• add emails to gov doc by @kushalkolar in #880
• remove graphic suffix by @clewis7 in #882
• add link to quickstart nb at top of guide by @kushalkolar in #864
• Update guide.rst by @kushalkolar in #887
• add kwarg for axes visibility by @clewis7 in #891
• Update README.md by @kushalkolar in #889
• Fix typo in Visible graphics feature by @almarklein in #892
• Implement PolygonSelector by @almarklein in #837
• Refactor handling of alpha by @almarklein in #873
• add ImageVolumeGraphic by @kushalkolar in #791
• remove a old text editor temp file by @kushalkolar in #909
• Adjust for PyGfx's new ticks by @almarklein in #910
• Refactor z-order to ensure axes are on top by @almarklein in #906
• remove existing screenshots in regenerate action by @kushalkolar in #915
• thinner selectors by @kushalkolar in #914
• New screenshots :D by @kushalkolar in #919
• fewer github actions for CI by @kushalkolar in #925
• skip existing arrays in ImageWidget.set_data() by @kushalkolar in #924
• add animation func getter and clear_animations() method by @clewis7 in #896
• Scatter markers and other scatter features by @kushalkolar in #913
• Fix docstring by @kushalkolar in #930
• VectorsGraphic by @kushalkolar in #929
• bump version to 0.6.0 by @kushalkolar in #934

Full Changelog: v0.5.1...v0.6.0

Bugfix release

What's Changed

• fix iw.set_data by @kushalkolar in #851
• add github button to docs by @kushalkolar in #845
• retry sklearn datset downloads if 403 error by @kushalkolar in #844
• Update docstrings by @kushalkolar in #841
• remove Graphic.share_property() and unshare_property() by @kushalkolar in #842
• better docs on use in jupyterlab and ipython by @kushalkolar in #843
• fix move to pointer for linear and linear region selector by @kushalkolar in #855
• Imgui pin to attempt bugfix release by @kushalkolar in #876

Full Changelog: v0.5.0...v0.5.1

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 frame by @kushalkolar in #313

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