diff --git a/.markdownlint.json b/.markdownlint.json new file mode 100644 index 0000000000000000000000000000000000000000..bf68de237524b9e77410e72f0ff5b2326bb7e6de --- /dev/null +++ b/.markdownlint.json @@ -0,0 +1,78 @@ +{ + "MD003": { + "style": "atx" + }, + "MD004": { + "style": "dash" + }, + "MD007": { + "indent": 4, + "start_indented": false + }, + "MD009": { + "strict": true + }, + "MD010": { + "code_blocks": true + }, + "MD012": { + "maximum": 1 + }, + "MD013": false, + "MD022": { + "lines_above": 1, + "lines_below": 1 + }, + "MD025": { + "level": 1 + }, + "MD029": { + "style": "one" + }, + "MD030": { + "ol_multi": 1, + "ol_single": 1, + "ul_multi": 1, + "ul_single": 1 + }, + "MD031": { + "list_items": true + }, + "MD033": { + "allowed_elements": [] + }, + "MD035": { + "style": "---" + }, + "MD040": { + "language_only": false + }, + "MD041": { + "level": 1 + }, + "MD043": false, + "MD044": { + "code_blocks": false, + "html_elements": true, + "names": [ + "BlazerID", + "UAB Campus Network", + "UAB Research Computing" + ] + }, + "MD046": { + "style": "fenced" + }, + "MD048": { + "style": "backtick" + }, + "MD049": { + "style": "underscore" + }, + "MD050": { + "style": "asterisk" + }, + "MD055": { + "style": "leading_and_trailing" + } +} diff --git a/.prettierrc b/.prettierrc new file mode 100644 index 0000000000000000000000000000000000000000..f14f7edf29d8993e940a51f356530dfd55e0b4ab --- /dev/null +++ b/.prettierrc @@ -0,0 +1,5 @@ +{ + "bracketSameLine": true, + "htmlWhitespaceSensitivity": "ignore", + "printWidth": 100000 +} diff --git a/checklist.md b/checklist.md index 56da485f99f5896c56069584cbff911c1f95ad15..ca2e6ebef1597ad06db10ca6e0108676655b528e 100644 --- a/checklist.md +++ b/checklist.md @@ -8,6 +8,9 @@ The course runs every session each year: Fall, Spring, Summer. The UAB Academic ### Instructor of Record +- At least one month prior to start of classes, contact departments to get courses listed. + - [ ] GBSC: Olivia Barnes (<ochood@uab.edu>) + - [ ] IDNE: Kristina Barlow (<kbarlow@uab.edu>) - [ ] Merge GBSC and IDNE sections. - Must be done by [IOR](#abbreviations). - Please visit [Canvas: Course Cross-Listing SLA page](https://uabprod.service-now.com/service_portal?id=sc_cat_item&sys_id=393e9275377d630024a67c1643990e27). @@ -23,14 +26,14 @@ The course runs every session each year: Fall, Spring, Summer. The UAB Academic - [ ] Set up the Syllabus Affirmation Assignment 1. Navigate to Quizzes page. - 2. Click "+ Quiz" button. - 3. Select "Classic Quizzes". - 4. Click "Submit" button. - 5. Enter in first text entry box: `Syllabus Affirmation`. - 6. Enter in the "Quiz Instructions" text entry box: + 1. Click "+ Quiz" button. + 1. Select "Classic Quizzes". + 1. Click "Submit" button. + 1. Enter in first text entry box: `Syllabus Affirmation`. + 1. Enter in the "Quiz Instructions" text entry box: > "In a new window, please read the Syllabus, then return here to complete the affirmation." - 7. Create a link to the Syllabus Course Page at the word "Syllabus" in the previous step. - 8. Set the following field values in the remainder of the form. + 1. Create a link to the Syllabus Course Page at the word "Syllabus" in the previous step. + 1. Set the following field values in the remainder of the form. - Quiz Type: `Graded Quiz` - Assignment Group: `Assignments` - Options: @@ -50,28 +53,28 @@ The course runs every session each year: Fall, Spring, Summer. The UAB Academic - Assign to: `Everyone` - Due: Wednesday of 2nd week. - Available from/until: both blank - 9. Click "Questions" tab. - 10. Click "+ New Question". + 1. Click "Questions" tab. + 1. Click "+ New Question". - In the top-left Text Entry box enter "First Demonstration Due Date" - In the Drop Down box select "Multiple Choice" - Enter the text "When is the first demonstration due?" in the main text entry box. - Make one answer the correct date (see the Syllabus for timings). - Make other answers other dates. - Click "Update Question". - 11. Click "Details" tab. - 12. Click "Save & Publish" button. + 1. Click "Details" tab. + 1. Click "Save & Publish" button. - [ ] Set up the [Demonstration Assignment HTML](demonstration_assignment.html) 1. Navigate to Assignments page. - 2. Click "+ Assignment" button. - 3. Enter Assignment Name in text entry box: `Demonstration #1`. - 4. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box. - 5. Copy-paste [HTML](demonstration_assignment.html) into text entry box. - 6. Update Syllabus link. + 1. Click "+ Assignment" button. + 1. Enter Assignment Name in text entry box: `Demonstration #1`. + 1. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box. + 1. Copy-paste [HTML](demonstration_assignment.html) into text entry box. + 1. Update Syllabus link. 1. On the first line is HTML tag that looks like `<a title="Syllabus" href="">`. - 2. Copy-paste Syllabus Page URL between double quotes after `href=`. - 7. Make any other necessary changes to the assignment HTML. Don't forget to update in the repository! - 8. Switch to WYSIWYG mode: click `</>` symbol again. - 9. Set the following field values in the remainder of the form. + 1. Copy-paste Syllabus Page URL between double quotes after `href=`. + 1. Make any other necessary changes to the assignment HTML. Don't forget to update in the repository! + 1. Switch to WYSIWYG mode: click `</>` symbol again. + 1. Set the following field values in the remainder of the form. - Points: `1` - Assignment Group: `Assignments` - Display Grade as: `Complete/Incomplete` @@ -90,35 +93,35 @@ The course runs every session each year: Fall, Spring, Summer. The UAB Academic | 10 weeks | 4th week | 7th week | 10th week | - Available from/until: blank - 10. Click save and publish! - 11. For `Demonstration #2` and `Demonstration #3`: + 1. Click save and publish! + 1. For `Demonstration #2` and `Demonstration #3`: 1. Go to the main Assignments page. - 2. Click the vertical three dots next to the `Demonstration #1` assignment you created. - 3. Click "Duplicate". - 4. On the new entry, click the vertical three dots, then "Edit Assignment". - 5. Modify the "Name" field appropriately. - 6. Click "Save & Publish". - 12. Verify the assignments are published in the Assignments main page, with a green checkmark icon next to each. + 1. Click the vertical three dots next to the `Demonstration #1` assignment you created. + 1. Click "Duplicate". + 1. On the new entry, click the vertical three dots, then "Edit Assignment". + 1. Modify the "Name" field appropriately. + 1. Click "Save & Publish". + 1. Verify the assignments are published in the Assignments main page, with a green checkmark icon next to each. - [ ] Upload [Syllabus HTML](syllabus.html) 1. Navigate to Syllabus page. - 2. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box. - 3. Copy-paste [HTML](syllabus.html) into text entry box. - 4. Update Syllabus Affirmation assignment link. + 1. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box. + 1. Copy-paste [HTML](syllabus.html) into text entry box. + 1. Update Syllabus Affirmation assignment link. 1. Look for the HTML tags like `<a title="Syllabus Affirmation" href="">`. - 2. For each one, add the appropriate assignment page path, which should look like `/courses/$course_number/quizzes/$quiz_number`, e.g. like `/courses/1601187/assignments/2325855`. This can be found by visiting the assignment to get the `$course_number` and `$assignment_number` values. - 3. Only the trailing part of the URL starting with `/courses` is needed. The leading `/` is required. - 5. Update Demonstration assignment links. + 1. For each one, add the appropriate assignment page path, which should look like `/courses/$course_number/quizzes/$quiz_number`, e.g. like `/courses/1601187/assignments/2325855`. This can be found by visiting the assignment to get the `$course_number` and `$assignment_number` values. + 1. Only the trailing part of the URL starting with `/courses` is needed. The leading `/` is required. + 1. Update Demonstration assignment links. 1. Look for the three HTML tags like `<a title="Demonstration #1" href="">`. - 2. For each one, add the appropriate assignment page path, which should look like `/courses/$course_number/assignments/$assignment_number`, e.g. like `/courses/1601187/assignments/6860919`. This can be found by visiting the assignment to get the `$course_number` and `$assignment_number` values. - 3. Only the trailing part of the URL starting with `/courses` is needed. The leading `/` is required. - 6. Switch to WYSIWYG mode: click `</>` symbol again. - 7. Check "Show Course Summary" checkbox. - 8. Verify formatting is correct. - 9. Update syllabus at <https://s3.lts.rc.uab.edu/uab-rc-dsjc/syllabus.html> by manual upload. + 1. For each one, add the appropriate assignment page path, which should look like `/courses/$course_number/assignments/$assignment_number`, e.g. like `/courses/1601187/assignments/6860919`. This can be found by visiting the assignment to get the `$course_number` and `$assignment_number` values. + 1. Only the trailing part of the URL starting with `/courses` is needed. The leading `/` is required. + 1. Switch to WYSIWYG mode: click `</>` symbol again. + 1. Check "Show Course Summary" checkbox. + 1. Verify formatting is correct. + 1. Update syllabus at <https://s3.lts.rc.uab.edu/uab-rc-dsjc/syllabus.html> by manual upload. - [ ] Set up Home page. 1. Navigate to Home page. - 2. Click "Choose Home Page" button. - 3. Select "Syllabus". + 1. Click "Choose Home Page" button. + 1. Select "Syllabus". - [ ] Set up Settings page. - Navigation tab: - Disable all except: @@ -143,12 +146,12 @@ The course runs every session each year: Fall, Spring, Summer. The UAB Academic - [ ] Publish the course. May need to be done by IOR. - [ ] Make an announcement welcoming new students. 1. Navigate to Announcements Page. - 2. Click `+ Announcements` button. - 3. Enter Topic Title as "Welcome to the Data Science Journal Club course!" - 4. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box. - 5. Copy-paste [HTML](welcome_announcement.html) into text entry box. - 6. Switch to WYSIWYG mode: click `</>` symbol again. - 7. Modify as necessary to be relevant to the current session. + 1. Click `+ Announcements` button. + 1. Enter Topic Title as "Welcome to the Data Science Journal Club course!" + 1. Switch text entry box to raw HTML mode by clicking `</>` symbol at bottom-right of box. + 1. Copy-paste [HTML](welcome_announcement.html) into text entry box. + 1. Switch to WYSIWYG mode: click `</>` symbol again. + 1. Modify as necessary to be relevant to the current session. ## Important Information @@ -156,14 +159,14 @@ The course runs every session each year: Fall, Spring, Summer. The UAB Academic | Course Title | UAB Title | Name | email | | :------------------- | :--------------------------- | :------------------- | :----------------- | -| Instructor of Record | Associate Professor | Kristina M. Visscher | <kmv@uab.edu> | -| Instructor | RC Facilitation Manager | William Warriner | <wwarr@uab.edu> | +| Instructor of Record | RC Facilitation Manager | William Warriner | <wwarr@uab.edu> | | Instructor | RC Facilitator (Scientist I) | Matthew Defenderfer | <mdefende@uab.edu> | -| Instructor | RC Facilitator (Scientist I) | Prema Soundararajan | <prema@uab.edu> | +| Instructor | RC Facilitator (Scientist I) | Prema Soundararajan | <prema@uab.edu> | ### Relevant Pages - UAB Academic Calendar: <https://www.uab.edu/students/academics/academic-calendar> +- UAB E-Learning Support Canvas Requests: <https://www.uab.edu/elearning/services/canvas-requests> ### Abbreviations diff --git a/demonstration_assignment.html b/demonstration_assignment.html index 4ea448c3d8eb89deffc753946f5017d0baec6c55..3c324ce27d7415f2df31dbb88e56040aab1c3a37 100644 --- a/demonstration_assignment.html +++ b/demonstration_assignment.html @@ -1,7 +1,15 @@ -<p>Bear in mind objectives and resources from the <a title="Syllabus" href="">Syllabus</a>:</p> +<p> + Bear in mind objectives and resources from the + <a title="Syllabus" href="">Syllabus</a> + : +</p> <ol start="1" type="1"> -<li>Learn new data science stuff</li> -<li>Grapple with that new stuff</li> -<li>Discuss that new stuff with us at Office Hours</li> + <li>Learn new data science stuff</li> + <li>Grapple with that new stuff</li> + <li>Discuss that new stuff with us at Office Hours</li> </ol> -<p>Office Hours are held Mondays and Thursdays from 10 AM to noon via Zoom. Meeting links are available at <a class="inline_disabled" href="https://docs.rc.uab.edu/#how-to-contact-us" target="_blank" rel="noopener noreferrer">https://docs.rc.uab.edu/#how-to-contact-us</a>.</p> \ No newline at end of file +<p> + Office Hours are held Mondays and Thursdays from 10 AM to noon via Zoom. Meeting links are available at + <a class="inline_disabled" href="https://docs.rc.uab.edu/#how-to-contact-us" target="_blank" rel="noopener noreferrer">https://docs.rc.uab.edu/#how-to-contact-us</a> + . +</p> diff --git a/syllabus.html b/syllabus.html index 1f6216604f317b2c0abcf19a5ff32f9fd7938ae9..643448f8a84ed21385a024e8f085d8e6dedaba82 100644 --- a/syllabus.html +++ b/syllabus.html @@ -1,76 +1,113 @@ -<h2 id="top_">SP2024 GBSC/IDNE 720/790-VTR JC- Data Science Club</h2> +<h2 id="top_">SU2025 GBSC/IDNE 720/790-VTR JC- Data Science Club</h2> -<p>Welcome!</p> -<p>The Data Science Journal Club course comes from a collaboration between the UAB IT Research Computing (RC) group, the Graduate Biomedical Sciences (GBSC) department and the Neuroengineering (IDNE) department. The course exists to foster knowledge transfer between Research Computing and students interested in growing their data science, programming and high-performance computing skill set. Future years will see increasing demand for these skills in every employment sector. Our goal is to enable students to be more competitive in their future careers by facilitating self-directed growth in the data science space. We accept students at all skill levels of data science, assuming familiarity with computers and graphical plots.</p> -<p>While the course is mostly self-directed and hands-off, we don't want students to get lost. We want you to be successful and come away from this course feeling confident in applying the skills you have learned. If you have concerns, get stuck, need ideas or even a <a href="https://en.wikipedia.org/wiki/Rubber_duck_debugging">rubber duck</a>, please feel free to contact us.</p> +<h3>Welcome!</h3> +<p>The Data Science Journal Club course originated from a collaboration between the UAB IT Research Computing (RC) group, the Graduate Biomedical Sciences (GBSC) department and the Neuroengineering (IDNE) department. The course exists to foster knowledge transfer between Research Computing and students interested in growing their data science, programming and high-performance computing skill set. Future years will see increasing demand for these skills in every employment sector. Our goal is to enable students to be more competitive in their future careers by facilitating self-directed growth in the data science space. We accept students at all skill levels of data science, assuming familiarity with computers and graphical plots.</p> +<p> + While the course is mostly self-directed and hands-off, we don't want students to get lost. We want you to be successful and come away from this course feeling confident in applying the skills you have learned. If you have concerns, get stuck, need ideas or even a + <a href="https://en.wikipedia.org/wiki/Rubber_duck_debugging">rubber duck</a> + , please feel free to contact us. +</p> <p> </p> <p>Please take the time to read this syllabus in its entirety. All of the information here should be useful as you work through the course.</p> <p> </p> <h3>Instructor Information:</h3> -<p>Course Instructors (please contact us first!)</p> -<p>William Warriner (he/him), <a href="mailto:wwarr@uab.edu" target="_blank" rel="noopener">wwarr@uab.edu</a></p> -<p>Matthew Defenderfer, <a href="mailto:mdefende@uab.edu" target="_blank" rel="noopener">mdefende@uab.edu</a></p> -<p>Prema Soundararajan, <a href="mailto:prema@uab.edu" target="_blank" rel="noopener">prema@uab.edu</a></p> -<p>Office Hours information is available here: <a class="inline_disabled" href="https://docs.rc.uab.edu/#how-to-contact-us" target="_blank" rel="noopener">https://docs.rc.uab.edu/#how-to-contact-us</a></p> <p> </p> -<p>Instructor of Record (please contact only as a last resort!)</p> -<p>Kristina Visscher, <a href="mailto:kmv@uab.edu" target="_blank" rel="noopener">kmv@uab.edu</a></p> +<p>Instructor of Record:</p> +<p> + William Warriner (he/him), + <a href="mailto:wwarr@uab.edu" target="_blank" rel="noopener">wwarr@uab.edu</a> +</p> <p> </p> +<p>Course Instructors:</p> +<p> + Matthew Defenderfer, + <a href="mailto:mdefende@uab.edu" target="_blank" rel="noopener">mdefende@uab.edu</a> +</p> +<p> + Prema Soundararajan, + <a href="mailto:prema@uab.edu" target="_blank" rel="noopener">prema@uab.edu</a> +</p> +<p> + Office Hours information is available here: + <a class="inline_disabled" href="https://docs.rc.uab.edu/#contact-us" target="_blank" rel="noopener">https://docs.rc.uab.edu/#contact-us</a> +</p> <h3 id="oae">Office of Access and Engagement:</h3> +<p>The University of Alabama at Birmingham considers all its students, faculty, and staff to be a strength and critical to its educational mission. In this class, we will strive to be a community where we can learn from the many perspectives and worldviews which may differ from our own. We are all expected to contribute to creating a respectful, welcoming, and safe environment that fosters a sense of belonging through open and honest dialogue. To this end, we should always conduct discussions in a way that honors, respects, and extends dignity to all class members.</p> <p>The Office of Access & Engagement works to promote success for everyone in the UAB community. We work to address challenges faced by our students, faculty and staff to ensure everyone has access to available programs and resources they need to promote success and retention, and to foster an accessible and welcoming culture.</p> <p>Since its founding, UAB has played a pivotal role in shaping the future in Birmingham and beyond by making a positive difference in as many lives as possible. We do this by serving all people — a commitment that continues today through our vision, mission and shared values.</p> <p>The Office of Access & Engagement strives to make sure every member of the UAB community has access to available programs and resources they need, recognizing that some students, faculty and staff may face more barriers and have a greater need for additional support than others due to their circumstances.</p> -<p>Please visit <a class="inline_disabled" href="https://www.uab.edu/access-engagement/students" target="_blank" rel="noopener">The Office of Access and Engagement Website</a> for more information.</p> -<p> </p> +<p> + Note: This OAE section has replaced the previous section on DEI (Diversity, Equity, and Inclusion) to comply with + <a href="https://alison.legislature.state.al.us/files/pdf/SearchableInstruments/2024RS/SB129-enr.pdf" target="_blank" rel="noopener">AL-SB129-2024</a> + . +</p> +<p> + Please visit + <a class="inline_disabled" href="https://www.uab.edu/access-engagement/students" target="_blank" rel="noopener">The Office of Access and Engagement Website</a> + for more information. +</p> -<h3 id="intent">Course Intent:<strong><br /></strong></h3> +<h3 id="intent">Course Intent:</h3> <p>Our intent with the course has three parts. The first is for students to learn new techniques and technologies to assist with or facilitate data science. The second is for students to grapple with the application of those techniques and technologies. The third is to discuss with us how that went so we can check understanding and provide mentoring and guidance. We also love seeing all the cool stuff our students learn, and frequently find ourselves learning new perspectives, details, gotchas and technologies in the process.</p> <p>To summarize students will:</p> <ol start="1" type="1"> -<li>Learn new data science related stuff</li> -<li>Grapple with that new stuff</li> -<li>Discuss that new stuff with us</li> + <li>Learn new data science related stuff</li> + <li>Grapple with that new stuff</li> + <li>Discuss that new stuff with us</li> </ol> <p> </p> <h3 id="work">Required Work:</h3> -<p>All students are required to give three demonstrations<strong></strong></p> +<p> + All students are required to give three demonstrations + <strong></strong> +</p> <ul> -<li>during any office hours, one per visit...</li> -<li>...in a student-led informal discussion style.</li> -<li>Students may collaborate on projects...</li> -<li>...but each student must show their original work.</li> -<li>Each demonstration must be data science related or somehow facilitate data science.</li> + <li>during any office hours, one per visit...</li> + <li>...in a student-led informal discussion style.</li> + <li>Students may collaborate on projects...</li> + <li>...but each student must show their original work.</li> + <li>Each demonstration must be data science related or somehow facilitate data science.</li> </ul> -<p>We realize the last bullet point is very broad. This is intentional as we account for student knowledge, skill and experience when you give your demonstrations. We have no expectations of student starting skill level or experience. With that in mind, examples of past topics are included in the following list. If you have an idea but are unsure if it would be sufficient material, please feel free to contact us.</p> +<p>We realize the last bullet point is very broad, so we account for student knowledge, skill and experience when you give your demonstrations. We have no expectations of student starting skill level or experience. With that in mind, examples of past topics are included in the following list. If you have an idea but are unsure if it would be sufficient material, please feel free to contact us.</p> <ul> -<li>Using machine learning or deep learning to create a predictive model.</li> -<li>Creating your very first Anaconda environment to share with collaborators.</li> -<li>Learning to use version control (git and github) with your existing code.</li> -<li>Extracting insights from existing results by applying new visualization methods.</li> -<li>Migrating a data analysis workflow from Excel to Python and pandas.</li> -<li>Scaling a data analysis workflow from a lab workstation to Cheaha.</li> -<li>Exploring a new programming language.</li> -<li>Writing your very first script in any programming language.</li> -<li>Identifying and extracting salient features from complex data for further processing.</li> -<li>Understand what makes data tidy and why it is important.</li> + <li>Using machine learning or deep learning to create a predictive model.</li> + <li>Creating your very first Anaconda environment to share with collaborators.</li> + <li>Learning to use version control (git and github) with your existing code.</li> + <li>Extracting insights from existing results by applying new visualization methods.</li> + <li>Migrating a data analysis workflow from Excel to Python and pandas.</li> + <li>Scaling a data analysis workflow from a lab workstation to Cheaha.</li> + <li>Exploring a new programming language.</li> + <li>Writing your very first script in any programming language.</li> + <li>Identifying and extracting salient features from complex data for further processing.</li> + <li>Understand what makes data tidy and why it is important.</li> </ul> <p>As you prepare for your demonstrations, please be thinking about the context of your work. An incomplete list of questions to guide your thoughts about context.</p> <ul> -<li>What are some drawbacks or limitations?</li> -<li>How does it compare to alternatives?</li> -<li>How does it work?</li> -<li>Why does it work?</li> -<li>Where can we go next?</li> -<li>Why will others want to use my work?</li> -<li>How can I transfer techniques to other projects?</li> + <li>What are some drawbacks or limitations?</li> + <li>How does it compare to alternatives?</li> + <li>How does it work?</li> + <li>Why does it work?</li> + <li>Where can we go next?</li> + <li>Why will others want to use my work?</li> + <li>How can I transfer techniques to other projects?</li> </ul> <p>Be prepared for us to challenge you with new ways of thinking!</p> -<p><strong>We are less interested in what your results are, and more interested in how you obtained those results and how they fit into the context of data science in general and your field in particular.<br /></strong></p> +<p> + <strong> + We are less interested in what your results are, and more interested in how you obtained those results and how they fit into the context of data science in general and your field in particular. + <br /> + </strong> +</p> <p>If you are not able to make the office hours sessions, please contact us as soon as possible to make alternative arrangements.</p> -<p><strong>The date of the final Demonstration in the course summary below is the last day of final exams, and therefore the final due date for all work. Please plan ahead to finish all assignments before that date. We cannot accept work after the due dates below without prior, individual discussion.<br /></strong></p> +<p> + <strong> + The dates in the course summary below are the last day of final exams, and therefore the due dates for the demonstrations. Please plan ahead to finish all three of them before that date. We cannot accept work after the due dates below without prior, individual discussion. + <br /> + </strong> +</p> <p> </p> <h3 id="grading">Grading:</h3> @@ -78,69 +115,179 @@ <p>Grading is based on a syllabus attestation, due on the second Wednesday of classes, and on demonstrations. Three demonstrations are required, and each has its own assignment within Canvas.</p> <p>Due dates progress throughout the semester:</p> <ul> -<li><a title="Syllabus Affirmation" href="" data-course-type="assignments" data-published="true">Syllabus Affirmation</a> is due by the 2nd Wednesday.</li> -<li><a title="Demonstration #1" href="" data-course-type="assignments" data-published="true">Demonstration #1</a> is due by the 6th Friday.</li> -<li><a title="Demonstration #2" href="" data-course-type="assignments" data-published="true">Demonstration #2</a> is due by the 10th Friday.</li> -<li><a title="Demonstration #3" href="" data-course-type="assignments" data-published="true">Demonstration #3</a> is due by the last Friday.</li> + <li> + <a title="Syllabus Affirmation" href="/courses/1620729/quizzes/2325855" data-course-type="assignments" data-published="true">Syllabus Affirmation</a> + is due by the 2nd Wednesday. + </li> + <li> + <a title="Demonstration #1" href="/courses/1620729/assignments/7043517" data-course-type="assignments" data-published="true">Demonstration #1</a> + is due by the 6th Friday. + </li> + <li> + <a title="Demonstration #2" href="/courses/1620729/assignments/7043519" data-course-type="assignments" data-published="true">Demonstration #2</a> + is due by the 10th Friday. + </li> + <li> + <a title="Demonstration #3" href="/courses/1620729/assignments/7043518" data-course-type="assignments" data-published="true">Demonstration #3</a> + is due by the last Friday. + </li> </ul> -<p>Because office hours are open to potentially hundreds of researchers outside the scope of this course, <strong>only one session can be presented per student per office hours visit.</strong> <strong><em>Please plan accordingly.</em></strong></p> +<p> + Because office hours are open to potentially hundreds of researchers outside the scope of this course, + <strong>only one session can be presented per student per office hours visit.</strong> + <strong> + <em>Please plan accordingly.</em> + </strong> +</p> <p>If for any reason you are not able to adhere to the above requirements, please contact us as soon as you know so we can make plans to accommodate you. Remember, we want you to be successful!</p> <p> </p> <h3 id="scheduling">Scheduling, Attendance & Office Hours:</h3> <p>Our course may differ from the typical university course experience. We do not host regularly scheduled course meetings. Instead, we offer twice-weekly office hours. The office hours serve two purposes for this course.</p> -<ol style="list-style-type: decimal;"> -<li>Each student must make three office hours visits for the three demonstrations.</li> -<li>Students are encouraged to attend office hours if they have questions that are best answered in a virtual meeting. Past examples include:</li> +<ol style="list-style-type: decimal"> + <li>Each student must make three office hours visits for the three demonstrations.</li> + <li>Students are encouraged to attend office hours if they have questions that are best answered in a virtual meeting. Past examples include:</li> </ol> <ul> -<li style="list-style-type: none;"> -<ul style="list-style-type: disc;"> -<li>Is my topic suitable for this course?</li> -<li>Where can I find more resources on topics?</li> -<li>Can you preview my demonstration material?</li> -<li>Am I on the right track?</li> -</ul> -</li> + <li style="list-style-type: none"> + <ul style="list-style-type: disc"> + <li>Is my topic suitable for this course?</li> + <li>Where can I find more resources on topics?</li> + <li>Can you preview my demonstration material?</li> + <li>Am I on the right track?</li> + </ul> + </li> </ul> -<p>Office Hours are held Mondays and Thursdays from 10 AM to noon via Zoom. Meeting links are available at our documentation (<a href="https://docs.rc.uab.edu/#how-to-contact-us" target="_blank" rel="noopener">https://docs.rc.uab.edu/#how-to-contact-us</a>).</p> +<p> + Office Hours are held Mondays and Thursdays from 10 AM to noon via Zoom. Meeting links are available at our documentation ( + <a href="https://docs.rc.uab.edu/#contact-us" target="_blank" rel="noopener">https://docs.rc.uab.edu/#contact-us</a> + ). +</p> <p> </p> <h3 id="resources">Course Resources:</h3> -<p>For students who are just entering the data science space, please consider trying some of Kaggle's micro-courses on data analysis, visualization and machine learning: <a class="inline_disabled" href="https://www.kaggle.com/learn" target="_blank" rel="noopener">https://www.kaggle.com/learn</a>.</p> -<p>For students who want to develop skills to facilitate data science, see the Software Carpentry's list of lessons: <a class="inline_disabled" href="https://software-carpentry.org/lessons/" target="_blank" rel="noopener">https://software-carpentry.org/lessons/</a>. These lessons include the Unix shell, Git version control and programming skills in Python and R.</p> -<p>For students who want to develop data literacy skills in the context of specific fields, see the Data Carpentry's list of lessons: <a class="inline_disabled" href="https://datacarpentry.org/lessons/" target="_blank" rel="noopener">https://datacarpentry.org/lessons/</a>. One of the included fields is genomics, which may be of particular interest to many UAB students.</p> -<p>For students interested in learning more about any of the above with a focus on scaling with high-performance computing, we maintain a YouTube channel with some Data Science Club Material to get you started using Cheaha: <a class="external" href="https://www.youtube.com/channel/UCZoOS2e699Ge0DND1oy1BJQ" target="_blank" rel="noopener"><span>https://www.youtube.com/channel/UCZoOS2e699Ge0DND1oy1BJQ</span></a>.</p> -<p>Here is a list of free data science resources and starting points: <a class="inline_disabled" title="Link" href="https://www.datapen.io/" target="_blank" rel="noopener">https://www.datapen.io/</a>. The following link narrows those resources down to just courses <a class="inline_disabled" title="Link" href="https://www.datapen.io/resources/free-course-resources" target="_blank" rel="noopener">https://www.datapen.io/resources/free-course-resources</a>.</p> +<p> + For students who are just entering the data science space, please consider trying some of Kaggle's micro-courses on data analysis, visualization and machine learning: + <a class="inline_disabled" href="https://www.kaggle.com/learn" target="_blank" rel="noopener">https://www.kaggle.com/learn</a> + . +</p> +<p> + For students who want to develop skills to facilitate data science, see the Software Carpentry's list of lessons: + <a class="inline_disabled" href="https://software-carpentry.org/lessons/" target="_blank" rel="noopener">https://software-carpentry.org/lessons/</a> + . These lessons include the Unix shell, Git version control and programming skills in Python and R. +</p> +<p> + For students who want to develop data literacy skills in the context of specific fields, see the Data Carpentry's list of lessons: + <a class="inline_disabled" href="https://datacarpentry.org/lessons/" target="_blank" rel="noopener">https://datacarpentry.org/lessons/</a> + . One of the included fields is genomics, which may be of particular interest to many UAB students. +</p> +<p> + For students interested in learning more about any of the above with a focus on scaling with high-performance computing, we maintain a YouTube channel with some Data Science Club Material to get you started using Cheaha: + <a class="external" href="https://www.youtube.com/channel/UCZoOS2e699Ge0DND1oy1BJQ" target="_blank" rel="noopener"> + <span>https://www.youtube.com/channel/UCZoOS2e699Ge0DND1oy1BJQ</span> + </a> + . +</p> +<p> + Here is a list of free data science resources and starting points: + <a class="inline_disabled" title="Link" href="https://www.datapen.io/" target="_blank" rel="noopener">https://www.datapen.io/</a> + . The following link narrows those resources down to just courses + <a class="inline_disabled" title="Link" href="https://www.datapen.io/resources/free-course-resources" target="_blank" rel="noopener">https://www.datapen.io/resources/free-course-resources</a> + . +</p> <p>Feel free to seek out and use other sources! If you do so, please inform us of those sources so we can curate our list and better serve future students.</p> <p> </p> +<h3 id="resources">Usage of Artificial Intelligence (AI):</h3> +<p>We encourage you to responsibly explore usage of AI. As always, beware of AI nonsense or "hallucinations". As a budding technologist, we want you to be aware that "hallucintaion" is a marketing term. We prefer to call it what is: nonsense. Nevertheless, the term of art is "hallucination" so, to avoid confusion, we will continue using that term.</p> +<p> + You should be aware that hallucinations are a + <a href="https://arxiv.org/abs/2409.05746">mathematical certainty</a> + and undetectable without independent verification. In other words, you need to already understand the AI's output (and its relationship to reality) well enough to be able to spot hallucinations. Alternatively, you can have an expert check the output.Otherwise, you cannot hope to spot hallucinations reliably. And, now that you are aware of these facts, you should be aware it would be + <a href="https://en.wikipedia.org/wiki/Intellectual_honesty">intellectually dishonest</a> + to pretend AI output is valid or truthful when you haven't verified. **Always verify AI output!** +</p> +<p> + You may use AI to assist with the development of any demonstration assignments, subject to the + <a href="https://www.uab.edu/ai/guidelines-principles">UAB AI guidelines</a> + , and our additional, course-specific guidelines below. +</p> +<ul> + <li>You may not use AI to do content development work for you, it may only be used assist.</li> + <li>You may not use AI to present work, it may only assist you in a manner, except as consistent with accomodations.</li> + <li>You may not use AI to assist with quizzes, tests, or any assessments.</li> + <li>If you use AI to assist you in this course, then you must report your usage of AI as part of relevant demonstrations. This applies both as demonstration content and assistance when developing content. (We'd like to learn more about how AI can be used, too!)</li> + <li>You are responsible for the correctness and accuracy of your work, regardless of AI use.</li> + <li>Remember, the purpose of the course is for you to learn something and show off what you learned. Don't replace your mind with AI. This is a chance for you to shine, so don't let the AI outshine you!</li> +</ul> + <h3>Frequently Asked Questions:</h3> + <h4>I'm completely new to data science, what are some good starting points?</h4> <ul> -<li>To get started with general data science tools and techniques, try Kaggle Learn: <a href="https://www.kaggle.com/learn" target="_blank" rel="noopener">https://www.kaggle.com/learn</a></li> -<li>Check out the Data Carpentries Lessons: <a href="https://datacarpentry.org/lessons/" target="_blank" rel="noopener">https://datacarpentry.org/lessons/</a></li> -<li>For starting bioinformatics, also try Rosalind.info: <a href="https://rosalind.info/problems/locations/" target="_blank" rel="noopener">https://rosalind.info/problems/locations/</a></li> + <li> + To get started with general data science tools and techniques, try Kaggle Learn: + <a href="https://www.kaggle.com/learn" target="_blank" rel="noopener">https://www.kaggle.com/learn</a> + </li> + <li> + Check out the Data Carpentries Lessons: + <a href="https://datacarpentry.org/lessons/" target="_blank" rel="noopener">https://datacarpentry.org/lessons/</a> + </li> + <li> + For starting bioinformatics, also try Rosalind.info: + <a href="https://rosalind.info/problems/locations/" target="_blank" rel="noopener">https://rosalind.info/problems/locations/</a> + </li> </ul> + <h4>What tools are available to make it easier to manage my projects?</h4> <ul> -<li>We suggest using Git! Learn more at: <a href="https://swcarpentry.github.io/git-novice/" target="_blank" rel="noopener">https://swcarpentry.github.io/git-novice/</a></li> + <li> + We suggest using Git! Learn more at: + <a href="https://swcarpentry.github.io/git-novice/" target="_blank" rel="noopener">https://swcarpentry.github.io/git-novice/</a> + </li> </ul> + <h4>Am I allowed to use my own research projects for this course?</h4> <ul> -<li>Yes, and we encourage applying new tools and techniques! Be mindful that we can't accept any work for research protected by IRB or using PHI/HIPAA data. Be sure to get your supervisor's approval first.</li> + <li>Yes, and we encourage applying new tools and techniques! Be mindful that we can't accept any work for research protected by IRB or using PHI/HIPAA data. Be sure to get your supervisor's approval first.</li> </ul> -<p> </p> <h3 id="support">Technical Support:</h3> -<p>Cheaha Documentation: <a class="external" href="https://docs.rc.uab.edu" target="_blank" rel="noopener">https://docs.rc.uab.edu</a>.</p> -<p>Cheaha Web Portal: <a class="external" href="https://rc.uab.edu" target="_blank" rel="noopener">https://rc.uab.edu</a>.</p> -<p>If you need software installed, or something just doesn't work like you expect, please email us at <a href="mailto:support@listserv.uab.edu" target="_blank" rel="noopener">support@listserv.uab.edu</a>. When asking for help, consider including all relevant details about your goal, what you tried, what you expected to happen, what actually happened, steps needed to reproduce the issue, and any error messages. If the error messages are longer than about 10 lines, copy-paste them into a text document and attach that to the email instead. Screenshots are also helpful. See our documentation on support (<a href="https://docs.rc.uab.edu/help/support" target="_blank" rel="noopener">https://docs.rc.uab.edu/help/support</a>) for more information.</p> +<p> + Research Computing Official Site: + <a class="external" href="https://www.uab.edu/it/home/research-computing" target="_blank" rel="noopener">https://www.uab.edu/it/home/research-computing</a> + . +</p> +<p> + Cheaha Documentation: + <a class="external" href="https://docs.rc.uab.edu" target="_blank" rel="noopener">https://docs.rc.uab.edu</a> + . +</p> +<p> + Cheaha Web Portal: + <a class="external" href="https://rc.uab.edu" target="_blank" rel="noopener">https://rc.uab.edu</a> + . +</p> +<p> + If you need software installed, or something just doesn't work like you expect, please email us at + <a href="mailto:support@listserv.uab.edu" target="_blank" rel="noopener">support@listserv.uab.edu</a> + . When asking for help, consider including all relevant details about your goal, what you tried, what you expected to happen, what actually happened, steps needed to reproduce the issue, and any error messages. If the error messages are longer than about 10 lines, copy-paste them into a text document and attach that to the email instead. Screenshots are also helpful. See our documentation on support ( + <a href="https://docs.rc.uab.edu/help/support" target="_blank" rel="noopener">https://docs.rc.uab.edu/help/support</a> + ) for more information. +</p> <p> </p> <h3>Title IX Statement:</h3> -<p>In accordance with Title IX, the University of Alabama at Birmingham does not discriminate on the basis of gender in any of its programs or services. The University is committed to providing an environment free from discrimination based on gender and expects individuals who live, work, teach, and study within this community to contribute positively to the environment and to refrain from behaviors that threaten the freedom or respect that every member of our community deserves. For more information about Title IX, policy, reporting, protections, resources and supports, please visit the <a class="inline_disabled" href="http://www.uab.edu/titleix" target="_blank" rel="noopener">UAB Title IX webpage</a> for UAB’s Title IX Sex Discrimination, Sexual Harassment, and Sexual Violence Policy; UAB’s Equal Opportunity and Discriminatory Harassment Policy; and the Duty to Report and Non-Retaliation Policy.</p> +<p> + In accordance with Title IX, the University of Alabama at Birmingham does not discriminate on the basis of gender in any of its programs or services. The University is committed to providing an environment free from discrimination based on gender and expects individuals who live, work, teach, and study within this community to contribute positively to the environment and to refrain from behaviors that threaten the freedom or respect that every member of our community deserves. For more information about Title IX, policy, reporting, protections, resources and supports, please visit the + <a class="inline_disabled" href="http://www.uab.edu/titleix" target="_blank" rel="noopener">UAB Title IX webpage</a> + for UAB’s Title IX Sex Discrimination, Sexual Harassment, and Sexual Violence Policy; UAB’s Equal Opportunity and Discriminatory Harassment Policy; and the Duty to Report and Non-Retaliation Policy. +</p> <p> </p> -<h3 id="dss">Disability Support Services (DSS) Statement<strong>:<br /></strong></h3> -<p>UAB is committed to providing an accessible learning experience for all students. If you are a student with a disability that qualifies under the Americans with Disabilities Act (ADA) and/or Section 504 of the Rehabilitation Act, and you require accommodations, please contact Disability Support Services for information on accommodations, registration, and procedures. Requests for reasonable accommodations involve an interactive process and consist of a collaborative effort among the student, DSS, faculty and staff. If you are registered with Disability Support Services, please contact me to discuss accommodations that may be necessary in this course. If you have a disability but have not contacted Disability Support Services, please call (205) 934-4205 or visit the <a class="inline_disabled" href="http://www.uab.edu/dss" target="_blank" rel="noopener">DSS website</a>.</p> +<h3 id="dss">Disability Support Services (DSS) Statement:</h3> +<p> + UAB is committed to providing an accessible learning experience for all students. If you are a student with a disability that qualifies under the Americans with Disabilities Act (ADA) and/or Section 504 of the Rehabilitation Act, and you require accommodations, please contact Disability Support Services for information on accommodations, registration, and procedures. Requests for reasonable accommodations involve an interactive process and consist of a collaborative effort among the student, DSS, faculty and staff. If you are registered with Disability Support Services, please contact me to discuss accommodations that may be necessary in this course. If you have a disability but have not contacted Disability Support Services, please call (205) 934-4205 or visit the + <a class="inline_disabled" href="http://www.uab.edu/dss" target="_blank" rel="noopener">DSS website</a> + . +</p> diff --git a/welcome_announcement.html b/welcome_announcement.html index 594fb0d1df507c8b6bdc70205961eb8282b11ec8..b4c5e5a7fbc8b1b7b81822de63ab944b2f8b42e5 100644 --- a/welcome_announcement.html +++ b/welcome_announcement.html @@ -1,4 +1,10 @@ <p>Hello everyone and welcome to Data Science Journal Club (DSJC)!</p> -<p>Please take a few minutes to read over the <a title="Syllabus" href="" data-course-type="navigation">syllabus</a> as it is the central repository for information about this course. There is a required, single-question, <a title="Syllabus Affirmation" href="" data-course-type="assignments" data-published="true">Syllabus Affirmation</a> quiz due the Wednesday of next week.</p> +<p> + Please take a few minutes to read over the + <a title="Syllabus" href="" data-course-type="navigation">syllabus</a> + as it is the central repository for information about this course. There is a required, single-question, + <a title="Syllabus Affirmation" href="" data-course-type="assignments" data-published="true">Syllabus Affirmation</a> + quiz due the Wednesday of next week. +</p> <p>If you are new to the course, welcome! We hope you have an enlightening experience. We are happy to answer questions and provide guidance, please feel free to reach out with questions, and please read the syllabus for more detailed information about expectations.</p> -<p>If you are returning, welcome back! The syllabus may have information that is new and useful to you, we recommend reviewing it.</p> \ No newline at end of file +<p>If you are returning, welcome back! The syllabus may have information that is new and useful to you, we recommend reviewing it.</p>