Dear Chrono users,

Earlier today, we merged into the main branch of the Chrono repository a major 
refactoring of the Chrono code.

A big chunk of these changes were class and function name changes that were 
done for consistency and uniformity across the entire Chrono code base. 
However, we took this opportunity to also make more fundamental changes by 
obsoleting several unused or unneeded classes and member functions, 
reimplementing some low-level algorithms, fixed some bugs, and - in some 
instances - changing semantics (e.g.. in definitions of some ChLink joints and 
motors so that the same convention is followed throughout).

We expect that, once you switch to using this latest version of the code, every 
one of you will have to adjust and update your user code to reflect these API 
changes.  For many of you, it is likely that these updates will be simple 
translation of old names into new names. Others may be more deeply affected 
(especially if you were using now obsoleted functionality or were using objects 
whose semantics have slightly changed).   While we understand that this may 
take a bit of time, we strongly encourage you to make the switch as soon as you 
can.  This is because, moving forward, this will make it easier to get support 
through this mailing list and because this refactored code will be the basis of 
the upcoming Chrono 9.0 release.  This release will take place as soon as some 
new features and capabilities are merged in the main development branch (over 
the next few days).

To help you with the transition to the refactored Chrono code, we have provided 
extensive details in the latest entry of the 
CHANGELOG<https://github.com/projectchrono/chrono/blob/main/CHANGELOG.md#changed-refactoring-of-class-and-function-names>
 file.
There, you will find tables with changes related to header files, classes, and 
member functions.  These tables list objects in alphabetical order of their old 
names.  Please make sure to carefully consult these tables for a proper and 
correct translation of old symbol names to the new ones.  Furthermore, please 
read carefully the "Notes" provided at the bottom of that changelog entry which 
give further details on changes that went beyond simple name-smithing.

Please note that conda packages corresponding to the refactored Chrono code are 
not yet available. This will be generated in the coming days.

Please feel free to post here any follow-up questions you might have related to 
this set of changes.  We would also greatly appreciate you reporting back any 
issues and bugs you might encounter with the new code. Despite the several 
rounds of exhaustive testing we went through during this refactoring, some 
problems may have slipped through the cracks.  We will be undergoing our own 
internal testing before the 9.0 release.

Thanks,
Radu

-- 
You received this message because you are subscribed to the Google Groups 
"ProjectChrono" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/projectchrono/PH0PR06MB8237E8FDB9F3AE45C40BD930A7352%40PH0PR06MB8237.namprd06.prod.outlook.com.

Reply via email to