TPP:6.0.0 Release Notes

From SPCTools

(Difference between revisions)
Jump to: navigation, search
Revision as of 06:29, 1 July 2021
Luis (Talk | contribs)

← Previous diff		 Revision as of 06:32, 1 July 2021
Luis (Talk | contribs)
(→New Features)
Next diff →
Line 25: Line 25:
** Preprend peptide sequence to UNMAPPED protein name in order to get better protein mapping stats within PepXMLViewer ** Preprend peptide sequence to UNMAPPED protein name in order to get better protein mapping stats within PepXMLViewer
** clarify errors and warnings; minor changes to output to ease file comparison ** clarify errors and warnings; minor changes to output to ease file comparison
- 
* ''PepXMLViewer'' * ''PepXMLViewer''
Line 46: Line 45:
** Added Kojak e-value field ** Added Kojak e-value field
** Updated "ions" link for SpectraST results - now displays query and library spectra in butterfly mode in Lorikeet ** Updated "ions" link for SpectraST results - now displays query and library spectra in butterfly mode in Lorikeet
- 
* ''PTMProphet'' * ''PTMProphet''
** new options EXCLUDEMASSDIFFMIN= EXCLUDEMASSDIFFMAX= to allow PTMProphet in MASSDIFF mode to localize mass differences on sufficient magnitude. ** new options EXCLUDEMASSDIFFMIN= EXCLUDEMASSDIFFMAX= to allow PTMProphet in MASSDIFF mode to localize mass differences on sufficient magnitude.
** new Option: STATIC mass difference search option ** new Option: STATIC mass difference search option
- 
- 
-* New Enzyme definition ''lysarginase'' 
- 
* ''decoyFastaGenerator'' * ''decoyFastaGenerator''
Line 60: Line 54:
 +* New Enzyme definition ''lysarginase''
 +
 +* Include ''comet 2021.01.0 and related conf file -- '''Please read the relevant Comet release notes, as some parameters have changed behavior'''
* Include ''Kojak'' 2.0.0 (alpha-1) and related conf file * Include ''Kojak'' 2.0.0 (alpha-1) and related conf file
* Include ''PSI-MOD.obo'', which is required for comet+peff mod searches * Include ''PSI-MOD.obo'', which is required for comet+peff mod searches
* Include ''gnuplot 5.28'' (Windows) * Include ''gnuplot 5.28'' (Windows)
* Upgrade (strawberry) ''perl'' to 5.30.2.1 (Windows) * Upgrade (strawberry) ''perl'' to 5.30.2.1 (Windows)
- 
- 
= Improvements/Changes/Bug Fixes = = Improvements/Changes/Bug Fixes =

Revision as of 06:32, 1 July 2021

Trans-Proteomic Pipeline (TPP) software, release 6.0.0 is a major release of TPP that contains new features, improvements, and fixes to 5.2.0. The software is available for Windows as well as Linux (and unofficially) for OSX from all the usual locations (please see the section below, "Getting the software"). Most users are recommended to use the Windows installer, which installs and configures the TPP and other required software (such as a web server). For advanced users who need to customize the TPP, or for those who run on Linux or OS X, you can download the source code. Again, most users don't need build from source, and should use the Windows installer.

For installation help, please see TPP:5.2_Installation.


Previous release notes are available at TPP:5.2.0_Release_Notes


Contents

Major Changes

  • New Tools: mzTrace, rtExtract, DidIScanThat


New Features

  • novor2xml
    • Add option to write one FASTA pseudo-protein per peptide
    • After conversion, call EnzymeDigestionParser to calculate NMC
    • Special handling for terminal mods (format not as advertised in docs!)
    • set protein name to "_UNMAPPED" as per TPP convention and add helpful description
    • Preprend peptide sequence to UNMAPPED protein name in order to get better protein mapping stats within PepXMLViewer
    • clarify errors and warnings; minor changes to output to ease file comparison
  • PepXMLViewer
    • Update to new L&F
    • Add new js FileBrowser widget to assist in file loading
    • Add tpp AlertBox for error messages
    • Added PEFF-related fields, with options to filter and sort on:
      • num_saavs_min : when mapping to several proteins, the peptide sequence with minimal number of aa subs
      • num_saavs_max : when mapping to several proteins, the peptide sequence with maximal number of aa subs
      • peff_mods : number of aa mass mods coming from PEFF
    • Display full SAAV pattern for each mapped sequence when viewing expanded protein list
    • Added new num_prots column, which can be zero if UNMAPPED; links to madcaps for alignment
    • Added peptide length column
    • fix ptm field name for PTMProphet MASSDIFFMODE analysis.
    • extend to visualize PTMProphet MASSDIFF and ADDUCT localizations ... also allow filtering for specific adducts or massdiffs ...
    • Add min/max Quantic filter
    • display additional columns for Quantic ...
    • display quantic_string
    • Add min/max scan filter
    • Added Kojak e-value field
    • Updated "ions" link for SpectraST results - now displays query and library spectra in butterfly mode in Lorikeet
  • PTMProphet
    • new options EXCLUDEMASSDIFFMIN= EXCLUDEMASSDIFFMAX= to allow PTMProphet in MASSDIFF mode to localize mass differences on sufficient magnitude.
    • new Option: STATIC mass difference search option
  • decoyFastaGenerator
    • option to generate de Bruijn decoys


  • New Enzyme definition lysarginase
  • Include comet 2021.01.0 and related conf file -- Please read the relevant Comet release notes, as some parameters have changed behavior
  • Include Kojak 2.0.0 (alpha-1) and related conf file
  • Include PSI-MOD.obo, which is required for comet+peff mod searches
  • Include gnuplot 5.28 (Windows)
  • Upgrade (strawberry) perl to 5.30.2.1 (Windows)

Improvements/Changes/Bug Fixes

  • DISCO
    • more peptides from boxcar and ion mobility (TIMS-TOF) support
    • change MININTENS= option so the filtered intensity is in units of a multiplicative factor on the minimum intensity peak in the spectrum, values 1 and higher ...
    • for each target only extract unique mz fragments (don't chase the same fragment.)
    • adjust correlation thresholds based on number of points used to compute the correlation ...
    • replace SCAN_WINDOW option with MAX_SCAN_WINDOW MIN_SCAN_WINDOW options to define all window sizes to test
    • automatically modulate the scan window for calculation of correlations to boost IDs, tweak the correlations of reported peaks to improve pseudo-spectrum quality
    • retry readFile up to 100 times if failing because some file systems error out when you ask them for a file only once ...
    • get back good performance on Triple TOF by adjust the binarySearchDataForPeak function, also experimental pea similarity..
    • correct an inefficient Spectrum allocation exposed when ion mobility bins are set high ...
    • apply different background filter in each ion mobility bin for extended dynamic range
    • some extra newlines for easier to read progress reporting
    • add a version number and a reference in mzML so can be properly formed mzML
    • TIMS_TOF related changes
    • Greater reliance on mzParser (less use of pwiz)
    • Better thread load balancing
    • increased sensitivity by averaging
    • Correct bug associated with MININTENS= parameter that filters out lower intensity peaks to speed up processing
    • correct some bugs associated with low sensitivity for TIMSTOF data ...
    • correct a bug with no spectra returned when MININTENS= was enabled on non-TIMS-TOF file...
    • BUGFIX correct crash on empty data ...
    • BUGFIX don't go past the ends of the run!
    • BUGFIX return ability to process irregular DIA files (e.g. ones with different types of MS1 scans)
    • BUGFIX wasting time at the end of the run by overrunning counter corrected


  • PepXMLViewer
    • Added link to chromatogram for label-free XPRESS analysis ("peak_area")
    • Report num_prots as "2" for intra-protein XLs, and "1" for inter-protein ones
    • Add separator to expanded protein lists for XL crosslinks
    • Do not consider _UNMAPPED entries as part of "unique proteins" count
    • Do not add (empty) protein links to _UNMAPPED entries
    • Add mouse-over tips to SpectraST and PeptideAtlas links
    • Disable Glyco B checkbox if NxS/T box is not checked
    • added check for incorrectly specified modification position
    • Clean up layout of PTMProphet filters
    • Place quant scale in (fixed) header
    • Replace "close menu" icon with more obvious red "X"
    • Replace messages "!" with a more screen-friendly icon
    • Use standard TPP footer
    • Pop "Messages" tab only once when file cannot be reached for status check
    • Remove filename's potential colon...ouch
    • Enable vertical scrolling of top menu (e.g. when window is small)
    • Add xlink type to link to models page
    • Added test for no peptide sequence: do not add links etc
    • Properly trim whitespace in input file name
    • Restore spreadsheet link
    • Clean up Quantic score code to fix export to ploTPP
    • fix bug where certain saav=0 stats were mis-counted
    • BUGFIX correct plotTPP file path bug on Windows (now working!) ...
    • BUGFIX correct problem with PTMProphet Filter disappearing when new columns are added ...


  • PTMProphet
    • enable analysis on SpectraST pepXML files ...
    • More multithreading for speed ...
    • Do not include in/output filenames in options string (which only gets written as an a tag attribute in pepXML, which already contains such info
    • write intermediate files to current directory instead of WEBSERVER_TMP, which was filling up too often
    • use extended SpectraST::Peptide library that allows to define 'user tokens' that would override any definition in the static mass tables and are allowed to have different masses in different instances of the Peptide class (e.g. in different threads of PTMProphet analysis) ...
    • support for Magnum adducts, allow evaluating adducts and massdiffs on modified positions, allow evaluating adducts and massdiffs at the same time as variable mods defined in MASSDIFFMODE, exclude mass range feature for MASSDIFFMODE, annotate modifications as massdiff, adduct or param...
    • switch mutex to try_lock instead of lock/unlock cycle, which was causing crashes on gcc (Ubuntu 9.3.0-17ubuntu1~20.04) 9.3.0
    • Bug fixes: MASSDIFFMODE functional again
    • BUGFIX MASSDIFFMODE wrong mod masses being reported...also use the same prior for MASSDIFFMODE as for EM=1 and EM=3 to help EM converge ...
    • fix xml formatting issues due to multithreading, implement options OSCOREMODE and QUANTMODE
    • fix some bugs related to flat PTM probabilities and EM=1 and EM=3 execution options.
    • BUGFIX address bug exposed when multiple variable mods of different types, but occuring on same amino acids, are be present in one peptide.
    • BUGFIX correct deadlock issue when msms_run_summary has zero spectrum_query tags ... NEW: threaded updateProbs routine
    • correct come issues with multithreading and writing invalid pepXML files ... prepare for adduct masses as annotated my Magnum ...
    • BUGFIX add any static mods on the n-terminal to the mass of the n-terminal
    • correct some issues related to analyzing files without probabilities ... also correct a bug with ROC curve reporting.
    • BUGFIX clear out old tags ...
    • BUGFIX correct error with reading NIONS / CIONS user parameter ...
    • fix bug dealing with c-terminal modifications.
    • Bug Fix: correct combinations to not evaluate more peptides than necessary


  • tpp models
    • Update to new L&F
    • Use new common tpp.css (also enables sticky table headers!)
    • Added support for multiple PeptideProphet models in same file (e.g. for XL analysis); also added score overlay of massdiff, isomassdiff, ntt, nmc, etc
    • Add button to toggle 1% Zoom in MASSD models
    • Handle new matchedions model
    • Also plot sum of pos+neg models for each charge state
    • Display all PTMProphet run options
    • Fix bug in parsing certain PTMProphet models; do not capture data points with value = zero; enable auto-tickmarks for MASSDIFF models (which can now be open search)
    • Fix PTMProphet sens/err models and table


  • HardKlor
    • Updated to support Ion Mobility
    • use spectrum member variable to boost speed in multi-threaded setting where reallocs add up


  • MSToolkit
    • Updated to support Ion Mobility (TIMS_TOF)
    • mzParser deal with Precursors in mzML to store isolation window info
    • Improved memory management with fewer reallocations to improve performance in multi-threaded applications


  • Make usage statements somewhat more readable (esp. xinteract)



Miscellaneous

  • comet params: Place full path to PSI-MOD.obo file, now in TPP distro
  • PWIZ Updated to compile on newer versions of gcc in msys2 mingw64 with pthreads


Known Issues

  • None


Getting the TPP Software

  • Download the TPP version 6.0.0 native windows installer (TPP_Setup_6.0.0.exe) from the Sashimi SourceForge project file release page: 
 http://sourceforge.net/projects/sashimi/files/
  • Everyone is encouraged to read and contribute to our wiki, at 
 http://tools.proteomecenter.org/wiki/
  • For guides to installing and using our software, please see our wiki: 
 http://tools.proteomecenter.org/wiki/index.php?title=Software:TPP
  • For downloading the source code, please go to the following link: 
 http://sourceforge.net/projects/sashimi/files/ and find the 6.0.0 source code .tgz package
  • Or, check out the code directly from svn: 
 svn checkout svn://svn.code.sf.net/p/sashimi/code/tags/release_6-0-0
  • For building from source, please refer to the README and INSTALL files in src/ directory of TPP as well as this wiki.


Acknowledgements

The TPP Team: David, Luis, Mike, Eric, Jimmy, plus all other developers who contributed to this release from ISB. Thanks to developers and users from the TPP's user community who provided feedback and code contributions.


SVN Log

The SVN log of all changes since the previous release is available at TPP:6.0.0_SVN_Log.

Retrieved from "http://tools.proteomecenter.org/wiki/index.php?title=TPP:6.0.0_Release_Notes"
Personal tools