cosin software 2017-2 release notes

cosin

1. TeimOrbit Data block names in TeimOrbit-formatted data files may have arbitrary upper/lower-case notation now
2. PID controller output made continuous in first call, to reduce initial transients
3. syntax check in arithmetic expressions improved: ’name of a function‘ no longer assumed by default if expression is part of a longer alphanumeric string
4. evaluation of arithmetic expressions accelerated
5. new fast interpolation routine for scattered data without need for previous triangulation
6. fix: potential thread safety violation in cosin/io file reading routines
7. introduction of new ‚program option manager‘: info about used program options added to program statistics output in verbose mode; option descriptions added in command-line invocation of cosin applications
8. all non-7bit-ASCII-characters removed from all text files in installation directory
9. improved error handling in case of license error
10. version in private data folder now saved in file .cosinversion (name independent on version)
11. potentially wrong interpretation of arithmetic expressions of form i.k+l (as done by GNU compilers) fixed, to match Matlab interpretation
12. made sure no already closed files are reopened in case of program abortion with esc
13. optional sound output in all cosin applications reactivated

cosin GUI

1. mandatory OpenCRG library selection included in cosimulation tab of cosin launchpad
2. CTI/server GUI extended and improved
3. better placement of file selector windows
4. improved windows control when generating encrypted rgr files
5. plot window placement improved
6. ‚New FTire/fit project ..‘ and ‚Open FTire/fit project ..‘ items added to cosin launchpad menu, for faster access to FTire/fit
7. simplified cosin version check in private data folders
8. GUI formatting improvements for high resolution displays in Windows

FTire

1. tir-files can hold and manage now simultaneously pre-processed data for RT and non-RT speed modes; by this, preprocessing refresh not any longer necessary when changing speed mode
2. arithmetic expressions kept in tir-files when discarding preprocessed data
3. ‚discard pre-processed data‘ fixed in case of write protected data file
4. new contact force visualization color introduced: orange if sliding but still left of friction maximum
5. new detailed output of ‚cleat contact phases‘
6. all example data files updated: default RT time step changed from 1/3 ms to 1/4 ms
7. initial temperature scale value mad selectable in animation settings
8. optional color legend quantization
9. new and unified color scheme for contour plot and tire surface coloring
10. automatic generation of sidewall texture image, indicating tire ETRTO string
11. new search function for scope selection in animation window
12. rim CAD model file name path may be relative to tire data file name now
13. improved automatic time axis scaling in FTire animation online plots
14. decoration strings in FTire animation window may contain now arbitrary signal values, enclosed in %
15. RT mode prepared for optional thermal and tread wear activation
16. obsolete operating condition ‚model level‘ removed
17. thermal and tread wear model selectable in all speed modes
18. efficiency of thermal model in accelerated speed modes improved
19. optional sensor traces in animation window added (if sensors displayed and traces activated in sensor pane)
20. sensor display made selectable in animation settings window
21. scaling of scopes time axis improved
22. fix png-file generation (via F3 in animation window)
23. demo license allows movie generation now
24. improved warning output in case of contact kinematics convergence issues
25. instability recognition improved
26. more accurate approximation of ‚contact point‘ output signal (and avoidance of convergence problems in case of sharp obstacles): usage of ground-pressure weighted footprint centroid instead of simplified contact geometry plot
27. output of road height footprint in [mm] instead of [m]
28. new truck tire example model
29. cosin/prm and FTire coupled
30. generalized recognition/creation of tire size string (ETRTO vs. P-metric vs. inch)
31. making sure that inertia forces in rim-fixed part of the tire are taken into account appropriately in force/moment output signals
32. optional output of deformed cross-section instead of full surface in animation window
33. pre-processing in case of steady-state data given in tire-file made thread-safe
34. correct gpo-file creation even if running backward or sideward
35. FTire structural DOFs visualization introduced
36. ground pressure output resolution made selectable
37. gas temperature and mean tread surface temperature introduced as independent operating conditions
38. independent initial conditions for filling gas temperature and mean tread surface temperature introduced
39. detailed thermal model output optionally activated even in higher speed modes
40. ‚lateral texture image shift‘ introduced and added to animation settings GUI
41. rim paint color made selectable (between pure aluminum and black)
42. extra camera shift settings added to animation settings from tir-file
43. optional brake disk added to FTire animation
44. fix: linearization in CTI if tire handle differs from tire index
45. improvements in linearization and modal analysis:
    • proper mode shape animation of rotating wheel
    • allowing off-lifted wheel even when making ‚loaded‘ condition assumption
    • in animation, only overlaid mode shape is amplified, not the distortion due to load
    • angular speed of modal analysis of rotating wheels correctly taken into account in mode shape animation
    • size of mode shape animation window increased
    • minimum rolling speed specification for linearization unified
    • modal analysis result output formatting in GUI improved; message if modes are not recognized
    • animation speed, mode shape amplitude, meshed/rendered display made controllable in animation window
    • order recognition in loaded modal analysis made more robust
    • movie generation checkbox re-enabled in GUI
    • extra window for results output in modal analysis
    • modal analysis settings saved in cosin/tools settings file
    • error message if speed choice is illegal in modal analysis menu
    • maximum frequency introduced in modal analysis
    • loaded linerarization always in pseudo-rolling state now, to guarantee continuous transition from standing to rolling
    • made sure tire is rotating at least 3-times in steady-state pre-processing for modal analysis of rolling tire
    • ‚gluing‘ in standing tire modal analysis and linearization made selectable in GUI and ctiLinearize() calls
    • default maximum damping in linearization set to 100% (to take into account complete system), in modal analysis to 25% (to take into account only relevant modes)
46. improved local implicit integration of block displacement in case of longitudinal coupling
47. prevent effective longitudinal tread stiffness coupling to become negative
48. fix: auto-balancing in case of TPMS sensor
49. potentially misleading size checks for membrane tension parameter removed in FTire data file reading routine
50. new optional side-wall coloring in FTire animation
51. robust Tydex signal output even in accelerated MT mode

FTire/fit

1. FTire/fit simulation scripts for steady-state tests with active thermal model completed with optional pressure control
2. FE data identification introduced; FE results import in FTire/fit
3. score display for footprints and FE results fixed in FTire/fit
4. FE results check-in improved: test for symmetry of road surfaces added, allowing in-plane/out-of-plane distinction, and more
5. output of fer-files (FE load-case result files) in both in FTire/static and FTire/calc added
6. direct check-in and identification of tdd-files (‚tire design data files‘) in FTire/fit, using internal automatic generation of fer-files (‚FE result files‘) with FTire/calc
7. FE result comparison images added to FTire/fit report
8. camber angle output added to slip sweep simulations in FTire/fit
9. new example files for FE results, containing radial deflection now
10. cleat description in FTire/calc and FTire/fit unified
11. FTire/fit (and similar) report generation in Windows fixed
12. all caption texts in FTire/fit validation plots unified
13. structure distortion visualization added for tdd files in FTire/fit
14. improved scaling/arrangement of cleat test plots
15. color scale for FE result comparison changed from VGA to green/red
16. info message issued if both drum angular velocity and drum moment of inertia is specified in FTire/fit cleat tests
17. optional non-constant drum velocity signal read from tdx file in FTire/fit cleat tests
18. FTire/fit projects made completely relocatable, by using relative paths in contr.ftf if applicable
19. improved message output in FTire/fit function ‚compare all‘
20. fix parallel cleat test simulation: first test might have had no proper road data
21. FTire/fit GUI simplified: specification of free parameters for cleat test identification
22. global scanning refinement steps introduced in FTire/fit optimizer
23. automatic Fz offset detection in cleat test check-in added
24. improvement in cleat test multi-criteria objective computation
25. optional detailed RMS values output for FTire/fit cleat test validation
26. wheel load controller for cleat tests with compliance improved
27. FTire/fit report improved: add all figure captions to TOC; unified figure caption texts; improved formatting
28. made sure cleat test after fitting are always plotted completely, even if only compared in frequency domain
29. free parameter bounds computation for FTire/fit fixed
30. rolling speed threshold value for static/steady_state discrimination in FTire/fit reduced from 1 to 0.1 m/s
31. reading FTire/fit parameters from file name fixed if first digit after decimal point is 0
32. fix: checking in tread patterns in FTire/fit
33. improved error handling if some but not all cleat tests fail in a group validation of FTire/fit
34. fix: treatment of case numbers > 9 in FTire/fit GUI for certain conditions
35. checking in bitmaps other than footprints in FTire/fit re-enabled
36. potential fail in cleat phase output fixed
37. all wheel load controller gains in FTire/fit scripts set to 0.3
38. some tooltips in FTire/fit settings improved
39. error values display in friction menu made easier readable

FTire/sim

1. new output signal ‚actual_pressure‘ provided in FTire/sim, useful in realizations of pressure control
2. looped simulation summary plot output fixed
3. ogl-file generation in FTire/sim enabled
4. all sim-script files made easier readable in Windows (some of them only had LF instead of CRLF)
5. moving contact body option added to FTire/sim
6. reference point for moving contact body in FTire/sim introduced
7. output control in mixed sequential-parallel call to FTire/sim fixed

FTire/link

1. prevent Matlab from crashing with ctrl+d when FTire/link model is running

cosin/tools

1. dynamic memory allocation for cosin/ip introduced, to allow loading of even huge data files
2. fingerprint button added to cosin/tools for tires
3. fix: potentially false plot signals when combining incompletely defined arithmetic expressions with multiple plots in cosin/ip
4. diagram legend position improved in cosin/ip
5. more general arithmetic expressions allowed in cosin/ip
6. reload button in cosin/ip GUI fixed
7. new Button in cosin/tools for optimization of numerical statics settings outside and w/o FTire/fit
8. made sure road visualisation window is visible when opened
9. improvements in cosin/ip and report generation: general legend table for attributes and file legends independent on number of actually loaded files
10. coordinate axis display in cosin/ip improved
11. immediate zoom/in and zoom/out implemented in cosin/ip
12. made sure animation window in cosin/CADplayer is not hidden
13. HTire/view graphics window reformatted
14. trim function in cosin/ip fixed
15. radial stiffness characteristics unit in HTire generalized
16. feature date for HTire introduced
17. command-line invocation of FTire fingerprint implemented
18. new cosin/ip command fftpow2 (to control frequency range of power spectrum output)
19. stack order in cosin/ip reverted: curves of first file are above curves of second file etc.
20. cosin/ip cursor display made faster
21. unit system ‚user-friendly‘ set to default unit system in cosin/tools
22. unit system management in cosin/tools fixed/improved, to avoid generation of wrong values if menu is open during unit system change
23. rim CAD file specification added to cosin/tools for tires GUI (tab ‚geometry‘)
24. lower output step size limit introduced in record-file analysis (CL option -hmtl=…)
25. Pacejka 2002 model export report generation improved
26. occasionally required RT license shown in cosin/tools for tires GUI
27. more animation setting items in tir-files made available through GUI

cosin/road

1. cosin evaluation for crg roads discontinued
2. external OpenCRG library is to be defined by the user (with cosin/tools cosimulation tab)
3. OpenCRG library included in cosin installation as a convenience, built from OpenCRG 1.1 sources
4. fixed 2 issues with RGR roads, detected by MSC:
   • patch swapping might not work properly if first tire handle is used only during init, but not in time loop
   • closed roads with superimposed RGR might see the RGR data only in the first lap
5. multiple specification of same huge crg file enabled, loading only once (OpenCRG is not able to do so by itself)
6. improved error message when trying to open encrypted road file in cosin/tools
7. OpenCRG shared library now built with OpenCRG 1.1. sources
8. password input for encrypted rgr files in Windows fixed
9. improved computation of cleat on rotating drum geometry
10. OpenCRG library unloading/loading enabled
11. auto-detect road size for xml to rgr export improved
12. superposition feature added to all cosin evr road data files
13. superposition of rgr files on rotating evr drums introduced

CTI

1. new ‚metrics‘ evaluation of FTire record files: frequency content analysis of input signals, API function calling statistics, time step control statistics, and more
2. metrics evaluation for 3rd-party test results implemented
3. made sure message output is not suppressed outside multi-threaded CTI-driven time loop
4. prevent log-file from being partially deleted in case of instability of certain customer-specific applications
5. output of licenses server and OpenCRG library in resources statistics
6. improved error message if OpenCRG library cannot be loaded
7. original OpenCRG messages shown in CTI message output
8. new mechanism to query smallest compatibility date of all loaded FTire models
9. zoom factor for CTI animation scenes changed
10. maximum admissible compliance estimation for simple K&C vehicle models added to general properties output; available via API function ctiGetTireDimensions()
11. road height output added to CTI record file analysis
12. ctiSetModelLevel() set to ‚deprecated‘
13. specification of animation settings source made available in 3rd-party environments
14. no killing of calling solver’s GUI if no license is available
15. added new CTI function ctiComputeForcesPosition() for usage in simple vehicle dynamics environments
16. added two new CTI functions: ctiComputeForcesListMT() and ctiGetForcesListMT() to split the ctiComputeForcesList() call into a ’start all threads‘ and a ‚wait for all threads to complete, then get forces/torques‘
17. added new CTI function ctiSetInitialTireTemperatures() to specify thermal model initial and operating conditions
18. license returned even if calling solver does not call ctiClose() for whatever reasons
19. ensure cosin/mbs uses the CTI shared library from the cosin/mbs installation folder
20. made sure rims in cosin/mbs are mounted correctly (outside out) on all wheels
21. put out contact point rather than wheel center in TYDEX signals # 66..68 during statics
22. made sure animation window doesn’t hang if called from CarMaker
23. new selectable feature in cosimulation settings: optionally prevent 3rd-party solver from disabling plot-file generation
24. no mass correction data output if not needed (i.e. if called by cosin application)
25. made sure old STI interface to Adams closes properly in case of run-time abort
26. made sure linearization is refreshed if time has proceeded in a ctiLinearize() call
27. ctiGetTydexSignals() extended, to put out compressed TYDEX signal array
28. potential thread-safety issue in CTI during fast force extrapolation mode fixed, by avoiding data exchange with calling solver during FTire threads actively running

CTIDL (CTI Dynamic Library Wrapper)

1. added COSIN_PREFIX handling to ctidlGetCosinInstallFolder which has priority over the setting stored in the cosin ini file
2. added more relaxed ctidl symbol loading, i.e. instead of stopping if a missing symbol is found a list with all missing symbol will be printed and the error code in ctidlInit is set accordingly. This will allow the usage of older FTire versions with ctidl if the missing symbols are not used in the current interface code.

CTI/client (client side of TCP- or UDP-based remote CTI execution)

1. new cticliComputeForcesListMT() and cticliGetForcesListMT() functions to split the cticliComputeForcesList() call in a compute forces/torque and a get forces/torque call
2. new cticliSetInitialTireTemperatures() function
3. added UDP support for cticliSetMultiThreadedCallFlag()
4. added UDP support for cticliGetTydexSignals()
5. removed cticliSetModelLevel()
6. homogenized CTICLIINIT and CTIINIT structures

CTI/server (server side of TCP- or UDP-based remote CTI execution)

1. added calling_solver handling (if set in CTICLIINIT structure)
2. added -cpuid option in UDP mode to pin the server to a given cpu
3. added ctisrv GUI for UDP communication specification

Installation

1. relocate OpenCRG libraries to external install directory; removed from cosin lib path
2. changed default Matlab release from R2009b to R2014a to avoid problems with Matlab greater or equal R2017a

Documentation

1. gpo file format description added to doc
2. notation in all documentation texts changed: ‚Imperial Units‘ are now called ‚UTC units‘
3. proposed usage of standard speed mode added to support checklist
4. added subset of TYDEX output signal description to CTI documentation (Appendix A.2)