SearchGUI

• Searchguide Level 3
• Search Guinea Pigs
• Searchgui
• Searchgui Command Line
• Myrimatch
• Http://searchguide.tds.net

Hi John, It's interesting that the permissions didn't seem to be maintained following the upgrade. However, I did a clean install then attached my machine to our corporate domain and Cortana/searchui.exe stopped working. We here present the latest developments in SearchGUI, a common open-source interface for the most frequently used freely available proteomics search and de novo engines that has evolved into a central component in numerous bioinformatics workflows. We would like to show you a description here but the site won't allow us.

SearchGUI Publications:

• Barsnes H and Vaudel M: SearchGUI: a highly adaptable common interface for proteomics search and de novo engines. J Proteome Res. 2018;17(7):2552-2555.
• Vaudel M, Barsnes H, Berven FS, Sickmann A, Martens L: SearchGUI: An open-source graphical user interface for simultaneous OMSSA and X!Tandem searches. Proteomics 2011;11(5):996-9.
• If you use SearchGUI as part of a publication, please refer to the most recent publication.

(Click on figure to see the full size version)

Introduction

SearchGUI is a a highly adaptable open-source common interface for configuring and running proteomics search and de novo engines, currently supporting X! Cardiograph. Tandem, MyriMatch, MS Amanda, MS-GF+, OMSSA, Comet, Tide, Andromeda, MetaMorpheus, Novor and DirecTag.

To start using SearchGUI, unzip the downloaded file, and double-click the SearchGUI-X.Y.Z.jar file. No additional installation required!

To visualize and analyze the search results we recommend PeptideShaker.

For developer access to the search results we recommend the use of compomics-utilities.

Read Me

Searchguide Level 3

To start identifying peptides and proteins using SearchGUI, download the latest version, unzip the downloaded file, and double-click on the SearchGUI-X.Y.Z.jar file.

From the Command Line

The main purpose of SearchGUI is to make it simpler to use multiple search engines at the same time. A graphical user interface is the best choice for smaller projects. SearchGUI can also be used via the command line, and be incorporated in different analysis pipelines.

For details about the command line see: SearchCLI.

Bioconda

SearchGUI is available as a Miniconda package in the bioconda channel here.

You can install SearchGUI with:

Docker

A Docker container is available via the Biocontainers repository. You can make use of the container via:

Search Guinea Pigs

Replace X.Y.Z with the wanted SearchGUI version number.

You need to have in mind that Docker images don't contain your data into them. If you want to use any data file into a dockerised tool, you will need to map (using -v Docker parameter) your local folder containing it into the Docker internal file system, like

In this example we are also writing the ouput of the command (-out parameter) into the mapped folder in order to write it into our own file system (instead on Docker's container one) and have access to it from our computer after the execution.

Easybuild

Searchgui

A Easybuild easyconfig file is available in the Easybuild development branch. SearchGUI can be installed with:

Replace X.Y.Z with the wanted SearchGUI version number.

The easyconfig provides aliases for the common CLI commands:

User Defined Modifications

It is straightforward to add/edit modifications via the graphical user interface. Modifications will be available in other instances of SearchGUI and PeptideShaker for the same user/computer. Not all modifications are correctly handled by the search engines. For example, X! Tandem is not compatible with modifications at termini on specific amino acids. Using such a modification will result in nonsense matches which can be filtered out afterwards. This functionality is available by default in PeptideShaker.

Spectrum Data Formats

SearchGUI supports mzML and mgf files as the direct input format for the spectrum files. In addition, ThermoRawFileParser is included, which supports out-of-the-box conversion of Thermo raw files into mzML and mgf.

Furthermore, by referencing the location of your ProteoWizard installtion you may also provide additional raw file types as input, which will then be converted using msconvert. Note that this option is only available via the graphical user interface. From the command line you have to run the msconvert command line separatelty.

Searchgui Command Line

Result Analysis

Myrimatch

To visualize and analyze the SearchGUI results we recommend the use of PeptideShaker. PeptideShaker is a search engine independent platform for visualization of peptide and protein identification results from multiple search engines.

Troubleshooting

Http://searchguide.tds.net

• Does Not Start I - Do you have Java installed? Download the latest version of Java here and try again. (You only need the JRE version (and not the JDK version) to run SearchGUI.)

• Does Not Start II - Have you unzipped the zip file? You need to unzip the file before double clicking the jar file. If you get the message 'A Java Exception has occurred', you are most likely trying to run SearchGUI from within the zip file. Unzip the file and try again.

• Does Not Start III - Is SearchGUI installed in a path containing special characters, i.e. [, %, æ, ø, å, etc? If so, move the whole folder to a different location or rename the folder(s) causing the problem and try again. (Note that on Linux SearchGUI has to be run from a path not containing spaces).

• Unidentified Developer - If you run SearchGUI on a Mac you can get the warning 'SearchGUI' can't be opened because it is from an unidentified developer. To escape this warning control-click on the file icon and then select 'Open.' This will give you the option of opening it regardless of its unidentified source. This only has to be done once for each SearchGUI version.

• Search Engine Issues - Important: If you have problems with the search engines, please verify that the search engines are working outside of SearchGUI first. To test your installation run the search engine executable on the command line. This should result in output describing what the script does. If you get this, it works, and SearchGUI should run without problems. If not, see below.

• X! Tandem XML Syntax Error - If X! Tandem gives the error 'Syntax error parsing XML', the problems is most likely that the path to your database or mgf files contains special characters not supported on your operating system. If this happens try renaming the folders containing the special characters or move the files to folders not containing special characters.

• Linux Support - Users wanting to use SearchGUI on Linux may have to install the search engines first, see the tools web pages for available search engine versions. Important: Please verify that the search engines are working outside of SearchGUI before using them inside SearchGUI.

• Linux Support II - If you get problems running makeblastdb (need to prepare FASTA files for OMSSA searches) make sure that you have the required 32 bit libraries. To install the libraries you can use 'sudo apt-get install ia32-libs'.

  Identify Site Check Clear Graphics Print Share Map Legend Search for layers Load User Data Data Visibility Tool Help Terms OSGB36 ETRS89 WGS84 Full Extent 1:1,000,000 1:500,000 1:250,000 1:50,000 1:25,000 1:10,000 1:2,500. Magic maps. Browse and download Minecraft Magic Maps by the Planet Minecraft community. MAGIC is a very popular website with 2,500 daily user sessions and 9 million maps generated each month across 8 themes, three different basemaps and three overview maps. MAGIC (Map and Geographic Information Center) Collection of maps, atlases, gazetteers, aerial photographs, and digital geospatial data, as well as resources on the history and current state of cartography. From the University of Connecticut's Map Library.

• MS Amanda Log - If you encounter problems with MS Amanda it may help to inspect the MS Amanda log files. On Windows these are located here: C:ProgramDataMSAmanda.

• MS Amanda on Linux - Running MS Amanda on Linux requires that you have Mono installed. Mono 3.2.1 or newer is required and the libmono-system-core4.0-cil has to be installed. To check your Mono version run 'mono -V'. Mono can be installed as follows: 'sudo apt-get install mono-runtime' (and if needed 'sudo apt-get install libmono-system-core4.0-cil' and 'sudo apt-get -f'). For some Linux distributions Mono version 3.X is not directly available, you might be able to use: 'sudo add-apt-repository ppa:directhex/monoxide', 'sudo apt-get update' and 'sudo apt-get dist-upgrade'. For more help on installing Mono please see http://www.mono-project.com/download.

• MS Amanda on Mac - Running MS Amanda on Linux requires that you have Mono installed. Rename xfinity router. Mono 3.10.0 or newer is required. For help on installing Mono please see http://www.mono-project.com/download.

• MyriMatch on Linux - If you get the error 'locale::facet::_S_create_c_locale name not valid', this can be fixed by running the command 'export LC_ALL=C' before running SearchGUI/MyriMatch. To make this fix permanent, put the export line in your .bash_profile (~/.bash_profile). If you still have problems, please contact the MyriMatch developers.

• MyriMatch on Linux II - If you get the error 'myrimatch: loadlocale.c:129: _nl_intern_locale_data: Assertion cnt < (sizeof (_nl_value_type_LC_TIME) / sizeof (_nl_value_type_LC_TIME[0]))' failed.' (or other locale-related variable than LC_TIME), this can be fixed by running the command 'export LC_TIME=C' before running SearchGUI/MyriMatch. To make this fix permanent, put the export line in your .bash_profile (~/.bash_profile).

• MyriMatch on Windows - If Myrimatch finishes almost immediately and SearchGUI log shows something like 'MyriMatch finished for * (47.0 milliseconds). Could not find MyriMatch result file', myrimatch executable may not be running properly. Into its internal path (similar to resourcesMyriMatchwindowswindows_64bit, depending on your platform) you can execute it just writing `myriMatch` . If it throws errors about missing libraries like MSVCR100.dll or MSVCP100.dll you will need to install the last version available of them from Microsoft. MSVCR100.dll and MSVCP100.dll need this specific Microsoft Visual C++ package: [Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/en-us/download/details.aspx?id=26999). Other versions of Visual C++ redistributable libraries may be obtained here:[The latest supported Visual C++ downloads](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads)

• MetaMorpheus requirements - 64-bit operating system and .NET Core 3.1. See https://github.com/smith-chem-wisc/MetaMorpheus for more details.

• Linux and Mac OSX File Permissions - On Linux and Mac OSX you may have to edit the permissions for the executable files in order for SearchGUI to work. Allow execution for all users.

• 32 bits vs 64 bits - Please make sure that your using versions of the search engines that are compatible with your OS. Note that the latest releases of OMSSA are only available in 64 bits versions. For older versions of OMSSA see the OMSSA archive. However, it is always recommended to use the latest version if possible. Also note that OMSSA versions up until version 2.1.9 does not support precursor mass tolerance in ppm.

• Xlib/X11 errorrs - When running the command lines on systems without a grahpical user interface you may get errors related to X11. If that happens try adding -Djava.awt.headless=true to the command line.

• Problem Not Solved? Or Problem Not List? - Contact the developers of SearchGUI by setting up an issue describing the problem. If the issue is related to the installation of the search engines, please contact the search engine developers directly.