Mass spectrometry, Protein Chemistry Facility
Research Institute of Molecular Pathology (IMP)
Institute of molecular biotechnology of the Austrian Academy of Sciences (IMBA)
Gregor Mendel Institute of Molecular Plant Biology (GMI)

PD-Nodes SimpatiQCo Software Tools Publications


SimpatiQCo About Download Installation Manual FAQ's
Manual

Precautions

The following instructions apply to a SIMPATIQCO system with the following properties:

Uploading a raw file

There are three methods to upload a file to SIMPATIQCO

Via the web interface
Navigate to the Raw files panel, select your instrument and click the "Upload new raw file" button. Since SIMPATIQCO needs to know how to handle the file and the resulting data, you have to choose a run-type by clicking on it. The site will reload and depending on your settings, the flash-upload area or a simple "browse" button will appear. You can choose the upload method (flash or ajax) in the "Settings" page. The picture below shows the flash-upload button.

Click the flash utility and select your file to upload. Attention: Keep this windows/tab open in your browser while uploading. Otherwise the upload and further file analysis will fail. If the upload succeeds, the raw analysis and search (if available in the run-type) will start soon. The status will update automatically whereas the left icon represents the raw analysis and the right icon represents the search status.


Via FTP or direct copy
If you click "FTP/Direct copy upload" you will see a listing of all files found in the e.g. D:\temp\ftp directory. You can then check which files should be analyzed and which run-type should be used. This directory is set in the /simpatiqco/inc/conf.php file. You can set up a ftp server of your choice or use smallftp.exe which can be found in /simpatiqco/ftpupload. Set the default upload directory to your simpatiqco ftp directory and use a client to upload files to simpatiqco. If you have access to this directory for instance via a network share, it is also possible to just copy files to this directory. Please note that raw data files will be deleted from the ftp folder after processing.
The "FTP/Direct copy" functionality exists for two reasons: With this feature it is possible to upload/Launch multiple files at once and it enables you to upload huge files (>2GB) which could be a problem doing so over the web interface. Please keep in mind that some FTP-clients (e.g. firebug) have a built-in 2GB filesize limit. To ensure stability, it is recommended to process raw data in repeated batches of up to 30 files.

Via the hot folder
You can specify a "hot" folder in conf.php (described in the installation manual). On the settings page you will then be able to start the hot-folder "service". SIMPATIQCO will then in the hot directory create a directory structure for every instrument and will also monitor these diretories for any new files. Any raw file copied to one of these directories will be processed automaticaly. You just have to specify the run-type in the name of the raw file by using the term "rtidX". X is a number and the ID of the run-type (you can see the IDs of your run-types when opening the settings page, at the run-type/instrument assigning section). For example, a raw file named "1012_BSA_CytoC_rtid12_100min.raw" will be processed using the run-type having the ID 12. Raw files with no rtid tag will be ignored. Please note that raw data files will be deleted from the hot folder after processing.
This option alows a total automatic workflow since one can also automatically copy raw files to SIMPATIQCO when acquisition is finished. See the FAQs how to do so.

Adding and removing instruments

Since there is no interface for this operation, one has to add instruments manually. This is simple done by adding a line in the SIMPATIQCO database. Open the tbl_instruments table and fill in the data for the new instrument.
Required columns:
The name_long string will later appear in the SIMPATIQCO web interface. Note that the id is a primary key, so just count this number up and do not delete lines. If you want to remove an instrument, just set the "active" column to false.
If there is a column named "dev", set its value to false.
The column "order" just regulates the listing of the instruments from left to right on the simpatiqco main site.

All other columns are optional. The columns "calc_statistic_period" and "run_type_ids" will later be filled when you go trough the settings and run-type settings.

The run-type concept

Each uploaded raw file will be analysed and the resulting data (raw file facts and search results) will be stored. To make these values comparable over time, the raw files need to be analysed in a certain way, which is not changing. The "run-types" hold these information, espacially the Mascot-search paramters. So each raw file is assigned to a certain run-type. Run-types can easily be created in the "Settings" page (see manual "Adding and removing of run-types" below). For better usability, the run-types can also be assigned to specific instruments. This has no impact on the statistic or what so ever, but is only a visual helper. For example, it is not necessary to make an ETD-run-type selectable for a non ETD instrument. This assigning is also done on the "Settings" page. The picture shows the self explaining matrix.

Adding and removing of run-types

If your mascot-server connection works, you can add run-types with different search parameters. Navigate to the Settings pane, and scroll down to the Status area. If you see something like "Mascotserver: Connection OK" then your mascot-server is reachable. Scroll down to the "Run-type configuration" area, enter a Name for your new run-type, choose the settings available on your mascot-server, and click save.

The "Display in menu: group number" item, lets you choose in which group your run-type will appear, when a user clicks upload new raw file. This is just an optical feature for providing a better overview regarding the different run-types. There are 10 groups possible and each group can hold infinite numbers of run-types. If you want to move a run-type to another group or up/down within a group, just select it by clicking it, then two small arrows on the left will appear. An "OK" sign will appear on the left if your run-type was saved successfully. If not, check the input fields for possible implausible values e.g. letters in numerical input fields, or using a "," instead of a "." -depending on your mascot server settings.

It is not intended to ever remove a run-type, since every uploaded run is bound to the latter. Therefore, if you want to remove a run-type (make it disappear from the menu), just enter the SIMPATIQCO database, open tbl_run_types and set the active column to false.

Peptide lists

On the Settings page you can create peptide lists to observe e.g. Retention times of certain peptides. Create a list (a peptide list is always bound to a certain run-type) e.g. "BSA peptides", then fill the list, by navigating to the search results. Click on the proteins which contain your desired peptides and click the "+" item. You will then be able to choose the peptide list which your peptide should be added to. To use your peptide lists, navigate to the Time-course Panel and select your run-type. If there are any peptide lists attached to it, they will appear, together with the available plots. If you click a peptide list, the corresponding plot for each peptide will appear for the last runs.

Time-course: plotting long term data about proteins of interest

To observe certain values about a protein of interest over a long term e.g. the sequence coverage of Bovine Serum Albumin (BSA) in an everyday test run, you must tell the system, that you want to make e.g. BSA a protein of interest (POI). Do this by opening a search-result and click on the protein.

A little white diamond appears next to the protein name. When you click it, this protein will become a protein of interest for the run-type of this search result. It will be marked in green color from now on, and it will appear in the list of proteins you can select for monitoring long time values in the Database pane. If you want to remove the POI status from a protein, navigate to the Settings pane, scroll down to the Proteins Of Interest Pane, and find the corresponding cell (Protein name/Run-type) and click the X icon.

Troubleshooting

First thing to do, log on to your server, and look what happens when the simpatiqco web site is accessed. Watch out for any error messages. If your uploaded runs deliver no results or you get error messages which don't explain enough there are ways of debugging. First, check the temp directory (e.g.: D:\temp) and open upload_log.txt. This file contains info on the latest upload and should like this:

$_GET array:
Array
(
[instrument_id] => 5
[run_type_id] => 24
)
 
$_FILES array:
Array
(
[Filedata] => Array
(
[name] => 2012-02-15_100scans.RAW
[type] => application/octet-stream
[tmp_name] => D:\temp\php29E.tmp
[error] => 0
[size] => 3682034
)

 

If this is the case, the upload of raw files is working. For further debugging open the corresponding log file (from today) in the temp directory. Also, log on to your server and upload a raw file. You will be able to watch the php scripts starting and working and read their output. This gives you a very detailed view at which point the system fails to analyse the raw file.If an uploaded run ends up with an error and the parameter "keep error file" (settings) is set to "yes" , the temp directory of this run will not be deleted. Look into the raw-file-temp-directory, where you will find a directory for every uploaded file (corresponding to the run id). Check if the created mgf and csv files have valid file sizes and try to open the raw file manually.

You can get a more detailed look into the process by manually starting a run analysis. To do so, make sure that you already uploaded a file which crashed when analyzed by simaptiqco. Now go to your simaptiaco server desktop and get the ID-number of this run and check in the simpatiqco-temp folder, if there is a folder named like this run-ID. E.g.: if your simpatiqco-temp folder is D:\www\simpatiqco_temp and the ID of the run in question is 1244, then there should be a directory D:\www\simpatiqco_temp\1244 (if the upload succeded). Now open a command line window and start the analyzing process: Use this command template:

php -c "C:\Program Files (x86)\EasyPHP-5.4.0RC4\apache\php.ini" D:\www\simpatiqco\inc\rawextractor.php 1244

NOTE: Adapt the above code to your settings. If you made a standard installation, then EasyPHP is in the "Programm Files (x86)" directory and simpatiqco is on D:\www. The last paramter is the ID of your run. If the command succeds, you can watch what happens and when exactly the analyzis crashes.