*/
void symmetrize ();
- /**
- * Print the sparsity of the matrix
- * in a format that <tt>gnuplot</tt> understands
- * and which can be used to plot the
- * sparsity pattern in a graphical
- * way. The format consists of pairs
- * <tt>i j</tt> of nonzero elements, each
- * representing one entry of this
- * matrix, one per line of the output
- * file. Indices are counted from
- * zero on, as usual. Since sparsity
- * patterns are printed in the same
- * way as matrices are displayed, we
- * print the negative of the column
- * index, which means that the
- * <tt>(0,0)</tt> element is in the top left
- * rather than in the bottom left
- * corner.
- *
- * Print the sparsity pattern in
- * gnuplot by setting the data style
- * to dots or points and use the
- * <tt>plot</tt> command.
- */
- void print_gnuplot (std::ostream &out) const;
-
/**
* Return number of rows of this
* matrix, which equals the dimension
*/
bool optimize_diagonal () const;
- /**
- * This is kind of an expert mode. Get
- * access to the rowstart array, but
- * read-only.
- *
- * Use of this function is highly
- * deprecated. Use @p{row_length}
- * and @p{column_number} instead.
- *
- * Though the return value is declared
- * <tt>const</tt>, you should be aware that it
- * may change if you call any nonconstant
- * function of objects which operate on
- * it.
- *
- * You should use this interface very
- * carefully and only if you are absolutely
- * sure to know what you do. You should
- * also note that the structure of these
- * arrays may change over time.
- * If you change the layout yourself, you
- * should also rename this function to
- * avoid programs relying on outdated
- * information! */
- const unsigned int * get_rowstart_indices () const;
-
- /**
- * @deprecated. Use @p{row_length}
- * and @p{column_number} instead.
- *
- * This is kind of an expert mode: get
- * access to the colnums array, but
- * readonly.
- *
- * Though the return value is declared
- * <tt>const</tt>, you should be aware that it
- * may change if you call any nonconstant
- * function of objects which operate on
- * it.
- *
- * You should use this interface very
- * carefully and only if you are absolutely
- * sure to know what you do. You should
- * also note that the structure of these
- * arrays may change over time.
- * If you change the layout yourself, you
- * should also rename this function to
- * avoid programs relying on outdated
- * information!
- */
- const unsigned int * get_column_numbers () const;
-
/**
* Write the data of this object
* en bloc to a file. This is
*/
void block_read (std::istream &in);
+ /**
+ * Print the sparsity of the
+ * matrix. The output consists of
+ * terms <tt>[i,j]</tt> for each
+ * allocated entry. No linefeeds
+ * are added.
+ */
+ void print (std::ostream &out) const;
+
+ /**
+ * Print the sparsity of the matrix
+ * in a format that <tt>gnuplot</tt> understands
+ * and which can be used to plot the
+ * sparsity pattern in a graphical
+ * way. The format consists of pairs
+ * <tt>i j</tt> of nonzero elements, each
+ * representing one entry of this
+ * matrix, one per line of the output
+ * file. Indices are counted from
+ * zero on, as usual. Since sparsity
+ * patterns are printed in the same
+ * way as matrices are displayed, we
+ * print the negative of the column
+ * index, which means that the
+ * <tt>(0,0)</tt> element is in the top left
+ * rather than in the bottom left
+ * corner.
+ *
+ * Print the sparsity pattern in
+ * gnuplot by setting the data style
+ * to dots or points and use the
+ * <tt>plot</tt> command.
+ */
+ void print_gnuplot (std::ostream &out) const;
+
/**
* Determine an estimate for the
* memory consumption (in bytes)
*/
unsigned int memory_consumption () const;
+ /**
+ * This is kind of an expert mode. Get
+ * access to the rowstart array, but
+ * read-only.
+ *
+ * Use of this function is highly
+ * deprecated. Use @p{row_length}
+ * and @p{column_number} instead.
+ *
+ * Though the return value is declared
+ * <tt>const</tt>, you should be aware that it
+ * may change if you call any nonconstant
+ * function of objects which operate on
+ * it.
+ *
+ * You should use this interface very
+ * carefully and only if you are absolutely
+ * sure to know what you do. You should
+ * also note that the structure of these
+ * arrays may change over time.
+ * If you change the layout yourself, you
+ * should also rename this function to
+ * avoid programs relying on outdated
+ * information! */
+ const unsigned int * get_rowstart_indices () const;
+
+ /**
+ * @deprecated. Use @p{row_length}
+ * and @p{column_number} instead.
+ *
+ * This is kind of an expert mode: get
+ * access to the colnums array, but
+ * readonly.
+ *
+ * Though the return value is declared
+ * <tt>const</tt>, you should be aware that it
+ * may change if you call any nonconstant
+ * function of objects which operate on
+ * it.
+ *
+ * You should use this interface very
+ * carefully and only if you are absolutely
+ * sure to know what you do. You should
+ * also note that the structure of these
+ * arrays may change over time.
+ * If you change the layout yourself, you
+ * should also rename this function to
+ * avoid programs relying on outdated
+ * information!
+ */
+ const unsigned int * get_column_numbers () const;
+
/**
* Exception
*/