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)
New in Catool 1.3 (Aug 30, 2016)
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)
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