Skip to content

Conversation

@SitChri
Copy link

@SitChri SitChri commented Nov 5, 2025

Which issue(s) are closed by this pull request?

Closes #88. implementation of Schroeder frequency....

Changes proposed in this pull request:

  • new function in parametric submodule
  • extra good looking docstring

Copy link

@mjasins mjasins left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank You for Your brilliant contribution. We have spotted some minor changes, that You should make to match the project convention.

Parameters
----------
V : float, np.ndarray
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please follow the variable naming convention adopted in the project, i.e.:
volume (double) – Room volume
reverberation_time (double) - Reverberation Time of a room

function which calculates the Schroeder frequency. The cut-off
frequency for modes.
Approved by Monty Python Flying Circus.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We appreciate Your sense of humour, although this should be a serious scientific documentation.


def schroeder_frequency(V, T):
r"""
function which calculates the Schroeder frequency. The cut-off
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please, change the sentence to: Calculate the Schroeder cut-off frequency of a room

r"""
function which calculates the Schroeder frequency. The cut-off
frequency for modes.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add the source - the citation is broken

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice hint, but we don´t know how ... seems as broken as for energy_decay_curve_analytic function below.

Returns
-------
schroeder_freq : float, np.ndarray
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The documentation return statement does not match the actual return variable name. Please repair and change to schroeder_frequency according to convention

@mberz
Copy link
Member

mberz commented Nov 5, 2025

Hey, thanks for your contribution. Could you please update the title of the PR to be more concise?

@SitChri SitChri changed the title The Minisitry of Silly Coding introduces a new equation for computing… feature/add_schroeder_frequency_function Nov 5, 2025
@ahms5 ahms5 added the ASSA 2025 Issues and PRs related to the Open Source Software school at ASSA 2025 label Nov 5, 2025
@mberz mberz added the enhancement New feature or request label Nov 5, 2025
Copy link
Member

@ahms5 ahms5 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for your contribution. I already looks very good.
I have just one suggestion to raise errors if the input parameters are not as expected

.. [#] H. Kuttruff, Room acoustics, 4th Ed. Taylor & Francis, 2009.
"""

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

here we could raise error, if the input parameters of the function are not valid. See the Guidelines

Copy link

@JudithvE JudithvE left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for your kind pull request. We could not have done this better. 👍
Don't forget to add a validation check for the input parameters 😄

.. [#] H. Kuttruff, Room acoustics, 4th Ed. Taylor & Francis, 2009.
"""

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe you can do a validation check of the input parameters. For example, the volume needs to be greater than zero. 🔢

Copy link

@mjasins mjasins left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank You for the submission, the tests are really good.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ASSA 2025 Issues and PRs related to the Open Source Software school at ASSA 2025 enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants