An IGB script file (available in IGB 6.3) is a simple batch file that allows a user to run sequential commands outside of IGB, either at startup (via a command-line option) or while IGB is running (via a URL "Bookmark" option -- see control bookmark). It can also be loaded via the File->Load menu (or via drag-and-drop) if its filename extension is ".igb".
Table of Contents |
---|
Introduction
You can control IGB from scripts, which are text files containing simple commands for navigation, loading data, and making snapshots.
To run an IGB script:
- Open a script file using File > Open. Script files should end with .igb.
- Click an IGB script link. See: Controlling IGB using IGB Links
- Drag and drop a script file into an open IGB window.
Syntax
The script file has a simple, space-delimited syntax. Each command should occupy a separate line.
Commands
"genome <version>"
...
Bring IGB to front
Code Block |
---|
bringToFront |
Bring the IGB window to the front of the user's desktop.
...
Open a genome version
Code Block |
---|
genome <version>
|
Open genome version (e.g., H_sapiens_Mar_2006). Any genome version or synonym that's accepted by IGB is accepted here
...
"goto <region>".
...
Go back to the IGB start screen.
Code Block |
---|
homescreen |
Return to the IGB start screen.
...
Go to a region
Code Block |
---|
goto <region>
|
Go to a region of a chromosome (e.g., "chr1:40000-60000" or "chr1:40,000-60,000"). Commas are optional. Any region format
...
accepted by the IGB
...
"load <file or URL>"quick search text entry (top left corner) is acceptable.
...
Hide a track
Code Block |
---|
hidetrack <file or URL> |
Hide the track. Accepts one or more comma separated files identified by full path or URL.
Add a new data set to IGB's list of active data sets
Code Block |
---|
load <file or URL>
|
Load the specified file (identified by full path) or URL into IGB. The data set will appear in the user's Data Management table upon completion.
...
"loadmode
Remove a data set from IGB's list of active data sets
Code Block |
---|
unload <file or URL>
|
Change the load mode for an active (opened) data set
Code Block |
---|
loadmode <NO_LOAD | REGION_IN_VIEW | CHROMOSOME | GENOME> <file or URL> |
...
|
Change the load mode for the specified
...
data set or file, identified by full path
...
"refresh"
...
.
Info |
---|
The loadmode command will work for any loaded track. Make sure to load your desired track before calling the loadmode command. |
Load data from currently active data sets
Code Block |
---|
refresh
|
This is equivalent to clicking the Load Data button in IGB. This
...
Wiki Markup |
---|
"snapshot \[<filename>\]" or "snapshotwholeFrame \[<filename>\]" |
Wiki Markup |
---|
"snapshotmainView \[<filename>\]" |
Wiki Markup |
---|
"snapshotmainViewWithLabels \[<filename>\]" |
"snapshotslicedViewWithLabels \[<filename>\]"triggers loading of data from the active data sets available in IGB, as specified in the load command. Wiki Markup
Make images
Code Block |
---|
snapshot <filename>
|
Code Block |
---|
snapshotwholeFrame <filename>
|
Code Block |
---|
snapshotmainView <filename>
|
Code Block |
---|
snapshotmainViewWithLabels <filename>
|
Code Block |
---|
snapshotslicedViewWithLabels <absolue path to file>
|
Export the entire frame, main view, main view with labels, or sliced view, respectively, to a PNG format file.
...
You must include the full path to the file or IGB will write the file to the location from where you launched IGB.
The filename defaults to "<genome_version><timestamp>.png" if not specified.
...
"select <geneids>"
Info |
---|
The snapshot and snapshotwholeFrame commands only work on Mac and Linux if attempting to export an SVG file. |
Select genes
Code Block |
---|
select <geneids>
|
Selects the given gene IDs, which are passed in as a comma-separated
...
list."sleep <milliseconds>"
Wait (sleep) for commands to finish
Code Block |
---|
sleep <milliseconds>
|
Sleep the application for x milliseconds.
...
"#"
...
Note |
---|
IGB is multi-threaded, which means that the user may be able to operate IGB while data are being loaded. If your IGB script includes loading data from remote sites (e.g, RNASeq data from the IGBQuickLoad.org site) then you should include a sleep command to give IGB time to load the data. |
Comments
Lines starting with the IGB script comment character '#' are ignored.
...
Example script
...
#select genome
...
Examples
Loading a BAM file
Code Block |
---|
# select genome genome A_thaliana_Jun_2009 #go to chromosome at region goto chr4:18,040,000 - 18,045,056 #load the file load# go to a region in chr4 # commas are optional goto chr4:8,860,484-8,872,096 # load a file load http://igbquickload.org/quickload rnaseq/A_thaliana_Jun_2009/nextgen_samples SRP029896/sample ColdControl.bam #set load mode to region in view loadmode REGION_IN_VIEW http://igbquickload.org/quickload/A_thaliana_Jun_2009/nextgen_samples/sample.bam #refresh to view data refresh
# load the data
refresh |