radical-collaboration / facts

Repository for the Framework for Accessing Changes To Sea-level (FACTS)
MIT License
21 stars 10 forks source link

FACTS Use Tutorial #249

Open AlexReedy opened 10 months ago

AlexReedy commented 10 months ago

After todays PROTECT-FACTS meeting it's clear that we need to set up some tutorial sessions for FACTS use, specifically in the following categories:

  1. FACTS Set Up
  2. Using config.yml to construct experiments
  3. Most probably debugging in the pilot as well (at least until we get those error logs outputted as per issue https://github.com/radical-collaboration/facts/issues/235)
  4. Discussion of RCT and it's use in FACTS

These are some basic ideas, and more can/should be added as well as setting up a time to actually do this. We should also start linking / directing folks more readily to the RCT troubleshooting resources

shantenujha commented 10 months ago

Thanks, @AlexReedy. Do you have a link to the PROTECT project/scope?

Timh37 commented 10 months ago

Perhaps it would also be helpful if you could recommend some basic (installation) steps to go through prior to such a tutorial?

AlexReedy commented 10 months ago

@Timh37 yes good call, we do have a quick start page for FACTS that we can attach https://fact-sealevel.readthedocs.io/en/latest/quickstart.html

bobkopp commented 10 months ago

And while 1 is currently addressed in the docs, and the technical specification for config.yml is also described, it would be good to add doc pages addressing 2-4 from a practical perspective.