Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction to bookmarks in IGB

In IGB 6.7 Bookmarks received a major redesign and had many new features added. Bookmarks in IGB allow you to create a shortcut to a specific genomic location and zoom level within a collection of data sets. Bookmarks will be are listed in the Bookmarks menu and in the Bookmarks tab.  When you create the bookmark, you will be able to provide any name or descriptor you wish to help you remember details about the bookmark. In 6.6, we have added and commentary, detailing elements in the bookmark. You can organize your bookmarks into folders, which can also have comments. There are tool tips for bookmarks, showing the chromosome number and coordinate range to further assist you in your data analysis. We have also included Bookmark history; within the bookmark tab, you will find , with 'fast forward' and 'rewind' buttons which will allow allowing you to move back or forward through the bookmarks you have looked at/made during a particular session.

...

The Bookmark tab allows you easy access to the bookmark list; it also provided all of the tools needed to manage and share the bookmarks. It does NOT actually create bookmarks - that requires the two functions found in the Bookmarks menu (see the details below). The Bookmarks tab can be opened either from Bookmarks > Open Bookmarks Tab, which will open it in the default right portrait tray, OR from View > Tabs > Bookmarks, which will allow you to open it in any of the three trays or as an independent window. For more details about the 'anatomy' of this tab, see Bookmark Paneltab.

The Bookmark Manager will allow you to work with your saved bookmarks. It will allow you to edit your bookmark names, or edit the bookmark list. You can set up separate folders for each user, allowing for individual bookmarks; the Bookmark Manager will allow you to also switch between these folders. Finally, the Bookmark Manager will allow Bookmark tab permits folder, separator and bookmark creation and deletion (the Bookmark dropdown menu only allows adding of a bookmark) improving organization of bookmarks. It contains an editor so that names and commentary about the bookmarks and folder can be changed as each area is analyzed, or to track what lab shared these bookmarks. Finally, the Bookmark tab allows you to export or import IGB bookmarks; this allows these bookmark files to be shared between (distant) users. Note: We strongly recommend that you occasionally export and save your bookmarks to provide a back up file. This will allow recovery of your bookmarks in case of catastrophic failure of the program.

Image Added

Any bookmarks that you create during a session will be saved when you exit, and will be available the next time you launch IGB. Bookmarks are saved in their own sub-directory, separate from the preferences and the cache.

Note: If you need to reset preferences to default, or if you need to clear the cache, your bookmarks will NOT be affected. However, if the entire IGB directory is deleted, or if the bookmark sub-directory is deleted, then all the bookmarks will be lost.

...

Adding bookmarks

As of In IGB version 6.4 and higher, the expanded Add position & data bookmark function will remember the genomic location, zoom level, all the tracks in view at the time and any changes made to the track(s). This includes color selection, name of the track and/or changes made to graphs such as threshholding6.7, adding a bookmark either Bookmarks > Add Bookmark, or clicking the 'star plus' icon in the Bookmarks tab will open a new window. You can choose to have this window always offer you the default name (which is the Genome Version, followed by the chromosomal location) by leaving the Use Default Name box checked. You can change, add to or alter the name from this window. You can also add any commentary you like in this window, especially information about the experiments, what you analysis is, the lab who sent these bookmarks, etc. Anything you like can go in this box, and it will be remembered, but remain editable. Chose Position Only or Position and Data option (details below) and then click OK.
Image Added

Position and Data bookmarks

Position and Data is the default setting for IGB bookmarks. These bookmarks remember the genomic location and zoom level, plus all of the data sets loaded at the time the bookmark was made. This also includes background color selection, and changes to the name of the track. Using the bookmark will open all of the accessible data sets/ data sources to the marked genomic location at the original zoom level (as if Choose Load Mode > Region in View were selected) with color and name adjustments. If you are interested in a greater area than bookmarked, zoom out or chose a new region from Current Sequence and then refresh the relevant tracks.. Any data sets loaded from a password protected source will ask for the password. Any files not found (missing from original locations) will throw a warning, but all remaining files will load. After all the files have loaded, you can continue to load more regions and work as if you had loaded them 'by hand'. 

Much as using an internet browser bookmark will take you to a completely new page, using IGB bookmarks will clear away data from different species and/or genome versions and replace it with the data contained within the bookmark.  The one time that IGB does this differently is if the data sets that are open match the same species and genome version in the bookmark; in this case, IGB will just add data sets or sources not already opened and zoom to the marked location. For instance, if you have open the 'TAIR9 TAIR10 ALL' data set from Arabidopsis thaliana, genome version June 2009 and your bookmark was made for the 'TAIR9 TAIR10 mRNA' data set from the matching species and genome version, when the TAIR9 TAIR10 mRNA bookmark is activated, it will add the TAIR9 mRNA data set, zoom in to the location and then display both the TAIR9 ALL and the TAIR9 mRNA tracks.

Position bookmarks

The function Add position bookmark only bookmarks Position Only bookmarks only contain the location data and zoom level; you need to open the any associated data sets or sources file to use these bookmarks. Using this type of bookmark will zoom in to a genomic location and zoom level within the currently opened data. You may wish to indicate that this is a 'position only' Position Only bookmark in the name that you create for this bookmarkor commentary.

...

Managing bookmarks

To create a bookmark, choose Bookmarks > Add position & data Bookmark or Bookmarks > Add position bookmark. As you create bookmarks, both the Bookmark menu and the Bookmark tab will become populated with the list of bookmark names. To load a view from a bookmark, just click on the name of the bookmark in either list.

...

Finally, as you can see (green arrow) we are currently looking at the second bookmark. We can use the history arrows (green box) to move forward or back through the bookmarks we have used in this session.

Image Removed

Exporting and Importing bookmarks

...

You can import multiple sets of bookmarks during the same IGB session.  Imported bookmarks will be added to the end of the list of existing bookmarks.  All imported bookmarks will be persistent between sessions of IGB. You can create a new folder for imported bookmarks, if you do not wish them to mix with your current bookmarks. Image Removed