June 2011 - Boost - lists.preview.boost.org

Re: [boost] [GSoC] Request for Feedback on Boost.Bloom Filter Project
by Phil Endecott 26 Jun '11

26 Jun '11

Arash Partow wrote: > Phil Endecott wrote: > > Sorry Arash but I don't understand your reply; what exactly > > is correct? > > My point was that you are correct, the "and" does not provide anything of > value. Only "or" and "xor" are practical for non-counting bloom filters. Well no, that's not what I said. For clarity, I believe that: 1. Bitwise OR of two bloom filters achieves the set union without any side effects. 2. Bitwise AND of two bloom filters achieves the set intersection, but it will introduce additional false positives, which may or may not be acceptable since they are already inherent in bloom filters. 3. Bitwise XOR of two bloom filters achieves something like the set symetric difference, but will introduce false negatives, which probably are not acceptable because bloom filters do not otherwise suffer from them. > I'm not sure what you mean by overlapping hashes I simply mean the case where two distinct values have the same hash for some of the hash functions. Regards, Phil.

1 0

[1.48.0] Schedule discussion
by Beman Dawes 26 Jun '11

26 Jun '11

In the "[boost] [1.47.0] Release branch now closed" thread, Daniel James and I discussed possible schedules for 1.48: Beman>>> While the release managers haven't talked about the 1.48.0 schedule Beman>>> yet, I personally would like to get back to our traditional quarterly Beman>>> schedule. That would mean 1.48.0 would be scheduled for the first Beman>>> Monday in August. Daniel>> We haven't got enough time for that. If we release 1.47 after a 2 week Daniel>> beta (i.e. pretty quickly), it will be released on 4th July, leaving Daniel>> just under a month before the first Monday in August. Beman> Agreed, but we could aim for as short a 1.48 schedule as is reasonable Beman> so that the 1.49 schedule is then back on the quarterly cycle. A 1.48 beta 5 weeks after 1.47 ships seems doable. That would be about August 8th, and then the release 3 weeks later, or about August 29. The 1.49 release then would be back on schedule for the first Monday in November. To make the above happen, we would need to open branches/release for merges immediately after 1.47 ships. Or maybe create a branch now for 1.48. Thoughts? --Beman

9 11

Re: [boost] Is there interest in an alternative to the Singleton anti-pattern?
by Ben Robinson 26 Jun '11

26 Jun '11

> > > If you choose the default policy of single_threaded, there is no > > thread safety, but there is also no overhead in using a mutex and using a > > volatile pointer. > > > > Volatile in C++ doesn't really help with threading... Check out < > > http://software.intel.com/en-us/blogs/2007/11/30/volatile-almost-useless-fo… > > > for one of many articles on the subject. > -- > Nevin ":-)" Liber <mailto:nevin@eviloverlord.com> (847) 691-1404 > > Thank you for the feedback. That article and the accompanying discussion is very interesting and informative. However, given the design of Singularity, I feel I still must make "instance_ptr" volatile for thread safety. If I do not, the compiler can store the pointer in a register, and other threads of execution will not see changes to its value. The linked article seems mostly concerned with fencing access to the variable, which I am achieving by using a mutex object. I only need volatile to prevent effectively reading a "cached" value for the pointer. I found the following article by Andrei Alexandrescu especially interesting: http://drdobbs.com/cpp/184403766 Also note, that the ThreadingModel for Singularity is policy based, so users of the class are free to develop alternative thread-safe policies, using whatever techniques are appropriate for their environment. Thank you, Ben Robinson, Ph.D.

2 1

[1.47.0] Regression in type_traits, is it too late to revert?
by John Maddock 26 Jun '11

26 Jun '11

There's a regression in type_traits caused by the addition of compiler-intrinsic support for Clang - this got reverted on Trunk after a flurry of discussion a while back: http://lists.boost.org/Archives/boost/2011/06/182844.php. Unfortunately it appears it never got reverted on the release branch. Can we please revert this? Thanks, John.

3 3

Interest in multi-dimensional array class templates.
by Brian Smith 25 Jun '11

25 Jun '11

The file maps.zip in the containers directory in Boost's vault contains a library with classes for the development of multi-dimensional array applications. Also included are scalar and fixed-size vector and matrix class templates with an expression template implementation of operators. The multi-dimensional array's can be fixed-size statically or dynamically allocated, or dynamically allocated and resizeable. Vectors and matrices can be statically or dynamically allocated and written in block form. The notation follows that provided by the STL and other Boost libraries. The classes lack tests using Boost's test framework and the documentation is rather sparse. The intention would be to remedy both issues if interest is sufficient to warrant it. Regards Brian

8 36

Re: [boost] [GSoC] Request for Feedback on Boost.Bloom Filter Project
by Alejandro Cabrera 25 Jun '11

25 Jun '11

Hello Phil, > Hi Alejandro, > > Alejandro Cabrera wrote: >> I'm writing to request feedback, suggestions, and advice from the Boost >> community. I've been working on a Bloom filter data structure for about >> a month and a half now. At this point, the following is complete and >> available in the Boost Sandbox: >> - working, basic prototype (insert& query operations, union& intersect) >> - a test suite covering the public interface >> - five examples >> - documentation covering many aspects of the project (tested on Chrome >> 12 and 13, Firefox 4 and 6) > At first glance, this looks very good. Well done. > > Bloom filters are essentially a quite simple concept, and I suggest > that you should stick to that i.e. resist any temptation to add lots of > extra features. Having said that, I think you should look at e.g. > std::set<> and std::unordered_set and see what you can do to make your > class closer to them. I can think of: > > - empty() > - clear() (Ah, you do have this, but not documented?) I accidentally skipped documenting this. Thank you for pointing this out. > - a constructor that takes a range, e.g. > int a[] = { 1,2,3,4,5 }; > bloom_filter<int> b(a,a+5); > std::list<int> l; > bloom_filter<int> c(l.begin(),l.end()); > - insert(begin,end) similarly I hadn't considered various ways to construct the Bloom filter. I assumed users would always want to start with an empty Bloom filter, but this would make using the Bloom filter more flexible. > - swap() I overlooked swap. I'll add this. > - You have a size() which is (confusingly?) different from those > containers' size(); it's more like capacity() I guess. (Similarly I > think I would rename count() to maybe bit_count().) I agree that using size() as I do is confusing, versus what size() has come to mean for standard containers. This would better be named something like bit_count(). I'll reconsider the name. > There is a trade-off between the size of the filter, the number of > values stored, the number of hash functions and the false positive > rate. You might consider adding some sort of compile-time > metafunctions to help the user determine the right size and number of > hash functions, based on their expected number of values stored and > acceptable false positive rate. Similarly, you could add a static > expected_false_positive_rate() method that takes the number of stored > values as a parameter. Given a desired false positive rate, an expected number of elements and an upper-limit on the storage requirement, it is possible to determine both a good Size value and a good number of hash functions. I see now how meta-functions can help alleviate the burden on the user for picking good values. This might take a bit of work to provide as a feature. It would involve ratios to represent the false positive rate as a template parameter to the meta-function. I'll put this feature off 'til version 1.1 or 1.2. Until that time, users will have to determine the best parameters for their application using the documentation guidelines. On that note, I think I should add a section to the tutorial detailing how to choose good parameters. > Sometimes it would be better for size to be a run-time parameter. I have a dynamic Bloom filter in the queue for variants. It's definitely required if I were to develop a scalable Bloom filter that guarantees a certain false positive rate, as detailed in a recent research paper titled "Scalable Bloom Filters". > Sometimes it would be useful to access the underlying data. For > example, say I have a spell check dictionary or a URL block-list; I > might want to compile that list into a bloom filter and ship that as a > binary file. For that I'd want to be able to use it as an adaptor on > top of an underlying container that I supply: > > // compile: > std::vector<uint32_t> data(100000); > bloom_filter b(data); // acts as a container adaptor > b.insert(...); > file f; > f.write(data.begin(),data.end()); > > // use: > memory_mapped_file f("dictionary.bloom"); > bloom_filter b(f); > if (b.contains(url)) .... I'm not sure how this would work. Could you elaborate further in this regard? Currently, as I understand, there's two components of interest. The first is to be able to access the underlying Bloom filter data for serialization/deserialization purposes. This should be easy enough to do given a function that exposes the Bloom filter data. The other component that I'm picking up on is to be able to construct a Bloom filter using various sources. Range construction will be added that semantically behaves as an insertion for each element in the range. However, I'm not sure how to support construction from a memory_mapped_file. > I think it would be sufficient for false_positive_rate() to return a > float. No-one cares about its 19th digit. I preferred greater precision to anticipate user needs. Unless false_positive_rate() were called frequently, I wouldn't expect that the added precision would incur a significant performance penalty. > For some reason I have a mental block about how intersection works. > Union is OK; I can see that > > set a; > set b; > bloom_filter(a) union bloom_filter(b) == bloom_filter( a union b ); > > but it's not clear to me if > > bloom_filter(a) intersect bloom_filter(b) == bloom_filter( a intersect > b ); > > Can you convince me? Intersect intends to leave only the bits shared between two bloom filters on. This also corresponds to the elements that both Bloom filters have inserted. The reason for this is because intersection is only allowed between Bloom filters that use the same hash function set and the same storage size. Assume that both Bloom filters are instantiated with hash functions that return the integer value of the element hashed. Then the following occurs: bloom_filter<int, 4> a; bloom_filter<int, 4> b; bloom_filter<int, 4> c; a.insert(1); a.insert(2); // 0110 b.insert(2); b.insert(3); // 0011 c = a & b; // 0010 At this point, only c.contains(2) will return true. > During the XInt review there was some discussion about whether > is_prime() should be called is_probably_prime(). The same argument > could be made here about whether your contains() should be > probably_contains(). If there were some six-letter word meaning > "probably contains" then I would support using it, but > "probably_contains" is a lot of typing. The wording for contains() is another tricky issue. probably_contains() has the benefit that it points out the probabilistic nature of the data structure. This is very helpful to warn users. I don't think the addition of 9 more characters to type (probably_) should be a problem, since it isn't the type of function that can nest on itself (x.contains(t).contains...). I will tentatively rename the function probably_contains(), and if further comments indicate that this adds some level of confusion, I'll reconsider the name again. > Regarding hash functions: I believe I have read that some care is > needed when you use essentially the same hash function but with > different seeds i.e. are the results really independent? It would be > be more obviously correct to have a set of hash functions that use > entirely different algorithms. Unfortunately this is hard. I've left the hashing component open to extension exactly because of this reasoning. The Bloom filter data structure does rely greatly on the use of good hash functions. However, the definition of "good" depends on the context. It might be that a CRC32 is perfect for some applications, but a murmurhash3 is better for others, and some applications might even require a cryptographically secure hash. Since the intent of the project is not to develop great hash functions, I'm inclined to leave the option of boost::hash_value as the default, though it might be best to default to an mpl::vector containing a single hash function instead of two, since as you stated, the results aren't independent. > Performance: it would be great to see some benchmarks for different > types against std::set and std::unordered_set. In particular it would > interesting to look at string keys of different lengths: both the bloom > filter and the unordered_set always have to look at every byte of the > string to compute the hash, while a std::set need only look at the > string's unique prefix. You mention things like web caches, and so I > guess getting some real-world benchmark data would be simple enough. > One hashing option for strings is to hash substrings. > I suspect that a benchmark on at least strings would be useful to demonstrate how the bloom_filter compares against std::set and std::unordered_set, assuming that most users will be hashing data (file names, URLs, etc.). I'll add benchmarks to my queue of things todo, but I want to make sure the interface is close to stable before I do commit to writing benchmarks. > Anyway, good work so far. > > > Regards, Phil. > Thank you for taking the time to comment so thoroughly on the Bloom filter project!

2 1

SVN Ignore for Bin dirs
by Joshua Boyce 25 Jun '11

25 Jun '11

Is it possible for somebody to add an svn:ignore for dirs like Bin, Stage, Dist, etc on the Boost trunk? Not a big deal, but I pull down Boost using svn:externals for one of my projects, then build it as part of my build script, and it's a little annoying having all the built files pop up in the commit list with no way to set them to ignore without having to do it manually on every checkout. Unless someone knows an SVN trick I can use in my project to work around this? (Though I can't see a reason using svn:ignore in Boost would be a problem...)

3 4

Assign V2 - first impression
by Christian Holmquist 25 Jun '11

25 Jun '11

Hi all, I've been using assign v1 for a long time, and I find it sometimes convenient to have at hand but I don't consider it a crucial tool. To have a v2 of the same library is to me..surprising.:) Very well, I compared the introduction of v1 and v2 to get a feeling for the difference V1: > The purpose of this library is to make it easy to fill containers with data > by overloading operator,() and operator()(). These two operators make it > possible to construct lists of values that are then copied into a container: A parenthesis-separated list: > map<string,int> m; > insert( m )( "Bar", 1 )( "Foo", 2 ); V2: > This second version of Boost.Assign is a new design, with optional support > for C++0x. Its core utility is a compact interface for executing the > repetitive tasks of assigning or inserting elements in a container, such as > follows > boost::for_each( > cal | do_csv_put<2>( "jan", 31, "feb", 28, "mar", 31 ), > std::cout > << lambda::bind( &p_::first, lambda::_1 ) << ':' > << lambda::bind( &p_::second, lambda:: _1 ) << ' ' > ); // prints jan:31 feb:28 mar:31 To my taste, I prefer V1 insert( m )( "Bar", 1 )( "Foo", 2 ); over V2 m | do_csv_put<2>( "Bar", 1, "Foo", 2) Even if I would find V2's syntax to be more tasty to the eye, i don't see that motivating enough for a new library at this point. Very well, continuing to understand the V2 library.. This example captures the basic features of this library: It maps arguments to a suitable data-element, p_( k, x ), and invokes a > container's modifier, insert. These semantics vary by container category. Operator | returns the modified container, thereby facilitating integration > with range algorithms. There is a function, csv_put, that achieves the same > as above, but without returning the container. Why is operator | used at all, if there are two separate functions? It doesn't look compelling to me and I'm perfectly fine with separating my statements, one for the assign part and one for the for_each part. In fact, the first example from the documentation would benefit from doing that, since it would be much more readable. cal | do_csv_put<2>( "jan", 31, "feb", 28, "mar", 31 ); boost::for_each(cal, long-lambda-expression..) Now it looks even more odd with the operator |. Additional features include: > Options for overriding default semantics, and macros to create custom > options > What are the default semantics? > A functor analogue of csv_put, put, for constructing a sequence of elements > from variadic argument lists > Two functions, csv_deque<> and deque<>, which are the analogues of those > just described, but which generate a container. You lost me here. I needed to read those sentences a few time before I think I understand what you mean. Functionality that is adjunct to or independent of what precedes is itemized > below: > Surely, this can be written smoother, no? =) > Chaining ranges, with special consideration for those created using the ref > functionalty (below) > I don't know what the docs are talking about at this point. Chaining ranges in the assign library? That sounds to the uneducated mind like a job for boost.range > Conversion from ranges to containers > This sentence doesn't make sence to me. std::container(range.begin(), range.end()) is supported by all containers. > A framework, whose identifiers are in namespace ref, for generating an > array of reference wrappers, for short, a reference-array. > I do not understand this part. What kind of container are we attempting to populate here? > Functionality is defined in namespace boost::assign::v2, thereby avoiding > any clash with the prior version [1]. Ok. Maybe V2 could show a compelling use-case that V1 lacks? I get the feeling V2 shows features I don't understand how to use, or didn't knew that I needed. Cheers, - christian

7 38

Re: [boost] Is there interest in an alternative to the Singleton anti-pattern?
by Ben Robinson 25 Jun '11

25 Jun '11

> > > I look forward to your feedback on the Singularity Pattern. The > unittests > > in Vault/Singularity/singularity_unittest.cpp are great to study first to > > see how Singularity is meant to be used. > > I have some remarks: > > 1) class single_threaded - if you remove user defined destructor and > constructor, it will become a POD type and compillers will do better > optimizations > > I completely agree. Done. Thank you. > 2) singularity_state, singularity_instance and singularity classes can > be combined together if you remove > BOOST_PP_REPEAT(BOOST_SINGULARITY_ARGS_MAX, > BOOST_PP_DEF_CLASS_TYPE_DEFAULT, _) from singularity and put this > templates directly for create functions. If you do so, code like: > > singularity<Horizon, single_threaded, int, Event*, Event&>::create(3, > &event, event); > > will look much better, just like: > > singularity<Horizon, single_threaded>::create(3, &event, event); > > Then, FRIEND_CLASS_SINGULARITY macro will be much shorter > > You suggestion simplifies the interface by implicitly determing the types for the user, rather than requiring them to manually specify them. But in addition, by only generating create(...) overloads that pass by reference or pointer (not by value which the user could have done before), we prevent the undesirable situation where a user would pass an object by value into Singularity which would then pass by value into their constructor. Now, all arguments which are passed by value are accepted by their reference, and then passed either by value, or by reference, into the constructor, whichever is present. A class obviously cannot provide both a value, and a reference constructor for the same type, so there are no ambiguity problems. An excellent suggestion. One detail, I still require the singularity_state and singularity_instance structs, because state should not depend on the threading model, and instance should not depend on the access model (see point 5 below). The only downside is that I must generate 2^(n+1)-1 function overloads if I am to support constructors up to a maximum of n arguments. I am basically permuting receiving the typed arguments by reference or by address. I have implemented Singularity without the BOOST_PP meta generating functions for now up to three arguments. Once the design is finalized, I will once again generate the create() functions based on BOOST_SINGULARITY_ARGS_MAX. 4) May be, it would be much better to derive from singularity. Then > the code will look just like this: > Horizon::create(3, &event, event); > or like: > Horizon< single_threaded >::create(3, &event, event); > I did not need to implement this suggestion, as implementing #2 also allowed this usage pattern. As such, Singularity is now usable as both a factory, or as a base class. I have unit tests and code comments demonstrating both usage patterns. This makes Singularity now far more usable, and general purpose. > 5) It would be great, to have a get() function in singularity, that > returns reference > > One of the selling points of Singularity is that it did not provide global access to an instance. However, I can see situations where this would be desirable, and also providing global access will make transitioning from Singleton much easier. Therefore, I have created an additional policy argument, which has a default value of "local_access", causing get() to throw an exception. However, if you instantiate Singularity with "global_access", you can now access the instance, provided create() has already been called and destroy() has not. > It's just what I saw in a 15 minutes of review. I will make a more > deep look a little bit later. Any comments are welcomed. > > > Best regards. > Antony Polukhin > Keep the feedback coming. I was going to post updated source and both AsFactory and AsBaseClass unit tests, to the Vault, but apparently the Vault is now deprecated. You can email me at icaretaker(a)gmail.com if you would like to see the new code. Here is an example of the new usage pattern: // Usage as a Factory: typedef singularity<Horizon, single_threaded, local_access> HorizonSingularityType; // same as singularity<Horizon> Horizon & horizonA = HorizonSingularityType::create(3, &event, event); HorizonSingularityType::destroy(); // Usage as a Base Class: class Horizon : public singularity<Horizon, multi_threaded, global_access> Horizon & horizonB = Horizon::create(3, &event, event); Horizon::destroy(); Thank you, Ben Robinson, Ph.D.

1 0

[graph] Bron Kerbosch Documentation
by Joel Young 24 Jun '11

24 Jun '11

Trac ticket 693 discusses the inclusion to trunk of the Bron Kerbosch cliques code from SOC 2007: https://svn.boost.org/trac/boost/ticket/693 Is there any documentation for this code in the boost::graph docs? I'm drawing a blank. First problem is that the example code is using typedef undirected_graph<Actor> Graph; which itself seems horribly documented. When I try to use a "real" undirected graph, I get compile errors stating that /usr/include/boost/graph/graph_concepts.hpp:455:13: error: no matching function for call to ‘renumber_vertex_indices(boost::adjacency_list<boost::vecS, boost::vecS, boost::undirectedS, boost::property<boost::vertex_name_t, unsigned int>, boost::property<boost::edge_weight_t, unsigned int> >&)’ Any tips? Thanks! Joel

2 2