Catool Changelog

What's new in Catool 2.2.0

Mar 31, 2024
  • Prevent NaN calculations in MFB, Wiebe, Heat Release, Polytropic Index calculations
  • MFB speed improvement
  • Configure gas temperature model - "gas_temp_model ( REF_CA | IVC | AVL_THERMO1 )"
  • Only calculate groups and allocate results for loaded channels
  • Support IFiles greater than 2GiB
  • Improved IFile channel support
  • Fixed MATLAB IFile parameter output
  • Support passing through 64-bit floating point data from IFile to MATLAB
  • Fourier stats speed and robustness improvements

New in Catool 2.1.0 (Dec 20, 2022)

  • Support 64-bit timestamped abscissa
  • FFT frequency correction
  • SOC default to zero degrees, was 20 BTDC
  • Knock onset defaults to zero degrees if not found
  • Knock onset threshold is now configurable
  • Heat release can be calculated between SOC_EEOC or IVC_EVO
  • Improved camshaft edge and timing calculations
  • Calculate knock signal energy
  • Calculate misfiring cycles
  • Improvements to channel resampling algorithm
  • Support valve lift calculations
  • Separate knock boss window configuration from knock pressure window
  • Calculate FFT statistics
  • Allow plugins for more channel types
  • Classify cycles for cylinder deactivation and exclude from misfire
  • "load-channels" keyword now allows minus prefix to negate, i.e. 'load-channels all -CYLPR1'

New in Catool 2.0.4 (Mar 18, 2021)

  • Fix crash in FFT
  • Robustness to very low PPR resolutions
  • Swept volume and clearance volume calculated with 64-bit resolution
  • Enable catoolRT DLL plugin capability ('plugin <DLL FILENAME>')
  • CSV and IFile data loaded with 64-bit resolution
  • Added 'output-variable <CA/TIME/RESULTS> <FLOAT/INTEGER>' to specify IFile storage type 32-bit floating point or 16-bit fixed point
  • Filtering speed improvements
  • Add channel description to IFile output
  • Fix issues loading parameter values from IFile
  • Fix issue with manifold pressure offsets when an extended channel had been loaded

New in Catool 2.0.3 (Oct 19, 2020)

  • Decode IFile dates in xx.xx.xx format
  • Engine swept and clearance volume performed with 64-bit floating point accuracy
  • IFile improvements for determining DGB abscissa type

New in Catool 2.0.2 (Sep 8, 2020)

  • Engine information in MATLAB files is now in an 'engine' structure, i.e. 'engine.bore'
  • File information in MATLAB files is now in a 'header' structure: header.filename, header.comment and header.date
  • IFile parameters in MATLAB files are now in a 'parameters' structure. parameters.PAR01
  • Other highlights include:
  • Fix scaling issues with data stored in IFile as 64-bit formats (2.0.2)
  • Allow WOSCHNI_GT and ASSANIS heat transfer models to be configured (2.0.1)
  • Total angular torque calculations work with mixed abscissa between channels
  • Default start of combustion is -20 degrees (was zero)
  • Add calculated power in kW
  • Add option to calculate IMEP in 1 degree steps
  • Add AVL_THERM1 heat release and mean gas temperature method. Note that units are kJ/m^3/deg not kJ/m^3 inline with AVL
  • Add AVL_THERM1_FIXED and AVL_THERM1_A gamma calculations
  • Robustness improvements to positive HR start of comubstion calculation
  • Add 'channel analysis-info'
  • Add POSITIVE_HR start of comubstion type
  • Automatically load dependent channels for start of combustion and offset correction
  • Add WOSCHNI_GT and ASSANIS heat transfer models
  • Add 'configure-analysis' to determine what analysis can be run for each channel
  • Improved default 2-stroke valve timing
  • Ensure MATLAB channel names are unique
  • Include start of combustion and offset correction configuration in MATLAB channel information
  • Reduced memory requirements for analysis calculations

New in Catool 2.0.1 (Jul 11, 2020)

  • Note that there are some changes to the format of generated MATLAB files:
  • Engine information in MATLAB files is now in an 'engine' structure, i.e. 'engine.bore'
  • File information in MATLAB files is now in a 'header' structure: header.filename, header.comment and header.date
  • IFile parameters in MATLAB files are now in a 'parameters' structure. parameters.PAR01
  • Other highlights include:
  • Allow WOSCHNI_GT and ASSANIS heat transfer models to be configured (2.0.1)
  • Total angular torque calculations work with mixed abscissa between channels
  • Default start of combustion is -20 degrees (was zero)
  • Add calculated power in kW
  • Add option to calculate IMEP in 1 degree steps
  • Add AVL_THERM1 heat release and mean gas temperature method. Note that units are kJ/m^3/deg not kJ/m^3 inline with AVL
  • Add AVL_THERM1_FIXED and AVL_THERM1_A gamma calculations
  • Robustness improvements to positive HR start of comubstion calculation
  • Add 'channel analysis-info'
  • Add POSITIVE_HR start of comubstion type
  • Automatically load dependent channels for start of combustion and offset correction
  • Add WOSCHNI_GT and ASSANIS heat transfer models
  • Add 'configure-analysis' to determine what analysis can be run for each channel
  • Improved default 2-stroke valve timing
  • Ensure MATLAB channel names are unique
  • Include start of combustion and offset correction configuration in MATLAB channel information
  • Reduced memory requirements for analysis calculations

New in Catool 2.0 (Jul 5, 2020)

  • Note that there are some changes to the format of generated MATLAB files:
  • Engine information in MATLAB files is now in an 'engine' structure, i.e. 'engine.bore'
  • File information in MATLAB files is now in a 'header' structure: header.filename, header.comment and header.date
  • IFile parameters in MATLAB files are now in a 'parameters' structure. parameters.PAR01
  • Other highlights include:
  • Total angular torque calculations work with mixed abscissa between channels
  • Default start of combustion is -20 degrees (was zero)
  • Add calculated power in kW
  • Add option to calculate IMEP in 1 degree steps
  • Add AVL_THERM1 heat release and mean gas temperature method. Note that units are kJ/m^3/deg not kJ/m^3 inline with AVL
  • Add AVL_THERM1_FIXED and AVL_THERM1_A gamma calculations
  • Robustness improvements to positive HR start of comubstion calculation
  • Add 'channel analysis-info'
  • Add POSITIVE_HR start of comubstion type
  • Automatically load dependent channels for start of combustion and offset correction
  • Add WOSCHNI_GT and ASSANIS heat transfer models
  • Add 'configure-analysis' to determine what analysis can be run for each channel
  • Improved default 2-stroke valve timing
  • Ensure MATLAB channel names are unique
  • Include start of combustion and offset correction configuration in MATLAB channel information
  • Reduced memory requirements for analysis calculations

New in Catool 1.5.4 (Apr 21, 2020)

  • Speed improvement to FFT (1.5.4)
  • Correction to FFT axis for frequency and engine order (1.5.4)
  • Allow custom defined cylinder volume to be imported using command "engine custom-volume volume.csv" where volume.csv is a comma seperated file with crank angle from -360 to +360 degrees and volume in cubic centimetres. (1.5.4)
  • Rename channel using command "channel rename " (1.5.4)
  • Set FFT channel units same as source channel (1.5.4)
  • All crank angle and frequency based calculations can be removed from analysis. If necessary they will be calculated "on-the-fly" for cycle based analysis. This can save significant amounts of memory. (1.5.4)
  • Add 3-point polytropic offset correction. Third point is the middle of the two configured points. "channel CYLPR1 channel-offset type POLYTROPIC_3PT". Existing AVL compatible 2-point method is still default (POLYTROPIC or POLYTROPIC_2PT). (1.5.4)
  • "engine info" now includes custom volume information (1.5.4)
  • Fixed an issue where AVL IFile parameter values were wrong (1.5.4)
  • Fixed an issue with exported IFiles not having correct extension information (1.5.4)
  • Bug fix importing CSV data (1.5.3)
  • Fix crash in parsing IFile parameters (1.5.2)
  • Improved AVL IFile support (1.5.1)
  • AVL IFile parameters output in MATLAB file (1.5.1)
  • Speed improvements to FFT
  • Calculate angular torque
  • Divide-by-zero protection during TLA calculation
  • Knocking pressure not absolute
  • Heat release now calculated between IVC and EVO (was SOC and EEOC)
  • Added WoschniGT heat transfer model
  • Added Chang et al gamma model (SAE 2004-01-2996)
  • Calculate spark restrike current, timing, delay and dwell time
  • Groups only calculated for crank angle channels
  • Calculate FFT of knocking pressure and angular torque sum
  • No longer calculate engine speed for every crankangle channel
  • Robustness improvements to engine speed calculation from AVL IFile data
  • Improved CSV import
  • Invertion allowed on output-data, i.e. "output-data ALL -CA" will output all data types except crank angle
  • Filtering uses dynamically expanding memory for speed improvement purposes
  • Time based channels are prefixed TM_ in MATLAB file output, i.e. crankangle channel will be called CYLPR1 and time based will be TM_CYLPR1
  • Frequency channels now included in MATLAB file output
  • AVL IFile: robustness improvements for data group types
  • AVL IFile: support 8-byte (double) and 16-byte (long double) data
  • AVL IFile: support channels embedded in extended data, i.e. from AVL X-ion

New in Catool 1.5.2 (Mar 23, 2020)

  • Fix crash in parsing IFile parameters

New in Catool 1.5.1 (Mar 22, 2020)

  • Improved AVL IFile support
  • AVL IFile parameters output in MATLAB file

New in Catool 1.5 (Feb 23, 2020)

  • Speed improvements to FFT
  • Calculate angular torque
  • Divide-by-zero protection during TLA calculation
  • Knocking pressure not absolute
  • Heat release now calculated between IVC and EVO (was SOC and EEOC)
  • Added WoschniGT heat transfer model
  • Added Chang et al gamma model (SAE 2004-01-2996)
  • Calculate spark restrike current, timing, delay and dwell time
  • Groups only calculated for crank angle channels
  • Calculate FFT of knocking pressure and angular torque sum
  • No longer calculate engine speed for every crankangle channel
  • Robustness improvements to engine speed calculation from AVL IFile data
  • Improved CSV import
  • Invertion allowed on output-data, i.e. "output-data ALL -CA" will output all data types except crank angle
  • Filtering uses dynamically expanding memory for speed improvement purposes
  • Time based channels are prefixed TM_ in MATLAB file output, i.e. crankangle channel will be called CYLPR1 and time based will be TM_CYLPR1
  • Frequency channels now included in MATLAB file output
  • AVL IFile: robustness improvements for data group types
  • AVL IFile: support 8-byte (double) and 16-byte (long double) data
  • AVL IFile: support channels embedded in extended data, i.e. from AVL X-ion

New in Catool 1.4.1 (Nov 5, 2018)

  • Generate MATLAB channel names after loading IFile
  • Prevent crash if 'analysis-info' called before 'run-analysis'

New in Catool 1.4 (Nov 2, 2018)

  • Speed improvements to FFT analysis
  • Improved pressure rise rate calculation
  • Robustness improvements to EEOC calculation
  • Determination of cylinder deactivation
  • Improved polytropic indices calculation
  • Added LOAD calculation
  • Support plugin cylinder volume and analysis calculations
  • Support additional CSV file configurations
  • Speed improvements to filtering
  • IFile: load channels saved from CalcGraph

New in Catool 1.3.4 (Aug 21, 2017)

  • Uses statically linked pthreads-win32 library, reducing need for additional DLL files

New in Catool 1.3.3 (Aug 16, 2017)

  • Option to interpolate MFB angles rather than chosing next higher angle
  • Calculate Net and Gross indicated torques
  • Implement alignment option for falling and rising edge start of combustion channels
  • Support analysis plugins
  • Only store analysis channels as names rather than channel numbers
  • Add "channel info" parameter
  • When refering to channel numbers they must be preceded with a hash. i.e. "channel #1 name CYLPR1"
  • Improvements to IFile channel offset handling
  • Various fixes for compiler warnings and Cppcheck/Coverity analysis

New in Catool 1.3.2 (Mar 18, 2017)

  • Motored cylinder pressure can be extrapolated back to BDC
  • New estimated trapped gas mass calculation
  • Additional robustness checks for Start of Combustion configuration
  • Added classification thresholds for Knock/Mega Knock based on knock boss analysis
  • Offset correction converts from psi, kPa, Pa and Mpa to bar if necessary
  • Only use IFile channels for engine speed if they have been loaded
  • Add confgiguration for analogue to digital channel conversion
  • Add ability to skip columns on CSV import (skip-columns)
  • Added CSV output types CA_MEAN and RESULTS_STATS
  • Added 3-point median filter
  • Improvements to IFile offset correction: Polytropic and manifold/intake/exhaust

New in Catool 1.3.1 (Aug 30, 2016)

  • TBD.

New in Catool 1.3 (Aug 30, 2016)

  • TBD.

New in Catool 1.2 (Aug 30, 2016)

  • Add channel filtering;
  • Add IMEP mean pressure calculation method;
  • Improved digital channel calculation;
  • Add additional methods for gamma calculation (specified, indolene, propane, Hayes);
  • Add analysis for knock sensor, igniton and crank position sensor;
  • Resize number of cycles;
  • Sample data from existing channel;
  • Delete channel;
  • Copy channel;
  • Resample channel abscissa;
  • Generate channel (sine, block, crank position sensor);
  • Convert CA/cycle channel to time base;
  • Start of better handling of lack of memory;
  • Improved polytropic offset correction (closer to AVL method);
  • Knock boss reference window FFT calculation;
  • Add mega-knock cycle classification;
  • Make results error checking configurable;
  • IFile robustness improvements;
  • Save catool channel type in IFiles;
  • Remove IFile CA_TO_TIME (replaced by channel to time conversion);
  • Improved export of time base IFile and MATLAB files;
  • Bug fixes, speed improvements, increased robustness.

New in Catool 1.1 (Aug 30, 2016)

  • Burn centre of gravity and knock factor calculations added;
  • Improvements to analysis request validation;
  • Additional configuration of various analysis' added;
  • Speed and robustness improvements and bug fixes;
  • Coverity Scan and cppcheck fixes.

New in Catool 1.0.5 (Aug 30, 2016)

  • Make TLA calculation more robust when pressure peak is at edges of cycle;
  • Improvements to digital channel calculation;
  • Fixes to manifold pressure pegging;
  • CSV: Crank angle results output is of the mean data not the first cycle;
  • Improvements to config file parsing, allow channel name to be used in all cases;
  • IFile: Improvements to measurement table checking and robustness;
  • Various other bug fixes;
  • Updates to the rover_v8_csv.ccf and rover_v8_avl.ccf example files.

New in Catool 1.0.4 (Dec 15, 2014)

  • Make TLA calculation more robust when pressure peak is at edges of cycle
  • Improvements to digital channel calculation
  • Fixes to manifold pressure pegging
  • CSV: Crank angle results output is of the mean data not the first cycle
  • Improvements to config file parsing, allow channel name to be used in all cases
  • IFile: Improvements to measurement table checking and robustness
  • Various other bug fixes
  • Updates to the rover_v8_csv.ccf and rover_v8_avl.ccf example files

New in Catool 1.0.2 (Nov 11, 2014)

  • Fixes to ensure analysis channels are initialised correctly

New in Catool 1.0 (Nov 11, 2014)

  • Rate of pressure rise calculated using smoothed pressure trace
  • Smoothed pressure now calculated over entire abscissa range
  • NEW: Calculation of camshaft and injection timing
  • Polytropic indices only calculated during closed volume period
  • Added offset correction based on mean value of another channel
  • Improved robustness for determining engine speed from an IFile
  • Ability to output raw IFile cycle results in CSV format
  • Support 64-bit floating point data in IFiles
  • Various bug fixes, compiler warnings and robustness improvements

New in Catool 0.9.10.6 (Jan 14, 2014)

  • IFiles: Check if file is ZIP compressed and warn user, skip data regions that are outside of file (prevent crash)
  • Calculate engine speed from IFile SPEED, CYCDUR, CYCTIME channels if necessary
  • Improvements to PKP calculation at abscissa change points
  • Speed Improvements
  • Bug Fixes

New in Catool 0.9.10.5 (Jan 13, 2014)

  • IFiles: Check if file is ZIP compressed and warn user, skip data regions that are outside of file (prevent crash)
  • Calculate engine speed from IFile SPEED, CYCDUR, CYCTIME channels if necessary
  • Improvements to PKP calculation at abscissa change points
  • Speed Improvements
  • Bug Fixes (Thanks to Peter Van Wieren)

New in Catool 0.9.10.4 (Oct 1, 2013)

  • Cylinder pressure will not be truncated to zero by specifying "channel X channel-offset truncate 0".
  • Outputting time data to CSV file has been implemented
  • "load-channels" or "channel" commands can specify channel names as well as numbers
  • Fixed bug that crashed catool when not loading all IFile channels
  • IFile loading and saving improvements
  • Loading IFiles into MATLAB loads all raw data groups

New in Catool 0.9.10.3 (Jan 11, 2013)

  • Various bug fixes

New in Catool 0.9.9 (Jul 3, 2012)

  • Improvements to Wiebe (Vibe) calculations, including generation of CA based MFB curve
  • Improved wrist pin offset handling (now per cylinder)
  • Code fixes from Coverity Scan
  • Various bug fixes

New in Catool 0.9.8.2 (Mar 24, 2012)

  • Two stroke fixes
  • Various robustness improvements
  • Change default heat release calculation to first law
  • Start of combustion fixes
  • Output channel names in CSV output files
  • cppcheck and splint fixes
  • Robustness checking for IndiCom 1.3 IFile extensions

New in Catool 0.9.8.1 (Mar 24, 2012)

  • Bugfix: IFile output had wrong crankangle abscissa
  • Output extended channel names in IFile if necessary
  • Only use extended channel name when loading IFile if less than 64 characters
  • Use default engine speed if no engine speed calculated

New in Catool 0.9.8.0 (Mar 24, 2012)

  • Use of -360 to 360 degree nomenclature (was previously 0 to 720 degrees) IMPORTANT: Existing configuration files will need any angular references offset to the new nomenclature
  • Automatic determination of start of combustion channels
  • Cylinder pressure smoothing for pressure rise rate calcs
  • Calculated second order polynomial for TDC determination
  • % burn angle calculated correctly
  • Improvements to heat release calculations
  • General robustness improvements
  • Minimum abscissa resolution now unlimited (was fixed at 0.05 degrees)
  • Cylinder volume calculation improvements with offset wrist pin
  • Improved cylinder pressure offset correction
  • Convert AVL IFile to MATLAB using command line switch
  • Improvements to IFile support:
  • Supports interleaved channel data
  • Recognises DISI engine type
  • Supports any abscissa resolution
  • Robustness improvements against invalid files
  • Automatically converts from psi, kPa, Pa or MPa measurements to bar
  • Improved pressure offset support
  • Supports long channel names
  • Supports stdin input in addition to configuration files

New in Catool 0.9.3 (Aug 10, 2007)

  • Multithreading capable using the pthreads library (Windows and UNIX)
  • Fixes to heat release and IMEP calculation
  • Fixes for big-endian and 64-bit architectures
  • General bug fixes and speed improvements