Deprecate RealVector.sparseIterator()

Details

Description

Following MATH-870, RealVector.sparseIterator() has become useless. Its interface was confusing. Indeed, the Javadoc states

Specialized implementations may choose to not iterate over all dimensions, either because those values are unset, or are equal to defaultValue(), or are small enough to be ignored for the purposes of iteration.

The reference to defaultValue() (which does not exist) suggests that the interface offers the flexibility to chose the value which is not stored in the sparse implementation. On the other hand, "small enough to be ignored" suggests that this default value is zero.

Luc Maisonobe
added a comment - 21/Feb/14 10:18 Un-deprecated method in r1570510.
The documentation explicitly states that ignored entires are the exact zero ones.
This is part of Apache Commons Math reconsidering support for sparse
linear algebra.