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

Documentation on input parameters #29

Open
emichr opened this issue May 4, 2019 · 3 comments
Open

Documentation on input parameters #29

emichr opened this issue May 4, 2019 · 3 comments

Comments

@emichr
Copy link

emichr commented May 4, 2019

I haven't found any documentation or docstrings in the functions and files of MULTEM. Is there any documentation other than the example files available or under development? If not, then perhaps we (the users) should initiate something based on experience/use?

@Quantumstud
Copy link

Hi,

I had a similar question. I started using MULTEM sometime back. It so seems that the description of the input parameters is present in the 'multem_default_values.' Then these parameters are quite closely related to the book by Kirkland.

I couldn't find any documentation apart from these. I think it is indeed an excellent idea for documentation of the code. Lucid documentations would also make future developments of the wonderful software package easier.

@emichr
Copy link
Author

emichr commented May 6, 2019

The descriptions in the multem_default_values are indeed very helpful but as you say, documentation of the code is very important for future developments!

At the moment, it is quite difficult to get an overview of all the parameters relevant for specific simulation modes. I would suggest starting out by creating a documentation based on the required inputs to il_MULTEM for each separate simulation mode. However, in my opinion, the end goal should be that all functions have descriptive and informative docstrings, and then a separate in-depth documentation of the implementations. This will be a large task though, but I think the code and community will benefit greatly from it.

@Ivanlh20
Copy link
Owner

Ivanlh20 commented May 6, 2019 via email

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

No branches or pull requests

3 participants