comparison doc/interpreter/sparse.txi @ 7330:55f35e469c43

[project @ 2007-12-20 17:53:36 by jwe]
author jwe
date Thu, 20 Dec 2007 17:53:36 +0000
parents e8d953d03f6a
children fe332ce262b5
comparison
equal deleted inserted replaced
7329:bf3fb3477d2a 7330:55f35e469c43
533 @result{} 1 0 0 533 @result{} 1 0 0
534 0 1 0 534 0 1 0
535 0 0 1 535 0 0 1
536 @end example 536 @end example
537 537
538 returns a full matrix as can be seen. Additionally all sparse functions 538 returns a full matrix as can be seen.
539 test the amount of memory occupied by the sparse matrix to see if the 539
540 amount of storage used is larger than the amount used by the full 540
541 Additionally, if @code{sparse_auto_mutate} is true, all sparse functions
542 test the amount of memory occupied by the sparse matrix to see if the
543 amount of storage used is larger than the amount used by the full
541 equivalent. Therefore @code{speye (2) * 1} will return a full matrix as 544 equivalent. Therefore @code{speye (2) * 1} will return a full matrix as
542 the memory used is smaller for the full version than the sparse version. 545 the memory used is smaller for the full version than the sparse version.
543 546
544 As all of the mixed operators and functions between full and sparse 547 As all of the mixed operators and functions between full and sparse
545 matrices exist, in general this does not cause any problems. However, 548 matrices exist, in general this does not cause any problems. However,
561 564
562 should return a sparse matrix. To ensure this actually happens, the 565 should return a sparse matrix. To ensure this actually happens, the
563 @dfn{sparse} function, and other functions based on it like @dfn{speye}, 566 @dfn{sparse} function, and other functions based on it like @dfn{speye},
564 always returns a sparse matrix, even if the memory used will be larger 567 always returns a sparse matrix, even if the memory used will be larger
565 than its full representation. 568 than its full representation.
569
570 @DOCSTRING(sparse_auto_mutate)
571
572 Note that the @code{sparse_auto_mutate} option is incompatible with
573 @sc{Matlab}, and so it is off by default.
566 574
567 @node MathConsiderations, , ReturnType, Operators and Functions 575 @node MathConsiderations, , ReturnType, Operators and Functions
568 @subsubsection Mathematical Considerations 576 @subsubsection Mathematical Considerations
569 577
570 The attempt has been made to make sparse matrices behave in exactly the 578 The attempt has been made to make sparse matrices behave in exactly the