cosin software 2019-1 release notes

cosin

1. consolidation: no more distinction between error and fatal error
2. misleading license error messages revised
3. warning and error messages are no longer collapsed in message output block

cosin GUI

1. reduce cursor flickering
2. GUI geometry formatting in Windows with retina display improved

FTire

1. fix: computation of wheel envelope made work again for all kinds of rim motion
2. fix: potential race condition in simulation recording in multi-threaded mode solved
3. consolidation: very old compatibility date checks (up to and including December 2012) removed
4. improved pre-processing convergence if only very few data are given for second inflation pressure, by swapping priority of radial stiffness progressivity with longitudinal stiffness
5. tire surface triangulation in animation using regular triangles now w/o preferred direction
6. optional data-block [SOURCES] or $sources in tire data files introduced, where varying operating conditions and more can be specified in most general form via sources/sinks signals even if no cti file is used
7. improvements in animation settings:
   • sidewall coloring made selectable
   • brake disc display made selectable
   • initial background color made selectable in animation settings GUI
   • new optional background color ‚transparent‘
8. png/tiff image format made selectable in animation settings
9. output of ‚critical parameter sizes‘ made better readable
10. header of bso-files made better readable, simplifying development of own evaluation tools
11. detailed air-cavity model with quarter-car model at high speed made numerically more robust
12. new optional obj file list output for simplified CFD and acoustics simulation coupling
13. full support for Simpack rdf triangulation roads
14. made negative brake torque treatment work as described in documentation
15. message output made work on RedHawk platforms
16. file format for continuous surface geometry output optimized
17. parameter ‚weight_initial_radial_stifness‘ introduced
18. graphics flickering of wildly disconnected contact patch animations reduced
19. new output signal ‚max sinkage‘ for soft soil simulation introduced
20. proper error handling if tread pattern file or rim data file is specified but non-existent

FTire/sim

1. new function to put out 2D cleat enveloping curves during cleat test
2. new example file sample.sim for simultaneous specification of road data and sources/sinks control
3. animation and movie generation selection improved in GUI
4. optional rgu-file creation in FTire/sim-based soft-soil simulations introduced
5. sim scripts may contain tire data file name now such that the sim script alone can completely define an FTire/sim run

FTire/fit

1. FTire table data visualization and friction model images added to FTire/fit report
2. score indicator in FTire/fit measurement list now cleared if measurement is deactivated
3. improved color palette for error visualization

cosin/road

1. selection of road rendering color introduced
2. improved error messages in case of road loading issues

cosin/mbs

1. instrument panel placement in non-simulator cosin/mbs animation improved

cosin/tools

1. preventing message window popping up multiply under certain circumstances

cosin/tools for tires

1. fix: made sure new spline data don’t get lost when entered in GUI
2. fix: minor issue in new tire generation GUI
3. consolidation of spline specification in GUI
4. FTire steady-state analysis stability and step-size selection improved
5. FTire table data visualization and friction model images added to fingerprint report
6. new GUI for creation, editing, analysis, and evaluation of cti files
7. self-tuning wheel-load controller in Pac2002 model export made more robust
8. Pac2002 parameter identification made more robust

cosin/tools for roads

1. fix: minor format issue in rgr to stl road data file export
2. 2d road visualizer made interactive by providing sliders for time and scaling in graphics window
3. unified triangulation export to all supported CAD and triangulation file formats enabled for all road types
4. center-line export from rgr files added to GUI

cosin/tools for Matlab

1. Matlab bso file post-processing enhanced: comparison of two bso-files in one plot added

CTI

1. fix: made ctiWriteStatesMemory() work properly with force extrapolation
2. fix: clean cti exit in case of fast cosimulation mode (with new automated wait for all threads to complete prior to closing cti handles)
3. fix: avoided animation window freeze during ctiClose() if calling solver is Altair/MotionSolve
4. consolidation: CTI functions ctiLoadSTIRoadModel() and ctiLoadSTITireModel() are marked as deprecated and are discontinued from cosin version 2019-1 onwards
5. consolidation: direct support for outdated STI tire and road models, as well as user-defined CTI-driven tire models discontinued
6. introduction of new file type ‚cti‘ for use as input file in all CTI environments. cti files contain, for all tire instances of a simulation model,
   • links to tire and road data files to be used
   • specification of any initial settings
   • DOE and other parameter values to be used in arithmetic expressions of all input data files
   • sources/sinks definitions of extra input signals like inflation pressure, tread depth, ambient temperature, and more
   • specification of animation settings
   • specification of post-processing actions like cosin/ip output scripts for fully automated generation of general result graphs
7. new CTI function ctiFollowRoad() to compute the rigid-body motion of the rim such that a line parallel to the currently loaded road’s center-line is followed with constant slip and camber angle: to be used for stand-alone CTI demonstrations. The rigid-body state can be passed over to ctiComputeForces() without any further adaptation. For an example see the ctiFollowRoadDemo.c code.
8. new CTI function ctiLoadControlData() to select and load a cti file in cosin/io format, containing CTI control info for a single tire instance
9. new CTI function ctiLoadList() to select and load a cti file in cosin/io format, containing complete CTI control info for all tire instances of a given list. No extra calls to ctiLoadTireData(), ctiLoadRoadData(), or ctiLoadControlData() are required when using ctiLoadList().
10. new CTI function ctiSetUPROXY() to register a user-defined proxy function of typedef UPROXY as callback function. See for an example the ctiUproxyCbDemo.c code
11. new CTI function ctiReadStatesMemoryList() to read all state arrays from memory for a list of tire instances in multi-threaded mode
12. made all FTire plot signals available in cti files as sources/sinks control signals
13. made sure message window on/off selection is always effective in CTI environments
14. CTI statistics output completed with times of state save/retrieve
15. ensured ctiComputeForcesList() reset call resets also the force extrapolation mode to OFF
16. generalization of output file prefixes, potentially indicating simulation run number, simulation phase number, and tire instance
17. optionally preventing overwriting of existing output files by a respective entry in cosin cosimulation settings GUI
18. optional link to cti file added in tir-files; for use in 3rd-party environments that do not yet directly accept cti files instead of tir files
19. made sure output file directory is created if not existent
20. simulation recording enabled in single-thread case if ordered by ctiRecorder(), but not in tir-file
21. ctiRecorder() may now be called even after loading of tire data files, and will contain all file loading tokens and names though

CTIDL (CTI Dynamic Library Wrapper)

1. new CTIDL function ctidlGetTireDataFileName() to get file name of tire data file from a cti file
2. added HOME folder handing to ctidlGetCosinInstallFolder() for root accounts on Linux

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

1. new target dir mode CTICLI_TARGETDIR_NATIVE for cticliLoad*Data() functions

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

1. added –syslog option to send all messages to syslog (only for Linux)

Documentation

1. updated screenshots and inclusion of new items and menu options in many documentation chapters
2. included previously undocumented input variables for road types drum and cleat
3. documentation of all new CTI functions added