Changelog¶

v0.5.1¶

Fixed a bug that was causing incorrect spectral binning when the frequency contribution is pure isotropic.

The to_dict_with_units() method is deprecated and is replaced with json()
The json() function returns a python dictionary object with minimal required keywords, where the event keys are globally serialized at the root method object. In the case where the event key value is different from the global value, the respective key is serialized within the event object.
The json() function will no longer serialize the transition_query objects for the named objects.

The update introduces various two-dimensional methods for simulating NMR spectrum.

Introduces a generic one-dimensional method, Method1D.
Introduces a generic two-dimensional method, Method2D.
Specialized two-dimensional methods for multi-quantum variable-angle spinning with build-in affine transformations.
Specialized two-dimensional methods for satellite-transition variable-angle spinning with build-in affine transformations.
- ST1_VAS,
- ST2_VAS,
Specialized two-dimensional isotropic/anisotropic sideband correlation method, SSB2D.

The get_transition_pathways() method no longer return a numpy array, instead a python list.

⭐ Improved simulation performance. ⭐ See our Benchmark.
New CzjzekDistribution and ExtCzjzekDistribution classes for generating Czjzek and extended Czjzek second-rank symmetric tensor distribution models for use in simulating amorphous materials.
New utility function, single_site_system_generator(), for generating a list of single-site spin systems from a 1D list/array of respective tensor parameters.

⭐ Improved simulation performance. ⭐ See our Benchmark.
Removed the Dimension class and added a new Method class instead.
New methods for simulating the NMR spectrum:
- BlochDecaySpectrum and
- BlochDecayCentralTransitionSpectrum.
The Bloch decay spectrum method simulates all p=Δm=-1 transition pathways, while the Bloch decay central transition selective spectrum method simulates all transition pathways with p=Δm=-1 and d=0.
New Isotope, Transition, and ZeemanState classes.
Every class now includes a reduced_dict() method. The reduced_dict method returns a dictionary with minimal key-value pairs required to simulate the spectrum. Note, this may cause metadata loss, if any.
Added a label and description attributes to the Site class.
Added a new label attribute to the SpinSystem class.
New SignalProcessor class for post-simulation signal processing.
Improved usage of least-squares minimization using python LMFIT package.
Added a new get_spectral_dimensions utility function to extract the spectral dimensions information from the CSDM object.

Fixed bug resulting from the rotation of the fourth rank tensor with non-zero euler angles.
Fixed bug causing a change in the spectral area as the sampling points change. Now the area is constant.
Fixed bug resulting in an incorrect spectrum when non-coincidental quad and shielding tensors are given.
Fixed bug causing incorrect generation of transition pathways when multiple events are present.

Renamed the decompose attribute from the ConfigSimulator class to decompose_spectrum. The attribute is an enumeration with the following literals:
- none: Computes a spectrum which is an integration of the spectra from all spin systems.
- spin_system: Computes a series of spectra each corresponding to a single spin system.
Renamed Isotopomer class to SpinSystem.
Renamed isotopomers attribute from Simulator class to spin_systems.
Renamed dimensions attribute from Simulator class to methods.
Changed the default value of name and description attribute from the SpinSystem class from "" to None.

Added more isotopes to the simulator. Source NMR Tables (https://apps.apple.com/bn/app/nmr-tables/id1030899609?mt=12).
Added two new keywords: atomic_number and quadrupole_moment.
Added documentation for every class.
Added examples for simulating NMR quadrupolar spectrum.

Fixed amplitude normalization. The spectral amplitude no longer change when the integration_density, integration_volume`, or the number_of_sidebands attributes change.