|
2 | 2 | History |
3 | 3 | ======= |
4 | 4 |
|
| 5 | +1.0.0 (2026-03-19) |
| 6 | +------------------ |
| 7 | + |
| 8 | +.. warning:: |
| 9 | + |
| 10 | + ``pyrato`` version 1.0.0 introduces several breaking changes which are not backwards compatible with prior versions. |
| 11 | + This includes changes in the module structure, and deprecations of functions that are now part of the ``pyfar`` v0.8 package. |
| 12 | + |
| 13 | + |
| 14 | +Breaking changes |
| 15 | +^^^^^^^^^^^^^^^^ |
| 16 | + |
| 17 | +- ``pyrato`` has been structured into the modules |
| 18 | + |
| 19 | + - ``pyrato.analytic`` containing analytic functions for room acoustics. |
| 20 | + - ``pyrato.dsp`` containing functions for low-level room impulse response processing. |
| 21 | + - ``pyrato.edc`` containing functions for computing Energy Decay Curves (EDC). |
| 22 | + - ``pyrato.parameters`` containing functions to compute room acoustical parameters from simple geometric considerations. |
| 23 | + - ``pyrato.parametric`` containing functions to compute room acoustical parameters from room impulse responses. |
| 24 | + |
| 25 | +- The following functions were removed and calling functions now use equivalent functions from pyfar |
| 26 | + |
| 27 | + - ``pyrato.dsp.find_impulse_response_start`` was removed in favor of ``pyfar.dsp.find_impulse_response_start``. |
| 28 | + - ``pyrato.dsp.center_frequencies_octaves`` and ``pyrato.dsp.center_frequencies_third_octaves`` were removed in favor of ``pyfar.constants.fractional_octave_frequencies_nominal``. |
| 29 | + - ``pyrato.dsp.filter_fractional_octave_bands`` was removed in favor of ``pyfar.dsp.filter.fractional_octave_bands``. |
| 30 | + - ``pyrato.dsp.time_shift`` was removed in favor of ``pyfar.dsp.time_shift``. |
| 31 | + - ``pyrator.parametric.air_attenuation_coefficient`` was removed in favor of ``pyfar.constants.air_attenuation``. |
| 32 | + - ``pyrato.parametric.calculate_speed_of_sound`` was removed in favor of multiple functions in ``pyfar.constants`` that can compute the speed of sound. |
| 33 | + |
| 34 | +- ``pyrato.dsp.truncate_energy_decay_curve`` was renamed to ``pyrato.dsp.threshold_energy_decay_curve```. |
| 35 | +- ``pyrato.parametric.reverberation_time_eyring`` was refactored for parameters to be more verbose and consistent with other functions in pyrato. |
| 36 | +- ``pyrato.parametric.calculate_sabine_reverberation_time`` was renamed to ``pyrato.parametric.reverberation_time_sabine`` and refactored for parameters to be more verbose and consistent with other functions in pyrato. |
| 37 | + |
| 38 | +Added: |
| 39 | +^^^^^^ |
| 40 | + |
| 41 | +- Room acoustic parameters according to ISO 3382 to ``pyrator.parameters`` |
| 42 | + |
| 43 | + - ``clarity`` to compute the clarity for arbitrary time limits including the standardized parameters C50 and C80. |
| 44 | + - ``early_lateral_energy_fraction`` to compute the ear lateral energy fraction J_LF. |
| 45 | + - ``late_lateral_sound_level`` to compute the late lateral sound level L_J |
| 46 | + - ``sound_strength`` to compute the sound sound_strength G. |
| 47 | + - ``speech_transmission_index_indirect`` and ``modulation_transfer_function`` to compute the STI based on impulse responses. |
| 48 | + |
| 49 | +- ``pyrato.edc.intersection_time_lundby`` can now process impulse response channels independently and by default raises a warning, if the computation fails for a specific channel. Before this update, it raised an error, even if the computation only failed for certain channels. |
| 50 | + |
| 51 | +Changed: |
| 52 | +^^^^^^^^ |
| 53 | + |
| 54 | +- ``pyrato.parametric.energy_decay_curve_analytic`` was refactored to take the desired reverberation time as input parameter. |
| 55 | +- Updated tests and package versions used for testing, as well as test fixtures. |
| 56 | + |
| 57 | +Documentation |
| 58 | +^^^^^^^^^^^^^ |
| 59 | +- Improved the scope and clarity of the documentation. |
| 60 | +- Added buttons to copy code contained in the documentation. |
| 61 | + |
| 62 | + |
5 | 63 | 0.4.1 (2024-06-05) |
6 | 64 | ------------------ |
7 | 65 | * fix: include analytic module in the package (PR #27) |
|
0 commit comments