Version 0.12.*

Changes

• Drop support for Python 3.9 (xsuite/xsuite#657)
• Add support for Python 3.13
• Dependency updates

Fixes

• Fix FloorPlot issue with recent versions of xsuite due to missing survey columns (xsuite/xsuite#693)
• v0.12.1: Fix FloorPlot support for thick replicas #97

Full Changelog: v0.11.14...v0.12.1

Version 0.11.*

New & improved features

• TwissPlot
  • Add option to plot apertures onto twiss plot
  • Add support for beam envelope, beam size and other data from twiss.get_beam_covariance
• FloorPlot
  • Add support for vertical bends and ZY projection
  • Use new information from additional columns in survey table, passing the line object is no longer needed for most cases
  • Improve element colouring in FloorPlot, handle more element types and also skew components, multipoles are now coloured by lowest non-zero order (only if passing line object explicitly)
  • Keep default boxes when customizing FloorPlot (use default_boxes=False to restore the previous behaviour)
  • Show zero length elements as narrow line only
  • Improve handling of survey data
  • Add support for RBend by @giadarol in #68
• Consider also skew components for element order and add unit test
• Add utility for discontinuous axis scales, see user guide

API changes

• Make dataset ID optional (if omitted, a UUID will be generated)

Bug fixes

• v0.11.1 Fix of FloorPlot wedges being offset #49
• v0.11.1 Fix in FloorPlot bend recognition to support Views #49
• v0.11.6 Avoid timeseries data to be interpreted as particle counts when plotting particle rate #67
• v0.11.9 Fix minimum required matplotlib version is 3.7 #77
• v0.11.10 Fix virtual sextupole util for thick elements #78
• v0.11.11 Restore compatibility with matplotlib 3.6 #79
• v0.11.12 Honor counting_bins_per_evaluation in SpillQualityTimescalePlot auto limits #85
• v0.11.13 Fix dtypes and pytest compatibility #88
• v0.11.14 Fix for slice elements in floor plot #90

Dependencies

• From this release on, pint is an optional (but still highly recommended) dependency. Without pint, all unit-conversion features are disabled! For new installations, it is recommended to use pip install xplt[recommended].

Full Changelog: v0.10.5...v0.11.14

Version 0.10.*

This is a maintenance release without functional changes, only bugfixes and requirement updates #10:

python>=3.9
matplotlib>=3.6
numpy>=1.17.0
scipy>=1.2.0
pint>=0.24.1

Fixes:

• Bend wedges in FloorPlot being offset #49

Full Changelog: v0.9.0...v0.10.5

Version 0.9.*

New & improved features

• Added interface for adding and working with multiple datasets in plots
• Added 1D ParticleHistogramPlot
• Add options for averaging FFTs (in lin and log space). This also significantly improves plotting speeds for $f \gg \text{MHz}$
• Improved and unified autoscaling, log-scaling
• More options for annotation location with axlines and axspans
• Add getter for axis by property name
• Add "-n" and "-.n" linestyles to mark lines with n dots (e.g. "-1" or "-.2")
• Improved documentation and examples, add unit tests

API changes

• Parameter smoothing in FFT plot renamed to welch (using smoothing will issue a warning)

Bug fixes

• Fix xlabel of TimeFFTPlot if relative=True
• Fixes for SpillQualityPlot and SpillQualityTimescalePlot with timeseries data
• Resolve element replicas in FloorPlot in #9 by @giadarol

Full Changelog: v0.8.0...v0.9.0

Version 0.8

🚀 With this release, xplt becomes part of the xsuite package.
The documentation is now located at https://xsuite.github.io/xplt

New & improved features

• Smoothing for FFT
• Support of time-series data for SpillQualityPlot, SpillQualityTimescalePlot, TimeFFTPlot and TimeBinPlot
• Automatic resolution for KnlPlot with precise element edges
• Annotations for axlines and axspans
• Improved default styles
• Improved documentation and error messages

API changes (breaking)

• TimeVariationPlot renamed to SpillQualityPlot
  and dropped parameters counting_bins and evaluate_bins (use counting_dt and evaluate_dt instead)
• TimeVariationScalePlot renamed to SpillQualityTimescalePlot
• Removed line_length parameter in KnlPlot as it is no longer required
• For various time plots: use timeseries=xplt.Timeseries(data, dt=1/fs) instead of timeseries=data, timeseries_fs=fs (and likewise dicts with values of this type)
• Removed xplt.timestructure.binned_timesieres. Use xplt.Timeseries.from_timestamps instead

Bug fixes

• Fixes for compatibility with latest matplotlib versions by @eltos in #8
• Fix default value for fmax when using timeseries data in TimeFFTPlot
• Fix in ParticlePlots when twiss is a dict
• Fixes when using timeseries data with various time-based plots

Full Changelog: v0.7.2...v0.8.1

Version 0.7.2

What's Changed

• Add LICENSE by @eltos in #3
• Replace np.float with builtin type float by @milo-gsi in #6
• Minor fixes

Full Changelog: v0.7.0...v0.7.2

Version 0.7.0

• Add support for thick elements in Floor Plot by @giadarol
• More options for FFT Plot
• Matplotlib stylesheet

Full Changelog: v0.6.0...v0.7.0

Version 0.6.0

• Improve property handling and introduce derived properties
  • Drops xplt.units module in favour of xplt.properties
  • Drops xplt.register_property method in favour of xplt.register_data_property and xplt.register_derived_property
  • Drops wrap_zeta=True keyword argument in favour of property zeta_wrapped
  • For details, see https://eltos.github.io/xplt/examples/properties.html
• Improved consistency
  • Make pandas an optional dependency
  • Renamed metric= keyword argument of TimeVariationPlot to kind=

Full Changelog: v0.5.0...v0.6

v0.5.0

• Update examples to match latest xtrack API
• Usage improvements and simplification

Full Changelog: v0.4.1...v0.5.0