Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

added descriptions to all distribution input specs #2341

Merged
merged 2 commits into from
Jul 25, 2024

Conversation

PaulTalbot-INL
Copy link
Collaborator

@PaulTalbot-INL PaulTalbot-INL commented Jul 23, 2024


Pull Request Description

What issue does this change request address? (Use "#" before the issue to link it, i.e., #42.)

idaholab/HERON#372

What are the significant changes in functionality due to this change request?

Adds the input spec descriptions to all the Distribution objects in RAVEN, for use in dynamic manual compiling, particularly in HERON.


For Change Control Board: Change Request Review

The following review must be completed by an authorized member of the Change Control Board.

  • 1. Review all computer code.
  • 2. If any changes occur to the input syntax, there must be an accompanying change to the user manual and xsd schema. If the input syntax change deprecates existing input files, a conversion script needs to be added (see Conversion Scripts).
  • 3. Make sure the Python code and commenting standards are respected (camelBack, etc.) - See on the wiki for details.
  • 4. Automated Tests should pass, including run_tests, pylint, manual building and xsd tests. If there are changes to Simulation.py or JobHandler.py the qsub tests must pass.
  • 5. If significant functionality is added, there must be tests added to check this. Tests should cover all possible options. Multiple short tests are preferred over one large test. If new development on the internal JobHandler parallel system is performed, a cluster test must be added setting, in XML block, the node <internalParallel> to True.
  • 6. If the change modifies or adds a requirement or a requirement based test case, the Change Control Board's Chair or designee also needs to approve the change. The requirements and the requirements test shall be in sync.
  • 7. The merge request must reference an issue. If the issue is closed, the issue close checklist shall be done.
  • 8. If an analytic test is changed/added is the the analytic documentation updated/added?
  • 9. If any test used as a basis for documentation examples (currently found in raven/tests/framework/user_guide and raven/docs/workshop) have been changed, the associated documentation must be reviewed and assured the text matches the example.

@moosebuild
Copy link

Job Test Ubuntu 18-2 Python 3 on dcc932c : invalidated by @GabrielSoto-INL

@moosebuild
Copy link

Job Mingw Test on dcc932c : invalidated by @GabrielSoto-INL

Copy link
Collaborator

@GabrielSoto-INL GabrielSoto-INL left a comment

Choose a reason for hiding this comment

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

Very minor typos, but might as well fix them now...

See \url{https://docs.scipy.org/doc/scipy/reference/generated/scipy.stats.triang.html} for more details.
"""
inputSpecification.addSub(InputData.parameterInputFactory("min",
descr=r"""lower domain boundary of this distribution, referred to as $a$ in euqation form.""",
Copy link
Collaborator

Choose a reason for hiding this comment

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

small typo in descr here, same in line 1206 for the max parameter

@@ -1433,7 +1537,14 @@ class cls.
specifying input of cls.
"""
inputSpecification = super(Bernoulli, cls).getInputSpecification()
inputSpecification.addSub(InputData.parameterInputFactory("p", contentType=InputTypes.FloatType))
inputSpecification.description = r"""classical Bournoulli discrete distribution. The probability mass function for the
Copy link
Collaborator

Choose a reason for hiding this comment

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

small typo for the distribution name here


DataFilenameParameterInput = InputData.parameterInputFactory("dataFilename", contentType=InputTypes.StringType)
DataFilenameParameterInput.addParam("type", InputTypes.StringType, True)
inputSpecification.description = r"""Custom user-defined N-diminsional distribution. This allows empirically-defined
Copy link
Collaborator

Choose a reason for hiding this comment

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

small typo in N-dimensional

TransformationParameterInput = InputData.parameterInputFactory("transformation")
RankParameterInput = InputData.parameterInputFactory("rank", contentType=InputTypes.IntegerType)
inputSpecification.description = r"""describes a N-dimensional multivariate Gaussian normal distribution.
This generalizes the univariate nurmal distribution to higher dimensions. The multivariate normal
Copy link
Collaborator

Choose a reason for hiding this comment

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

small typo in "univariate normal distribution"

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

it becomes clear to me that I rely a lot on spellcheckers flagging my mistakes in text! However, for visibility reasons I disabled it for code. Do you know a way to convince it only to spellcheck within text by chance?

Thanks for finding all of these.

Copy link
Collaborator

Choose a reason for hiding this comment

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

I don't know of any really smart ones that can identify when you're formatting strings or something like that, unfortunately. I think the "Code Spell Checker" extension in VS Code looks pretty good, but could see it getting annoying, like you mentioned.

Copy link
Collaborator

@GabrielSoto-INL GabrielSoto-INL left a comment

Choose a reason for hiding this comment

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

Changes are good. Thanks for fixing them!

@GabrielSoto-INL GabrielSoto-INL merged commit f7bc5a6 into idaholab:devel Jul 25, 2024
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants