Tutorial inspiration #16

GemmaTuron · 2022-03-23T09:21:52Z

We are working to develop simple tutorials for the Ersilia Model Hub.
Ca you comment below suggestion one example of a good tutorial from another FOSS project we could get inspiration from?

This is a required step to tackle Issue #17

AviatorIfeanyi · 2022-03-26T00:51:25Z

Does this have to include articles from blog posts?
This is exciting and i would love to collaborate with you on this

Find below an example

https://towardsdatascience.com/how-to-use-machine-learning-for-drug-discovery-1ccb5fdf81ad

nangahamandine · 2022-03-26T03:32:12Z

Greetings @GemmaTuron
During my esearch, I came accross this video on Youtube, I don't know if it can be of help in any way
https://www.youtube.com/watch?v=SoeQZJLQlMc

nangahamandine · 2022-03-26T03:52:06Z

Below are links to some articles that I came across;

https://www.ncbi.nlm.nih.gov/pmc/articles/PMC3884843/

https://www.researchgate.net/publication/256200380_Open_source_drug_discovery_-_A_limited_tutorial

https://www.simulations-plus.com/software/admetpredictor/?gclid=Cj0KCQjw0PWRBhDKARIsAPKHFGhoMZIta7SvbRDIVEYQAVqvBB1BU1CPYmbUBRPCro5zjdNiF2fDk_kaAnvpEALw_wcB

https://www.knime.com/blog/tutorials-for-computer-aided-drug-design-using-knime-workflows

nangahamandine · 2022-03-26T03:54:08Z

I'm hoping that I got the assignment correctly. In case I'm making a mistake, I'll greatly appreciate any corrections

victorabba · 2022-03-26T17:03:24Z

I think the way forward is to test the model by installing and trying it out after which we can then make a video tutorial on how newbies can install and use the model.

AishaSaman · 2022-03-26T23:09:18Z

Hi, I am Aisha and I am Outreachy internship applicant.

I think this website have really good, simple tutorials for inspiration:
https://material.io/design/machine-learning/barcode-scanning.html#usage

Things that inspire me and I found helpful are:

step by step with pictures and videos where necessary for better understanding
dos and donts are shown with green and red colors
links to related articles with each topic
use cases shown

julietugo · 2022-03-27T06:06:27Z

I believe the 'Getting Started' page of Python is a good example. I would like to write such for Ersilia.

kbetty · 2022-03-27T19:07:27Z

Hello @GemmaTuron I have searched and gone through several tutorials from other FOSS communities and I found one at https://wiki.openmrs.org/display/docs/Developer+Guide so inspiring that we can borrow a leaf as we develop ours for Ersilia Model Hub and am passionate to contribute to the project.

kbetty · 2022-03-27T19:55:57Z

@GemmaTuron I think we have two separate tutorials to cater for technical contributors and non technical contributors so that we come up with tutorials that will be of great use to our community.

adeola-dev · 2022-03-27T21:17:58Z

Hi @GemmaTuron I found this helpful for the usability of the Firefox FOSS project;
https://itsfoss.com/firefox/

And this for the VLC FOSS project;
https://itsfoss.com/install-latest-vlc/
https://www.flexclip.com/learn/vlc.html.

I am open to collaboration with other contributors to this issue

GemmaTuron · 2022-03-28T06:01:08Z

Hello,

@AviatorIfeanyi, you link to a high level introduction to ML for drug discovery, but here we are looking at creating specific tutorials for the Ersilia Model hub, our tool. Please think how to do this and find perhaps more adapted examples before continuing

@Ama-tech0001, the first resources you list are also high level overview of using computer science for drug discovery. The most relevant and similar to what we need is the knime workflow. Good find, get your inspiration from there to work on issue #17

@victorabba a video tutorial would be fantastic!

@AishaSaman this is a good example, you can use it as a template to work on issue #17

@julietugo the "Getting Started" in python is good but very general, we would like something more detailed to the Ersilia Model Hub

@kbetty, the Developer manual is focused on new developers and contributors. Is not a bad idea but here we were thinking of tutorials for users, not developers. Can you find a user-oriented example?

@adeola-dev, you are citing great documentation of installation instructions, but here we are looking at more tutorial-type of examples, can you find one?

But to all of you, thanks for your work you are all citing interesting resources and I encourage you to answer my comments before moving to issue #17

nangahamandine · 2022-03-28T06:11:21Z

Thank you for the comments @GemmaTuron
Can you please check out what I did in issue #17 ?

kbetty · 2022-03-28T06:14:20Z

@kbetty, the Developer manual is focused on new developers and contributors. Is not a bad idea but here we were thinking of tutorials for users, not developers. Can you find a user-oriented example?

Thanks for the insight. I have gone through several user-oriented guides but the one at https://wiki.openmrs.org/pages/viewpage.action?pageId=589851 out-stands them and I think we can borrow a leaf and we come up with a user-friendly deployment guide for AI/ML models.

Kheredine · 2022-03-28T06:53:55Z

Hi @GemmaTuron , I hope this will help
https://youtu.be/yL_NqXZgmks

Kcfreshly · 2022-03-28T07:40:45Z

@GemmaTuron Knime flow as suggested by @Ama-tech0001 looks great, I believe I can create a similar tutorial and possibly include a short tutorial video on how to use the Ersilia Model Hub.

Here is a sample tutorial I found

https://torchdrug.ai/docs/tutorials/

On a video tutorial, I found this material

https://www.youtube.com/watch?v=ghUyZknxq5o

In our own video tutorial, I suggest no voice, just a low background music and captions on the screen that explains each step

Onajitehub · 2022-03-28T08:53:53Z

Pictures helps as anchor to direction and it gives a visualization of what to expect as well as a road map. I would like to contribute to this project by creating a picture tutorial for users.

julietugo · 2022-03-28T09:06:26Z

Thank you @GemmaTuron for the feedback. I believe this is what you are looking for - https://towardsai.net/p/l/how-to-discover-antiviral-drugs-with-deep-learning. I can create this kind of tutorial for Ersilia

adeola-dev · 2022-03-28T12:28:03Z

Thanks @GemmaTuron for the feedback. I found the resources cited by @AishaSaman very useful. I could create a simple tutorial using the template.

MsChineme · 2022-03-28T13:39:58Z

@GemmaTuron Here is Google AutoML. Though works on the cloud, It's an open source platform that enables people with little knowledge of ML to train models specific to their use cases.

Features:
Image classification
Video intelligence
Auto ML translation
Natural language

Links
https://www.youtube.com/watch?v=kgxfdTh9lz0
https://www.youtube.com/watch?v=aUfIFoMEIgg

ps-19 · 2022-03-28T15:20:05Z

@GemmaTuron mam i would love to work on this issue.

kbetty · 2022-03-29T04:59:49Z

@GemmaTuron I have been reading more about the project to gather information on how best we can develop a simple tutorials for The Ersilia Model Hub. And as from my findings there are things we need to put into consideration

The users of the tutorial(Most of the users/research scientists are not computer experts).
The limitation users may encounter when using the tutorials during deploying
The main barriers of AI adoption in experimental research.
etc

Those factors above need to be carefully analysed so that we will create a tutorial for The Ersilia Model Hub ready to use AI model which will be easier for users(researchers) to adopt.

kbetty · 2022-03-29T06:03:31Z

Getting to know more on the project, I discovered that after Ersilia AI models are validated they are published for use but they lack the Deployment feature which can aid users to use the tool(s) with ease. Of which these users most of them are scientists who are actually not computer experts and this results into our tools not being widely adopted by the users.

So the Tutorial we are developing/creating is to address the issue above. And to my understanding based on the research have curried out we are creating a Deployment feature to our AI models for users to easily adopt to the tools during their research.

@GemmaTuron let me know whether am on track as I explore more with the project?

GemmaTuron · 2022-03-29T06:39:45Z

Thanks @GemmaTuron for the feedback. I found the resources cited by @AishaSaman very useful. I could create a simple tutorial using the template.

please head to issue #17 to start working on this!

GemmaTuron · 2022-03-29T06:41:30Z

Getting to know more on the project, I discovered that after Ersilia AI models are validated they are published for use but they lack the Deployment feature which can aid users to use the tool(s) with ease. Of which these users most of them are scientists who are actually not computer experts and this results into our tools not being widely adopted by the users.

So the Tutorial we are developing/creating is to address the issue above. And to my understanding based on the research have curried out we are creating a Deployment feature to our AI models for users to easily adopt to the tools during their research.

@GemmaTuron let me know whether am on track as I explore more with the project?

Hi @kbetty, you have done a good research! Indeed, non technical users might face difficulties in using the Hub. We would like one or two slides/text/video showing how can they use it (at the current stage of deployment, which is through CLI)

GemmaTuron · 2022-03-29T06:41:54Z

@GemmaTuron Here is Google AutoML. Though works on the cloud, It's an open source platform that enables people with little knowledge of ML to train models specific to their use cases.

Features: Image classification Video intelligence Auto ML translation Natural language

Links https://www.youtube.com/watch?v=kgxfdTh9lz0 https://www.youtube.com/watch?v=aUfIFoMEIgg

Hi @MsChineme , this is a good find and a very nice example.

GemmaTuron · 2022-03-29T06:42:29Z

@GemmaTuron mam i would love to work on this issue.

Hello @ps-19, comment with some examples you will use as a template and then go ahead to issue #17 !

MsChineme · 2022-03-29T06:55:25Z

@GemmaTuron Here is Google AutoML. Though works on the cloud, It's an open source platform that enables people with little knowledge of ML to train models specific to their use cases.
Features: Image classification Video intelligence Auto ML translation Natural language
Links https://www.youtube.com/watch?v=kgxfdTh9lz0 https://www.youtube.com/watch?v=aUfIFoMEIgg

Hi @MsChineme , this is a good find and a very nice example.

Thank you @GemmaTuron . Do I proceed to the next step, if yes? Please what is the next step?

Rufaida98 · 2022-03-29T09:36:04Z

@GemmaTuron I think it already listed but a video tutorial as i learned a lot from video tutorials or like what you did in ersilia book to download the Ubuntu and other packages for ersilia API which was very straightforward and helpful.

kbetty · 2022-03-30T06:23:19Z

As part of the ground work during my research so that we develop a useful tutorial for users, I discovered there are as two ways of using the product:

Using the CLI
Using an online platform via cloud services( A web-based app)

However, at the our current stage of deployment, the user can so far use the CLI. My idea that am working on is to come up with the skeleton of a useful Table of Content for the tutorial which we can brainstorm on and then add content accordingly.
cc: @GemmaTuron

ghost · 2022-03-30T16:50:30Z

We are working to develop simple tutorials for the Ersilia Model Hub. Can you comment below suggestion one example of a good tutorial from another FOSS project we could get inspiration from?

This is a required step to tackle Issue #17

Hello, I am Vaishnavi, Outreachy applicant.
First, we must install the model and analyze the problems the user might encounter during installation.
Then make a tutorial video which will show everything steps by step, from where to install it to how to use it.

ghost · 2022-03-30T17:06:56Z

We are working to develop simple tutorials for the Ersilia Model Hub. Can you comment below suggestion one example of a good tutorial from another FOSS project we could get inspiration from?
This is a required step to tackle Issue #17

Hello, I am Vaishnavi, Outreachy applicant. First, we must install the model and analyze the problems the user might encounter during installation. Then make a tutorial video which will show everything steps by step, from where to install it to how to use it.

I found a series of tutorial videos that explain everything about the app, starting with what it is, how to use it, what plus points are, etc.

Here I am sharing this series I think this will be helpful to make any tutorial video.
https://youtu.be/HCc7wzUH4ts - Introduction and app overview
https://youtu.be/gH2G0niO6cM - Visualize your thoughts
https://youtu.be/4sp2X4nsBwA - Tell the story through media
https://youtu.be/z_H7i-ERVQI - Capture everything
https://youtu.be/jq42O1W_Iys - Share for feedback
https://youtu.be/oANcUP2Q9XA - Meetings with meaning

miquelduranfrigola · 2022-03-30T17:24:29Z

Hi @GemmaTuron I see a lot of traction here! Can we nominate some assignees? (see right bar).

AbiolaAnisere · 2022-03-30T21:48:20Z

We are working to develop simple tutorials for the Ersilia Model Hub. Ca you comment below suggestion one example of a good tutorial from another FOSS project we could get inspiration from?

This is a required step to tackle Issue #17

Hi @GemmaTuron,

These are a few suggestions of good tutorials I found from different sources. Please provide feedback. Thank you.

https://www.youtube.com/watch?v=SoeQZJLQlMc

https://material.io/design/machine-learning/barcode-scanning.html#usage

https://towardsai.net/p/l/how-to-discover-antiviral-drugs-with-deep-learning

https://www.youtube.com/watch?v=kgxfdTh9lz0

AbiolaAnisere · 2022-03-30T21:59:55Z

Hi @GemmaTuron,

These are a few suggestions of good tutorials I found from different sources. Please provide feedback. Thank you.

https://www.youtube.com/watch?v=SoeQZJLQlMc

https://material.io/design/machine-learning/barcode-scanning.html#usage

https://towardsai.net/p/l/how-to-discover-antiviral-drugs-with-deep-learning

https://www.youtube.com/watch?v=kgxfdTh9lz0

AnshuKumari197 · 2022-03-31T09:10:36Z

Hello, @GemmaTuron Can we make tutorial how Ersilia Model Hub will help in future for mankind ?

camus60 · 2022-03-31T13:45:32Z

@GemmaTuron @miquelduranfrigola I have gone through your documentation,specifically the strategic plan, and I have an idea of what you guys stand for and a partial vision for what you intend Ersilia to become.

In light of that, I believe your tutorials should be modeled more like a mini-course similar to the ones in the links below

I would argue that it would be much easier to grow a tutorial organically as a course over-time and would capture all of Ersilia's values.

https://huggingface.co/course/chapter1/1

https://spacy.io/usage/spacy-101

or,create mini-projects using Ersilia's models the structure could be similar to the link attached by a fellow community member

https://www.youtube.com/watch?v=kgxfdTh9lz0

I can come up with something similar.

GemmaTuron · 2022-04-03T08:24:10Z

Hello all,

Thanks for your ideas, sound great! Please follow the new contribution guidelines to make sure we can track each applicant's work and suggestions!

I will close this issue now to move the discussions to the relevant thread

Write outputs to JSON and upload to S3 Bucket

GemmaTuron added documentation Improvements or additions to documentation good first issue Good for newcomers labels Mar 23, 2022

GemmaTuron mentioned this issue Mar 28, 2022

Create a mock tutorial slide #17

Closed

GemmaTuron mentioned this issue Mar 28, 2022

Code documentation #14

Closed

miquelduranfrigola assigned GemmaTuron Mar 30, 2022

GemmaTuron closed this as completed Apr 3, 2022

miquelduranfrigola pushed a commit that referenced this issue Dec 21, 2023

Merge pull request #16 from hcs-t4sg/theresa/memoryUsage

ae33842

Write outputs to JSON and upload to S3 Bucket

Tutorial inspiration #16

Tutorial inspiration #16

Comments

GemmaTuron commented Mar 23, 2022 • edited

AviatorIfeanyi commented Mar 26, 2022

nangahamandine commented Mar 26, 2022

nangahamandine commented Mar 26, 2022

nangahamandine commented Mar 26, 2022

victorabba commented Mar 26, 2022

AishaSaman commented Mar 26, 2022

julietugo commented Mar 27, 2022

kbetty commented Mar 27, 2022 • edited

kbetty commented Mar 27, 2022

adeola-dev commented Mar 27, 2022

GemmaTuron commented Mar 28, 2022

nangahamandine commented Mar 28, 2022

kbetty commented Mar 28, 2022 • edited

Kheredine commented Mar 28, 2022

Kcfreshly commented Mar 28, 2022 • edited

Onajitehub commented Mar 28, 2022

julietugo commented Mar 28, 2022

adeola-dev commented Mar 28, 2022

MsChineme commented Mar 28, 2022 • edited

ps-19 commented Mar 28, 2022

kbetty commented Mar 29, 2022 • edited

kbetty commented Mar 29, 2022 • edited

GemmaTuron commented Mar 29, 2022

GemmaTuron commented Mar 29, 2022

GemmaTuron commented Mar 29, 2022

GemmaTuron commented Mar 29, 2022

MsChineme commented Mar 29, 2022

Rufaida98 commented Mar 29, 2022

kbetty commented Mar 30, 2022 • edited

ghost commented Mar 30, 2022

ghost commented Mar 30, 2022

miquelduranfrigola commented Mar 30, 2022

AbiolaAnisere commented Mar 30, 2022 • edited

AbiolaAnisere commented Mar 30, 2022

AnshuKumari197 commented Mar 31, 2022 • edited

camus60 commented Mar 31, 2022 • edited

GemmaTuron commented Apr 3, 2022

GemmaTuron commented Mar 23, 2022 •

edited

kbetty commented Mar 27, 2022 •

edited

kbetty commented Mar 28, 2022 •

edited

Kcfreshly commented Mar 28, 2022 •

edited

MsChineme commented Mar 28, 2022 •

edited

kbetty commented Mar 29, 2022 •

edited

kbetty commented Mar 29, 2022 •

edited

kbetty commented Mar 30, 2022 •

edited

AbiolaAnisere commented Mar 30, 2022 •

edited

AnshuKumari197 commented Mar 31, 2022 •

edited

camus60 commented Mar 31, 2022 •

edited