File Menu

Content of this page:

Main Menu Items


Description
Recent filesAllows reopening recently closed projects.
Open fileOpen an OmicsBox project (.b2g/.box).
Save and Save asSave the current project.

Close Tab

Close the selected tab.
LoadAllows loading of different file types into OmicsBox.
ExportAllows exporting the desired information to some file types, such as text or GFF.
Manage LicenseCheck the license you currently have and change the activation key.
PreferencesSet the OmicsBox configuration.

Data Import and Export

Under the File menu and the Tools sub-menu, there are several useful features that can be used to manipulate sequence data.

Load

  1. Extract and import sequences from a FASTA and a GFF/GTF file (figure 1). For further information, please link here.
  2. Load Blast and InterProScan results.
  3. Load ID lists.
  4. Load GTF/GFF2/GFF3
  5. Load Accession List: Load Gene Ontology annotations via an Accession list. 
  6. Load GeneSymbol List: Load Gene Ontology annotations via a GeneSymbol list.
  7. Load GI-List: load Gene Ontology annotations via a GenInfo Identifier (gi) list. Please consider the identifier to be between vertical bar e.g. gi|356569257|.
  8. Load Data from BioMart: Load Gene Ontology annotations from BioMart. For further details on how to load annotations, link here.
  9. Load EggNOG, Metagenomics and PfamScan annotations.
  10. Load metagenomic Kraken data.
  11. Load Count Tables and Differential Expression results.
  12. Load BAM and VCF files.

The Accession List and the GeneSymbol file should contain two columns (separated by tabs) per line. The first column the accession id or gene symbol and the second column may contain the corresponding taxonomy. The second column is optional.


Figure 1: Extract and import sequences from a FASTA and a GFF/GTF file.

Export Menu

The icon of each menu item indicates which object type is suitable for this menu item. 


Description
Export TableExport the current Main Sequence Table for the selected sequences.
Generic ExportThis option allows you to export all the desired information to a text file.
Export as FastaExport sequences of this project in fasta format.
Export as GFFExport the annotations of this project as GFF file.

Export Blast Top-Hits

It will export the best-blast-hit for each sequence, this is the hit with the lowest e-value.
Export Mapping ResultsAllows to export all the information obtained and used during the Gene Ontology mapping process as GFF formatted text file.
Export Annotations (.annot)
Export Annotation Descriptions
Export Annotations in GO Annotation File Format (GAF v.2)
Export GO PropagationExports the GO parents up to the root for the annotated sequences.
Export Sequences per GO (Gene Sets)
Export Metagenomics GO Annotations
Export Kraken DataExport the Kraken data as text file.
Export GFF

This option is only visible if a GFF file is loaded in OmicsBox or if a GFF has been generated from Gene Finding. It is also possible to export a GFF with GO terms. For further details, link here.

Export KEGG DataKEGG related information as tab separated text file.


OmicsBox File Export Menu

Figure 2: OmicsBox File Export Menu

General Preferences

In the General Preferences, it is possible to enter a valid email address, which will be used in the QBLAST and also in the InterProScan searches. Furthermore, the path to the OmicsBox workspace can be provided and all results such as BLAST, InterProScan, charts and OmicsBox projects will be saved here.


Image General Preferences

Figure 3: OmicsBox General preferences

Update

OmicsBox allows automatic software updates during the application startup. These updates contain improvements, new features or bug fixes. It is possible to choose if you want to be notified of new updates or if you want to install software updates automatically (recommended).

It is also possible to specify the update behaviour of installed Apps. We differentiate between "Featured'' and normal Apps. New "featured'' Apps can be installed and updated automatically. Normal, non-featured Apps have to be installed manually but can be updated automatically.

Image update_blast2go_pref

Figure 4: Wizard to configure the OmicsBox update behaviour


GO Version

For the Functional Analysis Module OmicsBox contains the Gene Ontology database and all the information necessary to perform the mapping step i.e. to be able to link the different protein IDs to the functional information of the Gene Ontology database (see Gene Ontology Mapping section).

Here one can select the GO version available on OmicsBox servers as well as the corresponding .obo file to be used in the mapping step.

Local OmicsBox database

Local OmicsBox database installation: If you are interested in installing your own OmicsBox database locally with the aim to not depend on the OmicsBox server, you can find a tutorial on the OmicsBox website in the download section including a step-by-step installation guide. Basically will need a MySql server, the latest GO database dump and some additional "mapping tables" (NCBI and PIR flat-files). By following several few steps this data is imported into your database.

Enzyme Code Data

In OmicsBox it is possible to provide a file with the corresponding Enzyme Codes.

Proxy

Proxy Settings. If a proxy server or a firewall is used to access the internet here you can define the proxy settings. An HTTP or a Socks proxy can be configured. In this window, you can configure the proxy settings only for OmicsBox and this will overcome the system-wide settings. If the Use Direct Connection check box is selected, the application will try to connect directly to the internet skipping any system settings. To use your defined proxy settings select the HTTP or Socks Proxy check box and complete the required fields.

Figure 5: Proxy settings dialog

Custom CA Root Certificates

This option allows the import of custom CA root certificates to the OmicsBox trusted entities. It is located in the same Proxy setting page.

A certificate authority (CA) is an entity that issues digital certificates. A digital certificate certifies the ownership of a public key by the named subject of the certificate (Common Name or CN in a certificate). A CA acts as a trusted third-party and allows OmicsBox to rely on the packets received through the connection to OmicsCloud or other internet sites. The format of these certificates is specified by the X.509 standard.

In a normal configuration, a secure connection is established between the end client (OmicsBox) and the server (e.g.: OmicsCloud) and the packages travel encrypted between client and server. In some custom firewall configurations where all traffic going through the network is inspected by the firewall, a secure connection is established between the client application and the firewall, and another connection is established between the firewall and the servers. The firewall can act as a man-in-the-middle to inspect the packages and will re-encrypt them using its own certificate.

This may cause connection problems if OmicsBox does not recognize the certificate used in the firewall as a trusted entity. The IT department of the institution will know if a custom certificate is used and can provide you with the CA root of this certificate, or the certificate itself, to be added to OmicsBox. This is usually a .crt file that can be provided in the wizard page.

It can also be obtained from a regular web browser by opening a page that is known to be inspected by the firewall, for example the connection to the OmicsCloud https://cloud.biobam.com by clicking on the padlock next to the url address the certificate option shows the path to the certificate and the signing authority. On our servers, the CA root entity is either Amazon Root CA 1 or GlobalSign Root CA. Something else is an indicator of a custom CA Root certificate.

In Windows and Linux, the Root certificate can be saved from within the browser. In MacOS, this needs to be searched in the keychain app and exported from there. Once this file is exported, it can be directly imported in OmicsBox Proxy preferences page.

Auto-Save

OmicsBox allows to automatically and continuously save OmicsBox results after a certain amount of time.