Skip to content

Commit 8476f47

Browse files
committed
Update HISTORY.rst
1 parent 2ab1610 commit 8476f47

File tree

1 file changed

+58
-0
lines changed

1 file changed

+58
-0
lines changed

HISTORY.rst

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,64 @@
22
History
33
=======
44

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+
563
0.4.1 (2024-06-05)
664
------------------
765
* fix: include analytic module in the package (PR #27)

0 commit comments

Comments
 (0)