Closed wimvanderbauwhede closed 3 years ago
Thanks for the feedback! I'd be happy to create a PR that addresses how to clone and clarify the prerequisites section for cases when singularity is not used. With regards to the installation of Singularity I am not sure -- as this is a separate dependency, currently we assume that information on how to install and set up Singularity are sourced directly from Singularity's website (dependencies and instructions may change at any time) there how would you feel if instead of adding specific doc information about this we were to link to the Singularity's website and ask the user to refer to that for up to date information about the installation and use of Singularity?
With regards to "an explanation of how to inspect the results would be very useful", we have a section at the end of the page (https://udales.github.io/u-dales/udales-getting-started/#whats-next) that takes you to simulate and view the results -- did you find this too hidden away? We wanted to avoid duplication but maybe there is a better place to add this information. @tomgrylls @samoliverowens any thoughts/preferences?
Re "an explanation of how to inspect the results would be very useful": I found a way. I searched the web for a netcdf viewer and found Paraview and Panoply. Panoply works just fine to visualise the results.
Re "an explanation of how to inspect the results would be very useful": I found a way. I searched the web for a netcdf viewer and found Paraview and Panoply. Panoply works just fine to visualise the results.
Great idea -- I will add them to the docs as well 👍
ncview can also be used to visualise the results quickly.
ncview can also be used to visualise the results quickly.
👍. Added in 0d36037
For the record, I had similar experience as @wimvanderbauwhede with the singularity build --remote ...
instruction. I wonder if the remote
option is required. I managed to get the build go forward by skipping it and executing sudo singularity build ...
.
@ashwinvis thanks for the feedback -- we had updated the docs at https://github.com/uDALES/u-dales/pull/139. With regards to the specifics of Singularity, we ask users to refer to the Singularity docs as this is not something related to uDALES. With regards to the remote build option, we wanted something that works on most systems and that is what the remote options does. As you pointed out, if you can run a program with elevated privileges, you don't have to use the remote build but, in most HPC/shared environments, this is often not the case.
Fair enough. I also tried the normal cmake
and make
route today, and it did not go through. I ran it on ArchLinux, and here are
Do you understand this?
Yes, we only support GNU compilers versions 9 and below -- you seem to be running 10.2.
@dmey That's probably it. I managed to compile in a HPC cluster. Thanks.
I went through the Getting Started guide and managed to install and run everything fine, but here are some comments on the installation and running to help you improve the documentation.
The "Getting Started" guide does not tell me where to get the code.
So I cloned the master branch
Singularity
Singularity-based installation requires golang and some other packages. The instructions to install golang are messy, I just used the Ubuntu packages and that worked fine.
"To build and download the Singularity image use:"
So I did
It asks me to create a token and paste it
I did this, I got:
What worked:
So once again I did
That takes a while. Some indication of how long it may take would be welcome
"then, to install uDALES use:"
Ditto
"Finally, to run an example case use:"
That works but an explanation of how to inspect the results would be very useful.
Prerequisites
That should maybe say "Prerequisites when not using Singularity"
The Linux/WSL (Ubuntu) instructions work fine but could have come earlier because I had already followed the link to the netcdf web site, downloaded netcdf-c and netcdf-fortran and was about to start building when I thought, there must be a better way.