Updating to Version 19

The ROSE Math library provides the mesh data structures used by both faceting libraries, but now that IFC4 handles spline surfaces and boundary representations, we have consolidated algorithms used by STEP and IFC into the common math library.

If you include the mesh definitions, you may need to add some support libraries to your link line. The setup instructions have the current list of libraries. In addition, some class and function names have changed as outlined in the table below:

Some of the library functions lacked structure, making them difficult to find. We revised names across STEP, IFC, and ROSE to group them topically in a three level pattern. All functions begin with "stix", "ifcx", or "rose" to identify the layer, followed by a short topic area, like "unit", "xform", or "vec". Finally, the action, like "make", "get" or "find".

Most of the ROSE math functions already followed this convention, but we renamed the unit functions as below. The headers have #defines for the original names, so you do not need to change existing code. To see what needs to change, just disable the old names by defining ROSEMATH_NO_DEPRECATED_NAMES on the compile line or in your code.

#define ROSEMATH_NO_DEPRECATED_NAMES

The original and new names are listed below:

Deprecated Name				Current Name
rose_get_measure_as_unit		rose_unit_convert
rose_get_measure_type			rose_unit_get_measure_type
rose_get_measure_type_name		rose_unit_get_measure_name
rose_get_rational_unit			rose_unit_find_rational
rose_get_unit				rose_unit_find
rose_get_unit_conversion_factor 	rose_unit_get_conversion
rose_get_unit_denominator		rose_unit_get_denominator
rose_get_unit_fullname			rose_unit_get_fullname
rose_get_unit_name			rose_unit_get_name
rose_get_unit_numerator			rose_unit_get_numerator
rose_get_unit_related_by_factor		rose_unit_find_related_by_factor

Updating to Version 17

This ROSE Math library gathers together code that existed in the STEP Tools libraries for STEP, IFC, and other engineering data and then removed depencencies on specific EXPRESS schemas.

The STEP Faceter, IFC Faceter, and STEP helper function libraries now use mesh, transform, bounding box, and unit data types provided by the ROSE Math library. As a result, you will need to change some symbols when updating code that used the earlier definitions.

In most cases, updating older code is just a change from a "Stix" prefix to a "Rose" prefix, as with StixUnit to RoseUnit. In addition to the changes in the table below, you must add the rosemath.lib library to your link line.