I have had much the same experience as you. The library seems to hold a lot of promise and is from what I can see very sophisticated. But I had the same problems with the documentation and examples. I struggled for some time to figure out the difference between units and base units (and dimensions and base dimensions) and when you would use each. If someone could put together a decent tutorial I'm sure I would use this library quite frequently. -----Original Message----- From: Robert Ramey [ramey@rrsd.commailto:ramey@rrsd.com] Sent: Sunday, September 15, 2013 01:14 PM Eastern Standard Time To: boost-users@lists.boost.org Subject: [Boost-users] [units] I have an urgent and definite need for the functionality which boost.units is meant to provide. The concept is quite simple so I had expected it to be relatively easy to use. I had anticipated spending a few hours perusing the documentation and examples, adding code to my application and moving on. T'was not to be. I'm now on day 3 (or 4?) trying to figure this thing out. The main hurdle is that the documentation is indecipherable. There are a number of templated classes defined which depend upon each other. I expect to find a page for each of the templates along with a description of what the template arguments should be. (Ideally these should be backed up with concept checking classes). Ideally there would be a small example showing how one would use these templates. It seems that the library is layered from low level ideas to higher level ones. The documentation touches on this - but its not really formalized. Theres a reference section which includes scores of things like base_units types for wide variety of units - but no where is there any indication how these should be used - not even in the examples are they used. There is a concept of "system" (of dimensions?) and the idea of mixing units from different systems and the idea that the same dimension (eg length) have multiple renderings in the system (nautical vs metric). I realize I've likely got this wrong and I'm not asking for anyone to explain this to me here - my point is that what should be very simple is incredibly confusing. I still haven't figured out whether it's only the documentation which is incomplete or if it is the actual logical design of the library itself is what's flawed. I'm still working on this. I don't remember much traffic on this list regarding this library and if I google information on boost C++ units library I don't get a whole lot of hits. This could mean that that the library is so easy to use no one ever needs to ask about it or it could be that almost no one every uses it. In Boost we don't gather statistics on usage by library so I don't which of these it might be. So my question is: Has anyone had good success with this library? How much effort did it take? What did you have to do to make it work. I would be curious about any other user feed back in these questions. Robert Ramey _______________________________________________ Boost-users mailing list Boost-users@lists.boost.org http://lists.boost.org/mailman/listinfo.cgi/boost-users ________________________________ IMPORTANT: The information contained in this email and/or its attachments is confidential. If you are not the intended recipient, please notify the sender immediately by reply and immediately delete this message and all its attachments. Any review, use, reproduction, disclosure or dissemination of this message or any attachment by an unintended recipient is strictly prohibited. Neither this message nor any attachment is intended as or should be construed as an offer, solicitation or recommendation to buy or sell any security or other financial instrument. Neither the sender, his or her employer nor any of their respective affiliates makes any warranties as to the completeness or accuracy of any of the information contained herein or that this message or any of its attachments is free of viruses.