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

Tutorials on stdlib modules #3

Open
3 tasks
awvwgk opened this issue Feb 6, 2022 · 3 comments
Open
3 tasks

Tutorials on stdlib modules #3

awvwgk opened this issue Feb 6, 2022 · 3 comments

Comments

@awvwgk
Copy link
Owner

awvwgk commented Feb 6, 2022

For the tutorials we need self-contained examples which walk the reader through the available functionality and different usage patterns of stdlib. Potential topic are

  • statistics, distributions
  • string processing, input/output
  • quadrature, mathematical utilities

We can have more than one tutorial for a module, if they have several difficulty levels or explore different applications.

@jvdp1
Copy link
Collaborator

jvdp1 commented Feb 7, 2022

@awvwgk Thank you for opening all these issues. Unfortunately I am currently quite busy. I hope to come back on these by the end of the week.

@jvdp1
Copy link
Collaborator

jvdp1 commented Feb 13, 2022

@awvwgk I just saw that you put the stuff on Numpy files in the section how-to, while I would put intuitively such a description in the section tutorial. Why did you do this choice (note: it is fine for me as is, but based on your comment on this thread, I was expecting to find it here)

@awvwgk
Copy link
Owner Author

awvwgk commented Feb 13, 2022

You can think of the tutorials as a general introduction to Fortran while also using stdlib. For the tutorials we are looking for a somewhat complete example application, which is build step by step in the course of a tutorial. This allows to explore several features of one or more stdlib modules.

For fpm we have a small command line application with some stdlib functions and declares dependencies on various fpm projects, while we are building a library, adding a CLI and finally also unit testing. Similarly, one could think about analyzing a data set using the statistics module while navigating through different statistical measures and their practical relevance.

One of the nice aspects about writing a tutorial is that it shows you what we can't do with stdlib.


For the how to guides I'm taking a specific task and show how it is done with stdlib. This is much more problem oriented way of making stdlib's features accessible, however it is only useful if you know exactly what you want to do with stdlib.

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

2 participants