diff --git a/gen_doc/Faust_manipulation.mlx b/gen_doc/Faust_manipulation.mlx old mode 100644 new mode 100755 index 5f0814fe64e575e01801d5a698f60d17f987c067..262da1263ac2de3e87cdc8d45be693a54cf7fd46 Binary files a/gen_doc/Faust_manipulation.mlx and b/gen_doc/Faust_manipulation.mlx differ diff --git a/gen_doc/Faust_manipulation.mlx.html b/gen_doc/Faust_manipulation.mlx.html old mode 100644 new mode 100755 index f96c4044d567034956bf8577065101844ed31709..57dc7d31c994e1fca8e061472fc93fd38d1f4e9a --- a/gen_doc/Faust_manipulation.mlx.html +++ b/gen_doc/Faust_manipulation.mlx.html @@ -5,8 +5,8 @@ .S3 { margin: 10px 0px 20px; padding-left: 0px; font-family: Helvetica, Arial, sans-serif; font-size: 14px; } .S4 { margin-left: 56px; line-height: 21px; min-height: 0px; text-align: left; white-space: pre-wrap; } .CodeBlock { background-color: #F7F7F7; margin: 10px 0 10px 0;} -.S5 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 1px solid rgb(233, 233, 233); border-radius: 4px 4px 0px 0px; padding: 6px 45px 4px 13px; line-height: 17.234001159668px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } -.S6 { color: rgb(64, 64, 64); padding: 10px 0px 6px 17px; background: rgb(255, 255, 255) none repeat scroll 0% 0% / auto padding-box border-box; font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; overflow-x: hidden; line-height: 17.234001159668px; } +.S5 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 1px solid rgb(233, 233, 233); border-radius: 4px 4px 0px 0px; padding: 6px 45px 4px 13px; line-height: 17.2339992523193px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } +.S6 { color: rgb(64, 64, 64); padding: 10px 0px 6px 17px; background: rgb(255, 255, 255) none repeat scroll 0% 0% / auto padding-box border-box; font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; overflow-x: hidden; line-height: 17.2339992523193px; } .embeddedOutputsErrorElement {min-height: 18px; max-height: 250px; overflow: auto;} .embeddedOutputsErrorElement.inlineElement {} .embeddedOutputsErrorElement.rightPaneElement {} @@ -26,7 +26,7 @@ .inlineElement .textElement {} .embeddedOutputsTextElement.rightPaneElement,.embeddedOutputsVariableStringElement.rightPaneElement {min-height: 16px;} .rightPaneElement .textElement {padding-top: 2px; padding-left: 9px;} -.S7 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 1px solid rgb(233, 233, 233); border-radius: 0px; padding: 6px 45px 4px 13px; line-height: 17.234001159668px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } +.S7 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 1px solid rgb(233, 233, 233); border-radius: 0px; padding: 6px 45px 4px 13px; line-height: 17.2339992523193px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } .variableValue { width: 100% !important; } .embeddedOutputsMatrixElement,.eoOutputWrapper .matrixElement {min-height: 18px; box-sizing: border-box;} .embeddedOutputsMatrixElement .matrixElement,.eoOutputWrapper .matrixElement,.rtcDataTipElement .matrixElement {position: relative;} @@ -53,74 +53,83 @@ .matrixElement .horizontalEllipsis,.rtcDataTipElement .matrixElement .horizontalEllipsis {display: inline-block; margin-top: 3px; width: 30px; height: 12px; background-repeat: no-repeat; background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAJCAYAAADO1CeCAAAAJUlEQVR42mP4//8/A70xw0i29BUDFPxnAEtTW37wWDqakIa4pQDvOOG89lHX2gAAAABJRU5ErkJggg==");} .matrixElement .verticalEllipsis,.textElement .verticalEllipsis,.rtcDataTipElement .matrixElement .verticalEllipsis,.rtcDataTipElement .textElement .verticalEllipsis {margin-left: 35px; width: 12px; height: 30px; background-repeat: no-repeat; background-image: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAZCAYAAAAIcL+IAAAALklEQVR42mP4//8/AzGYgWyFMECMwv8QddRS+P//KyimlmcGUOFoOI6GI/UVAgDnd8Dd4+NCwgAAAABJRU5ErkJggg==");} .S8 { margin: 10px 10px 9px 4px; padding: 0px; line-height: 21px; min-height: 0px; white-space: pre-wrap; color: rgb(0, 0, 0); font-family: Helvetica, Arial, sans-serif; font-style: normal; font-size: 14px; font-weight: normal; text-align: left; } -.S9 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 0px none rgb(0, 0, 0); border-radius: 4px 4px 0px 0px; padding: 6px 45px 0px 13px; line-height: 17.234001159668px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } -.S10 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 0px none rgb(0, 0, 0); border-bottom: 1px solid rgb(233, 233, 233); border-radius: 0px; padding: 0px 45px 4px 13px; line-height: 17.234001159668px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } -.S11 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 0px none rgb(0, 0, 0); border-bottom: 0px none rgb(0, 0, 0); border-radius: 0px; padding: 0px 45px 0px 13px; line-height: 17.234001159668px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } +.S9 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 0px none rgb(0, 0, 0); border-radius: 4px 4px 0px 0px; padding: 6px 45px 0px 13px; line-height: 17.2339992523193px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } +.S10 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 0px none rgb(0, 0, 0); border-bottom: 1px solid rgb(233, 233, 233); border-radius: 0px; padding: 0px 45px 4px 13px; line-height: 17.2339992523193px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } +.S11 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 0px none rgb(0, 0, 0); border-bottom: 0px none rgb(0, 0, 0); border-radius: 0px; padding: 0px 45px 0px 13px; line-height: 17.2339992523193px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } .S12 { margin: 10px 10px 5px 4px; padding: 0px; line-height: 18px; min-height: 0px; white-space: pre-wrap; color: rgb(60, 60, 60); font-family: Helvetica, Arial, sans-serif; font-style: normal; font-size: 15px; font-weight: bold; text-align: left; } -.S13 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 1px solid rgb(233, 233, 233); border-radius: 4px; padding: 6px 45px 4px 13px; line-height: 17.234001159668px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } -.S14 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 0px none rgb(0, 0, 0); border-radius: 0px; padding: 6px 45px 0px 13px; line-height: 17.234001159668px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } -.S15 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 1px solid rgb(233, 233, 233); border-radius: 0px 0px 4px 4px; padding: 6px 45px 4px 13px; line-height: 17.234001159668px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; }</style></head><body><div class = rtcContent><div class = 'S0'></div><h2 class = 'S1'><span>How to Manipulate a Faust</span></h2><div class = 'S0'><span></span></div><div class = 'S0'><span>This livescript is intended to gently introduce the operations available to manipulate a Faust object. It comes after the first livescript (available </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/Faust_creation.mlx"><span>here</span></a><span> for download or </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/Faust_creation.html"><span>here</span></a><span> as a web page), so it's assumed you already know how to create a Faust object from one way or another.</span></div><div class = 'S0'><span>Keep in mind that a full API doc is available </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/namespacematfaust.html"><span>here</span></a><span> every time you need details. In particular the Faust class is documented </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html"><span>here</span></a><span>.</span></div><div class = 'S0'><span style=' font-weight: bold;'>NOTE</span><span>: the livescript is made to be executed sequentially, otherwise, skipping some cells, you would end up on an import error.</span></div><div class = 'S0'><span></span></div><h3 class = 'S2'><span>Table of Contents:</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>1. Getting Basic Information about a Faust Object</span></div><div class = 'S0'><span>1.1 Obtaining Dimension and Scalar Type Information</span></div><div class = 'S0'><span>1.2 Obtaining Other Faust Specific Information</span></div><div class = 'S0'><span>1.3 Plotting a Faust</span></div><div class = 'S0'><span>1.4 About Sparsity!</span></div><div class = 'S0'><span>2. Faust Algebra and other Operations</span></div><div class = 'S0'><span>2.1 Transpose, conjugate, transconjugate</span></div><div class = 'S0'><span>2.2 Add, Subtract and Multiply</span></div><div class = 'S0'><span>2.3 Faust Multiplication by a Vector or a Matrix</span></div><div class = 'S0'><span>2.4 Faust Norms</span></div><div class = 'S0'><span>2.5 Faust Normalizations</span></div><div class = 'S0'><span>2.6 Faust Concatenation</span></div><div class = 'S0'><span>2.7 Faust Indexing and Slicing</span></div><div class = 'S0'><span></span></div><h3 class = 'S2'><span>1. Getting Basic Information about a Faust Object</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>First of all, given any object, you might ask yourself if it's a Faust or not (typically when you receive an object in a function, matlab being built on dynamic types, you can't say for sure it's a Faust). </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#ac5d5fbe66ef212a1c7043b78504f87fc"><span>Faust.isFaust()</span></a><span> is the function to verify an object is a Faust. Its use is straighforward as you can see in the documentation. Note by the way, that a more accessible alias is available at the package root </span><span style=' font-family: monospace;'>(matfaust.isFaust</span><span>).</span></div><div class = 'S0'><span></span></div><h3 class = 'S2'><span>1.1 Obtaining Dimension and Scalar Type Information</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>Firstly, let's list basic Faust informative methods/attributes you're probably used to for matlab matrices:</span></div><ul class = 'S3'><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a7146c7de95b35efc570a377765edda27"><span>size</span></a><span>,</span></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#af62f554cd8b491a2c75ee06019f87d8a"><span>numel</span></a><span>,</span></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a7527e1fda21bc1678646a4b40db28eb6"><span>isreal</span></a><span>.</span></li></ul><div class = 'S0'><span>To keep it really clear, let's show some examples operated on a random Faust.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F = matfaust.rand(5,10)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="966668C8" data-scroll-top="null" data-scroll-left="null" data-testid="output_0" data-width="926" data-height="104" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">F = </span></div><div>Faust size 5x10, density 3.7, nnz_sum 185, 5 factor(s): -- FACTOR 0 (real) SPARSE, size 5x10, density 0.5, nnz 25 -- FACTOR 1 (real) SPARSE, size 10x6, density 0.666667, nnz 40 -- FACTOR 2 (real) SPARSE, size 6x9, density 0.555556, nnz 30 -- FACTOR 3 (real) SPARSE, size 9x9, density 0.555556, nnz 45 -- FACTOR 4 (real) SPARSE, size 9x10, density 0.5, nnz 45</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>size(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="253C2C58" data-scroll-top="null" data-scroll-left="null" data-testid="output_1" data-width="926" style="width: 956px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 926px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">1×2</span></div><div class="valueContainer" data-layout="{"columnWidth":44,"totalColumns":2,"totalRows":1,"charsPerColumn":6}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 90px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 5 10 -</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>numel(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 50</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>isreal(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="B36889E1" data-scroll-top="null" data-scroll-left="null" data-testid="output_3" data-width="926" data-height="34" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 1 -</div></div></div></div></div></div><div class = 'S8'><span>If the attributes printed out above seem not clear to you, you're probably not a Matlab user. Anyway you'll find all descriptive informations in the FAµST API documentation (see the links above).</span></div><div class = 'S0'><span>As a complement, you can also refer to the Matlab API documentation:</span></div><ul class = 'S3'><li class = 'S4'><a href = "https://www.mathworks.com/help/matlab/ref/size.html"><span>size</span></a></li><li class = 'S4'><a href = "https://www.mathworks.com/help/matlab/ref/numel.html"><span>numel</span></a></li><li class = 'S4'><a href = "https://www.mathworks.com/help/matlab/ref/isreal.html"><span>isreal</span></a></li></ul><div class = 'S0'><span>About size, it's noteworthy that contrary to what Matlab is capable of on an array, you cannot </span><a href = "https://www.mathworks.com/help/matlab/ref/reshape.html"><span>reshape</span></a><span> a Faust.</span></div><h3 class = 'S2'><span></span></h3><h3 class = 'S2'><span>1.2 Obtaining Other Faust Specific Information</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>As you've seen in this livescript and the first one, when you print a Faust object, several pieces of information appear. Most of them are also available independently with specific functions.</span></div><div class = 'S0'><span>For instance, if you want information about factors, nothing is more simple than calling directly the next functions:</span></div><ul class = 'S3'><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a5e77419460592366457aa60175472e2e"><span>numfactors()</span></a><span> ; which gives you the number of factors (aka layers) a Faust object is composed of.</span></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a65a84416b4b1fd050654a02232e95d2f"><span>factors()</span></a><span> ; which allows you to copy any of the Faust's factors givens its index.</span></li></ul><div class = 'S0'><span>Going back to our F object, let's call these functions:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>numfactors(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 5</div></div></div></div><div class = 'S8'><span>For example, try to copy the third factor:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>f3 = factors(F, 3)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="5FE9FC04" data-scroll-top="null" data-scroll-left="null" data-testid="output_5" data-width="926" data-height="440" data-hashorizontaloverflow="false" style="width: 956px; max-height: 451px;"><div class="textElement"><div><span class="variableNameElement">f3 = </span></div><div> (1,1) 0.4445 - (2,1) 0.7386 - (3,1) 0.8996 - (5,1) 0.7525 - (6,1) 0.3492 - (5,2) 0.8700 - (6,2) 0.0345 - (1,3) 0.1148 - (2,3) 0.9154 - (3,3) 0.1409 - (5,3) 0.3150 - (6,3) 0.0677 - (1,4) 0.0300 - (2,4) 0.0864 - (3,4) 0.0184 - (4,4) 0.8315 - (1,5) 0.3195 - (3,5) 0.6342 - (4,5) 0.5401 - (5,5) 0.7264 - (1,6) 0.0206 - (6,6) 0.4736 - (2,7) 0.6442 - (4,7) 0.8710 - (5,7) 0.2015 - (2,8) 0.6851 - (4,8) 0.1751 - (3,9) 0.5870 - (4,9) 0.2351 - (6,9) 0.2876 -</div></div></div></div></div></div><div class = 'S8'><span>Note that, since Faust 2.3, the function doesn't alterate the factor format. If the Faust object contains a sparse factor then you'll receive a sparse matrix.</span></div><div class = 'S0'><span>Since Faust 2.3 again, it's possible to retrieve a sub-sequence of Faust factors.</span></div><div class = 'S0'><span>Go straight to the example, extracting factors from F:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>factors(F, 3:4)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="F02A29A9" data-scroll-top="null" data-scroll-left="null" data-testid="output_6" data-width="926" data-height="62" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 6x9, density 1.38889, nnz_sum 75, 2 factor(s): -- FACTOR 0 (real) SPARSE, size 6x9, density 0.555556, nnz 30 -- FACTOR 1 (real) SPARSE, size 9x9, density 0.555556, nnz 45</div></div></div></div></div></div><div class = 'S8'><span>Hmm... something is different from the previous example. We indeed received a Faust as return type, great! You've just learned another way to create a Faust from another, additionally to what you've seen in the first </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/Faust_manipulation.html"><span>livescript</span></a><span>.</span></div><div class = 'S0'><span>Without this function, you'd surely have written something similar to:</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>import </span><span style="color: rgb(160, 32, 240);">matfaust.Faust</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>Faust({factors(F, 3), factors(F, 4)})</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="5F503923" data-scroll-top="null" data-scroll-left="null" data-testid="output_7" data-width="926" data-height="62" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 6x9, density 1.38889, nnz_sum 75, 2 factor(s): -- FACTOR 0 (real) SPARSE, size 6x9, density 0.555556, nnz 30 -- FACTOR 1 (real) SPARSE, size 9x9, density 0.555556, nnz 45</div></div></div></div></div></div><div class = 'S8'><span>OK, that's not awful but I let you imagine how much complicated it is with more factors.</span></div><div class = 'S0'><span></span></div><h3 class = 'S2'><span>1.3 Plotting a Faust</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>Available soon!</span></div><div class = 'S0'><span></span></div><h3 class = 'S2'><span>1.4 About Sparsity!</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>Three functions of the Faust class are here to evaluate the sparsity of a Faust object.</span></div><div class = 'S0'><span>Let's call the first one:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>nnz_sum(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 185</div></div></div></div><div class = 'S8'><span>I'm sure you guessed exactly what the function returns, if you doubt it, here is the doc: </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a7dc7f3cb86b02b3c2cd725387c34300d"><span>Faust.nnz_sum()</span></a><span>. The smaller </span><span style=' font-family: monospace;'>nnz_sum</span><span>, the sparser the Faust.</span></div><div class = 'S0'><span>Next comes the function: </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#ac33ff53bbff16f93666acec05031511b"><span>Faust.density()</span></a><span>.</span></div><div class = 'S0'><span>This function along with its reciprocal </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#aff3261319b63c49d51a699726edc74bc"><span>Faust.rcg()</span></a><span> can give you a big hint on how much your Faust is potentially optimized both for storage and calculation. The sparser the Faust, the larger the Relative Complexity Gain (RCG)!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>density(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 3.7000</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>rcg(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.2703</div></div></div></div><div class = 'S8'><span>According to its RCG, this Faust doesn't seem to be of any help for optimization but look at the graphic the next script generates:</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>nfactors = 3;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>startd = 0.01;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>endd = 1;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>dim_sz = 1000;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>ntests = 10;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>sizes = zeros(ntests, 1);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>rcs = zeros(ntests, 1);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>densities = linspace(startd, endd, ntests);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(0, 0, 255);">for </span><span>i=1:ntests</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> d = densities(i);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> F = matfaust.rand(dim_sz, dim_sz, </span><span style="color: rgb(160, 32, 240);">'num_factors'</span><span>, nfactors, </span><span style="color: rgb(160, 32, 240);">'density'</span><span>, d, </span><span style="color: rgb(160, 32, 240);">'fac_type'</span><span>, </span><span style="color: rgb(160, 32, 240);">'sparse'</span><span>);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> sizes(i) = nbytes(F);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> rcs(i) = density(F);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(0, 0, 255);">end</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>plot(rcs, sizes)</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>legend(</span><span style="color: rgb(160, 32, 240);">'size'</span><span>)</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>xlabel(</span><span style="color: rgb(160, 32, 240);">'Density'</span><span>)</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>ylabel(</span><span style="color: rgb(160, 32, 240);">'Faust Size (bytes)'</span><span>)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsFigure" uid="234B7E16" data-scroll-top="null" data-scroll-left="null" data-testid="output_11" style="width: 956px;"><div class="figureElement"><div class="figureContainingNode" style="width: 560px; max-width: 100%; display: inline-block;"><div class="GraphicsView" data-dojo-attach-point="graphicsViewNode,backgroundColorNode" id="uniqName_197_0" widgetid="uniqName_197_0" style="width: 100%; height: auto;"><img class="ImageView figureImage" data-dojo-attach-point="imageViewNode" draggable="false" ondragstart="return false;" id="uniqName_197_2" widgetid="uniqName_197_2" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAjAAAAGkCAYAAAAv7h+nAAAgAElEQVR4AezBD3zfBWHn/1c+tW3GY5LMzeiw36yDC2/dco+ctmwk3V1cRaSij8hJogUNYAHB6yM9UkCGtEg7fZyyfrfmwQmbMLxwjxUTTom4Q71bNcwkCC0uDzO3t+F81KRDDP+SutEUbPv79e7BHXOi/G3zTd7PZ3E4IiIiosIURERERFSYgoiIiIgKUxARERFRYQoiIiIiKkxBRERERIUpiIiIiKgwBREREREVpiAiIiKiwhREREREVJiCiIiIiApTEBEREVFhCiIiIiIqTEFEREREhSmIiIiIqDAFERERERWmICIiIqLCFMRR95d/+Zds3bqVrVu3snXrVvbv309EREQ8fwVx1P27f/fvuOSSS+js7GRmZobq6moiIiLi+SuIo+7Vr341r33ta7n99tvp6uqiqqqKiIiIeP4K4pgYHx/nJz/5CfX19URERMQLUxAvm8HBQf7oj/6IZ/vUpz5FR0cH73//+/mbv/kbnnHHHXfwnve8h4iIiHjhCuIlm5mZ4eqrr+ayyy7jqaee4hnf+ta3+Lu/+ztuv/12rr32Wq699lqe8Xd/93e88Y1vJCIiIl64gnhedu3axejoKM/42te+xuTkJEccd9xxnHvuuVx22WU823333ceaNWsoioI3velNPPXUU+zbt48jent7WbRoEREREfHCFcTzsnLlSn74wx8yOjrK1772NV73utdRKpU4YvHixfz2b/829fX1PNvMzAy1tbU841d+5VfYt28fERER8dIUxPN2xhlnsHPnTh577DGampr4RZYsWcKBAwd4xuzsLEuWLCEiIiJemoJ43r7yla+wevVqXvva1zI6Osov8sY3vpH77ruPIx577DGeeOIJfu3Xfo2IiIh4aQrieXnggQf49V//dZqamjjttNN45JFHmJyc5OdZs2YNP/rRj+js7OQDH/gAl19+OUVREBERES9NQXDw4EHWrl2LbZ7LW97yFpqamnjGaaedRqlU4tlaW1u5+uqrecbixYv57Gc/y2c+8xm+/OUvc+aZZxIREREvXUHwn//zf2bfvn0cOnSIV8Iv//Ivs2jRIiIiIuLlUbDAPfDAAzz11FP8m3/zb4iIiIjKULCA/dM//RM333wzXV1d/Dytra1IQhKSkIQkJCEJSUhCEpKQ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kdbWVu6++25OOeUUNm3axBE33ngj7373u/nLv/xLfu/3fo/e3l4CCiIiIhaQvs5GDm9bzeFtqzm8bTWHt63m8LbVHN62msPbVnN422oOb1vN4W2rObxtNYe3rebwttUc3raaw9tWc3jbag5vW83hbas5vG01h7et5vC21RzetprD21ZzeNtqDm9bzeFtqzm8bTWHt63m8LbV9HU28oyuri6+9KUv0dzczMzMDIcPH+YZX/rSl/jHf/xH1q5dyxF/8zd/ww033MCaNWvo6+vjkUceIaAgIiIijqp7772XP/uzP+Oee+7hnnvu4bvf/S5H/OhHP+Kmm27i+uuv5xknnngiH/vYx7j77rvZtm0bb3/72wkoiIiIiKNqyZIlnHXWWaxfv57Fixdz0kknccRtt93Gvn37WLt2LWeffTaPPPIIH/nIR9i2bRsXXHABmzdv5uSTTyagICIiIo6q97znPfzVX/0Vf/qnf8p//+//nerqai644AK++93v8s1vfpM77riDO+64g9e+9rW87nWv46tf/Sq33norAwMD1NTUEFAQERERUWEKIiIiIipMQURExDz2+te/HklIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJPH617+ehaggIiJiHhscHMQ2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9sMDg6yEBVEREREVJiCiIiIiApTEBEREVFhCiIiIiIqTEFEREREhSmIiIiIqDAFERERERWmICIiIqLCFERERERUmIKIiIiIClMQERER81L/6BTff9snmZyeZb4piIiIiHmno3eM7oFxSkOfplRbzXxTEBEREfPGyJ4ZSluGWFazlMnNq1g8O818VBARERHzQvfAOB29Y5TbGii3NTCfFURERERFm5yepblnF3tnDjDctYL2pjrmu4KIiIioWP2jU9RvHaa9qY6+zkZKtdUsBAXz2MGDB7n66qt53/vex/ve9z5s89MuvPBC1q5dy9q1a7n++uuJiIioBJPTs3T0jtE9MM7Epha6W+tZSArmsa9+9assWbKEz3/+85x//vn8yZ/8Cc+2f/9+Dh48yI4dO9ixYwdXXHEFERERc93InhlaenazrGYpk5tXUaqtZqEpmMde//rXc/7553PE8ccfz3HHHcezfe973+OEE05gYGCAwcFBDh06xHORhCQksWHDBiIiIo6F7oFxOnrHKLc1UG5r4Kdt2LABSUhCEvNVwTz2lre8heXLl/OpT32KK6+8knPPPZdne+ihh3jsscdYsmQJX//617nyyit5LraxjW22b99ORETE0TQ5PUtzzy72zhxguGsF7U11/Czbt2/HNraxzXxVMI/t27ePgwcP8tGPfpS77rqLq666ioMHD/KMNWvWcNNNN7FmzRo+/vGP8+1vf5sDBw4QERExl/SPTlG/dZj2pjr6Ohsp1Vaz0BXMY+VymTvvvJMjjjvuOJ5++mkOHTrEwYMHefzxx7n55pvZuXMnR/z4xz/m0KFDLF68mIiIiLlgcnqWjt4xugfGmdjUQndrPfF/FMxjF110Ebfddhvr1q3jnHPOYf369SxevJjvf//7nH766bzzne/kxhtvZP369VxwwQVs2rSJoiiIiIg41kb2zNDSs5tlNUuZ3LyKUm018f8UzGNveMMbuPPOO7nlllv4whe+wHvf+16OaGhoYNeuXZxwwgn09/dzww03cMcdd7B69WoiIiKOte6BcTp6x+jrbKTc1kD8SwURERExJ0xOz1LaMsTemQMMd62geXkN8bMVRERExDFXHpygfusw5bYG+jobKdVWE8+tICIiIo6ZyelZOnrH6B+dYmJTC+1NdcQvVhARERHHRP/oFC09u1lWs5SRrpWUaquJ56cgIiIijrrugXG6B8bp62yk3NZAvDAFERERcdRMTs9S2jLE3pkDDHetoHl5DfHCFURERMRRUR6coH7rMOW2Bvo6GynVVhMvTkFERES8oianZ+noHaN/dIqJTS20N9URL01BREREvGL6R6do6dnNspqljHStpFRbTbx0BREREfGK6B4Yp3tgnL7ORsptDcTLpyAiIiJeVpPTs5S2DLF35gCTm1fRvLyGeHkVRERExMumPDhBS89uym0N9HU2Eq+MgoiIiHjJJqdnae7ZRf/oFMNdK2hvqiNeOQURERHxkvSPTtHSs5v2pjpGulZSqq0mXlkFERER8aJ19I7RPTBOX2cj3a31xNFREBERES/YyJ4ZSluGOGJy8yqal9cQR09BREREvCDlwQk6esco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84Mf/IBvfvObjIyM8Mgjj/CLnHPOORxx8skn88QTT/Bs3/ve9zjhhBMYGBhgcHCQQ4cO8VwkIQlJbNiwgYiIuag8OEFH7xjltgb6OhuJhWfDhg1IQhKSmK8KKsDs7Cy33HILZ5xxBhdeeCE333wzt956K+eddx6///u/z2c+8xn279/PT3vXu95FU1MT+/fv55prrqGzs5Nne+ihh3jsscdYsmQJX//617nyyit5LraxjW22b99ORMRcMjk9S3PPLvpHpxjuWkF7Ux2xMG3fvh3b2MY281XBHPf0009zySWXUF1dzRe/+EX+x//4H3zuc5/jxhtv5HOf+xz/83/+T0qlEhs2bOBHP/oRP+2ee+7hoosuYs2aNZx33nk825o1a7jppptYs2YNH//4x/n2t7/NgQMHiIioJP2jU7T07Ka9qY6RrpWUaquJmO8K5rhXvepV3HrrrZx77rns2bOHc845h0OHDvH+97+ftrY2tmzZwrvf/W7+7M/+jNe+9rU827333svtt9/OZz/7WU477TSecfDgQR5//HFuvvlmdu7cyRE//vGPOXToEIsXLyYiolJ09I7RPTBOX2cj3a31RCwUBXNcVVUVVVVVHNHT08PFF1/M6Ogoxx13HMPDw3znO99h//79HFEUBc/W19fH5OQkF198MR/84Afp7u7miO9///ucfvrpvPOd7+TGG29k/fr1XHDBBWzatImiKIiImOtG9sxQ2jLEEZObV9G8vIaIhaSggjzyyCOceuqp3HfffbztbW+jqqqK448/nieffJKfpVwuc9ddd3Hbbbdx2223US6XOaKhoYFdu3Zxwgkn0N/fzw033MAdd9zB6tWriYiY68qDE3T0jlFua6Cvs5GIhaiggjQ1NXHdddexY8cO3vrWt/KVr3yFRx55hNe85jVERMx3k9OzNPfson90iuGuFbQ31RGxUBVUkMsvv5yTTz6ZT37yk9TX1/PDH/6QG264gaqqKiIi5rP+0SlaenbT3lTHSNdKSrXVRCxkBRXkl37pl/id3/kdvvnNbzI0NMSb3vQmfuM3foOIiPmso3eM7oFx+job6W6tJyKgoILs3LmTTZs2MTU1xYMPPsgDDzzAlVdeSUTEfDSyZ4bSliGW1SxlcvMqmpfXEBH/R0EFuf322+np6eHUU0+lqqqKj3zkIzz00EPMzs4SETGfdA+M09E7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s5m2xhoiIha6LVu2IAlJSGKxKogPxDa2sc0jjzxCLGwDoxM09x5l1YqlHO5aS211FRERi8EjjzyCbWxjm8WqIKLMdA+O0z04Tn9nAz2t9URExMJTEFEmSpPT1N7/HK9PzTDctYam1SuIiIiFqSBYv349O3bsIBavnqFjNPcepae1nv7OBmqrq4iIiIWrIGIRK01O0943xsDoBMNda2hrrCEiIha+gohFamB0gubeo3z+U8s53LWW2uoqIiJicSiIWITa+8boHhynv7OB7vV1RETE4lIQsYgcfm2K2vufY17pnnU0rV5BREQsPgURi0TP0DHa+8boaa2nv7OBiIhYvAoiFrjS5DRNvSMMjE4w3LWGtsYaIiJicSuIWMAGRido7j1KW2MNh7vWUltdRURELH4FEQtUe98Y3YPj9Hc20L2+joiIKB8FEQvM4demqL3/OeaV7llH0+oVREREeSmIWEB6ho7R3jdGT2s9/Z0NREREeSqIWABKk9M09Y4wMDrBcNca2hpriIiI8lUQcZEbGJ2gufcobY01HO5aS211FRERUd4KIi5Spclp2vvG6B4cZ7hrDd3r64iIiJhXEHEROvzaFM29R1m1Yimle9ZRW11FRETEOQURF5nuwXHa+8boaa2np7WeiIiIdyuIuEiUJqdp6h3h9akZhrvW0NZYQ0RExHspiLgIDIxOULd7mLbGGvo7G6itriIiIuL9FER8gkqT07T3jdE9OM6xnc10r68jIiLiFymI+IQcfm2K5t6jrFqxlNI966itriIiIuKDKIj4BHQPjtPeN0ZPaz09rfVERET8MgoiPkalyWmaekd4fWqG4a41tDXWEBER8csqiPiYDIxOULd7mLbGGvo7G6itriIiIuLDKIi4wEqT07T3jdEzdIxjO5vpXl9HRETER1EQcQENjE7Q3HuUVSuWcrhrLbXVVURERHxUBREXSPfgON2D4/R3NtDTWk9ERMT5UhBxnpUmp6m9/zlen5phuGsNTatXEBERcT4VRJxHPUPHqNs9TE9rPf2dDdRWVxEREXG+FUScB6XJadr7xhgYneDYzmbaGmuIiIi4UAoiPqKB0Qmae4+yasVSDnetpba6ioiIiAupIOIj6B4cp3twnP7OBnpa64mIiPg4FER8CKXJaWrvf47Xp2YY7lpD0+oVREREfFwKIn5JPUPHqNs9TE9rPf2d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6NAhtm/fTjm74YYbaGxs5MyZM9x99910dnZS7m644QYaGxs5c+YMd999N52dnbzTG2+8wfHjx6msrOTQoUNs376dcva5z32O1atX8+CDD7J9+3ZuuukmFpOCeE+VlZXMzMxwzvT0NJWVlZSryspKZmZmOGd6eprKykrOaWlp4fHHH6elpYV7772XF198kZmZGSI+qJaWFh5//HFaWlq49957efHFF5mZmaGc/fCHP+T222+npaWFb37zmwT88Ic/5Pbbb6elpYVvfvObvFNLSwuPP/44LS0t3Hvvvbz44ovMzMxQrk6dOsXs7Cx33XUXTz31FH/6p3/K7Owsi0VBvKerrrqKI0eOMO/48eOcPHmSyy+/nHJ11VVXceTIEeYdP36ckydPcvnllzM7O8uJEyfYu3cvBw8eZN7p06eZm5ujoqKCiF9kdnaWEydOsHfvXg4ePMi806dPMzc3R0VFBeXq+eefZ//+/ezZs4cvfelLBDz//PPs37+fPXv28KUvfYlzZmdnOXHiBHv37uXgwYPMO336NHNzc1RUVFCuenp6ePLJJ5m3bNky3n77bebm5lgsCuI9tbS08Oabb9LZ2cnNN9/MnXfeSVEUlKuWlhbefPNNOjs7ufnmm7nzzjspioJXX32VjRs3cv311/PYY49xxx13cOutt7Jz506KoiDiF3n11VfZuHEj119/PY899hh33HEHt956Kzt37qQoCspVf38/pVKJb33rW3zjG9+gu7ubctff30+pVOJb3/oW3/jGN+ju7mbeq6++ysaNG7n++ut57LHHuOOOO7j11lvZuXMnRVFQrm6//XaeeOIJ/vAP/5DNmzdzxx13UFFRwWJREO+poqKCPXv28Oijj/L000+zadMmyllFRQV79uzh0Ucf5emnn2bTpk3Mq6+vZ2RkhJUrVzIwMMADDzzAwMAAGzZsIH5m/fr17Nixg/iZ9evXs2PHDs6pr69nZGSElStXMjAwwAMPPMDAwAAbNmygnPX09PDUU0/xxBNP8MQTT9DT00O56+np4amnnuKJJ57giSeeoKenh3n19fWMjIywcuVKBgYGeOCBBxgYGGDDhg2Us9/6rd/iySef5K/+6q8YGBjga1/7GotJQfxcl156KZdccgnxM5deeimXXHIJ72f58uUsWbKEiA9r+fLlLFmyhIgPa/ny5SxZsoT4meXLl3PJJZew2BRERERELDAFEREREQtMQURERMQCUxARERGxwBRERERELDAFEREf0o9//GOuvvpqvvCFL7Bhwwauu+46/uIv/oJTp05xvoyMjPDtb3+beX/9139NRMS8goiIj+DXfu3XOHToEAcPHuR73/seS5Ys4U/+5E84Xz7zmc+we/du5vX19RERMa8gIuI8Wbp0Kdu3b2dsbIwf//jHDAwMcMMNN7Bp0yb27t3LvBdeeIEHHniAb3/721x77bXcdtttzMzM8D//8z90dnayceNGvvzlL/ODH/yAea+88gq9vb3ceOONvPXWW2zcuJH//M//5M477+TIkSOc82d/9meMjo4SEeWhICLiPPqVX/kVrrzySmzzz//8zwwMDPBP//RPDA0N8fzzz3PmzBmefPJJdu7cyfe//31++tOf8oMf/IAnn3wSSTz77LP09vbS39/PvJmZGf77v/+b/fv3c+mll/Lss8/ym7/5mzQ1NfHkk08y76233mJkZITPfOYzRER5KIiIOM/efvttRkZGuPTSS/n7v/97/u7v/o5LL72UgwcPMu/zn/88K1eu5JJLLqGxsZETJ06wZs0a/vVf/5U///M/p1Qq8Z3vfIefp6WlheHhYd5++20OHjxIS0sLRVEQEeWhICLiPPrf//1f/uM//oPly5dTXV1NTU0NNTU1/O7v/i7XXXcd85YuXcq7ffazn+V73/sev/3bv813v/tdvvKVr/DTn/6U97Ns2TLWrVvHv//7v3PgwAF+//d/n4goHwUREefJW2+9xa5du9iwYQMNDQ2cPn2ar3zlK3z1q1+lVCoxMzPD+9m7dy/PP/88X/3qV3n00Uc5efIkJ06c4J2WLFnC3Nwc5/zBH/wB/f39nD59miuvvJKIKB8FEREfwYkTJ/jCF77AF7/4RTo6OviN3/gNdu/ezbXXXsuqVav4vd/7PTZv3kypVKKpqYn388UvfpFHH32UW265ha997Wtcd9111NTU8E6f+9zn+PKXv8x//dd/Me+zn/0sx44dY9OmTUREeSmIiPiQPvWpT/Hyyy9z6NAhvv/97/PUU0+xbds2li5dyry7776bf/mXf+Fv//Zvefjhh1myZAnXXnstDz30EOds3bqVjo4OrrzySp5++mn+8i//kn/4h3/g3nvvZd7atWt57LHHmPf444/z7LPPcsUVVzBvbm6Ooii4/vrriYjyUhARcQFVVFRQVVXFB7FkyRJ+/dd/nV/91V/lF3nxxRf5oz/6I37nd36H5cuXExHlpSAiYgG68sor+eM//mO2bdtGRJSfgoiIBai6uprGxkaWLFlCRJSfgoiIiIgFpiAiIiJigSmIiIiIWGAKIiIiIhaYgoiIiIgFpiAiIiJigSmIiIiIWGAKIiIiIhaYgoiIiIgFpiAiIiJigSmIiIiIWGAKIiIiIhaYgoiIiIgF5v8A4tt04blIwEIAAAAASUVORK5CYII=" style="width: 100%; height: auto;"></div></div></div></div></div></div></div><div class = 'S8'><span>Isn't it obvious now that the smaller the density the better?! Indeed, for two Faust objects of the same shape and the same number of factors, a smaller density (linearly) implies a smaller file size for storage. This point applies also to the memory (RAM) space to work on a Faust.</span></div><div class = 'S0'><span>We'll see later how the computation can benefit of a bigger RCG (or smaller density). But let's point out right now that the sparsity is often a tradeoff with accuracy, as the following plot shows about the truncated SVD of a matrix </span><span style="vertical-align:-5px"><img src="data:image/png;base64,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" width="85" height="19" /></span><span>. Note beforehand that the SVD of M (truncated or not) can be seen as a Faust which approximates M.</span></div><div class = 'S0'><span></span></div><div class = 'S0'><img src = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAoAAAAHgCAYAAAA10dzkAABILUlEQVR42u2dCXgV5dm/i2EVBFGw4EJitUDUfgha1KpBXEDcxX5qtUi1oqBAUKriUsF+4FpF60e1Iu4iVYl1LWpVoLJpBVzKvi/ijp8bi+Lz7+9t3/znTGbOkgRykrnv65oryck5c2Z55n3uebf5gQEAAABAovgBhwAAAAAAAQQAAAAABBAAAAAAEEAAAAAAQAABAAAAAAEEAAAAAAQQAAAAABBAAAAAAEAAAQAAAAABBAAAAAAEEAAAAAAQQAAAAABAAAEAAAAAAQQAAABAAO+//377wQ9+UL4UFBRYmzZt7IwzzrBFixZV+guGDx/u1lcZnn/+eff5KAoLC61v377b/IB169Yt5TgFF21TUgnHT6NGjeyHP/yhHXHEEXb99dfbhx9+mD9B/6/tC8bVP//5T/f38uXLa2ybJkyYYPvss481btzYbd+cOXMiYz4u9oKLzkVt54477rCHH3642te7YcMGd4xuuOGGjO9VPFxwwQW29957u/PSsmVL+8lPfuJee//99917iouLbc8997Tvv/8+dj1dunSxtm3b2nfffWfz589POVf169e3nXfe2bp27WqXXnqp+3918te//tU6d+5s22+/vfs+/V3bOOigg6xnz55k6yx58MEH7c4778zpMz4uH3vssWqLOx/jces85JBD3P87dOiQ9XoPPfRQKy0trbDdUctTTz2V8tnXXnvNzjvvPHc9NGzY0L1n3bp1Fb5j3rx5NmTIENt///2tefPm7vo87LDDKqwvF6644orIbWzRokWF995888128sknW7t27dx74mL/z3/+s51++umu/FH5VFRUZH369LGlS5emvG/jxo22++6721133ZVZAPVzxowZ7mCNHDnSmjRpYrvssot99tln21wAL7744tjPzp4925YsWVIjAvijH/3IHaPwom1KugD6+Jk6dao9+eST7kJSkO+000728ssv58W2avtWr15d/vcTTzzhtl0xXxN89NFH1qBBAzvxxBNt8uTJbvu+/vrryJgPxtuvf/1rt92TJk1KeV3rq+3stddeWyXpZyuAy5Ytc8LXsWNH+9Of/mSvvvqqlZWV2f/8z/84CdRxFrfccotb3yuvvBK5nrffftv9f9iwYSkJa+jQoW4d06ZNs2effdauu+46J/iKA8lvdbB582bbYYcd7PDDD3fbr+/7/PPPEcA6zlFHHZWTVPnrQvHxySefVKsAKv6OPvroWOGUYGW7rbpJ1o3MBx98UGE9/noKLmFn0TUoWTr11FPdNREngLqm9913X1dGKGepIuoXv/iFe/9NN91UJQH016Ff3nzzzQrvlcgdcMABdv7557u8GRf7nTp1cvvywAMPuLwh8f/xj3/s8m240u7uu++21q1bV7j+KwhgeINUMOn1++67L68EsKaQACo4KsM333wTW1MQlfBzpTrWUVUBjArolStX2h577OEKg+DFmy/UtAC+/vrr7vt1R1eZa+vjjz/O6v2qgdq0aRMCmIUAXn755VavXj1bu3Zt5P+3bNnifqpmW9J29tlnR75PtRX6Pl8g+4QVVUPz1Vdf2ZFHHum+N04oc0E3yPqu6hLKmipjEMCtJ4Bbq0zwAiiJ2W677WzFihUp///Nb37jKlIU79luq4TnV7/6VaRIZlPj6a9ZoRu5OAHUDXRUntZxlbDqmFVWAL/88suctjNdORjVqqbjrOMtdwq7h7b91ltvzU0AZb9xBaaM/OCDD3ZW3rRpU+vRo0eFWrAoAdTnjjnmGNfErKpL3WXrAKkA9Kh5N6rK1DfTBZuAfQ3KNddcE3unESwEddLVjLPbbru5z8m4R4wYYd9++221CaA/ni+++KKde+651qpVK/e3EpA/Jm+99ZaddtpptuOOO7pj4Xn66afdcVXta7Nmzdwd1PTp0yOPa9w6gsydO9e99957763wvxdeeMH9T9/pj2W/fv1clbGqybXdP/vZzzLW3qUTQPH444+7/+uGIojer5ov1bao2VjV7mER8uvW3VP//v1dlbzujHT3E07QSpw6R/q/Ykvi2bt375TEFWwCDjddB5tRf/e737muEKtWraqwPzqn+g6dz3RkOpdRca7tr6oA+rgfPXq0e5+uFxUMklw1BUQVfr7Q9rVbPvnqblTbrCYb7YcKpd///vcVCslPP/3UCY+uJ8WOWg6OP/74lJr6q6++2g488EB3vlUgad26cw2irgPhYxJMEuvXr3c1y77GTLGqGgAVckFUA6DzpGtD5ZO2Rc392Qigale1D9kkR8Whjkv47lo1cLp+VNuQbcJS+aaY69WrV/lrShr+uOoaUdz99Kc/dTXsmRJO3DFUHKh7ho6Lym81camsCuLjRNfdOeec4667dDfkKr91XlRDqps9bafKjueeey6reFY8qdVJ51P7qdhQuRMlgNnEgJd9vT5u3Dhr3769O09qAgzvq64FxYpygi/3dExUsxIuL3V96lrWunRup0yZkrUQ6WbzkksucdeGjv0pp5zirl/tjy9T9N0qg8OyrWtZTaD6vz77X//1Xy6hB/OWjlX4vOtYZioTwk3A+m51SVFuDkqLWk70/cr1QVGJ2181m+p6Vn71aHv1miQsW1lVTXlUTXsuAhgknQDGceWVV7rP+JpFfVb7oXgISqG67yj3SH4rI4BVvRFWd5OTTjopMmfpGshJAP/3f//XvT5x4sSU10eNGuXuVNWmrgtczSNKEApMFbLpBFAHX0EoudQFpupJVc1279495e715z//eXlC8ovas8MC6AthJftwUOpOXhe0r9rWSdP79Hk17fztb39z26OLJHx3kU4AFcThJfjd/niqQJFs6oJQga1A8cdE26DAUCH3l7/8xX3u0Ucfdf/TBabXJEMqCLUPf//73ysc16h1RKFCT4VHGPUhUGHkCxEFm6qK77nnHndutM5rr73WSXtVBFDJQYlNF7xHiUX7pUJU+6mmTJ2DcD82v27dMQ4aNMgV3pJZSUQwZpQ8deHp5kLbre3X8VS/CBWwUQIo4VUfRb02ZsyYlGZU3WEpLiQtYdFR4X/ZZZelPSbZnEvFub5X79N26LuD109VBVDxp+Oh61fHTQV4rgKo+FDBMXbsWBdnKtjCNZY6vnqPEr/KhpdeesnF+8CBA10Np+eXv/ylO5+67vQeJQYd42DTim5qlNAlzv586CZGfPHFF+76U8GrmzqtR0lQ33vsscem1GxIPhQPWre+S+dR5Uw2Aqj40vskjfpsuoJb5Z/eq3IsiI65XlcTTS4JSzdBKkeDNwnaP+2vYlpNxjrG4e8LopsWXbPB5jF/DLU/uhZ1fCUkKrt1HUkGgv2cfJzoXKhGQdenbuTi0DWjfPDII4+4a1vxJElTnsimdtsnyQsvvNB9l75/1113dfEXTILZxoAXQJ1z5SbFo3KOykHFXPDGTuW6EqfOu4RO16viRccmGBPal//+7/92/3/mmWfc90lAg2VzOiFSeS2507Wo3KpyROvQ96uJUteXzq3ORbh8Udmnc65jIxHSTZjKwAEDBpS/57333nM3B/oef+3MmjUrY5kQ1QdQ5ZBuDs4666xycdOx0znJ1M3E769iVfuhmxd/w6gY0/7pe7MVwKuuusqVm+Ebbr/dklKdBx3PkpISJ+rVLYC6XnTsgje+Og/aF8mhj001w+omKHgz4mNblTR6v2JXuW7NmjXVKoDqv6gY9dsTRDfawdaISAGcOXOmO9Eq8BRo2mAd0OBdhi4cdV5WQAbRZ/R+SUW2TcA6mFq3Ljq9T31msmkCDgugLka9V4VbMAkoWFVD5lHhors3NUsG0cWkz2dKvukGgajWIHw8deccl7glVuGqX22vgicokzquKgSV0DKtI44//OEP7v0LFy5MqSFRQagE4dGxUaFdnU3AwZoddZr36O5SYhqueT3hhBNcYeyPgV/3RRddlPI+dZYNXsQq4PW3T3RxhAeBpGsCVozp2AdrgiQUuojTDRrJ5Vzqe33tQHU1AfuCUcc73GSRqwCqQAkeU12zGhihjsrBAlqfVd/PbNFx0bnXZ3W+syn4tM8qe4LlhJB0+Noqn2T0t27ygvz2t7/NSgC1bbpj1r7r/fop6dC1Eq4R1vFVYtBAjiCSR0lJsCYnGwHUcdV7/u///s/9rWN95pln5nxNxn2XBFPbG0xQOg8SeB33cJzoBrYy6LhovWoel4Clw7fiqK9VuEY/3BE+2xjwAiiBDZ4DnT9fE+bjWd/t+2lGoXOhGmvJXxDtn8ox5chshCj8ebVo6HVVVASRFKr8yHTt6EZd2x5sPYuTqnRlQtwgEC8NEk9to24cwrWimQTQr1uiLtTi40U9WwHUDYriNqrJUzldZb8kXDGgFgZ9X7pBZLkKoK6hqPJEqFVL5YOkU4NmlUMXLFiQ8h7VQKvM0XFRTEvy1TKh6zBdt6hcBFA5SteZbgqi9uvdd9+tULkSOwrYLwqWYO2JUE2AT/bhWjAdACW4dAKoUSq60CUEvoD1S7CmKRcB1HdLPoMFiG++1k+PDrgCMLzdvmnoj3/8Y0YB1EnRvoeXYD8Hfzx902pU4g4XYLJ3vS6xCaO7PEmHL8ji1hGHaq0ke8E7A1/zpLtGj/pkKDB1gUgE1IxVXQKouPACuHjxYvd+iXf4XOgc6H86HsF164YkiP72Ny2+Nk13iUrEqnUJj4aqjACqS4P+p4LFF7y6m1UMZboTy/Zcbk0BjLoTzFUAtb9h1HQVLJAl8mqSyoTOmQpziVG4rAk2ocYVfKpB1fkNx4ziO3hDNHjw4MgmF39cshkFLDQYRDU1ultXDbQ+qwI+3CXDC7C/lnRslSxV25Nrk5Wab4ICqBoY1WzoO3SjnKnbQbrv0k2fXtOI46hEFuxm4+Mk3FyaqdbbdwsKnluVKelQTZveF9VcrDwRjIVsY8ALYFTLjrYneKOrGzI1v6oW3leCBJHI+O0Lf6+a5yWk6cpKf22FuzuoBlOvh5uR1Uys3Bhc5xtvvOFuKpTgw9dO8AYtkwBGlQnpRgHrRkjlqrZHTfTZEBRAITFRHGv0vI6Vr0nOVgD1HrWkZINaCXWzJh+I63OfiwCqtlfbHNfPVzlBXXv8DA4+V2RCwqpjGpb/ygighF7upe2Mq/1Ui5a2L3gOKwjgQw895JK47qJk1notWK0utIJ001AoucUJoApk3dmoMJVIKvD1fb4ACNppLgIoVNWsk+CFVXdbfvoFjw5Qum1Xv69smoCzFSJdtHGJO1yNroCIu3PxAeurjOPWkQ4dDwmwPx5qKgjXWkgmVKD5KUeU7NSEmulCybUJ2A98SLf42qS4dXtxCoqbPqMaRDWh+Wbj22+/vdICKNRE7WswJPTZJMVczuXWFEDV/FZVAJVww6iwCRbcqmU57rjj0m6vzo3KBhVoSgCSKJ1TXbfh7Ykr+PQ96WLG1xKrsFbshlHZkIsAhtH5VKEd7Nfnbz70uq9NVy1x8OYkFwFUZ/fgtqtZSfKnpiV9VjKoVg3Jaa4C6G+8NNIxjL+x/8c//pESJ++8807W8qf3K9ErafpRjjoXvh9aHOHvDh+PYCxkGwPBPoBRUqn8FkyO6q6g7kF+dKrEx5evvktAuiVdWRwWovC1qNqZqOZwfwOj+NJ5V3ktwVD5qWN72223VbhmMwlgVJmQTgB9WSapD1cGZbu/On7Kzdov9SX1LSrZCqCmRInq1xaHupbo++OukWwFUC2Lkl91MUs3RkDlgtan7cxmLIFHN9fpao+zEUDlc11jyq/pulrohlLbGOzSlLEPoO/vE0xOqg7Wa6p2jaoJC64jLIA+gYarkdX3oaoC6GtddFH55k0FXBDdFehOIm6740b9VVYAo4QoLnFXpgYw2xGgwg/40MXpazyj5gbyqJlcyUMylSkIMwmgAlP/14UnVEXu70bjzoUSX64CGLwolHx1YYQLtlwF0P9ffdPUd0ZNZenmfcunGsAo0fDHMzwyzxdilRHAbGoAtd+q+QvXlChBZyuAqnXU9sTFjO/aUV01gFGoyU+1MGE0qEK13No/vSeqnMgkgEpYig3V9EShY6Rkqj5PEqOtUQPo4yJOTuLQwBXtdxjJaiYBzKUGMNsYyEUAg6gGVM3DEi7fzUFC65sA4743XeKvqgD6G4qwsPimyVwEMCr24gRQ0qBrUS03uikJN2Fnu7/aD+URxXZwHr9sBVBzaWpQTq5lY7iMy0UAvfyptSdd7a66FKj2WNsoCcvUNzzsMSo3KiuAqn1UjtNxzVTzqLgOdn3ISgBVYKiwUwD4vkxakWrSspkTJyyAvq9eMGCFH/ARFEAVUnotPLovTgB9wtJdkh+8Em6Ll9CqBrKy8xpuTQHU8VUNnQq4oGCo9kyJJTiIozIC6PsqqY+mhuHrjiybecHU3KeBIZXdXz8NjOYnCt4lq0YjU61RZQXQo/3Te4IXZVgAfUzGVZ3ruOnOTheqannCNYpxF2a253JbC6D/Pu13uIa4sgLom0CDAz7CqGZGBWWwRl6JQbX04cJYIxCj7ow10l+1M8F5HKOoah9AP9Fz1F20vj+qDPACrSYd/QxPuZDpvASngcnUz0p9x/S+dFNSxH2XZF3Xox9Q52Nc5zOqD2C2AqhrOSylSo4SqUwC6KfTyaYPYLYxUFkB9KjlS8fJ1xxLgNQ0WxmqKoC6kdT5DuYtnTMd7/A1q/Og8qo6BFB5WTdt6jvu+1hm6iYVt7833nijE+pgP/tsBVC1yuF+wunOu8oP5fnKNgFruyV/OpbpZgKQ9Kt1SGW9ymG1juo8BbudxeHHPaTre5pOAJVjNKhO8hfuWhCFv5aCrVcZBdAHX7g5S30lJIG6iFTYqsBSLY8utuDAhLAAajSuhFKBq7s+HWh1cPbNG1GjP7UO1eZo2/zJiBNAFfi+42+wo32wYNdndaeqQNZB0clSfzjddWcqVNJNBB28CCsjgMFmFAWeakvVVKam2rhRwLkIoFCNmwpjCZ0f3RWUJSUHNQ/pvOic6neJYvi9cZLmJ4LWtmqUWXAiaN8526O/tS2qkR0/fry7IBRLii0VPLkKoApTSYz6/2ndEjp/Y5ES9CEBVK2LXpPoarv1PeEJUf0duO5is51MN9tzua0FUHezGhmpRdesjpOau/wI2coIoB8FrMTsJ1BVrYnu9jWFQ7AGWrGk/+ucqxzw136wMNb61eSkY6Lz4fvWScD2228/dw3rTlbrUb9CdYbXdD/+CSpKjn76HZVfGhwmcch2FLAGdOmOXudd69e1oI7c2l4V8Dq3YXSjqr5l+r9kJqpJMGoiaJU/6nqi5iB9TjevYWFTYlEM6RpRWaXvkSzmWgMo/Chg1ajoGtU1p3XFjQLOVgB9312dc5WrOl46Tzq/mQRQ6KZUn5fc6npVS1PUKOBsYyBbAVQnfA0ckLCrBlLXo+JD16lGNXtU86pjpKSr1i+dC8WnmtRU47w1BVB9vZVv1QLhZ5TQDam/doLXrD6rGFSzukYAq+WiMgLoaxd1nQYrUHQuo55UlM3+hslWAHVutb7w4E21EireNHZA500ipOtF+x+WWZ1nnS8tcg6tT8dIfwfLY8Wu9lGDr/zE/MEl2Kqg2NJ58Z+XcCqfqZnbu4TiUNuk/u6KL11/ut5VVkrUw+WEXMdvp1osVYng/w76iW+d1fUS3saogZAaeBIeMJSVAGoHtKEKtuAdpwp4dejWjuiA6YJUwvWjfaIEUPg5xVTAS0S0I76zfVAAJXv6n97jB4tEzQMYvkNXoe9PbhRKmLpglQx0QCQnSnK6kIMHJ04A0/UD8c0AlRVAf1yVeCVeEg5dJD6JVlUANQTcb2t4bj/VCCiY1JSnc6rjqItT35VpAtjwICI/D5yOl4Qurn+MCjY/FY3OhQJeySg4xUW2AqjAV18NxYbiURehvj9c0xUWQKFaPcWDEmPU49TUlOAvtlzI5lxuawH0TdTaFt3d69irtt3XmlVGAP3NnfpR6eZL51JJVv12goNxdF69EOjuVjcYXhyCAqg+T9o+1bqE57BT1wDdyEg4FWe6wVDMqjAOHgsNClAZof/r2KtGRyKZjQDqHKnJWqO4dcOqQt7PaxicaSCqmVvrl4ikk7LgIze1fgmItj/cYuFbQiSjkj7FkY6bZClTK0a6GNANkq4NlcG6zlUjHR5klasAKvkpsfnrT7WkuhmTkGQjgKrR0Of9XHx+vr6oeQCziYFsBVBlvkY6Syp1PeiYqMVLtUThATeSA8WRzpm+V7GuJsJMjwmrqgD6ZnLFo2JA36v9912qgtes9l/loI5J1DyA2QigpFGfC9eS6iZH26Br2HfR2RYC6KfeCvdfVHmim2p/jSqXqytCuLIhuE1RSzC+4h7b5hd/rLVv8pJwWaLabNVW6gbLDxRSjtN1q9hS2ahco7IyajJnla1x3x2U2qj5UqPm/PToOIWb8PPrMRsAeYqfRic4YhoAALYNqgzSTQHkjr/xDY82RwAB0qCaaTWTqdN9cN47AADYdmjWBNXkZ6pVhIqoyVuzY4RBAAHS4JuzNM9TLrPGAwBA9aKm9mCfRMiMunZphH/UvLgIIAAAAEDCQAABAAAAEEAAAAAAQAABAAAAAAGEeDSflSZs1ITBmpeQhYWFhYWFJfdFeVT51D+JDBDAvEbBmunB4SwsLCwsLCzZLZme0gUIYF7gnz+rgOUOjoWFhYWFpXKLr1DJ9hGcgADWKApaBax+AgAAAPkUASRgAQAAgHyKABKwAAAAQD5FAAlYAAAA8in5FAEkYAEAAMingAASsAAAAORTQAAJWAAAAPIpIIAELAAAAPkUEEACFgAAgHyKAAIBCwAAQD5FAIGABQAAIJ8igLWUMWPGWFFRkTVq1Mi6dOliU6dOjX3v/fffH/kg6g0bNhCwAAAACCACWBuYMGGCNWjQwMaOHWvz5s2z0tJSa9q0qa1cuTJWAJs3b27r1q1LWQhYAAAABBABrCV07drV+vfvn/Jax44dbdiwYbEC2KJFCwIWAAAAAUQAayObNm2ygoICKysrS3l98ODBVlJSEiuA+ky7du1st912s+OPP95mz55NwAIAACCACGBtYO3atS5wpk2blvL6qFGjrH379pGfmTFjhj388MM2d+5c11fwtNNOsyZNmtiiRYtiv2fjxo0uOP2yevVqAhYAAAABRABrUgCnT5+e8vrIkSOtQ4cOWa1jy5Yt1qlTJxs0aFDse4YPHx45cKS6A/bhGSvsZze84n4CAAAggIAARlCZJuAozj//fDv22GNj/7+tagAlf4VXPGc/GvYcEggAAAggIIBxaBDIgAEDUl4rLi6OHQQS5vvvv7cDDzzQzj333BoPWEmf5E8SKBkEAABAAAEBjMBPAzNu3Dg3DcyQIUPcNDArVvy7Bq1Pnz4pMjhixAibNGmSLV261ObMmePEr379+jZr1qy8CFhJYKcRL7qFWkAAAEAAAQGMQRNBFxYWWsOGDd1E0FOmTCn/X7du3axv377lf0sQNQJY723durX16NGjQh/Cmg5YmoIBAAABBAQwYQEbbApGAgEAgHwKCGBCAlbSV3TFvyVQzcEAAADkU0AAExCwEj8EEAAAyKeAACYoYBkQAgAA5FNAABMYsAwIAQAA8ikggAkLWAaEAAAA+RQQwAQGLBIIAADkU0AAExiwPCUEAADIp4AAJjBgGRQCAADkU0AAExiwTA0DAADkU0AAEyqAmiSaWkAAACCfAgKYgIBlQAgAAJBPAQFMYMAyIAQAAMingAAmMGAZEAIAAORTQAATGLA8JQQAAMingAAmLGDpDwgAAORTQAATGLCSPo0IZmoYAAAgnwICmKCAZWoYAAAgnwICmLCAZVQwAACQTwEBTGDAMioYAADIp4AAJjBgGRUMAADkU0AAExawjAoGAADyKSCACQxYJBAAAMingAAmMGCZGgYAAMinCCAkMGD91DAIIAAAkE8RQEhIwDIqGAAAyKcIICQwYBkVDAAA5FMEEBIWsAwIAQAA8ikCCAkMWCQQAADIpwggJDBgkUAAACCfIoCQwIBlahgAACCfIoCQwID1U8NIBKkFBAAA8ikCCAkI2GBTsEYIAwAAkE8RQEhAwDI/IAAAkE8RQEhgwDI/IAAAkE8RQEhYwDIqGAAAyKcIICQwYJFAAAAgnyKAkMCAZWoYAAAgnyKAkMCAZWoYAAAgnyKAkLCApSkYAADIpwggJDBgmR8QAADIpwggJDBgmR8QAADIpwggJDBgmR8QAADIpwggJCxg6Q8IAADkUwQQEhiwTA0DAADkUwQQEhiwTA0DAADkUwQQEhawNAUDAAD5FAGEBAYsEggAAORTBBASGLBIIAAAkE8RQEhgwCKBAABAPkUAIYEBy8hgAAAgnyKABGwCA5aRwQAAQD5FAAnYhAUszwsGAADyKQJIwCYwYHleMAAAkE8RQAI2gQHL84IBAIB8igASsAmDUcEAAEA+RQAJ2ASCBAIAAPkUASRgEyqBTA0DAADkUwSQgE0YTA0DAADkUwSQgE0YNAUDAAD5FAGsMcaMGWNFRUXWqFEj69Kli02dOjWrzz322GMu8E4++WQCFgkEAAAEEAGsLUyYMMEaNGhgY8eOtXnz5llpaak1bdrUVq5cmfZzK1assN12280OP/xwBBAJBAAABBABrE107drV+vfvn/Jax44dbdiwYbGf+e677+zQQw+1e++91/r27YsAIoEAAIAAIoC1hU2bNllBQYGVlZWlvD548GArKSmJ/dy1115rp5xyivsdAaxeCWRkMAAAkE8RwK3K2rVrXeBMmzYt5fVRo0ZZ+/btIz/z+uuvu6bfjz/+OGsB3LhxowtOv6xevZqAjYGRwQAAgAAigNtEAKdPn57y+siRI61Dhw4V3v/FF1+4wSIvvPBC+WvZCODw4cPd94QXArYiNAUDAAACiABuVXJtAp4zZ44LNH3GL/Xq1XOLfl+yZEnk91ADiAQCAAACiADmERoEMmDAgJTXiouLIweBbNiwwd59992URbV/Rx55pPtdQknAIoEAAIAAIoB5jp8GZty4cW4amCFDhrhpYDTNi+jTp0/aEcEMAkECAQAAAUQAayGaCLqwsNAaNmzoJoKeMmVK+f+6devmJA8BrDkJZGQwAACQTxFAAjZhMDIYAADIpwggAZswaAoGAADyKQJIwCKBSCAAAJBPEUACNmkS+LMbXuGAAACQT8mnCCABmxQJVJ9ALdQCAgCQT8mnCCABmxBU+0dTMAAAkE8RQAI2QTA1DAAAkE8RQAI2gTA1DAAAkE8RQAI2YTAqGAAAyKcIIAGLBCKBAADkU0AACVgkEAAAyKeAABKwSCAAAJBPAQEkYOuOBDIyGACAfAoIIAGbMBgZDABAPgUEkIBNGDQFAwCQTwEBJGCRQCQQAIB8CgggAYsEAgAA+RQQQAIWCQQAAPIpIIAEbN2RQD8ymIEhAADkU0AACdiE4EcGUxMIAEA+BQSQgE0IEj5JYBESCABAPgUEkIBNngjSJxAAgHwKCCABiwRyUAAAyKeAABKwSZBAHhkHAEA+BQSQgE0YPDIOAIB8CgggAZswaAoGACCfAgJIwCKBSCAAAPkUEEACFgkEAADyKQIIBGydlUAGhQAAkE8BASRgEwaDQgAAyKeAABKwCYOmYAAA8ikggAQsEogEAgCQTxFAIGCRQAAAIJ8igEDAIoEAAEA+RQCBgK07EsjIYAAA8ikCCARswmBkMAAA+RQBBAI2YdAUDABAPkUAgYBFApFAAADyKQIIBCwSCAAA5FMEEAhYJBAAAMinCCAQsHVHAhkZDABAPkUAgYBNGIwMBgAgnyKAQMAmjGBTcNF/agIRQQAA8ikCCARsgiSQPoEAAORTBBAI2ARJoGr/ipBAAADyKQIIBGzyRJCBIQAA5FMEEAjYhMHAEAAA8ikCCARswmCOQAAA8ikCCAQsEogEAgCQTxFAIGCRQAAAIJ8igAQsAYsEAgAA+RQBJGCh7kggI4MBAMinCCAQsAmDkcEAAORTBLCa2bx5sx1xxBG2cOFCAhbyEh4ZBwBAPkUAtwKtWrWyRYsWEbBQKySQPoEAAORTBLAauPTSS+2KK64gYCHvJZBHxgEAkE8RwGpi4MCB1rx5c+vSpYtdcMEFdskll6QsBCzkmwgyMAQAgHyKAFYR9QGMW7p3707AQt7BwBAAAPIpAkjAErAJgzkCAQDIpwhgNbJ69Wpbs2YNAQtIIAAAAgh1WQC3bNli1113nesHuN1227mlRYsW9rvf/c79L1fGjBljRUVF1qhRI9evcOrUqbHvnThxoh1wwAHu+7bffnvr1KmTPfTQQwQsIIEAAAggArg1GTZsmLVu3dr++Mc/2ttvv21z5851EqfXrrrqqpzWNWHCBGvQoIGNHTvW5s2bZ6Wlpda0aVNbuXJl5Ptfe+01Kysrc+9dsmSJ3X777VZQUGCTJk0iYCFnCdQyaPxsDgoAAAKIAGaibdu29vTTT1d4/S9/+YvtuuuuOa2ra9eu1r9//5TXOnbs6CQzWzp37mzXXHMNAQs5SaAXwEIGhgAAIIAIYGbUVBv1JJAFCxZY48aNs17Ppk2bXO2davSCDB482EpKSjJ+/vvvv7e//e1vrin4pZdeImAhJ1Tzx0TRAAAIIAKYJaq1GzRoUIXXNT/gQQcdlPV61q5d6wJn2rRpKa+PGjXK2rdvH/u5zz//3DUT169f38nouHHj0n7Pxo0bXXD6RQNXCFgQ9AkEAEAAEcAsmTx5shOw4uJiO++88+zXv/61+71Zs2ZpB3DECeD06dNTXh85cqR16NAh9nMaaLJ48WKbM2eO/f73v3cDQtQ3MI7hw4e77wkvBCwggQAACCACmAOSNw346N27t5166ql29dVXu9dyoapNwB4JaI8ePWL/Tw0gIIEAAAggAlgFvv32WxsxYoStWrWqWtan5uQBAwakvKbaxFwGgagWslu3bgQsVFkCeWQcAAACiADGoObf5cuXV8u6/DQw6senqV2GDBni1r9ixb9rYPr06ZMig9dff70b8LF06VKbP3++3Xrrra4voKaRIWChqvDIOAAABBABjOHkk0+2+++/v9rWpzkECwsLrWHDhm4i6ClTppT/TzV7ffv2Lf9bTc177723G23csmVLO+SQQ5xEErBQHQSbgov+UxOICAIAkE8RwH9x9913W5s2bWzo0KE2fvx4NydgcCFgoa5IIH0CAQDIpwjgf6hXr17sosfCEbBQFyRQtX9FSCAAAPkUASRgIXkiyMAQAADyaeIFcPPmzXbEEUdEPgmEgIW6CANDAADIp4kXQNGqVStbtGgRAQuJgDkCAQDIpwjgv7j00kvtiiuuIGAhkRLI6GAAAPJpIgVQz/xt3ry5m7LlggsusEsuuSRlIWChrksgtYEAAOTTxAmg+gDGLd27dydgoU5LoO8TyMAQAEAAyaeJEkACFpIOA0MAAMinCGCADz/8kICFOg8DQwAAyKeJEcAmTZrYRx99VP53z5497f333y//+4MPPmAiaEACAQAQQKhLAqgnfQRr+Jo1a2ZLly5NEUC9h4CFJEogo4MBAAGExAogNYCQZAlkYAgAIICAABKwkCAJ9I+MY2AIACCAUKcEUHIX7AO4ww472LJlyxBAAKNPIAAggFBHBVA1gDvuuKO1bNnSLfq7RYsW5X/rfwggIIFIIAAggFCHBPCBBx7IaiFgAQlEAgEAAYQ6IoAELEDuEqhl0PjZHBQAIJ8CAkjAQhIk0AtgIQNDAIB8CgggAQvJQDV/XgBpDgYA8ikggAQsJAT6BAIA+RQQQAIWkEAkEADIp1B7BXDTpk22YMEC+/bbbwlYgBwkkIEhAIAAQq0TwK+//trOO+88KygocIt/GsigQYPshhtuIGAB0kggA0MAAAGEWimAgwcPtgMOOMD+/ve/W9OmTcsF8Omnn7b999+fgAVIAwNDAAABhFopgO3atbMZM2a434PPA168eLF7PBwBC5Ae+gQCAAIItU4AmzRpUi59QQGcO3euNW/enIAFQAIBAAGEuiaAJSUl9oc//KFcAJctW+Z+v/jii61nz54ELEAlJJCBIQCAAEJeC+C0adNcU2///v2tcePGVlpaakcffbTrD/iPf/yDgAXIUQIZGAIACCDkvQCKd955x8455xzbd999rbi42M4++2z3GgELkDsMDAEABBBqhQASsADVC30CAYB8CnktgEcccYTde++99vnnnxOwAFtJAov+tXQa8SIiCADkUwQwP9CEz23atHH9/3r37m1PPfWUeyoIAQtQvRJY+B8JBAAgnyKAecGWLVvsxRdftL59+7qpX1q2bGn9+vWzyZMnE7AA1SCBRVf8/5pAagEBgHyKAOYdGzZssMcff9w6depk2223HQELUE0SSJ9AACCfIoB5ybp162z06NHu0XD16tWzrl27ErAAW0EC6RMIAORTBLDGT/h9993n5v6rX7++tW/f3kaMGOEeBUfAAmw9CaQ2EADIpwhgjaHBH23btnUTQL/xxhsELMA2kEDV/jEwBADIpwhgjaHBHxoEQsACbFu8BDIwBADIpwggELCQEOgTCADkUwRwm9K5c2f77LPP3O/777+/+ztuIWABto0E0icQAMinCOBWRYM8vv76a/f78OHD3d9xCwELsPUlULV/RUggAJBPEUAgYCF5IljEwBAAIJ8igNuCPffc0z755JMKr69fv979j4AF2HaERwdTEwgA5FMEcKugCZ8//PDDCq9/8MEH1qBBAwIWYBtCn0AAIJ8igFuVp59+2i0SwIceeqj8by1lZWV28cUXu0mhCViAbS+B9AkEAPIpArhVkPhp0fN+/e9+adiwoZO/Z599loAFqEER5PnBAEA+RQC3CkVFRfbxxx8TsAB5KoG+JpAJowGAfIoAAgELCSE4MISaQAAgnyKA1cZXX31lzz//vN111112xx13pCwELEDNQp9AACCfIoDVzuzZs61NmzbWvHlzKygosNatW7t+gE2bNmUaGIA8E8HgCOFB42dzUACAfIoAVo5u3bpZv3797LvvvrNmzZrZ0qVLbdWqVVZSUmITJ04kYAHyTAK9ABbSJxAAyKcIYGVp0aKFLViwoPz3efPmud9nzpxpHTp0IGAB8gzV/NEnEADIpwhglWjVqpUtXLjQ/a6pXyZNmuR+nz9/vjVp0oSABchDmCIGAMinCGCVOOaYY+zRRx91v1944YXWtWtXe+SRR6xnz57udwIWIP8lsIhHxwEA+RQBzIU333zTXn31Vff7Rx99ZL169bIddtjBOnfubHPnziVgAWqJBPrnBwMAkE8RQAIWIAESyGTRAEA+RQAJWIAESiDNwQBAPkUA07L//vu7Jt5sFgIWoPZJIINDAIB8igBWYMSIEVkvBCxA7ZJAnhoCAORTBHCbM2bMGCsqKrJGjRpZly5dbOrUqbHvveeee+ywww6zHXfc0S1HHXWUzZo1i4AFqAYRpF8gAJBPEcC0rF+/3saOHWvDhg2zTz/91L321ltv2Zo1a3Jaz4QJE6xBgwZuXZpQurS01D1SbuXKlZHvP+uss5wwzpkzx807eO6557rJqHP5XgIWIBrVBNIcDADkUwQwkrfffts9/3fvvfe2+vXru0fBiWuuucb69OmT07o0b2D//v1TXuvYsaMTy2zQ4+g0Bc2DDz5IwAJUEZqDAQABRABjUbPrZZdd5n73zwIW06ZNs8LCwqzXs2nTJisoKLCysrKU1wcPHuyeK5wNX3zxhTVu3NieffZZAhagGkWQEcIAQD5FAFNo3ry5LVmypIIArlixwvXjy5a1a9e6wJE4Bhk1apR7xFw2XHTRRbbXXnvZhg0bYt+zceNGF5x+Wb16NQELkIMEMmE0ACCACKDtsssuNnv27AoC+OKLL9ruu++eswBOnz495fWRI0dahw4dMn7+pptuspYtW7om6XQMHz7cfU94IWABMksgA0MAAAFEAB39+vWzU045xTZv3uwEcNmyZW7QhuYA1CCObKlKE/Att9ziBn/osXSZoAYQoGoSSHMwACCACKA70YceeqibhkUCt8cee7iRvJK2r776Kqd1aRDIgAEDUl4rLi5OOwjk5ptvds3QM2bMIGABtrEEMjgEAMinCRVAzyuvvOJq4tQU+/LLL1dqHX4amHHjxrlpYIYMGeKmgVF/QqFRxUEZ1Hc1bNjQnnzySVu3bl358uWXXxKwAFtZAhkhDADkUwQwklznARSa10+jhyV2mgh6ypQp5f/r1q2b9e3bt/xvvS+qP5/6+RGwANtGBOkXCADkUwTQoVq4gQMHuilZCFiAug0TRgMA+TRBAqinf+hJHK1atbK2bdvaHXfcYVu2bLHf/va31qRJEzvwwANt/PjxBCxAHSfcHMzgEAAEEOqwAGqwhqZ5GTp0qO2777623XbbWa9evax79+42efJkAhYggSLI4BAABJB8WscFsF27duWDPTT3X7169XKa9oWABaibEhhsEmbCaAAEEOqYAOq5v5q82aNm33fffZeABYAKEkhNIAACCHVEANXk+9FHH5X/7SeBJmABgOZgAAQQ6qgAqsn3uOOOs1NPPdUtqhHs0aNH+d9+IWABkiuBzBUIgABCHRPAX/3qV1ktBCwAIhisDRw0fjYHBQABhNoqgAQsAOQigV4AC5kwGoB8CgggAQuQDFTzV8hcgQDkU0AACViAZMHgEADyKSCABCxAQiWQwSEA5FNAAAlYgISKYPDxcUggAPkUEEACFiABBCeMpiYQgHwKCCABC5AAws3BDA4BIJ8CAkjAAiRIBBkcAkA+BQSQgAVIoASGnyEMAORTQAAJWIAEEJZAagIByKcIIBCwAHUcmoMByKeAABKwAAmVQAaHAJBPAQEkYAESKoLB2kD6BQKQTxFAIGABEiKBviaQfoEA5FMEEAhYgARJIP0CAcinCCAQsAAJlED6BQKQTxFAIGABEiqC9AsEIJ8igEDAAiRQAukXCEA+RQCBgAVIoATSLxCAfIoAAgELkEAJpF8gAPkUAQQCFiChIki/QADyKQIIBCxAAiWQfoEA5FMEEAhYgARKIP0CAcinCCAQsAAJlED6BQKQTxFAIGABEiqC9AsEIJ8igEDAAiRQAukXCEA+RQCBgAVIoATSLxCAfIoAAgELkEAJpF8gAPkUAQQCFiChIki/QADyKQIIBCxAAiWQfoEA5FMEkIAlYAESKIH0CwQgnyKABCwBC5BACaRfIAD5FAEkYDkYAAkVQfoFApBPEUACFgASKIH0CwQgnyKABCwAJFACgzWBNAkDkE8RQAIWABIigcF+gQwQASCfIoAELAAkTASDtYFIIAD5FAEkYAEgAQQlkJpAAPIpAkjAAkACYKoYAPIpAkjAAkCCRTA4QETLoPGzOTAA5FMEkIAFgLougcEm4UL6BQKQTxFAAhYAkoFq/pgqBoB8igASsACQMHiWMAD5FAEkYAEgoRIYnjOQfoFAPiWfIoAELAAkRAQLeYwcAPkUASRgASBZBPsF0iQM5FPyKQJIwAJAQmDOQCCfkk8RQAIWABIsgsEBIjxGDsingAASsACQEAksokkYyKeAABKwAJA8CaRJGMingAASsACQUBGkSRjIp4AAErAAkEAJpEkYyKeAABKwAJBACaRJGMingADGMGbMGCsqKrJGjRpZly5dbOrUqbHvfe+996x3795WWFjogm706NEELADkvQgGm4R5gggggJB4AZwwYYI1aNDAxo4da/PmzbPS0lJr2rSprVy5MvL9b7zxhv3mN7+xxx57zNq0aYMAAkCtkUDV/gUlkJpAQAAhsQLYtWtX69+/f8prHTt2tGHDhmX8rGoBEUAAqE0EnyBCkzAggJBIAdy0aZMVFBRYWVlZyuuDBw+2kpKSahPAjRs3uuD0y+rVqwlYAKgxokYJI4KAAEJiBHDt2rUucKZNm5by+qhRo6x9+/bVJoDDhw933xNeCFgAqEkJDA4QYboYQAAhcQI4ffr0lNdHjhxpHTp0qDYBpAYQAPJZBMMSSG0gIIBAE3A1CCABCwD5LoHh2kDmDQQEEAGs02gQyIABA1JeKy4uZhAIACCCTBcDCCACWFfx08CMGzfOTQMzZMgQNw3MihX/vvPt06dPigyq1nDOnDluadu2rZsSRr8vXryYgAWAOiOCweliaBIGBBABrJNoImjV5jVs2NBNBD1lypTy/3Xr1s369u1b/vfy5csjB3TofQQsANQVgtPF0DcQEEAEEAhYAEgI9A0E8ikCCAQsACRcBJkuBsinCCAQsACQMMISSJMwkE8RQCBgAaCOEzd5NCII5FMEEAhYAEioCCKBQD5FAIGABYAEiCC1gUA+RQCBgAWABEogI4WBfIoAAgELAIggTxEB8ikCCAQsACRJBHmKCJBPEUAgYAEgYfAUESCfIoBAwAJAAolqEqZZGMinCCABS8ACQIJEkGZhIJ8igAQsAQsACYNmYSCfIoAELAELAAmEZmEgnyKABCwBCwAJF0GahYF8igASsAAACYNmYSCfIoAELABAAqFZGMinCCABCwCQcBGkWRjIpwggAQsAkDBoFgbyKQJIwAIAJBCahYF8igASsAAACRdBmoWBfIoAErAAAAmDZmEgnyKABCwAQAKhWRjIpwggAQsAkHARpFkYyKcIIAELAJAwaBYG8ikCSMACACSQuGbhjtf8FREknwICSMACACRBBKkRJJ8CAkjAAgAkDDULh2sDEUHyKSCABCwAQAKIahrW70gg+RQQQAIWACABIlhEbSD5FBBAAhYAIHkSGDVQpIg5BMmngAASsAAAyRRBagTJp4AAErAAAAkQwY7XvMBAEfIpIIAELABAEkWQOQTJp4AAErAAAAkWQWoEyaeAABKwAAAJgzkEyaeAABKwAAAJhcEi5FNAAAlYAIAEiyA1guRTBBAIWACABEqghE+jhhksQj5FAIGABQBIqAxSI0g+RQCBgAUASBhRg0WoESSfIoBAwAIAJABqBMmnCCAQsAAACSWuRpBnDZNPEUAgYAEA6jjxTxZ5gVpB8ikCCAQsAEBdF8Hws4ZpHiafIoBAwAIAJEQE46aQQQTJpwggAcvBAABIgAxGTSpN8zD5FAEkYAEAoI5LYFyNILWC5FMEkIAFAICEyGAhtYLkUwSQgAUAgGSKYFStoP5GAsmnCCABCwAACZBBagTJpwggAQsAAAkVwah+gntf+TwySD5FAAlYAACo6yIYN6cgNYPkUwSQgAUAgDqMf9ycagAZQUw+RQAJWAAASBiMICafIoAELAAAJFwE4+YVTIoMkk8RQAIWAAASLYOFESL4/4Xwr3VSBsmnCCABCwAAiOB/agXj5hb0/6srtYPkUwSQgAUAAAgJYdQo4rrUVEw+RQAJWAAAgDQyGDetTG2ea5B8igBWiTFjxlhRUZE1atTIunTpYlOnTk37/ieffNKKi4utYcOG7mdZWRkBCwAAtU4G4waR+Gln8r3/IPkUAaw0EyZMsAYNGtjYsWNt3rx5Vlpaak2bNrWVK1dGvn/69OlWUFBg119/vc2fP9/9rF+/vs2cOZOABQCAWimEvmYwbq5B338w36SQfIoAVpquXbta//79U17r2LGjDRs2LPL9p59+uh177LEpr/Xs2dPOPPNMAhYAAOqEEKqG0Mte3BKWwppoPiafIoCVYtOmTa42L9yEO3jwYCspKYn8zB577GG33XZbymv6u127drHfs3HjRhecflm9ejUBCwAAtUoIg7KXSQyDUuibmrfGgBMEEAGsFGvXrnWBM23atJTXR40aZe3bt4/8jJqLH3300ZTX9Lf6A8YxfPhw9z3hhYAFAIC6IoVxzcfh5Wc3vIIAIoD5IYDq1xdk5MiR1qFDh1gBHD9+fMprjzzyiBtAEgc1gAAAkCQxpAYQAcxrtlUTMAELAABQ/ZBPEcBKo0EgAwYMSHlNU7ukGwTSq1evlNc0KIRBIAAAAAggAlhL8NPAjBs3zk0DM2TIEDcNzIoV/66i7tOnT4oMqr+gag1vvPFGNw2MfjINDAAAAAKIANYyNBF0YWGhG8ihiaCnTJlS/r9u3bpZ3759U97/xBNPuD6CEkdNGTNx4kQCFgAAAAFEAIGABQAAIJ8igEDAAgAAkE8RQAIWAAAAyKcIIAELAAAA5FMEkIAFAAAA8ikCSMACAACQT8mnCCABCwAAQD4FBJCABQAAIJ8CAkjAAgAAkE8BASRgAQAAyKeAABKwAAAA5FMEEAhYAAAA8ikCCJXl888/dwG7evVqF7QsLCwsLCwsuS/Ko8qnyquAAOY9PmBZWFhYWFhYqr4orwICmPds2bLFBavuWKr7Lqiu1SrWxf1in9gn9ot9Yp+qZ53Ko1qf8ioggPSDYL/YJ/aJfeJcsU/sEyCACCD7xT6xT+wT54p9Yp8AAUQA2S/2iX3immKf2Cf2CRDA2szGjRtt+PDh7if7xT6xT+wT54p9Yp8AAQQAAAAABBAAAAAAEEAAAAAAQAABAAAAEEDYhowZM8aKioqsUaNG1qVLF5s6dWra9z/55JNWXFxsDRs2dD/LyspS/v/999+7Drht27a1xo0bW7du3ey9997L232655577LDDDrMdd9zRLUcddZTNmjUr5T19+/atMCP8QQcdlLf7dP/990fOYr9hw4Yqnfua3i/FUtR+HXfccXlzrqZMmWInnHCCi39991NPPZXxM5MnT3b7rmOw55572l133VXl67Qm92nixIl29NFHW6tWrWyHHXawgw8+2CZNmpTyHpUR4fP0wx/+MG/36bXXXouMvfnz5+dUPubTPkVdK1r22WefvDlP119/vR144IHWrFkza926tZ188sm2YMGCjJ+rDXkKEMAaZcKECdagQQMbO3aszZs3z0pLS61p06a2cuXKyPdPnz7dCgoK3EWpgk8/69evbzNnzix/z4033ugKfSWBd99918444wx3kX3xxRd5uU9nnXWWS65z5sxx+3TuuedaixYtbM2aNSkF5bHHHmvr1q0rXz799NO8PU8SwObNm6dsr5aqrDMf9kvHPLg/KrAVj9rffDlXL7zwgl199dUu/rNJwsuWLbPtt9/e7buOgY6FjokSWL6cq1z3Sdt300032RtvvGGLFi2yK6+80m3/7NmzU8Ri3333TTlPH330Ud6eJy+ACxcuTNnm7777LqfyMZ/2SU+3CO6LnnSx0047uXOTL+epZ8+e7vrWtT537lw7/vjjrV27dvbVV1/FfqY25ClAAGucrl27Wv/+/VNe69ixow0bNizy/aeffrpLruEL9Mwzzyy/q2rTpo27uDwaii+huvvuu/Nyn8KoQFfB8OCDD6ZIhe48a8t5UoGpY741j1M+nKvRo0e7cxVMBjV9rlIKtiyS8OWXX+72OciFF17oas3y6Vzlsk9RqFbpuuuuSxGLTp061Zrz5AVw/fr1se/JVD7m+3nS++vVq2crVqzIy/MkJJ/aN9V2VvY85EOeAgSwRtm0aZO7SwpXjQ8ePNhKSkoiP7PHHnvYbbfdlvKa/tYdmVi6dKm7OIN3+uKkk06yc845Jy/3KYzuANUk8Oyzz6ZIhQoHNUH8+Mc/tvPPP98+/PDDvD1PEkB9Rudlt912c3fNwXNSHccpH87VfvvtZ/369Ut5rSbPVWWS8OGH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eOGF7veysjK3vq+//poTCQAIIABAdQjgT37yEzv++OPtxhtvtN12280WL15cYfn444/LBVBNxkFGjx7t+gN61JT8+uuv27XXXuvWrdo79e3LRQCfeeYZa9GihX3zzTeuSfr888/nJAIAAggAUB0C6AeB3HffffbSSy+5plf13YsjGwEMohpBSeWtt94auR3HHHOMDRw4MPJzu+66q/uc+hROnz6dkwgACCAAQK4CGDcNzAknnOCESzV3hx12mBO8SZMmORGcNm2aXX311W5QSDYCOHPmTLdevX/lypX2+OOPW8OGDe2FF16IFEANAPnpT3/qvku1jME5CTWwRJ/t2LEjJxAAEEAAgMoIYHAiaDXLaiJo1fwFpUuDOwYNGuRq3xo0aGB77LGHnX322bZq1aqsBHDevHnWs2dPt/5GjRpZ+/bt7c4770zZjqAALly40A4++GBr0qSJ27Zg7ePSpUvda+qbCACAAAIAJAD1I5SsfvDBBxwMAEAAAQDqMpqGRgNPNAn1WWedxQEBAAQQAKCuc//997upZ7p06eL6KwIAIIAAAAAAgAACAAAAAAIIAAAAAAggAAAAACCAAAAAAIAAAgAAAAACCAAAAAAIIAAAAAAggAAAAAAIIAAAAAAggAAAAACAAAIAAAAAAggAAAAACCAAAAAAIIAAAAAAkBf8PwxregtdjfnYAAAAAElFTkSuQmCC" width = "524" height = "425" alt = "" style = "vertical-align: baseline"></img></div><div class = 'S0'><span>Here is the script to reproduce the last figure with pyfaust: </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/test_svd_rc_vs_err.py"><span>test_svd_rc_vs_err.py</span></a></div><div class = 'S0'><span></span></div><h3 class = 'S2'><span>2. Faust Algebra and other Operations</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>In order to write some nice algorithms using Faust objects, you'll have to use the basic "stable" operations a Faust is capable of. Let's make a tour of them.</span></div><div class = 'S0'><span></span></div><h4 class = 'S12'><span>2.1 Transpose, conjugate, transconjugate</span></h4><div class = 'S0'><span></span></div><ul class = 'S3'><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a029a3db751ae1282eca2af94ce4101ec"><span>Faust.transpose</span></a><span> or </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a029a3db751ae1282eca2af94ce4101ec"><span>.'</span></a></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#aec9036a3d251fd47038a9a338b91502d"><span>Faust.conj</span></a><span>,</span></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a66c1abdcbcfe8505457ce69a7b355716"><span>Faust.ctranspose</span></a><span> or </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a66c1abdcbcfe8505457ce69a7b355716"><span>'</span></a></li></ul><div class = 'S0'><span>You are probably familiar with .' and ' shorthand operators from Matlab. Well, they are also used in the Faust class.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>G = matfaust.rand(10, 15, </span><span style="color: rgb(160, 32, 240);">'dim_sizes'</span><span>, [10,15], </span><span style="color: rgb(160, 32, 240);">'field'</span><span>, </span><span style="color: rgb(160, 32, 240);">'complex'</span><span>)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="7A9EAF2D" data-scroll-top="null" data-scroll-left="null" data-testid="output_12" data-width="926" data-height="104" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">G = </span></div><div>Faust size 10x15, density 2.16667, nnz_sum 325, 5 factor(s): -- FACTOR 0 (complex) SPARSE, size 10x14, density 0.357143, nnz 50 -- FACTOR 1 (complex) SPARSE, size 14x13, density 0.384615, nnz 70 -- FACTOR 2 (complex) SPARSE, size 13x13, density 0.384615, nnz 65 -- FACTOR 3 (complex) SPARSE, size 13x15, density 0.333333, nnz 65 -- FACTOR 4 (complex) SPARSE, size 15x15, density 0.333333, nnz 75</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>G.'</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="90D7DC90" data-scroll-top="null" data-scroll-left="null" data-testid="output_13" data-width="926" data-height="104" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 15x10, density 2.16667, nnz_sum 325, 5 factor(s): -- FACTOR 0 (complex) SPARSE, size 15x15, density 0.333333, nnz 75 -- FACTOR 1 (complex) SPARSE, size 15x13, density 0.333333, nnz 65 -- FACTOR 2 (complex) SPARSE, size 13x13, density 0.384615, nnz 65 -- FACTOR 3 (complex) SPARSE, size 13x14, density 0.384615, nnz 70 -- FACTOR 4 (complex) SPARSE, size 14x10, density 0.357143, nnz 50</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>conj(G)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="2EE00C35" data-scroll-top="null" data-scroll-left="null" data-testid="output_14" data-width="926" data-height="104" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x15, density 2.16667, nnz_sum 325, 5 factor(s): -- FACTOR 0 (complex) SPARSE, size 10x14, density 0.357143, nnz 50 -- FACTOR 1 (complex) SPARSE, size 14x13, density 0.384615, nnz 70 -- FACTOR 2 (complex) SPARSE, size 13x13, density 0.384615, nnz 65 -- FACTOR 3 (complex) SPARSE, size 13x15, density 0.333333, nnz 65 -- FACTOR 4 (complex) SPARSE, size 15x15, density 0.333333, nnz 75</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>G'</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="B3BFA437" data-scroll-top="null" data-scroll-left="null" data-testid="output_15" data-width="926" data-height="104" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 15x10, density 2.16667, nnz_sum 325, 5 factor(s): -- FACTOR 0 (complex) SPARSE, size 15x15, density 0.333333, nnz 75 -- FACTOR 1 (complex) SPARSE, size 15x13, density 0.333333, nnz 65 -- FACTOR 2 (complex) SPARSE, size 13x13, density 0.384615, nnz 65 -- FACTOR 3 (complex) SPARSE, size 13x14, density 0.384615, nnz 70 -- FACTOR 4 (complex) SPARSE, size 14x10, density 0.357143, nnz 50</div></div></div></div></div></div><div class = 'S8'><span>What really matters here is that the results of G.', conj(G) and G' are all Faust objects. Behind the scene, there is just one memory zone allocated to the factors. Strictly speaking they are memory views shared between G, G.' and G'. So don't hesitate to use!</span></div><h4 class = 'S12'><span>2.2 Add, Subtract and Multiply</span></h4><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>s = size(G, 1);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>F = matfaust.rand(s, s);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>G = matfaust.rand(s, s, </span><span style="color: rgb(160, 32, 240);">'field'</span><span>, </span><span style="color: rgb(160, 32, 240);">'complex'</span><span>);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>F+G</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="0840809D" data-scroll-top="null" data-scroll-left="null" data-testid="output_16" data-width="926" data-height="146" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 5.6, nnz_sum 560, 8 factor(s): +.S13 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 1px solid rgb(233, 233, 233); border-radius: 4px; padding: 6px 45px 4px 13px; line-height: 17.2339992523193px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; } +.S14 { border-left: 1px solid rgb(233, 233, 233); border-right: 1px solid rgb(233, 233, 233); border-top: 1px solid rgb(233, 233, 233); border-bottom: 0px none rgb(0, 0, 0); border-radius: 0px; padding: 6px 45px 0px 13px; line-height: 17.2339992523193px; min-height: 18px; white-space: nowrap; color: rgb(0, 0, 0); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 14px; }</style></head><body><div class = rtcContent><div class = 'S0'></div><h2 class = 'S1'><span>How to Manipulate a Faust</span></h2><div class = 'S0'><span></span></div><div class = 'S0'><span>This livescript is intended to gently introduce the operations available to manipulate a Faust object. It comes after the first livescript (available </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/Faust_creation.mlx"><span>here</span></a><span> for download or </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/Faust_creation.html"><span>here</span></a><span> as a web page), so it's assumed you already know how to create a Faust object from one way or another.</span></div><div class = 'S0'><span>Keep in mind that a full API doc is available </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/namespacematfaust.html"><span>here</span></a><span> every time you need details. In particular the Faust class is documented </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html"><span>here</span></a><span>.</span></div><div class = 'S0'><span style=' font-weight: bold;'>NOTE</span><span>: the livescript is made to be executed sequentially, otherwise, skipping some cells, you would end up on an import error.</span></div><div class = 'S0'><span></span></div><h3 class = 'S2'><span>Table of Contents:</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><a href = "#H_E9BF5BFF"><span>1. Getting Basic Information about a Faust Object</span></a></div><div class = 'S0'><a href = "#H_95BE1343"><span>1.1 Obtaining Dimension and Scalar Type Information</span></a></div><div class = 'S0'><a href = "#H_0602CE09"><span>1.2 Obtaining Other Faust Specific Information</span></a></div><div class = 'S0'><a href = "#H_2CF60B15"><span>1.3 Plotting a Faust</span></a></div><div class = 'S0'><a href = "#H_C5C21250"><span>1.4 About Sparsity!</span></a></div><div class = 'S0'><span></span></div><div class = 'S0'><a href = "#H_73387A87"><span>2. Faust Algebra and other Operations</span></a></div><div class = 'S0'><a href = "#H_5E556DD4"><span>2.1 Transpose, conjugate, transconjugate</span></a></div><div class = 'S0'><a href = "#H_99DA98B4"><span>2.2 Add, Subtract and Multiply</span></a></div><div class = 'S0'><a href = "#H_BD8A7C70"><span>2.3 Faust Multiplication by a Vector or a Matrix</span></a></div><div class = 'S0'><a href = "#H_7AF16EFF"><span>2.4 Faust Norms</span></a></div><div class = 'S0'><a href = "#H_1070C649"><span>2.5 Faust Normalizations</span></a></div><div class = 'S0'><a href = "#H_B081D439"><span>2.6 Faust Concatenation</span></a></div><div class = 'S0'><a href = "#H_EBCC81E9"><span>2.7 Faust Indexing and Slicing</span></a></div><div class = 'S0'><span></span></div><h3 class = 'S2' id = 'H_E9BF5BFF' ><span>1. Getting Basic Information about a Faust Object</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>First of all, given any object, you might ask yourself if it's a Faust or not (typically when you receive an object in a function, matlab being built on dynamic types, you can't say for sure it's a Faust). </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#ac5d5fbe66ef212a1c7043b78504f87fc"><span>Faust.isFaust()</span></a><span> is the function to verify an object is a Faust. Its use is straighforward as you can see in the documentation. Note by the way, that a more accessible alias is available at the package root </span><span style=' font-family: monospace;'>(matfaust.isFaust</span><span>).</span></div><div class = 'S0'><span></span></div><h3 class = 'S2' id = 'H_95BE1343' ><span>1.1 Obtaining Dimension and Scalar Type Information</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>Firstly, let's list basic Faust informative methods/attributes you're probably used to for matlab matrices:</span></div><ul class = 'S3'><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a7146c7de95b35efc570a377765edda27"><span>size</span></a><span>,</span></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#af62f554cd8b491a2c75ee06019f87d8a"><span>numel</span></a><span>,</span></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a7527e1fda21bc1678646a4b40db28eb6"><span>isreal</span></a><span>.</span></li></ul><div class = 'S0'><span>To keep it really clear, let's show some examples operated on a random Faust.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F = matfaust.rand(5,10)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="B93E932D" data-testid="output_0" data-width="1172" data-height="104" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">F = </span></div><div>Faust size 5x10, density 3.1, nnz_sum 155, 5 factor(s): +- FACTOR 0 (real) SPARSE, size 5x8, density 0.625, nnz 25 +- FACTOR 1 (real) SPARSE, size 8x8, density 0.625, nnz 40 +- FACTOR 2 (real) SPARSE, size 8x5, density 1, nnz 40 +- FACTOR 3 (real) SPARSE, size 5x5, density 1, nnz 25 +- FACTOR 4 (real) SPARSE, size 5x10, density 0.5, nnz 25</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>size(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="4491F0F0" data-testid="output_1" data-width="1172" style="width: 1202px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 1172px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">1×2</span></div><div class="valueContainer" data-layout="{"columnWidth":40,"totalColumns":2,"totalRows":1,"charsPerColumn":6}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 82px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 5 10 +</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>numel(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 50</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>isreal(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="E2251216" data-testid="output_3" data-width="1172" data-height="34" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 1 +</div></div></div></div></div></div><div class = 'S8'><span>If the attributes printed out above seem not clear to you, you're probably not a Matlab user. Anyway you'll find all descriptive informations in the FAµST API documentation (see the links above).</span></div><div class = 'S0'><span>As a complement, you can also refer to the Matlab API documentation:</span></div><ul class = 'S3'><li class = 'S4'><a href = "https://www.mathworks.com/help/matlab/ref/size.html"><span>size</span></a></li><li class = 'S4'><a href = "https://www.mathworks.com/help/matlab/ref/numel.html"><span>numel</span></a></li><li class = 'S4'><a href = "https://www.mathworks.com/help/matlab/ref/isreal.html"><span>isreal</span></a></li></ul><div class = 'S0'><span>About size, it's noteworthy that contrary to what Matlab is capable of on an array, you cannot </span><a href = "https://www.mathworks.com/help/matlab/ref/reshape.html"><span>reshape</span></a><span> a Faust.</span></div><h3 class = 'S2'><span></span></h3><h3 class = 'S2' id = 'H_0602CE09' ><span>1.2 Obtaining Other Faust Specific Information</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>As you've seen in this livescript and the first one, when you print a Faust object, several pieces of information appear. Most of them are also available independently with specific functions.</span></div><div class = 'S0'><span>For instance, if you want information about factors, nothing is more simple than calling directly the next functions:</span></div><ul class = 'S3'><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a5e77419460592366457aa60175472e2e"><span>numfactors()</span></a><span> ; which gives you the number of factors (aka layers) a Faust object is composed of.</span></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a65a84416b4b1fd050654a02232e95d2f"><span>factors()</span></a><span> ; which allows you to copy any of the Faust's factors givens its index.</span></li></ul><div class = 'S0'><span>Going back to our F object, let's call these functions:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>numfactors(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 5</div></div></div></div><div class = 'S8'><span>For example, try to copy the third factor:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>f3 = factors(F, 3)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement scrollableOutput" uid="E771A4F9" data-testid="output_5" data-width="1172" data-height="580" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">f3 = </span></div><div> (1,1) 0.6747 + (2,1) 0.1861 + (3,1) 0.3943 + (4,1) 0.9627 + (5,1) 0.8914 + (6,1) 0.9190 + (7,1) 0.3666 + (8,1) 0.6478 + (1,2) 0.9990 + (2,2) 0.5762 + (3,2) 0.7183 + (4,2) 0.9727 + (5,2) 0.1263 + (6,2) 0.2359 + (7,2) 0.6577 + (8,2) 0.9747 + (1,3) 0.4491 + (2,3) 0.2179 + (3,3) 0.9607 + (4,3) 0.2979 + (5,3) 0.6902 + (6,3) 0.4500 + (7,3) 0.9129 + (8,3) 0.2257 + (1,4) 0.7983 + (2,4) 0.3299 + (3,4) 0.3559 + (4,4) 0.8236 + (5,4) 0.1541 + (6,4) 0.4884 + (7,4) 0.0303 + (8,4) 0.1343 + (1,5) 0.5932 + (2,5) 0.4671 + (3,5) 0.0055 + (4,5) 0.0170 + (5,5) 0.5230 + (6,5) 0.1512 + (7,5) 0.9959 + (8,5) 0.1423 +</div></div></div></div></div></div><div class = 'S8'><span>Note that, since Faust 2.3, the function doesn't alterate the factor format. If the Faust object contains a sparse factor then you'll receive a sparse matrix.</span></div><div class = 'S0'><span>Since Faust 2.3 again, it's possible to retrieve a sub-sequence of Faust factors.</span></div><div class = 'S0'><span>Go straight to the example, extracting factors from F:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>factors(F, 3:4)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="48DD6E63" data-testid="output_6" data-width="1172" data-height="62" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 8x5, density 1.625, nnz_sum 65, 2 factor(s): +- FACTOR 0 (real) SPARSE, size 8x5, density 1, nnz 40 +- FACTOR 1 (real) SPARSE, size 5x5, density 1, nnz 25</div></div></div></div></div></div><div class = 'S8'><span>Hmm... something is different from the previous example. We indeed received a Faust as return type, great! You've just learned another way to create a Faust from another, additionally to what you've seen in the first </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/Faust_manipulation.html"><span>livescript</span></a><span>.</span></div><div class = 'S0'><span>Without this function, you'd surely have written something similar to:</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>import </span><span style="color: rgb(160, 32, 240);">matfaust.Faust</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>Faust({factors(F, 3), factors(F, 4)})</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="57A2B1EB" data-testid="output_7" data-width="1172" data-height="62" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 8x5, density 1.625, nnz_sum 65, 2 factor(s): +- FACTOR 0 (real) SPARSE, size 8x5, density 1, nnz 40 +- FACTOR 1 (real) SPARSE, size 5x5, density 1, nnz 25</div></div></div></div></div></div><div class = 'S8'><span>OK, that's not awful but I let you imagine how much complicated it is with more factors.</span></div><div class = 'S0'><span></span></div><h3 class = 'S2' id = 'H_2CF60B15' ><span>1.3 Plotting a Faust</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>It's quite useful to print a </span><span style=' font-family: monospace;'>Faust</span><span> as we've seen before, calling disp(F), </span><span style=' font-family: monospace;'>display(F)</span><span> or just </span><span style=' font-family: monospace;'>F</span><span> in an interactive terminal but this is wordy. How about plotting a Faust in a more graphical fashion ?</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>imagesc(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsFigure" uid="84E24A62" data-testid="output_8" style="width: 1202px;"><div class="figureElement" style="cursor: default;"><div class="figureContainingNode" style="width: 560px; max-width: 100%; display: inline-block;"><div class="GraphicsView" data-dojo-attach-point="graphicsViewNode,backgroundColorNode" id="uniqName_197_54" widgetid="uniqName_197_54" style="width: 100%; height: auto;"><img class="ImageView figureImage" data-dojo-attach-point="imageViewNode" draggable="false" ondragstart="return false;" id="uniqName_197_56" widgetid="uniqName_197_56" src="data:image/png;base64,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" style="width: 100%; height: auto;"></div></div></div></div></div></div></div><div class = 'S8'><span>What do we see above ? On the bottom right is the dense matrix associated to F, obtained with </span><span style=' font-family: monospace;'>full(F)</span><span>. On the top are the indexed factors of F. Note that you can change the default </span><a href = "https://www.mathworks.com/help/matlab/ref/colormap.html"><span style=' text-decoration: underline;'>colormap</span></a><span> in matplotlib parameters.</span></div><div class = 'S0'><span>Let's look at a last example:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>imagesc(Faust({eye(5,4),eye(4,10)}))</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsFigure" uid="869DBEED" data-testid="output_9" style="width: 1202px;"><div class="figureElement" style="cursor: default;"><div class="figureContainingNode" style="width: 560px; max-width: 100%; display: inline-block;"><div class="GraphicsView" data-dojo-attach-point="graphicsViewNode,backgroundColorNode" id="uniqName_197_57" widgetid="uniqName_197_57" style="width: 100%; height: auto;"><img class="ImageView figureImage" data-dojo-attach-point="imageViewNode" draggable="false" ondragstart="return false;" id="uniqName_197_59" widgetid="uniqName_197_59" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAjAAAAGkCAYAAAAv7h+nAAAgAElEQVR4AezBD5RedX3v+zdPJpMEfsUqHSJyTluiB0U2gifivSuuEH5158ifaeTklGYFJVmWTqAP+7JcC//cK9YIXJQ4SMHPz2kr4/k1sJCoBQuyuD3MvtlFiYE7phw5+6dBw58eoIIYFNhkMpOZ57l31umsm1L5e1DzlO/r1eoaY4wxxvSYFsYYY4wxPaaFMcYYY0yPaWGMMcYY02NaGGOMMcb0mBbGGGOMMT2mhTHGGGNMj2lhjDHGGNNjWhhjjDHG9JgWxhhjjDE9poUxxhhjTI9pYYwxxhjTY1oYY4wxxvSYFsYYY4wxPaaFMa9B27dvZ2hoiKGhIYaGhhgaGmJoaIihoSGGhoYYGhpiZGSEX6bdu3fTa8qy5IwzzmDlypWsX7+eF7N7927mfOELX+CCCy7gl2379u0MDQ0xNDTE0NAQQ0NDDA0NMTQ0xNDQEENDQ4yMjHAg2L17Ny9m+/btDA0NMTQ0xNDQEENDQwwNDTE0NMTQ0BBDQ0OMjIxgzGtNC2Neg3bt2sXo6Cijo6OMjo4yOjrK6Ogoo6OjjI6OMjo6SlmW/DLs3LmTLMu455576CWPPvoog4ODlGXJIYccwtFHH83z2blzJ1mWcc899zDn9ttv56/+6q/4Zdu1axejo6OMjo4yOjrK6Ogoo6OjjI6OMjo6yujoKGVZ8uu0c+dOsizjnnvu4cXs2rWL0dFRRkdHGR0dZXR0lNHRUUZHRxkdHWV0dJSyLDHmtaaFMa9hW7Zsodvt0u126Xa7dLtdut0u3W6Xm266iV+G8fFxUkr0mh07djA5OcnVV1/N3/zN33DRRRfxfMbHx0kp8eu0ZcsWut0u3W6XbrdLt9ul2+3S7Xa56aab+HUaHx8npcTLsWXLFrrdLt1ul263S7fbpdvt0u12uemmmzDmtaaFMeZlmZqa4qWYnp7mleh0OkxPT/NiOp0Ov8jU1BSvVKfTYXp6ml+k0+kw67DDDuPV0Ol06HQ6vJjp6Wl+Vaampng1TU1NYYz55WhhjHlR119/PSeccAJ9fX0sWLCAvr4+vPfce++97G/Hjh28973vpa+vj/nz53PEEUfw2c9+ljlDQ0Ocf/75zFq9ejVHHXUUc7Zt28aKFSvo7+9n/vz5LF68mI0bNzI1NcWctWvXsn79ev7iL/6ChQsXcvDBB/PVr36VJ554gg996EMsXLiQBQsW0N/fz3vf+17quual2LZtGytWrKC/v5/58+ezePFiNm7cyNTUFLNWr17NunXrmLVu3ToGBgb49re/zS8yNDTE+eefz6zVq1dz1FFHsb+qqjjhhBOYN28e/f39rFixgl27drG/uq5ZuXIlfX19zJ8/n8WLF7Nx40amp6d5tV1//fWccMIJ9PX1sWDBAvr6+vDec++997K/tWvX8ra3vY3nuu666xgYGODb3/42s5544gk+9KEPsXDhQhYsWEB/fz/vfe97qeuaWUNDQ5x//vnMWr16NUcddRTGmJevhTHmBY2MjPDBD36QN73pTVx//fXceOONfOQjH2Hbtm2cfvrpdDodZo2Pj/Oe97yHBx54gL/8y7/kxhtv5OSTT+YTn/gEf/qnf8qss846izPPPJNZGzZs4NOf/jSzbr/9dlasWMEjjzzCyMgIN954I6tWreKSSy7h1FNPZc4zzzzD+Pg4F1xwAatWreKd73wnb33rW1m9ejW33norV1xxBTfffDNf+MIXqOuak046iaZpeCG33347K1as4JFHHmFkZIQbb7yRVatWcckll3Dqqacya8OGDaxbt45Z69at4/LLL2fJkiX8ImeddRZnnnkmszZs2MCnP/1p5uzdu5fTTz+d3/u932PLli18/OMf51vf+hbve9/7mLNjxw6WLVvGrl27GBkZ4Rvf+AZnn302l1xyCX/wB3/Aq2lkZIQPfvCDvOlNb+L666/nxhtv5CMf+Qjbtm3j9NNPp9PpMOeZZ55h9+7dPNfU1BQ//elPmZycZNbq1au59dZbueKKK7j55pv5whe+QF3XnHTSSTRNw1lnncWZZ57JrA0bNvDpT38aY8zL18KY17BNmzYxODjI4OAgg4ODDA4OMjg4yGWXXcacTZs2ceyxx3LbbbexZs0aVq9ezeWXX0673eaRRx5hx44dzPrwhz/MwoULueuuuzjnnHNYvXo1N9xwAyeddBKbNm1ienoa7z0nn3wys0455RTWr1/PrHPPPZeBgQHuuusuNmzYwOrVq7nmmmu45JJL2Lp1K5s3b2bOD37wA/78z/+cv/7rv2bbtm0cffTR3HnnnZxzzjkURcGqVas477zzuOqqqzjmmGP4wQ9+wAs599xzGRgY4K677mLDhg2sXr2aa665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jz3GihUruOWWW9ixYwdf/vKXWbduHYcffjgXXnghr4alS5eyYMECQghs376dqakptm/fzsqVK/nhD3/IrE6nw5yTTjqJmZkZ/vAP/5DbbruNW2+9lVNOOYUf//jHzBkcHGTJkiV84hOf4Etf+hLj4+OUZckHPvAB9u3bx5o1a5jV39/PrNHRUa677jqMMS9fC2PM8zriiCPYsmULe/fuZdmyZSxYsIAVK1Zw7LHHcscddzDr7rvvZtaqVav42te+xq5du3jf+97Hu971Lj772c9y4YUXEkJgzqmnnsrSpUv5+te/zrp165iammL9+vV85Stf4YEHHuD000/n+OOP52Mf+xhr1qzhjjvuYOHChTyfVqvF2NgYxx13HOeeey7vfve7WblyJWVZcvXVV7NmzRpeyPr16/nKV77CAw88wOmnn87xxx/Pxz72MdasWcMdd9zBwoULeblOPfVUli5dyte//nXWrVvH1NQUL9WqVau4+eabeeaZZ3j/+9/Pu971Lv74j/+Yt771rVRVxeLFi3k1HHHEEWzZsoW9e/eybNkyFixYwIoVKzj22GO54447mHX33Xcz54ILLuBP/uRPuP322zn99NP5/d//fQ499FCuuuoq5rRaLcbGxjjuuOM499xzefe7383KlSspy5Krr76aNWvWMOvUU09l6dKlfP3rX2fdunVMTU1hjHl5WhjzGnT22WfT7XZZs2YNL+aMM87g8ccf53vf+x733HMPe/fu5aqrruLEE0+k2+1y6aWXMufMM8/k4Ycf5v777+fOO+9kz549XHHFFbRaLeYceuihfPe732VycpJ9+/bR39/PrLVr1/Lwww9z//33861vfYs9e/awefNmBgYGmHPrrbfy9NNP81xLlixh27ZtTE5OsnXrVu677z6eeOIJLrjgAl6KtWvX8vDDD3P//ffzrW99iz179rB582YGBgaYc8YZZ9DtdjnjjDN4MYceeijf/e53mZycZN++ffT393Prrbfy9NNP81xr1qyh2+1y2mmnMWfVqlU8+OCD/OM//iNbt27lySefZPv27bz97W/nxZx99tl0u13WrFnDiznjjDN4/PHH+d73vsc999zD3r17ueqqqzjxxBPpdrtceumlzGm1WoyMjLBnzx7+7u/+jp/+9Kd87WtfY+3atXS7XfI8Z9aSJUvYtm0bk5OTbN26lfvuu48n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mc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnN3/mDyv+m8nf+cGZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNm87N++Vm//KxfftYvP+uXn/XLz/rlZ/3ys375Wb/8rF9+1i8/65ef9cvP+uVn/fKzfvlZv/ysX37WLz/rl5/1y5nNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2Zzd/5g8r/pPJ3/nBmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2ZzZnNmc2bzd/6g8u9a/IuKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKyv9HRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUVFRUXl/6KioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqLyn1gkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWMWSZIkj1kkSZI8ZpEkSfKYRZIkyWP+G/womKXYd6phAAAAAElFTkSuQmCC" style="width: 100%; height: auto;"></div></div></div></div></div></div></div><div class = 'S8'><span></span></div><h3 class = 'S2' id = 'H_C5C21250' ><span>1.4 About Sparsity!</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>Three functions of the Faust class are here to evaluate the sparsity of a Faust object.</span></div><div class = 'S0'><span>Let's call the first one:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>nnz_sum(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 155</div></div></div></div><div class = 'S8'><span>I'm sure you guessed exactly what the function returns, if you doubt it, here is the doc: </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a7dc7f3cb86b02b3c2cd725387c34300d"><span>Faust.nnz_sum()</span></a><span>. The smaller </span><span style=' font-family: monospace;'>nnz_sum</span><span>, the sparser the Faust.</span></div><div class = 'S0'><span>Next comes the function: </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#ac33ff53bbff16f93666acec05031511b"><span>Faust.density()</span></a><span>.</span></div><div class = 'S0'><span>This function along with its reciprocal </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#aff3261319b63c49d51a699726edc74bc"><span>Faust.rcg()</span></a><span> can give you a big hint on how much your Faust is potentially optimized both for storage and calculation. The sparser the Faust, the larger the Relative Complexity Gain (RCG)!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>density(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 3.1000</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>rcg(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.3226</div></div></div></div><div class = 'S8'><span>According to its RCG, this Faust doesn't seem to be of any help for optimization but look at the graphic the next script generates:</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>figure()</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>nfactors = 3;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>startd = 0.01;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>endd = 1;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>dim_sz = 1000;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>ntests = 10;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>sizes = zeros(ntests, 1);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>rcs = zeros(ntests, 1);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>densities = linspace(startd, endd, ntests);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(0, 0, 255);">for </span><span>i=1:ntests</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> d = densities(i);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> F = matfaust.rand(dim_sz, dim_sz, </span><span style="color: rgb(160, 32, 240);">'num_factors'</span><span>, nfactors, </span><span style="color: rgb(160, 32, 240);">'density'</span><span>, d, </span><span style="color: rgb(160, 32, 240);">'fac_type'</span><span>, </span><span style="color: rgb(160, 32, 240);">'sparse'</span><span>);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> sizes(i) = nbytes(F);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> rcs(i) = density(F);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(0, 0, 255);">end</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>plot(rcs, sizes)</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>legend(</span><span style="color: rgb(160, 32, 240);">'size'</span><span>)</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>xlabel(</span><span style="color: rgb(160, 32, 240);">'Density'</span><span>)</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>ylabel(</span><span style="color: rgb(160, 32, 240);">'Faust Size (bytes)'</span><span>)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsFigure" uid="A93C84D1" data-testid="output_13" style="width: 1202px;"><div class="figureElement"><div class="figureContainingNode" style="width: 560px; max-width: 100%; display: inline-block;"><div class="GraphicsView" data-dojo-attach-point="graphicsViewNode,backgroundColorNode" id="uniqName_197_60" widgetid="uniqName_197_60" style="width: 100%; height: auto;"><img class="ImageView figureImage" data-dojo-attach-point="imageViewNode" draggable="false" ondragstart="return false;" id="uniqName_197_62" widgetid="uniqName_197_62" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAjAAAAGkCAYAAAAv7h+nAAAgAElEQVR4AezBD5TVBZ3//+f5CDlxWhYmzXBOx7lLLWp2rImGnFXjsugtF9sdcksohFFDh3zVbv90G9brrazTP1NfHicyA6J07LhRa3G6NjKYYjmON6kcvCncSx7+ZV1cSrpK8P397m8Pvy8ZKCY4d2bej0fyf0IIIYQQhpmEEEIIIYRhJiGEEEIIYZhJCCGEEEIYZhJCCCGEEIaZhBBCCCGEYSYhhBBCCGGYSQghhBBCGGYSQgghhBCGmYQQQgghhGEmIYQQQghhmEkIIYQQQhhmEkIIIYQQhpmEEEIIIYRhJiHUjXvvvZdLLrmESy65hEsuuYRLLrmEpUuXEkIIIYQ/lxDqxrRp0/jc5z7H5z73Oa666ioef/xxWltbCSGEEMKfSwh1Y+zYsUyYMIEJEybwjW98g/b2dl7/+tcTQgghhD+XEOpOuVwmn89z0UUXEUIIIYS/lBCOqHvuuYdne/zxx+nt7aVYLHIg3/rWt5g3bx5JkhBCCCGEv5QQjpgbb7yRT3ziE+zvjjvu4Pzzzyefz9PZ2cl1113Hs61atYr29nZCCCGEcGAJ4bB78skn+Y//+A++9rWvsb89e/aQzWZZvnw5X/jCF7j99ttZunQp5XKZfR599FFe9apXMWHCBEIIIYRwYAnhkOzdu5fHHnuMZ9uyZQt/+MMf2N+1115LY2Mjn/nMZ9jfj3/8YyZMmMBrX/taahobGznzzDO599572adUKpFKpQghhBDCwSWEQ5IkCT/4wQ9Yt24d+2zZsoUVK1bwile8gv1deeWVfOxjH+PlL385+3vyySc58cQT2d8rXvEKfvWrX7HP2WefzTXXXEMIIYQQDi4hHLIPfehDrFmzhnXr1rFlyxZWrFjB5ZdfzrMlScKB7NmzhyRJ2F+SJOzdu5cQQgghHLqE8IJ86EMfYtWqVdx4441cfvnlvBBHH300e/bsYX979+5lzJgxhBBCCOHQJYQXpFwus3fvXk444QTWrVvHC/GqV72KX/7yl+xvx44dvPnNbyaEEEIIhy4hHLJyucy3vvUturq6eP/73899993HunXrOFRvectbqLn77rupefTRR7nvvvs47bTTCCGEEMKhSxjl1q1bxxNPPMHz2bt3L7fffjtdXV3s09nZydq1a9m5cyeHIkkSvvjFL/KJT3yC+fPnM2fOHD73uc9xzDHHEEIIIYRDlzCKPfbYY7zvfe9j3bp1PJ8kSfjoRz/Ksy1atIjx48dzIG9729u455572N+0adNYu3Yt3d3d9Pf38/a3v50QQgghvDAJo9Tu3bv5yEc+wjHHHMNQGDduHEmSEEIIIYQXLmGUuuaaa/jHf/xH/v7v/57nYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvbjEQJo1B/fz/3338/H/zgB3k+tunv7ycc2ObNm1m5ciXh4FauXMnmzZsJB9bf309/fz/hwDZv3szKlSsJB7dy5Uo2b95MOLD+/n5sM9IkjDI7d+7kyiuv5JprruFQtba2IglJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCRqJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkESNJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkmhtbaW1tRVJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkUSMJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkaiQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpBEa2srI1HCKPP5z3+ek08+mU2bNnH33XdTqVR4+OGHKRaLhBBCCGF4SBhljj32WJ566iluueUWbrnlFjZv3szdd9/NfffdRwghhBCGh4RR5kMf+hBLlixhyZIlLFmyhDe84Q0sWrSIjo4OwgvX1NSEJMLBSaKpqYlwYLNnz2batGmEA2tqakIS4eAk0dTURBhdEkJ4kdrb2wkH197eTji4pqYmWltbCQfX3t5OOLj29nbC6JMwyi1ZsoSZM2cSQgghhOEjIYQQQghhmEkIIYQQQhhmEkIIIYQQhpmEEEIIoc7Yxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYZrRLCCGEEOqIbfr7+wkH19/fj21Gs4QQQgihzrS2tiIJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkWltbGe0SQgghhBCGmYQQQgghhGEmIYQQQghhmEkIIYQQQhhmEkIIIYRwxD3yyCN8+MMfJhweCSGEEEI44vbu3cszzzxDODwSQgghhHBYPfHEE/z3f/83q1at4plnnqFm0qRJvOc976HmV7/6Fb29vfT29tLb20tvby+PPPII+6xdu5bvfve7bNq0iXBgCSGEEEKdy+VL5PIlcvkSuXyJXL5ELl8ily+Ry5fI5Uvk8iVy+RK5fIlcvkQuXyKXL5HLl8jlS+TyJXL5Erl8iVy+RC5fIpcvkcuXyOVL5PIlcvkSuXyJXL5ELl8ily+Ry5fI5Uvk8iVy+RK5fIlcvkQuXyKXL5HLl9jfI488wlvf+lZWr17NrbfeykknncSuXbt48MEHmT17NjX3338/K1asYMWKFaxYsYJzzjmHVatWUTN79mwWL17Mj3/8Y8466yxuu+02wl9KCCGEEMJhc//993Pqqady7bXXsmLFCr70pS/xP//zP+xv3rx5LF++nOXLlzNx4kTe9a538eEPf5hVq1axefNm+vr6uOaaa+jr66Ozs5O9e/cS/lxCCCGEUOeymRTZTIpsJkU2kyKbSZHNpMhmUmQzKbKZFNlMimwmRTaTIptJkc2kyGZSZDMpspkU2UyKbCZFNpMim0mRzaTIZlJkMymymRTZTIpsJkU2kyKbSZHNpMhmUmQzKbKZFNlMimwmRTaTIptJkc2kyGZSZDMp9vf2t7+dRx55hGOPPZb3vve9jBs3jkmTJnEg1157LQ888ABLly6lpre3l23btjF79mxmz56NJHbu3MnmzZsJfy4hhBBCCIfNcccdx+DgID/60Y9405vexPz587n11lt5tu9///tcd911fPe736WhoYGal7/85UyfPp2bbrqJm266iZtuuont27dz3HHHEf5cQgghhBAOm6uvvpp/+7d/441vfCMf/ehHmTFjBuVymf395Cc/4ZJLLuEHP/gBxx57LPu8/e1vZ82aNSRJwitf+UrK5TKnnHIKSZIQ/lxCCCGEEA6bSy+9lHvvvZczzjiDt73tbfz6179m4cKF7O/qq6/md7/7Haeffjrjx49n/PjxnHfeeZxxxhksWrSIk08+mXe+8528853v5KabbmLMmDGEP5cQQgghhMPmla98JQMDA/zoRz/iRz/6Effccw+vfOUrmTlzJk888QQ13//+96lWq1QqFXbu3MnOnTu5/fbbqbn88svZvHkzPT09bN68mVmzZhH+UkIIIYQQDruGhgZe9rKX8ddIkoRx48YRDi4hhBBCCGGYSQghhBBCGGYSQgghhDrT39+PbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2trGNbWxjG9vYxja2sY1tbGMb29jGNraxjW1sYxvb2MY2tunv72e0SwghhBDqiCRaW1sJB9fa2ookRrOEEEIIoc5IQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIQhKSkIQkJCEJSUhCEpKQhCQkIQlJSEISkpCEJCQhCUlIYrRLCCGEEEIYZhJCCCGEMCIte2ArHxl8NX8a90pGmoQQQgghjCjlSpVcvkTuzhIfnFRmzK7fMdIkhBBCCGHEKFeqpLsL1JS62jhhYgMjUUIIIYQQhr1ypUouXyLdXWDB1ElkMylGsoQQQgghDGvlSpWOnkHWbNhBX2cL2UyKkS5hBCkWi/T29lIul3kulUqFgYEBBgYGGBgYYGBggJ07dxJCCCEMN7l8iXR3gemTJ9K3qIXmxgZGg4QR4stf/jKSuOuuu7j44otZsmQJB7Ny5Urmz5/PwoULWbhwIQsXLuTnP/85IYQQwnBRrlTJ5UssG9hKX2cL2UyK0SRhBHj00Uf5+te/zre//W0++9nPcuutt3LddddRqVQ4kIcffpiuri4KhQKFQoFCocDpp59OCCGEMByUK1XS3QVqSl1tNDc2MNokjACTJ09m5cqVTJgwgZqxY8eyZ88edu/ezYEMDg4yefJkKpUKu3fv5vmsXLmSK664giuuuIIrrriC/v5+QgghhJdauVIlly+R7i6QPTtFNpPi2fr7+7niiiu44ooruOKKK+jv72ckShgBkiThta99LXv27OG2225j/vz5fOADH+C4447j2fbs2cOvf/1rPvWpTzFr1ixOPfVUFi9ezHNpbW1l2rRpTJs2jWnTptHU1EQIIYTwUipXqnT0DFLeUaXU1caCt0ziQJqampg2bRrTpk1j2rRpjFQJI0ilUuHpp5/mVa96FWvXruXJJ5/k2bZv387MmTP56le/yn333UdfXx/33HMPt956KwfT1NREe3s77e3ttLe309TURAghhPBSyeVLpLsLTJ88kaXnn8RzaWpqor29nfb2dtrb22ltbWUkShhBjj32WC644AJuuukmGhoaWL58Oc92/PHHc/3113P88cdTc9xxx3HWWWfx4IMPEkIIIdSTcqVKLl9i2cBW+jpbyGZShP+VMAJs3LiRb37zm+zv1a9+Ndu2bePZNm3axO23387+nnnmGY466ihCCCGEelGuVOnoGaSm1NVGc2MD4f9KGAH27NnDZz/7WTZu3EjNb3/7W+69917OOussatatW8fWrVupqVarZLNZHnvsMWq2b9/OXXfdxbnnnksIIYQw1MqVKrl8iXR3gWwmRTaTIvylhBHgda97HYsXL2b27NlcdNFFzJw5kwsuuIAZM2ZQc+2117J27VpqpkyZQldXF+9+97uZP38+73jHO7j44os5/fTTCSGEEIZSuVIl3V2gptTVxvTJEwkHljBCzJkzh4ceeoibb76Zhx56iEsuuYR9li5dynnnncc+c+fOpVAosHz5cgqFAh0dHYQQQghDKZcvke4usGDqJLKZFOG5JYQQQghhyJQrVXL5EssGttLX2UI2kyI8v4QQQgghDIlypUpHzyA1pa42mhsbCIcmIYQQQggvqXKlSi5fIt1dIJtJkc2kCC9MQgghhBBeMuVKlXR3gZpSVxvTJ08kvHAJIYQQQnhJ5PIl0t0FFkydRDaTIvz1EkIIIYRwRJUrVXL5EssGttLX2UI2kyK8OAkhhBBCOGLWbNhBR88gNaWuNpobGwgvXkIIIYQQDrtypUouX6KjZz1Lzz+ZbCZFOHwSQgghhHBYlStV0t0FakpdbTQ3NhAOr4QQQgghHDa5fIl0d4EFUyeRzaQIR0ZCCCGEEF60cqVKLl9i2cBW+jpbyGZShCMnIYQQQggvypoNO+joGaSm1NVGc2MD4chKCCGEEMJfpVypksuX6OhZz9LzTyabSRFeGgkhhBBCeMHKlSrp7gI1pa42mhsbCC+dhBBCCCG8ILl8iXR3gQVTJ5HNpAgvvYQQQgghHJJypUpHz3rWbNhBX2cL2UyKMDQSQgghhPC81mzYQUfPIM0TG+hb1EJzYwNh6CSEEEII4aDKlSq5fImOnvUsPf9kspkUYeglhBBCCOGAypUq6e4CNaWuNpobGwj1ISGEEEIIf6ZcqZLLl0h3F1gwdRLZTIpQXxJCCCGE8P8rV6p09AyyZsMO+jpbyGZShPqTEEIIIYT/Ty5fIt1dYPrkifQtaqG5sYFQnxJCCCGEUa5cqZLLl1g2sJW+zhaymRShviWEEEIIo1i5UiXdXaCm1NVGc2MDof4lhBBCCKNQuVIlly+R7i6QPTtFNpMiDB8JIYQQwihTrlTp6BlkzYYd9HW2sOAtkwjDS0IIIYQwiuTyJdLdBaZPnkjfohaaGxsIw09CCCGEMAqUK1Vy+RLLBrbS19lCNpMiDF8JIYQQwghXrlTp6BmkptTVRnNjA2F4SwghhBBGqHKlSi5fIt1dIJtJkc2kCCNDQgghhDAClStV0t0FyjuqlLramD55ImHkSAghhBBGmFy+RLq7wIKpk1h6/kmEkSdhlCoWi/T29lIulwkhhDAylCtVcvkSywa20tfZQjaTIoxMCaPQl7/8ZSRx1113cfHFF7NkyRJCCCEMb+VKlY6eQWpKXW00NzYQRq6EUebRRx/l61//Ot/+9rf57Gc/y6233sp1111HpVIhhBDC8FOuVMnlS6S7C2QzKbKZFGHkSxhlJk+ezMqVK5kwYQI1Y8eOZc+ePezevZuDWblyJfPmzWPevHnMmzeP/v5+QgghDL1ypUq6u0BNqauN6ZMnMtr19/czb9485s2bx7x581i5ciUjUcIokyQJr33ta9mzZw+33XYb8+fP5wMf+ADHHXccB9Pa2ookJCGJpqYmQgghDK1cvkS6u8CCqZPIZlKE/9XU1IQkJCGJ1tZWRqKEUapSqfD000/zqle9irVr1/Lkk09yME1NTbS2ttLa2kpraytNTU2EEEIYGuVKlVy+xLKBrfR1tpDNpAj/V1NTE62trbS2ttLa2kpTUxMjUcIodeyxx3LBBRdw00030dDQwPLlywkhhFDf1mzYQUfPIDWlrjaaGxsIo1PCKLNx40a++c1vsr9Xv/rVbNu2jRBCCPWpXKmSy5fo6FlPNpMim0kRRreEUWbPnj189rOfZePGjdT89re/5d577+Wss84ihBBC/SlXqqS7C9SUutqYPnkiISSMMq973etYvHgxs2fP5qKLLmLmzJlccMEFzJgxgxBCCPUlly+R7i6wYOokspkUIeyTMArNmTOHhx56iJtvvpmHHnqISy65hBBCCPWjXKmSy5dYNrCVvs4WspkUIewvIYQQQqgjazbsoKNnkJpSVxvNjQ2E8GwJIYQQQh0oV6rk8iU6etaz9PyTyWZShHAwCSGEEMIQK1eqpLsL1JS62mhubCCE55IQQgghDKFcvkS6u8CCqZPIZlKEcCgSQgghhCFQrlTp6FnPsoGt9HW2kM2kCOFQJYQQQggvsTUbdtDRM0jzxAZKXW00NzYQwguREEIIIbxEypUquXyJjp71LD3/ZLKZFCH8NRJCCCGEl0C5UiXdXaCm1NVGc2MDIfy1EkIIIYQjqFypksuXSHcXWDB1EtlMihBerIQQQgjhCClXqnT0DLJmww76OlvIZlKEcDgkhBBCCEfAsge2ku4uMH3yRPoWtdDc2EAIh0tCCCGEcBiVK1Vy+RK5O0v0dbaQzaQI4XBLCCGEEA6TcqVKurtATamrjebGBkI4EhJCCCGEF6lcqZLLl0h3F1gwdRLZTIoQjqSEEEII4UUoV6p09AyyZsMO+jpbyGZShHCkJYQQQgh/pVy+RLq7wPTJE+lb1EJzYwMhvBQSQgghhBeoXKmSy5dYNrCVvs4WspkUIbyUEkIIIYQXoFyp0tEzSE2pq43mxgZCeKklhBBCCIegXKmSy5dIdxfIZlJkMylCGCoJdWLXrl1s3LiRX/ziF6xbt47HHnuMJ598khBCCEOvXKnS0TNIeUeVUlcb0ydPJIShlDDE7rvvPtLpNG9605t4xzvewfve9z46Ojr4p3/6J6ZNm0ZbWxvf/OY3CSGEMDRy+RLp7gLTJ09k6fknEUI9SBgilUqFM844g8svv5yFCxeydu1a1q9fz7p16ygUChSLRX7yk5/w6U9/mmXLlnHqqady7733EkII4aVRrlTJ5UssG9hKX2cL2UyKEOpFwhA577zz+PrXv84999zDnDlzOOaYY0iShP01NjYyY8YMent76e3t5ZprrmHnzp2EEEI4ssqVKh09g9SUutpobmwghHqSMERWr17N6173Og7Vsccey3e+8x3Gjx9PCCGEI6NcqZLLl0h3F8hmUmQzKUKoRwkhhBDC/6tcqZLuLlBT6mpj+uSJhFCvEurEqlWr2LJlCzXXXXcdU6dOZcaMGYQQQjjycvkS6e4CC6ZOIptJEUK9S6gD1113Hf/+7//O73//e5544gluvPFGLrjgAl796ldzxhlnEEII4cgoV6rk8iWWDWylr7OFbCZFCMNBQh249dZbuf3225kyZQpf+9rX+Ju/+Rs++MEPcsstt/Cb3/yGP/7xj4QQQji8ypUqHT2D1JS62mhubCCE4SKhDvzxj38klUpRs2rVKl7/+tezz8te9jJ2795NCCGEw6NcqZLLl0h3F8hmUmQzKUIYbhLqwPjx43nwwQd58skn+c1vfkM2m6Wmv7+fZ555hvHjxxNCCOHFK1eqpLsL1JS62pg+eSIhDEcJdSCXy7Fw4UKmTZvG6173Ov7u7/6O//qv/2LevHlceOGFhBBCePFy+RLp7gILpk4im0kRwnCWUAdmzJjB/fffT29vL9///vepmTVrFr29vVx++eWEEEL465UrVXL5EssGttLX2UI2kyKE4S6hTowfP56VK1dyzjnn8LOf/YxyucwTTzzBC/HYY4/R29tLoVDguVQqFQYGBhgYGGBgYICBgQF27txJCCGMNGs27KCjZ5CaUlcbzY0NhDASJNSBXbt2cdJJJ3HbbbexYcMGajZv3sycOXO44YYbOBSf/vSnWbhwIfl8nlwux9y5c3n66ac5kJUrVzJ//nwWLlzIwoULWbhwIT//+c8JIYSRolypksuX6OhZz9LzTyabSRHCSJJQB2bPns3FF1/M2rVrOfHEE6mZMWMGN998MzfeeCPPZ/369dx222185zvf4Qtf+ALf+973+P3vf88dd9zBgTz88MN0dXVRKBQoFAoUCgVOP/10QghhJChXqqS7C9SUutpobmwghJEmoQ5s27aN97///Tzb6aefzlFHHcXOnTt5LhMmTGDJkiVMmDCBfVKpFFu2bOFABgcHmTx5MpVKhd27d/N8Vq5cyYwZM5gxYwYzZsxg5cqVhBBCPcrlS6S7CyyYOolsJkUYffr7+5kxYwYzZsxgxowZ3HDDDYxECXVgzJgx/PGPf+TZ9u7dyzPPPMOYMWN4LpMmTaKtrY19Nm3aRF9fH2eddRbPtmfPHn7961/zqU99ilmzZnHqqaeyePFinktraysrVqxgxYoVrFixgvb2dkIIoZ6UK1Vy+RLLBrbS19lCNpMijE5NTU2sWLGCFStWsGLFCi677DJGooQ6MGvWLM4991wqlQr77Nq1i/e97300NTUxbtw4DtX27dtZsGABixYt4qSTTuLZtm/fzsyZM/nqV7/KfffdR19fH/fccw+33norB9PU1ERTUxNNTU00NTURQgj1ZM2GHXT0DFJT6mqjubGBMHo1NTXR1NREU1MTTU1NjFQJdeCqq67i9a9/PaeddhqPPPIIHR0dvOlNb2JwcJB8PmYryccAACAASURBVM+h+sUvfkF7ezsXXHABnZ2dHMjxxx/P9ddfz/HHH0/Ncccdx1lnncWDDz5ICCEMJ+VKlVy+REfPepaefzLZTIoQRouEOrF8+XLWrFnD7bffzvLly7nzzjt56KGHGDt2LIfivvvu48ILL+Sqq66io6ODg9m0aRO33347+3vmmWc46qijCCGE4aJcqZLuLlBT6mqjubGBEEaThDowa9Ystm7dyqRJk3jDG97AqaeeygknnMDOnTs5+eSTefrpp3kujz/+OJdddhmf//znSafT7N69m927d7Nnzx5q1q1bx9atW6mpVqtks1kee+wxarZv385dd93FueeeSwghDAe5fIl0d4EFUyeRzaQIYTRKGCL9/f3MnTuXuXPn8uijj/KRj3yEuXPnMnfuXObOncvcuXOZP38+e/bsYcyYMTyXW265haeeeopLL72UU045hVNOOYVTTjmFq6++mpprr72WtWvXUjNlyhS6urp497vfzfz583nHO97BxRdfzOmnn04IIdSzcqVKR8961mzYQV9nC9lMihBGq4Qh0traSrVaZdu2bdRs27aNbdu2sW3bNrZt28a2bdt46qmnuOKKKzjqqKN4LpdffjnFYpFisUixWKRYLFIsFrnyyiupWbp0Keeddx77zJ07l0KhwPLlyykUCnR0dBBCCPVs2QNb6egZpHliA32LWmhubCCE0SxhCH3nO99h9erVTJs2jW9961usXr2a1atXs3r1alavXs2dd95JR0cHIYQwWpUrVXL5Erk7Syw9/2SymRQhBEioA5s2beLcc8/li1/8Ijt37iSEEAKUK1XS3QVqSl1tNDc2EEL4Xwl1oLe3l2w2yx133MFb3vIWZsyYQW9vLyGEMBqVK1Vy+RLp7gILpk4im0kRQvhzCXVg7NixnHvuudx999385Cc/4ZxzzuHKK69kypQpzJ07ly1bthBCCKNBuVKlo2eQNRt20NfZQjaTIoTwlxLqTGNjI/PmzeOcc85hzJgxPPjgg8yc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117j3//934lEIjz88MN0dHSwaNEivv/973MmJkyYQG1tLc888wy/+MUvuPPOOxGR0hQgInKG+vv72b59O9u3b6ezs5MNGzYwf/58PvOZz/C3f/u3TJs2jY9//OMsX76co0ePUtTR0UFTUxODg4O8n9///vf8/d//Pbt27aLoxIkTvP7661x77bW8m1AoxIEDBzhy5Agn3XnnnWzZsoVcLkd9fT0iUpoCRETO0PPPP09TUxNNTU185Stf4Uc/+hF33nknra2thEIhgiCgtbWVfD5PTU0Nn/3sZ/na177GN77xDW677TbeT21tLYsXL+buu+/ms5/9LDfccAMDAwN897vf5d3cdttt7Nixg7/4i7/gpL/+67/md7/7HbNmzWLUqFGISGkKEBE5A11dXfT29tLb20tvby89PT0888wz3HfffVx22WWc9PGPf5wf//jH/OY3vyGZTJJOp/nSl77ESb29vUyfPp1T9fb2Mn36dIqWLFnCSy+9RDKZJJVKsXnzZsaPH89Jvb29TJ8+naI5c+bw8ssv85vf/IaTgiAgFArx+c9/HhEpXQEiIufAxRdfzLhx4wiCgA8qCALGjRvHqFGjeD9BEBAKhThy5Aj5fJ6VK1dy1VVXMWXKFESkdAWIiJSIm2++mZ/85Cd885vfRERKW4CISAm44oor+M1vfsOvfvUrpkyZgoiUtgARkRJx6aWXEgqFEJHSFyAiIiIywgSIiIiIjDD/A04XMlm00bnKAAAAAElFTkSuQmCC" style="width: 100%; height: auto;"></div></div></div></div></div></div></div><div class = 'S8'><span>Isn't it obvious now that the smaller the density the better?! Indeed, for two Faust objects of the same shape and the same number of factors, a smaller density (linearly) implies a smaller file size for storage. This point applies also to the memory (RAM) space to work on a Faust.</span></div><div class = 'S0'><span>We'll see later how the computation can benefit of a bigger RCG (or smaller density). But let's point out right now that the sparsity is often a tradeoff with accuracy, as the following plot shows about the truncated SVD of a matrix </span><span style="vertical-align:-5px"><img src="data:image/png;base64,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" width="85" height="19" /></span><span>. Note beforehand that the SVD of M (truncated or not) can be seen as a Faust which approximates M.</span></div><div class = 'S0'><span></span></div><div class = 'S0'><img src = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAoAAAAHgCAYAAAA10dzkAABILUlEQVR42u2dCXgV5dm/i2EVBFGw4EJitUDUfgha1KpBXEDcxX5qtUi1oqBAUKriUsF+4FpF60e1Iu4iVYl1LWpVoLJpBVzKvi/ijp8bi+Lz7+9t3/znTGbOkgRykrnv65oryck5c2Z55n3uebf5gQEAAABAovgBhwAAAAAAAQQAAAAABBAAAAAAEEAAAAAAQAABAAAAAAEEAAAAAAQQAAAAABBAAAAAAEAAAQAAAAABBAAAAAAEEAAAAAAQQAAAAABAAAEAAAAAAQQAAABAAO+//377wQ9+UL4UFBRYmzZt7IwzzrBFixZV+guGDx/u1lcZnn/+eff5KAoLC61v377b/IB169Yt5TgFF21TUgnHT6NGjeyHP/yhHXHEEXb99dfbhx9+mD9B/6/tC8bVP//5T/f38uXLa2ybJkyYYPvss481btzYbd+cOXMiYz4u9oKLzkVt54477rCHH3642te7YcMGd4xuuOGGjO9VPFxwwQW29957u/PSsmVL+8lPfuJee//99917iouLbc8997Tvv/8+dj1dunSxtm3b2nfffWfz589POVf169e3nXfe2bp27WqXXnqp+3918te//tU6d+5s22+/vfs+/V3bOOigg6xnz55k6yx58MEH7c4778zpMz4uH3vssWqLOx/jces85JBD3P87dOiQ9XoPPfRQKy0trbDdUctTTz2V8tnXXnvNzjvvPHc9NGzY0L1n3bp1Fb5j3rx5NmTIENt///2tefPm7vo87LDDKqwvF6644orIbWzRokWF995888128sknW7t27dx74mL/z3/+s51++umu/FH5VFRUZH369LGlS5emvG/jxo22++6721133ZVZAPVzxowZ7mCNHDnSmjRpYrvssot99tln21wAL7744tjPzp4925YsWVIjAvijH/3IHaPwom1KugD6+Jk6dao9+eST7kJSkO+000728ssv58W2avtWr15d/vcTTzzhtl0xXxN89NFH1qBBAzvxxBNt8uTJbvu+/vrryJgPxtuvf/1rt92TJk1KeV3rq+3stddeWyXpZyuAy5Ytc8LXsWNH+9Of/mSvvvqqlZWV2f/8z/84CdRxFrfccotb3yuvvBK5nrffftv9f9iwYSkJa+jQoW4d06ZNs2effdauu+46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7if7xT6xT+wT54p9Yp8AAQQAAAAABBAAAAAAEEAAAAAAQAABAAAAEEDYhowZM8aKioqsUaNG1qVLF5s6dWra9z/55JNWXFxsDRs2dD/LyspS/v/999+7Drht27a1xo0bW7du3ey9997L232655577LDDDrMdd9zRLUcddZTNmjUr5T19+/atMCP8QQcdlLf7dP/990fOYr9hw4Yqnfua3i/FUtR+HXfccXlzrqZMmWInnHCCi39991NPPZXxM5MnT3b7rmOw55572l133VXl67Qm92nixIl29NFHW6tWrWyHHXawgw8+2CZNmpTyHpUR4fP0wx/+MG/36bXXXouMvfnz5+dUPubTPkVdK1r22WefvDlP119/vR144IHWrFkza926tZ188sm2YMGCjJ+rDXkKEMAaZcKECdagQQMbO3aszZs3z0pLS61p06a2cuXKyPdPnz7dCgoK3EWpgk8/69evbzNnzix/z4033ugKfSWBd99918444wx3kX3xxRd5uU9nnXWWS65z5sxx+3TuuedaixYtbM2aNSkF5bHHHmvr1q0rXz799NO8PU8SwObNm6dsr5aqrDMf9kvHPLg/KrAVj9rffDlXL7zwgl199dUu/rNJwsuWLbPtt9/e7buOgY6FjokSWL6cq1z3Sdt300032RtvvGGLFi2yK6+80m3/7NmzU8Ri3333TTlPH330Ud6eJy+ACxcuTNnm7777LqfyMZ/2SU+3CO6LnnSx0047uXOTL+epZ8+e7vrWtT537lw7/vjjrV27dvbVV1/FfqY25ClAAGucrl27Wv/+/VNe69ixow0bNizy/aeffrpLruEL9Mwzzyy/q2rTpo27uDwaii+huvvuu/Nyn8KoQFfB8OCDD6ZIhe48a8t5UoGpY741j1M+nKvRo0e7cxVMBjV9rlIKtiyS8OWXX+72OciFF17oas3y6Vzlsk9RqFbpuuuuSxGLTp061Zrz5AVw/fr1se/JVD7m+3nS++vVq2crVqzIy/MkJJ/aN9V2VvY85EOeAgSwRtm0aZO7SwpXjQ8ePNhKSkoiP7PHHnvYbbfdlvKa/tYdmVi6dKm7OIN3+uKkk06yc845Jy/3KYzuANUk8Oyzz6ZIhQoHNUH8+Mc/tvPPP98+/PDDvD1PEkB9Rudlt912c3fNwXNSHccpH87VfvvtZ/369Ut5rSbPVWWS8OGH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eOGF7veysjK3vq+//poTCQAIIABAdQjgT37yEzv++OPtxhtvtN12280WL15cYfn444/LBVBNxkFGjx7t+gN61JT8+uuv27XXXuvWrdo79e3LRQCfeeYZa9GihX3zzTeuSfr888/nJAIAAggAUB0C6AeB3HffffbSSy+5plf13YsjGwEMohpBSeWtt94auR3HHHOMDRw4MPJzu+66q/uc+hROnz6dkwgACCAAQK4CGDcNzAknnOCESzV3hx12mBO8SZMmORGcNm2aXX311W5QSDYCOHPmTLdevX/lypX2+OOPW8OGDe2FF16IFEANAPnpT3/qvku1jME5CTWwRJ/t2LEjJxAAEEAAgMoIYHAiaDXLaiJo1fwFpUuDOwYNGuRq3xo0aGB77LGHnX322bZq1aqsBHDevHnWs2dPt/5GjRpZ+/bt7c4770zZjqAALly40A4++GBr0qSJ27Zg7ePSpUvda+qbCACAAAIAJAD1I5SsfvDBBxwMAEAAAQDqMpqGRgNPNAn1WWedxQEBAAQQAKCuc//997upZ7p06eL6KwIAIIAAAAAAgAACAAAAAAIIAAAAAAggAAAAACCAAAAAAIAAAgAAAAACCAAAAAAIIAAAAAAggAAAAAAIIAAAAAAggAAAAACAAAIAAAAAAggAAAAACCAAAAAAIIAAAAAAkBf8PwxregtdjfnYAAAAAElFTkSuQmCC" width = "524" height = "425" alt = "" style = "vertical-align: baseline"></img></div><div class = 'S0'><span>Here is the script to reproduce the last figure with pyfaust: </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/test_svd_rc_vs_err.py"><span>test_svd_rc_vs_err.py</span></a></div><div class = 'S0'><span></span></div><h3 class = 'S2' id = 'H_73387A87' ><span>2. Faust Algebra and other Operations</span></h3><div class = 'S0'><span></span></div><div class = 'S0'><span>In order to write some nice algorithms using Faust objects, you'll have to use the basic "stable" operations a Faust is capable of. Let's make a tour of them.</span></div><div class = 'S0'><span></span></div><h4 class = 'S12' id = 'H_5E556DD4' ><span>2.1 Transpose, conjugate, transconjugate</span></h4><div class = 'S0'><span></span></div><ul class = 'S3'><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a029a3db751ae1282eca2af94ce4101ec"><span>Faust.transpose</span></a><span> or </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a029a3db751ae1282eca2af94ce4101ec"><span>.'</span></a></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#aec9036a3d251fd47038a9a338b91502d"><span>Faust.conj</span></a><span>,</span></li><li class = 'S4'><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a66c1abdcbcfe8505457ce69a7b355716"><span>Faust.ctranspose</span></a><span> or </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#a66c1abdcbcfe8505457ce69a7b355716"><span>'</span></a></li></ul><div class = 'S0'><span>You are probably familiar with .' and ' shorthand operators from Matlab. Well, they are also used in the Faust class.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>G = matfaust.rand(10, 15, </span><span style="color: rgb(160, 32, 240);">'dim_sizes'</span><span>, [10,15], </span><span style="color: rgb(160, 32, 240);">'field'</span><span>, </span><span style="color: rgb(160, 32, 240);">'complex'</span><span>)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="AC55DEF9" data-testid="output_14" data-width="1172" data-height="104" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">G = </span></div><div>Faust size 10x15, density 2, nnz_sum 300, 5 factor(s): +- FACTOR 0 (complex) SPARSE, size 10x10, density 0.5, nnz 50 +- FACTOR 1 (complex) SPARSE, size 10x15, density 0.333333, nnz 50 +- FACTOR 2 (complex) SPARSE, size 15x14, density 0.357143, nnz 75 +- FACTOR 3 (complex) SPARSE, size 14x11, density 0.454545, nnz 70 +- FACTOR 4 (complex) SPARSE, size 11x15, density 0.333333, nnz 55</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>G.'</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="E84D10E7" data-testid="output_15" data-width="1172" data-height="104" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 15x10, density 2, nnz_sum 300, 5 factor(s): +- FACTOR 0 (complex) SPARSE, size 15x11, density 0.333333, nnz 55 +- FACTOR 1 (complex) SPARSE, size 11x14, density 0.454545, nnz 70 +- FACTOR 2 (complex) SPARSE, size 14x15, density 0.357143, nnz 75 +- FACTOR 3 (complex) SPARSE, size 15x10, density 0.333333, nnz 50 +- FACTOR 4 (complex) SPARSE, size 10x10, density 0.5, nnz 50</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>conj(G)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="A724B623" data-testid="output_16" data-width="1172" data-height="104" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x15, density 2, nnz_sum 300, 5 factor(s): +- FACTOR 0 (complex) SPARSE, size 10x10, density 0.5, nnz 50 +- FACTOR 1 (complex) SPARSE, size 10x15, density 0.333333, nnz 50 +- FACTOR 2 (complex) SPARSE, size 15x14, density 0.357143, nnz 75 +- FACTOR 3 (complex) SPARSE, size 14x11, density 0.454545, nnz 70 +- FACTOR 4 (complex) SPARSE, size 11x15, density 0.333333, nnz 55</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>G'</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="12FBB89A" data-testid="output_17" data-width="1172" data-height="104" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 15x10, density 2, nnz_sum 300, 5 factor(s): +- FACTOR 0 (complex) SPARSE, size 15x11, density 0.333333, nnz 55 +- FACTOR 1 (complex) SPARSE, size 11x14, density 0.454545, nnz 70 +- FACTOR 2 (complex) SPARSE, size 14x15, density 0.357143, nnz 75 +- FACTOR 3 (complex) SPARSE, size 15x10, density 0.333333, nnz 50 +- FACTOR 4 (complex) SPARSE, size 10x10, density 0.5, nnz 50</div></div></div></div></div></div><div class = 'S8'><span>What really matters here is that the results of G.', conj(G) and G' are all Faust objects. Behind the scene, there is just one memory zone allocated to the factors. Strictly speaking they are memory views shared between G, G.' and G'. So don't hesitate to use!</span></div><h4 class = 'S12' id = 'H_99DA98B4' ><span>2.2 Add, Subtract and Multiply</span></h4><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>s = size(G, 1);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>F = matfaust.rand(s, s);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>G = matfaust.rand(s, s, </span><span style="color: rgb(160, 32, 240);">'field'</span><span>, </span><span style="color: rgb(160, 32, 240);">'complex'</span><span>);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>F+G</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="7E0B4540" data-testid="output_18" data-width="1172" data-height="146" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 5.6, nnz_sum 560, 8 factor(s): - FACTOR 0 (complex) SPARSE, size 10x20, density 0.1, nnz 20 - FACTOR 1 (complex) SPARSE, size 20x20, density 0.25, nnz 100 - FACTOR 2 (complex) SPARSE, size 20x20, density 0.25, nnz 100 @@ -128,7 +137,7 @@ - FACTOR 4 (complex) SPARSE, size 20x20, density 0.25, nnz 100 - FACTOR 5 (complex) SPARSE, size 20x20, density 0.25, nnz 100 - FACTOR 6 (complex) SPARSE, size 20x20, density 0.05, nnz 20 -- FACTOR 7 (complex) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div></div><div class = 'S8'><span>Go ahead and verify it's accurate.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>norm(full(F+G)-(full(F)+full(G)), </span><span style="color: rgb(160, 32, 240);">'fro'</span><span>)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0</div></div></div></div><div class = 'S8'><span>Some points are noticeable here:</span></div><ul class = 'S3'><li class = 'S4'><span>F is real but G is complex. The Faust API is able to return the proper type for the resulting Faust, that is a complex Faust.</span></li><li class = 'S4'><span>F+G is composed of 8 factors, however F and G are both 5 factors long. It's due to the way the addition is implemented (Faust concatenation is hiding behind).</span></li></ul><div class = 'S0'><span>Subtracting is not different:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F-G</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="C29FC773" data-scroll-top="null" data-scroll-left="null" data-testid="output_18" data-width="926" data-height="146" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 5.6, nnz_sum 560, 8 factor(s): +- FACTOR 7 (complex) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div></div><div class = 'S8'><span>Go ahead and verify it's accurate.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>norm(full(F+G)-(full(F)+full(G)), </span><span style="color: rgb(160, 32, 240);">'fro'</span><span>)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0</div></div></div></div><div class = 'S8'><span>Some points are noticeable here:</span></div><ul class = 'S3'><li class = 'S4'><span>F is real but G is complex. The Faust API is able to return the proper type for the resulting Faust, that is a complex Faust.</span></li><li class = 'S4'><span>F+G is composed of 8 factors, however F and G are both 5 factors long. It's due to the way the addition is implemented (Faust concatenation is hiding behind).</span></li></ul><div class = 'S0'><span>Subtracting is not different:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F-G</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="D4A009EC" data-testid="output_20" data-width="1172" data-height="146" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 5.6, nnz_sum 560, 8 factor(s): - FACTOR 0 (complex) SPARSE, size 10x20, density 0.1, nnz 20 - FACTOR 1 (complex) SPARSE, size 20x20, density 0.25, nnz 100 - FACTOR 2 (complex) SPARSE, size 20x20, density 0.25, nnz 100 @@ -136,7 +145,7 @@ - FACTOR 4 (complex) SPARSE, size 20x20, density 0.25, nnz 100 - FACTOR 5 (complex) SPARSE, size 20x20, density 0.25, nnz 100 - FACTOR 6 (complex) SPARSE, size 20x20, density 0.05, nnz 20 -- FACTOR 7 (complex) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div></div><div class = 'S8'><span>You can also add/subtract scalars to Faust objects.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F+2</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="D9F87807" data-scroll-top="null" data-scroll-left="null" data-testid="output_19" data-width="926" data-height="146" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 3.6, nnz_sum 360, 8 factor(s): +- FACTOR 7 (complex) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div></div><div class = 'S8'><span>You can also add/subtract scalars to Faust objects.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F+2</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="14F2FB7F" data-testid="output_21" data-width="1172" data-height="146" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 3.6, nnz_sum 360, 8 factor(s): - FACTOR 0 (real) SPARSE, size 10x20, density 0.1, nnz 20 - FACTOR 1 (real) SPARSE, size 20x20, density 0.15, nnz 60 - FACTOR 2 (real) SPARSE, size 20x20, density 0.15, nnz 60 @@ -144,7 +153,7 @@ - FACTOR 4 (real) SPARSE, size 20x11, density 0.272727, nnz 60 - FACTOR 5 (real) SPARSE, size 11x20, density 0.272727, nnz 60 - FACTOR 6 (real) SPARSE, size 20x20, density 0.05, nnz 20 -- FACTOR 7 (real) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div></div><div class = 'S8'><span>Note that here again </span><span style=' font-family: monospace;'>numfactors(F+2) ~= numfactors(F)</span><span>.</span></div><div class = 'S0'><span>The FAµST API supports equally the Faust to array addition and subtraction.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F+full(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="B8F7A944" data-scroll-top="null" data-scroll-left="null" data-testid="output_20" data-width="926" data-height="146" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 4.5, nnz_sum 450, 8 factor(s): +- FACTOR 7 (real) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div></div><div class = 'S8'><span>Note that here again </span><span style=' font-family: monospace;'>numfactors(F+2) ~= numfactors(F)</span><span>.</span></div><div class = 'S0'><span>The FAµST API supports equally the Faust to array addition and subtraction.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F+full(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="2C5F3993" data-testid="output_22" data-width="1172" data-height="146" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 4.5, nnz_sum 450, 8 factor(s): - FACTOR 0 (real) SPARSE, size 10x20, density 0.1, nnz 20 - FACTOR 1 (real) SPARSE, size 20x20, density 0.15, nnz 60 - FACTOR 2 (real) SPARSE, size 20x20, density 0.15, nnz 60 @@ -152,7 +161,7 @@ - FACTOR 4 (real) SPARSE, size 20x20, density 0.15, nnz 60 - FACTOR 5 (real) SPARSE, size 20x20, density 0.375, nnz 150 - FACTOR 6 (real) SPARSE, size 20x20, density 0.05, nnz 20 -- FACTOR 7 (real) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>F-full(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="9AECB800" data-scroll-top="null" data-scroll-left="null" data-testid="output_21" data-width="926" data-height="146" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 4.5, nnz_sum 450, 8 factor(s): +- FACTOR 7 (real) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>F-full(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="BFD13945" data-testid="output_23" data-width="1172" data-height="146" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 4.5, nnz_sum 450, 8 factor(s): - FACTOR 0 (real) SPARSE, size 10x20, density 0.1, nnz 20 - FACTOR 1 (real) SPARSE, size 20x20, density 0.15, nnz 60 - FACTOR 2 (real) SPARSE, size 20x20, density 0.15, nnz 60 @@ -160,8 +169,8 @@ - FACTOR 4 (real) SPARSE, size 20x20, density 0.15, nnz 60 - FACTOR 5 (real) SPARSE, size 20x20, density 0.375, nnz 150 - FACTOR 6 (real) SPARSE, size 20x20, density 0.05, nnz 20 -- FACTOR 7 (real) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>all(all(full(F-full(F)) < eps))</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="E4420FE8" data-scroll-top="null" data-scroll-left="null" data-testid="output_22" data-width="926" data-height="34" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 1 -</div></div></div></div></div></div><div class = 'S8'><span>Now let's multiply these Fausts!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>FG = F*G</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="E58E2DE6" data-scroll-top="null" data-scroll-left="null" data-testid="output_23" data-width="926" data-height="174" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">FG = </span></div><div>Faust size 10x10, density 5, nnz_sum 500, 10 factor(s): +- FACTOR 7 (real) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>all(all(full(F-full(F)) < eps))</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="8C11953E" data-testid="output_24" data-width="1172" data-height="34" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 1 +</div></div></div></div></div></div><div class = 'S8'><span>Now let's multiply these Fausts!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>FG = F*G</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="6F48C590" data-testid="output_25" data-width="1172" data-height="174" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">FG = </span></div><div>Faust size 10x10, density 5, nnz_sum 500, 10 factor(s): - FACTOR 0 (complex) SPARSE, size 10x10, density 0.5, nnz 50 - FACTOR 1 (complex) SPARSE, size 10x10, density 0.5, nnz 50 - FACTOR 2 (complex) SPARSE, size 10x10, density 0.5, nnz 50 @@ -171,134 +180,129 @@ - FACTOR 6 (complex) SPARSE, size 10x10, density 0.5, nnz 50 - FACTOR 7 (complex) SPARSE, size 10x10, density 0.5, nnz 50 - FACTOR 8 (complex) SPARSE, size 10x10, density 0.5, nnz 50 -- FACTOR 9 (complex) SPARSE, size 10x10, density 0.5, nnz 50</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(full(FG)-full(F)*full(G))/norm(full(F)*full(G))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 9.0371e-17</div></div></div></div><div class = 'S8'><span>Faust scalar multiplication is also available and here again the result is a Faust object!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F*2</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="A81640D3" data-scroll-top="null" data-scroll-left="null" data-testid="output_25" data-width="926" data-height="104" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 2.5, nnz_sum 250, 5 factor(s): +- FACTOR 9 (complex) SPARSE, size 10x10, density 0.5, nnz 50</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(full(FG)-full(F)*full(G))/norm(full(F)*full(G))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 9.0087e-17</div></div></div></div><div class = 'S8'><span>Faust scalar multiplication is also available and here again the result is a Faust object!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F*2</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="660C3353" data-testid="output_27" data-width="1172" data-height="104" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 2.5, nnz_sum 250, 5 factor(s): - FACTOR 0 (real) SPARSE, size 10x10, density 0.5, nnz 50 - FACTOR 1 (real) SPARSE, size 10x10, density 0.5, nnz 50 - FACTOR 2 (real) SPARSE, size 10x10, density 0.5, nnz 50 - FACTOR 3 (real) SPARSE, size 10x10, density 0.5, nnz 50 -- FACTOR 4 (real) SPARSE, size 10x10, density 0.5, nnz 50</div></div></div></div></div></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S13'></div></div></div><h4 class = 'S12'><span>2.3 Faust Multiplication by a Vector or a Matrix</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>When you multiply a Faust by a vector or a matrix (the number of nrows must match the number of Faust columns), you'll get respectively a vector or a matrix as result.</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>vec = rand(size(F, 2), 1);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>F*vec</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="4F797A9E" data-scroll-top="null" data-scroll-left="null" data-testid="output_26" data-width="926" style="width: 956px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 926px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">10×1</span></div><div class="valueContainer" data-layout="{"columnWidth":73,"totalColumns":1,"totalRows":10,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 75px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 51.3618 - 56.8713 - 22.0841 - 32.4884 - 88.5154 - 47.7793 - 32.8079 - 56.8013 - 37.8312 - 51.6433 -</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div></div><div class = 'S8'><span>Let's launch a timer to compare the execution times of Faust-vector multiplication and Faust's dense matrix-vector multiplication.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F_times_vec = @() F*vec</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="4DCA0829" data-scroll-top="null" data-scroll-left="null" data-testid="output_27" data-width="926" data-height="34" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">F_times_vec = <span class="headerElement">function_handle with value:</span></span></div><div> @()F*vec -</div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'><span style="white-space: pre;"><span>FD = full(F);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>FD_times_vec = @() FD*vec</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="B27D8619" data-scroll-top="null" data-scroll-left="null" data-testid="output_28" data-width="926" data-height="34" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">FD_times_vec = <span class="headerElement">function_handle with value:</span></span></div><div> @()FD*vec -</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(F_times_vec)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 2.0105e-05</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(FD_times_vec)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsWarningElement" uid="4630EE03" data-scroll-top="null" data-scroll-left="null" data-testid="output_30" data-width="926" data-height="18" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="diagnosticMessage-wrapper diagnosticMessage-warningType"><div class="diagnosticMessage-messagePart">Warning: The measured time for F may be inaccurate because it is running too fast. Try measuring something that takes longer.</div><div class="diagnosticMessage-stackPart"></div></div></div><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 2.0919e-07</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>all(all(F*vec-FD*vec < 1e-7))</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="F0AC2975" data-scroll-top="null" data-scroll-left="null" data-testid="output_32" data-width="926" data-height="34" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 1 -</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>rcg(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.4000</div></div></div></div><div class = 'S8'><span>When the RCG is lower than 1 the Faust-vector multiplication is slower. Making a random Faust with a large RCG (small density) shows better results.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>G = matfaust.rand(1024, 1024, </span><span style="color: rgb(160, 32, 240);">'num_factors'</span><span>, 3, </span><span style="color: rgb(160, 32, 240);">'density'</span><span>, .001, </span><span style="color: rgb(160, 32, 240);">'fac_type'</span><span>, </span><span style="color: rgb(160, 32, 240);">'sparse'</span><span>)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="4664C7A3" data-scroll-top="null" data-scroll-left="null" data-testid="output_34" data-width="926" data-height="76" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">G = </span></div><div>Faust size 1024x1024, density 0.00292969, nnz_sum 3072, 3 factor(s): -- FACTOR 0 (real) SPARSE, size 1024x1024, density 0.000976562, nnz 1024 -- FACTOR 1 (real) SPARSE, size 1024x1024, density 0.000976562, nnz 1024 -- FACTOR 2 (real) SPARSE, size 1024x1024, density 0.000976562, nnz 1024</div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'><span style="white-space: pre;"><span>GD = full(G);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>vec2 = rand(1024, 1);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>timeit(@() G*vec2)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 4.9490e-05</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(@() GD*vec2)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 6.7963e-04</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>rcg(G)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 341.3333</div></div></div></div><div class = 'S8'><span>It goes without saying that a big RCG gives a big speedup to the Faust-vector multiplication relatively to the corresponding (dense) matrix-vector multiplication. I hope the example above has finished to convince you.</span></div><div class = 'S0'><span>Just to convince you as well of the Faust-vector multiplication accuracy:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>norm(G*vec2 - GD*vec2)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 4.3060e-16</div></div></div></div><div class = 'S8'><span>What applies to Faust-vector multiplication remains valid about Faust-matrix multiplication. Take a look:</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>M = rand(1024,32);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>timeit(@() G*M)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 6.9088e-04</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(@() GD*M)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.0134</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(GD*M-G*M)/norm(GD*M)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 7.2196e-17</div></div></div></div><div class = 'S8'><span>Well, what do we see? A quicker Faust-matrix multiplication than the matrix-matrix corresponding multiplication, though a good accuracy of the Faust-matrix multiplication is also clearly confirmed.</span></div><div class = 'S0'><span>These examples are somehow theoretical because we cherry-pick the Faust to ensure that the RCG is good to accelerate the muplication, but at least it shows the potential speedup using Faust objects.</span></div><div class = 'S0'><span></span></div><h4 class = 'S12'><span>2.4 Faust Norms</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>The Faust class provides a norm function which handles different types of norms. This function is really close to Matlab </span><a href = "https://www.mathworks.com/help/matlab/ref/norm.htm"><span>norm</span></a><span> function.</span></div><div class = 'S0'><span>In the following example, three of the four norms available are computed.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>norm(F,1)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 204.5014</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(F, inf)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 219.4268</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(F, </span><span style="color: rgb(160, 32, 240);">'fro'</span><span>)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 142.4657</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(full(F), 1)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 204.5014</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(full(F), inf)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 219.4268</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(full(F), </span><span style="color: rgb(160, 32, 240);">'fro'</span><span>)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 142.4657</div></div></div></div><div class = 'S8'><span>Perfect! But a last norm is available, this is the Faust's 2-norm. Let's see in the next small benchmark how the Faust 2-norm is being computed faster than the Faust's dense matrix 2-norm.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>timeit(@() norm(G, 2))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 4.9805e-04</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(@() norm(GD, 2))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 2.2828</div></div></div></div><div class = 'S8'><span>The power-iteration algorithm implemented in the FAµ?ST C++ core is faster on G and the relative error is not bad too. The norm computation is faster as it benefits from faster Faust-vector multiplication.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>err = abs((norm(G, 2)-norm(GD,2))/norm(GD,2))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>err = 0.0012</div></div></div></div><div class = 'S8'><span></span></div><h4 class = 'S12'><span>2.5 Faust Normalizations</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>The FAµST API proposes a group of normalizations. They correspond to the norms available and discussed above.</span></div><div class = 'S0'><span>It's possible to normalize along columns or rows with any type of these norms.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F = matfaust.rand(5, 10)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="594C614F" data-scroll-top="null" data-scroll-left="null" data-testid="output_51" data-width="926" data-height="104" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">F = </span></div><div>Faust size 5x10, density 4, nnz_sum 200, 5 factor(s): -- FACTOR 0 (real) SPARSE, size 5x8, density 0.625, nnz 25 -- FACTOR 1 (real) SPARSE, size 8x9, density 0.555556, nnz 40 -- FACTOR 2 (real) SPARSE, size 9x10, density 0.5, nnz 45 -- FACTOR 3 (real) SPARSE, size 10x8, density 0.625, nnz 50 -- FACTOR 4 (real) SPARSE, size 8x10, density 0.5, nnz 40</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>NF = normalize(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="306E3EB9" data-scroll-top="null" data-scroll-left="null" data-testid="output_52" data-width="926" data-height="104" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">NF = </span></div><div>Faust size 5x10, density 4, nnz_sum 200, 5 factor(s): -- FACTOR 0 (real) SPARSE, size 5x8, density 0.625, nnz 25 -- FACTOR 1 (real) SPARSE, size 8x9, density 0.555556, nnz 40 -- FACTOR 2 (real) SPARSE, size 9x10, density 0.5, nnz 45 -- FACTOR 3 (real) SPARSE, size 10x8, density 0.625, nnz 50 -- FACTOR 4 (real) SPARSE, size 8x10, density 0.5, nnz 40</div></div></div></div></div></div><div class = 'S8'><span>The API doc is </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#abb16b52adc84eadc2835ae0542f75b90"><span>here</span></a><span>.</span></div><div class = 'S0'><span>What's interesting here is the fact that Faust.normalize returns a Faust object. Combined with slicing (that you will see soon), normalize is useful to write algorithms such as Orthonormal Matching Pursuit (OMP), which require matrices with L2-normalized columns, in a way that makes them able to leverage the acceleration offered by the FAµST API.</span></div><div class = 'S0'><span>The normalization coded in C++ is memory optimized (it never builds the dense matrix full(F) to compute the norms of the columns/rows). In the same goal the factors composing the Faust object NF are not duplicated in memory from same factors F, they're used as is with an additional factor giving the appropriate scaling.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>factors(NF, 5)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement scrollableOutput" uid="3173D7A8" data-scroll-top="null" data-scroll-left="null" data-testid="output_53" data-width="926" data-height="580" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div> (1,1) 0.0035 - (3,1) 0.0413 - (4,1) 0.0459 - (6,1) 0.0654 - (2,2) 0.0275 - (3,2) 0.0233 - (4,2) 0.0078 - (5,2) 0.0385 - (8,2) 0.0429 - (1,3) 0.0408 - (2,3) 0.0104 - (5,3) 0.0382 - (6,3) 0.0386 - (8,3) 0.0188 - (6,4) 0.0692 - (7,4) 0.0377 - (8,4) 0.0568 - (1,5) 0.0192 - (4,5) 0.0698 - (6,5) 0.0108 - (7,5) 0.0730 - (1,6) 0.0179 - (2,6) 0.0097 - (3,6) 0.0256 - (4,6) 0.0193 - (5,6) 0.0215 - (7,6) 0.0255 - (8,6) 0.0209 - (5,7) 0.1890 - (1,8) 0.1062 - (2,9) 0.0240 - (3,9) 0.0328 - (4,9) 0.0376 - (5,9) 0.0353 - (6,9) 0.0199 - (7,9) 0.0063 - (2,10) 0.0089 - (3,10) 0.0487 - (7,10) 0.0482 - (8,10) 0.0272 -</div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>cumerr = 0;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>fullF = full(F);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(0, 0, 255);">for </span><span>i=1:size(F,2)</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> normalized_col = fullF(:,i)/norm(fullF(:,i));</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> cumerr = cumerr + norm(NF(:,i) - normalized_col, </span><span style="color: rgb(160, 32, 240);">'fro'</span><span>);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(0, 0, 255);">end</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>cumerr</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>cumerr = 1.5405e-15</div></div></div></div><div class = 'S8'><span>And as you see it works!</span></div><div class = 'S0'><span></span></div><h4 class = 'S12'><span>2.6 Faust Concatenation</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>You're probably aware of Matlab arrays concatenation otherwise look this example.</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>M = rand(5,5);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>I = eye(5,5);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>[ M; I ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="090D4585" data-scroll-top="null" data-scroll-left="null" data-testid="output_55" data-width="926" style="width: 956px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 926px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">10×5</span></div><div class="valueContainer" data-layout="{"columnWidth":73,"totalColumns":5,"totalRows":10,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 367px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 0.4646 0.2921 0.8408 0.8864 0.8112 - 0.9722 0.1937 0.0800 0.1349 0.7004 - 0.9748 0.2559 0.1754 0.6393 0.7324 - 0.3829 0.6570 0.0191 0.6451 0.6932 - 0.6989 0.7678 0.1076 0.1505 0.2574 +- FACTOR 4 (real) SPARSE, size 10x10, density 0.5, nnz 50</div></div></div></div></div></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S13'></div></div></div><h4 class = 'S12' id = 'H_BD8A7C70' ><span>2.3 Faust Multiplication by a Vector or a Matrix</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>When you multiply a Faust by a vector or a matrix (the number of nrows must match the number of Faust columns), you'll get respectively a vector or a matrix as result.</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>vec = rand(size(F, 2), 1);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>F*vec</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="E32A5952" data-testid="output_28" data-width="1172" style="width: 1202px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 1172px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">10×1</span></div><div class="valueContainer" data-layout="{"columnWidth":66,"totalColumns":1,"totalRows":10,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 68px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 41.0501 + 49.2117 + 45.6702 + 55.8418 + 30.6538 + 39.0950 + 44.5995 + 52.0164 + 39.0722 + 25.9827 +</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div></div><div class = 'S8'><span>Let's launch a timer to compare the execution times of Faust-vector multiplication and Faust's dense matrix-vector multiplication.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F_times_vec = @() F*vec</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="DB9DDB2D" data-testid="output_29" data-width="1172" data-height="34" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">F_times_vec = <span class="headerElement">function_handle with value:</span></span></div><div> @()F*vec +</div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'><span style="white-space: pre;"><span>FD = full(F);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>FD_times_vec = @() FD*vec</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="6F9B4A04" data-testid="output_30" data-width="1172" data-height="34" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">FD_times_vec = <span class="headerElement">function_handle with value:</span></span></div><div> @()FD*vec +</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(F_times_vec)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 3.5931e-05</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(FD_times_vec)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsWarningElement" uid="440D990A" data-testid="output_32" data-width="1172" data-height="18" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="diagnosticMessage-wrapper diagnosticMessage-warningType"><div class="diagnosticMessage-messagePart">Warning: The measured time for F may be inaccurate because it is running too fast. Try measuring something that takes longer.</div><div class="diagnosticMessage-stackPart"></div></div></div><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 7.1565e-07</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>all(all(F*vec-FD*vec < 1e-7))</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="6E3CDBC9" data-testid="output_34" data-width="1172" data-height="34" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 1 +</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>rcg(F)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.4000</div></div></div></div><div class = 'S8'><span>When the RCG is lower than 1 the Faust-vector multiplication is slower. Making a random Faust with a large RCG (small density) shows better results.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>G = matfaust.rand(1024, 1024, </span><span style="color: rgb(160, 32, 240);">'num_factors'</span><span>, 3, </span><span style="color: rgb(160, 32, 240);">'density'</span><span>, .001, </span><span style="color: rgb(160, 32, 240);">'fac_type'</span><span>, </span><span style="color: rgb(160, 32, 240);">'sparse'</span><span>)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="BD7CF9EC" data-testid="output_36" data-width="1172" data-height="76" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">G = </span></div><div>Faust size 1024x1024, density 0.00292969, nnz_sum 3072, 3 factor(s): +- FACTOR 0 (real) SPARSE, size 1024x1024, density 0.000976563, nnz 1024 +- FACTOR 1 (real) SPARSE, size 1024x1024, density 0.000976563, nnz 1024 +- FACTOR 2 (real) SPARSE, size 1024x1024, density 0.000976563, nnz 1024</div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'><span style="white-space: pre;"><span>GD = full(G);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>vec2 = rand(1024, 1);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>timeit(@() G*vec2)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 6.9531e-05</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(@() GD*vec2)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.0016</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>rcg(G)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 341.3333</div></div></div></div><div class = 'S8'><span>It goes without saying that a big RCG gives a big speedup to the Faust-vector multiplication relatively to the corresponding (dense) matrix-vector multiplication. I hope the example above has finished to convince you.</span></div><div class = 'S0'><span>Just to convince you as well of the Faust-vector multiplication accuracy:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>norm(G*vec2 - GD*vec2)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 4.5356e-16</div></div></div></div><div class = 'S8'><span>What applies to Faust-vector multiplication remains valid about Faust-matrix multiplication. Take a look:</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>M = rand(1024,32);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>timeit(@() G*M)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.0038</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(@() GD*M)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.0129</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(GD*M-G*M)/norm(GD*M)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 6.6552e-17</div></div></div></div><div class = 'S8'><span>Well, what do we see? A quicker Faust-matrix multiplication than the matrix-matrix corresponding multiplication, though a good accuracy of the Faust-matrix multiplication is also clearly confirmed.</span></div><div class = 'S0'><span>These examples are somehow theoretical because we cherry-pick the Faust to ensure that the RCG is good to accelerate the muplication, but at least it shows the potential speedup using Faust objects.</span></div><div class = 'S0'><span></span></div><h4 class = 'S12' id = 'H_7AF16EFF' ><span>2.4 Faust Norms</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>The Faust class provides a norm function which handles different types of norms. This function is really close to Matlab </span><a href = "https://www.mathworks.com/help/matlab/ref/norm.htm"><span>norm</span></a><span> function.</span></div><div class = 'S0'><span>In the following example, three of the four norms available are computed.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>norm(F,1)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 193.4601</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(F, inf)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 146.0016</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(F, </span><span style="color: rgb(160, 32, 240);">'fro'</span><span>)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 123.8180</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(full(F), 1)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 193.4601</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(full(F), inf)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 146.0016</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>norm(full(F), </span><span style="color: rgb(160, 32, 240);">'fro'</span><span>)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 123.8180</div></div></div></div><div class = 'S8'><span>Perfect! But a last norm is available, this is the Faust's 2-norm. Let's see in the next small benchmark how the Faust 2-norm is being computed faster than the Faust's dense matrix 2-norm.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>timeit(@() norm(G, 2))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.0021</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(@() norm(GD, 2))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 1.5850</div></div></div></div><div class = 'S8'><span>The power-iteration algorithm implemented in the FAµ?ST C++ core is faster on G and the relative error is not bad too. The norm computation is faster as it benefits from faster Faust-vector multiplication.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>err = abs((norm(G, 2)-norm(GD,2))/norm(GD,2))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>err = 0.0034</div></div></div></div><div class = 'S8'><span></span></div><h4 class = 'S12' id = 'H_1070C649' ><span>2.5 Faust Normalizations</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>The FAµST API proposes a group of normalizations. They correspond to the norms available and discussed above.</span></div><div class = 'S0'><span>It's possible to normalize along columns or rows with any type of these norms.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F = matfaust.rand(5, 10)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="941A9DF5" data-testid="output_53" data-width="1172" data-height="104" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">F = </span></div><div>Faust size 5x10, density 3.1, nnz_sum 155, 5 factor(s): +- FACTOR 0 (real) SPARSE, size 5x6, density 0.666667, nnz 20 +- FACTOR 1 (real) SPARSE, size 6x5, density 1, nnz 30 +- FACTOR 2 (real) SPARSE, size 5x9, density 0.555556, nnz 25 +- FACTOR 3 (real) SPARSE, size 9x7, density 0.714286, nnz 45 +- FACTOR 4 (real) SPARSE, size 7x10, density 0.5, nnz 35</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>NF = normalize(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="BA562C8A" data-testid="output_54" data-width="1172" data-height="104" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">NF = </span></div><div>Faust size 5x10, density 3.1, nnz_sum 155, 5 factor(s): +- FACTOR 0 (real) SPARSE, size 5x6, density 0.666667, nnz 20 +- FACTOR 1 (real) SPARSE, size 6x5, density 1, nnz 30 +- FACTOR 2 (real) SPARSE, size 5x9, density 0.555556, nnz 25 +- FACTOR 3 (real) SPARSE, size 9x7, density 0.714286, nnz 45 +- FACTOR 4 (real) SPARSE, size 7x10, density 0.5, nnz 35</div></div></div></div></div></div><div class = 'S8'><span>The API doc is </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classmatfaust_1_1Faust.html#abb16b52adc84eadc2835ae0542f75b90"><span>here</span></a><span>.</span></div><div class = 'S0'><span>What's interesting here is the fact that Faust.normalize returns a Faust object. Combined with slicing (that you will see soon), normalize is useful to write algorithms such as Orthonormal Matching Pursuit (OMP), which require matrices with L2-normalized columns, in a way that makes them able to leverage the acceleration offered by the FAµST API.</span></div><div class = 'S0'><span>The normalization coded in C++ is memory optimized (it never builds the dense matrix full(F) to compute the norms of the columns/rows). In the same goal the factors composing the Faust object NF are not duplicated in memory from same factors F, they're used as is with an additional factor giving the appropriate scaling.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>factors(NF, 5)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement scrollableOutput" uid="25AC5892" data-testid="output_55" data-width="1172" data-height="510" data-hashorizontaloverflow="false" data-scroll-top="174" data-scroll-left="0" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div> (2,1) 0.0110 + (4,1) 0.0137 + (5,1) 0.0326 + (7,1) 0.0454 + (1,2) 0.0144 + (2,2) 0.0126 + (3,2) 0.0399 + (5,2) 0.0317 + (6,2) 0.0429 + (1,3) 0.0278 + (2,3) 0.0037 + (4,3) 0.1015 + (3,4) 0.0710 + (5,4) 0.0461 + (3,5) 0.0745 + (5,5) 0.0229 + (6,5) 0.0371 + (4,6) 0.1228 + (2,7) 0.0190 + (3,7) 0.0317 + (6,7) 0.0302 + (7,7) 0.0329 + (1,8) 0.0869 + (7,8) 0.0543 + (1,9) 0.0014 + (2,9) 0.0292 + (3,9) 0.0036 + (4,9) 0.0237 + (5,9) 0.0252 + (6,9) 0.0051 + (7,9) 0.0179 + (1,10) 0.0555 + (4,10) 0.0715 + (6,10) 0.0124 + (7,10) 0.0101 +</div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>cumerr = 0;</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>fullF = full(F);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(0, 0, 255);">for </span><span>i=1:size(F,2)</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> normalized_col = fullF(:,i)/norm(fullF(:,i));</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span> cumerr = cumerr + norm(NF(:,i) - normalized_col, </span><span style="color: rgb(160, 32, 240);">'fro'</span><span>);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(0, 0, 255);">end</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>cumerr</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>cumerr = 1.8195e-15</div></div></div></div><div class = 'S8'><span>And as you see it works!</span></div><div class = 'S0'><span></span></div><h4 class = 'S12' id = 'H_B081D439' ><span>2.6 Faust Concatenation</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>You're probably aware of Matlab arrays concatenation otherwise look this example.</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>M = rand(5,5);</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>I = eye(5,5);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>[ M; I ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="6461B301" data-testid="output_57" data-width="1172" style="width: 1202px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 1172px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">10×5</span></div><div class="valueContainer" data-layout="{"columnWidth":66,"totalColumns":5,"totalRows":10,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 332px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 0.9498 0.2879 0.9385 0.8808 0.2407 + 0.2554 0.0749 0.4457 0.8527 0.8250 + 0.6174 0.3690 0.7012 0.6056 0.8516 + 0.9982 0.1396 0.2804 0.0755 0.2322 + 0.5436 0.1280 0.8271 0.0053 0.5111 1.0000 0 0 0 0 0 1.0000 0 0 0 0 0 1.0000 0 0 0 0 0 1.0000 0 0 0 0 0 1.0000 -</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(34, 139, 34);">% it was vertical concatenation, now let's concatenate horizontally</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>[ M I ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="977EBA77" data-scroll-top="null" data-scroll-left="null" data-testid="output_56" data-width="926" style="width: 956px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 926px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">5×10</span></div><div class="valueContainer" data-layout="{"columnWidth":73,"totalColumns":10,"totalRows":5,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 732px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 0.4646 0.2921 0.8408 0.8864 0.8112 1.0000 0 0 0 0 - 0.9722 0.1937 0.0800 0.1349 0.7004 0 1.0000 0 0 0 - 0.9748 0.2559 0.1754 0.6393 0.7324 0 0 1.0000 0 0 - 0.3829 0.6570 0.0191 0.6451 0.6932 0 0 0 1.0000 0 - 0.6989 0.7678 0.1076 0.1505 0.2574 0 0 0 0 1.0000 -</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div></div><div class = 'S8'><span>I'm sure you guessed that likewise you can concatenate Faust objects. That's right!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>[ F ; F]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="F4BC5FB0" data-scroll-top="null" data-scroll-left="null" data-testid="output_57" data-width="926" data-height="118" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 4.2, nnz_sum 420, 6 factor(s): -- FACTOR 0 (real) SPARSE, size 10x16, density 0.3125, nnz 50 -- FACTOR 1 (real) SPARSE, size 16x18, density 0.277778, nnz 80 -- FACTOR 2 (real) SPARSE, size 18x20, density 0.25, nnz 90 -- FACTOR 3 (real) SPARSE, size 20x16, density 0.3125, nnz 100 -- FACTOR 4 (real) SPARSE, size 16x20, density 0.25, nnz 80 -- FACTOR 5 (real) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>C = [ F F ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="1E92197F" data-scroll-top="null" data-scroll-left="null" data-testid="output_58" data-width="926" data-height="118" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">C = </span></div><div>Faust size 5x20, density 4.1, nnz_sum 410, 6 factor(s): +</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span style="color: rgb(34, 139, 34);">% it was vertical concatenation, now let's concatenate horizontally</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>[ M I ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="040B15C1" data-testid="output_58" data-width="1172" style="width: 1202px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 1172px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">5×10</span></div><div class="valueContainer" data-layout="{"columnWidth":66,"totalColumns":10,"totalRows":5,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 662px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 0.9498 0.2879 0.9385 0.8808 0.2407 1.0000 0 0 0 0 + 0.2554 0.0749 0.4457 0.8527 0.8250 0 1.0000 0 0 0 + 0.6174 0.3690 0.7012 0.6056 0.8516 0 0 1.0000 0 0 + 0.9982 0.1396 0.2804 0.0755 0.2322 0 0 0 1.0000 0 + 0.5436 0.1280 0.8271 0.0053 0.5111 0 0 0 0 1.0000 +</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div></div><div class = 'S8'><span>I'm sure you guessed that likewise you can concatenate Faust objects. That's right!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>[ F ; F]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="16C5D37B" data-testid="output_59" data-width="1172" data-height="118" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 10x10, density 3.3, nnz_sum 330, 6 factor(s): +- FACTOR 0 (real) SPARSE, size 10x12, density 0.333333, nnz 40 +- FACTOR 1 (real) SPARSE, size 12x10, density 0.5, nnz 60 +- FACTOR 2 (real) SPARSE, size 10x18, density 0.277778, nnz 50 +- FACTOR 3 (real) SPARSE, size 18x14, density 0.357143, nnz 90 +- FACTOR 4 (real) SPARSE, size 14x20, density 0.25, nnz 70 +- FACTOR 5 (real) SPARSE, size 20x10, density 0.1, nnz 20</div></div></div></div></div><div class="inlineWrapper"><div class = 'S14'></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>C = [ F F ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="538113B0" data-testid="output_60" data-width="1172" data-height="118" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">C = </span></div><div>Faust size 5x20, density 3.2, nnz_sum 320, 6 factor(s): - FACTOR 0 (real) SPARSE, size 5x10, density 0.2, nnz 10 -- FACTOR 1 (real) SPARSE, size 10x16, density 0.3125, nnz 50 -- FACTOR 2 (real) SPARSE, size 16x18, density 0.277778, nnz 80 -- FACTOR 3 (real) SPARSE, size 18x20, density 0.25, nnz 90 -- FACTOR 4 (real) SPARSE, size 20x16, density 0.3125, nnz 100 -- FACTOR 5 (real) SPARSE, size 16x20, density 0.25, nnz 80</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>full(C) - [ full(F) full(F) ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="FA1B206B" data-scroll-top="null" data-scroll-left="null" data-testid="output_59" data-width="926" style="width: 956px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 926px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">5×20</span></div><div class="valueContainer" data-layout="{"columnWidth":44,"totalColumns":20,"totalRows":5,"charsPerColumn":6}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 882px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +- FACTOR 1 (real) SPARSE, size 10x12, density 0.333333, nnz 40 +- FACTOR 2 (real) SPARSE, size 12x10, density 0.5, nnz 60 +- FACTOR 3 (real) SPARSE, size 10x18, density 0.277778, nnz 50 +- FACTOR 4 (real) SPARSE, size 18x14, density 0.357143, nnz 90 +- FACTOR 5 (real) SPARSE, size 14x20, density 0.25, nnz 70</div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>full(C) - [ full(F) full(F) ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="53EA1128" data-testid="output_61" data-width="1172" style="width: 1202px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 1172px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">ans = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">5×20</span></div><div class="valueContainer" data-layout="{"columnWidth":40,"totalColumns":20,"totalRows":5,"charsPerColumn":6}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 802px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div></div><div class = 'S8'><span>The difference of the two concatenations is full of zeros, so of course it works!</span></div><div class = 'S0'><span>As you noticed the Faust concatenation is stable, you give two Fausts and you get a Faust again. Besides, it's possible to concatenate an arbitrary number of Faust objects.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>[F C C F ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="655726DA" data-scroll-top="null" data-scroll-left="null" data-testid="output_60" data-width="926" data-height="160" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 5x60, density 4.25, nnz_sum 1275, 9 factor(s): +</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div></div><div class = 'S8'><span>The difference of the two concatenations is full of zeros, so of course it works!</span></div><div class = 'S0'><span>As you noticed the Faust concatenation is stable, you give two Fausts and you get a Faust again. Besides, it's possible to concatenate an arbitrary number of Faust objects.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>[F C C F ]</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="D534238F" data-testid="output_62" data-width="1172" data-height="160" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 5x60, density 3.35, nnz_sum 1005, 9 factor(s): - FACTOR 0 (real) SPARSE, size 5x10, density 0.2, nnz 10 - FACTOR 1 (real) SPARSE, size 10x15, density 0.1, nnz 15 - FACTOR 2 (real) SPARSE, size 15x20, density 0.0666667, nnz 20 - FACTOR 3 (real) SPARSE, size 20x30, density 0.05, nnz 30 -- FACTOR 4 (real) SPARSE, size 30x48, density 0.104167, nnz 150 -- FACTOR 5 (real) SPARSE, size 48x54, density 0.0925926, nnz 240 -- FACTOR 6 (real) SPARSE, size 54x60, density 0.0833333, nnz 270 -- FACTOR 7 (real) SPARSE, size 60x48, density 0.104167, nnz 300 -- FACTOR 8 (real) SPARSE, size 48x60, density 0.0833333, nnz 240</div></div></div></div></div></div><div class = 'S8'><span>As an exercise, you can write the factors of the Faust</span><span style=' font-family: monospace;'> [F ; F]</span><span>, F being any Faust.</span></div><div class = 'S0'><span style=' font-weight: bold;'>Hint</span><span>: the block-diagonal matrices are around here.</span></div><div class = 'S0'><span></span></div><h4 class = 'S12'><span>2.7 Faust Indexing and Slicing</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>Sometimes you need to access the dense matrix corresponding to a Faust or an element of it (by the way, note that it's costly).</span></div><div class = 'S0'><span>Let's access a Faust item:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F(3, 4)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 4.4882</div></div></div></div><div class = 'S8'><span>Why is it costly? Because it essentially converts the Faust to its dense form (modulo some optimizations) to just access one item.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>timeit(@() F(3, 4))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 4.8594e-04</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(@() FD(3, 4))</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsWarningElement" uid="FF24A602" data-scroll-top="null" data-scroll-left="null" data-testid="output_63" data-width="926" data-height="18" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="diagnosticMessage-wrapper diagnosticMessage-warningType"><div class="diagnosticMessage-messagePart">Warning: The measured time for F may be inaccurate because it is running too fast. Try measuring something that takes longer.</div><div class="diagnosticMessage-stackPart"></div></div></div><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 3.5386e-07</div></div></div></div><div class = 'S8'><span>It's totally the same syntax as Matlab but much slower so use it with care.</span></div><div class = 'S0'><span>The more advanced slicing operation uses also the same syntax as Matlab:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F(3:5, 4:10)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="BCB69AEF" data-scroll-top="null" data-scroll-left="null" data-testid="output_65" data-width="926" data-height="104" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 3x7, density 8.38095, nnz_sum 176, 5 factor(s): -- FACTOR 0 (real) SPARSE, size 3x8, density 0.625, nnz 15 -- FACTOR 1 (real) SPARSE, size 8x9, density 0.555556, nnz 40 -- FACTOR 2 (real) SPARSE, size 9x10, density 0.5, nnz 45 -- FACTOR 3 (real) SPARSE, size 10x8, density 0.625, nnz 50 -- FACTOR 4 (real) SPARSE, size 8x7, density 0.464286, nnz 26</div></div></div></div></div></div><div class = 'S8'><span>Here again, the result is another Faust. But this is not a full copy, it makes profit of memory views implemented behind in C++. Solely the first and last factors of the sliced Faust are new in memory, the others are just referenced from the initial Faust F. So use it with no worry for a Faust with a lot of factors!</span></div><div class = 'S0'><span>The Matlab indexing by arbitrary vector of integers has also been implemented in the FAµ?ST C++ core, let's try it:</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>I = [2, 4, 3];</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>FI = F(I,:);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>matfaust.isFaust(FI)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="100B3F16" data-scroll-top="null" data-scroll-left="null" data-testid="output_66" data-width="926" data-height="34" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 1 -</div></div></div></div></div></div><div class = 'S8'><span>Again, it's a Faust but is it really working? Verify!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>FID = full(FI)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="A6572BAA" data-scroll-top="null" data-scroll-left="null" data-testid="output_67" data-width="926" style="width: 956px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 926px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">FID = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">3×10</span></div><div class="valueContainer" data-layout="{"columnWidth":73,"totalColumns":10,"totalRows":3,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 732px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 8.9957 11.7083 14.8396 6.6188 7.8696 23.0172 2.3615 1.9188 10.7625 10.2643 - 4.8183 7.0419 9.1435 3.7627 4.6130 13.9024 1.5176 1.3094 6.0943 5.9542 - 6.0062 8.0569 10.5489 4.4882 5.6134 15.9861 1.8449 1.3966 7.3818 6.8053 -</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>FD = full(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="3DAF38DC" data-scroll-top="null" data-scroll-left="null" data-testid="output_68" data-width="926" style="width: 956px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 926px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">FD = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">5×10</span></div><div class="valueContainer" data-layout="{"columnWidth":73,"totalColumns":10,"totalRows":5,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 732px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 6.1737 8.5499 11.1382 4.7044 5.6684 17.0015 1.7882 1.5646 7.5773 7.4382 - 8.9957 11.7083 14.8396 6.6188 7.8696 23.0172 2.3615 1.9188 10.7625 10.2643 - 6.0062 8.0569 10.5489 4.4882 5.6134 15.9861 1.8449 1.3966 7.3818 6.8053 - 4.8183 7.0419 9.1435 3.7627 4.6130 13.9024 1.5176 1.3094 6.0943 5.9542 - 4.8377 6.0456 7.7101 3.4253 4.2102 11.7624 1.3160 0.9319 5.7729 5.0566 -</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>all(all(FID(1, :) == FD(I(1), :) & FID(2, :) == FD(I(2), :) & FID(3, :) == FD(I(3), :)))</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="3E59CE19" data-scroll-top="null" data-scroll-left="null" data-testid="output_69" data-width="926" data-height="34" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 1 -</div></div></div></div></div></div><div class = 'S8'><span>Yes it is!</span></div><div class = 'S0'><span></span></div><div class = 'S0'><span>This is the notebook's end, you have now a global view of what the Faust class is able and what kind of high-level algorithms it is ready for. You might be interested to read other notebooks, just go back to the </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/index.html"><span>page</span></a><span> where you got this one.</span></div><div class = 'S0'><span style=' font-weight: bold;'>Note:</span><span> this livescript was executed using the following matfaust version:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>matfaust.version()</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="B059AC81" data-testid="output_70" data-width="926" data-height="20" data-hashorizontaloverflow="false" style="width: 956px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span>'2.10.17'</div></div></div></div></div><div class="inlineWrapper"><div class = 'S15'></div></div></div><div class = 'S8'><span></span></div><div class = 'S0'><span></span></div><div class = 'S0'><span></span></div><div class = 'S0'><span></span></div><div class = 'S0'><span></span></div><div class = 'S0'><span></span></div><div class = 'S0'></div></div><br> +- FACTOR 4 (real) SPARSE, size 30x36, density 0.111111, nnz 120 +- FACTOR 5 (real) SPARSE, size 36x30, density 0.166667, nnz 180 +- FACTOR 6 (real) SPARSE, size 30x54, density 0.0925926, nnz 150 +- FACTOR 7 (real) SPARSE, size 54x42, density 0.119048, nnz 270 +- FACTOR 8 (real) SPARSE, size 42x60, density 0.0833333, nnz 210</div></div></div></div></div></div><div class = 'S8'><span>As an exercise, you can write the factors of the Faust</span><span style=' font-family: monospace;'> [F ; F]</span><span>, F being any Faust.</span></div><div class = 'S0'><span style=' font-weight: bold;'>Hint</span><span>: the block-diagonal matrices are around here.</span></div><div class = 'S0'><span></span></div><h4 class = 'S12' id = 'H_EBCC81E9' ><span>2.7 Faust Indexing and Slicing</span></h4><div class = 'S0'><span></span></div><div class = 'S0'><span>Sometimes you need to access the dense matrix corresponding to a Faust or an element of it (by the way, note that it's costly).</span></div><div class = 'S0'><span>Let's access a Faust item:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F(3, 4)</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 4.5517</div></div></div></div><div class = 'S8'><span>Why is it costly? Because it essentially converts the Faust to its dense form (modulo some optimizations) to just access one item.</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>timeit(@() F(3, 4))</span></span></div><div class = 'S6'><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0.0011</div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>timeit(@() FD(3, 4))</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsWarningElement" uid="6D482C81" data-testid="output_65" data-width="1172" data-height="18" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="diagnosticMessage-wrapper diagnosticMessage-warningType"><div class="diagnosticMessage-messagePart">Warning: The measured time for F may be inaccurate because it is running too fast. Try measuring something that takes longer.</div><div class="diagnosticMessage-stackPart"></div></div></div><div class='variableElement' style='font-family: Menlo, Monaco, Consolas, "Courier New", monospace; font-size: 12px; '>ans = 0</div></div></div></div><div class = 'S8'><span>It's totally the same syntax as Matlab but much slower so use it with care.</span></div><div class = 'S0'><span>The more advanced slicing operation uses also the same syntax as Matlab:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>F(3:5, 4:10)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="FB448FDC" data-testid="output_67" data-width="1172" data-height="104" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span></div><div>Faust size 3x7, density 6.42857, nnz_sum 135, 5 factor(s): +- FACTOR 0 (real) SPARSE, size 3x6, density 0.666667, nnz 12 +- FACTOR 1 (real) SPARSE, size 6x5, density 1, nnz 30 +- FACTOR 2 (real) SPARSE, size 5x9, density 0.555556, nnz 25 +- FACTOR 3 (real) SPARSE, size 9x7, density 0.714286, nnz 45 +- FACTOR 4 (real) SPARSE, size 7x7, density 0.469388, nnz 23</div></div></div></div></div></div><div class = 'S8'><span>Here again, the result is another Faust. But this is not a full copy, it makes profit of memory views implemented behind in C++. Solely the first and last factors of the sliced Faust are new in memory, the others are just referenced from the initial Faust F. So use it with no worry for a Faust with a lot of factors!</span></div><div class = 'S0'><span>The Matlab indexing by arbitrary vector of integers has also been implemented in the FAµ?ST C++ core, let's try it:</span></div><div class="CodeBlock"><div class="inlineWrapper"><div class = 'S9'><span style="white-space: pre;"><span>I = [2, 4, 3];</span></span></div></div><div class="inlineWrapper"><div class = 'S11'><span style="white-space: pre;"><span>FI = F(I,:);</span></span></div></div><div class="inlineWrapper outputs"><div class = 'S10'><span style="white-space: pre;"><span>matfaust.isFaust(FI)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="D9515D09" data-testid="output_68" data-width="1172" data-height="34" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 1 +</div></div></div></div></div></div><div class = 'S8'><span>Again, it's a Faust but is it really working? Verify!</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>FID = full(FI)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="4D785859" data-testid="output_69" data-width="1172" style="width: 1202px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 1172px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">FID = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">3×10</span></div><div class="valueContainer" data-layout="{"columnWidth":66,"totalColumns":10,"totalRows":3,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 662px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 8.6416 8.6416 8.8458 8.6416 4.2308 8.6416 6.3638 8.6416 5.6379 8.6416 + 6.0348 6.0348 6.6685 6.0348 2.9693 6.0348 4.9064 6.0348 4.3525 6.0348 + 7.2944 7.2944 7.5158 7.2944 3.6321 7.2944 5.4321 7.2944 4.8335 7.2944 +</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>FD = full(F)</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableMatrixElement" uid="AF83E6B1" data-testid="output_70" data-width="1172" style="width: 1202px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="matrixElement veSpecifier" style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="veVariableName variableNameElement double" style="width: 1172px; white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><span style="white-space: normal; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;">FD = </span><span class="veVariableValueSummary veMetaSummary" style="white-space: normal; font-style: normal; color: rgb(179, 179, 179); font-size: 12px;">5×10</span></div><div class="valueContainer" data-layout="{"columnWidth":66,"totalColumns":10,"totalRows":5,"charsPerColumn":10}" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"><div class="variableValue" style="width: 662px; white-space: pre; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"> 6.0348 6.6685 2.9693 4.9064 4.3525 2.5213 7.5575 1.7875 10.7148 3.5887 + 8.6416 8.8458 4.2308 6.3638 5.6379 3.6127 10.5910 2.5712 15.2344 5.0702 + 6.6132 6.4056 3.3165 4.5517 4.0479 2.8073 8.1196 2.0966 11.5987 3.9959 + 7.2944 7.5158 3.6321 5.4321 4.8335 3.0580 9.0816 2.2985 12.8331 4.4162 + 11.1903 11.6055 5.7530 8.4704 7.5258 4.9098 13.9732 3.4261 19.9193 6.8549 +</div><div class="horizontalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div><div class="verticalEllipsis hide" style="white-space: nowrap; font-style: normal; color: rgb(64, 64, 64); font-size: 12px;"></div></div></div></div></div></div><div class="inlineWrapper outputs"><div class = 'S7'><span style="white-space: pre;"><span>all(all(FID(1, :) == FD(I(1), :) & FID(2, :) == FD(I(2), :) & FID(3, :) == FD(I(3), :)))</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="ACAA515F" data-testid="output_71" data-width="1172" data-height="34" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = <span class="headerElement">logical</span></span></div><div> 0 +</div></div></div></div></div></div><div class = 'S8'><span>Yes it is!</span></div><div class = 'S0'><span></span></div><div class = 'S0'><span>This is the notebook's end, you have now a global view of what the Faust class is able and what kind of high-level algorithms it is ready for. You might be interested to read other notebooks, just go back to the </span><a href = "https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/index.html"><span>page</span></a><span> where you got this one.</span></div><div class = 'S0'><span style=' font-weight: bold;'>Note:</span><span> this livescript was executed using the following matfaust version:</span></div><div class="CodeBlock"><div class="inlineWrapper outputs"><div class = 'S5'><span style="white-space: pre;"><span>matfaust.version()</span></span></div><div class = 'S6'><div class="inlineElement eoOutputWrapper embeddedOutputsVariableStringElement" uid="A7CDA7FB" data-testid="output_72" data-width="1172" data-height="20" data-hashorizontaloverflow="false" style="width: 1202px; max-height: 261px;"><div class="textElement"><div><span class="variableNameElement">ans = </span>'2.10.29'</div></div></div></div></div></div><div class = 'S8'><span></span></div><div class = 'S0'><span></span></div><div class = 'S0'><span></span></div><div class = 'S0'><span></span></div><div class = 'S0'><span></span></div><div class = 'S0'></div></div><br> <!-- ##### SOURCE BEGIN ##### %% @@ -325,31 +329,33 @@ %% Table of Contents: % % -% 1. Getting Basic Information about a Faust Object +% <internal:H_E9BF5BFF 1. Getting Basic Information about a Faust Object> +% +% <internal:H_95BE1343 1.1 Obtaining Dimension and Scalar Type Information> +% +% <internal:H_0602CE09 1.2 Obtaining Other Faust Specific Information> % -% 1.1 Obtaining Dimension and Scalar Type Information +% <internal:H_2CF60B15 1.3 Plotting a Faust> % -% 1.2 Obtaining Other Faust Specific Information +% <internal:H_C5C21250 1.4 About Sparsity!> % -% 1.3 Plotting a Faust % -% 1.4 About Sparsity! % -% 2. Faust Algebra and other Operations +% <internal:H_73387A87 2. Faust Algebra and other Operations> % -% 2.1 Transpose, conjugate, transconjugate +% <internal:H_5E556DD4 2.1 Transpose, conjugate, transconjugate> % -% 2.2 Add, Subtract and Multiply +% <internal:H_99DA98B4 2.2 Add, Subtract and Multiply> % -% 2.3 Faust Multiplication by a Vector or a Matrix +% <internal:H_BD8A7C70 2.3 Faust Multiplication by a Vector or a Matrix> % -% 2.4 Faust Norms +% <internal:H_7AF16EFF 2.4 Faust Norms> % -% 2.5 Faust Normalizations +% <internal:H_1070C649 2.5 Faust Normalizations> % -% 2.6 Faust Concatenation +% <internal:H_B081D439 2.6 Faust Concatenation> % -% 2.7 Faust Indexing and Slicing +% <internal:H_EBCC81E9 2.7 Faust Indexing and Slicing> % % %% 1. Getting Basic Information about a Faust Object @@ -450,8 +456,21 @@ Faust({factors(F, 3), factors(F, 4)}) %% 1.3 Plotting a Faust % % -% Available soon! +% It's quite useful to print a |Faust| as we've seen before, calling disp(F), +% |display(F)| or just |F| in an interactive terminal but this is wordy. How +% about plotting a Faust in a more graphical fashion ? + +imagesc(F) +%% +% What do we see above ? On the bottom right is the dense matrix associated +% to F, obtained with |full(F)|. On the top are the indexed factors of F. Note +% that you can change the default <https://www.mathworks.com/help/matlab/ref/colormap.html +% colormap> in matplotlib parameters. % +% Let's look at a last example: + +imagesc(Faust({eye(5,4),eye(4,10)})) +%% % %% 1.4 About Sparsity! % @@ -481,6 +500,7 @@ rcg(F) % According to its RCG, this Faust doesn't seem to be of any help for optimization % but look at the graphic the next script generates: +figure() nfactors = 3; startd = 0.01; endd = 1; @@ -812,7 +832,6 @@ all(all(FID(1, :) == FD(I(1), :) & FID(2, :) == FD(I(2), :) & FID(3, :) == FD(I( % *Note:* this livescript was executed using the following matfaust version: matfaust.version() - %% % % @@ -824,8 +843,6 @@ matfaust.version() % % % -% -% % ##### SOURCE END ##### --></body></html> \ No newline at end of file