CHANGELOG.rst

PlasmaPy v2023.1.0 (2023-01-13)

Backwards Incompatible Changes

• Moved the charged particle radiography analysis codes into a new module ~plasmapy.diagnostics.charged_particle_radiography containing synthetic radiography tools in ~plasmapy.diagnostics.charged_particle_radiography.synthetic_radiography and detector stack calculation tools in ~plasmapy.diagnostics.charged_particle_radiography.detector_stacks. (1274)
• Changed the ~plasmapy.formulary.lengths.gyroradius function so that it takes relativistic effects into account by default. (1813)

Deprecations and Removals

• Changed the ~plasmapy.formulary.lengths.gyroradius function so it no longer accepts deprecated T_i. (1824)
• Removed plasmapy.formulary.parameters, which was deprecated in the 0.7.0 release. The functionality in that module had previously been migrated to modules that are broken down by physical type, such as: plasmapy.formulary.densities, plasmapy.formulary.dimensionless, plasmapy.formulary.frequencies, plasmapy.formulary.lengths, plasmapy.formulary.misc, and plasmapy.formulary.speeds. (1833)
• Deprecated providing a real number to the charge parameter of to represent the . Use Z instead. (1866)

Features

• Added the ~plasmapy.diagnostics.charged_particle_radiography.detector_stacks.Stack and objects to the ~plasmapy.diagnostics.charged_particle_radiography module, which represent a stack of detector media layers. The ~plasmapy.diagnostics.charged_particle_radiography.detector_stacks.Stack.deposition_curves and ~plasmapy.diagnostics.charged_particle_radiography.detector_stacks.Stack.energy_bands methods of ~plasmapy.diagnostics.charged_particle_radiography.detector_stacks.Stack calculate the particle energies deposited in each detector layer. (1274)
• ~plasmapy.diagnostics.charged_particle_radiography.synthetic_radiography.Tracker now supports multiple field grids, provided as an iterable. (1799)
• Added the plasmapy.analysis.time_series.running_moments module including two functions for calculating running moments of time series. (1803)
• Added lorentzfactor as an optional keyword-only argument to ~plasmapy.formulary.lengths.gyroradius. Also added relativistic as an optional keyword-only argument which can be set to False for the non-relativistic approximation. (1813)
• Modified attributes to return in the appropriate units when undefined rather than raising exceptions. (1825)
• Added the ~plasmapy.particles.particle_class.CustomParticle.charge_number attribute to . (1866)
• Added Z as a representing the to . (1866)

Improved Documentation

• Updated docstrings and annotations in plasmapy.diagnostics.thomson. (1756)
• Updated the discussion on type descriptions and parameter descriptions for docstrings in the . (1757)
• Updated troubleshooting sections of the . (1817)
• Added a summary section to the . (1823)
• Updated the . (1826)
• Reorganized the . (1856)
• Added a documentation page on performance tips. (1887)

Trivial/Internal Changes

• Updated warning messages in ~plasmapy.formulary.collisions.coulomb.Coulomb_logarithm. (1586)
• Transferred most of the contents of setup.py and setup.cfg to _ (see 518 and 621). Simplified extras requirements (pip install plasmapy[all] and [extras] are gone). (1758)
• Added blacken-docs to the configuration. (1807)
• Removed pytest-xdist from the testing requirements (see also 750). (1822)
• Refactored tests of ~plasmapy.formulary.relativity.Lorentz_factor and ~plasmapy.formulary.relativity.relativistic_energy. (1844)
• Applied refactorings from ruff and refurb to plasmapy.utils. (1845)
• Applied changes from refurb to plasmapy.particles. (1846)
• Applied changes from refurb to plasmapy.formulary. (1847)
• Apply changes from ruff and refurb to plasmapy.analysis, plasmapy.diagnostics, plasmapy.dispersion, and plasmapy.plasma. (1853)
• Added ruff to the pre-commit configuration. (1854)
• Added the strict and allowed_physical_types parameters to plasmapy.utils._units_helpers._get_physical_type_dict. (1880)
• Added a private constructor method to with an API that is better suited for use in and the particle factory function used by . (1881)
• Dropped the dependency on cached-property in favor of functools.cached_property. (1886)

PlasmaPy v0.9.0 (2022-11-11)

Backwards Incompatible Changes

• Removed the none_shall_pass parameter from . Instead, typing.Optional should be used to create the annotation (e.g., Optional[ParticleLike]). (1057)
• Renamed the first of from wrapped_function to wrapped. (1057)
• Refactored the return pattern of ~plasmapy.analysis.swept_langmuir.floating_potential.find_floating_potential to follow the (vf, extras) pattern, where vf is the computed floating potential and extras is an instance of ~plasmapy.analysis.swept_langmuir.floating_potential.VFExtras containing extra parameters from the computation. (1565)
• Moved plasmapy.particles.particle_collections.ionic_levels to plasmapy.particles.atomic.ionic_levels. (1697)
• Deprecated plasmapy.formulary.collisions.fundamental_electron_collision_freq. The ~plasmapy.formulary.collisions.frequencies.MaxwellianCollisionFrequencies.Maxwellian_avg_ei_collision_freq attribute of ~plasmapy.formulary.collisions.frequencies.MaxwellianCollisionFrequencies should be used instead. (1703)
• Deprecated plasmapy.formulary.collisions.fundamental_ion_collision_freq. The ~plasmapy.formulary.collisions.frequencies.MaxwellianCollisionFrequencies.Maxwellian_avg_ii_collision_freq attribute of ~plasmapy.formulary.collisions.frequencies.MaxwellianCollisionFrequencies should be used instead. (1703)
• The parameters Z and mass_numb are now for ~plasmapy.particles.symbols.ionic_symbol and ~plasmapy.particles.symbols.particle_symbol. (1718)
• Moved the valid_categories attribute of ~plasmapy.particles.particle_class.AbstractPhysicalParticle.is_category to plasmapy.particles.particle_class.valid_categories. (1720)
• Changed the behavior of , , and so that an equality comparison with an object of a different type returns False instead of raising a TypeError. (1721)
• When the argument provided to ~plasmapy.formulary.magnetostatics.GeneralWire is not callable, a TypeError will be raised instead of a ValueError. (1782)
• In ~plasmapy.diagnostics.thomson.spectral_density and ~plasmapy.diagnostics.thomson.spectral_density_model, a TypeError is now raised when ions is an unsupported type. (1782)
• In ~plasmapy.plasma.grids.AbstractGrid, a TypeError is now raised instead of a ValueError when start or stop are not of the appropriate type. (1783)

Deprecations and Removals

• The capability of to process arguments annotated with or (Particle, Particle) is now deprecated and will be removed in a future release. Use as an annotation instead. (1057)
• The integer_charges attribute of has been removed after being deprecated in v0.7.0. Use ~plasmapy.particles.ionization_state.IonizationState.charge_numbers instead. (1633)
• The integer_charge attributes of and have been removed after being deprecated in v0.7.0. Use the charge_number attribute instead. (1633)
• The plasmapy.particles.atomic.integer_charge function has been removed after being deprecated in v0.7.0. Use ~plasmapy.particles.atomic.charge_number instead. (1633)
• Deprecated plasmapy.formulary.collisions.frequencies.collision_frequency in favor of collision frequency classes in plasmapy.formulary.collisions. See also 1703. (1676)

Features

• Expanded the functionality of the decorator to convert and arguments into , , and objects. This change is part of an ongoing effort to improve compatibility of functions in subpackages like plasmapy.particles and plasmapy.formulary with and objects. (1057)
• Added the ~plasmapy.analysis.swept_langmuir.ion_saturation_current.find_ion_saturation_current function to the ~plasmapy.analysis.swept_langmuir module. The function fits the tail of a swept Langmuir probe trace and returns the linear fit corresponding to the ion-saturation current. (1469)
• Created plasmapy.utils.data to contain functionality for downloading data from PlasmaPy's data repository. This module contains a new prototype function plasmapy.utils.data.downloader.get_file which downloads a file from the repository. (1486)
• Added the class to facilitate calculation of the relativistic properties of a body in motion. (1540)
• Added inplace as an optional argument to ~plasmapy.simulation.particle_integrators.boris_push. (1556)
• Added a function to calculate the dimensionless Lundquist number. (1642)
• Created the plasmapy.formulary.densities module. (1664)
• Added ~plasmapy.formulary.densities.critical_density to calculate the critical density of a plasma for a given frequency of radiation. (1664)
• Added the plasmapy.formulary.collisions.CollisionFrequencies class. This class can be used to calculate collision frequencies for two interacting species in a plasma. Superseded by 1703. (1676)
• Reimplemented ~plasmapy.formulary.quantum.chemical_potential. (1678)
• Allowed ~plasmapy.formulary.relativity.Lorentz_factor to accept and return values. (1681)
• Added a test for ~plasmapy.formulary.dimensionless.Hall_parameter in plasmapy/formulary/test/test_dimensionless.py. (1689)
• Replaced usage of os.path with the more modern pathlib. (1690)
• Replaced pkg_resources with the more modern importlib.metadata. (1692)
• Added the ~plasmapy.particles.particle_class.CustomParticle.categories attribute to , and added the "custom" particle category. (1700)
• Moved the is_category method of to ~plasmapy.particles.particle_class.AbstractPhysicalParticle. This method is now inherited by both and . (1700)
• Added ~plasmapy.formulary.collisions.frequencies.MaxwellianCollisionFrequencies for calculating relevant collision frequencies for Maxwellian populations. (1703)
• Refactored ~plasmapy.formulary.collisions. The file collisions.py was converted into a subpackage (directory) and it's contents was split into appropriately categorized and named sub-modules (files). (1769)

Bug Fixes

• Modified tests in the class TestSyntheticRadiograph to try to fix an intermittent failure of test_optical_density_histogram. (1685)

Improved Documentation

• Added the Hollweg dispersion notebook. (1392)
• Creates an example notebook for fitting Thomson scattering spectra using the ~plasmapy.diagnostics.thomson.spectral_density_model function. (1520)
• Updated the following the 0.8.1 release. (1615)
• Added docs/whatsnew/dev.rst as a stub file for the changelogs between releases. (1623)
• Added customizations for towncrier in pyproject.toml. (1626)
• Updated the introductory paragraphs of the . (1649)
• Added a section to the on best practices for naming variables. (1650)
• Updated the section of the contributor guide on _, and moved it to docs/contributing/install_dev.rst. (1651)
• Added sections to the on units and particles. (1655)
• Updated the section of the on code style. (1657)
• Added sections to the on lite-functions and aliases. (1658)
• Added sections to the on imports and requirements. (1659)
• Added sections on best practices for comments and error messages to the . (1660)
• Updated the section of the with more detail on the "Parameters", "Raises", and "Warns" sections of docstrings. (1667)
• Added a guideline to the specifying how values should be treated in functions that accept or inputs. (1673)
• Added an admonition to the that describes how to change reST links for removed code objects into inline literals in old changelog entries. (1674)
• Split the patent clause from the license file (LICENSE.md) into its own file (PATENT.md). (1686)
• Added explanatory text to the "Notes" sections in the docstrings for functions within ~plasmapy.formulary.magnetostatics. (1695)
• Enabled :py: as a reST role for inline code formatting in the documentation. (1698)
• Increased the minimum version of Sphinx to 5.0.0. (1698)
• Updated docstrings and annotations for and its methods. (1713)
• Updated docstrings and annotations in plasmapy.particles, including by marking parameters as or . (1718)
• Added a section to the on troubleshooting. (1752)

Trivial/Internal Changes

• Moved the functionality responsible for converting arguments to particle objects from the decorator into a separate class that is now used inside . (1057)
• Added wrapt as a dependency. (1057)
• The decorator now processes arguments annotated with . (1057)
• Added tomli to the tests category of requirements. (1500)
• Added tests to verify that the requirements given in the .txt files in the requirements directory are consistent with the requirements given in setup.cfg and pyproject.toml. (1500)
• Restricted the required version of sphinx-gallery to < 0.11.0, since sphinx-gallery changed their thumbnail containers to flex containers. See pull request sphinx-gallery/#906 and issue sphinx-gallery/#905 for more detail. (1654)
• Moved the plasmapy.formulary.dimensionless.quantum_theta function to plasmapy.formulary.quantum.quantum_theta. This function can still be called from the plasmapy.formulary.dimensionless module without issue. (1671)
• Reimplemented plasmapy.formulary.quantum._chemical_potential_interp. (1678)
• Re-enabled value testing for the quantum keyword argument in ~plasmapy.formulary.collisions.dimensionless.coupling_parameter. (1678)
• Increased the minimum version of NumPy to 1.20.0. (1694)
• Added the ~plasmapy.utils.decorators.validators.validate_class_attributes decorator to the ~plasmapy.utils.decorators module. This decorator is useful for class methods that require optional parameters to be specified during class instantiation. (1703)
• Made minor improvements to plasmapy.formulary.collisions.CollisionFrequencies. (1705)
• Changed the towncrier requirement to >= 19.2.0, < 22.8.0. Superseded by 1717. (1710)
• Applied automated refactorings from Sourcery. (1714)
• Changed the minimum version of towncrier to 22.8.0 and the minimum version of _ to 1.2.0. (1717)
• Changed ~plasmapy.formulary.quantum.chemical_potential to use the Broyden-Fletcher-Goldfarb-Shanno algorithm to implicitly solve for the ideal chemical potential. (1726)
• Increased the minimum version of Astropy to 5.0.1. (1727)
• Simplified the pull request template. (1729)
• Added a GitHub Action to automatically comment on pull requests with a code review checklist. (1729)
• The following functions are now decorated by : ~plasmapy.formulary.dimensionless.Hall_parameter, ~plasmapy.formulary.distribution.kappa_velocity_1D, ~plasmapy.formulary.distribution.kappa_velocity_3D, ~plasmapy.formulary.distribution.Maxwellian_1D, ~plasmapy.formulary.distribution.Maxwellian_velocity_2D, ~plasmapy.formulary.distribution.Maxwellian_velocity_3D, ~plasmapy.formulary.distribution.Maxwellian_speed_1D, ~plasmapy.formulary.distribution.Maxwellian_speed_2D, ~plasmapy.formulary.distribution.Maxwellian_speed_3D, ~plasmapy.formulary.lengths.gyroradius, and ~plasmapy.formulary.quantum.deBroglie_wavelength. (1732)
• Changed to raise a ~astropy.units.UnitConversionError when the annotated argument has a physical type other than mass or electrical charge. (1732)
• Set up issue forms on PlasmaPy's GitHub repository to replace issue templates. (1733)
• Made pytest an install requirement instead of a testing requirement. (1749)
• Added a step to validate _ as part of the linters tox testing environment. (1771)
• Added cffconvert to the testing requirements. (1771)
• Deleted codemeta.json, which recorded project metadata using the CodeMeta metadata schema. Instead, project metadata is now stored in _ which uses the Citation File Format and was created in 1640. See also 676 and 794. (1772)
• Added the flake8 extensions flake8-use-pathlib, flake8-builtins, and flake8-comments to the testing requirements. (1777)
• Added tryceratops as a flake8 extension. (1782)

Plasmapy 0.8.1 (2022-07-05)

Backwards Incompatible Changes

• In ~plasmapy.diagnostics.thomson.spectral_density, the arguments Te and Ti have been renamed T_e and T_i and are now required keyword-only arguments. (#974)
• Moved the grid_resolution attribute from ~plasmapy.plasma.grids.AbstractGrid to ~plasmapy.plasma.grids.CartesianGrid and ~plasmapy.plasma.grids.NonUniformCartesianGrid separately. This fixes a potential future bug, because this attribute is only valid as written when all axes share the same units. (#1295)
• Changed the behavior of the __repr__ method of to display the symbol as well if it was provided. (#1397)
• Removed a block of code that printed out special particle properties when plasmapy.particles.special_particles (renamed to plasmapy.particles._special_particles) was executed. (#1440)
• Renamed plasmapy.particles.elements to plasmapy.particles._elements, plasmapy.particles.isotopes to plasmapy.particles._isotopes, plasmapy.particles.parsing to plasmapy.particles._parsing, and plasmapy.particles.special_particles to plasmapy.particles._special_particles. Consequently, these modules are no longer part of PlasmaPy's public API. Most of these modules did not contain any public objects, except for plasmapy.particles.special_particles.ParticleZoo which was renamed to plasmapy.particles._special_particles.particle_zoo and removed from the public API. (#1440)
• The parameters Z and mass_numb to are now keyword-only. (#1456)

Deprecations and Removals

• Officially deprecated plasmapy.formulary.parameters and scheduled its permanent removal for the v0.9.0 release. (#1453)
• Dropped support for Python 3.7 in accordance with the deprecation policy laid out in NumPy Enhancement Proposal 29. (#1465)
• The [all] option when using pip to install plasmapy is now deprecated and may be removed in a future release. Packages that were previously optional (_, , _, and _) are now installed by default when running pip install plasmapy. To install all packages required for code development of PlasmaPy, instead run pip install plasmapy[developer]. (#1482)
• Removed plasmapy.optional_deps. (#1482)

Features

• ~plasmapy.diagnostics.thomson.spectral_density and ~plasmapy.diagnostics.thomson.spectral_density_model now support ~plasmapy.particles.particle_collections objects as input to the ions keywords. (#974)
• Created a lite-function for ~plasmapy.diagnostics.thomson.spectral_density, ~plasmapy.diagnostics.thomson.spectral_density_lite. (#974)
• Added a fitting function for 1D spectra, ~plasmapy.diagnostics.thomson.spectral_density_model, to the Thomson scattering diagnostic module. (#974)
• Created function plasmapy.formulary.parameters.thermal_speed_coefficients to support plasmapy.formulary.parameters.thermal_speed_lite usage by calculating the various thermal speed coefficients. plasmapy.formulary.parameters.thermal_speed_coefficients is also bound to plasmapy.formulary.parameters.thermal_speed as the coefficients attribute. (#1145)
• Created decorator ~plasmapy.utils.decorators.lite_func.bind_lite_func for handling the binding of lite-functions and any supporting functions to a parent function. (#1145)
• Introduced the concept of lite-functions, by creating the lite-function plasmapy.formulary.parameters.thermal_speed_lite, which is a simplified and Numba jitted version of plasmapy.formulary.parameters.thermal_speed. These functions are intended for computational use and as such have no validation of input or output values. plasmapy.formulary.parameters.thermal_speed_lite is also bound to plasmapy.formulary.parameters.thermal_speed as the lite attribute. (#1145)
• Added the hollweg_.py module to the ~plasmapy.dispersion.numerical subpackage to numerically solve the dispersion relation using Hollweg's method :citehollweg:1999,bellan:2012. (#1189)
• Implemented non-breaking speed improvements on the methods ~plasmapy.plasma.grids.CartesianGrid.nearest_neighbor_interpolator and ~plasmapy.plasma.grids.CartesianGrid.volume_averaged_interpolator for ~plasmapy.plasma.grids.CartesianGrid. The new interpolators now require that the grid axes be sorted, which is always true for uniform grids. Added a new test to ensure this stays true. (#1295)
• Refactored the interpolator methods on objects defined in ~plasmapy.plasma.grids. All interpolators are now defined in the subclasses of ~plasmapy.plasma.grids.AbstractGrid. Calling the interpolator methods on ~plasmapy.plasma.grids.AbstractGrid raises a NotImplementedError exception. (#1295)
• Created lite-function plasmapy.formulary.parameters.plasma_frequency_lite. (#1308)
• Added the ~plasmapy.particles.particle_class.molecule function to build objects from a str representing a molecule symbol. (#1309)
• Added the ~plasmapy.particles.particle_collections.ParticleList.is_category method for objects. This method is analogous to the ~plasmapy.particles.particle_class.Particle.is_category method for objects. (#1378)
• Created the prototype analysis tool plasmapy.analysis.nullpoint for finding the null points in a vector space using the trilinear interpolation method of :citehaynes:2007. (#1383)
• Created plasmapy.formulary.lengths to contain length related plasma parameters, and migrated ~plasmapy.formulary.lengths.Debye_length, ~plasmapy.formulary.lengths.gyroradius, and ~plasmapy.formulary.lengths.inertial_length from plasmapy.formulary.parameters to the new module. Related aliases were also migrated. (#1434)
• Created plasmapy.formulary.frequencies to contain frequency related plasma parameters, and migrated ~plasmapy.formulary.frequencies.gyrofrequency, ~plasmapy.formulary.frequencies.plasma_frequency, ~plasmapy.formulary.frequencies.plasma_frequency_lite, ~plasmapy.formulary.frequencies.lower_hybrid_frequency, and ~plasmapy.formulary.frequencies.upper_hybrid_frequency from plasmapy.formulary.parameters to the new module. Related aliases were also migrated. (#1439)
• Migrated ~plasmapy.formulary.dimensionless.Debye_number, and ~plasmapy.formulary.dimensionless.Hall_parameter from plasmapy.formulary.parameters to plasmapy.formulary.dimensionless. Related aliases were also migrated. (#1444)
• Created plasmapy.formulary.speeds to contain frequency related plasma parameters, and migrated ~plasmapy.formulary.speeds.Alfven_speed, ~plasmapy.formulary.speeds.ion_sound_speed, ~plasmapy.formulary.speeds.kappa_thermal_speed, ~plasmapy.formulary.speeds.thermal_speed, ~plasmapy.formulary.speeds.thermal_speed_coefficients, and ~plasmapy.formulary.speeds.thermal_speed_lite from plasmapy.formulary.parameters to the new module. Related aliases were also migrated. (#1448)
• Created plasmapy.formulary.misc to contain functionality for miscellaneous plasma parameters, and migrated ~plasmapy.formulary.misc._grab_charge, ~plasmapy.formulary.misc.Bohm_diffusion, ~plasmapy.formulary.misc.magnetic_energy_density, ~plasmapy.formulary.misc.magnetic_pressure, ~plasmapy.formulary.misc.mass_density, and ~plasmapy.formulary.misc.thermal_pressure from plasmapy.formulary.parameters to the new module. Related aliases were also migrated. (#1453)
• Created lite-functions ~plasmapy.dispersion.dispersionfunction.plasma_dispersion_func_lite and ~plasmapy.dispersion.dispersionfunction.plasma_dispersion_func_deriv_lite for ~plasmapy.dispersion.dispersionfunction.plasma_dispersion_func and ~plasmapy.dispersion.dispersionfunction.plasma_dispersion_func_deriv respectively. (#1473)
• Created lite-function plasmapy.formulary.dielectric.permittivity_1D_Maxwellian_lite for plasmapy.formulary.dielectric.permittivity_1D_Maxwellian. (#1476)
• Added the stix_.py module to the ~plasmapy.dispersion.analytical subpackage which contains the Stix cold-plasma dispersion solution ~plasmapy.dispersion.analytical.stix_.stix, :citestix:1992,bellan:2012. (#1511)
• Particle("Li").ionize() no longer results in a ~plasmapy.particles.exceptions.ChargeError. Instead, ionization of a neutral atom is assumed. (#1514)
• Created the typing construct and added particle-list-like to the . (#1528)
• Added a null point classifier function which determines the type of a given 3D magnetic null point. (#1554)
• Added support for arbitrarily shaped input arrays to the function plasmapy.formulary.collisions.lengths.impact_parameter. (#1604)

Bug Fixes

• Fixed a bug in the _make_grid method of ~plasmapy.plasma.grids.AbstractGrid that would fail to smoothly handle invalid user input if the start, stop, or num keywords were not the correct type. (#1295)
• Fixed a bug with where Particle("p+") == Particle("H", Z=1, mass_numb=1) led to a . (#1366)
• For plasmapy.formulary.parameters.gyroradius, updated the default keyword arguments and conditional for issuing the ~plasmapy.utils.exceptions.PlasmaPyFutureWarning. This addresses the incorrect behavior where a ValueError is raised if an array is passed to the deprecated keyword T_i. (#1430)
• Exposed plasmapy.formulary.misc to the plasmapy.formulary namespace. (#1471)
• Replaced misuse of max_exp_bias - max_exp_bias with max_exp_bias - min_exp_bias when creating seed parameters for the bimaxwellian fit function inside ~plasmapy.diagnostics.langmuir.get_electron_temperature. (#1487)
• Corrected the improper inversion of the electron temperature for the non-bimaxwellian case for ~plasmapy.diagnostics.langmuir.get_electron_temperature. The electron temperature, and not the slope, is a fit parameter of the curve used by ~plasmapy.diagnostics.langmuir.get_electron_temperature, so there is no need for the inversion. The returned value is now the electron temperature and not its reciprocal. (#1487)
• Exposed the ~plasmapy.analysis and ~plasmapy.dispersion subpackages to the plasmapy namespace. (#1512)
• Changed the ~plasmapy.analysis.fit_functions.Linear.curve_fit method on plasmapy.analysis.fit_functions.Linear so that the arbitrary keyword arguments get passed to scipy.stats.linregress. Previously, ~plasmapy.analysis.fit_functions.Linear.curve_fit had accepted arbitrary keyword arguments but did not pass them along to ~scipy.stats.linregress. (#1518)
• Fixed a bug in ~plasmapy.dispersion.numerical.hollweg_.hollweg that did not allow for arguments theta and k to simultaneously be arrays. (#1529)
• Fixed the Z dependence in ~plasmapy.formulary.collisions.frequencies.fundamental_electron_collision_freq, by replacing n_e with n_i while calling ~plasmapy.formulary.collisions.frequencies.collision_frequency. (#1546)
• Updated the regular expression matching used by ~plasmapy.particles.particle_class.Particle to parse and identify a particle-like string. This fixes the bug where a string with a trailing space (e.g. "Ar ") was converted into a negatively charged ion (e.g. "Ar -1"). (#1555)
• Exposed plasmapy.formulary.radiation and functions therein to the plasmapy.formulary namespace. (#1572)

Improved Documentation

• Added a lite-function group to the configuration value automodapi_custom_groups that introduces the __lite_funcs__ dunder for listing the lite-functions in a module (akin to the __all__ dunder). (#1145)
• Added a page in the that describes how to add changelog entries. (#1198)
• Created an example notebook that lets users input plasma properties and get plasma parameters. (#1229)
• The file docs/_static/css/admonition_color_contrast.css was added to include color customizations for Sphinx admonitions that originally came from sphinx_rtd_theme_ext_color_contrast. (#1287)
• Changed the color contrast of links and admonitions to be consistent with the Web Content Accessibility Guidelines 2 Level AA Conformance for contrast. (#1287)
• Re-organized CSS files for the online documentation. The file docs/_static/rtd_theme_overrides.css was re-organized, renamed to docs/_static/css/plasmapy.css, and updated with comments to help someone unfamiliar with CSS to understand the file and syntax. (#1287)
• Put references from plasmapy.formulary into docs/bibliography.bib in BibTeX format. (#1299)
• Added a discussion of test parametrization with argument unpacking to the in the . (#1316)
• Adopted the Contributor Covenant Code of Conduct version 2.1 and updated the Contributor Covenant Code of Conduct <plasmapy-code-of-conduct> page accordingly. (#1324)
• Updated deprecated meeting and calendar links in README.md. (#1327)
• Enabled the sphinx-hoverxref extension to Sphinx. (#1353)
• Added bullet points on module level docstrings and __all__ to the documentation guide. (#1359)
• Reverted the code syntax highlighting style back to the pygments default. The minimum version of pygments was set to 2.11.0 because the default style was changed to meet accessibility guidelines for contrast in this release. (#1361)
• Described additional environments for building the documentation with make in the . (#1373)
• Moved references from individual docstrings to the . (#1374)
• Fixed the docstring of ~plasmapy.formulary.collisions.dimensionless.coupling_parameter. (#1379)
• Added an example notebook that introduces how to use astropy.units. (#1380)
• Added a "Getting Started" page to the documentation sidebar and a "Getting Started" section to the examples gallery. (#1380)
• Added an example notebook that introduces how to use plasmapy.particles. (#1382)
• Described the in the narrative documentation. (#1390)
• Updated the cold magnetized plasma dielectric permittivity tensor notebook. (#1396)
• Configured the Sphinx extension sphinx-hoverxref. (#1437)
• Removed the following files from docs/api_static: plasmapy.particles.elements.rst, plasmapy.particles.isotopes.rst, plasmapy.particles.parsing.rst, and plasmapy.particles.special_particles.rst. These files corresponded to modules that were renamed with a leading underscore to indicate that they are no longer part of the public API. (#1440)
• Updated the docstring for plasmapy.particles.particle_class.molecule. (#1455)
• Hid the documentation page that contained the subpackage stability matrix. (#1466)
• Added a discussion of doctests to the . (#1478)
• Removed the section on package requirements from the instructions on how to install plasmapy. (#1482)
• Updated the instructions on how to install plasmapy. (#1482)
• Defined autodoc_typehints_format="short" so signature type hints are displayed in short form, i.e. without the leading module names. (#1488)
• Set minimum version of sphinx to v4.4. (#1488)
• Defined the nitpick_ignore_regex configuration variable in docs/conf.py to specify regular expressions for objects to ignore in nitpicky documentation builds. (#1509)
• Made numerous minor updates and fixes to reST links in docstrings and the narrative documentation. (#1509)
• Described the GitHub Action for codespell in the . (#1530)
• Added the _ extension to Sphinx to simplify linking to GitHub issues, pull requests, users, and commits. (#1532)
• Added the sphinx.ext.extlinks extension to Sphinx to simplify adding links to external domains which have a common base URL. (#1532)
• Added the _ extension to Sphinx so that the documentation now has a 404 <HTTP_404> page in the same style as the rest of the documentation. (#1532)
• Added a notebook on using ~plasmapy.formulary.dimensionless.beta from the plasmapy.formulary module to calculate plasma β in different parts of the solar atmosphere. (#1552)
• Added an example notebook for the null point finder module. (#1554)
• Added an example notebook that calculates plasma parameters associated with the Magnetospheric Multiscale Mission (MMS). (#1568)
• Added an example notebook that discusses Coulomb collisions. (#1569)
• Increased the strictness of the build_docs tox environment so that broken reST links now emit warnings which are then treated as errors, fixed the new errors, removed the build_docs_nitpicky tox environment, and updated the accordingly. (#1587)
• Renamed the magnetic_statics.ipynb notebook to magnetostatics.ipynb, and made some minor edits to its text and plotting code. (#1588)
• Added examples sections to the documentation pages for several modules within plasmapy.formulary. (#1590)
• Re-organized the directory structure for example notebooks. (#1590)
• Alphabetized the author list in docs/about/credits.rst, and added missing authors from using git log and the pull request history. (#1599)
• Renamed docs/development → docs/contributing, and set up redirects from the original hyperlinks to the new ones for the contributor guide. (#1605)
• Added _ as a Sphinx extension to allow website redirects. (#1605)
• Added a robots.txt file to the online documentation to tell web crawlers to ignore all but stable and latest documentation builds when indexing for search engines. (#1607)

Trivial/Internal Changes

• Streamlined ~plasmapy.utils.decorators.helpers.preserve_signature such that it only binds __signature__ to the wrapped function, i.e. it no longer touches any other attribute of the wrapped function. (#1145)
• Moved all tests associated with calculating the thermal speed from test file plasmapy/formulary/tests/test_parameters.py to plasmapy/formulary/tests/test_thermal_speed.py. (#1145)
• Applied reST substitutions for plasmapy.particles and in the narrative documentation. (#1158)
• Added csslint to the pre-commit configuration to check the formatting and style of CSS files. (#1287)
• Added Python 3.10 to the GitHub Actions test suite. (#1292)
• Parametrized tests for plasmapy.formulary.parameters.ion_sound_speed. (#1313)
• Added cron tests of the development versions of matplotlib and SciPy, while changing the cadence of cron tests to be run approximately fortnightly. (#1333)
• Applied pytest.warns in several tests to catch warnings that are being issued during execution of the test suite. (#1345)
• Split the tests running on pull requests into multiple stages. The various pytest test environments, including code coverage, now run conditionally given successful execution of a basic test environment and the linter checks. This change also prevents code coverage prompts from appearing twice, with incomplete information on the first time. (#1350)
• Added a helper function that takes an iterable and creates a dict with physical types as keys and the corresponding objects from that iterable as values. This change updates the minimum required version of Astropy to 4.3.1. (#1360)
• Added the module plasmapy.particles._factory which contains a private function that accepts arguments that can be provided to , , or and returns the appropriate instance of one of those three classes. (#1365)
• Used the extract method refactoring pattern on the initialization of objects. (#1366, #1368)
• Refactored tests in plasmapy.particles. (#1369)
• and no longer emit a warning when the charge and/or mass is not provided and got assigned a value of in the appropriate units. (#1399)
• Added unit test cases for manual entry of vector values in order to improve code coverage in the null point finder. (#1427)
• Consolidated and parametrized tests associated with plasmapy.formulary.parameters.gyroradius. (#1430)
• Within plasmapy.particles modules, the _elements, _isotopes, _parsing, and _special_particles modules are now imported directly. Before this, objects within these modules were typically imported. (#1440)
• Renamed objects within the source code for plasmapy.particles to conform with 8 naming conventions (e.g., ParticleZooClass → ParticleZoo, ParticleZoo → particle_zoo, and Particles → particles). (#1440)
• Applied automated refactorings from Sourcery to plasmapy.utils. (#1463)
• Applied automated refactorings from Sourcery to plasmapy.plasma. (#1464)
• Bumped the minimum version of h5py to 3.0.0. (#1465)
• Changed the raised exception to ImportError (from a general Exception) when attempting to import plasmapy from a Python version below the minimum supported version. (#1465)
• Added a workflow to label pull requests based on size. (#1467, #1492)
• Separated plasmapy.analysis.nullpoint.null_point_find into two functions named ~plasmapy.analysis.nullpoint.null_point_find and plasmapy.analysis.nullpoint.uniform_null_point_find. ~plasmapy.analysis.nullpoint.null_point_find finds the null points of a vector space whose values are manually entered. plasmapy.analysis.nullpoint.uniform_null_point_find finds the null points of a uniform vector space whose values are generated by a function provided by the user. (#1477)
• Applied automated refactorings from Sourcery to plasmapy.particles. (#1479)
• Applied automated refactorings from Sourcery to plasmapy.formulary. (#1480)
• Bumped the minimum versions of _ to 1.2.1, numpy to 1.19.0, pandas to 1.0.0, pytest to 5.4.0, scipy to 1.5.0, and _ to 0.15.0. (#1482)
• Moved _, _, _, and _ out of the extras requirements category and into the install requirements category. These packages are now installed when running pip install plasmapy. (#1482)
• Added dlint, flake8, flake8-absolute-import, flake8-rst-docstrings, flake8-use-fstring, pydocstyle, and pygments into the tests requirements category and pre-commit into the extras requirements category. These dependencies are not required for basic installation with pip. (#1482)
• Updated docs/environment.yml to use pip to install all requirements specified by requirements.txt when creating a Conda environment. (#1482)
• Used codespell to fix typos. (#1493)
• Used contextlib.suppress to suppress exceptions, instead of try & except blocks. (#1494)
• Added a pre-commit hook that transforms relative imports to absolute imports, except in docs/plasmapy_sphinx. (#1499)
• Added a test that import plasmapy does not raise an exception. (#1501)
• Added a GitHub Action for codespell, and updated the corresponding tox environment to print out contextual information. (#1530)
• Added plasmapy/utils/units_definitions.py to precompute units which were applied to optimize functionality in plasmapy/formulary/distribution.py. (#1531)
• Replaced except Exception clauses in formulary, particles, and utils with specific exception statements. (#1541)
• Added tests for passing array valued k and theta arguments to ~plasmapy.dispersion.numerical.hollweg_.hollweg, which was an added feature in 1529. (#1549)
• Added flake8-implicit-str-concat and flake8-mutable as extensions for flake8. (#1557)
• Added flake8-simplify as an extension for flake8. (#1558)
• Applied automated refactorings from Sourcery to plasmapy.dispersion. (#1562)
• Applied automated refactorings from Sourcery to plasmapy.diagnostics. (#1563)
• Applied automated refactorings from Sourcery to plasmapy.analysis. (#1564)
• Removed an extraneous print statement from ~plasmapy.formulary.collisions.frequencies.frequencies.collision_frequency that activated when the colliding particles were both electrons. (#1570)
• Changed the type hints for z_mean in plasmapy.formulary.collisions functions from astropy.units.dimensionless_unscaled to ~numbers.Real. Consequently, z_mean will no longer be processed by ~plasmapy.utils.decorators.validators.validate_quantities. Previously, z_mean issued a warning when a real number was provided instead of a dimensionless . (#1570)
• Updated the version of black to 22.3.0 in PlasmaPy's pre-commit configuration. This update included a formatting change where spaces around power operators were removed for sufficiently simple operands (e.g., a ** b → a**b). (#1582)
• Renamed units_definitions to _units_definitions and units_helpers to _units_helpers in plasmapy.utils to mark these modules as private. (#1587)
• Updated the codemeta.json file with metadata for the version 0.8.1 release. (#1606)

Plasmapy v0.7.0 (2021-11-18)

Backwards Incompatible Changes

• Removed alias tfds_ to plasmapy.dispersion.two_fluid_dispersion.two_fluid_dispersion_solution, with the reasoning behind the removal outlined in the pull request. (#1101)
• Removed the Tracker.synthetic_radiograph() method and created the standalone function ~plasmapy.diagnostics.charged_particle_radiography.synthetic_radiograph in its place. This new function takes either a ~plasmapy.diagnostics.charged_particle_radiography.Tracker object or a dictionary equivalent to ~plasmapy.diagnostics.charged_particle_radiography.Tracker.results_dict. (#1134)
• Renamed subpackage plasmapy.diagnostics.proton_radiography to plasmapy.diagnostics.charged_particle_radiography, and renamed the SyntheticProtonRadiograph class within that module to ~plasmapy.diagnostics.charged_particle_radiography.Tracker. (#1134)
• ~plasmapy.diagnostics.charged_particle_radiography.Tracker no longer supports making changes to an instantiated object and re-running the simulation. Subsequent simulations should be performed by instantiating a new ~plasmapy.diagnostics.charged_particle_radiography.Tracker object and running its simulation. (#1134)
• For ~plasmapy.plasma.grids.CartesianGrid the ~plasmapy.plasma.grids.CartesianGrid.volume_averaged_interpolator now returns numpy.nan values for any interpolation not bounded by the grid points. (#1173)
• Renamed file two_fluid_dispersion.py to two_fluid_.py and moved it into the plasmapy.dispersion.analytical subpackage. The function two_fluid_dispersion_solution() contained within that file was renamed to ~plasmapy.dispersion.analytical.two_fluid_.two_fluid. (#1208)
• Changed so that if it is provided with no arguments, then it creates an empty . This behavior is analogous to how list and tuple work. (#1223)
• Changed the behavior of in equality comparisons. Comparing a with an object that is not particle-like will now return False instead of raising a TypeError. (#1225)
• Changed the behavior of ~plasmapy.particles.particle_class.CustomParticle so that it returns False when compared for equality with another type. Previously, a TypeError was raised. (#1315)

Deprecations and Removals

• In plasmapy.particles, use of the term "integer charge" has been deprecated in favor of the term "charge number". The ~plasmapy.particles.particle_class.Particle.integer_charge attribute of has been deprecated in favor of ~plasmapy.particles.particle_class.Particle.charge_number. The ~plasmapy.particles.ionization_state.IonicLevel.integer_charge attribute of (formerly IonicFraction) has been deprecated in favor of ~plasmapy.particles.ionization_state.IonicLevel.charge_number. The ~plasmapy.particles.ionization_state.IonizationState.integer_charges attribute of has been deprecated in favor of ~plasmapy.particles.ionization_state.IonizationState.charge_numbers. (#1136)
• The particle attribute of has been removed after having been deprecated in 0.6.0. (#1146)
• Use more generalized keyword argument T instead of T_i in plasmapy.formulary.parameters.gyroradius. The T_i argument has been deprecated and will be removed in a subsequent release. (#1210)

Features

• Add the ~plasmapy.particles.ionization_state.IonizationState.average_ion method to . (#1028)
• Added the ~plasmapy.particles.ionization_state_collection.IonizationStateCollection.average_ion method to . (#1028)
• Added the plasmapy.formulary.mathematics.Chandrasekhar_G function, which is helpful in neoclassical transport theory. This change was reverted in #1233. (#1084)
• Enabled slicing of instances to return a list of instances. (#1130)
• instances can now be compared to an of a different element without raising an exception. (#1130)
• Allowed len to be used on instances. (#1130)
• and now accept an additional, optional ion temperature argument for each of the ionic levels. (#1130)
• Added the ~plasmapy.diagnostics.charged_particle_radiography.Tracker.save_results method to ~plasmapy.diagnostics.charged_particle_radiography.Tracker for saving results to the .npz file format (see numpy.lib.format for details on the file format). (#1134)
• Added the plasmapy.utils.decorators.deprecation module. The module includes ~plasmapy.utils.decorators.deprecation.deprecated, which is a decorator that is based on astropy.utils.decorators.deprecated. (#1136)
• Created the ~plasmapy.particles.ionization_state.IonizationState.to_list method of to provide a instance that contains the different ionic levels. (#1154)
• The behavior of the function plasmapy.formulary.parameters.gyroradius has been changed. If numpy.nan values are provided for T_i or Vperp, then instead of raising a slightly misleading error, numpy.nan in the appropriate units is returned. (#1187)
• Added the ~plasmapy.particles.particle_collections.ParticleList.average_particle method to . This method returns a particle with the mean mass and charge of the . The use_rms_charge and use_rms_mass keyword arguments make this method calculate the root mean square charge and mass, respectively. The abundances keyword argument allows the calculation of the mean or root mean square to be weighted. (#1204)
• Restructured the plasmapy.dispersion subpackage by creating the ~plasmapy.dispersion.analytical subpackage to contain functionality related to analytical dispersion solutions. (#1208)
• Implemented __eq__, __ne__ and __hash__ to allow instances to be used as dict keys. (#1216)
• Added the ~plasmapy.particles.particle_collections.ionic_levels function to create a initialized with different ionic levels of an element or isotope. (#1223)

Bug Fixes

• Made instances pickleable. (#1122)
• Fixed the behavior of plasmapy.formulary.mathematics.Chandrasekhar_G at very small and very large argument values. This change was reverted in #1233. (#1125)
• Running ~plasmapy.diagnostics.charged_particle_radiography.synthetic_radiograph with the keyword optical_density=True will now return numpy.inf where the source profile intensity is zero. Previously, an incorrect value was returned since zero entries were replaced with values of 1 before taking the logarithm. (#1134)
• Fixed a bug in the volume-averaged interpolator for ~plasmapy.plasma.grids.CartesianGrid (~plasmapy.plasma.grids.CartesianGrid.volume_averaged_interpolator). The old method miss interpreted where the interpolation point was inside the nearest neighbor cell volume. So, if an interpolation point was at the lower bounds of the nearest neighbor cell volume, then the position was flipped and interpreted as being at the upper bounds of the cell volume, and visa-versa. (#1173)
• Fixed the normalization of the wavevector in the Thomson spectral density function, ~plasmapy.diagnostics.thomson.spectral_density. The previous version was not properly normalizing the wavevector to unity. (#1190)
• Reverted most of #1084 and #1125, removing our implementation of the Chandrasekhar G function (for now!). This function may get brought back at a later date, once we have an implementation we numerically trust. (#1233)

Improved Documentation

• Improved consistency of documentation style and made reST fixes in several subpackages. (#1073)
• Added a pre-release section to the release guide. This section now includes steps for having a feature freeze about a week before the release, followed by a code freeze about two days before the release. (#1081)
• Created the Sphinx extension package plasmapy_sphinx and used it to replace sphinx_automodapi. plasmapy_sphinx creates directives :rstautomodapi and :rstautomodsumm to replace the same directives defined by sphinx_automodapi. The documentation was updated so the slight syntax differences in the newly defined directives will still render the same as before. (#1105)
• The term "integer charge" has been replaced in the documentation with the term "charge number". (#1136)
• Implemented a framework to define and use common Sphinx substitutions <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html #substitutions>__ across the narrative documentation and docstrings. These substitutions are defined in docs/common_links.rst. (#1147)
• Began a project glossary at docs/glossary.rst. (#1149)
• Changed the default branch name to main. Locations in the code and documentation that referred to the default branch of PlasmaPy (and certain other packages) were changed to reflect the new name (including, for example, in the development guide in the documentation). (#1150)
• Updated information on how to write and build documentation in the development guide. (#1156)
• Updated information on how to write and run tests in the contributor guide. (#1163)
• Created an outline of a page in the development guide to describe the workflow required to contribute to PlasmaPy. (#1178)
• Added brief description about the physics of the upper-hybrid resonance to the docstring of the function plasmapy.formulary.parameters.upper_hybrid_frequency. (#1180)
• Added a brief description about the physics of the lower-hybrid resonance to the docstring of the function plasmapy.formulary.parameters.lower_hybrid_frequency. (#1181)
• Made the function plasmapy.formulary.parameters.gyrofrequency more general by removing the indications that it might only work for ions. (#1183)
• Make plasmapy.analysis.fit_functions.AbstractFitFunction.FitParamTuple a property to fix the documentation build warning caused by the release of Sphinx v4.1.0. (#1199)
• Included a step in the release guide to update Binder requirements so that the release of PlasmaPy on PyPI gets installed when opening example notebooks from the stable and release branches of the online documentation. (#1205)
• Updated the documentation guide to include updates to tox environments for building the documentation. (#1206)
• Fixed numerous broken reST links in prior changelogs. (#1207)
• Improve the docstring for plasmapy.online_help. (#1213)
• Renamed "Development Guide" to "Contributor Guide", and temporarily removed the incomplete docs/development/workflow.rst from the toctree of the Contributor Guide. (#1217)
• Fixed a typo in the docstring of plasmapy.formulary.parameters.Alfven_speed. (#1218)
• Fixed broken reST links in docstrings for aliases in plasmapy.formulary. (#1238)
• Fixed multiple broken and redirected links. (#1257)
• Updated the documentation guide to include a description on how to add and cite references to PlasmaPy's global bibliography BibTeX file, docs/bibliography.bib. (#1263)
• Added sphinxcontrib-bibtex as a Sphinx extension to enable references to be stored in a BibTeX file. (#1263)
• Began a documentation-wide bibliography page. (#1263)
• Updated documentation guide to describe where formulae should go in docstrings and how to use glossary entries. (#1264)
• Updated and fixed hyperlinks in the documentation. (#1267)
• Adopted the "xcode" code highlighting style for pygments to increase color contrast and improve web accessibility. (#1268)
• Updated the feedback and communication page. (#1272)
• Updated the requirements for the documentation build to include no restrictions on docutils and sphinx_rtd_theme >= 1.0.0. docutils == 0.17 is not compatible with sphinx_rtd_theme < 1.0 (see #1107 and #1230). (#1275)
• Added a screenshot of the link for the Read the Docs preview of the documentation for a pull request. (#1298)
• Incorporated citations in the ~plasmapy.dispersion.analytical.two_fluid_.two_fluid docstring into the PlasmaPy bibliography framework. (#1301)

Trivial/Internal Changes

• Simplified handling of package dependencies. Removed duplicated requirements files and centralized them instead. Developer dependencies can now be installed with either pip install plasmapy[developer] or pip install -r requirements.txt. (#789)
• Reconfigured flake8 settings in CI. (#1062)
• Added pydocstyle to continuous integration (CI), to hopefully make writing prettier docstrings easier. (#1062)
• Added flake8-rst-docstrings to catch reST formatting errors in documentation in the linter stage of
  101. (#1062)
• Added pytest-regressions to testing dependencies, to make regression tests a little easier to write. (#1084)
• Fixed a minor error in the E × B drift notebook. (#1088)
• Upgrade nbqa to latest available version (0.6.0). (#1104)
• Moved our custom pre-commit style testing suite to pre-commit.ci, taking advantage of the new pre-commit.ci autofix command that allows manually calling for pre-commit to be run by typing that command as a comment to a pull request. (#1106)
• Added tests using hypothesis. (#1125)
• Added to setup.cfg the configuration flake8.per-file-ignores=plasmapy/formulary/__init__.py:F403 to ignore warnings resulting from imports like from xx import *. (#1127)
• Re-enabled several flake8 checks by removing the following codes from the flake8.extend-ignore configuration in setup.cfg: D100, D102, D103, D104, D200, D210, D301, D401, D407, D409, D412, E712, E713, F403, F541, RST213, RST306, and RST902. Addressed any failed linter checks from this modification. (#1127)
• ~plasmapy.diagnostics.charged_particle_radiography.synthetic_radiograph now determines the default detector size to be the smallest detector plane centered on the origin that includes all particles. (#1134)
• Added ion velocity input to the thomson.ipynb diagnostics notebook. (#1171)
• Added tox and removed pytest as extra requirements. (#1195)
• Updated tox test environments for building the documentation. Added the build_docs_nitpicky environment to check for broken reST links. (#1206)
• Added the --keep-going flag to the build_docs* tox environments with the -W option so that test failures will not stop after the first warning (that is treated as an error). (#1206)
• Make queries to plasmapy.online_help for "quantity" or "quantities" redirect to the help page for astropy.units (which was already the case for "unit" and "units"). (#1213)
• Bumped the Python version for Read the Docs builds from 3.7 to 3.8. (#1248)
• Refactored plasmapy/dispersion/tests/test_dispersion.py to use hypothesis for property based testing. (#1249)
• Defined redirects to allow and anchors to avoid checking when using Sphinx to verify that hyperlinks are correct via make linkcheck. (#1267)
• Replaced usage of eval inside with getattr. (#1280)
• Added using dlint to the linters testing environment in tox.ini as a static analysis tool to search for security issues. (#1280)
• Enabled using flake8-use-fstring in the linters testing environment in tox.ini to enforce usage of formatted string literals (f-strings). (#1281)
• Switched usage of str.format to formatted string literals (f-strings) in several files. (#1281)
• Added flake8-absolute-import to the linters tox environment. (#1283)
• Removed unused imports, and changed several imports from relative to absolute. (#1283)
• Added pre-commit hooks to auto-format .ini, .toml, and .yaml files, and applied changes from those hooks to existing files. (#1284)
• Changed the validated units for the theta input argument of ~plasmapy.dispersion.analytical.two_fluid_.two_fluid from degrees to radians. (#1301)
• Replaced usage of distutils.version.StrictVersion with packaging.version.Version because distutils has been deprecated. As part of this change, packaging has been added as a dependency. (#1306)
• Increased the minimum version of matplotlib to 3.3.0 and updated plasmapy.diagnostics.langmuir.swept_probe_analysis to be compatible with matplotlib 3.5.0. (#1334)

Plasmapy v0.6.0 (2021-03-14)

Backwards Incompatible Changes

• The State namedtuple was changed to the ~plasmapy.particles.IonicFraction class. (Note: #1046 subsequently changed that to ~plasmapy.particles.IonicLevel). (#796)
• Now, when the ~plasmapy.particles.IonizationState class is provided with an ion, the ionic fraction for that ion is set to 100% for the corresponding element or isotope. (#796)
• AtomicError was renamed to ~plasmapy.particles.exceptions.ParticleError and MissingAtomicDataError was renamed to ~plasmapy.particles.exceptions.MissingParticleDataError. (#796)
• In plasmapy.particles, the IonizationStates class was renamed to ~plasmapy.particles.IonizationStateCollection. Argument n of IonizationStates was changed to n0 in ~plasmapy.particles.IonizationStateCollection. (#796)
• Moved and refactored error message formatting functionality from plasmapy.utils.error_messages to plasmapy.utils.code_repr. (#920)
• Renamed the available "methods" for computing the Coulomb logarithm in an attempt to make the names more explicit. This is implemented using the method keyword for functions ~plasmapy.formulary.collisions.coulomb.Coulomb_logarithm and ~plasmapy.formulary.collisions.lengths.impact_parameter, and then propagated throughout the functionality in plasmapy.formulary.collisions. (#962)
• Add dependency pandas >= 1.0.0. Modify _ dependency to be xarray >= 0.14.0. (#963)
• The ~plasmapy.plasma.grids.AbstractGrid property ~plasmapy.plasma.grids.AbstractGrid.grid is now dimensioned (has units) and cannot be accessed if all dimensions do not share the same units. (#981)
• Renamed attribute is_uniform_grid on ~plasmapy.plasma.grids.AbstractGrid to is_uniform. (#981)
• Drop Python 3.6 support. (#987)
• The __getitem__ method of ~plasmapy.plasma.grids.AbstractGrid now returns a ~astropy.units.Quantity array instead of a reference to a xarray.DataArray. (#1027)
• Renamed IonicFraction to ~plasmapy.particles.ionization_state.IonicLevel. This lays groundwork for future changes, where that class is going to become more than a fraction. (#1046)

Deprecations and Removals

• The particle attribute of ~plasmapy.particles.particle_class.Particle has been deprecated in favor of the new symbol attribute. The particle attribute now issues a FutureWarning to indicate that it will be removed in a future release. (#984)

Features

• Created the ~plasmapy.simulation.abstractions.AbstractNormalizations class to serve as an abstract interface for future classes that represent normalizations. (#859)
• Create the analysis sub-package plasmapy.analysis.swept_langmuir for analysis code related to analyzing swept Langmuir traces. Sub-package is initiated with functionality for calculating the floating potential, ~plasmapy.analysis.swept_langmuir.floating_potential.find_floating_potential. (#889)
• Added a proton radiography diagnostic module containing a tool for generating synthetic proton radiographs from simulated or calculated fields using a particle tracking algorithm. (#895)
• Created new grid objects for representing plasma quantities as functions of space. (#909)
• Added functions in plasmapy.utils.code_repr to reproduce strings that represent a call to a method or attribute of an object. These functions are used, for example, in error messages. (#920)
• Add the function ~plasmapy.dispersion.two_fluid_dispersion.two_fluid_dispersion_solution to plasmapy.dispersion, which gives an analytical solution to the dispersion relation as derived by P. M. Bellan 2012 (DOI: 10.1029/2012JA017856). (#932)
• Refactor out the ~plasmapy.simulation.particle_integrators.boris_push tracking integrator algorithm from ~plasmapy.simulation.particletracker.ParticleTracker. (#953)
• For plasmapy.plasma.grids functionality, add better support for recognizing and handling physical quantities (e.g. spatial position, magnetic field, etc.) added to a grid object. (#963)
• For plasmapy.plasma.grids functionality, improve interpolation performance on non-uniform grids. (#963)
• Added the ~plasmapy.formulary.drifts.diamagnetic_drift function to ~plasmapy.formulary.drifts. (#966)
• Add properties ~plasmapy.plasma.grids.AbstractGrid.grid_resolution and ~plasmapy.plasma.grids.AbstractGrid.quantities to ~plasmapy.plasma.grids.AbstractGrid. (#981)
• Make several speed improvements to the functionality in ~plasmapy.plasma.grids, including the addition of keyword persistent to ~plasmapy.plasma.grids.AbstractGrid (and child class) methods ~plasmapy.plasma.grids.AbstractGrid.nearest_neighbor_interpolator and ~plasmapy.plasma.grids.AbstractGrid.volume_averaged_interpolator. This keyword allows the interpolators to assume the last grid setup and contents if input arguments have not changed. (#981)
• Add methods ~plasmapy.plasma.grids.AbstractGrid.on_grid and ~plasmapy.plasma.grids.AbstractGrid.vector_intersects to ~plasmapy.plasma.grids.AbstractGrid. (#981)
• The ~plasmapy.particles.particle_class.Particle class now contains an attribute named symbol that is intended to replace particle. The symbol attribute has been added as a property to ~plasmapy.particles.particle_class.AbstractParticle, ~plasmapy.particles.particle_class.CustomParticle, and ~plasmapy.particles.particle_class.DimensionlessParticle. (#984)
• Added new can_be_zero check parameter to ~plasmapy.utils.decorators.checks.CheckValues and its dependents ( ~plasmapy.utils.decorators.checks.check_values, ~plasmapy.utils.decorators.validators.ValidateQuantities, ~plasmapy.utils.decorators.validators.validate_quantities). (#999)
• Both plasmapy.particles.CustomParticle and plasmapy.particles.DimensionlessParticle now allow users to define a custom symbol via the symbol keyword argument, which can then be accessed by the symbol attribute in each of these classes. (#1015)
• The greater than (>) operator can now be used between ~plasmapy.particles.Particle and/or ~plasmapy.particles.ParticleList instances to get the nuclear reaction energy. (#1017)
• Create plasmapy.particles.ParticleList as a list-like collection for instances of plasmapy.particles.Particle and plasmapy.particles.CustomParticle. Adding ~plasmapy.particles.Particle and/or ~plasmapy.particles.CustomParticle instances will now create a ~plasmapy.particles.ParticleList. (#1017)
• Added method ~plasmapy.plasma.grids.AbstractGrid.require_quantities to ~plasmapy.plasma.grids.AbstractGrid that verifies a list of quantities is present on the grid. Method is also incorporated into ~plasmapy.diagnostics.proton_radiography.SyntheticProtonRadiograph. (#1027)
• Added the ~plasmapy.diagnostics.proton_radiography.SyntheticProtonRadiograph.add_wire_mesh() method to ~plasmapy.diagnostics.proton_radiography.SyntheticProtonRadiograph to allow the creation of synthetic proton radiographs that include a wire mesh reference grid. (#1049)
• Created a function, ~plasmapy.formulary.mathematics.rot_a_to_b, that calculates the rotation matrix that will rotate one 3D vector onto another. (#1054)
• Made ~plasmapy.plasma.grids.AbstractGrid.is_uniform a properly-documented public attribute of ~plasmapy.plasma.grids.AbstractGrid. (#1072)

Bug Fixes

• Fixed a minus sign bug in the Particle Tracker simulation that caused the E×B drift to go in the incorrect direction. (#953)
• Bugfix plasmapy.analysis.fit_functions.Linear.root_solve to handle the case where the slope is zero and no finite roots exist. (#959)
• Fixed a bug that prevented nested iterations of a single ~plasmapy.particles.IonizationState or ~plasmapy.particles.IonizationStateCollection instance. (#1025)
• Fixed a bug in grids.py for non-uniform grids that arose when _ upgraded to v0.17.0 (#1027)
• In ~plasmapy.diagnostics.proton_radiography.SyntheticProtonRadiograph, adaptive dt now calculates the cyclotron period using the provided particle charge and mass (previously assumed protons). (#1035)
• In ~plasmapy.diagnostics.proton_radiography.SyntheticProtonRadiograph, the adaptive timestep algorithm now works when particles are provided using ~plasmapy.diagnostics.proton_radiography.SyntheticProtonRadiograph.load_particles. (#1035)
• In ~plasmapy.diagnostics.proton_radiography.SyntheticProtonRadiograph, removed highly deflected particles so the call of ~plasmapy.diagnostics.proton_radiography.SyntheticProtonRadiograph.max_deflection does not raise an exception. (#1035)

Improved Documentation

• Add narrative documentation on ionization state functionality. (#796)
• Added description to plasmapy.formulary.parameters.Hall_parameter signature and equation in docstrings. (#934)
• Updated documentation for the plasmapy.particles and plasmapy.utils subpackages. (#942)
• Improves documentation of plasmapy/formulary/quantum.py by cleaning up docstrings of contained functionality. (#951)
• Update all docstrings associated with computing the Coulomb logarithm and the possible methods of calculation. (#962)
• Add two Jupyter notebooks for functionality contained in `plasmapy.plasma.grids`: grids_cartesian.ipynb and grids_nonuniform.ipynb. (#963)
• Added the ExB drift notebook, which demonstrates the analytical solution for the drift and the implementation of the corresponding formulary drift functions, ~plasmapy.formulary.drifts.force_drift and ~plasmapy.formulary.drifts.ExB_drift. (#971)
• Describe what constitutes a valid representation of a particle in the docstring for the plasmapy.particles.particle_class.ParticleLike typing construct. (#985)
• Put the docstring for plasmapy.particles.Particle.is_category into numpydoc format. (#1039)
• Adds formulas (which were missing) to the docstrings of plasmapy.formulary.dimensionless.quantum_theta and ~plasmapy.formulary.dimensionless.beta. (#1041)
• Add live rendering of changelog entries on documentation builds, based on sphinx-changelog. (#1052)
• Created an example notebook demonstrating how the ~plasmapy.diagnostics.proton_radiography.SyntheticProtonRadiograph class can be used to generate synthetic proton radiographs with arbitrary source profiles. Add code documentation links to all proton radiograph notebooks. (#1054)
• Update formatting and broken sphinx.ext.intersphinx links in plasmapy.formulary docstrings. (#1058)
• Make minor fixes in plasmapy.particles docstrings. (#1064)
• Organize the layout of the example Jupyter notebooks on the Read the Docs example page. (#1066)
• Fix formatting and broken sphinx.ext.intersphinx links in docstrings in various places in the code base. Improve installation instructions in the docs; the subpackage stability matrix, and funding acknowledgments. (#1076)

Trivial/Internal Changes

• Removed colorama as a dependency. (#920)
• Moved remaining CI from CircleCI to GitHub Actions. (#996)
• Add notebook CI through nbqa. (#997)
• Remove lambda expressions from plasmapy.particles and plasmapy.utils. (#1013)
• Add unicode particle aliases for electrons ("β-", "β⁻"), muons ("μ-", "μ⁻"), anti-muons ("μ+", "μ⁺"), tau particles ("τ", "τ-", "τ⁻"), anti-tau particles ("τ+", "τ⁺") electron neutrinos ("ν_e"), muon neutrinos ("ν_μ"), tau neutrinos ("ν_τ"), and alpha particles ("α"). (#1036)
• A set containing all valid particle categories may now be accessed via plasmapy.particles.Particle.is_category.valid_categories. (#1039)
• Properly handled warnings in test_proton_radiography.py (#1050)

Plasmapy v0.5.0 (2020-12-09)

Backwards Incompatible Changes

• Created plasmapy.dispersion in accordance with PlasmaPy Enhancement Proposal 7 (PLEP 7) and migrated the dispersion functionality (dispersionfunction.py) from plasmapy.formulary to plasmapy.dispersion. (#910)
• Removed default values for the ion and particle arguments of functions contained in plasmapy.formulary.parameters, in accordance with issue [#453](#453), and updated all relevant calls to modified functionality. (#911)
• Moved test helper exceptions from plasmapy.utils.pytest_helpers to plasmapy.tests.helpers. (#919)
• Update plasmapy.formulary.parameters.mass_density so it calculates the mass density for a specific particle from a given number density. Original function calculated the total mass density (ion + electron). (#957)

Features

• Added a function to calculate the power spectrum of thermal bremsstrahlung emitted by a Maxwellian plasma. (#892)
• Added support for multiple electron components to diagnostics.thomson.spectral_density. Also fixed a bug for multiple ion populations. (#893)
• Add dependency pygments >= 2.4.1. (#898)
• Create the plasmapy.analysis package as per PLEP-7 and initialize the package with the ~plasmapy.analysis.fit_functions module. Fit functions are designed to wrap together an analytical function, a curve fitter, uncertainty propagation, and a root solver to make curve fitting a little less painful. (#908)
• Created a new subpackage, plasmapy.tests.helpers, to contain test helper functionality. (#919)
• Create decorator ~plasmapy.utils.decorators.helpers.modify_docstring, which allows for programmatically prepending and/or appending a docstring. (#943)

Bug Fixes

• Allowed implicit conversions of AstroPy units in inputs and outputs of validated functions to happen without warnings. Most notably, this removes warnings on eV inputs to temperature fields. (#886)
• Update plasmapy.formulary.parameters.Alfven_speed to properly use the updated plasmapy.formulary.parameters.mass_density and maintain the same behavior. Also add handling of the ion input keyword, so and the convertible representations can be used as inputs. (#957)

Improved Documentation

• Improved the release guide after the release of 0.4.0. (#872)

• Add various improvements to the documentation.

  • Replace home link with the plasmapy logo.
  • Add module and index navigation links to sidebar header.
  • Replace raw html on the main page that simulates a nbgallery with a real nbgallery directive.
  • Move link to view page source code from the header to footer.
  • Add link to footer the jumps the user back to the top of the page.
  • Create and add custom CSS stylesheet.
  • Create _templates directory and templates to customize page elements. (#875)

• Add static stub files to docs/api_static so all modules of plasmapy are indexed. This is necessary to expose all of plasmapy since not all modules are indexed in the narrative documentation. (#878)
• Decompose sub-package plasmapy/utils/roman/ into the plasmapy/utils/roman.py file. Move definition of roman specific Exceptions into plasmapy.utils.exceptions. (#883)
• Replaced references to Riot.im with references to Element.io or Matrix, as appropriate, following their recent rebranding. (#891)
• Update the information on how to cite PlasmaPy, including in the release guide. (#900)

Trivial/Internal Changes

• Apply isort to entire codebase, bringing it back to the pre-commit hook suite. (#857)
• Expand package metadata contained in codemeta.json, following the CodeMeta standard. (#902)
• Changed remaining instances of @u.quantity_input to @validate_quantities in response to issue #880. (#905)
• Switched from Azure Pipelines to GitHub Actions for PR tests to make things easier for contributors. Moved away from Travis CI for test cron jobs. (#952)

Plasmapy v0.4.0 (2020-07-20)

Backwards Incompatible Changes

• Rename plasmapy.atomic to ~plasmapy.particles. In ~plasmapy.formulary.collisions and ~plasmapy.formulary.braginskii, change arguments named particles to species and arguments named ion_particle to ion for multiple functions. (#742)
• Officially delete plasmapy.examples. (#822)
• Move plasmapy.data to plasmapy.particle.data. (#823)
• Renamed the plasmapy.classes subpackage to plasmapy.plasma. (#842)

Features

• Added units to reprs of .formulary.magnetostatics classes. (#743)
• Create prototype abstract interfaces for plasma simulations (#753)
• Created classes to represent custom and dimensionless particles in plasmapy.particles. (#755)
• Create ~plasmapy.formulary.relativity.relativistic_energy function, which uses the established ~plasmapy.formulary.relativity.Lorentz_factor function to aid in the calculation of the relativistic energy of an object. (#805)
• Create ~plasmapy.formulary.dimensionless.Reynolds_number function. (#815)
• Create ~plasmapy.formulary.dimensionless.Mag_Reynolds function. (#820)
• Create plasmapy.formulary.parameters.Bohm_diffusion function. (#830)
• Added a new diagnostics module thomson containing a function spectral_density that calculates Thomson scattering spectra for Maxwellian plasmas in both the collective and non-collective regimes. As a followup to PR #835, set the minimal required Numpy version to 1.18.1 to finally fix unit dropping bugs. (#831)
• Revised parameters.thermal_speed to support 1D and 2D distributions as well as 3D, and added an example notebook for this function. (#850)
• Create plasmapy/formulary/ionization.py Create ~plasmapy.formulary.ionization.Z_bal function. (#851)
• Create ~plasmapy.formulary.ionization.Saha function. (#860)

• Added aliases (with trailing underscores) for parameters in the formulary:

  • plasmapy.formulary.dimensionless.Reynolds_number -> ~plasmapy.formulary.dimensionless.Re_
  • plasmapy.formulary.dimensionless.Mag_Reynolds -> ~plasmapy.formulary.dimensionless.Rm_
  • plasmapy.formulary.drifts.ExB_drift -> ~plasmapy.formulary.drifts.veb_
  • plasmapy.formulary.drifts.force_drift -> ~plasmapy.formulary.drifts.vfd_
  • plasmapy.formulary.parameters.mass_density -> plasmapy.formulary.parameters.rho_
  • plasmapy.formulary.parameters.Afven_speed -> plasmapy.formulary.parameters.va_
  • plasmapy.formulary.parameters.ion_sound_speed -> plasmapy.formulary.parameters.cs_
  • plasmapy.formulary.parameters.thermal_speed -> plasmapy.formulary.parameters.vth_
  • plasmapy.formulary.parameters.thermal_pressure -> plasmapy.formulary.parameters.pth_
  • plasmapy.formulary.parameters.kappa_thermal_speed -> plasmapy.formulary.parameters.vth_kappa_
  • plasmapy.formulary.parameters.inertial_length -> plasmapy.formulary.parameters.cwp_
  • plasmapy.formulary.parameters.Hall_parameter -> plasmapy.formulary.parameters.betaH_
  • plasmapy.formulary.parameters.gyrofrequency -> plasmapy.formulary.parameters.oc_, plasmapy.formulary.parameters.wc_
  • plasmapy.formulary.parameters.gyroradius -> plasmapy.formulary.parameters.rc_, plasmapy.formulary.parameters.rhoc_
  • plasmapy.formulary.parameters.plasma_frequency -> plasmapy.formulary.parameters.wp_
  • plasmapy.formulary.parameters.Debye_length -> plasmapy.formulary.parameters.lambdaD_
  • plasmapy.formulary.parameters.Debye_number -> plasmapy.formulary.parameters.nD_
  • plasmapy.formulary.parameters.magnetic_pressure -> plasmapy.formulary.parameters.pmag_
  • plasmapy.formulary.parameters.magnetic_energy_density -> plasmapy.formulary.parameters.ub_
  • plasmapy.formulary.parameters.upper_hybrid_frequency -> plasmapy.formulary.parameters.wuh_
  • plasmapy.formulary.parameters.lower_hybrid_frequency -> plasmapy.formulary.parameters.wlh_
  • plasmapy.formulary.parameters.Bohm_diffusion -> plasmapy.formulary.parameters.DB_
  • plasmapy.formulary.quantum.deBroglie_wavelength -> ~plasmapy.formulary.quantum.lambdaDB_
  • plasmapy.formulary.quantum.thermal_deBroglie_wavelength -> ~plasmapy.formulary.quantum.lambdaDB_th_
  • plasmapy.formulary.quantum.Fermi_energy -> ~plasmapy.formulary.quantum.Ef_ (#865)

• Add json_dumps method to ~plasmapy.particles.particle_class.AbstractParticle to convert a particle object into a JSON string. Add json_dump method to ~plasmapy.particles.particle_class.AbstractParticle to serialize a particle object and writes it to a file. Add JSON decoder ~plasmapy.particles.serialization.ParticleJSONDecoder to deserialize JSON objects into particle objects. Add plasmapy.particles.serialization.json_loads_particle function to convert JSON strings to particle objects (using ~plasmapy.particles.serialization.ParticleJSONDecoder). Add plasmapy.particles.json_load_particle function to deserialize a JSON file into a particle object (using ~plasmapy.particles.serialization.ParticleJSONDecoder). (#836)

Bug Fixes

• Fix incorrect use of pkg.resources when defining plasmapy.__version__. Add setuptools to package dependencies. Add a definition of __version__ for developers using source files. (#774)
• Repair notebook links that are defined in the nbsphinx_prolog sphinx configuration variable. (#828)
• Increase the required Astropy version from 3.1 to 4.0, Numpy from 1.14 to 1.16.6, Scipy from 0.19 to 1.2 and lmfit from 0.9.7 to 1.0.1. This fixes long-standing issues with Numpy operations dropping units from AstroPy quantities. (#835)

Improved Documentation

• • Added documentation to file test_converters (#756)
• • Updated installation instructions. (#772)
• Reorder documentation page (#777)
• Fix failing documentation build due to duplicate docstrings for ParticleTracker.kinetic_energy_history and incompatibility of sphinx-automodapi with sphinx v3.0.0. (#780)
• Automate definition of documentation release and version in docs/conf.py with plasmapy.__version__. (#781)
• Add a docstring to __init__.py in plasmapy.formulary. (#788)
• Replaced sphinx-gallery with nbsphinx, turning .py example files into .ipynb files and allowing for easier example submission. (#792)
• Linked various instances of classes and functions in the .ipynb examples in docs/notebooks/ to the respective API docs. (#825)
• Fixed a few documentation formatting errors. (#827)
• Add notes on the PlasmaPy benchmarks repository to documentation. (#841)
• Improve readability of the plasmapy.formulary page by replacing the toctree list with a cleaner reST table. (#867)

Trivial/Internal Changes

• Remove mutable arguments from Particle.is_category method. (#751)
• Remove all occurrences of default mutable arguments (#754)
• Handle ModuleNotFoundError when trying to import __version__ but setuptools_scm has not generated the version.py file. This commonly happens during development when plasmapy is not installed in the python environment. (#763)
• Updated pep8speaks/flake8 configuration and added .pre-commit-config.yaml to simplify automated style checks during development. (#770)
• Removes some lint from setup.py and setup.cfg. Use pkg_resources for version checking in code. Remove version.py file in favor of pkg_resources. (#771)
• Default settings for isort were set to be consistent with default settings for black. (#773)
• Update community meeting and funding information in docs. (#784)
• Improved pull request template to include more information about changelog entries. (#843)
• Added GitHub actions that apply pre-commit and flake8 (separately) to incoming pull requests. (#845)
• Apply pre-commit hooks to entire repository, so that GitHub actions do not shout at contributors needlessly. (#846)
• Update ~plasmapy.particles.particle_class.CustomParticle so input parameters mass and charge can accept string representations of astropy Quantities. (#862)

Plasmapy v0.3.0 (2020-01-25)

Backwards Incompatible Changes

• Create simulation subpackage; move Species particle tracker there; rename to particletracker (#665)
• Changed plasmapy.classes.Species to plasmapy.simulation.ParticleTracker (#668)
• Move pytest helper functionality from plasmapy.utils to ~plasmapy.utils.pytest_helpers (#674)
• Move plasmapy.physics, plasmapy.mathematics and plasmapy.transport into the common plasmapy.formulary subpackage (#692)
• Change ClassicalTransport methods into attributes (#705)

Deprecations and Removals

• Remove parameters_cython.pyx, switching to Numba for the future of computationally intensive code in PlasmaPy (#650)
• Remove plasmapy.constants, which was a thin wrapper around astropy.constants with no added value (#651)

Features

• Generalize ion_sound_speed function to work for all values of k²λ_D² (i.e. not just in the non-dispersive limit). (#700)
• Optimize add__magnetostatics for a 16x speedup in tests! (#703)

Bug Fixes

• Define preserve_signature decorator to help IDEs parse signatures of decorated functions. (#640)
• Fix Pytest deprecations of message argument to raise and warn functions. (#666)
• Fix h5py warning in OpenPMD module, opening files in read mode by default (#717)

Improved Documentation

• Added real-world examples to examples/plot_physics.py and adjusted the plots to be more human-friendly. (#448)
• Add examples images to the top of the main doc page in docsindex.rst (#655)

• Added exampes to the documentation to mass_density

  and Hall_parameter functions (#709)

• Add docstrings to decorator plasmapy.utils.decorators.converter.angular_freq_to_hz. (#729)

Trivial/Internal Changes

• Replace decorator plasmapy.utils.decorators.checks.check_quantity with decorator plasmapy.utils.decorators.validators.validate_quantities. Permanently delete decorator ~plasmapy.utils.decorators.checks.check_quantity and its supporting code. For functions plasmapy.formulary.quantum.chemical_potential and plasmapy.formulary.quantum._chemical_potential_interp, add a RaiseNotImplementedError due to bug outlined in issue #726. Associated pytests are marked with pytest.mark.xfails and doctests are marked with doctests: +SKIP. (#722)
• Add Towncrier automated changelog creation support (#643)
• Move existing "check" decorators to new plasmapy.utils.decorators module (#647)
• Allow running our sphinx-gallery examples as Jupyter notebooks via Binder (#656)
• Overhaul CI setup, following the example of SunPy (#657)
• Patch sphinx_gallery.binder to output custom links to Binder instance (#658)
• Remove the now unnecessary astropy_helpers submodule (#663)
• Followup PR to CI overhaul (#664)
• Add a Codemeta file (codemeta.json) (#676)
• Overhaul and simplify CI, add Python 3.8 to tests, bump minimal required package versions, fix docs. (#712)
• Update communication channels in docs (#715)
• Code style fixes to the atomic subpackage (#716)
• Clean up main package namespace, removing plasmapy.test (#718)
• Reduce precision of tests and doctests to allow for refinements of fundamental constants. (#731)
• Create decorators for checking/validating values and units of function/method input and return arguments. Defined decorators include ~plasmapy.utils.decorators.checks.check_values, ~plasmapy.utils.decorators.checks.check_units, and ~plasmapy.utils.decorators.validators.validate_quantities. These decorators are fully defined by "decorator classes" ~plasmapy.utils.decorators.checks.CheckBase, ~plasmapy.utils.decorators.checks.CheckValues, ~plasmapy.utils.decorators.checks.CheckUnits, and ~plasmapy.utils.decorators.validators.ValidateQuantities. (#648)
• Create a decorator to change output of physics functions from "radians/s" to "hz" (#667)
• Added pytest.mark.slow to pytest markers. Updated documentation to notify developers of functionality. (#677)