-
Notifications
You must be signed in to change notification settings - Fork 3
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
Clarification of the config
example
#172
Comments
That's a good point. I can definitely see why this is confusing. This is a semi-nonstandard usage and is mostly useful for running in a CI environment. We could just add a note in this example, but I wonder if it would be useful to add a separate section in the docs as well that gives a bit more background as to why things are done this way. I wonder too if the function |
Maybe having a how-to guide with the different options for configuring a simulation would be useful. This could include the following possible paths:
This guide could also include some basic rationale about when/why you would want to use each option as well as a little background as to what is actually happening in the configuration step. |
Yes, I think having explanations of a few different ways would certainly be helpful. There are also lots of options (numerics and physics), so a brief tutorial on changing things like radiative losses, or AMR options, etc., might also be useful. I think we've listed the variables in the docs, but a plot of, for example, the emissivity for different radiation options would really hammer home what they mean. |
I do not disagree though I would say this starts to stray into more of a user guide for HYDRAD itself. Ultimately, I do think it would be good to try and combine the existing user guide PDF with these docs (see #78). Maybe a good place to start would be seeing how much of the tutorial you propose is covered in the user guide and then starting to slowly incorporate that into a dedicated section of these docs. |
I'd like to suggest that the following snippet of the docs should be clarified a bit. It's not obvious to a few collaborators what the "clean" copy means, or how this relates to setting up simulations. I think the standard practice of most people who run HYDRAD is to make a copy of the directory for each simulation, but this isn't patently obvious to new users.
It would also be helpful to show an example where it points to a local copy, rather than just the download from Github.
The text was updated successfully, but these errors were encountered: