{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Using CGC for Workshops and Courses","type":"basic","slug":"using-cgc-for-workshops-and-courses","excerpt":"","body":"##Overview\n\nThere are many challenges associated with teaching cancer research concepts to students in a hands-on workshop or course format. Course instructors need mechanisms to share course materials with the students, including test data, methods, and example analyses.\n\nCourse instructors also need to provide students with up-to-date software packages for carrying out the hands-on exercises. Finally, course instructors benefit from the ability to monitor student progress and review final work. All of this becomes even more challenging when courses and workshops are held virtually.\n\nLikewise, students need access to the course materials (including the files and code) as well as a resource with sufficient computational power. Students may require technical help from course instructors as they work through the exercises. \n\nCGC provides a solution for the challenges described above, offering course instructors and students the necessary technical infrastructure for teaching, sharing class materials, and learning. This allows the instructors and students to focus on the science, instead of the technical infrastructure.\n\n##CGC Success Stories\n\nProfessors mentioned in the stories below, have used the CGC to teach complex bioinformatics concepts. The students, on the other hand, have learned the coursework and are enabled to continue using their CGC account on future research projects on CGC.\n\n###Masters in Health Informatics and Data Science Class at Georgetown University\n\nGeorgetown University Master’s degree in Health Informatics and Data Science is designed to teach students to apply informatics and data science to lead the transformation of healthcare.\n\nOur long term collaborators Dr. Yuriy Gusev and Ms. Krithika Bhuvaneshwar lead this Master’s program. They have been using the CGC platform for the past 3 years to train the next generation of data scientists.\n\nTo make it easier for students, they decided to use Seven Bridges’ collection of tools. The Seven Bridges CGC platform presents the tools and data in a very user-friendly, graphical interface where students have this low barrier to understand and start using the pipelines, which otherwise would require a lot of additional training.\n\nUsing the project infrastructure, they have created a project for each of their students and teach them how to copy data, pipelines, and how to collaborate with the CGC. They are able to follow their progress and troubleshoot in real time. \n\nOver the past 3 years, Dr. Gusev has used the CGC to train students on how to perform RNAseq analysis and imaging machine learning algorithms in the cloud. Each class has an average of 15-20 students, and the CGC is used for at least two of the classes in the Masters program.\n\nFor more details on Dr. Gusev’s experience, you can find a [recorded webinar on our website](https://www.cancergenomicscloud.org/webinars/2021/7/6/webinar-july-2021).\n \n The Seven Bridges team provided support to participants prior to and during the workshop, assisting with account setup and troubleshooting. This enabled the course instructors to focus on the content and teaching while the Seven Bridges team focused on the infrastructure and platform account logistics.\n\n\n###Stats 581 Undergraduate class at Purdue University\n\nTogether with our collaborator Dr Min Zhang, Seven Bridges prepared a lecture series of 4 classes of ~50 min, to teach undergraduate students how to use the CGC platform to perform end-to-end analysis of bulk RNA-seq and single-cell data RNA-seq data. \n\nDuring the first lecture, the participants learned how to change their billing group, how to create a project, and easily transfer data from one project or collaborator into their own.\n\nDuring the following lectures, the students and attendees learned how to transfer open access data from two SRA datasets to their projects, perform RNA-seq analysis starting with alignment of sequences and do differential expression analysis from publicly available data.\n\nThey also learned to utilize popular CGC single-cell tools, such as Seurat, to identify single cell gene expression differences. \n\nPrior to the first lecture the Seven Bridges team instructed all of the registered students to create platform accounts and added them to the professor billing group.\n\nDuring the series, the Seven Bridges team provided the slides, reading materials and expected pipelines to allow the participants to get started on their own. The lecture series had an average of 30 attendees, and the recorded sessions were made available at the Purdue and [CGC websites](https://www.cancergenomicscloud.org/teaching-success-stories). \n\n##Procedure\n\n###Setting up course materials on the platform\nCourse and workshop organizers can share data and code with participants by using platform projects. The organizers can choose to make the course materials available to all users on the platform or limit distribution to the registered participants. \n\n#### Distributing materials to specific participants\nIn cases where there is a registration fee for a workshop or course, organizers may want to limit distribution of the course materials to only those individuals who registered for the course. In this case, organizers should set up a Course Materials project with all the needed data and methods.\n\nFor small courses of less than 20 participants, the participants can be added as members of the Course Materials project. All course participants can work together in the same project and view each other’s analyses. \n\nIt becomes difficult to organize the work of more than 20 people in one project. For that reason, we recommend giving each participant their own copy of the Course Materials project when there are more than 20 participants in a course. Instructors and support staff can be added as members of the project as needed for assistance. \n\n####Sharing materials with all platform users\nIn cases where the workshop or course materials could benefit researchers beyond those who registered for the event, the materials can be made available to CGC users through a “public project.” Public projects are listed in the top navigation bar of the platform. Organizers set up a private project with all of the needed data and methods for the event. Once the project is finalized, the Seven Bridges team creates a “public project” using the content provided. Public projects can only contain open access data that can be shared with all platform users. \n\n####Files\nCourse instructors should provide students with test files for the course. These test files should be added to the Files tab of the project. Course instructors can upload/import files to the Platform, following [CGC data protection policies](https://www.cancergenomicscloud.org/data-protection) and [these steps](doc:upload-to-the-cgc).\n\nOpen access hosted datasets can also be used. For example, CGC hosts files from the 1000 Genomes dataset and makes these available to all users on the platform. [Learn more](doc:about-datasets) about the hosted datasets.  \n\n####Analysis methods\n\nCourse instructors can make methods available within projects using either interactive notebooks in the [Data Cruncher feature](doc:about-data-cruncher) and/or through Common Workflow Language tools and workflows. If course instructors want to expose all of the code in a set of methods, they can set up RStudio, Jupyterlab, or SAS notebooks.\n\nTo access the code, the participant would launch the notebook. If course instructors want to show participants how to scale up analyses (batch processing) and ensure reproducibility, they can include CWL versions of the methods in the project as well. For more information on CWL, see[ this blog post on working with CWL](https://www.sevenbridges.com/cwl-seven-bridges-platforms/). \n\n###Determine how cloud costs will be supported\nParticipants will incur cloud costs while using CGC. In order to create projects and run analyses on the platform, participants must be a member of a platform billing group. A billing group provides a mechanism for the participant cloud costs to be captured and paid for. \n\nWe recommend that course organizers use one platform billing group to support the cloud costs of all event participants. The Seven Bridges team creates the billing group in advance of the workshop and ensures that all participants are set up as “members” of the billing group. \n\nCourse or workshop organizers have two options for supporting the costs of the billing group:\n\n* Apply for CGC Cloud Credits\n* Set up a payment mechanism with Seven Bridges\n\n####Apply for CGC Cloud Credits\n\nCGC offers a cloud credits program for cancer researchers. Every researcher that is a new user  can request $300 in pilot cloud credits. In addition, researchers can apply collaborative projects, provided in the form of cloud credit  credits. We recommend applying for a collaborative project to support the cost of multiple participants in a workshop or course. For more information on how to apply for a collaborative project, see our website here https://www.cancergenomicscloud.org/collaborative-funds.\n\nSteps: \n\n1) Estimate the cloud costs for the event\n    a) Set up data and code on CGC.\n    b) Run through the exercises to determine the expected cloud costs for one participant\n    c) Estimate the total costs by scaling up to the expected number of participants\n    d) Refer to tutorial on [Estimating and Managing Cloud Costs](doc:estimate-and-manage-your-cloud-costs)\n    e) Reach out [support:::at:::sevenbridges.com](mailto:[email protected]) if you need assistance\n2) Submit application for cloud credits\n    a) Go to the [CGC website](https://www.cancergenomicscloud.org/collaborative-funds).\n    b) Submit an application for a “Collaborative Grant”.\n3) Seven Bridges CGC team will be notified if your application is approved. If approved, Seven Bridges will create a platform billing group with the approved cloud credit amount. You will be notified about the status of your application as well as once your billing group is available. \n\n###Set up a payment mechanism with Seven Bridges\nResearchers can pay for their own cloud costs on the CGC by providing a purchase order or a credit card number. Course instructors can work with the Seven Bridges team to set up a billing group. Course instructors have the choice to be invoiced after the workshop completes or to pre-pay. \n\n\nSteps:\n\n1) Estimate the cloud costs for the event\n  a) Set up data and code on CGC \n  b) Run through the exercises to determine the expected cloud costs for individual participants\n  c) Estimate the total costs by scaling up to the expected number of participants\n  d) Refer to tutorial on Estimating and Managing Cloud Costs\n  e) Reach out [email protected] if you need assistance\n2) Email [[email protected]](mailto:[email protected]) and indicate that you would like to host a workshop or course on the platform and need a platform billing group. The support team will inform the CGC Program Manager who will reach out to you with next steps. \n\n\n###Platform accounts for participants \n\nCourse organizers manage registration for the course. The Seven Bridges team manages the process of course participants getting set up with accounts on CGC. \n\n**2 weeks before the event**\nCourse organizers send the Seven Bridges Team the final list of participants and their email addresses. \n\nSeven Bridges Team emails the participants instructions on how to create accounts. Participants are asked to send their platform usernames to the Seven Bridges Team. This step confirms that the individual has completed account creation and enables the Seven Bridges Team to add the individual to the platform billing group that will be used to support cloud costs for the event.  \n\n**1 week before the event**\n\nFor participants who have not yet created platform accounts: \n* Seven Bridges Team follows up with a reminder email. \n\nFor participants who have created platform accounts: \n* Seven Bridges Team adds them to the platform billing group that will be used to support the cloud costs for the event.\n* Seven Bridges Team distributes an introductory tutorial and asks participants to work through the instructions prior to the event.\n\n**Day of the event**\n\nA Seven Bridges Community Engagement Manager is available to ensure the students are successful. The Seven Bridges Support Team is also available to troubleshoot any issues that may come up. Students are also encouraged to attend [office hours](https://www.cancergenomicscloud.org/) with Seven Bridges, on Tuesdays 10am and Thursdays 2pm ET. \n\n\n##For more information\n\nIf you are interested in using CGC for a workshop or course, please write to us at [[email protected]](mailto:[email protected]). We are eager to help you get the most out of the platform.","updates":[],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"62289fb076dcfb019adc8a2a","createdAt":"2022-03-09T12:38:08.592Z","user":"5dbff97bc91e080029778657","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"GUIDES","slug":"guides","order":2,"from_sync":false,"reference":false,"_id":"6176d5bf8f59c6001038c2f7","createdAt":"2021-10-25T16:05:19.286Z","version":"55faf11ba62ba1170021a9aa","project":"55faf11ba62ba1170021a9a7","__v":0},"version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77","59a555bccdbd85001bfb1442","5a2a81f688574d001e9934f5","5b080c8d7833b20003ddbb6f","5c222bed4bc358002f21459a","5c22412594a2a5005cc9e919","5c41ae1c33592700190a291e","5c8a525e2ba7b2003f9b153c","5cbf14d58c79c700ef2b502e","5db6f03a6e187c006f667fa4","5f894c7d3b0894006477ca01","6176d5bf8f59c6001038c2f7"],"_id":"55faf11ba62ba1170021a9aa","releaseDate":"2015-09-17T16:58:03.490Z","createdAt":"2015-09-17T16:58:03.490Z","project":"55faf11ba62ba1170021a9a7","__v":48},"project":"55faf11ba62ba1170021a9a7","__v":0,"parentDoc":null}

Using CGC for Workshops and Courses


##Overview There are many challenges associated with teaching cancer research concepts to students in a hands-on workshop or course format. Course instructors need mechanisms to share course materials with the students, including test data, methods, and example analyses. Course instructors also need to provide students with up-to-date software packages for carrying out the hands-on exercises. Finally, course instructors benefit from the ability to monitor student progress and review final work. All of this becomes even more challenging when courses and workshops are held virtually. Likewise, students need access to the course materials (including the files and code) as well as a resource with sufficient computational power. Students may require technical help from course instructors as they work through the exercises. CGC provides a solution for the challenges described above, offering course instructors and students the necessary technical infrastructure for teaching, sharing class materials, and learning. This allows the instructors and students to focus on the science, instead of the technical infrastructure. ##CGC Success Stories Professors mentioned in the stories below, have used the CGC to teach complex bioinformatics concepts. The students, on the other hand, have learned the coursework and are enabled to continue using their CGC account on future research projects on CGC. ###Masters in Health Informatics and Data Science Class at Georgetown University Georgetown University Master’s degree in Health Informatics and Data Science is designed to teach students to apply informatics and data science to lead the transformation of healthcare. Our long term collaborators Dr. Yuriy Gusev and Ms. Krithika Bhuvaneshwar lead this Master’s program. They have been using the CGC platform for the past 3 years to train the next generation of data scientists. To make it easier for students, they decided to use Seven Bridges’ collection of tools. The Seven Bridges CGC platform presents the tools and data in a very user-friendly, graphical interface where students have this low barrier to understand and start using the pipelines, which otherwise would require a lot of additional training. Using the project infrastructure, they have created a project for each of their students and teach them how to copy data, pipelines, and how to collaborate with the CGC. They are able to follow their progress and troubleshoot in real time. Over the past 3 years, Dr. Gusev has used the CGC to train students on how to perform RNAseq analysis and imaging machine learning algorithms in the cloud. Each class has an average of 15-20 students, and the CGC is used for at least two of the classes in the Masters program. For more details on Dr. Gusev’s experience, you can find a [recorded webinar on our website](https://www.cancergenomicscloud.org/webinars/2021/7/6/webinar-july-2021). The Seven Bridges team provided support to participants prior to and during the workshop, assisting with account setup and troubleshooting. This enabled the course instructors to focus on the content and teaching while the Seven Bridges team focused on the infrastructure and platform account logistics. ###Stats 581 Undergraduate class at Purdue University Together with our collaborator Dr Min Zhang, Seven Bridges prepared a lecture series of 4 classes of ~50 min, to teach undergraduate students how to use the CGC platform to perform end-to-end analysis of bulk RNA-seq and single-cell data RNA-seq data. During the first lecture, the participants learned how to change their billing group, how to create a project, and easily transfer data from one project or collaborator into their own. During the following lectures, the students and attendees learned how to transfer open access data from two SRA datasets to their projects, perform RNA-seq analysis starting with alignment of sequences and do differential expression analysis from publicly available data. They also learned to utilize popular CGC single-cell tools, such as Seurat, to identify single cell gene expression differences. Prior to the first lecture the Seven Bridges team instructed all of the registered students to create platform accounts and added them to the professor billing group. During the series, the Seven Bridges team provided the slides, reading materials and expected pipelines to allow the participants to get started on their own. The lecture series had an average of 30 attendees, and the recorded sessions were made available at the Purdue and [CGC websites](https://www.cancergenomicscloud.org/teaching-success-stories). ##Procedure ###Setting up course materials on the platform Course and workshop organizers can share data and code with participants by using platform projects. The organizers can choose to make the course materials available to all users on the platform or limit distribution to the registered participants. #### Distributing materials to specific participants In cases where there is a registration fee for a workshop or course, organizers may want to limit distribution of the course materials to only those individuals who registered for the course. In this case, organizers should set up a Course Materials project with all the needed data and methods. For small courses of less than 20 participants, the participants can be added as members of the Course Materials project. All course participants can work together in the same project and view each other’s analyses. It becomes difficult to organize the work of more than 20 people in one project. For that reason, we recommend giving each participant their own copy of the Course Materials project when there are more than 20 participants in a course. Instructors and support staff can be added as members of the project as needed for assistance. ####Sharing materials with all platform users In cases where the workshop or course materials could benefit researchers beyond those who registered for the event, the materials can be made available to CGC users through a “public project.” Public projects are listed in the top navigation bar of the platform. Organizers set up a private project with all of the needed data and methods for the event. Once the project is finalized, the Seven Bridges team creates a “public project” using the content provided. Public projects can only contain open access data that can be shared with all platform users. ####Files Course instructors should provide students with test files for the course. These test files should be added to the Files tab of the project. Course instructors can upload/import files to the Platform, following [CGC data protection policies](https://www.cancergenomicscloud.org/data-protection) and [these steps](doc:upload-to-the-cgc). Open access hosted datasets can also be used. For example, CGC hosts files from the 1000 Genomes dataset and makes these available to all users on the platform. [Learn more](doc:about-datasets) about the hosted datasets. ####Analysis methods Course instructors can make methods available within projects using either interactive notebooks in the [Data Cruncher feature](doc:about-data-cruncher) and/or through Common Workflow Language tools and workflows. If course instructors want to expose all of the code in a set of methods, they can set up RStudio, Jupyterlab, or SAS notebooks. To access the code, the participant would launch the notebook. If course instructors want to show participants how to scale up analyses (batch processing) and ensure reproducibility, they can include CWL versions of the methods in the project as well. For more information on CWL, see[ this blog post on working with CWL](https://www.sevenbridges.com/cwl-seven-bridges-platforms/). ###Determine how cloud costs will be supported Participants will incur cloud costs while using CGC. In order to create projects and run analyses on the platform, participants must be a member of a platform billing group. A billing group provides a mechanism for the participant cloud costs to be captured and paid for. We recommend that course organizers use one platform billing group to support the cloud costs of all event participants. The Seven Bridges team creates the billing group in advance of the workshop and ensures that all participants are set up as “members” of the billing group. Course or workshop organizers have two options for supporting the costs of the billing group: * Apply for CGC Cloud Credits * Set up a payment mechanism with Seven Bridges ####Apply for CGC Cloud Credits CGC offers a cloud credits program for cancer researchers. Every researcher that is a new user can request $300 in pilot cloud credits. In addition, researchers can apply collaborative projects, provided in the form of cloud credit credits. We recommend applying for a collaborative project to support the cost of multiple participants in a workshop or course. For more information on how to apply for a collaborative project, see our website here https://www.cancergenomicscloud.org/collaborative-funds. Steps: 1) Estimate the cloud costs for the event a) Set up data and code on CGC. b) Run through the exercises to determine the expected cloud costs for one participant c) Estimate the total costs by scaling up to the expected number of participants d) Refer to tutorial on [Estimating and Managing Cloud Costs](doc:estimate-and-manage-your-cloud-costs) e) Reach out [[email protected]](mailto:[email protected]) if you need assistance 2) Submit application for cloud credits a) Go to the [CGC website](https://www.cancergenomicscloud.org/collaborative-funds). b) Submit an application for a “Collaborative Grant”. 3) Seven Bridges CGC team will be notified if your application is approved. If approved, Seven Bridges will create a platform billing group with the approved cloud credit amount. You will be notified about the status of your application as well as once your billing group is available. ###Set up a payment mechanism with Seven Bridges Researchers can pay for their own cloud costs on the CGC by providing a purchase order or a credit card number. Course instructors can work with the Seven Bridges team to set up a billing group. Course instructors have the choice to be invoiced after the workshop completes or to pre-pay. Steps: 1) Estimate the cloud costs for the event a) Set up data and code on CGC b) Run through the exercises to determine the expected cloud costs for individual participants c) Estimate the total costs by scaling up to the expected number of participants d) Refer to tutorial on Estimating and Managing Cloud Costs e) Reach out [email protected] if you need assistance 2) Email [[email protected]](mailto:[email protected]) and indicate that you would like to host a workshop or course on the platform and need a platform billing group. The support team will inform the CGC Program Manager who will reach out to you with next steps. ###Platform accounts for participants Course organizers manage registration for the course. The Seven Bridges team manages the process of course participants getting set up with accounts on CGC. **2 weeks before the event** Course organizers send the Seven Bridges Team the final list of participants and their email addresses. Seven Bridges Team emails the participants instructions on how to create accounts. Participants are asked to send their platform usernames to the Seven Bridges Team. This step confirms that the individual has completed account creation and enables the Seven Bridges Team to add the individual to the platform billing group that will be used to support cloud costs for the event. **1 week before the event** For participants who have not yet created platform accounts: * Seven Bridges Team follows up with a reminder email. For participants who have created platform accounts: * Seven Bridges Team adds them to the platform billing group that will be used to support the cloud costs for the event. * Seven Bridges Team distributes an introductory tutorial and asks participants to work through the instructions prior to the event. **Day of the event** A Seven Bridges Community Engagement Manager is available to ensure the students are successful. The Seven Bridges Support Team is also available to troubleshoot any issues that may come up. Students are also encouraged to attend [office hours](https://www.cancergenomicscloud.org/) with Seven Bridges, on Tuesdays 10am and Thursdays 2pm ET. ##For more information If you are interested in using CGC for a workshop or course, please write to us at [[email protected]](mailto:[email protected]). We are eager to help you get the most out of the platform.