Uploaded image for project: 'IGB'
  1. IGB
  2. IGBF-2539

On-Boarding: Step 0 - Module 1 of IGB course & running IGB

    Details

    • Type: Task
    • Status: Closed (View Workflow)
    • Priority: Major
    • Resolution: Done
    • Affects Version/s: None
    • Fix Version/s: None
    • Labels:
      None
    • Story Points:
      3
    • Sprint:
      Summer 5: 3 Aug - 14 Aug, Summer 6: 17 Aug - 28 Aug, Summer 7: 31 Aug - 11 Sep, Fall 1: 14 Sep - 25 Sep, Fall 2: 28 Sep - 9 Oct, Winter 3 Jan 25 - Feb 5, Winter 4 Feb 8 - Feb 19, Winter 5 Feb 22 - Mar 5, Spring 3 2021 Apr 19 - Apr 30, Summer 1 2023 May 15, Fall 3 2023 Oct 2, Fall 4, Fall 5

      Description

      Welcome to your first on-boarding task for the IGB core development team!

      We are super excited you have joined us! We hope you will enjoy your time with us and will make big contributions to the code base and the IGB community.

      For the next steps, please do the following tasks to get familiar with IGB and how it is used.

      Note that this issue has 3 story points.

      A "story point" is an estimate for how long a task ought to take. One day is roughly equal to one story point.

      This means you should expect to spend about three working days on this "on-boarding" task. Take your time on this task and explore the IGB interface to better understand how it works.

      Reading:

      IGB on-line canvas course:

      IGB documentation:

      Get started using IGB:

      1. Download and install the current release of IGB onto your computer from https://bioviz.org/
      2. Click the “install IGB” button in the top right. (The appropriate version for your operating system should be supplied for you.)
      3. Click the button to download IGB for your computer
      4. Run the downloaded file
      5. Follow the instructions in the setup wizard.
      6. Open and run the Integrated Genome Browser software.
      7. The IGB Quickstart webpage will open automatically in your web browser.
      8. IGB may take several seconds to launch.
      9. Using IGB, follow along and copy the actions shown in this video: https://www.youtube.com/watch?v=LjPNT1k9cqk
      10. Re-create the scene shown at the very end of the video.
      11. Then use the camera icon button in the IGB toolbar at the top, or go to File > Save Image to take a picture of IGB showing the scene at the end of the video;
      12. Upload that image here as an attachment (you can use the plus icon to the right of Attachments).
      13. Move the ticket to Needs 1st Level Review by clicking the Workflow dropdown button at the top (under the ticket name), and select Request Review. You could also drag the ticket over to the right one space from the Agile board > IGB > Work view.
      14. Since this might be the first ticket you do, and it needs to be completed before you move on to On-Boarding: Step 1 (Step 0 is a blocker for Step 1): Reach out to another developer here to review your ticket with you before you move on.

      Reviewers:

      • Watch https://www.youtube.com/watch?v=LjPNT1k9cqk
      • Confirm that the assignee has uploaded an image with graphs loaded and configured to the same scale as each other, as shown in the video
      • Confirm that the assignee has enrolled in the class. To do this select the People tab and look for the student’s name in the list.

        Attachments

        1. igb_1.0.png
          igb_1.0.png
          68 kB
        2. igb.png
          igb.png
          795 kB
        3. igb.png
          igb.png
          124 kB
        4. IGB.PNG
          IGB.PNG
          78 kB
        5. igb2.png
          igb2.png
          61 kB
        6. screenshot-1.png
          screenshot-1.png
          123 kB
        7. screenshot-2.png
          screenshot-2.png
          328 kB
        8. screenshot-3.png
          screenshot-3.png
          526 kB

          Issue Links

            Activity

            Hide
            inaylor Irvin Naylor (Inactive) added a comment -

            Feedback:

            Overall, this new version of the module is very straightforward and easy to follow. I was able to easily put myself in the shoes of someone new and easily walk through all seven steps. The only thing I might clarify is in step 7, telling them an indication of where the IGB toolbar is for the camera could be helpful especially if this might be their first time ever using IGB.

            Show
            inaylor Irvin Naylor (Inactive) added a comment - Feedback: Overall, this new version of the module is very straightforward and easy to follow. I was able to easily put myself in the shoes of someone new and easily walk through all seven steps. The only thing I might clarify is in step 7, telling them an indication of where the IGB toolbar is for the camera could be helpful especially if this might be their first time ever using IGB.
            Hide
            inaylor Irvin Naylor (Inactive) added a comment - - edited

            IGB screenshot attached:

            Potential bug in IGB 9.1.4:
            At the point where the user has loaded the data and is going to configure the graph tracks, selecting "select all" in the graph menu as the video describes does not seem to do anything. It worked before when I did it the first time, but now on subsequent tries, it doesn't. I've reinstalled 9.1.4 to make sure but it is still persisting. I just wanted to let you know and ask if there is any specific protocol on reporting bugs. The screenshot is of the next closest step before the graph track step, as a result.

            Show
            inaylor Irvin Naylor (Inactive) added a comment - - edited IGB screenshot attached: Potential bug in IGB 9.1.4: At the point where the user has loaded the data and is going to configure the graph tracks, selecting "select all" in the graph menu as the video describes does not seem to do anything. It worked before when I did it the first time, but now on subsequent tries, it doesn't. I've reinstalled 9.1.4 to make sure but it is still persisting. I just wanted to let you know and ask if there is any specific protocol on reporting bugs. The screenshot is of the next closest step before the graph track step, as a result.
            Hide
            rweidenh Logan Weidenhammer (Inactive) added a comment -

            Irvin Naylor
            Noted your comment on step 7 and will add that to the improvements.

            I just went through the steps and the "select all" worked fine.
            Then I tried it again after reading your comment, you're right it doesn't work after that.
            Have you tried resetting the preferences? Reinstalling IGB will keep your preferences from any previous installs.
            To do this go to File > Preferences > Other Options > Reset Preferences to Defaults (at the bottom)
            Or you can click the gear icon and select the reset preferences button at the bottom.

            It started working again for me after I reset the preferences.
            Good luck!

            Show
            rweidenh Logan Weidenhammer (Inactive) added a comment - Irvin Naylor Noted your comment on step 7 and will add that to the improvements. I just went through the steps and the "select all" worked fine. Then I tried it again after reading your comment, you're right it doesn't work after that. Have you tried resetting the preferences? Reinstalling IGB will keep your preferences from any previous installs. To do this go to File > Preferences > Other Options > Reset Preferences to Defaults (at the bottom) Or you can click the gear icon and select the reset preferences button at the bottom. It started working again for me after I reset the preferences. Good luck!
            Hide
            inaylor Irvin Naylor (Inactive) added a comment -

            Logan Weidenhammer
            Thanks for the suggestion! I reset the preferences but it looks like it's still there on my end. I've tried a few different read alignment combinations but I'm not sure what it could be. I'll keep fiddling around with it and see if I can find anything.

            Show
            inaylor Irvin Naylor (Inactive) added a comment - Logan Weidenhammer Thanks for the suggestion! I reset the preferences but it looks like it's still there on my end. I've tried a few different read alignment combinations but I'm not sure what it could be. I'll keep fiddling around with it and see if I can find anything.
            Hide
            inaylor Irvin Naylor (Inactive) added a comment -

            [~aloraine]

            Dr. Loraine, you were totally right! I was putting reads instead of graphs, my bad. I've changed the screenshot to be in line with what the video was looking like at the end. In general, it looks like this step 0 is completely smooth and straightforward otherwise.

            I'm not sure if the select all potential bug isn't actually a bug at all, in this case!

            Show
            inaylor Irvin Naylor (Inactive) added a comment - [~aloraine] Dr. Loraine, you were totally right! I was putting reads instead of graphs, my bad. I've changed the screenshot to be in line with what the video was looking like at the end. In general, it looks like this step 0 is completely smooth and straightforward otherwise. I'm not sure if the select all potential bug isn't actually a bug at all, in this case!
            Hide
            ann.loraine Ann Loraine added a comment -

            Moving to closed. Thank you for the feedback!

            Show
            ann.loraine Ann Loraine added a comment - Moving to closed. Thank you for the feedback!
            Hide
            ann.loraine Ann Loraine added a comment - - edited

            Feedback for Omkar Marne:

            • Please note: You should un-assign the ticket when you move it to Needs First Level Review. Otherwise, no-one will review it because it looks like someone has already picked it up but is not working on reviewing it yet. Please ask Sai Supreeth Segu or Irvin Naylor for details.
            • Please re-read the above instructions carefully. You need to enroll in the Canvas class but it appears this has not been done. (I could not find your name in the list of enrolled students.)
            • The image attached does not match the end of the video. Kindly re-read the documentation for IGB to understand the difference between an annotation data type and a graph data type. Then watch the video again, following along as closely as you can.
            • Please do not proceed to the next on-boarding ticket until the above has been completed.
            Show
            ann.loraine Ann Loraine added a comment - - edited Feedback for Omkar Marne : Please note: You should un-assign the ticket when you move it to Needs First Level Review. Otherwise, no-one will review it because it looks like someone has already picked it up but is not working on reviewing it yet. Please ask Sai Supreeth Segu or Irvin Naylor for details. Please re-read the above instructions carefully. You need to enroll in the Canvas class but it appears this has not been done. (I could not find your name in the list of enrolled students.) The image attached does not match the end of the video. Kindly re-read the documentation for IGB to understand the difference between an annotation data type and a graph data type. Then watch the video again, following along as closely as you can. Please do not proceed to the next on-boarding ticket until the above has been completed.
            Hide
            omarne Omkar Marne (Inactive) added a comment -

            My apologies. I went through the course without enrolling. Please check if my name in the list now.

            Show
            omarne Omkar Marne (Inactive) added a comment - My apologies. I went through the course without enrolling. Please check if my name in the list now.
            Hide
            omarne Omkar Marne (Inactive) added a comment -

            IGB

            Show
            omarne Omkar Marne (Inactive) added a comment - IGB
            Hide
            omarne Omkar Marne (Inactive) added a comment - - edited

            I have uploaded the corrected image. I was able to do 'SELECT ALL' and change the X and Y axis for the coverage graphs.

            Show
            omarne Omkar Marne (Inactive) added a comment - - edited I have uploaded the corrected image. I was able to do 'SELECT ALL' and change the X and Y axis for the coverage graphs.
            Hide
            ssegu Sai Supreeth Segu (Inactive) added a comment -

            Omkar Marne has enrolled in the class but image is not same as the final image in the video. Please go through the youtube link and follow each step to replicate final image.

            Show
            ssegu Sai Supreeth Segu (Inactive) added a comment - Omkar Marne has enrolled in the class but image is not same as the final image in the video. Please go through the youtube link and follow each step to replicate final image.
            Hide
            omarne Omkar Marne (Inactive) added a comment -

            IGB updated image

            Show
            omarne Omkar Marne (Inactive) added a comment - IGB updated image
            Hide
            omarne Omkar Marne (Inactive) added a comment -

            Please check the corrected IGB image.

            Show
            omarne Omkar Marne (Inactive) added a comment - Please check the corrected IGB image.
            Hide
            omarne Omkar Marne (Inactive) added a comment -

            Sai Supreeth Segu Please check the corrected IGB image and let me know if its wrong.

            Show
            omarne Omkar Marne (Inactive) added a comment - Sai Supreeth Segu Please check the corrected IGB image and let me know if its wrong.
            Hide
            ssegu Sai Supreeth Segu (Inactive) added a comment -

            Omkar Marne Screenshot looks good to me. Moving the ticket to pull request

            Show
            ssegu Sai Supreeth Segu (Inactive) added a comment - Omkar Marne Screenshot looks good to me. Moving the ticket to pull request
            Hide
            omarne Omkar Marne (Inactive) added a comment -
            Show
            omarne Omkar Marne (Inactive) added a comment - Thank you Sai Supreeth Segu
            Hide
            jsirigin Jaya Sravani Sirigineedi added a comment - - edited

            Day - 1: Enrolled in the canvas course and completed the first module. Installed IGB on my local machine and completed the steps mentioned in the video and the ticket, attached the required screenshot below.

            Gone through the provided IGB documentation as well but these two links doesn't have any content in them. https://wiki.bioviz.org/confluence/display/ITD/IGB+Release+Documentation
            https://wiki.bioviz.org/confluence/display/igbdevelopers/Home

            UPDATE from Nowlan - Links are updated in the ticket description to:
            https://wiki.bioviz.org/confluence/display/ITD/How+to+test+-+read+this+first
            https://wiki.bioviz.org/confluence/display/igbdevelopers/Developing+Integrated+Genome+Browser

            Show
            jsirigin Jaya Sravani Sirigineedi added a comment - - edited Day - 1: Enrolled in the canvas course and completed the first module. Installed IGB on my local machine and completed the steps mentioned in the video and the ticket, attached the required screenshot below. Gone through the provided IGB documentation as well but these two links doesn't have any content in them. https://wiki.bioviz.org/confluence/display/ITD/IGB+Release+Documentation https://wiki.bioviz.org/confluence/display/igbdevelopers/Home UPDATE from Nowlan - Links are updated in the ticket description to: https://wiki.bioviz.org/confluence/display/ITD/How+to+test+-+read+this+first https://wiki.bioviz.org/confluence/display/igbdevelopers/Developing+Integrated+Genome+Browser
            Hide
            jsirigin Jaya Sravani Sirigineedi added a comment -

            Day - 2:
            Completed the documentation regarding testing and started the developer's documentation. Created a bitbucket account and tried to fix an issue that occurred while setting up SSH.

            Show
            jsirigin Jaya Sravani Sirigineedi added a comment - Day - 2: Completed the documentation regarding testing and started the developer's documentation. Created a bitbucket account and tried to fix an issue that occurred while setting up SSH.
            Hide
            ann.loraine Ann Loraine added a comment - - edited

            When you move an issue to "needs review" or "needs testing" please do not assign it to a specific person, unless only that one specific person can review it, or if that person has asked for you to assign it to them. In this case, pretty much anybody on the team can review this particular issue, so you should leave it unassigned. I am usually the person with the biggest workload, so if at all possible you try not to assign things to me, because if you do, you might have to a wait a few days for me to get to it, which could slow you down

            Show
            ann.loraine Ann Loraine added a comment - - edited When you move an issue to "needs review" or "needs testing" please do not assign it to a specific person, unless only that one specific person can review it, or if that person has asked for you to assign it to them. In this case, pretty much anybody on the team can review this particular issue, so you should leave it unassigned. I am usually the person with the biggest workload, so if at all possible you try not to assign things to me, because if you do, you might have to a wait a few days for me to get to it, which could slow you down
            Hide
            jsirigin Jaya Sravani Sirigineedi added a comment -

            Sure, [~aloraine]. Actually, I didn't assign it, after I unassigned myself it got assigned to you directly I guess. I will make sure to check that from now on.

            Show
            jsirigin Jaya Sravani Sirigineedi added a comment - Sure, [~aloraine] . Actually, I didn't assign it, after I unassigned myself it got assigned to you directly I guess. I will make sure to check that from now on .
            Hide
            Mdavis4290 Molly Davis added a comment -

            Review:

            • The image has graphs loaded and configured to the same scale as each other
            • Jaya Sravani Sirigineedi has enrolled in the class

            Moving to done!

            Show
            Mdavis4290 Molly Davis added a comment - Review : The image has graphs loaded and configured to the same scale as each other Jaya Sravani Sirigineedi has enrolled in the class Moving to done!
            Hide
            uchinta Udaya Chinta added a comment - - edited

            *Day1:

            Below are the doubts and I got them clarified from Professor Loraine and Dr Freese:

            • What is the source for BAM file?
            • Dont we have a feature to delete all tracks at a time in data management table?
            Show
            uchinta Udaya Chinta added a comment - - edited * Day1: Enrolled in canvas course and completed the module 1. Installed IGB and completed the steps mentioned in the youtube video. Attaching the screenshot for verification. Attaching the another screenshot where I have explored reads, annotations and graphs tabs. I have gone through the below documentations https://wiki.bioviz.org/confluence/display/ITD/How+to+test+-+read+this+first https://wiki.bioviz.org/confluence/display/igbdevelopers/Developing+Integrated+Genome+Browser Below are the doubts and I got them clarified from Professor Loraine and Dr Freese: What is the source for BAM file? Dont we have a feature to delete all tracks at a time in data management table?
            Hide
            uchinta Udaya Chinta added a comment -

            Day 2:
            I created an account in Bitbucket, forked the igb repository, and added an SSH key. I then tried to set up the local environment by cloning the Bitbucket repository, but it threw an error showing:
            kex_exchange_identification: read: Software caused connection abort
            banner exchange: Connection to 104.192.142.26 port 22: Software caused connection abort.
            I resolved the above error. After resolving it, I received the following message:
            authenticated via ssh key.
            Now I am getting another error that I need to resolve.

            Show
            uchinta Udaya Chinta added a comment - Day 2: I created an account in Bitbucket, forked the igb repository, and added an SSH key. I then tried to set up the local environment by cloning the Bitbucket repository, but it threw an error showing: kex_exchange_identification: read: Software caused connection abort banner exchange: Connection to 104.192.142.26 port 22: Software caused connection abort. I resolved the above error. After resolving it, I received the following message: authenticated via ssh key. Now I am getting another error that I need to resolve.
            Hide
            ann.loraine Ann Loraine added a comment -

            The ticket is in the "needs review" column but the most recent comment added by Udaya Chinta indicates more work is needed to resolve a new error. So I am returning this to "To-Do" because more work needs to be done, according to comments added thus far.

            Show
            ann.loraine Ann Loraine added a comment - The ticket is in the "needs review" column but the most recent comment added by Udaya Chinta indicates more work is needed to resolve a new error. So I am returning this to "To-Do" because more work needs to be done, according to comments added thus far.
            Hide
            uchinta Udaya Chinta added a comment - - edited

            Day 3: I am able to clone the code using https url and installed azul jdk 21. Maven build is successful on local machine.
            Attaching the screenshot

            Show
            uchinta Udaya Chinta added a comment - - edited Day 3: I am able to clone the code using https url and installed azul jdk 21. Maven build is successful on local machine. Attaching the screenshot
            Hide
            jsirigin Jaya Sravani Sirigineedi added a comment - - edited

            Review:

            • The image uploaded has the same graphs loaded and the scales also match the video.
            • Udaya Chinta is enrolled in the Canvas course.

            Moving the ticket to done.

            Show
            jsirigin Jaya Sravani Sirigineedi added a comment - - edited Review: The image uploaded has the same graphs loaded and the scales also match the video. Udaya Chinta is enrolled in the Canvas course. Moving the ticket to done.

              People

              • Assignee:
                uchinta Udaya Chinta
                Reporter:
                ann.loraine Ann Loraine
              • Votes:
                0 Vote for this issue
                Watchers:
                9 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: