--- /srv/reproducible-results/rbuild-debian/r-b-build.Q5iGMOhi/b1/spooles_2.2-14_amd64.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.Q5iGMOhi/b2/spooles_2.2-14_amd64.changes ├── Files │ @@ -1,5 +1,5 @@ │ │ 01a64e0370d945ef0f7caee44cbe16ca 593508 libdevel optional libspooles-dev_2.2-14_amd64.deb │ 736f29649e332d6798507f29b7cb838e 1353112 debug optional libspooles2.2-dbgsym_2.2-14_amd64.deb │ 040fafef9db32df4de23b43ac09bfda7 459684 libs optional libspooles2.2_2.2-14_amd64.deb │ - 8d29f1506a69b2fdb0fe8d4790e04b91 8127400 doc optional spooles-doc_2.2-14_all.deb │ + c31a4ebc9e19b11845338f269b25d40f 8111028 doc optional spooles-doc_2.2-14_all.deb ├── spooles-doc_2.2-14_all.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2018-12-19 22:56:58.000000 debian-binary │ │ -rw-r--r-- 0 0 0 1952 2018-12-19 22:56:58.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 8125256 2018-12-19 22:56:58.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 8108884 2018-12-19 22:56:58.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./control │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ Package: spooles-doc │ │ │ │ Source: spooles │ │ │ │ Version: 2.2-14 │ │ │ │ Architecture: all │ │ │ │ Maintainer: Debian Science Maintainers │ │ │ │ -Installed-Size: 8187 │ │ │ │ +Installed-Size: 8177 │ │ │ │ Suggests: libspooles2.2-dev │ │ │ │ Section: doc │ │ │ │ Priority: optional │ │ │ │ Homepage: http://www.netlib.org/linalg/spooles/ │ │ │ │ Description: SPOOLES numerical simulation pre- and post-processor documentation │ │ │ │ SPOOLES is a library for solving sparse real and complex linear systems of │ │ │ │ equations, written in the C language using object oriented design. │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -1,56 +1,56 @@ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2018-12-19 22:56:58.000000 ./ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2018-12-19 22:56:58.000000 ./usr/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2018-12-19 22:56:58.000000 ./usr/share/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2018-12-19 22:56:58.000000 ./usr/share/doc/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 151985 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/A2.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 151807 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/A2.ps.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 596035 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ASHCRAFC.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 312465 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/AllInOne.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 127875 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/BKL.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 156051 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/BPG.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 190334 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Chv.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 100970 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ChvList.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 94671 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ChvManager.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 120938 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Coords.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 115950 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/DSTree.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 134092 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/DV.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 117845 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/DenseMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 107553 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Drand.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 121532 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/EGraph.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 220990 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ETree.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 254848 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Eigen.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 179607 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/FrontMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 275769 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/FrontTrees.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 184611 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/GPart.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 190180 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Graph.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 131960 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/I2Ohash.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 109992 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/IIheap.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 121763 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/IV.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 124711 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/IVL.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 95652 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Ideq.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 205021 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/InpMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 283599 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/LinSol.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 89446 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Lock.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 176474 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/MPI.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 168546 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/MSMD.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 163518 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/MT.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 146521 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Network.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 143587 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/PatchAndGoInfo.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 124731 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Pencil.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 107294 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Perm.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 911453 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ReferenceManual.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 153056 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SemiImplMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 134566 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SolveMap.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 175801 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SubMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 101660 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SubMtxList.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 117819 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SubMtxManager.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 120961 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SymbFac.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 167995 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Tree.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 190258 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Utilities.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 127967 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ZV.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 311822 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/AllInOne.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 127684 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/BKL.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 155900 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/BPG.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 190111 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Chv.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 100773 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ChvList.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 94465 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ChvManager.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 120723 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Coords.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 115752 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/DSTree.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 133866 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/DV.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 117557 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/DenseMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 107357 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Drand.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 121396 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/EGraph.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 220787 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ETree.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 254150 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Eigen.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 179450 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/FrontMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 275359 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/FrontTrees.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 184337 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/GPart.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 189930 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Graph.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 131785 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/I2Ohash.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 109732 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/IIheap.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 121532 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/IV.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 124457 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/IVL.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 95438 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Ideq.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 204829 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/InpMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 283054 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/LinSol.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 89254 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Lock.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 176282 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/MPI.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 168475 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/MSMD.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 163221 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/MT.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 146309 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Network.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 143370 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/PatchAndGoInfo.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 124515 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Pencil.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 107033 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Perm.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 910637 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ReferenceManual.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 152850 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SemiImplMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 134443 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SolveMap.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 175545 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SubMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 101424 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SubMtxList.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 117611 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SubMtxManager.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 120748 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/SymbFac.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 167792 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Tree.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 190070 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/Utilities.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 127741 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/ZV.ps.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1881 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/changelog.Debian.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 378 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/copyright │ │ │ │ --rw-r--r-- 0 root (0) root (0) 189114 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/misc.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 188884 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/misc.ps.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9600 2018-12-19 22:56:58.000000 ./usr/share/doc/spooles-doc/spooles.2.2.html │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2018-12-19 22:56:58.000000 ./usr/share/doc-base/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 430 2018-12-19 22:56:58.000000 ./usr/share/doc-base/spooles │ │ │ ├── ./usr/share/doc/spooles-doc/A2.ps.gz │ │ │ │ ├── A2.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o A2.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0424 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2061,21 +2061,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2259,88 +2258,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4629,16 +4623,16 @@ │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 205[33 33 49[{}2 58.1154 /CMR7 rf /Fb 255[65{}1 │ │ │ │ │ 83.022 /CMSY10 rf /Fc 149[27 21[39 11[54 72[{}3 58.1154 │ │ │ │ │ /CMMI7 rf /Fd 173[74 77 81[{}2 99.6264 /CMMI12 rf /Fe │ │ │ │ │ 133[50 59 3[62 44 44 46 2[56 62 93 31 2[31 62 1[34 51 │ │ │ │ │ 62 50 1[54 11[86 1[62 3[84 88 106 3[42 6[80 9[56 56 56 │ │ │ │ │ 56 56 56 56 56 2[31 46[{}33 99.6264 /CMBX12 rf /Ff 134[44 │ │ │ │ │ -3[46 2[33 12[37 2[46 42 26[54 11[23 1[42 2[42 2[42 1[42 │ │ │ │ │ -3[23 44[{}13 83.022 /CMSL10 rf /Fg 139[62 4[62 4[62 4[62 │ │ │ │ │ +3[46 2[33 3[46 12[42 22[43 15[23 2[42 2[42 1[42 1[42 │ │ │ │ │ +3[23 44[{}12 83.022 /CMSL10 rf /Fg 139[62 4[62 4[62 4[62 │ │ │ │ │ 1[62 62 32[62 14[62 50[{}8 119.552 /CMTT12 rf /Fh 136[55 │ │ │ │ │ 1[45 28 34 35 1[42 42 47 68 21 38 1[25 42 38 1[38 42 │ │ │ │ │ 38 38 42 12[59 1[61 11[54 56 63 2[62 6[25 58[{}26 83.022 │ │ │ │ │ /CMTI10 rf │ │ │ │ │ %DVIPSBitmapFont: Fi tcrm1000 10 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ @@ -4763,42 +4757,41 @@ │ │ │ │ │ 2397 4912 V 31 w(BY)p 2516 4912 V 31 w(COLUMNS)p Fm(.)0 │ │ │ │ │ 5204 y Fj(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g │ │ │ │ │ Fg(A2)f Fj(metho)t(ds)0 5407 y Fm(This)28 b(section)f(con)n(tains)f │ │ │ │ │ (brief)i(descriptions)f(including)h(protot)n(yp)r(es)e(of)i(all)f │ │ │ │ │ (metho)r(ds)h(that)g(b)r(elong)f(to)g(the)h Fl(A2)f Fm(ob)5 │ │ │ │ │ b(ject.)1929 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fm(2)p 125 100 1248 4 v │ │ │ │ │ -1413 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2652 100 V 0 390 a Fe(1.2.1)112 b(Basic)38 │ │ │ │ │ -b(metho)s(ds)0 573 y Fm(As)21 b(usual,)g(there)f(are)g(four)g(basic)g │ │ │ │ │ -(metho)r(ds)g(to)h(supp)r(ort)f(ob)5 b(ject)20 b(creation,)h(setting)f │ │ │ │ │ -(default)h(\014elds,)h(clearing)d(an)n(y)h(allo)r(cated)0 │ │ │ │ │ -672 y(data,)27 b(and)h(free'ing)f(the)h(ob)5 b(ject.)101 │ │ │ │ │ -889 y(1.)42 b Fl(A2)g(*)h(A2_new)f(\()h(void)f(\))h(;)208 │ │ │ │ │ -1027 y Fm(This)28 b(metho)r(d)g(simply)h(allo)r(cates)e(storage)f(for)h │ │ │ │ │ -(the)i Fl(A2)e Fm(structure)h(and)g(then)h(sets)f(the)g(default)h │ │ │ │ │ -(\014elds)f(b)n(y)g(a)f(call)h(to)208 1127 y Fl(A2)p │ │ │ │ │ -301 1127 27 4 v 30 w(setDefaultFields)o(\(\))p Fm(.)101 │ │ │ │ │ -1302 y(2.)42 b Fl(void)f(A2_setDefaultFiel)o(ds)c(\()43 │ │ │ │ │ -b(A2)g(*mtx)f(\))h(;)208 1440 y Fm(The)34 b(structure's)h(\014elds)g │ │ │ │ │ -(are)e(set)i(to)g(default)g(v)-5 b(alues:)51 b Fl(type)34 │ │ │ │ │ -b Fm(=)g Fl(SPOOLES)p 2618 1440 V 29 w(REAL)p Fm(,)f │ │ │ │ │ -Fl(n1)h Fm(=)h Fl(inc1)e Fm(=)h Fl(n2)h Fm(=)f Fl(inc2)f │ │ │ │ │ -Fm(=)208 1539 y Fl(nowned)25 b Fm(=)i(0)g(and)h Fl(entries)c │ │ │ │ │ -Fm(=)k Fl(NULL)e Fm(.)208 1677 y Fh(Err)l(or)k(che)l(cking:)38 │ │ │ │ │ -b Fm(If)28 b Fl(mtx)f Fm(is)g Fl(NULL)p Fm(,)f(an)i(error)d(message)i │ │ │ │ │ -(is)g(prin)n(ted)h(and)f(the)h(program)e(exits.)101 1852 │ │ │ │ │ -y(3.)42 b Fl(void)f(A2_clearData)e(\()k(A2)g(*mtx)f(\))h(;)208 │ │ │ │ │ -1990 y Fm(This)32 b(metho)r(d)i(clears)d(the)j(ob)5 b(ject)32 │ │ │ │ │ -b(and)h(free's)f(an)n(y)h(o)n(wned)f(data.)52 b(If)33 │ │ │ │ │ -b Fl(nowned)41 b(>)j(0)32 b Fm(and)h Fl(entries)d Fm(is)j(not)g │ │ │ │ │ -Fl(NULL)p Fm(,)208 2090 y(then)28 b Fl(DVfree\(entries\))21 │ │ │ │ │ -b Fm(is)28 b(called)f(to)g(free)h(the)g(storage.)35 b(It)28 │ │ │ │ │ -b(calls)e Fl(A2)p 2487 2090 V 31 w(setDefaultFields)o(\(\))p │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 125 100 1266 4 v │ │ │ │ │ +1431 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2635 100 V 0 390 a Fe(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +573 y Fm(As)21 b(usual,)g(there)f(are)g(four)g(basic)g(metho)r(ds)g(to) │ │ │ │ │ +h(supp)r(ort)f(ob)5 b(ject)20 b(creation,)h(setting)f(default)h │ │ │ │ │ +(\014elds,)h(clearing)d(an)n(y)h(allo)r(cated)0 672 y(data,)27 │ │ │ │ │ +b(and)h(free'ing)f(the)h(ob)5 b(ject.)101 889 y(1.)42 │ │ │ │ │ +b Fl(A2)g(*)h(A2_new)f(\()h(void)f(\))h(;)208 1027 y │ │ │ │ │ +Fm(This)28 b(metho)r(d)g(simply)h(allo)r(cates)e(storage)f(for)h(the)i │ │ │ │ │ +Fl(A2)e Fm(structure)h(and)g(then)h(sets)f(the)g(default)h(\014elds)f │ │ │ │ │ +(b)n(y)g(a)f(call)h(to)208 1127 y Fl(A2)p 301 1127 27 │ │ │ │ │ +4 v 30 w(setDefaultFields)o(\(\))p Fm(.)101 1302 y(2.)42 │ │ │ │ │ +b Fl(void)f(A2_setDefaultFiel)o(ds)c(\()43 b(A2)g(*mtx)f(\))h(;)208 │ │ │ │ │ +1440 y Fm(The)34 b(structure's)h(\014elds)g(are)e(set)i(to)g(default)g │ │ │ │ │ +(v)-5 b(alues:)51 b Fl(type)34 b Fm(=)g Fl(SPOOLES)p │ │ │ │ │ +2618 1440 V 29 w(REAL)p Fm(,)f Fl(n1)h Fm(=)h Fl(inc1)e │ │ │ │ │ +Fm(=)h Fl(n2)h Fm(=)f Fl(inc2)f Fm(=)208 1539 y Fl(nowned)25 │ │ │ │ │ +b Fm(=)i(0)g(and)h Fl(entries)c Fm(=)k Fl(NULL)e Fm(.)208 │ │ │ │ │ +1677 y Fh(Err)l(or)k(che)l(cking:)38 b Fm(If)28 b Fl(mtx)f │ │ │ │ │ +Fm(is)g Fl(NULL)p Fm(,)f(an)i(error)d(message)i(is)g(prin)n(ted)h(and)f │ │ │ │ │ +(the)h(program)e(exits.)101 1852 y(3.)42 b Fl(void)f(A2_clearData)e(\() │ │ │ │ │ +k(A2)g(*mtx)f(\))h(;)208 1990 y Fm(This)32 b(metho)r(d)i(clears)d(the)j │ │ │ │ │ +(ob)5 b(ject)32 b(and)h(free's)f(an)n(y)h(o)n(wned)f(data.)52 │ │ │ │ │ +b(If)33 b Fl(nowned)41 b(>)j(0)32 b Fm(and)h Fl(entries)d │ │ │ │ │ +Fm(is)j(not)g Fl(NULL)p Fm(,)208 2090 y(then)28 b Fl(DVfree\(entries\)) │ │ │ │ │ +21 b Fm(is)28 b(called)f(to)g(free)h(the)g(storage.)35 │ │ │ │ │ +b(It)28 b(calls)e Fl(A2)p 2487 2090 V 31 w(setDefaultFields)o(\(\))p │ │ │ │ │ Fm(.)208 2227 y Fh(Err)l(or)k(che)l(cking:)38 b Fm(If)28 │ │ │ │ │ b Fl(mtx)f Fm(is)g Fl(NULL)p Fm(,)f(an)i(error)d(message)i(is)g(prin)n │ │ │ │ │ (ted)h(and)f(the)h(program)e(exits.)101 2403 y(4.)42 │ │ │ │ │ b Fl(void)f(A2_free)g(\()i(A2)g(*mtx)f(\))h(;)208 2540 │ │ │ │ │ y Fm(This)27 b(metho)r(d)h(releases)e(an)n(y)h(storage)f(b)n(y)h(a)g │ │ │ │ │ (call)g(to)h Fl(A2)p 1975 2540 V 30 w(clearData\(\))c │ │ │ │ │ Fm(and)j(then)h(free)f(the)h(space)f(for)g Fl(mtx)p Fm(.)208 │ │ │ │ │ @@ -4833,17 +4826,17 @@ │ │ │ │ │ b Fl(double)f(*)i(A2_entries)c(\()k(A2)g(*mtx)f(\))h(;)208 │ │ │ │ │ 5270 y Fm(This)27 b(metho)r(d)h(returns)f(a)g(p)r(oin)n(ter)g(to)h(the) │ │ │ │ │ g(base)f(address)f(of)i(the)g(en)n(tries.)208 5407 y │ │ │ │ │ Fh(Err)l(or)i(che)l(cking:)38 b Fm(If)28 b Fl(mtx)f Fm(is)g │ │ │ │ │ Fl(NULL)p Fm(,)f(an)i(error)d(message)i(is)g(prin)n(ted)h(and)f(the)h │ │ │ │ │ (program)e(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 83 100 1248 4 v 1414 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -2613 100 V 1248 w Fm(3)101 390 y(6.)42 b Fl(double)f(*)i(A2_row)e(\()i │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1266 4 v 1431 100 a Fl(A2)27 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)110 b Ff(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2595 100 V 1266 w Fm(3)101 390 y(6.)42 b Fl(double)f(*)i(A2_row)e(\()i │ │ │ │ │ (A2)g(*mtx,)e(int)i(irow)f(\))h(;)208 541 y Fm(This)27 │ │ │ │ │ b(metho)r(d)h(returns)f(a)g(p)r(oin)n(ter)g(to)h(the)g(leading)f │ │ │ │ │ (elemen)n(t)h(of)f(ro)n(w)g Fl(irow)p Fm(.)208 691 y │ │ │ │ │ Fh(Err)l(or)k(che)l(cking:)41 b Fm(If)29 b Fl(mtx)f Fm(or)g │ │ │ │ │ Fl(entries)e Fm(is)j Fl(NULL)p Fm(,)e(or)h(if)i Fl(irow)d │ │ │ │ │ Fm(is)i(not)f(in)i Fl([0,n1-1])p Fm(,)c(an)i(error)f(message)g(is)i │ │ │ │ │ (prin)n(ted)208 791 y(and)e(the)h(program)e(exits.)101 │ │ │ │ │ @@ -4914,51 +4907,51 @@ │ │ │ │ │ Fm(,)e Fl(ppReal)f Fm(or)i Fl(ppImag)e Fm(is)i Fl(NULL)p │ │ │ │ │ Fm(,)f(or)h(if)g(the)h(matrix)f(is)g(not)h(complex,)f(or)f(if)i │ │ │ │ │ Fl(irow)e Fm(is)h(not)h(in)208 5407 y Fl([0,n1-1])p Fm(,)c(or)j(if)h │ │ │ │ │ Fl(jcol)e Fm(is)h(not)h(in)g Fl([0,n2-1])p Fm(,)c(an)j(error)f(message) │ │ │ │ │ g(is)i(prin)n(ted)f(and)h(the)g(program)d(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fm(4)p 125 100 1248 4 v │ │ │ │ │ -1413 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2652 100 V 0 390 a Fe(1.2.3)112 b(Initialize)38 │ │ │ │ │ -b(metho)s(ds)101 574 y Fm(1.)k Fl(void)f(A2_init)g(\()i(A2)g(*mtx,)f │ │ │ │ │ -(int)g(type,)f(int)i(n1,)f(int)h(n2,)f(int)g(inc1,)g(int)g(inc2,)861 │ │ │ │ │ -674 y(double)f(*entries)g(\))i(;)208 812 y Fm(This)30 │ │ │ │ │ -b(is)h(the)g(basic)f(initializer)h(metho)r(d.)47 b(W)-7 │ │ │ │ │ -b(e)31 b(require)e(that)i Fl(mtx)f Fm(not)h(b)r(e)g Fl(NULL)p │ │ │ │ │ -Fm(,)e Fl(type)g Fm(b)r(e)j(either)e Fl(SPOOLES)p 3702 │ │ │ │ │ -812 27 4 v 29 w(REAL)208 912 y Fm(or)d Fl(SPOOLES)p 623 │ │ │ │ │ -912 V 29 w(COMPLEX)p Fm(,)e Fl(n1)j Fm(and)g Fl(n2)g │ │ │ │ │ -Fm(b)r(oth)h(b)r(e)g(p)r(ositiv)n(e,)f(and)h(b)r(oth)f │ │ │ │ │ -Fl(inc1)f Fm(and)i Fl(inc2)e Fm(b)r(oth)i(b)r(e)f(p)r(ositiv)n(e)g(and) │ │ │ │ │ -h(that)208 1012 y(one)g(of)h(them)h(b)r(e)f(equal)g(to)g(one.)44 │ │ │ │ │ -b(Also,)30 b(w)n(e)g(only)f(initialize)i(a)e(full)i(matrix,)f(i.e.,)h │ │ │ │ │ -(one)f(of)g Fl(inc1)42 b(=)h(1)30 b Fm(and)f Fl(inc2)42 │ │ │ │ │ -b(=)208 1111 y(nrow)26 b Fm(or)g Fl(inc1)42 b(=)h(ncol)26 │ │ │ │ │ -b Fm(and)i Fl(inc2)42 b(=)h(1)27 b Fm(m)n(ust)h(hold.)208 │ │ │ │ │ -1250 y(The)g(ob)5 b(ject)29 b(is)f(\014rst)g(cleared)g(with)h(a)f(call) │ │ │ │ │ -h(to)f Fl(A2)p 1780 1250 V 31 w(clearData\(\))p Fm(.)35 │ │ │ │ │ -b(If)29 b Fl(entries)d Fm(is)i Fl(NULL)f Fm(then)i Fl(n1*n2)e │ │ │ │ │ -Fm(new)i(en)n(tries)208 1350 y(are)h(found,)k Fl(mtx->entries)27 │ │ │ │ │ -b Fm(is)32 b(set)f(to)h(this)g(address)f(and)h Fl(nowned)d │ │ │ │ │ -Fm(is)j(set)g(to)g Fl(n1*n2)p Fm(.)48 b(If)32 b Fl(entries)d │ │ │ │ │ -Fm(is)j(not)g Fl(NULL)p Fm(,)208 1449 y(then)c Fl(mtx->entries)22 │ │ │ │ │ -b Fm(is)28 b(set)f(to)h Fl(entries)d Fm(and)i Fl(nowned)e │ │ │ │ │ -Fm(is)j(set)f(to)h(zero.)208 1588 y Fh(Err)l(or)e(che)l(cking:)37 │ │ │ │ │ -b Fm(If)25 b Fl(mtx)d Fm(is)i Fl(NULL)p Fm(,)f(or)g(if)h │ │ │ │ │ -Fl(n1)p Fm(,)g Fl(n2)p Fm(,)g Fl(inc1)f Fm(or)g Fl(inc2)f │ │ │ │ │ -Fm(are)h(less)h(than)g(or)f(equal)g(to)h(zero,)g(or)f(if)h(the)h │ │ │ │ │ -(matrix)208 1688 y(is)k(not)h(full)h(matrix)e(\(i.e.,)i │ │ │ │ │ -Fl(inc1)d Fm(m)n(ust)i(b)r(e)g Fl(1)f Fm(and)h Fl(inc2)e │ │ │ │ │ -Fm(m)n(ust)i(b)r(e)g Fl(n1)p Fm(,)g Fh(or)g Fl(inc1)f │ │ │ │ │ -Fm(m)n(ust)h(b)r(e)g Fl(n2)f Fm(and)h Fl(inc2)e Fm(m)n(ust)i(b)r(e)208 │ │ │ │ │ -1787 y Fl(1)p Fm(\),)d(an)g(error)f(message)g(is)i(prin)n(ted)f(and)h │ │ │ │ │ -(zero)e(is)i(returned.)101 1965 y(2.)42 b Fl(void)f(A2_subA2)g(\()i(A2) │ │ │ │ │ -g(*mtxA,)e(A2)i(*mtxB,)905 2065 y(int)f(firstrow,)e(int)i(lastrow,)f │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 125 100 1266 4 v │ │ │ │ │ +1431 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2635 100 V 0 390 a Fe(1.2.3)112 b(Initialize)38 b(metho)s(ds)101 │ │ │ │ │ +574 y Fm(1.)k Fl(void)f(A2_init)g(\()i(A2)g(*mtx,)f(int)g(type,)f(int)i │ │ │ │ │ +(n1,)f(int)h(n2,)f(int)g(inc1,)g(int)g(inc2,)861 674 │ │ │ │ │ +y(double)f(*entries)g(\))i(;)208 812 y Fm(This)30 b(is)h(the)g(basic)f │ │ │ │ │ +(initializer)h(metho)r(d.)47 b(W)-7 b(e)31 b(require)e(that)i │ │ │ │ │ +Fl(mtx)f Fm(not)h(b)r(e)g Fl(NULL)p Fm(,)e Fl(type)g │ │ │ │ │ +Fm(b)r(e)j(either)e Fl(SPOOLES)p 3702 812 27 4 v 29 w(REAL)208 │ │ │ │ │ +912 y Fm(or)d Fl(SPOOLES)p 623 912 V 29 w(COMPLEX)p Fm(,)e │ │ │ │ │ +Fl(n1)j Fm(and)g Fl(n2)g Fm(b)r(oth)h(b)r(e)g(p)r(ositiv)n(e,)f(and)h │ │ │ │ │ +(b)r(oth)f Fl(inc1)f Fm(and)i Fl(inc2)e Fm(b)r(oth)i(b)r(e)f(p)r │ │ │ │ │ +(ositiv)n(e)g(and)h(that)208 1012 y(one)g(of)h(them)h(b)r(e)f(equal)g │ │ │ │ │ +(to)g(one.)44 b(Also,)30 b(w)n(e)g(only)f(initialize)i(a)e(full)i │ │ │ │ │ +(matrix,)f(i.e.,)h(one)f(of)g Fl(inc1)42 b(=)h(1)30 b │ │ │ │ │ +Fm(and)f Fl(inc2)42 b(=)208 1111 y(nrow)26 b Fm(or)g │ │ │ │ │ +Fl(inc1)42 b(=)h(ncol)26 b Fm(and)i Fl(inc2)42 b(=)h(1)27 │ │ │ │ │ +b Fm(m)n(ust)h(hold.)208 1250 y(The)g(ob)5 b(ject)29 │ │ │ │ │ +b(is)f(\014rst)g(cleared)g(with)h(a)f(call)h(to)f Fl(A2)p │ │ │ │ │ +1780 1250 V 31 w(clearData\(\))p Fm(.)35 b(If)29 b Fl(entries)d │ │ │ │ │ +Fm(is)i Fl(NULL)f Fm(then)i Fl(n1*n2)e Fm(new)i(en)n(tries)208 │ │ │ │ │ +1350 y(are)h(found,)k Fl(mtx->entries)27 b Fm(is)32 b(set)f(to)h(this)g │ │ │ │ │ +(address)f(and)h Fl(nowned)d Fm(is)j(set)g(to)g Fl(n1*n2)p │ │ │ │ │ +Fm(.)48 b(If)32 b Fl(entries)d Fm(is)j(not)g Fl(NULL)p │ │ │ │ │ +Fm(,)208 1449 y(then)c Fl(mtx->entries)22 b Fm(is)28 │ │ │ │ │ +b(set)f(to)h Fl(entries)d Fm(and)i Fl(nowned)e Fm(is)j(set)f(to)h │ │ │ │ │ +(zero.)208 1588 y Fh(Err)l(or)e(che)l(cking:)37 b Fm(If)25 │ │ │ │ │ +b Fl(mtx)d Fm(is)i Fl(NULL)p Fm(,)f(or)g(if)h Fl(n1)p │ │ │ │ │ +Fm(,)g Fl(n2)p Fm(,)g Fl(inc1)f Fm(or)g Fl(inc2)f Fm(are)h(less)h(than) │ │ │ │ │ +g(or)f(equal)g(to)h(zero,)g(or)f(if)h(the)h(matrix)208 │ │ │ │ │ +1688 y(is)k(not)h(full)h(matrix)e(\(i.e.,)i Fl(inc1)d │ │ │ │ │ +Fm(m)n(ust)i(b)r(e)g Fl(1)f Fm(and)h Fl(inc2)e Fm(m)n(ust)i(b)r(e)g │ │ │ │ │ +Fl(n1)p Fm(,)g Fh(or)g Fl(inc1)f Fm(m)n(ust)h(b)r(e)g │ │ │ │ │ +Fl(n2)f Fm(and)h Fl(inc2)e Fm(m)n(ust)i(b)r(e)208 1787 │ │ │ │ │ +y Fl(1)p Fm(\),)d(an)g(error)f(message)g(is)i(prin)n(ted)f(and)h(zero)e │ │ │ │ │ +(is)i(returned.)101 1965 y(2.)42 b Fl(void)f(A2_subA2)g(\()i(A2)g │ │ │ │ │ +(*mtxA,)e(A2)i(*mtxB,)905 2065 y(int)f(firstrow,)e(int)i(lastrow,)f │ │ │ │ │ (int)h(firstcol,)e(int)i(lastcol)f(\))i(;)208 2204 y │ │ │ │ │ Fm(This)27 b(initializer)g(metho)r(d)h(mak)n(es)f(the)h(ob)5 │ │ │ │ │ b(ject)27 b Fl(mtxA)f Fm(p)r(oin)n(t)i(in)n(to)f(a)h(submatrix)f(of)g │ │ │ │ │ (ob)5 b(ject)28 b Fl(mtxB)p Fm(,)e(as)208 2415 y Fl(A\(0:lastrow-fir)o │ │ │ │ │ (str)o(ow)o(,0)o(:la)o(st)o(col)o(-f)o(ir)o(stc)o(ol)o(\))38 │ │ │ │ │ b(=)43 b(B\(firstrow:lastr)o(ow)o(,)37 b(firstcol:lastcol\))208 │ │ │ │ │ 2626 y Fm(Note,)20 b Fl(firstrow)p Fm(,)d Fl(lastrow)p │ │ │ │ │ @@ -5008,17 +5001,17 @@ │ │ │ │ │ b(jor.)208 5308 y Fh(Err)l(or)31 b(che)l(cking:)40 b │ │ │ │ │ Fm(If)30 b Fl(Q)p Fm(,)e Fl(A)g Fm(or)g Fl(workDV)e Fm(is)j │ │ │ │ │ Fl(NULL)p Fm(,)e(or)h(if)h Fl(msglvl)41 b(>)i(0)28 b │ │ │ │ │ Fm(and)h Fl(msgFile)d Fm(if)j Fl(NULL)p Fm(,)e(an)h(error)f(message)g │ │ │ │ │ (is)208 5407 y(prin)n(ted)g(and)g(the)h(program)e(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 83 100 1248 4 v 1414 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -2613 100 V 1248 w Fm(5)101 390 y(4.)42 b Fl(void)f(A2_applyQT)f(\()j │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1266 4 v 1431 100 a Fl(A2)27 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)110 b Ff(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2595 100 V 1266 w Fm(5)101 390 y(4.)42 b Fl(void)f(A2_applyQT)f(\()j │ │ │ │ │ (A2)g(*Y,)f(A2)h(*A,)f(A2)h(*X,)f(DV)h(*workDV,)d(int)j(msglvl,)d(FILE) │ │ │ │ │ i(*msgFile)f(\))i(;)208 522 y Fm(This)22 b(metho)r(d)h(computes)f │ │ │ │ │ Fk(Y)42 b Fm(=)22 b Fk(Q)1296 491 y Fc(T)1348 522 y Fk(X)29 │ │ │ │ │ b Fm(\(if)23 b(real\))f(or)f Fk(Y)42 b Fm(=)22 b Fk(Q)2077 │ │ │ │ │ 491 y Fc(H)2140 522 y Fk(X)29 b Fm(\(if)23 b(complex\),)g(where)f │ │ │ │ │ Fk(Q)g Fm(is)g(stored)g(in)g(Householder)208 621 y(v)n(ectors)d(inside) │ │ │ │ │ j Fk(A)p Fm(.)35 b(W)-7 b(e)21 b(assume)g(that)h Fk(A)p │ │ │ │ │ @@ -5086,23 +5079,23 @@ │ │ │ │ │ 5176 y Fm(This)27 b(metho)r(d)h(returns)f(the)h(one-norm)e(of)i(ro)n(w) │ │ │ │ │ e Fl(irow)g Fm(of)i(the)g(matrix.)208 5308 y Fh(Err)l(or)d(che)l │ │ │ │ │ (cking:)36 b Fm(If)22 b Fl(mtx)f Fm(is)h Fl(NULL)p Fm(,)e(or)i │ │ │ │ │ Fl(irow)e Fm(is)i(not)g(in)g Fl([0,n1-1])p Fm(,)e(an)i(error)e(message) │ │ │ │ │ h(is)h(prin)n(ted)g(and)g(the)g(program)208 5407 y(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fm(6)p 125 100 1248 4 v │ │ │ │ │ -1413 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2652 100 V 101 390 a Fm(9.)42 b Fl(double)f │ │ │ │ │ -(A2_twoNormOfRow)c(\()43 b(A2)g(*mtx,)e(int)i(irow)f(\))h(;)208 │ │ │ │ │ -521 y Fm(This)27 b(metho)r(d)h(returns)f(the)h(t)n(w)n(o-norm)e(of)h │ │ │ │ │ -(ro)n(w)g Fl(irow)f Fm(of)h(the)h(matrix.)208 652 y Fh(Err)l(or)d(che)l │ │ │ │ │ -(cking:)36 b Fm(If)22 b Fl(mtx)f Fm(is)h Fl(NULL)p Fm(,)e(or)i │ │ │ │ │ -Fl(irow)e Fm(is)i(not)g(in)g Fl([0,n1-1])p Fm(,)e(an)i(error)e(message) │ │ │ │ │ -h(is)h(prin)n(ted)g(and)g(the)g(program)208 751 y(exits.)60 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fm(6)p 125 100 1266 4 v │ │ │ │ │ +1431 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2635 100 V 101 390 a Fm(9.)42 b Fl(double)f(A2_twoNormOfRow)c(\()43 │ │ │ │ │ +b(A2)g(*mtx,)e(int)i(irow)f(\))h(;)208 521 y Fm(This)27 │ │ │ │ │ +b(metho)r(d)h(returns)f(the)h(t)n(w)n(o-norm)e(of)h(ro)n(w)g │ │ │ │ │ +Fl(irow)f Fm(of)h(the)h(matrix.)208 652 y Fh(Err)l(or)d(che)l(cking:)36 │ │ │ │ │ +b Fm(If)22 b Fl(mtx)f Fm(is)h Fl(NULL)p Fm(,)e(or)i Fl(irow)e │ │ │ │ │ +Fm(is)i(not)g(in)g Fl([0,n1-1])p Fm(,)e(an)i(error)e(message)h(is)h │ │ │ │ │ +(prin)n(ted)g(and)g(the)g(program)208 751 y(exits.)60 │ │ │ │ │ 914 y(10.)41 b Fl(double)g(A2_infinityNorm)o(OfR)o(ow)c(\()43 │ │ │ │ │ b(A2)g(*mtx,)e(int)i(irow)f(\))h(;)208 1044 y Fm(This)27 │ │ │ │ │ b(metho)r(d)h(returns)f(the)h(in\014nit)n(y-norm)f(of)h(ro)n(w)e │ │ │ │ │ Fl(irow)g Fm(of)i(the)g(matrix.)208 1175 y Fh(Err)l(or)d(che)l(cking:) │ │ │ │ │ 36 b Fm(If)22 b Fl(mtx)f Fm(is)h Fl(NULL)p Fm(,)e(or)i │ │ │ │ │ Fl(irow)e Fm(is)i(not)g(in)g Fl([0,n1-1])p Fm(,)e(an)i(error)e(message) │ │ │ │ │ h(is)h(prin)n(ted)g(and)g(the)g(program)208 1275 y(exits.)0 │ │ │ │ │ @@ -5169,17 +5162,17 @@ │ │ │ │ │ (coloff)f(\))i(;)208 5218 y Fm(This)27 b(metho)r(d)h(is)g(used)f(to)h │ │ │ │ │ (shift)g(the)g(base)f(of)h(the)f(en)n(tries)g(and)h(adjust)g │ │ │ │ │ (dimensions)f(of)g(the)h Fl(A2)f Fm(ob)5 b(ject.)208 │ │ │ │ │ 5407 y Fl(mtx\(0:n1-rowoff)o(-1,)o(0:)o(n2)o(-co)o(lo)o(ff-)o(1\))37 │ │ │ │ │ b(:=)43 b(mtx\(rowoff:n1-1)o(,co)o(lo)o(ff:)o(n2)o(-1)o(\))p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 83 100 1248 4 v 1414 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -2613 100 V 1248 w Fm(7)208 390 y Fh(Err)l(or)i(che)l(cking:)38 │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1266 4 v 1431 100 a Fl(A2)27 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)110 b Ff(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2595 100 V 1266 w Fm(7)208 390 y Fh(Err)l(or)j(che)l(cking:)38 │ │ │ │ │ b Fm(If)28 b Fl(mtx)f Fm(is)g Fl(NULL)f Fm(an)i(error)d(message)h(is)i │ │ │ │ │ (prin)n(ted)f(and)h(the)g(program)d(exits.)101 551 y(3.)42 │ │ │ │ │ b Fl(int)g(A2_rowMajor)d(\()k(A2)g(*mtx)f(\))h(;)208 │ │ │ │ │ 682 y Fm(This)27 b(metho)r(d)h(returns)f(1)g(if)h(the)g(storage)e(is)i │ │ │ │ │ (ro)n(w)e(ma)5 b(jor,)26 b(otherwise)h(it)h(returns)f(zero.)208 │ │ │ │ │ 812 y Fh(Err)l(or)j(che)l(cking:)38 b Fm(If)28 b Fl(mtx)f │ │ │ │ │ Fm(is)g Fl(NULL)p Fm(,)f(an)i(error)d(message)i(is)g(prin)n(ted)h(and)f │ │ │ │ │ @@ -5253,19 +5246,19 @@ │ │ │ │ │ Fm(of)i(the)g(matrix)f(with)h(the)g(en)n(tries)f(in)h(the)g │ │ │ │ │ Fl(row[])d Fm(v)n(ector.)208 5308 y Fh(Err)l(or)k(che)l(cking:)39 │ │ │ │ │ b Fm(If)27 b Fl(mtx)p Fm(,)f Fl(entries)e Fm(or)j Fl(row[])e │ │ │ │ │ Fm(are)h Fl(NULL)p Fm(,)f(or)h(if)i Fl(irow)d Fm(is)i(not)g(in)h │ │ │ │ │ Fl([0,n1-1])p Fm(,)c(an)i(error)g(message)f(is)208 5407 │ │ │ │ │ y(prin)n(ted)i(and)g(the)h(program)e(exits.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fm(8)p 125 100 1248 4 v │ │ │ │ │ -1413 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2652 100 V 60 390 a Fm(13.)41 b Fl(void)g(A2_setRowDV)f │ │ │ │ │ -(\()j(A2)f(*mtx,)g(DV)h(rowDV,)e(int)h(irow)g(\))h(;)208 │ │ │ │ │ -520 y Fm(This)27 b(metho)r(d)h(\014lls)g(ro)n(w)e Fl(irow)g │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fm(8)p 125 100 1266 4 v │ │ │ │ │ +1431 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2635 100 V 60 390 a Fm(13.)41 b Fl(void)g(A2_setRowDV)f(\()j(A2)f │ │ │ │ │ +(*mtx,)g(DV)h(rowDV,)e(int)h(irow)g(\))h(;)208 520 y │ │ │ │ │ +Fm(This)27 b(metho)r(d)h(\014lls)g(ro)n(w)e Fl(irow)g │ │ │ │ │ Fm(of)i(the)g(matrix)f(with)h(the)g(en)n(tries)f(in)h(the)g │ │ │ │ │ Fl(rowDV)d Fm(ob)5 b(ject.)208 649 y Fh(Err)l(or)32 b(che)l(cking:)44 │ │ │ │ │ b Fm(If)31 b Fl(mtx)e Fm(or)h Fl(rowDV)e Fm(are)i Fl(NULL)p │ │ │ │ │ Fm(,)e(or)i(if)h(the)f(matrix)g(is)g(not)h(real,)f(or)f(if)i │ │ │ │ │ Fl(irow)e Fm(is)h(not)h(in)f Fl([0,n1-1])p Fm(,)208 749 │ │ │ │ │ y(an)d(error)e(message)i(is)g(prin)n(ted)h(and)f(the)h(program)e │ │ │ │ │ (exits.)60 908 y(14.)41 b Fl(void)g(A2_setRowZV)f(\()j(A2)f(*mtx,)g(ZV) │ │ │ │ │ @@ -5338,17 +5331,17 @@ │ │ │ │ │ (n2)o(\))19 b Fm(columns)24 b(are)208 5178 y(copied.)208 │ │ │ │ │ 5308 y Fh(Err)l(or)30 b(che)l(cking:)38 b Fm(If)28 b │ │ │ │ │ Fl(mtxA)e Fm(or)g Fl(mtxB)g Fm(is)i Fl(NULL)p Fm(,)d(or)i(if)h(the)g │ │ │ │ │ (matrices)e(are)h(not)g(of)h(the)f(same)g(t)n(yp)r(e,)h(an)f(error)f │ │ │ │ │ (message)208 5407 y(is)h(prin)n(ted)h(and)f(the)h(program)e(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 83 100 1248 4 v 1414 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -2613 100 V 1248 w Fm(9)60 390 y(23.)41 b Fl(void)g(A2_sub)h(\()h(A2)g │ │ │ │ │ +TeXDict begin 9 8 bop 83 100 1266 4 v 1431 100 a Fl(A2)27 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)110 b Ff(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2595 100 V 1266 w Fm(9)60 390 y(23.)41 b Fl(void)g(A2_sub)h(\()h(A2)g │ │ │ │ │ (*mtxA,)e(A2)h(*mtxB)g(\))h(;)208 523 y Fm(This)27 b(metho)r(d)h │ │ │ │ │ (subtracts)e(en)n(tries)h(in)h(matrix)e Fl(mtxB)g Fm(from)h(en)n(tries) │ │ │ │ │ g(in)g(matrix)g Fl(mtxA)p Fm(.)f(Note,)h Fl(mtxA)f Fm(and)h │ │ │ │ │ Fl(mtxB)f Fm(need)208 622 y(not)34 b(b)r(e)h(of)g(the)f(same)g(size,)i │ │ │ │ │ (the)f(leading)f Fl(min\(mtxA->n1,mtxB)o(->)o(n1\))28 │ │ │ │ │ b Fm(ro)n(ws)33 b(and)h Fl(min\(mtxA->n2,mtx)o(B->)o(n2)o(\))208 │ │ │ │ │ 722 y Fm(columns)27 b(are)f(subtracted.)208 855 y Fh(Err)l(or)k(che)l │ │ │ │ │ @@ -5435,18 +5428,18 @@ │ │ │ │ │ (in)i(reading)208 5275 y(the)i(data,)f(the)h(v)-5 b(alue)27 │ │ │ │ │ b Fl(1)g Fm(is)h(returned.)36 b(If)28 b(an)g(IO)f(error)f(is)h(encoun)n │ │ │ │ │ (tered)g(from)g Fl(fread)p Fm(,)f(zero)g(is)i(returned.)208 │ │ │ │ │ 5407 y Fh(Err)l(or)i(che)l(cking:)38 b Fm(If)28 b Fl(mtx)f │ │ │ │ │ Fm(or)g Fl(fp)f Fm(are)h Fl(NULL)p Fm(,)f(an)h(error)f(message)g(is)i │ │ │ │ │ (prin)n(ted)f(and)h(zero)e(is)i(returned.)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fm(10)p 166 100 1228 4 │ │ │ │ │ -v 1392 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2673 100 V 101 390 a Fm(4.)42 b Fl(int)g(A2_writeToFile)c │ │ │ │ │ -(\()43 b(A2)g(*mtx,)e(char)h(*fn)g(\))i(;)208 522 y Fm(This)31 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fm(10)p 166 100 1245 4 │ │ │ │ │ +v 1410 w Fl(A2)26 b Ff(:)37 b Fh(DRAFT)28 b Ff(Jan)n(uary)d(7,)i(2024)p │ │ │ │ │ +2656 100 V 101 390 a Fm(4.)42 b Fl(int)g(A2_writeToFile)c(\()43 │ │ │ │ │ +b(A2)g(*mtx,)e(char)h(*fn)g(\))i(;)208 522 y Fm(This)31 │ │ │ │ │ b(metho)r(d)h(writes)f(a)g Fl(A2)g Fm(ob)5 b(ject)31 │ │ │ │ │ b(to)h(a)f(\014le.)49 b(It)32 b(tries)f(to)g(op)r(en)h(the)g(\014le)g │ │ │ │ │ (and)f(if)h(it)g(is)f(successful,)i(it)f(then)g(calls)208 │ │ │ │ │ 622 y Fl(A2)p 301 622 27 4 v 30 w(writeFromFormatt)o(edF)o(il)o(e\(\)) │ │ │ │ │ 24 b Fm(or)29 b Fl(A2)p 1600 622 V 31 w(writeFromBinaryF)o(ile)o(\(\))o │ │ │ │ │ Fm(,)d(closes)j(the)i(\014le)g(and)f(returns)g(the)h(v)-5 │ │ │ │ │ b(alue)208 722 y(returned)27 b(from)g(the)h(called)f(routine.)208 │ │ │ │ │ @@ -5522,17 +5515,17 @@ │ │ │ │ │ Fm(parameter)g(is)h(the)h(n)n(um)n(b)r(er)g(of)f(ro)n(ws.)307 │ │ │ │ │ 5144 y Fi(\210)42 b Fm(The)28 b Fl(ncol)e Fm(parameter)g(is)h(the)h(n)n │ │ │ │ │ (um)n(b)r(er)g(of)f(ro)n(ws.)307 5275 y Fi(\210)42 b │ │ │ │ │ Fm(The)28 b Fl(inc1)e Fm(parameter)g(is)h(the)h(ro)n(w)f(incremen)n(t.) │ │ │ │ │ 307 5407 y Fi(\210)42 b Fm(The)28 b Fl(inc2)e Fm(parameter)g(is)h(the)h │ │ │ │ │ (column)g(incremen)n(t.)p eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 83 100 1228 4 v 1393 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2592 100 V 1228 w Fm(11)307 390 y Fi(\210)42 b Fm(The)28 │ │ │ │ │ +TeXDict begin 11 10 bop 83 100 1245 4 v 1411 100 a Fl(A2)26 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)111 b Ff(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2574 100 V 1245 w Fm(11)307 390 y Fi(\210)42 b Fm(The)28 │ │ │ │ │ b Fl(seed)e Fm(parameter)g(is)h(a)h(random)e(n)n(um)n(b)r(er)i(seed.) │ │ │ │ │ 101 573 y(2.)42 b Fl(test_QR)e(msglvl)h(msgFile)g(type)h(nrow)g(ncol)g │ │ │ │ │ (inc1)g(inc2)g(seed)208 706 y Fm(This)22 b(driv)n(er)g(program)e(tests) │ │ │ │ │ j(the)g Fl(A2)p 1376 706 27 4 v 30 w(QRreduce\(\))c Fm(and)k │ │ │ │ │ Fl(A2)p 2110 706 V 30 w(QRreduce2\(\))18 b Fm(metho)r(ds)23 │ │ │ │ │ b(whic)n(h)g(reduce)f Fk(A)h Fm(to)g Fk(QR)g Fm(via)208 │ │ │ │ │ 805 y(rank-1)g(and)i(rank-2)f(up)r(dates.)36 b(Use)25 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -20,15 +20,15 @@ │ │ │ │ │ │ • A2 IS REAL(mtx) is 1 if mtx has real entries and 0 otherwise. │ │ │ │ │ │ • A2 IS COMPLEX(mtx) is 1 if mtx has complex entries and 0 otherwise. │ │ │ │ │ │ TheA2 copyEntriesToVector()methodusesthefollowingconstants: A2 STRICT LOWER,A2 LOWER,A2 DIAGONAL, │ │ │ │ │ │ A2 UPPER, A2 STRICT UPPER, A2 ALL ENTRIES, A2 BY ROWS and A2 BY COLUMNS. │ │ │ │ │ │ 1.2 Prototypes and descriptions of A2 methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the A2 object. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 A2 : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 A2 : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ Asusual, there are four basic methods to support object creation, setting default fields, clearing any allocated │ │ │ │ │ │ data, and free’ing the object. │ │ │ │ │ │ 1. A2 * A2_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the A2 structure and then sets the default fields by a call to │ │ │ │ │ │ A2 setDefaultFields(). │ │ │ │ │ │ 2. void A2_setDefaultFields ( A2 *mtx ) ; │ │ │ │ │ │ @@ -56,15 +56,15 @@ │ │ │ │ │ │ 4. int A2_inc2 ( A2 *mtx ) ; │ │ │ │ │ │ This method returns the secondary increment, the stride in memory (with respect to real or complex │ │ │ │ │ │ entries) between adjacent entries in the same row. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 5. double * A2_entries ( A2 *mtx ) ; │ │ │ │ │ │ This method returns a pointer to the base address of the entries. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - A2 : DRAFT February 8, 2025 3 │ │ │ │ │ │ + A2 : DRAFT January 7, 2024 3 │ │ │ │ │ │ 6. double * A2_row ( A2 *mtx, int irow ) ; │ │ │ │ │ │ This method returns a pointer to the leading element of row irow. │ │ │ │ │ │ Error checking: If mtx or entries is NULL, or if irow is not in [0,n1-1], an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 7. double * A2_column ( A2 *mtx, int jcol ) ; │ │ │ │ │ │ This method returns a pointer to the leading element of column jcol. │ │ │ │ │ │ Error checking: If mtx or entries is NULL, or if jcol is not in [0,n2-1], an error message is printed │ │ │ │ │ │ @@ -93,15 +93,15 @@ │ │ │ │ │ │ or if jcol is not in [0,n2-1], an error message is printed and the program exits. │ │ │ │ │ │ 13. void A2_pointerToComplexEntry ( A2 *mtx, int irow, int jcol, │ │ │ │ │ │ double **ppReal, double **ppImag ) ; │ │ │ │ │ │ This method sets *ppReal to the pointer to the real part of the (irow,jcol) entry, and sets *ppImag │ │ │ │ │ │ to the pointer to the imaginary part of the (irow,jcol) entry. │ │ │ │ │ │ Error checking: If mtx, ppReal or ppImag is NULL, or if the matrix is not complex, or if irow is not in │ │ │ │ │ │ [0,n1-1], or if jcol is not in [0,n2-1], an error message is printed and the program exits. │ │ │ │ │ │ - 4 A2 : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 A2 : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.3 Initialize methods │ │ │ │ │ │ 1. void A2_init ( A2 *mtx, int type, int n1, int n2, int inc1, int inc2, │ │ │ │ │ │ double *entries ) ; │ │ │ │ │ │ This is the basic initializer method. We require that mtx not be NULL, type be either SPOOLES REAL │ │ │ │ │ │ or SPOOLES COMPLEX, n1 and n2 both be positive, and both inc1 and inc2 both be positive and that │ │ │ │ │ │ one of them be equal to one. Also, we only initialize a full matrix, i.e., one of inc1 = 1 and inc2 = │ │ │ │ │ │ nrow or inc1 = ncol and inc2 = 1 must hold. │ │ │ │ │ │ @@ -134,15 +134,15 @@ │ │ │ │ │ │ Error checking: If A or workDV is NULL, or if msglvl > 0 and msgFile if NULL, an error message is │ │ │ │ │ │ printed and the program exits. │ │ │ │ │ │ 3. void A2_computeQ ( A2 *Q, A2 *A, DV *workDV, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method computes Q from the A = QR factorization computed in A2 QRreduce(). Note: A and Q │ │ │ │ │ │ must be column major. │ │ │ │ │ │ Error checking: If Q, A or workDV is NULL, or if msglvl > 0 and msgFile if NULL, an error message is │ │ │ │ │ │ printed and the program exits. │ │ │ │ │ │ - A2 : DRAFT February 8, 2025 5 │ │ │ │ │ │ + A2 : DRAFT January 7, 2024 5 │ │ │ │ │ │ 4. void A2_applyQT ( A2 *Y, A2 *A, A2 *X, DV *workDV, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ T H │ │ │ │ │ │ This method computes Y = Q X (if real) or Y = Q X (if complex), where Q is stored in Householder │ │ │ │ │ │ vectors inside A. We assume that A2 reduce() has been previously called with A as an argument. Since │ │ │ │ │ │ Y is computed column-by-column, X and Y can be the same A2 object. The workDV object is resized │ │ │ │ │ │ as necessary. Note: Y, A and X must be column major. │ │ │ │ │ │ Error checking: If Y, A, X or workDV is NULL, or if msglvl > 0 and msgFile if NULL, or if Y, A or X is │ │ │ │ │ │ @@ -174,15 +174,15 @@ │ │ │ │ │ │ This method returns the infinity-norm of column jcol of the matrix. │ │ │ │ │ │ Error checking: If mtx is NULL, or jcol is not in [0,n2-1], an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 8. double A2_oneNormOfRow ( A2 *mtx, int irow ) ; │ │ │ │ │ │ This method returns the one-norm of row irow of the matrix. │ │ │ │ │ │ Error checking: If mtx is NULL, or irow is not in [0,n1-1], an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - 6 A2 : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 A2 : DRAFT January 7, 2024 │ │ │ │ │ │ 9. double A2_twoNormOfRow ( A2 *mtx, int irow ) ; │ │ │ │ │ │ This method returns the two-norm of row irow of the matrix. │ │ │ │ │ │ Error checking: If mtx is NULL, or irow is not in [0,n1-1], an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 10. double A2_infinityNormOfRow ( A2 *mtx, int irow ) ; │ │ │ │ │ │ This method returns the infinity-norm of row irow of the matrix. │ │ │ │ │ │ Error checking: If mtx is NULL, or irow is not in [0,n1-1], an error message is printed and the program │ │ │ │ │ │ @@ -213,15 +213,15 @@ │ │ │ │ │ │ 1.2.7 Utility methods │ │ │ │ │ │ 1. int A2_sizeOf ( A2 *mtx ) ; │ │ │ │ │ │ This method returns the number of bytes owned by this object. │ │ │ │ │ │ Error checking: If mtx is NULL an error message is printed and the program exits. │ │ │ │ │ │ 2. void A2_shiftBase ( A2 *mtx, int rowoff, int coloff ) ; │ │ │ │ │ │ This method is used to shift the base of the entries and adjust dimensions of the A2 object. │ │ │ │ │ │ mtx(0:n1-rowoff-1,0:n2-coloff-1) := mtx(rowoff:n1-1,coloff:n2-1) │ │ │ │ │ │ - A2 : DRAFT February 8, 2025 7 │ │ │ │ │ │ + A2 : DRAFT January 7, 2024 7 │ │ │ │ │ │ Error checking: If mtx is NULL an error message is printed and the program exits. │ │ │ │ │ │ 3. int A2_rowMajor ( A2 *mtx ) ; │ │ │ │ │ │ This method returns 1 if the storage is row major, otherwise it returns zero. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. int A2_columnMajor ( A2 *mtx ) ; │ │ │ │ │ │ This method returns 1 if the storage is column major, otherwise it returns zero. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ @@ -253,15 +253,15 @@ │ │ │ │ │ │ This method fills the colZV object with column jcol of the matrix. │ │ │ │ │ │ Error checking: If mtx or colZV are NULL, or if the matrix is not complex, or if jcol is not in [0,n2-1], │ │ │ │ │ │ an error message is printed and the program exits. │ │ │ │ │ │ 12. void A2_setRow ( A2 *mtx, double row[], int irow ) ; │ │ │ │ │ │ This method fills row irow of the matrix with the entries in the row[] vector. │ │ │ │ │ │ Error checking: If mtx, entries or row[] are NULL, or if irow is not in [0,n1-1], an error message is │ │ │ │ │ │ printed and the program exits. │ │ │ │ │ │ - 8 A2 : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 A2 : DRAFT January 7, 2024 │ │ │ │ │ │ 13. void A2_setRowDV ( A2 *mtx, DV rowDV, int irow ) ; │ │ │ │ │ │ This method fills row irow of the matrix with the entries in the rowDV object. │ │ │ │ │ │ Error checking: If mtx or rowDV are NULL, or if the matrix is not real, or if irow is not in [0,n1-1], │ │ │ │ │ │ an error message is printed and the program exits. │ │ │ │ │ │ 14. void A2_setRowZV ( A2 *mtx, ZV rowZV, int irow ) ; │ │ │ │ │ │ This method fills row irow of the matrix with the entries in the rowZV object. │ │ │ │ │ │ Error checking: If mtx or rowZV are NULL, or if the matrix is not complex, or if irow is not in [0,n1-1], │ │ │ │ │ │ @@ -294,15 +294,15 @@ │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 22. void A2_copy ( A2 *mtxA, A2 *mtxB ) ; │ │ │ │ │ │ This method copies entries from matrix mtxB into matrix mtxA. Note, mtxA and mtxB need not be of │ │ │ │ │ │ the same size, the leading min(mtxA->n1,mtxB->n1)rows and min(mtxA->n2,mtxB->n2)columns are │ │ │ │ │ │ copied. │ │ │ │ │ │ Error checking: If mtxA or mtxB is NULL, or if the matrices are not of the same type, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ - A2 : DRAFT February 8, 2025 9 │ │ │ │ │ │ + A2 : DRAFT January 7, 2024 9 │ │ │ │ │ │ 23. void A2_sub ( A2 *mtxA, A2 *mtxB ) ; │ │ │ │ │ │ This method subtracts entries in matrix mtxB from entries in matrix mtxA. Note, mtxA and mtxB need │ │ │ │ │ │ not be of the same size, the leading min(mtxA->n1,mtxB->n1) rows and min(mtxA->n2,mtxB->n2) │ │ │ │ │ │ columns are subtracted. │ │ │ │ │ │ Error checking: If mtxA or mtxB is NULL, or if the matrices are not of the same type, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 24. void A2_swapRows ( A2 *mtx, int irow1, int irow2 ) ; │ │ │ │ │ │ @@ -335,15 +335,15 @@ │ │ │ │ │ │ This method reads a A2 object from a formatted file whose pointer is fp. If there are no errors in │ │ │ │ │ │ reading the data, the value 1 is returned. If an IO error is encountered from fscanf, zero is returned. │ │ │ │ │ │ Error checking: If mtx or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 3. int A2_readFromBinaryFile ( A2 *mtx, FILE *fp ) ; │ │ │ │ │ │ This method reads a A2 object from a binary file whose pointer is fp. If there are no errors in reading │ │ │ │ │ │ the data, the value 1 is returned. If an IO error is encountered from fread, zero is returned. │ │ │ │ │ │ Error checking: If mtx or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - 10 A2 : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 A2 : DRAFT January 7, 2024 │ │ │ │ │ │ 4. int A2_writeToFile ( A2 *mtx, char *fn ) ; │ │ │ │ │ │ This method writes a A2 object to a file. It tries to open the file and if it is successful, it then calls │ │ │ │ │ │ A2 writeFromFormattedFile() or A2 writeFromBinaryFile(), closes the file and returns the value │ │ │ │ │ │ returned from the called routine. │ │ │ │ │ │ Error checking: If mtx or fn are NULL, or if fn is not of the form *.a2f (for a formatted file) or *.a2b │ │ │ │ │ │ (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ 5. int A2_writeToFormattedFile ( A2 *mtx, FILE *fp ) ; │ │ │ │ │ │ @@ -374,15 +374,15 @@ │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • The type parameter denotes the type of entries — SPOOLES REAL or SPOOLES COMPLEX │ │ │ │ │ │ • The nrow parameter is the number of rows. │ │ │ │ │ │ • The ncol parameter is the number of rows. │ │ │ │ │ │ • The inc1 parameter is the row increment. │ │ │ │ │ │ • The inc2 parameter is the column increment. │ │ │ │ │ │ - A2 : DRAFT February 8, 2025 11 │ │ │ │ │ │ + A2 : DRAFT January 7, 2024 11 │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ 2. test_QR msglvl msgFile type nrow ncol inc1 inc2 seed │ │ │ │ │ │ This driver program tests the A2 QRreduce()and A2 QRreduce2()methods which reduce A to QR via │ │ │ │ │ │ rank-1 and rank-2 updates. Use the script file do QR for testing. When msglvl > 1, the matrix A and │ │ │ │ │ │ matrices R1 and R2 (computed from A2 QRreduce()and A2 QRreduce2(),respectively) are printed to │ │ │ │ │ │ T T T T │ │ │ │ │ │ the message file. When the output file is loaded into matlab, the errors A A−R R and A A−R R │ │ │ ├── ./usr/share/doc/spooles-doc/AllInOne.ps.gz │ │ │ │ ├── AllInOne.ps │ │ │ │ │ @@ -12,15 +12,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o AllInOne.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0424 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2705,30 +2705,28 @@ │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 46 /period put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 61 /equal put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 66 /B put │ │ │ │ │ dup 67 /C put │ │ │ │ │ dup 68 /D put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ dup 71 /G put │ │ │ │ │ dup 74 /J put │ │ │ │ │ dup 75 /K put │ │ │ │ │ dup 80 /P put │ │ │ │ │ dup 82 /R put │ │ │ │ │ dup 87 /W put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 102 /f put │ │ │ │ │ dup 103 /g put │ │ │ │ │ dup 104 /h put │ │ │ │ │ dup 105 /i put │ │ │ │ │ dup 107 /k put │ │ │ │ │ @@ -2924,216 +2922,203 @@ │ │ │ │ │ 66D4EBC86C0DF27B789D5597FE88BCDAD2925CFF60F5A8EA618FE867857D585A │ │ │ │ │ CE25A158AED63B8FE391030C518693AEC75AC0AADD0C11B0065E2ABCF51132F3 │ │ │ │ │ 82E3718B9A9FAAF727F2D8286177EE27BAD040C66D0D2D7C092B45D9330265B5 │ │ │ │ │ 6B5C8E29F71C9EF548BFA4BAFAB242B26455E4B7FC1882D68E408D25E6F58EC3 │ │ │ │ │ 046AAFC52C182BDCD36034FD58E8B379C9F2BD16FA6FBB8C455E36A1BEA8F803 │ │ │ │ │ 2AC069379392D74A6E8DD64AAC6FB5E7EE151EE99AF33B1D9E55C5C8D601EEB7 │ │ │ │ │ 2C194E090D261E86199D6576EC00044C87B3E79C39B4CBCBF391B78C1E9D17AE │ │ │ │ │ -FC99092341499E3160303A843D8D858FD9F209F919A884F4CF162643A8BBAD69 │ │ │ │ │ -384089F0CC5F15CE4179710883F8F87DF7398CEA29065D8D0EECF16A62FCD89B │ │ │ │ │ -877F399CCEF8F36475782F0BFF6D25A3CFB5733F8E1C4BF58AA40C991A4D0EF8 │ │ │ │ │ -B73255F64C66D5A58203675B738F4C93D85E9A4850442EE80DB5772B2344C670 │ │ │ │ │ -FB7958F90B205BDB0779BD4C678EA9CBF0E439819C9605839DC0870F22BD2B01 │ │ │ │ │ -713CCC99AC35354C7F42AD18792A9A7AA4E65FD73D0DC558939B373FD4EBFDC9 │ │ │ │ │ -63AFFC755A9AB945D3DC357C3D53CFF50F60667650394D7D7D52086E8472F281 │ │ │ │ │ -A33A2107D62846A48FE63B7C8167E8AC430EC64855A69D3DDDF50D7ABB3E2CDE │ │ │ │ │ -CBDF8AF233C62869B863016163249F8217B8EB6DAA32E142D8D18C806DAB5683 │ │ │ │ │ -DC0576B51E6DFBBF638D1D759E8F030FAD4039DE44BBBB347844AA0EAED096DB │ │ │ │ │ -BEC468F18BF07378D352D6ABEDD71F9CEFAF1C73CBA5489DA8B95E2D61B329A5 │ │ │ │ │ -C4D81951738724DB52065C86D18732F469567189255200701A346CA29ABCC787 │ │ │ │ │ -695E04C3E4248F61D8CB597E27A1575B9811443EEAF5F97BB2167EACBB0BC2AF │ │ │ │ │ -967D7D7B257A8EC1CD1970E2E0C2B9E1B3EF4F68F7D73E49C7E3B772ECB52967 │ │ │ │ │ -5DBA0B8296F13035C5B57B19D20E8415ACEDF854B3DF9FAE8774434405998CD8 │ │ │ │ │ -84E82DC5928D629196ADE2247EFD4CD73333D2B89C081DCAD5C4DC9880E42F98 │ │ │ │ │ -2F1E4793C9D6B7A727742EEBB6A87AA4FCF218DDD23AB836FD8AF460051BA69C │ │ │ │ │ -818003F264B59AEB65BBA5D8EA249F680414529F4F1B1C55AFF5D9D3DB838596 │ │ │ │ │ -70EB55DE10FA90D4CDC57606606CC432187CACEE595CAC96EEDE64F0E38E7539 │ │ │ │ │ -3AC65D668A2D5B2C7356E8188FF076042C85F2749D5A8C737F923D4BA4FF54E5 │ │ │ │ │ -EC913C96A06A2D94328E175FC6DA0B3FB1B31E2FE2A6949D5B43C42925D36ADB │ │ │ │ │ -EEA7E48FB6EB88FCF8D4607162594C9663769FE2196FCD412F6A919C045C527C │ │ │ │ │ -1DE564467BA2AA40FA4FE3498AA7A8DD2AEC3D2E6C357F99F3A5764E1BEE6C8E │ │ │ │ │ -E443D695E6B9CC3E520533BBB3F836766B6554B2BA299BE490137AF8D927DC23 │ │ │ │ │ -E1380ECC8654DBEE3B56A68F804A8300D2806251809E8F106870856FA0BEFBAE │ │ │ │ │ -8AB037C80A92D19F86EEEFB497CA10D892F2CA04EEA91D6C542B4BAEA3B75D84 │ │ │ │ │ -24A7899079B86BB96058718D1FAA194A83C0621B767002AFC49A9CD9F9302186 │ │ │ │ │ -72AC5E8A2F843360F4DAECB2F1F20750D24FB19ACE79A58077156DCE5F652E13 │ │ │ │ │ -87BD302832DAF1A2D6B55A750706170D37E3D9D98EFFCCBB7AC84095128C1A9B │ │ │ │ │ -7F781C815FE4A41492064CE05881B2E36655C2842F5C7FCF3F4B816EED500793 │ │ │ │ │ -144ECEACC56DF54B06EE80CEBC1B63C624AAF31F06FBC43FA2234A8554A3D73B │ │ │ │ │ -5741A397817F997C7C49A4DC9F379829016BB932F11B8E7A2825204349C5E7C0 │ │ │ │ │ -A968AD9FEF55944B76F603F6D1F5C2AC36F97BECBC8FDBD5859D2B5B1E9AC6C3 │ │ │ │ │ -58DAA56907ABE0D3EF4DE352550F774C91CC0C44AD923CABE199F11CF8DB1FDD │ │ │ │ │ -46AD64729A9DDEE609A66FE07CF8792D97FFDAE04F5B5E2E4910CA7953487361 │ │ │ │ │ -D052A2C0B6151C4E5205BA6321030859D223078B9D5F7FF4967F139BA8E4B30B │ │ │ │ │ -5BEFC8FE2092AC4337AFE0BC38C60FC53EA7A0D90090E6ADF8657FB539507833 │ │ │ │ │ -1F0463A21EE424E47EF1A7B5D7486F55EBF0F13E3EFA45215FCC2270E74DFCD9 │ │ │ │ │ -625DBFD3B9C87F41F17445CFC6919DDF949C9E6CBABB704876B32D9AD514FA72 │ │ │ │ │ -ACB3444AE175F5D11796E9CAF5FB1F318DFA6567190361229A7F207A472F5B6A │ │ │ │ │ -7421FF57C7C162F979962749180EFC8E623E3B110B7D89CD1D504B04F870334F │ │ │ │ │ -21568AA5756B20721115334DC1FBE08BD75D0CAB3BEB2E1C3FC692165C6DC425 │ │ │ │ │ -3877EC61327831655BD540EEE414E2616EA89A0EE219587E209B4CEEDFE45077 │ │ │ │ │ -F24B3FF7671937E8068F27482BF28C1EB7E54026E0155225A6B3F75EE4B7B0BB │ │ │ │ │ -32B5F974686701BA1CD5C3C2CCD818C0E2005FDB766A05B3AC5453CA9C71EF94 │ │ │ │ │ -A16081DA364C8790B5CE4D8852BB4E805AFB7AE91E3ABA273ACB7CF4113E6793 │ │ │ │ │ -AC1D6505D95CE7252EC17998166CAB392BADE5A5EAC604FFC8019839D09CBB8D │ │ │ │ │ -34C0E8A08B53FD73EA3C1EA482B8AD1C83E25F5A93CEB7533717CB0B3F369033 │ │ │ │ │ -0B0E2B8BD036DC3A8ADFAD03D3AA843DC5A4BF51691B919B7962A1D5B4A704FC │ │ │ │ │ -F924A72CD77564C1F14F5382B2C4C2243F94BD73AB81A3D6CC3E039B6F97B6CC │ │ │ │ │ -8051FF14AFD9B1151A8F8642E0FF00D77D6771529346E8E4537EC37B66916607 │ │ │ │ │ -02E5F7EAD243A27344277376963BAA71B89511E86B0681C01B08F9749F12DF88 │ │ │ │ │ -60E261304428185F32BA261740BBA92B57F84AEA085256D6ADB3F10A18755796 │ │ │ │ │ -670962F0F2796D82479011D94559A154C78E1DAE7F6E56A0E6994D94B9A90527 │ │ │ │ │ -E311B9E690E6F5D7ADB02D6F57CD96C63FAF1B395AF9288B058A5B4F808C76AF │ │ │ │ │ -68FFDB416935BFEF12934A34021EFD5D808E8FCDCD445A2EB383FCC5C5A6D27B │ │ │ │ │ -8CD874A39D04CA9B9307B96301654B36D980DC6DA31E42586CFF8BBD2B4026C5 │ │ │ │ │ -A9097C0D3DBFDB179BDB077406724FF3CB2FB01C76916E2FD245D479AF971A90 │ │ │ │ │ -4203A64DF57DB44BA87615CD978DE7B3DE159D857EA3D58CAA1A63E121610E1D │ │ │ │ │ -803A92418CB39559B5F738F5D89EF66D9F04DAAD98F17E2455F05DD51DA3F41A │ │ │ │ │ -2B8B69702EDA6A0AC99B799F48EDDBB611554A9F65954A2060798182C31A347F │ │ │ │ │ -C14A08961DD38F4DE279F82CCC35922A6A7ED494B3E9F6D24F2C44C6E9EB730D │ │ │ │ │ -587DF5DF760901D7D8A447CE6600D7A44AB9ACBFBF98677FCDCA0E1DC1072E1D │ │ │ │ │ -294AA6775663AA877E1031E196222F6CA13DF7A6F22E20DB3BEA60DCD0999329 │ │ │ │ │ -282D1378C1210A43F3F5A323005A3EACB319D048A4C4E368C72D171CE82DBFA1 │ │ │ │ │ -38B8C87D05891B1C985522E98E0C11950E7AC5DADC15513E5E230FDDEE52AFE8 │ │ │ │ │ -8AB3DA87082F844317138700B04CEAEA603AB7C6B39361CFB461E274D08F9FE5 │ │ │ │ │ -C4D8E6EF94DB9A2729C2E237D2D9E9251FEA4BB6C7CDA541E2498F462F7CDC9C │ │ │ │ │ -3A853D0F084BCF79B404B882600CAAB559AB710C8AEA0E22E0606E857CDD3BD4 │ │ │ │ │ -F157662DB751EEA1F2B670867D761AE799810B31FC458F1BD5D78895F6FFC4E6 │ │ │ │ │ -C7901F715B2F222CDDE7B549C239B7F9B394D3E1104B240C0BB1B21ABF590D6A │ │ │ │ │ -485D3ECEDF2001B457AB93065B3EEF857628C3B2E65C8F2636A6C82444A2F7B4 │ │ │ │ │ -775C126F1EB8BF511CBC1C27CF4F2AD9F0FE4449E4B6AA2A5507BBE1D2703101 │ │ │ │ │ -1131B7287BBD5CF46A1EEC8AFDC05DE42899D634CF9F16167AE1ABD70D8AF4F8 │ │ │ │ │ -19EAA56D51D609120D5AB7A8CD74BF759D9E33FA615A9AFEA56A8FCC0D41207D │ │ │ │ │ -FDFA1E3102AEBA240955684C0A413A1819B56254015C982E9F3F6DC8EF0490FE │ │ │ │ │ -5ECE529E577B3E8D5E5BF097ECB95711560A06559ECFCFE5BA36DC4496F0D423 │ │ │ │ │ -F7FFFA0C7C0F592AA607FF07411149B7413C3A5C240F4A06A00CA5D09D720E9D │ │ │ │ │ -06EF0AA1C644E6C42697EC952AE79A45214CB29018E27D0306366E93CBDC3BD9 │ │ │ │ │ -75150783EED3147575B529A5ED88DDB7C8C3C4DDFF727F99EA80DB97AE9D577F │ │ │ │ │ -2B0BCD2B39F990FA83FA395504084B603C0C4B726BE752B1CF5153B727F127A1 │ │ │ │ │ -8D4C81B0A10A4C734113644C95607C976678C3D4C28090F5533CBC62D72082C8 │ │ │ │ │ -CA524C60CDBC3A9F383C99D086E095039DA1FE110D5D4E73AE23F4F7055A6E54 │ │ │ │ │ -2EC89E5B25BB7634C670D833D2570AEB2D5CB114B5DD8461E6606E3E3CA8C38F │ │ │ │ │ -F7EF37B8245CFED5EECEA0B57C0D846910F10C238927CEE81B3ADD565CEC1B44 │ │ │ │ │ -869859FB54B49A00FD50F34CC44FAC3FAD0750863D2DC46913E6195859B97E66 │ │ │ │ │ -E81278660666517A9DC45F5A28049C70B1640C7F2441211163F88460ED4D3DA4 │ │ │ │ │ -16A7E3790E4DCB7D66AA11C581956826553CA6782F41960071078B80294A4977 │ │ │ │ │ -0A72DED4EF6D4F286E7662B2E30CD87057063A9C40E5DC0110626B155EE3784C │ │ │ │ │ -B3058E67139A0C31C9C784BEC9899F6261E0829E0DE05A1391CB4AECF2A8094C │ │ │ │ │ -ED0F9E81C25A398DED8DF4E115420F989127A04BDE96B74433E452E575A6A0C5 │ │ │ │ │ -568693282AB0833D4FC87A3C0E02E76402E37C95942E68532834C0CB26C8F90F │ │ │ │ │ -75B26F9BFBE429289A766B0DBCC5A58A5C437FF2E2ED990351219F44E6BD3A77 │ │ │ │ │ -12A4DAD5C8EF1E2AA5E2E5DE14A451E0D32B923863EED375F896D1F065BA498A │ │ │ │ │ -70060E9225154A66B48046AD8D1D6076A49D632A2EBCD09A47E4BDA25EDC8265 │ │ │ │ │ -DCBADB8C673352F09F1D06B1C6F890A22A009A2AA6E8280E9E106D1E1FFCD307 │ │ │ │ │ -1BB3985C7FD71F22EFC4737B619F2FE24D7EC7E6DB081930E189281A508B27FA │ │ │ │ │ -02174EFFEEED006E28DFD05785D612C2A18EE1945295F265DC5E7485CEA7BD15 │ │ │ │ │ -819824DB1A4D50FE4F58450582D1A3EF665B8BB0F7E1084E5DC801912921939B │ │ │ │ │ -1D03202CCA6A48B813437935DE1B7B984ACE22CFC5B8D5628F436757B793297D │ │ │ │ │ -F033C41ED85F5C2F31D9B197F8CEAD39E04B313DF2888E51C26138F66D72A9DB │ │ │ │ │ -6D3F4004124CF9730744F94AE342D77BC708AA89BBD848B9B105AAF456871E14 │ │ │ │ │ -1AED722870FAF1BB03503B65DE6B084AACF6908C0CA49728FBB6FE716AC79391 │ │ │ │ │ -AC23022A82AA1376E589A99DD29ADA5E5F1C8DA54D05FC3BBD5AE322E46F8BA7 │ │ │ │ │ -6BF134570A4A025D8FD0753E45880B331093793B4EB14B28016059C16A0DC0FE │ │ │ │ │ -B46B0772BDEE6B5572FC8F652E4F09396EA48633CF5473C3646255E70F57F8CC │ │ │ │ │ -7F1654D484C7B86DE621A1E0782A9D269F205FC84CE4E547AEBCB96D702631D0 │ │ │ │ │ -899FF0B6DD18CA7022E7462E40B9E378DC88328CAD3C8E52D1FCE0DD170941E3 │ │ │ │ │ -68A02E6ED154ABB5334C5BB4297EEB4C08A2FDC1472CBB3CB3C2C58668433DF3 │ │ │ │ │ -D63D4FA4A9C7943A150091DA97B27987F6681E07B76437F04C5FD6A4C9EE43CD │ │ │ │ │ -F284B1A940DB08AB09BBF034E2BE64FF1822568EC0EF98C24E26A0BB8479D827 │ │ │ │ │ -A72D279508F61993DC4FF5A0C192F431322DF65265435247D99B19282DD7515A │ │ │ │ │ -B66564F8DC4D63A356D46F6F29982BE07CB2F81F23A2D9FCB3FF59C68B2509D5 │ │ │ │ │ -755D255925CF9B149B8856D858835C4E119B189AB7D77988BD2C0CC818174262 │ │ │ │ │ -8742820E47B5FC695CBC126EE2B757D6502539E363D3A0AB0FB39E106B8EF640 │ │ │ │ │ -5F6ED4FB1EF8E81280F0D3475B9DADF80D8580BB4249E3180EAA87DB2D66FE78 │ │ │ │ │ -E6518F3EBAD397F383D7D46030795AE9130DE604F5D22D3445C6BDE4834C79E9 │ │ │ │ │ -88AA8CF34B8549271AC3599A8BDB68ADEB8A93A916884AAE9C0B150DFD5136DB │ │ │ │ │ -D91A1759439E4F4C828D7FF50D459F17D0EB7B246FB93585F37D1204477CDA46 │ │ │ │ │ -12CDCF3BE6476EC15491F16672E07306C4F5ADB6EB7ECAD3F6C07632F1A36CD8 │ │ │ │ │ -D1C730B844DA4EAEF990B99CD9C4EE691A7443E55CEA0632C8B98E5C5FE9B3BB │ │ │ │ │ -2755E756ED10387A8C57869AA809208E39C79C4131D0BA42025FB70B47FD925A │ │ │ │ │ -21A8345AE7B78CA0255BA647FA01C18630097A7A4A78FCF14FB481AA125C45A2 │ │ │ │ │ -7BBFF1215311FB10676181F9E46B9D92F5417C3912D85A0354DBB5CFD26DBBB2 │ │ │ │ │ -20499BD34B7E9CD516AE3B89A4224F41A0C2B8FE33CE66A74F9874CEC997C663 │ │ │ │ │ -33B8D80B0FCAC61A96A69F41812E43F084ADD3A3CBA373A064FFF4410C81DE80 │ │ │ │ │ -50FDCE801C1E82A83D2C16EEC1E79A30440E7F8B93151705FBF13C08EF8DDDEF │ │ │ │ │ -22B7D6372BE53BA3018928F45EC509C5F6D70EC2CA362C7EFE97AC764CE16A76 │ │ │ │ │ -89DB48AB09B1F8D915A8B0B9AFFF2C8F676318DAEC47A539ACB20ED6EAA5C822 │ │ │ │ │ -84EA1B73437EC8226831E5B7D46676381A8B6907CBAB96CD4390D7AC04AAC688 │ │ │ │ │ -6DFAC0FA5B4DFFA02DF1EF417EE94D6D75EE8505A8BE7C64ED2835A7DB88E9E0 │ │ │ │ │ -F72B08C9CA6CA88A4A614BA1F039438305E736D40DFB03B19CAF65A6F5485580 │ │ │ │ │ -7B9D70D421F273CA2CA47AC060FB482B86FED7B7330EC7F995122648DD4A2433 │ │ │ │ │ -F4E1D23EB0B0A9DB681A4710732F9E4EE474471CA3FCDED55E672554DFBD4429 │ │ │ │ │ -5BADA6C45C4226FA8371C322C8DBE4E6F11F2AF0AA098F23B157B06727AED238 │ │ │ │ │ -7CEEBF480970F1B1086ED287000BA06E6BA76075FAAA70F0502E8134D5730425 │ │ │ │ │ -56CB0940EAF11F9F9860CE14F0E7E9106D4D75C28D1CE4C7A503E0CBE6631465 │ │ │ │ │ -FDF5871D586F101BDA60968B3D347CCD7FF245E4ECAEF091BFF3EB048DF77253 │ │ │ │ │ -DC80C51C67C332CF8FD343CC0B09E1B3A9ECB739321C13689BB28022823D0E17 │ │ │ │ │ -25C260FF931F56CDC90C677070F1F00DF4D8AFC560FC03B33CA04164F6038578 │ │ │ │ │ -E5E3AC620D9746342854AEF3240F59CCF40B645237B72CC650C6B98D2CF588A8 │ │ │ │ │ -625E0293C7B1037A926D997A5B7095470A34926A3C226826A4E1E1A7239383F9 │ │ │ │ │ -491F96822A692536FFFA069FD5488D678D526211B20619566ED4BA776C137CE4 │ │ │ │ │ -72581C112919FECF585A35079CB64575C8B42C6EA815E15072C0D57B161D3FE0 │ │ │ │ │ -F1C531DDAB64356F9404EBF2C13BD4DB455CA099585B3E9D8B5C3654D2C682B6 │ │ │ │ │ -9AFD368828C584013FA84F789142676C1CA0D58AAC6769A4A80DC1FE04C0134A │ │ │ │ │ -1124A661D31797F86B683C281C6F05AC84ED83AA9353C99C85851DB94AFA9D1E │ │ │ │ │ -596879C27BACC5F516F2A63E6A7A29CD9276960EDE6C74458D8A0DBC191101ED │ │ │ │ │ -34650F2ED1898AC699B7464FF203B90CE157977E1359F87284C878287B60B97B │ │ │ │ │ -AF1F76C1C74B50CEE1DB99683ACF6458B5CE9E605883706DD56F8BE55A1978DA │ │ │ │ │ -A0146A57DF9EACB9FC39C69471587E79C6407EB1A1530C30AC5B4CB394E851D1 │ │ │ │ │ -35EA480F4FE977C1AE75520F87D1625D38E344668694C5E8673E7214B1C9DC99 │ │ │ │ │ -37E672E8D4A3987C43E34B7A21AADD06F1D23024AFC7B8852A89D337A5B5BBD8 │ │ │ │ │ -A731C95D57CA641971E0B1B6D607EDF146FE81D27B7EDD46933A886C11115BD9 │ │ │ │ │ -09F1639FFDD97D28B0900F20F8931458B1D0651C98E286E7589C58071A4FA9FB │ │ │ │ │ -80FBECA2B8C56F1411824EDDF290DA57BB7D5FEDC3590D9400611BB2A74978D3 │ │ │ │ │ -75CC52ED74D67D9E69432A142D64D5AFBB22F5210101A4AB9DB5912A4EC1DAB0 │ │ │ │ │ -E6AC778ADAB99752386DC8439F9091A7C8AAFD9009AEF81B6507BA25A4143A77 │ │ │ │ │ -0CAECD3B165FA3CBEC1A7CA4B43B8BC30E3DF00176DAD844779B32DEFAC4427E │ │ │ │ │ -C9017A86A23C089FAA74A6D1C60DD84C64D6E42D24859B3B07D734EDFB033E13 │ │ │ │ │ -130998B6D5D4B62886124F0E908C318D92FAF65447018657BC38019A0F09EBDF │ │ │ │ │ -FE387E414E8ECF338138F578212E2931555D5BAA2B38A357DBCAF5DC69E296AE │ │ │ │ │ -B108B8353D7A2B70504319B18A1086DE4B02A7046731E23AF982FD470D184236 │ │ │ │ │ -BD168560BFF642F0A3B8341C55C4378B12DBF3B97AE8498B42F521EA632119E3 │ │ │ │ │ -C1CFF44656ED6B1C0D9E7C65BF0192896F9DE92102512B7C1F1B3E9AE75A3B3B │ │ │ │ │ -DA04B6A2B30DD797E1DD48F13BBD017A1E95E57EF7906C09299ED33C8A3D17C4 │ │ │ │ │ -59F06904B04E776399761E567BB33C12C0F99F7220E0A7A114F233B2175E8699 │ │ │ │ │ -342CB9C65D6DC86927A4F04AE75F227A138A8D7CED2872742999201D678FE387 │ │ │ │ │ -085821A3E6EB38D64B995DE09F7D237087EDA28D35D73282D45376922C137324 │ │ │ │ │ -255BB5BBB56C86D65BA06E2C277344A0692CC3EA367507D92B43BBAAEB7C65F0 │ │ │ │ │ -41447DB2373F4648EE4A065025E32B51913918B7A3790C782106952CBF2A471C │ │ │ │ │ -242A03F3C71478C9184F9D8227F2085D2B823F1192511D1A0DD72F50CF9728AF │ │ │ │ │ -643ECC94FCFE0FD5AD4C0BA4E27EAE240D5E2B0BD3F01C4A2C31FA7F4F897F8D │ │ │ │ │ -3E8A50075BE79E435417510581222FE9EEE9AEBC8F275A2E0C8E66014FCEDA16 │ │ │ │ │ -B508046ADD6B87A04ED714F66C789553CB18E00CA834114BB040698A3D1CCE03 │ │ │ │ │ -9B28DA4346090A656E7D824E2069140AA081A0EF5C51CE80CBBB0449FB4D8EA6 │ │ │ │ │ -870DE206E2145CF7984736AEE85BC4254861EE95519608C585ACC7A81BC73F14 │ │ │ │ │ -391953F42E44E6738A47028477D8A10450162688530F717CCCAF77B9BF050E36 │ │ │ │ │ -1DE5541912300E80A21381A38DEC2B6D24C5C310D12DDDC8168FD688E4DD77E5 │ │ │ │ │ -7C518106A1359175CC7FFE4336F9374AD11115BAA9E1773DEF0CE658857B846E │ │ │ │ │ -C5FDFD6CBDB4D29BDDB29B9583ABA6BE3B371B8E55C8FFF2209F238E66D54923 │ │ │ │ │ -2C8A77C8A27C8838B22869DED48370C61D2F91C120BAEDDD57DB7001AAF7A64E │ │ │ │ │ -60AEA71CBF3F4863812F7A30708480743BA2528F60B47A2E39DC38B4C3A4BF7C │ │ │ │ │ -D676CD3644CBC795890398FE54DE5725CA82C9B8DA20773CEEA39FD7896FEB59 │ │ │ │ │ -2C1820FD69AE112635E835D2D74CBB2420B55DFCDB69E62B9A14D585FC287B6C │ │ │ │ │ -660C487890D72CAE1B15E4D78CF9BB4445B230633ADD18B985447BC314D8AD51 │ │ │ │ │ -2D8A9469CD5704A6C6FE2C617970E38E8FEEE46A38DE955946618DE993F3BF56 │ │ │ │ │ -59571BFEB7E2E9171FAA21482068C3DE2065A772A15AA345FB575FA5EF1BCF29 │ │ │ │ │ -5AFCF65A5D2CF809BADEF35420284920515585111AEF12A82440EF6D04C6B393 │ │ │ │ │ -7A7B9AB622DCBE6DD85927A43A5DBA2D8A7F7A6B181DC8A6F420E3F32CEC153D │ │ │ │ │ -3C0EB64C3F699CD1AC5A1F65A0B5E28D01CB15A948B29021E3BBC64010D25AE0 │ │ │ │ │ -D1EEE20F24C548A731ADC5E20D30F30C66231490DD0A1589F72C941EBB4873EA │ │ │ │ │ -C26BBD7620AA358607F432C5BADA6E9C879ED2815CAE742F21C3346E983F4957 │ │ │ │ │ -F3765685DE42B34433B8408BDAE9E6B9DA0E76210D79AF1FE1B97BE5FD8B27AE │ │ │ │ │ -1015631683B94B65E674684DF7D2A0210440FFF3504087A21DA65D79AD083443 │ │ │ │ │ -7FDCC86B3DAEE7432B9623F64FC8D9523FA9AC6584A856C507B203081006A367 │ │ │ │ │ -B27189E9D2FA70026567A57C9F126A1FB43ECF3BD4B2F13E67D3B7AB525BAF0C │ │ │ │ │ -E9B53912F377DE2B6191E4462EF9889D7CCFEF995D7B03C640969C142789AF3B │ │ │ │ │ -75E408CA7A8B990E5FB8BBCB4602F875403A74F1A0AA78AE6E8C38AA84FDE62B │ │ │ │ │ -C8334ADAEAA1894BDFDF35035E44EC0B1D3EAEF9061EEB66DAEFF90ADBCA76EC │ │ │ │ │ -930CBDF1263443CE173FD8440732DB151204D954653F93527B20CD7C123ABFAE │ │ │ │ │ -C08A01CDC5ADDF281460 │ │ │ │ │ +FC99092341499E3160303A869929280E672C29204632974124DE524092221775 │ │ │ │ │ +1ECA4A30DF02B58740DCC4BA984CB0AF7F0ED7642F310CA9C8DE9DD1ABA550D5 │ │ │ │ │ +0CB05C0AAC0D6FD8A162B1819417381F9FE61C6C969A9F1B90540850B1987ACB │ │ │ │ │ +78AFA3A7CB4777BE09789E016B56B6703DA49888701BB3E62C71C23BC4836E53 │ │ │ │ │ +36B08C6D7989C5CC88FBAF42D988B7C84C0BFBD1515B88EA7EDCDA0F7A90A3EF │ │ │ │ │ +3399B19919992B3061D71E2CA9D5EB3DAD40B23A8F46B22D97DCFB1F59C6191E │ │ │ │ │ +1F10115669CD6CC05A4BE4F7AC5252F4EF69041831C805F18C467E3897BD934E │ │ │ │ │ +535073A5F07092528A564245005C2D3DE8FB7C0766724A17C870AA8BA5D92B60 │ │ │ │ │ +B0405DFD157AC0E2EAC29B4C646EF47AC3073866DBAF844C997648F5F8BB467A │ │ │ │ │ +D743E84DC558A7EA03F24E67261C753FABE4EE9F7BF298980F3DCDB668261517 │ │ │ │ │ +137A75D73525BDA305A66D6BF225C9B4D364CBBBA5632674384228DE6841A1FB │ │ │ │ │ +48EE0B15B9A6B45EEE1DA7CD1310748F82FFEE4C84A9A10FD47101CE606D24F0 │ │ │ │ │ +FFA5ED3AA1888774548C9D05F89F613E7F628CE0E1652C4F223C68A298EE07A1 │ │ │ │ │ +0D6136CB6F635E8C7DE8082FC196ACB13047A403D600A49291D8B3B3A95898EA │ │ │ │ │ +1C8C4063BA11CB33F0FF9ED593174ED95D3F165C07429025F24BFB5562127CF2 │ │ │ │ │ +7520479CFC3D1EF27519B5CE86B34D103B480152490503FAADD39454B53EDD82 │ │ │ │ │ +2DF982880409FA1F644FE5B7CAEF4F81C03FC3BC37F9BEA2606C5D4ADE9FCF95 │ │ │ │ │ +2A123FA37505B0C43C71FDB476B8E98B8465A0F8C7509F5F23C7E71FBFAD315C │ │ │ │ │ +655EC95F6A8B201FD4A3C7F164450C605E63759D23DD2D2BBFF03F9A20C47BBA │ │ │ │ │ +74A81926D67F12F8966C60C3C4088B697754025937D4D381BA857604B7B059E9 │ │ │ │ │ +2BA7C437DEFA6BF9110A8503F666FF95A315C53FAFB6B2DC9BFFAF94356B37D3 │ │ │ │ │ +51D4A88908E12FDD2EFC9559D9633642700756B8D8E0F198368136F13A48412E │ │ │ │ │ +8E087D26FF183367AAED3C1E09A21E3DBF1F73F4AA1A6ECC21B1059097B3816E │ │ │ │ │ +00FB0288B1D0E8F8F840965320EC73D260A5635E6423ABC503CF9A7A8B20A2B2 │ │ │ │ │ +D95A159A29F0207DABB7DAD7187EFF159AAE862B0D6719079991D4BFFD96E392 │ │ │ │ │ +D829E1CDA0AE55557AB084C1740C52A4F752AA0B0EEAEE5C3F155F1DB3D859C9 │ │ │ │ │ +41E4F28D42CD273D67E589DE38FF0C5EA845B9276D1CC41BA0C3A9CA03BEFB13 │ │ │ │ │ +C5AD17C96FFE4D99686BC5F22CBF2DA61B3181054CF163DF1763B96B56A9FCA3 │ │ │ │ │ +4BBBE52DE255800C117ABD79600B39F641D88C9117C97533A5AED2BDE7B5C72F │ │ │ │ │ +4CA81A8C76E3524E1F5A3C12045278CA23137504626BC111BD6F4E514677FFE5 │ │ │ │ │ +18EF9D4D2380E572FA2452671F0A26F4E080A506EA0A776D78FD65D2C8AC8E06 │ │ │ │ │ +8E9CBF6C24647C4D6AD17F4771CE939924A8026F0FC929B8E0351F9CA3C010FA │ │ │ │ │ +D4F834691176FEDCB2E1C1453F79FDB27F1D64DD1ACCEE128EF5DECB43AE3942 │ │ │ │ │ +F38C5B690EDF00F3FE8BF9861E13F99B17E8D2E451A8F1802078DB9D9B5D9136 │ │ │ │ │ +AC1D335C007EBEE4C1FCEE9159DDC92DFC8C2E15216A7C0D824FA78FA84D891E │ │ │ │ │ +6189E2766CAD6D6C881983BD306070EE37D13A90F622A00BEF7116C905CDB4E1 │ │ │ │ │ +895DC32C56F9AE2DF1D4773705EF1BEB4FE9BBBDAE3B4EBB698E63E4052405C0 │ │ │ │ │ +206D4C3FE1BFD33ECFB9E6A120EF17DFDEA2EEBD275AF5BBC8221F5B71F51D63 │ │ │ │ │ +649D694206B574E3EFB88D9994D707DA3D18818645CE8D78B229E60647FC08EB │ │ │ │ │ +E77D1114ADA3FE5ECD29AD623B21E930E4EA4669620FE7839C947F2690B651A0 │ │ │ │ │ +42C9296947DB79D4CB018127129E7B0FD831AACC72C6D331A2EE6939E0103A28 │ │ │ │ │ +22D9CF16D15EC2432BC5DC83EDA59D874B3947FFB8302F87D6BA41F2D4CA85CA │ │ │ │ │ +84814193E3325E9DA22A5A9F0AF66BFAF36A1B4440D00CD058C9D9C8F3C71DE5 │ │ │ │ │ +616F770FA85D14F44F45F01FD0E1C02D3387F2BC4F9955C12EF2D9AFC3C59A6C │ │ │ │ │ +170C2A505D61573DF18AFCFD90C58727BCEAE2D381898E0C8C20D87A76998850 │ │ │ │ │ +EDD32AE8D9B50DF0873F6646FC78057C773FC9059223CF52054067976D80FA7F │ │ │ │ │ +CF5E214D22FD313EA45E0783F01D315100BD6B80CD4168DAD79AED62E30C5170 │ │ │ │ │ +F564147897E62B73996CF105948752A1D111BDE1C2F596AE60A64619FD4B839A │ │ │ │ │ +8BBD3055F31A2842082DA3CF2DF26266C60D10CF751846DCB33C35C664946700 │ │ │ │ │ +60B23C2DC0FE01C2F6D2AB4C1D7CB2DABC107F50B9171CA54CE705A608BBD3D4 │ │ │ │ │ +54DC28CD75B6F698BABE3A6E580DD820A15FD40C03C8ABDD88CC565244BD2837 │ │ │ │ │ +6CF7979F55B4260CED5CB2EA9064A93140FD3021A555C22D0738A0909B2E8A0A │ │ │ │ │ +FF9486C60AEF29DFEECE8DABD6864C3B9853178274BF0D6FA2AE09A57D22F35D │ │ │ │ │ +73DF40B4E922D52257CA5702C741D9CEDF1C596B6C970B8FB1C5A3285E9F4DA1 │ │ │ │ │ +D4231D91DAE07A2C6AE8BB86FC3A6C77171E7053C4AB05EFC13C28AFA0B75963 │ │ │ │ │ +79C87AE6CFFDCB2F113E40CCFE47EF42B3CF3A00E0AFF57371E7F1E51531DE22 │ │ │ │ │ +7CECD228E351198586C65A62B9356C9D04E33C5585CF8EC714F7FA3DFEC04429 │ │ │ │ │ +A37E314B395A1FF90D11AC1874840551EBAAF5FC9D523CE0E1F146F4079575AD │ │ │ │ │ +D52ABD305A50E65D87FA0DFE971BE6ABF9DA46F5CC5A4CFD6990A15EC486CAD0 │ │ │ │ │ +8A76DE11A55D5688B9174789029A78798EF97BBBD3218797FC2D76C0CC07CE91 │ │ │ │ │ +FDC4A8A70FDF7BD7D9DC4A8262FC8576AF47EF7564D90AADF3470D305BEEB082 │ │ │ │ │ +506C0D7676BAD3D2BFC324BD6B6BA40D42AB1738467A6023EAEC1D68480CB0D0 │ │ │ │ │ +F9CB44FC6D38910E47B9624E2F8DDFEBD3BD946107D3FE3C14FDDB92C5694DD2 │ │ │ │ │ +C8EE46EA8A69E2DAD328E951A654A8D1323F66B13AD1ADF3FA27221545E7C8AB │ │ │ │ │ +45D36D91B3D172E7009AF9BAB4172665D69D273C3C8C864BBE91C1B216B916A9 │ │ │ │ │ +7A22629CB723A475173065249E59D82B6EC3E96C43A8ABFE265B1879054CD3DB │ │ │ │ │ +55EF0177A7B420A299A2494B5D80847B99BA1246F11F0DBC69DD7782317F1E4E │ │ │ │ │ +0828FD61CA1188D34D0F39961C12DBDAD1B28267CF8963A928BABF2EEE434045 │ │ │ │ │ +949627C3AE4393C1F3EEE7DD835E336B3E6BDB278F97331019B889E368C5F39F │ │ │ │ │ +A4DA02E53649DE2AF01DB925663594AA8DFF9B278999337BE1C4E876568CA46D │ │ │ │ │ +1A7B566756242AC17334E8A3A297854860E42AFF78F18DF609DB3A1A7FFC5BDE │ │ │ │ │ +737BF59DF7FD912B5A27BD638BDB34C82C6691FDBCF02AB238BE7B954399EAEE │ │ │ │ │ +6E6C5B13ABFD875B26E18629822DDA7102EC4AF83E9158698DFBDA6D9E1672F1 │ │ │ │ │ +03A9D35753513A51F1FA9D0E5F0AFAB2498FE1D727A1FD85546524E52A3744A3 │ │ │ │ │ +4E8A44391FB59F2E8A6A5A9C6BBB6379037AB429413B9F81AAFC8B0586CD9C4E │ │ │ │ │ +C3C424E002544E9EA55E7574FECF751C18A8DC513EA30890C424D4A6F37E6B2E │ │ │ │ │ +6C83D289BB83A2D26B79B60B7F1BAE0EC9E3DBFA361C2D0D8CEA5E72FD679379 │ │ │ │ │ +35CCF9EADCD35EF6D02D3F013A5A60953C4DEBCE3CB900B48A49B3F43458ADAC │ │ │ │ │ +624698E9A6687BEA31A40B27CB585FA7A4BAF4550507A896EDBB7531FA39E52D │ │ │ │ │ +8D6FB1EF25FEC2AE91C9B4E4550A449C70B3F24EDC363E59525EC5AC0334E852 │ │ │ │ │ +5F9780D8C4A2410D98517AD0DAE3FCE459C05BE3C23ABBF07B04725FA90AEB30 │ │ │ │ │ +45C618FA69DA2F9E07452B03F1820A9287C0EBFD0DF57494AEBEDA0118960826 │ │ │ │ │ +4D91E5AFEFDA8F04E92E4A988453565872A033B563DF34703353D072A03F19D5 │ │ │ │ │ +3E8375D110E2178CD0AB6D0E792CB6C97025FC3976603899BBC6F8D96F0FE77B │ │ │ │ │ +600737B81C890217D3BDFADF2FDEDB50E17D9A8E562BF52CF299EDFDFF312D9B │ │ │ │ │ +E3996A72AEBF747F4E50D11B716907D143B7DA51B508D06E2F5B298268210E28 │ │ │ │ │ +68938B389AC6C50B3FC5B373A4A9EC0952F3440D0902FC02018CF4F28531A9BA │ │ │ │ │ +C341058BC0BD30F118960C112C40689620777791E723E515ED59AB83D394F8D3 │ │ │ │ │ +01F94195DEC71170F6FFB1EC16C1EF79B106643707485E56D8B5BC9F174D7B9A │ │ │ │ │ +F0DBF9B16A438B6D12E3F41C0511E76F4C25994F7C9A0D1B596C90712E1BEBF3 │ │ │ │ │ +1B9B1D7128064CCFC17A3B4F55A88E7CAE932E09796FB56F0D3E4B6FC33E9C25 │ │ │ │ │ +D416920E38014B3EE053A8051F18BA3D7DE7E2CDA3D88B9B026AB91ACE2EB029 │ │ │ │ │ +316285AB32FEB2D25D8A9A2FB8B306F3F493050CC2CF4E5AD6430968AE334F6A │ │ │ │ │ +2427DD93B44619432E803D76D5C3AE36CBF85B8EC18801CED5007CDE0984C530 │ │ │ │ │ +566749ECC828D14C463E4BDE839934ED7D3E4B391D70404D979CC9048FA9F0C2 │ │ │ │ │ +2E11E2B5C8948C1469C4579D41EA2BABE4F478E16FAB29E3E21034FAC7482869 │ │ │ │ │ +70312054ABBC4D09132C54CA60721A250FA15625E3E4E34F51C2D63CBD29AE3A │ │ │ │ │ +FC4D314B6A2A1ED7F77B47AC30A3C623941D686444E6191C70BDA055D08F9FAC │ │ │ │ │ +C56ECCBDF794B4A7CD3D063EC3EF75C71887281DBF39361BB50529B072715446 │ │ │ │ │ +21C1C848A4DF3FA54E4B7388CAE8BEE9D47258C4324049CED7D5A2F9D8F00850 │ │ │ │ │ +EC8FEF78E4B35E3D4FFD1D2F36A589180580C107296C9EE307D99F40476E58AF │ │ │ │ │ +A68FDD22AD4228CBCF38A6C463AF98004D3679EE4E48FAD6178764562CF0F7DB │ │ │ │ │ +404C04BCB36C9A1F14543D406CEC2E9418D62B6F0B2176DEE9CF8DCA9D7D35EC │ │ │ │ │ +F3256BF6008B3A16ADC64CB934B9DEB144E81CAB2E76B3EA736AE314BAE07B5F │ │ │ │ │ +A561F540241382CA809D5CDC8305F20F094B01F18189A2DDF472E7A808C428FC │ │ │ │ │ +E711882EFE1AB8DBC1E2513A8DDE2F1DA7322F138F0323F5BB167DD1CE3DD2BE │ │ │ │ │ +FE0827D4AD25DF91DCB0F24DFD97C72FC79B219EF049C3BDD192BFA3110D2813 │ │ │ │ │ +89768E0A505D22C4588AC1347140103D4EAB57089287278825B7EADB0FD311C1 │ │ │ │ │ +0D6F03A639CC905153117ECBE35B0AE585BB2B19451E2782B3EF9B8495EE89B5 │ │ │ │ │ +E83EA82913E83011B6D1EB271481B7F25FA567EC364965A0B64DB8D9DA52B575 │ │ │ │ │ +D459D3CDA0F534E2E96A08337810DE0E7D00D0CF249DD540FEA3ED05854EAE6A │ │ │ │ │ +5AE05877BB9CD541DBFF7C00BA658D9FD682195A543E2C99FD651A2F1381DC2D │ │ │ │ │ +7C60D5DCB262182436B225B08DC0677335A07BAA14B0A4DA8334903929B42948 │ │ │ │ │ +82A99846DD72DAE7B57D2DF090BB29BA3654D076734C9EE2386D93249F71DCCB │ │ │ │ │ +BB78E213B6E2AD88CDB8E69AC0A478D83D1CE3DA355ACCE6E94C2DA14070D435 │ │ │ │ │ +94347DA99DFBD8183BE8C4185AAD6319DB87EA5BC1C71C73D23450A51048E5E0 │ │ │ │ │ +852C924F6833564507CC7B1B89041E5C841166B24B6F85BD12B88D3CE3901E02 │ │ │ │ │ +6F0AAC81ABE990428ACFC72734A29913C2FCAD0A5B07AC5DCA5FC296CD7792FC │ │ │ │ │ +528E8D2039DE4339714F478F777924F0F4C633778E984BCC4A2F172F453DAAAB │ │ │ │ │ +B6C688F7147D1C4E08B5ABD2983706FD5F3DFD0FD98C9F3FE234EF4F6926CDE1 │ │ │ │ │ +1A1C44B8C1086C909B43238644A8D0663AAC15D57C7E8179935E3A8FCCEE737B │ │ │ │ │ +D60790137C06D8A26CD8606CE24145C9B59B15030BB5A45DDDEDD2E107F6C7E6 │ │ │ │ │ +022EBD16B273C45091602BF9BA0AD298E0685325CFEB4DAE06B995E9DCEFC926 │ │ │ │ │ +FB35D355A041AB298A21F9B37DDBF0C213E12842651E7F6484B04E0E425E46C0 │ │ │ │ │ +1363F563CD1534408D3B6630032C294C6FB329B7C78991383F93EE72DFB9C0B9 │ │ │ │ │ +3A0C036CAA5340706405FFFAC9FD6C22DB26EF1B9B3F9560034D1239FA447362 │ │ │ │ │ +47CBAA7259D67E890FA8511AA34E71F058546438D9BE23A1D6CBD280585C2665 │ │ │ │ │ +D33AE240341F54DDD3C39235A59F9091B8D1B46DE7BED4EFF535FF7E6EA119F4 │ │ │ │ │ +99E41E7E0D1BD6A9EC3A55546CD902BCA21DC90A0A0B0833CA490D3BB046B79B │ │ │ │ │ +69F0A7078430DCE12212CFAEF8BB5A6838DE90DAED48BDFDAB4A8C53F4277DF2 │ │ │ │ │ +319A4BD346798A08592733067371423BC14A6FD9A48635001CEEF1F8050E123E │ │ │ │ │ +AF85C4F990B660B965C2A33AB1D02DD7811074E0BEFC98E86D4C8D6EC37728E0 │ │ │ │ │ +E319EE4E79DE72CB2913D9868BBBD728266EE0528757CE58E85B173A5777D827 │ │ │ │ │ +36ACD14BAC217B1BAF5DAFFA387907546BB00D8360DAF519DE085E4BE9521615 │ │ │ │ │ +7CF22E054016D254F0F18424A2A6A2E1774C084C91A57E62EB0B89BE4FF9D96B │ │ │ │ │ +F6A34C82B1DB408859B2E14B326B3E5F644F7CAE0A48B4EC168BE59F0F7DCFB6 │ │ │ │ │ +978E042F5250D073C6D16CEFE896E5561359544773B5F7EE8EE37EE1FC0E91D3 │ │ │ │ │ +6C506974470B5FCA4A8F172B237C5171761C89B6DC5880654A24ADEBE44543D9 │ │ │ │ │ +8FB1558D43F161EC4E166459153A6CB907775DFC1FFA6C04A05D25E452BAE929 │ │ │ │ │ +9E709FD28D710B8366CA72D3D409D94C741040317DF2623086A3F18B35C2B1DE │ │ │ │ │ +8334FD108D85C8948361D4DB05899A970B329F5558EBEE0DD3BE8343934182E5 │ │ │ │ │ +A4CB2239C16685DE6047F24C53E4B6CAD901F26407B0D799B337598250AE6FEB │ │ │ │ │ +91B6053DFD30E93CA665A83CBFEF5B5D80B0CE5D75A08BA40B7076BFC25B4DF0 │ │ │ │ │ +628EC3A6DACF952F248C456FB6F7E46E32FCC2AEFBA2915907E5253C12E34251 │ │ │ │ │ +D3D7A9EAEB8694D514767211FE059049EFB5F0B3C2C41D6DBD22FE40602607AC │ │ │ │ │ +1083A0F1D7D5661538260EA10E976FB3BE66AFEE090ECE12E8CF4686077D52F8 │ │ │ │ │ +8AE203DD22235DF4339B679FBCA6137B403FA73869CFAEA5A23F81BC0938D029 │ │ │ │ │ +009FEC653728679E0EAD85525952BF85B6BB502C704CA8E4B4CED460FAD16800 │ │ │ │ │ +7F59DF4D3DD0A6F7B6BA6C0208B604175D288DA1003B7669821400C4B09E0D7B │ │ │ │ │ +B74FF14F89A866C9681724FCF78736D9641F700952C3182A2ED25CD0EC28ED47 │ │ │ │ │ +5DF00703305B20B2CB1FF424CD2F82ECDE406D57F9BADBB59CE323099B4A3227 │ │ │ │ │ +0BCD333C002566B59D1091621EB00F6FE44A4048237800404840382CF3F02195 │ │ │ │ │ +74C86D4FB924CDFD3A9440EEF27C3E17BB7F1DC7800C6BA3C9AC763D0DACD17E │ │ │ │ │ +4767ACCF68B08D997606CD4C60641FAB9E072948622AE0DB5B3EE9B00541DD0B │ │ │ │ │ +9F433C61BDEB11873B36853C851D2FBE25E5FB956EE1B43A8F9AC6B4722FB93C │ │ │ │ │ +4055BBBF834E2512B16B203007F4E507D925A4134775F1925995891FBC6B831D │ │ │ │ │ +773E055BABD722BEC4F0D8E4C87B305FA4424EA263FE2ACD39FD9F1DE87A5AD3 │ │ │ │ │ +D0778E55E5B4C2EAE689D9AFEB3BD91A763B2F83FECED704AFF12FF6950CF2CD │ │ │ │ │ +E1C1B5A96F1D481603B292820057880CD84168C7A2A4777C8AF9D0FA837E5AC3 │ │ │ │ │ +5EF8442D6C35B5D3DC824469D86376FE392900FAB57899437A1EDB4FECA392B9 │ │ │ │ │ +45AE3DCDDD8544FD01F3125173540A69B66399E6A7C72FFC08E79E7A5F769A73 │ │ │ │ │ +944625CF6F03A4CCA0DC10F324644A6158A2C0241D4870AA8909ABA2787D9C27 │ │ │ │ │ +FB1284EA287A3A9FA03B6B089123212994906457E0455B8D73FA9E82B742F6FF │ │ │ │ │ +6FA62EC6DBCCA364C793DC1BD48BF396DFE43EDDADC196340D559414985FC4CF │ │ │ │ │ +FE31C7E0E7DE6B58D74FFA850FE877FED1E50936B0CE6E915EA458415848E231 │ │ │ │ │ +3EFF534C53DE932B1AB8F3A0FC331717BF0AA53FAD7B5CAB300B003F15E8D0E0 │ │ │ │ │ +FEB31B3E7B78C4CA645009BE655EFFFF13B5CE13F49F23D399FCE91AB19995DE │ │ │ │ │ +9AC3B9CD436A5102479572B5D6E80FB4BF792923E5C0BE83EF3A499F151A8839 │ │ │ │ │ +D27C83CC3BA0A2299661276B7E539245A2300E9D09ECB4CE895ADB74B6891806 │ │ │ │ │ +90EEB1E32F8C6F735EE4537803F253533C370ECAD7F55C6634DA2D0A0A62B307 │ │ │ │ │ +62CC2918FB0C7B9EC6A9F37F3B07FA72EAE89FBE3F710BC44D0C454E8396F901 │ │ │ │ │ +BF6D9816FF36385B8777695C8FE2929D0744E4C7BB91B7699A31F8EB1F07FC82 │ │ │ │ │ +F017242DA2F6DD0EE65BA35BBBF22419B735204580B13795757B4D8B4DA5AE9D │ │ │ │ │ +D7EAE7F9A32B23C2D1FDFBFAB20231384C18A83A0D1DDE62D3DA06BD8E64E8A0 │ │ │ │ │ +05FA447255A99CCE4EC0480A310C953A607F15E17A7E111D8A9AA0DD59BD4415 │ │ │ │ │ +22A33C031760C0B1A574EF316017C692CC466E339EBB9C229DECD4DF5E40D3E3 │ │ │ │ │ +FE7C60D9AE65848F41752BEC9A4B5893C19190F06F321495465FD60A5278427B │ │ │ │ │ +4D6B7EBBC4BF5D98394E9BD3A29703B861A067B606614A152DA22144E2EA14F9 │ │ │ │ │ +29D5598F44373DD951175E8DD14DFEB32D32129ADCDE1CA7DD6D4492C85133E7 │ │ │ │ │ +5C03F23537608DC47ED4DD94853315800A7F9B2573419AEF90F754A5EDDDA24D │ │ │ │ │ +1DB0984C855B11DD120967336D90BCAAE800865EEB93409F109C459BE8E2872C │ │ │ │ │ +F4B955220BF7BFF03E58F1067DA1E95FEB0F164F121C22BEEF969C637FAEFBC0 │ │ │ │ │ +8073C9553C49C9BA3C8CB982C707A7EE1943F9F1FA8CA7DC310351C600F8A742 │ │ │ │ │ +52068F5635824181237CCCEDD20D551D8CBC8BA4E1396D318D2FD68CD8EDB9E9 │ │ │ │ │ +A0E0F59618046A80274CDD9CD118BD365331C543064A0A75C748CAD74A48CC92 │ │ │ │ │ +877539D3BF9B3CB11FAEF87D09EF5640D11F830B8D873945C710078124A84CAE │ │ │ │ │ +889B84FEAE4C4533B1A9073EF672302957F05C8557B9EA29F47C94E3749A2C0A │ │ │ │ │ +0EE70CEC43939D7E7DAF4DCB3B32575402307375C9DFD1EBD6BE6887DFF02DF9 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5908,21 +5893,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 76 /L put │ │ │ │ │ dup 83 /S put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 103 /g put │ │ │ │ │ dup 105 /i put │ │ │ │ │ dup 108 /l put │ │ │ │ │ dup 109 /m put │ │ │ │ │ dup 110 /n put │ │ │ │ │ dup 111 /o put │ │ │ │ │ @@ -6109,161 +6093,151 @@ │ │ │ │ │ AEA5E1ACCDA7FB2DF05E9480936281484BC329F0B771775E73F7FD72FE3F45F0 │ │ │ │ │ 50ADBD03932B38F37A8F0A66B2F739EA3AC8811C8F514E68C5643E4AFF485C81 │ │ │ │ │ 88475A523D7FCCA5C8809BD49846C77795A38DC6406082000236A4D2628B5932 │ │ │ │ │ AB7916D44EC2210CB941B4C12515E844F0D26CDF0AEAD63BF1491BB50ED4D6D2 │ │ │ │ │ 739930E80E26E9B425C25033121899AD22102AE6868648BABB7D5985611C95E3 │ │ │ │ │ 5B8D365C7D034BA22E904A0ADB0132CE38288C127BBEA0825E600D18383A6854 │ │ │ │ │ EE28FD1B2F57AF704854AEECF985EEFAE0521DB38B0A7511C803CE8AE0D0BC02 │ │ │ │ │ -50744F806B8D771AEA2192F982AF15F1AA2B282B220E0446388AE1E65D790C3B │ │ │ │ │ -EE0CDD225BFA7546482D89735D609CB0F6404848709CE648248461C1C1947781 │ │ │ │ │ -1D09EE81A86FE19A47333DE9F1BB60E4D5956B30CAD83C9D7802B23384AA4770 │ │ │ │ │ -1F8B0BECC59D89A72228FDB1DFF4A8ED1860B5BB6A68972B4AF749921DB8B84C │ │ │ │ │ -29CB8AFBD2A2627BA5A48365915B851AA4B6C3EA9B56AFF84BA518B76B538B1D │ │ │ │ │ -F061BB3B52415F812A0FBE7E3F1368385655D26F83F4E26258BF2DEE7635BCAA │ │ │ │ │ -CA750B27B84E49C0739DD9FE8D83E237DCB07FAA40A877F8EBF3A9F648A42396 │ │ │ │ │ -FC5DF2E28CF108232859709F2E9C018D674E7F84D46AA22B5055DB664186CC0B │ │ │ │ │ -9B1DA23AEC29A6D08B92C5092585546ED88BBEC2FC591F1C1CA84328FFD54A2D │ │ │ │ │ -DB228549726B17089658A66B29B7FA10CA72133470272BFF16F12783C19E3640 │ │ │ │ │ -874C15441BBBA891C93146F792E72BB6B10182B72F8FA36147C118ABE6692E9E │ │ │ │ │ -937E982F3B3487CB7E2D32F8521C48C6CB50F385AD26BA5EE81FBC3AA200E9B3 │ │ │ │ │ -3CC27D1FD93376676FD61BF33E88C2914D85828D1B506F2939BA348B34A4DF91 │ │ │ │ │ -78701F8A629B86DAD0ABE65680850CFBA1A926EACB6AD0EA84CB61B2466D8BA0 │ │ │ │ │ -85C4290EC49C61A2DEC657CF49491B69246E1B0406938A52B38C9DE5786525DA │ │ │ │ │ -C5DD8E9297B67224EACB45486194809FBBB1B9952CACE84789EEF19113205D4F │ │ │ │ │ -7F9004B2684F010EAB20DE35A1371C0AD87A7B7D2B23693B9CE88A07F0595534 │ │ │ │ │ -8A318440BCCA49567636C8F35A3649C6DB57DF98F8E47639CDBAB86C0ED14BEE │ │ │ │ │ -10DA32CBD16165A2A2692AFC370A6A1F0DD93A8C08A011631E2F9C8F89E1D8AB │ │ │ │ │ -99A3C50FC180A32F9544EC68B9E361F2EF597D3BE661A2CE60444179E041974F │ │ │ │ │ -C0ABA4CBDB6D82B11FE9F7B9FD0EF183483048A21E1CB02CE9481827FFE8EED9 │ │ │ │ │ -83E487A0C55B9A0B5AA8FC9928E2BA982F6297BFF66BF9A218C67D1E69FBD0E5 │ │ │ │ │ -2BEAC470C0A4EE308220E87D7AF4498493690789AAD086CE9F9763F4E44FDBF0 │ │ │ │ │ -97D68F8FF96F3CEA802261C4377D8D0AADA58FB87A61556AE65579B126504538 │ │ │ │ │ -79808D63AFD98B5ED5195C9AADD7E322D59BF8EE48AA9412A7B110C24482EB79 │ │ │ │ │ -269BC099F1366184E88625F02A760F2DEE27DDF585DBA229C4A65D40413416E9 │ │ │ │ │ -A7345809166F00877A3F642E7BA036D8812A560F713E39BC15554F3C55AB7A53 │ │ │ │ │ -BAC47B22ADA3DE1CC88ADBCC3636D34937875D3B1F79F746B42F97FA02735954 │ │ │ │ │ -C1596798BDF302CE3F241937C1F03013D34B8A7CC05FE828CCB311683392909A │ │ │ │ │ -C7B1C656AA539B6C0B0434AD07F3FD24660EED49D637D116CA57B6B882A7EF4E │ │ │ │ │ -1BC45E4570712554A98510D26778D9B00974A9AFD0F93123E4AD86143BE6A81B │ │ │ │ │ -73EA8743D77B9D16C7F22950A6D5F6B49A683659FC1CB8485F832C264325A010 │ │ │ │ │ -C19F194DA56F259B2308F79CD1E60EF623DCBDD7C12C678C43FC186F5A46D00A │ │ │ │ │ -8F25132450F9540D5F9793F24CD49E17152C0D7FEF943416CF71E2A443E1A6AB │ │ │ │ │ -831BB28BBB8ACD765448A955D6936B7D233361C72EC16DD6A65CE706B599904B │ │ │ │ │ -4AEC0386E0A1FA39ECBB63A0C1C2C31DD275ED1AAFEFE7D1DC3AC797AA897B3C │ │ │ │ │ -639017DA840DA162757BABB6DCA3DDE158AFF824D1A8A68DE61A9BB5C895AD8D │ │ │ │ │ -46D41E42D7E9A82A7494E445589BE0C3EFEFB2500A6BC0BE05366B1FB019738A │ │ │ │ │ -4FAF93DDE35B27622D13314E35AD3A5788C3B5489B5ABBB58DF221ADE734AA0F │ │ │ │ │ -B3FA461A8F9817A25232D2842112CE32ED995F503A0A548785484FD286258E76 │ │ │ │ │ -87418AD2DCE5EB8C4B3FF58517860E34589488CE33CC1F6C1CD45E57CEE7A436 │ │ │ │ │ -00ABFD44902D6D5D6EE410A60248303430BE62BE86CC1F344D1F0E6E6D332289 │ │ │ │ │ -4B4AEB02A2009785421F1A69200DAD4615CCAED0C5221CCB99BCD83852C01ED7 │ │ │ │ │ -F27AC9C7E6FB154F1409BE4C608F6B6469A1ED910EFCF1CEFA64275AC0E0E343 │ │ │ │ │ -90C11E181FEF481EBBE301E2D4B22D371DCE90DE6E495594E73D0F6A177C795B │ │ │ │ │ -E47CB1570C7B42AB405D1C2A809D60F0BD72C6B3158EB82A293CEAF01534C1B2 │ │ │ │ │ -F3440D45F28F24421FAF8F3CE7FD3FA9C3B5B48E6A7E18A00B7F1E3D0A6EF339 │ │ │ │ │ -412349795CFCDF4934AA5239868DB3D50815C0DDB4E20C1A4583275E615CEF14 │ │ │ │ │ -0EE430746A271C3CA99480843BA8AEC34C9949EE805C5739963395081F3F1857 │ │ │ │ │ -BE427567339C950899AA93FE2BD535CE7C272EFA1397B87C36E1A20BA57396D2 │ │ │ │ │ -1A9CAF1B862D24BE6E68AEFD17D699EB4DC9934CB18D3D6FB29C594E8AE4C699 │ │ │ │ │ -4AFD5F299B7A0BD48065C576095766B229D2D08C6C2D9A71920EA819490741E3 │ │ │ │ │ -8B64D473A4A241F287A2ABC969D75E09DC087B812E70E2006938AAD22E04F08B │ │ │ │ │ -2D0F9DF02983803E1D36DA17E2B4039B78889BBFB9943FEB46187FEAD26FD4DA │ │ │ │ │ -1E9F466052324FFACB9864425DD29C3A6D820DD4C2AC20D558F512FD42539A69 │ │ │ │ │ -1B5140EFFC5E40C3B54656C58CBFC5595E1609EC226CA41CE9345B521A6C38B7 │ │ │ │ │ -F6267B454B1780D17B894461A7B29713C4B98BD65238B9AB325E467D50B7DD66 │ │ │ │ │ -DC4F19975D86A28571EC0DB26EFDA3A69D450CEE1D975E0848AB72D2842468E7 │ │ │ │ │ -B8AE904916612E2B38DC326F07B07681550C57090F402DC8BC1E2C0DDABFF000 │ │ │ │ │ -1CF8D42C0DEA05A30047899094489C6FD6B8A4062447E0CCB1D8A56FE225F49A │ │ │ │ │ -7B7FFA39BA5FA7F94944121F0C298FFC2F4B5F186DCF3488724AC3F8A7FD091F │ │ │ │ │ -D73FFB143E88D715435D377C65D361CCE98A6D77927CE634B84830885DC5F1A7 │ │ │ │ │ -C0107E96347679B3FDA67C5E4C8491DDECD12273A602F5D0BBEC0167097847FB │ │ │ │ │ -DD303C946D2BA04D317F0D672D5301F59C8C301D4D58DE13316FF6309F400D7B │ │ │ │ │ -BF9C3BF51271F4F8501658A60B9861F458732CAFC163D546C0B2214CFD7FC3ED │ │ │ │ │ -2555BC50691008D3F3220D7AD8FD68479DDE1FA971EDB8D574BDDA8947354D08 │ │ │ │ │ -68C121A255D556D7E6E29D480A5C7E48DFB71BC8D46EDED17FC14C06BA0C708E │ │ │ │ │ -B9AB37A8E9BCEF74F5855569090C164C839A5BF61BAE7EC9089400A2C7725F28 │ │ │ │ │ -97D2EE0153729B2D945C5ED3BA304A60D90EC1B21046D7A59FABF292062CFD1D │ │ │ │ │ -76A859DDDA9397506FB9C2AC79A745016186F391E263F97775E03C6CE2736195 │ │ │ │ │ -91E02354B61464C962FB52FAE71CB88671D756D6938B2295D091F6C099E46B75 │ │ │ │ │ -A5E60310BF3CDC2A990E738CB789DE26B0495DE0213BBF10C4CFB7062C8B2AAE │ │ │ │ │ -892F21CD11D59C019938CA71429D30423E4DFECB4C908D1CB772F72E37E1E92F │ │ │ │ │ -CC763D6AE998B54293BD0A959D6CF1DF40D9FCEFB225F6E56A8F8B29F6C54113 │ │ │ │ │ -A38BA9B8BFE2103375D589E0F33D9FEB538246F7B548602E9E52E9997C890DD1 │ │ │ │ │ -A14879C615583345F543CEB34C483167D2E5C67FD1841D0069FA69EA3861D301 │ │ │ │ │ -8EC694CFDDA8232AE6611ECDC17F7A5FF42457C5DC163655743A1EFA2913EF04 │ │ │ │ │ -25E7BF690F7D613260B164CD8B501ED928D6C0E414BAA79F6B918A62E2A3C6AD │ │ │ │ │ -FE0E4580B56FEBF4966B50CB874F53944FE5B854A6C2FD9191310E295D8A774D │ │ │ │ │ -AB8F7A3DD78363CC8EBEB1ABAB819DDDA7CE79477199EC1985ABCB3FFF4C7DED │ │ │ │ │ -2211E4F1864567F8867AAB01960A5B83C84610580264A5C6638FB3AAD9F1AE02 │ │ │ │ │ -8537218FCD49F36ECF78025FAFB880AEF6E693DBF8118F6C44D3621148A20819 │ │ │ │ │ -EE8468BA0E4B7260F0B3CCBFE279A0D8403307DAB3E7FD6476162D6659963427 │ │ │ │ │ -F900A3996D1AFB96C6F402FEAE9EBEEC5F3982462314BB4BD6A5B6CD338BBB66 │ │ │ │ │ -DA1F7A063161D54D2CCF068B95B9C409DE5D693E4F6635D86E01492EA637516C │ │ │ │ │ -02930DD84DDB00336D9416C9427ED98F8A5634BECE9F4AB26C6B9F4FDC62A12A │ │ │ │ │ -84417CAFFD4EE99B466BF8E853787E6E92B13075F631CD4CD0BE1107A43FBED5 │ │ │ │ │ -7F0ABFBCB93273EADB93C7B7A9EA63869029293464A22A1E15E06B84285A30ED │ │ │ │ │ -C550D8ED6E28511D4019D902CEDC0FD540AC1CEDD707B822804C0B81E1B02372 │ │ │ │ │ -F2A6EE8A5E570661CA51759C8CA209FD1C6AAC16CA5AAC108DA1CEEFE8859460 │ │ │ │ │ -9BA0643162160D14C1402EC4A9C7866D881CF3A57959368D2B7418B216222C19 │ │ │ │ │ -E3A3C91CEF7FBF39F2D1BB5ACE5ABB86D49988B8D820B9BDF0588B385DE65A1E │ │ │ │ │ -BDA6E74A32FD9781E75ACB29F900259E1786CD4ACA6626651ED6388A1CD13C52 │ │ │ │ │ -1C573EF5D21432F4A68659BE7B6D669F7ABBDF9F5C8A8BE0220B1080E92DF5E6 │ │ │ │ │ -14A5B07BCC4F9A98C697D025ED88262BEE90E4A12C3930C35C6796B95C3A6D2E │ │ │ │ │ -2483F87F73240407B0E0756E82BD214F2DE91415767C939C7471D6A74F14D315 │ │ │ │ │ -D14F5C1FCA7ABF659AEF6678A26EAEF5ADC972930741684D5C08704D63F39A3B │ │ │ │ │ -8C54C7611C4673C361CF28786EC5C302A014E42FB78ACFC2C9FB39236C1715ED │ │ │ │ │ -1A3631C61DA6D8B7FE768CE8F7DD3CD6D2CE72413A2C6CBF7641EF30B5EB352D │ │ │ │ │ -D8A07A5999A1B273234C1B9FB7EE7BD5941E1564BA03ECD5BEDC75C240698816 │ │ │ │ │ -CC9C71B2A5E2F5B3C25F1CC4CCF2B79C68D00E042E464BC88E686F05CAFFE5B7 │ │ │ │ │ -1649962B68A15979C1AB6AC2AF7878C81409D840579BBF0C281F7918163AAB50 │ │ │ │ │ -991C24D6344A25328951C0B9E75E6C62E8C2B34A56CF353DFB0587898327308C │ │ │ │ │ -3CA7B99FDF675AC309E154D7EAF4A920538F6571B409724A27063B6F17D8A935 │ │ │ │ │ -A9C23B400155D61534D92ED720DA1424B7701AA8CE5AB6D593588740F81F1E40 │ │ │ │ │ -DA43F7E2974C96CB91A82272C7827964B23D547249C462FA4F02EE81856FE8C0 │ │ │ │ │ -15D7991D2569D426D883C643AA261DCE4D3412F4DFF5F47AB97408125D8FBDD3 │ │ │ │ │ -02A9A3E15D3F880F90A0F381B8DC10D5294A3CB904B65035C2FBB66F1906ED9F │ │ │ │ │ -7BDBD5F6B49B871E3C9A4DD73508A2D42FFA20CF3EC8A95EC6E6A28B45A230F1 │ │ │ │ │ -05707E48C8DEA8C49736F2CCB343DFC05963B3CBCEB0EB97B8AAFBC07E0328C8 │ │ │ │ │ -5D23A475B73A34C37B715937EB43BA3754D6363048C492FFF95A760640A031D5 │ │ │ │ │ -E76B5AF7AED1B177E6BAE39AE0E1A8AFD56CDD6C5A2A5D880C627B9961F551B1 │ │ │ │ │ -E6D41554C886DE8D71DB55A8F33DAC6753DE6BA4731D13239798D122663C059B │ │ │ │ │ -2B30A53E983341659D25ABAB54A3A9E9874ECE5D9CD422F34B7E2A8A3DD8F2C8 │ │ │ │ │ -4EC89D880BC53FD82C9201B7C1848CA8985844CFF6EE2BB6F7358B0DDE206C1A │ │ │ │ │ -8359865D47E7D89737495FA41F1698A6C2F336E563487B1942237DFD3DEB9550 │ │ │ │ │ -1A26E4ED6837CB6349D17475CACE76641918B2736AB6AFE5DB28DD48C41FECA8 │ │ │ │ │ -8F761D7832D865F88BDBF31A3B4B2AF743E3E7C0206804C7EC7108CC15503BC3 │ │ │ │ │ -1EF660B5C156F27910CF92E90AEF1F32D1AD1377040ADB15F69A7DB099475BAC │ │ │ │ │ -EACDC9DBCD05C3D3038CE76D0BCA56EAE45923D95EB5A9270F86853F00EA21B9 │ │ │ │ │ -D4315420195B114C0BCD4513E169DEC7AD2BA7A8D175D47141A5EFF11BD7C677 │ │ │ │ │ -DF3686B82CE687DA73B2908181B956B9D3D683B42DA87F0C8387B68171F6B13B │ │ │ │ │ -03CBA0C37EC251583E45531441B1E829B3414B3C40AD90036CA83767423FC673 │ │ │ │ │ -5995382F86A635A06EF9A94392402625693E612DA0773FD751B25140E05799D4 │ │ │ │ │ -5E3A747CCBBEA23653969C2345E8D43545A4DF074160278AAA72FB44C281C075 │ │ │ │ │ -9195EC37DE7DD349BA52DF2E067A065B39B7B7CECB3E5BA9ADB00365781BBE26 │ │ │ │ │ -76E74A0823BF1B11BEF56CA11A0D7B4A159A39E259922681C950CB4B83F4F44C │ │ │ │ │ -75D9CD354667C918BB60D920FD557BA08FD92FBE8D1F25B6AEADE758BE2A1680 │ │ │ │ │ -4A4997AD141FAEA3B71BDB03BB5A62C76F13519A16930403C0D2A554249B19B9 │ │ │ │ │ -C7CC27DFA9BF153DA02BE79498F9422068AC7A522B2934818161BB41F19BD25D │ │ │ │ │ -3C03BFCFBAD02972911DA477CE18D031833C0C4CCB41189D577925DAB9770605 │ │ │ │ │ -2528E5CFE636130F48C89F912177CE91A3EF2F332A828D50EF51F63E86C9467E │ │ │ │ │ -8C8F07264BBECCE67BAAFD37510469E760194BB3FBDDBC438888D29604D6A35C │ │ │ │ │ -04B9120FBB788825C3EC0A2878FC5728BAF2CE76E32B6657F48DD1CBCEAD0CB0 │ │ │ │ │ -CECDF929D1002C2A2AB15D45261B27D50B5F8E93AE083E4E723CE3F5BE554834 │ │ │ │ │ -FD3FCE53E8C16F08033E3AB91CED07ACDEA8AFC5A0C0024A0BF793441877732E │ │ │ │ │ -8D0FD02324CA0730CB972DE02EE1AF177080A0375296FCAB08B27E2A2FCFC6FF │ │ │ │ │ -79865A4B7282B07EF03B430B9F6512D2EFF6875C3DEE5EEC3115A39B7FE8D186 │ │ │ │ │ -258C4530905EFD615A7223D6537BBA8DABE69A974DC925A1ECDA3E68B6BD061E │ │ │ │ │ -59227272FA4AB2F6BE46ACE521FBEE05D076DD09C37D984BCAADBED11C88C817 │ │ │ │ │ -1C29895D7C4BCADCC2669207C4907AE30A39C93E3B8EF54E99801290ED31722A │ │ │ │ │ -13A77CE076773D0EF6B59AA3E187FF2E6123939D4F33F98B5EFF54C47AC554F8 │ │ │ │ │ -DC7AB5AEAC2585B718D20821D16638FDA8BDD4DE1FAD47E9EC5E0EE0F2693EBE │ │ │ │ │ -1E20E8DF1B35F2E91239F1FA968BEC540BA6F60AD715A27736994618DC53BE2D │ │ │ │ │ -876326765132E994776CCA7083F9ED2ED653D71936FFA9D37621CC357E3384D2 │ │ │ │ │ -862F5CA8B36FC9B1706DF2C764CB10492334452F3C1D72258DC718CB5242F695 │ │ │ │ │ -74978912B2376EC738D40DD2996F │ │ │ │ │ +50744F806B8D771AEA2192F982AF14237CC79ED90C155ABFD082CD9FC67DED21 │ │ │ │ │ +DB9584A87F8D8B306E67503CD64DB373B7ABFC4ECD49AD636AF40414A47C5A02 │ │ │ │ │ +3BDEB8FA7D935A4FD76D7A45322654577BEDD2DF0F059DA2FC1B48F0D3CEC68D │ │ │ │ │ +2C1DA99B022B1B5122032A1BCD94A589903BF6EE1D32343C355554FFA0569198 │ │ │ │ │ +1B6BF9765C19EAF83D82F6ECCA25A5A3D94DD56B8FB4F5A10BF71AB1AB10D6F9 │ │ │ │ │ +F78F44E628999F187006E4958533AF73E4179DAB513B1B6E0C87D5285AA383D9 │ │ │ │ │ +4896522C164A8282CDA375421331AF337C572225850780F4BE914537D7F0A0C9 │ │ │ │ │ +874FB2298F39B3D02C2BEFAD99FDCDC5AB0B66BC77807CE02EDA15503F66B8E7 │ │ │ │ │ +A5A3D7BF202300EA1AFA758989F57334105EC8B58C4CDA2F1CCB99482E880710 │ │ │ │ │ +A665B3ED7C4ECCF00D9BB2B045CF5A585471FD93102DAC166CC66CBE338BF871 │ │ │ │ │ +8A13E016E614F74771323E24A76E159E0208435B90C17EA212915583BDBCA4BF │ │ │ │ │ +7D1EA197E223C155F2EC28690D3C299B0BF8084C65486058E94A45B040D6FDF9 │ │ │ │ │ +F8C007A49F84A8A875D61F4876AD9B2AEEC41779154217F016241D46237A0ED4 │ │ │ │ │ +98FD2EBBCD62A7B11A2324B9831E78CEB50C9C6B95B2BA6AC2B891BDF68998E1 │ │ │ │ │ +EFB5702447D1CCA6A04EE8C5BE1FAE3FE9FFAC261F754AFF8E0B7D320835EE97 │ │ │ │ │ +1E020CEFAFD2DF2AEF1FD74869F546DDF96FDE0EF13A9F1EDD9E52634C5F1289 │ │ │ │ │ +E6561A44A450908258C7BFDF31CFF9F1B412F89918E59DB788A75EB07C6BFF04 │ │ │ │ │ +B7E5CCA2FBCA7C74DE59B228E4DA70FCAF64F78A69D90AAB45542BE43A069C1D │ │ │ │ │ +B920D3C11D592DDB67A283B9C476788C5BB38A7154ADFBEFB575545D2FE6C951 │ │ │ │ │ +0D813B3CA6339E2734B1B85659C21F2EBE5A6E604E0782E597E89A5DE3BA65DF │ │ │ │ │ +5AD653952743B84141F92DB575C1BBC2397AA266FE67D29659A39FDD5E07477F │ │ │ │ │ +535D1E0D0351BAB80979186658EA970A5057F121C59C9A2BA72298B524001306 │ │ │ │ │ +8F30228478C4D491328682D4C883002EA8BBBDC4A634BF13FE331BAFB5608117 │ │ │ │ │ +E16C7BD78B3119FDB7B275A6D0AD6004C98C8AA20AC58ABD64FA16C6D01ADB67 │ │ │ │ │ +67EC0DEF52BAF8FBEBF27B617F98B9DFECD8BF5EAD1A036E00DFFD093160A180 │ │ │ │ │ +EF022A51B47EE7C15180F9E8FE57D761FA85A3B2C973049F2F9A55EE32EE7E8B │ │ │ │ │ +E8C6AD1CB6EAB589966C1AE0E39E8232FB53D7AF6A55BD2F4F67D21E6A401960 │ │ │ │ │ +AAC9998D44DB98786589A2C1A69D22D16432C477B58069401DC20CCCAC00D28B │ │ │ │ │ +7100FD657027894324C3D67B5583DC341ACFCBD49271B2B1B30B87ADF56193C9 │ │ │ │ │ +D6D3F00262CD2A8066841BE84EB71419A83F0DA2B592890659176EBFCAE479C0 │ │ │ │ │ +EDA8B52B7B2B1A716497DF468C12F89C2F28D74B4238AFCEA6C057625FF125D3 │ │ │ │ │ +D15C2150231A369AC0F0CFB1547ABE0310BB8C4C8374775FF4195B1135B6571F │ │ │ │ │ +4B59958E7CDF7BAAB82453CFDF7D1D9C56920FFBD676E355254A734BE6FD5DC6 │ │ │ │ │ +506AF8486F5324773DF8F8C1D1D79761DC8364F7AF562C1075E52CAD565D1F19 │ │ │ │ │ +E2DA84111C14188633278729806A783B3509413C414D6875BDFA648A30765378 │ │ │ │ │ +02684DF480AB5243D2C07515FE3F70C85B095DAC2264B5073DFF1A2C4AA74724 │ │ │ │ │ +B09168676DF2455FBC2D45CAC0550C86E5A68588A8FB4DD055BFC1EF562E0098 │ │ │ │ │ +25AB6D2536D9A81B1636A8DF29FA913B3367F10425D041E220D0E26F5ED96B88 │ │ │ │ │ +62C7B37BBEF7FC791AA5B5C12D04B51747938FFD099EF430B3FC4D1131694206 │ │ │ │ │ +57948517CC20A8F4F218D24A72FC2AB384D72D6C9F5722AE3F199594A1FE9013 │ │ │ │ │ +4B3001D6442C14C84AE7626DF8709F60D58DC27A9579163389F975586229EFD0 │ │ │ │ │ +9A7F1C72D7A7A589537A67F7843C67AF740BF0EB9D1A26568446BBD16C3796E8 │ │ │ │ │ +40FF361F9279968038654C9487BE537FE0E6AD82ACD87DBCB4CE55C23F23DABF │ │ │ │ │ +21CE5F0D049B18E4B0805702D6A82A68B9AEFE1054C229B643CD3167E702F5F8 │ │ │ │ │ +FE49FF31355BAAA0F2A06C511BB46E122ACF99D043B64059BAAA3F0058EE5676 │ │ │ │ │ +F5656C2A3295E3E285375C7D84D6EB106B77A69384516A46B743C3B275FCC34A │ │ │ │ │ +B0600A82E7442E930372FB8F772091DA9BF7AE7EFA430233596A56324680DE51 │ │ │ │ │ +2B0DDDA9878918FD24769CEE0192416CC386928AC768041C2546237C1D110D4A │ │ │ │ │ +10D236BC4828B91FA3534EE7A17795C298D6F5EEE61BB643F956EDE6337ABE80 │ │ │ │ │ +53F718158A25BA9233A349632BD28DA2BE2741473AFFDF3A48597F57E7A40CDF │ │ │ │ │ +1AD301B401AEF98D1E364701EA0F5595C615D9CCC5E821649D99A2A4FE597ABC │ │ │ │ │ +CFFFF7F10F70D1D6AB213AB75C09BF22DDA227E457EA96A33A1B4C065FC41376 │ │ │ │ │ +DAD4731B341A43DCEDDE82ECEAE1721C799A0F045D5D982F07D1725457E36A4B │ │ │ │ │ +CA603BD5F7777AE2AA3FD24E02BF1517F2A63F37ABC9725E1785307CC1F13187 │ │ │ │ │ +D1BE38F1E7AFC01A8BAE3A12168BA01F0F3179EA747B88933012D7D87585F96F │ │ │ │ │ +07008DB079932E1BD83B66F4C392E5FAA00047CFF05922CEFD1EBB85C0282A3C │ │ │ │ │ +F79470CCEC2F2832EBE21D946AF4CE08505741EE5039EB34C286D7A40E214C8D │ │ │ │ │ +3AF6F77B875002788DA5F83DB40B707E7B91D3956D9DA437DCC70143865E52B3 │ │ │ │ │ +4B383D54CF81C388789323D20B3B8B3E911B7BFFF01D60D1F23EBC9F8E39D3D4 │ │ │ │ │ +A1487A62696F308D0E0AA727BC0654024927D41635F858365EBD67F7FC07882E │ │ │ │ │ +0D2AABCAA2E4C27F01602DE867E733251A4AACC0347257BA246EDC7D495B7F2B │ │ │ │ │ +2A6CC02BA3996E2D95C1780CF556EF4465CFBBC0FC0792513B9D611DD8E6D5D4 │ │ │ │ │ +0239E3D17FA2F88FBCDC732E16BCAA4727D167AB923FF4F7796856A2AB001595 │ │ │ │ │ +E59CE5C0AEA660A2183FB16FA048AF4C171F24DA5005852BCB46D9A5FA26053B │ │ │ │ │ +21FB6CE3666F8869D835A91D7872A98E16E83C6158E7F3171002EB776EC8B958 │ │ │ │ │ +60D28C499B2A0C06770CE3A8030E1D87676E8C5FE532C77EFE72BADEC1814F7C │ │ │ │ │ +3B12453711EF45E6EF1F6C383BC92C2FCE466D70D48806EFFABE0B3EE8C57D59 │ │ │ │ │ +362174F2209E331CEFA204CB098D40315F4827F18F2A0B5AD799C872E4A282DE │ │ │ │ │ +C4E55BB396B9E5B790F351319A8CC283B71CAEE1656A54A01E995821CB5F616D │ │ │ │ │ +BF7537A83B8D0BD172761D27B5105C32130A9493A12FFF600CF29989D7D3A404 │ │ │ │ │ +F6D6A2FB77091C2EA5B4248BC28E1A1D097E99F4D9F6C658893DFBF0DB2BFAFC │ │ │ │ │ +632F5BBE5D644D921933E23DE5C8AEAF8BE1EA72DC2FFF4736C1E731E782D367 │ │ │ │ │ +3018DDB67921DCB906727B669395366F012BA2F05F25A01FDD5B76CE7B04FFA7 │ │ │ │ │ +AB05100272665999735F3EAA1DDCF3C77A46EA7B7365F095B0594221A7CD2138 │ │ │ │ │ +C89408E7BBD0293B87746C34A46A638EB2CF537330AED977E967733FE8C185EC │ │ │ │ │ +3ECC0B375F0826E4162925774E03B6667D69092D22A21FCD8596C1864BD02FBC │ │ │ │ │ +5D653341EEE0C9ED2D63F89660CB90AF600C51CB9F966A18F2D887EF3CC07F9F │ │ │ │ │ +6F7716FD277F0A06A9D7AC0A8C9A4BD50CBF14FD2BE95CDEBFA552084F54C52D │ │ │ │ │ +7DF2D592049AB770C8D659C2B74648ECD5403471BDF0E19B6E3F7A246F38230F │ │ │ │ │ +F1B76CB0447D2FD52688FB3AE0B2EC799C08FAE74074610E5EE9F856194AAB42 │ │ │ │ │ +77790811168022E81CB15C307304C4A2D644696C62E94A33A9FCAABE1FCCC9A8 │ │ │ │ │ +0B5F5D796E76E6086D488914E6D5CD3DB9F8B87331293FC34484EA1A2C9EC3F1 │ │ │ │ │ +44794E41CCAAABB9AD8897630E80D834793A6147C8A00A14721DE7532DC005A2 │ │ │ │ │ +0413277886782F4AC8C68E473C70F5CA09E1D66AF7BF7ED675BE908287F23EE3 │ │ │ │ │ +CAB7AF49427A67020410CF757C30E5C3894E57DD4B411A4963B54C74EF788FC9 │ │ │ │ │ +B86FCDF130C069B262F353004C537F8EBA1F6170BCCD78DE0A0C4B9E59D0AE1C │ │ │ │ │ +BE11DE868C63D713A93A230E0C98368A085C2D103EDAD472E37087104DFF159B │ │ │ │ │ +646470AFA3A1E01A8CB073135D84A80DEFEA889A3D8A21A0CCC0CA1D14504EF1 │ │ │ │ │ +57DC4EA0424AE8490F09637B5123DBF700B851A74F8A90DD9CC33A28435268DA │ │ │ │ │ +3B9AEDC18BE2992CE513D0C0D7CEA938D6D0DC80DE8066B9856E83F016923E29 │ │ │ │ │ +4092F996480A00A7B723CE994673236157639815B0C3CD38E41E886B3550B608 │ │ │ │ │ +E7BAED13C709BE7FDBB2AE74B6B6C58E8348C088F2C7641C5C7B3D384DB4B044 │ │ │ │ │ +9375A691D0CB2D7A31C8FE4E6EE67DE990281837E23E3711C578519E272EDBE9 │ │ │ │ │ +13A7F525C73EF9BF93707BC01590ECD0206D48AD34906EAC27578CE47A614735 │ │ │ │ │ +59EA93606233E2B9E079DFC79EB6B81D6158B6B67763BF4D23A60CB65F72C01F │ │ │ │ │ +73E1BA876528E89A3324F3068203896C931C2A288C76D1CD6E26B9D47906AB2B │ │ │ │ │ +003EB5DD61E8BE4E649E96BB9409FB2CEE00BF7B9B8EE2D3DD86156CB205D484 │ │ │ │ │ +793076AFA21327E86F85F05F225D70DD60E0C1F321A2D8355EA7D804ABFCE6F3 │ │ │ │ │ +B8880B9C4DB71042A3899C8DC91212E0EDB9F1077974CEB0CC49040417CD43DA │ │ │ │ │ +7006F42E597D43069145D44EA18DBEC469B8576D3B75C82A67C9F533A5A7AD6C │ │ │ │ │ +59EBBA2863E42DE70EAC178A68DBD1E11C4C1B7E0952BD9E7AF9408665E09CAC │ │ │ │ │ +E407206E286D881A979CB73B1DDA74A819B97A98556EF26D45065FCFAAC08B8A │ │ │ │ │ +AE59E089EB96269B595E320E929683886206C39FB1A8CCC7A9BD281ACAB29465 │ │ │ │ │ +2FCC7924493E4508E0FB963CDD7C37BE6C71B365366480BE070DF1A6D924ED4E │ │ │ │ │ +9D3FB72779380AB6CF8C7808BFA584A9B6A162EA87242BB89E250C9143C47C44 │ │ │ │ │ +76D7FF22AF7C44F68F6C4502903567C7BD18E720BB16B9EB6374C21CE1230FBC │ │ │ │ │ +63556FC481B75AFC476C0AD443B07265D11F5236732418630A7BCE72BDA272C3 │ │ │ │ │ +3A0FF80AF45ADD41FEC951FF792FDA3B675F2EC2F3801AE535C9A5CF6D5B6D23 │ │ │ │ │ +AF41A5DCBED1BC2BFD658B071B06BF6FE1B4C257AE79860932AA7901F0B23C16 │ │ │ │ │ +17158E6E44636C2877B40EBB5A3F1CA71C2027AA05143978614BD7FD31C31728 │ │ │ │ │ +7A414D195833ECB030ECAD54C77DB69A144E071328170AE1DF8658AEAEC7682A │ │ │ │ │ +28477E2E70B005C8BABF89EA912E817FBBFCB2122F1590CB98D524F289434DE6 │ │ │ │ │ +3A779EA830A5A4A7BD521FBD9A95900535F5320F630BA513544917041925A9AF │ │ │ │ │ +F74433B58E25F69326022909DC4991EB49D190E377A21EF3B0CE65877C7CA48D │ │ │ │ │ +D8B5DBA68A2FF8F906892B568ADE2DE1B1D8874CB1F5DB0CBF72EF27DBCE0303 │ │ │ │ │ +4594BE7A421A2F0DBB260EA812E242EF9D20BA257B9C8416DB115E07611B9A20 │ │ │ │ │ +59A9C9B501F7A3628353B8EEEBC200CD09627CEBB9FC92503F230CB3583B5A3C │ │ │ │ │ +9F22540684D2F2E35C1253248F8C53F82A5E799A7E094DD276059C2F69A026E0 │ │ │ │ │ +7DD248D440FBC7390104F339425AE8849A4C0ADB8E38DDE576C3175BBA78477D │ │ │ │ │ +79A1B70EC5B11F07DC9C9A59C6AEEE9BBCD381263A7554EDCE96FDB050800457 │ │ │ │ │ +6F747A4872CBCDD9C4073707D1FA8F0778A53316E884667BEFBA141241B0E808 │ │ │ │ │ +3591B7C700487A8542FF01BDD09453BDC985C31C968F84EB11151164AB18485A │ │ │ │ │ +40254076CA81E7B14EA7FBF8420FEBB73D7B9B3A700FE2DCD9BC8B5A157B55BE │ │ │ │ │ +AB22E9BE644F4A4250B34984CA6771D1A305EEBEA15D80C77F0DF93D3FB86208 │ │ │ │ │ +69FE81705D3C17C9A92733C561530CD11BC9CEB8E008F3BC0A292C77CD9FF8CD │ │ │ │ │ +54B3DB005CB05EE170C140C4013DECAD4976B4802B4195302F127886D1820D20 │ │ │ │ │ +71F3820D817B00C02BBF3F555210B3AC7105E7C3D3F0275810811D8897F4D24E │ │ │ │ │ +D3FA01316377745677E2FE86EE1FF4CFD4632B47DC486869543078C0ABE86FD5 │ │ │ │ │ +47CD47E76513A0F2BFA948F3A44299A80A59D006089F45BCF2020B3CD9C9320A │ │ │ │ │ +3B60C88D1D1308BC31B38E2FD0D14F7D73B70EB9D1EDE0868B10F5BD8831D0C2 │ │ │ │ │ +AD4BB71749FC27BD9426EE26046870FE0DB2EBA596B778BD63AFD159FF04BD5F │ │ │ │ │ +6CC1B4035E70ECADE0DA281262F9430C7FA8E9D4B7B2B447D924B9C2BA44E745 │ │ │ │ │ +E254630E2683CA8DB04D952A0DBF68429CB8B7E4A2DABDA7BD5EC44D22AE365E │ │ │ │ │ +A7A44553C01DE467E14C9888EE33A305DC547ACA27BDA0ABA14762F0089544E2 │ │ │ │ │ +749BD2835251682D30AFEADA2F3F7F78731AC18AB5FF021537729E91311912F9 │ │ │ │ │ +66F3EC8EE95A70EEC16093B589BB6C37A21F0C10A258AC454E9835AD2311058B │ │ │ │ │ +82AAC53DC1619CE630D85104F8F38C993EE9A57007AAD0BE6CFEBF1BC929 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -8608,24 +8582,24 @@ │ │ │ │ │ 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 1[44 44 │ │ │ │ │ 1[44 44 44 33[{}86 83.022 /CMTT10 rf /Fq 142[37 23[48 │ │ │ │ │ 69 2[57 2[63 66 53 3[57 1[46 5[69 2[62 65[{}11 83.022 │ │ │ │ │ /CMMI10 rf /Fr 132[67 60 2[97 71 75 52 53 55 2[67 75 │ │ │ │ │ 112 37 2[37 75 67 41 61 75 60 1[65 13[75 2[92 101 1[128 │ │ │ │ │ 3[50 4[103 97 96 102 11[67 67 67 67 67 49[{}34 119.552 │ │ │ │ │ /CMBX12 rf /Fs 131[83 2[44 2[44 46 32 33 33 2[42 46 69 │ │ │ │ │ -23 2[23 1[42 1[37 2[46 42 13[46 6[52 5[54 13[42 2[42 │ │ │ │ │ -2[42 1[42 3[23 44[{}24 83.022 /CMSL10 rf /Ft 132[48 42 │ │ │ │ │ -2[69 50 53 37 38 39 2[48 53 80 27 2[27 53 48 29 44 53 │ │ │ │ │ -42 1[46 6[58 6[53 2[65 72 75 91 57 2[36 3[63 73 69 68 │ │ │ │ │ -72 7[48 2[48 48 48 48 48 48 48 1[27 46[{}42 83.022 /CMBX10 │ │ │ │ │ -rf /Fu 131[83 42 37 44 44 60 44 46 32 33 33 44 46 42 │ │ │ │ │ -46 69 23 44 25 23 46 42 25 37 46 37 46 42 4[42 3[62 85 │ │ │ │ │ -1[62 60 46 61 1[57 65 62 76 52 65 1[30 62 1[54 57 63 │ │ │ │ │ -60 59 62 3[65 2[23 42 42 42 42 42 42 42 42 42 42 42 23 │ │ │ │ │ -28 23 65 1[32 32 23 4[42 20[46 46 48 11[{}73 83.022 /CMR10 │ │ │ │ │ +23 2[23 1[42 1[37 3[42 13[46 6[52 1[43 18[42 2[42 1[42 │ │ │ │ │ +1[42 3[23 44[{}23 83.022 /CMSL10 rf /Ft 132[48 42 2[69 │ │ │ │ │ +50 53 37 38 39 2[48 53 80 27 2[27 53 48 29 44 53 42 1[46 │ │ │ │ │ +6[58 6[53 2[65 72 75 91 57 2[36 3[63 73 69 68 72 7[48 │ │ │ │ │ +2[48 48 48 48 48 48 48 1[27 46[{}42 83.022 /CMBX10 rf │ │ │ │ │ +/Fu 131[83 42 37 44 44 60 44 46 32 33 33 44 46 42 46 │ │ │ │ │ +69 23 44 25 23 46 42 25 37 46 37 46 42 4[42 3[62 85 1[62 │ │ │ │ │ +60 46 61 1[57 65 62 76 52 65 1[30 62 1[54 57 63 60 59 │ │ │ │ │ +62 3[65 2[23 42 42 42 42 42 42 42 42 42 42 42 23 28 23 │ │ │ │ │ +65 1[32 32 23 4[42 20[46 46 48 11[{}73 83.022 /CMR10 │ │ │ │ │ rf /Fv 133[31 37 37 51 37 39 27 28 28 1[39 35 39 59 20 │ │ │ │ │ 1[22 20 39 35 22 31 39 31 39 35 9[72 2[51 39 52 1[48 │ │ │ │ │ 55 53 65 44 2[25 53 3[54 51 50 53 7[35 35 35 35 35 35 │ │ │ │ │ 35 35 35 35 1[20 24 20 31[39 12[{}53 66.4176 /CMR8 rf │ │ │ │ │ %DVIPSBitmapFont: Fw tcrm0600 6 1 │ │ │ │ │ /EN0 load IEn S/IEn X FBB FMat/FMat[0.02 0 0 -0.02 0 │ │ │ │ │ 0]N/FBB[-11 -15 87 40]N │ │ │ │ │ @@ -8642,16 +8616,16 @@ │ │ │ │ │ 0780FC0C0FC07F0C3F803F8C7F0007CCF80001FFE000007F8000001E0000007F800001FF │ │ │ │ │ E00007CCF8003F8C7F007F0C3F80FC0C0FC0781E0780601E0180001E0000001E0000001E │ │ │ │ │ 0000001E0000001E0000000C00001A1D7C9E23>42 D E │ │ │ │ │ /Fx load 0 Fx currentfont 66.6667 scalefont put/FMat │ │ │ │ │ X/FBB X/IEn X │ │ │ │ │ %EndDVIPSBitmapFont │ │ │ │ │ /Fy 134[51 3[54 38 38 38 2[49 54 81 1[51 1[27 54 49 30 │ │ │ │ │ -43 1[43 54 49 9[100 4[72 1[66 4[76 50 2[77 64 1[75 70 │ │ │ │ │ -69 73 8[49 2[49 2[49 1[49 1[27 1[27 44[{}34 99.6264 /CMR12 │ │ │ │ │ +43 1[43 1[49 9[100 4[72 1[66 4[76 50 2[77 2[75 70 69 │ │ │ │ │ +73 9[49 2[49 1[49 1[49 1[27 1[27 44[{}32 99.6264 /CMR12 │ │ │ │ │ rf /Fz 172[90 2[110 121 2[97 6[106 18[81 3[45 46[{}7 │ │ │ │ │ 143.462 /CMBX12 rf /FA 134[70 2[70 73 51 52 51 2[66 73 │ │ │ │ │ 111 36 2[36 1[66 1[58 3[66 13[73 6[83 76[{}16 143.462 │ │ │ │ │ /CMR17 rf end │ │ │ │ │ %%EndProlog │ │ │ │ │ %%BeginSetup │ │ │ │ │ %%Feature: *Resolution 600dpi │ │ │ │ │ @@ -8665,31 +8639,31 @@ │ │ │ │ │ end │ │ │ │ │ %%EndSetup │ │ │ │ │ %%Page: 1 1 │ │ │ │ │ TeXDict begin 1 0 bop 590 739 a FA(Solving)43 b(Linear)g(Systems)f │ │ │ │ │ (using)h Fz(SPOOLES)54 b(2.2)778 1005 y Fy(C.)33 b(C.)g(Ashcraft,)g(R.) │ │ │ │ │ f(G.)h(Grimes,)g(D.)f(J.)h(Pierce,)h(D.)e(K.)g(W)-8 b(ah)1442 │ │ │ │ │ 1121 y(Bo)s(eing)32 b(Phan)m(tom)i(W)-8 b(orks)2458 1085 │ │ │ │ │ -y Fx(*)1590 1341 y Fy(F)g(ebruary)33 b(8,)g(2025)p 0 │ │ │ │ │ -5173 1560 4 v 92 5226 a Fw(*)127 5249 y Fv(P)-6 b(.)33 │ │ │ │ │ -b(O.)g(Bo)n(x)h(24346,)j(Mail)32 b(Stop)i(7L-22,)i(Seattle,)h(W)-6 │ │ │ │ │ -b(ashington)36 b(98124.)62 b(This)32 b(researc)n(h)i(w)n(as)g(supp)r │ │ │ │ │ -(orted)g(in)f(part)h(b)n(y)g(the)g(D)n(ARP)-6 b(A)0 5328 │ │ │ │ │ -y(Con)n(tract)33 b(D)n(ABT63-95-C-0122)f(and)g(the)g(DoD)g(High)f(P)n │ │ │ │ │ -(erformance)h(Computing)g(Mo)r(dernization)g(Program)f(Common)h(HPC)f │ │ │ │ │ -(Soft)n(w)n(are)0 5407 y(Supp)r(ort)25 b(Initiativ)n(e.)1929 │ │ │ │ │ -5656 y Fu(1)p eop end │ │ │ │ │ +y Fx(*)1611 1340 y Fy(Jan)m(uary)33 b(7,)f(2024)p 0 5173 │ │ │ │ │ +1560 4 v 92 5226 a Fw(*)127 5249 y Fv(P)-6 b(.)33 b(O.)g(Bo)n(x)h │ │ │ │ │ +(24346,)j(Mail)32 b(Stop)i(7L-22,)i(Seattle,)h(W)-6 b(ashington)36 │ │ │ │ │ +b(98124.)62 b(This)32 b(researc)n(h)i(w)n(as)g(supp)r(orted)g(in)f │ │ │ │ │ +(part)h(b)n(y)g(the)g(D)n(ARP)-6 b(A)0 5328 y(Con)n(tract)33 │ │ │ │ │ +b(D)n(ABT63-95-C-0122)f(and)g(the)g(DoD)g(High)f(P)n(erformance)h │ │ │ │ │ +(Computing)g(Mo)r(dernization)g(Program)f(Common)h(HPC)f(Soft)n(w)n │ │ │ │ │ +(are)0 5407 y(Supp)r(ort)25 b(Initiativ)n(e.)1929 5656 │ │ │ │ │ +y Fu(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ TeXDict begin 2 1 bop 0 100 a Fu(2)327 b Ft(SPOOLES)32 │ │ │ │ │ b(2.2)27 b Fs(|)g(Solving)g(Linear)g(Systems)p 2053 100 │ │ │ │ │ -1151 4 v 1344 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fr(Con)l(ten)l(ts)0 601 y Ft(1)77 b(Ov)m(erview)3335 │ │ │ │ │ -b(4)0 812 y(2)77 b(Serial)31 b(Solution)g(of)g Fq(AX)f │ │ │ │ │ -Fu(=)23 b Fq(Y)50 b Ft(using)31 b(an)h Fq(LU)40 b Ft(factorization)1572 │ │ │ │ │ -b(6)125 938 y Fu(2.1)83 b(Reading)28 b(the)f(input)i(parameters)k(.)42 │ │ │ │ │ +1186 4 v 1379 w(Jan)n(uary)f(7,)h(2024)0 390 y Fr(Con)l(ten)l(ts)0 │ │ │ │ │ +601 y Ft(1)77 b(Ov)m(erview)3335 b(4)0 812 y(2)77 b(Serial)31 │ │ │ │ │ +b(Solution)g(of)g Fq(AX)f Fu(=)23 b Fq(Y)50 b Ft(using)31 │ │ │ │ │ +b(an)h Fq(LU)40 b Ft(factorization)1572 b(6)125 938 y │ │ │ │ │ +Fu(2.1)83 b(Reading)28 b(the)f(input)i(parameters)k(.)42 │ │ │ │ │ b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ (.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ 134 b(6)125 1065 y(2.2)83 b(Comm)n(unicating)27 b(the)h(data)f(for)h │ │ │ │ │ (the)g(problem)77 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ (.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)134 │ │ │ │ │ b(6)125 1191 y(2.3)83 b(Reordering)26 b(the)i(linear)f(system)78 │ │ │ │ │ b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.) │ │ │ │ │ @@ -8785,61 +8759,60 @@ │ │ │ │ │ b(.)d(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(23)0 │ │ │ │ │ 5196 y Ft(A)53 b Fp(allInOne.c)27 b Ft({)32 b(A)g(Serial)f │ │ │ │ │ Fq(LU)40 b Ft(Driv)m(er)33 b(Program)1941 b(24)0 5407 │ │ │ │ │ y(B)57 b Fp(allInOne.c)27 b Ft({)32 b(A)g(Serial)f Fq(LU)40 │ │ │ │ │ b Ft(Driv)m(er)33 b(Program)1941 b(31)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 0 100 a Fs(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -696 100 1179 4 v 1342 w Ft(SPOOLES)k(2.2)27 b Fs(|)g(Solving)g(Linear)g │ │ │ │ │ -(Systems)327 b Fu(3)0 390 y Ft(C)56 b Fp(allInOne.c)27 │ │ │ │ │ +TeXDict begin 3 2 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1214 4 v 1377 w Ft(SPOOLES)32 b(2.2)27 b Fs(|)g(Solving)g │ │ │ │ │ +(Linear)g(Systems)327 b Fu(3)0 390 y Ft(C)56 b Fp(allInOne.c)27 │ │ │ │ │ b Ft({)32 b(A)g(Serial)f Fq(LU)40 b Ft(Driv)m(er)33 b(Program)1941 │ │ │ │ │ b(39)0 598 y(D)52 b Fp(allInOne.c)27 b Ft({)32 b(A)g(Serial)f │ │ │ │ │ Fq(QR)h Ft(Driv)m(er)h(Program)1934 b(49)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ TeXDict begin 4 3 bop 0 100 a Fu(4)327 b Ft(SPOOLES)32 │ │ │ │ │ b(2.2)27 b Fs(|)g(Solving)g(Linear)g(Systems)p 2053 100 │ │ │ │ │ -1151 4 v 1344 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fr(1)135 b(Ov)l(erview)0 598 y Fu(The)34 b Ft(SPOOLES)h │ │ │ │ │ -Fu(soft)n(w)n(are)d(library)h(is)h(designed)g(to)g(solv)n(e)f(sparse)g │ │ │ │ │ -(systems)h(of)g(linear)f(equations)h Fq(AX)40 b Fu(=)34 │ │ │ │ │ -b Fq(Y)53 b Fu(for)34 b Fq(X)7 b Fu(,)0 698 y(where)20 │ │ │ │ │ -b Fq(A)h Fu(is)f(full)h(rank)f(and)g Fq(X)27 b Fu(and)20 │ │ │ │ │ -b Fq(Y)40 b Fu(are)19 b(dense)h(matrices.)34 b(The)21 │ │ │ │ │ -b(matrix)f Fq(A)g Fu(can)g(b)r(e)h(either)g(real)e(or)h(complex,)h │ │ │ │ │ -(symmetric,)0 797 y(Hermitian,)28 b(square)f(nonsymmetric,)h(or)f(o)n │ │ │ │ │ -(v)n(erdetermined.)36 b(When)29 b Fq(A)f Fu(is)g(square,)f(there)h(are) │ │ │ │ │ -f(four)h(steps)g(in)g(the)g(pro)r(cess)0 897 y(of)g(solving)e │ │ │ │ │ -Fq(AX)k Fu(=)22 b Fq(Y)d Fu(.)125 1090 y Fo(\210)42 b │ │ │ │ │ -Ft(comm)m(unicate)27 b Fu(the)h(data)f(for)g(the)h(problem)f(as)g │ │ │ │ │ -Fq(A)p Fu(,)h Fq(X)34 b Fu(and)28 b Fq(Y)18 b Fu(.)125 │ │ │ │ │ -1258 y Fo(\210)42 b Ft(reorder)27 b Fu(as)663 1237 y │ │ │ │ │ -Fn(e)643 1258 y Fq(A)727 1237 y Fn(e)706 1258 y Fq(X)i │ │ │ │ │ -Fu(=)902 1237 y Fn(e)892 1258 y Fq(Y)18 b Fu(,)28 b(where)1269 │ │ │ │ │ -1237 y Fn(e)1249 1258 y Fq(A)23 b Fu(=)g Fq(P)1475 1270 │ │ │ │ │ -y Fm(1)1513 1258 y Fq(AP)1640 1228 y Fl(T)1628 1279 y │ │ │ │ │ -Fm(1)1692 1258 y Fu(,)1764 1237 y Fn(e)1743 1258 y Fq(X)29 │ │ │ │ │ -b Fu(=)23 b Fq(P)1982 1270 y Fm(1)2019 1258 y Fq(X)34 │ │ │ │ │ -b Fu(and)2294 1237 y Fn(e)2284 1258 y Fq(Y)41 b Fu(=)23 │ │ │ │ │ -b Fq(P)2514 1270 y Fm(1)2552 1258 y Fq(Y)18 b Fu(,)28 │ │ │ │ │ -b(and)f Fq(P)2883 1270 y Fm(1)2949 1258 y Fu(is)g(a)g(p)r(erm)n │ │ │ │ │ -(utation)h(matrix.)125 1437 y Fo(\210)42 b Ft(factor)497 │ │ │ │ │ -1416 y Fn(e)477 1437 y Fq(A)24 b Fu(=)e Fq(P)703 1449 │ │ │ │ │ -y Fm(2)741 1437 y Fq(LD)r(U)9 b(Q)1001 1407 y Fl(T)1001 │ │ │ │ │ -1458 y Fm(2)1052 1437 y Fu(,)28 b(where)f Fq(P)1396 1449 │ │ │ │ │ -y Fm(2)1461 1437 y Fu(and)h Fq(Q)1689 1449 y Fm(2)1753 │ │ │ │ │ -1437 y Fu(are)f(p)r(erm)n(utation)g(matrices.)125 1605 │ │ │ │ │ -y Fo(\210)42 b Ft(solv)m(e)27 b Fq(LD)r(U)9 b Fu(\()p │ │ │ │ │ -Fq(Q)731 1575 y Fl(T)731 1626 y Fm(2)782 1605 y Fq(P)835 │ │ │ │ │ -1617 y Fm(1)873 1605 y Fq(X)e Fu(\))22 b(=)h(\()p Fq(P)1188 │ │ │ │ │ -1575 y Fl(T)1176 1626 y Fm(2)1240 1605 y Fq(P)1293 1617 │ │ │ │ │ -y Fm(1)1331 1605 y Fq(Y)c Fu(\).)0 1798 y(When)26 b Fq(A)h │ │ │ │ │ -Fu(is)e(symmetric)h(or)f(Hermitian,)h Fq(L)c Fu(=)h Fq(U)1562 │ │ │ │ │ -1768 y Fl(T)1640 1798 y Fu(or)i Fq(L)d Fu(=)h Fq(U)1973 │ │ │ │ │ -1768 y Fl(H)2036 1798 y Fu(,)j(resp)r(ectiv)n(ely)-7 │ │ │ │ │ +1186 4 v 1379 w(Jan)n(uary)f(7,)h(2024)0 390 y Fr(1)135 │ │ │ │ │ +b(Ov)l(erview)0 598 y Fu(The)34 b Ft(SPOOLES)h Fu(soft)n(w)n(are)d │ │ │ │ │ +(library)h(is)h(designed)g(to)g(solv)n(e)f(sparse)g(systems)h(of)g │ │ │ │ │ +(linear)f(equations)h Fq(AX)40 b Fu(=)34 b Fq(Y)53 b │ │ │ │ │ +Fu(for)34 b Fq(X)7 b Fu(,)0 698 y(where)20 b Fq(A)h Fu(is)f(full)h │ │ │ │ │ +(rank)f(and)g Fq(X)27 b Fu(and)20 b Fq(Y)40 b Fu(are)19 │ │ │ │ │ +b(dense)h(matrices.)34 b(The)21 b(matrix)f Fq(A)g Fu(can)g(b)r(e)h │ │ │ │ │ +(either)g(real)e(or)h(complex,)h(symmetric,)0 797 y(Hermitian,)28 │ │ │ │ │ +b(square)f(nonsymmetric,)h(or)f(o)n(v)n(erdetermined.)36 │ │ │ │ │ +b(When)29 b Fq(A)f Fu(is)g(square,)f(there)h(are)f(four)h(steps)g(in)g │ │ │ │ │ +(the)g(pro)r(cess)0 897 y(of)g(solving)e Fq(AX)k Fu(=)22 │ │ │ │ │ +b Fq(Y)d Fu(.)125 1090 y Fo(\210)42 b Ft(comm)m(unicate)27 │ │ │ │ │ +b Fu(the)h(data)f(for)g(the)h(problem)f(as)g Fq(A)p Fu(,)h │ │ │ │ │ +Fq(X)34 b Fu(and)28 b Fq(Y)18 b Fu(.)125 1258 y Fo(\210)42 │ │ │ │ │ +b Ft(reorder)27 b Fu(as)663 1237 y Fn(e)643 1258 y Fq(A)727 │ │ │ │ │ +1237 y Fn(e)706 1258 y Fq(X)i Fu(=)902 1237 y Fn(e)892 │ │ │ │ │ +1258 y Fq(Y)18 b Fu(,)28 b(where)1269 1237 y Fn(e)1249 │ │ │ │ │ +1258 y Fq(A)23 b Fu(=)g Fq(P)1475 1270 y Fm(1)1513 1258 │ │ │ │ │ +y Fq(AP)1640 1228 y Fl(T)1628 1279 y Fm(1)1692 1258 y │ │ │ │ │ +Fu(,)1764 1237 y Fn(e)1743 1258 y Fq(X)29 b Fu(=)23 b │ │ │ │ │ +Fq(P)1982 1270 y Fm(1)2019 1258 y Fq(X)34 b Fu(and)2294 │ │ │ │ │ +1237 y Fn(e)2284 1258 y Fq(Y)41 b Fu(=)23 b Fq(P)2514 │ │ │ │ │ +1270 y Fm(1)2552 1258 y Fq(Y)18 b Fu(,)28 b(and)f Fq(P)2883 │ │ │ │ │ +1270 y Fm(1)2949 1258 y Fu(is)g(a)g(p)r(erm)n(utation)h(matrix.)125 │ │ │ │ │ +1437 y Fo(\210)42 b Ft(factor)497 1416 y Fn(e)477 1437 │ │ │ │ │ +y Fq(A)24 b Fu(=)e Fq(P)703 1449 y Fm(2)741 1437 y Fq(LD)r(U)9 │ │ │ │ │ +b(Q)1001 1407 y Fl(T)1001 1458 y Fm(2)1052 1437 y Fu(,)28 │ │ │ │ │ +b(where)f Fq(P)1396 1449 y Fm(2)1461 1437 y Fu(and)h │ │ │ │ │ +Fq(Q)1689 1449 y Fm(2)1753 1437 y Fu(are)f(p)r(erm)n(utation)g │ │ │ │ │ +(matrices.)125 1605 y Fo(\210)42 b Ft(solv)m(e)27 b Fq(LD)r(U)9 │ │ │ │ │ +b Fu(\()p Fq(Q)731 1575 y Fl(T)731 1626 y Fm(2)782 1605 │ │ │ │ │ +y Fq(P)835 1617 y Fm(1)873 1605 y Fq(X)e Fu(\))22 b(=)h(\()p │ │ │ │ │ +Fq(P)1188 1575 y Fl(T)1176 1626 y Fm(2)1240 1605 y Fq(P)1293 │ │ │ │ │ +1617 y Fm(1)1331 1605 y Fq(Y)c Fu(\).)0 1798 y(When)26 │ │ │ │ │ +b Fq(A)h Fu(is)e(symmetric)h(or)f(Hermitian,)h Fq(L)c │ │ │ │ │ +Fu(=)h Fq(U)1562 1768 y Fl(T)1640 1798 y Fu(or)i Fq(L)d │ │ │ │ │ +Fu(=)h Fq(U)1973 1768 y Fl(H)2036 1798 y Fu(,)j(resp)r(ectiv)n(ely)-7 │ │ │ │ │ b(,)26 b(and)f Fq(P)2765 1810 y Fm(2)2826 1798 y Fu(=)d │ │ │ │ │ Fq(Q)2979 1810 y Fm(2)3016 1798 y Fu(.)37 b(F)-7 b(or)25 │ │ │ │ │ b(a)g Fq(QR)h Fu(factorization)0 1898 y(of)i Fq(A)p Fu(,)g(there)f(are) │ │ │ │ │ g(also)f(four)h(steps)h(in)g(the)g(pro)r(cess)e(of)i(solving)e │ │ │ │ │ Fq(AX)k Fu(=)22 b Fq(Y)d Fu(.)125 2091 y Fo(\210)42 b │ │ │ │ │ Ft(comm)m(unicate)27 b Fu(the)h(data)f(for)g(the)h(problem)f(as)g │ │ │ │ │ Fq(A)p Fu(,)h Fq(X)34 b Fu(and)28 b Fq(Y)18 b Fu(.)125 │ │ │ │ │ @@ -8925,45 +8898,45 @@ │ │ │ │ │ 5308 y(F)-7 b(or)35 b(example,)k(consider)c(the)i Fp(DenseMtx)d │ │ │ │ │ Fu(ob)5 b(ject)36 b(that)h(mo)r(dels)f(a)h(dense)f(matrix.)63 │ │ │ │ │ b(The)37 b Fp(DenseMtx/DenseMt)o(x.)o(h)0 5407 y Fu(header)j(\014le)i │ │ │ │ │ (de\014nes)f(the)h(ob)5 b(ject's)41 b(C)g(struct)g(and)h(has)e(protot)n │ │ │ │ │ (yp)r(es)h(\(with)h(extensiv)n(e)e(commen)n(ts\))i(of)f(the)g(ob)5 │ │ │ │ │ b(ject's)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 0 100 a Fs(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -696 100 1179 4 v 1342 w Ft(SPOOLES)k(2.2)27 b Fs(|)g(Solving)g(Linear)g │ │ │ │ │ -(Systems)327 b Fu(5)0 390 y(metho)r(ds.)35 b(The)21 b(source)f(\014les) │ │ │ │ │ -h(are)f(found)i(in)f(the)h Fp(DenseMtx/src)16 b Fu(directory)-7 │ │ │ │ │ -b(.)33 b(The)21 b(L)2629 373 y Fm(A)2666 390 y Fu(T)2712 │ │ │ │ │ -408 y(E)2758 390 y(X)h(do)r(cumen)n(tation)f(\014les)g(are)f(found)0 │ │ │ │ │ -490 y(in)g(the)h Fp(DenseMtx/doc)15 b Fu(directory)-7 │ │ │ │ │ -b(.)34 b(The)20 b(\014les)g(can)g(b)r(e)g(used)g(to)g(create)g(the)g │ │ │ │ │ -Fp(DenseMtx)d Fu(ob)5 b(ject's)20 b(c)n(hapter)f(in)i(the)f(Reference)0 │ │ │ │ │ -589 y(Man)n(ual,)g(or)d(in)i(a)f(standalone)f(manner)h(to)g(generate)g │ │ │ │ │ -(the)g(ob)5 b(ject's)18 b(do)r(cumen)n(tation.)34 b(The)18 │ │ │ │ │ -b Fp(DenseMtx/drivers)12 b Fu(directory)0 689 y(con)n(tains)27 │ │ │ │ │ -b(driv)n(er)f(programs)f(that)j(exercise)f(and)g(v)-5 │ │ │ │ │ -b(alidate)27 b(the)h(ob)5 b(ject's)27 b(functionalit)n(y)-7 │ │ │ │ │ +TeXDict begin 5 4 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1214 4 v 1377 w Ft(SPOOLES)32 b(2.2)27 b Fs(|)g(Solving)g │ │ │ │ │ +(Linear)g(Systems)327 b Fu(5)0 390 y(metho)r(ds.)35 b(The)21 │ │ │ │ │ +b(source)f(\014les)h(are)f(found)i(in)f(the)h Fp(DenseMtx/src)16 │ │ │ │ │ +b Fu(directory)-7 b(.)33 b(The)21 b(L)2629 373 y Fm(A)2666 │ │ │ │ │ +390 y Fu(T)2712 408 y(E)2758 390 y(X)h(do)r(cumen)n(tation)f(\014les)g │ │ │ │ │ +(are)f(found)0 490 y(in)g(the)h Fp(DenseMtx/doc)15 b │ │ │ │ │ +Fu(directory)-7 b(.)34 b(The)20 b(\014les)g(can)g(b)r(e)g(used)g(to)g │ │ │ │ │ +(create)g(the)g Fp(DenseMtx)d Fu(ob)5 b(ject's)20 b(c)n(hapter)f(in)i │ │ │ │ │ +(the)f(Reference)0 589 y(Man)n(ual,)g(or)d(in)i(a)f(standalone)f │ │ │ │ │ +(manner)h(to)g(generate)g(the)g(ob)5 b(ject's)18 b(do)r(cumen)n │ │ │ │ │ +(tation.)34 b(The)18 b Fp(DenseMtx/drivers)12 b Fu(directory)0 │ │ │ │ │ +689 y(con)n(tains)27 b(driv)n(er)f(programs)f(that)j(exercise)f(and)g │ │ │ │ │ +(v)-5 b(alidate)27 b(the)h(ob)5 b(ject's)27 b(functionalit)n(y)-7 │ │ │ │ │ b(.)125 814 y(Almost)23 b(all)h(the)f(metho)r(ds)h(in)g(the)g(library)e │ │ │ │ │ (are)h(asso)r(ciated)f(with)i(a)f(particular)g(ob)5 b(ject.)35 │ │ │ │ │ b(There)23 b(are)g(some)g(exceptions,)0 913 y(mostly)i(found)g(in)g │ │ │ │ │ (the)g Fp(misc/src)d Fu(directory)-7 b(.)34 b(The)25 │ │ │ │ │ b Fp(misc/drivers)20 b Fu(directory)k(con)n(tains)f(the)j(serial)d │ │ │ │ │ Fq(LU)34 b Fu(and)24 b Fq(QR)h Fu(driv)n(er)0 1013 y(programs.)58 │ │ │ │ │ b(The)36 b Fp(MT/drivers)31 b Fu(and)k Fp(MPI/drivers)c │ │ │ │ │ Fu(directories)j(con)n(tain)h(the)h(m)n(ultithreaded)f(and)h(MPI)f │ │ │ │ │ Fq(LU)43 b Fu(driv)n(er)0 1112 y(programs.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ TeXDict begin 6 5 bop 0 100 a Fu(6)327 b Ft(SPOOLES)32 │ │ │ │ │ b(2.2)27 b Fs(|)g(Solving)g(Linear)g(Systems)p 2053 100 │ │ │ │ │ -1151 4 v 1344 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fr(2)135 b(Serial)46 b(Solution)f(of)g Fj(AX)e Fi(=)33 │ │ │ │ │ -b Fj(Y)71 b Fr(using)45 b(an)g Fj(LU)56 b Fr(factorization)0 │ │ │ │ │ -599 y Fu(The)27 b(user)g(has)g(some)g(represen)n(tation)f(of)h(the)h │ │ │ │ │ -(data)f(whic)n(h)g(represen)n(ts)f(the)i(linear)f(system,)g │ │ │ │ │ +1186 4 v 1379 w(Jan)n(uary)f(7,)h(2024)0 390 y Fr(2)135 │ │ │ │ │ +b(Serial)46 b(Solution)f(of)g Fj(AX)e Fi(=)33 b Fj(Y)71 │ │ │ │ │ +b Fr(using)45 b(an)g Fj(LU)56 b Fr(factorization)0 599 │ │ │ │ │ +y Fu(The)27 b(user)g(has)g(some)g(represen)n(tation)f(of)h(the)h(data)f │ │ │ │ │ +(whic)n(h)g(represen)n(ts)f(the)i(linear)f(system,)g │ │ │ │ │ Fq(AX)j Fu(=)22 b Fq(Y)d Fu(.)37 b(The)27 b(user)g(w)n(an)n(ts)0 │ │ │ │ │ 699 y(the)h(solution)f Fq(X)7 b Fu(.)36 b(The)28 b Ft(SPOOLES)g │ │ │ │ │ Fu(library)e(will)i(use)f Fq(A)h Fu(and)g Fq(Y)46 b Fu(and)27 │ │ │ │ │ b(pro)n(vide)g Fq(X)34 b Fu(bac)n(k)26 b(to)i(the)g(user.)125 │ │ │ │ │ 825 y(The)f Ft(SPOOLES)g Fu(library)f(is)h(based)g(on)g(an)g(ob)5 │ │ │ │ │ b(ject)27 b(orien)n(ted)f(design)h(philosoph)n(y)-7 b(.)36 │ │ │ │ │ b(The)27 b(\014rst)g(ob)5 b(ject)28 b(that)f(the)h(user)0 │ │ │ │ │ @@ -9055,24 +9028,25 @@ │ │ │ │ │ b Fu(or)23 b Fp(InpMtx)p 3048 5253 V 29 w(inputComplexEntr)o(y\()o(\))p │ │ │ │ │ 0 5330 1560 4 v 92 5384 a Fg(1)127 5407 y Ff(InpMtx)i │ │ │ │ │ Fv(stands)g(for)d Ff(Inp)p Fv(ut)j Ff(M)p Fv(a)p Ff(t)p │ │ │ │ │ Fv(ri)p Ff(x)p Fv(,)f(for)f(it)g(is)g(the)i(ob)t(ject)f(in)n(to)h(whic) │ │ │ │ │ n(h)e(the)i(user)e(inputs)h(the)h(matrix)e(en)n(tries.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 0 100 a Fs(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -696 100 1179 4 v 1342 w Ft(SPOOLES)k(2.2)27 b Fs(|)g(Solving)g(Linear)g │ │ │ │ │ -(Systems)327 b Fu(7)0 390 y(to)30 b(place)g(that)g(en)n(try)g(in)n(to)g │ │ │ │ │ -(the)g Fp(InpMtx)e Fu(ob)5 b(ject.)44 b(Finally)30 b(this)g(co)r(de)g │ │ │ │ │ -(segmen)n(t)g(closes)f(the)i(\014le.)44 b(\014nalizes)30 │ │ │ │ │ -b(the)g(input)h(to)0 490 y Fp(InpMtx)23 b Fu(b)n(y)j(con)n(v)n(erting)e │ │ │ │ │ -(the)i(in)n(ternal)f(storage)e(of)j(the)g(matrix)f(en)n(tries)g(to)h(a) │ │ │ │ │ -f(v)n(ector)f(form.)36 b(\(This)26 b(is)g(necessary)e(for)h(later)0 │ │ │ │ │ -589 y(steps.\))0 787 y Fp(inputFile)40 b(=)j(fopen\(matrixFile)o(Nam)o │ │ │ │ │ -(e,)37 b("r"\))42 b(;)0 887 y(fscanf\(inputFile)o(,)c("\045d)k(\045d)h │ │ │ │ │ +TeXDict begin 7 6 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1214 4 v 1377 w Ft(SPOOLES)32 b(2.2)27 b Fs(|)g(Solving)g │ │ │ │ │ +(Linear)g(Systems)327 b Fu(7)0 390 y(to)30 b(place)g(that)g(en)n(try)g │ │ │ │ │ +(in)n(to)g(the)g Fp(InpMtx)e Fu(ob)5 b(ject.)44 b(Finally)30 │ │ │ │ │ +b(this)g(co)r(de)g(segmen)n(t)g(closes)f(the)i(\014le.)44 │ │ │ │ │ +b(\014nalizes)30 b(the)g(input)h(to)0 490 y Fp(InpMtx)23 │ │ │ │ │ +b Fu(b)n(y)j(con)n(v)n(erting)e(the)i(in)n(ternal)f(storage)e(of)j(the) │ │ │ │ │ +g(matrix)f(en)n(tries)g(to)h(a)f(v)n(ector)f(form.)36 │ │ │ │ │ +b(\(This)26 b(is)g(necessary)e(for)h(later)0 589 y(steps.\))0 │ │ │ │ │ +787 y Fp(inputFile)40 b(=)j(fopen\(matrixFile)o(Nam)o(e,)37 │ │ │ │ │ +b("r"\))42 b(;)0 887 y(fscanf\(inputFile)o(,)c("\045d)k(\045d)h │ │ │ │ │ (\045d",)f(&nrow,)f(&ncol,)g(&nent\))g(;)0 986 y(neqns)h(=)h(nrow)f(;)0 │ │ │ │ │ 1086 y(mtxA)g(=)h(InpMtx_new\(\))c(;)0 1185 y(InpMtx_init\(mtxA)o(,)f │ │ │ │ │ (INPMTX_BY_ROWS,)f(type,)k(nent,)h(neqns\))f(;)0 1285 │ │ │ │ │ y(if)i(\()g(type)f(==)h(SPOOLES_REAL)38 b(\))43 b({)131 │ │ │ │ │ 1385 y(double)128 b(value)42 b(;)131 1484 y(for)g(\()h(ient)f(=)h(0)h │ │ │ │ │ (;)f(ient)f(<)h(nent)f(;)h(ient++)e(\))i({)262 1584 y(fscanf\(inputFil) │ │ │ │ │ o(e,)37 b("\045d)42 b(\045d)h(\045le",)f(&irow,)f(&jcol,)g(&value\))g │ │ │ │ │ @@ -9135,28 +9109,28 @@ │ │ │ │ │ (they)h(apply)f(to,)h(or)e(the)i(library)e(name,)h(e.g.,)g │ │ │ │ │ Ff(SPOOLES)p 3716 5328 V 27 w(REAL)p Fv(.)0 5407 y(They)e(are)g │ │ │ │ │ (describ)r(ed)g(in)f(the)i(reference)f(man)n(ual)g(in)f(the)i(section)g │ │ │ │ │ (for)d(the)j(particular)e(ob)t(ject.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ TeXDict begin 8 7 bop 0 100 a Fu(8)327 b Ft(SPOOLES)32 │ │ │ │ │ b(2.2)27 b Fs(|)g(Solving)g(Linear)g(Systems)p 2053 100 │ │ │ │ │ -1151 4 v 1344 w(F)-7 b(ebruary)27 b(8,)g(2025)125 390 │ │ │ │ │ -y Fu(Ev)n(ery)e(ob)5 b(ject)27 b(in)g Ft(SPOOLES)g Fu(has)g(prin)n(t)g │ │ │ │ │ -(metho)r(ds)g(to)g(output)h(the)f(con)n(ten)n(ts)f(of)h(that)h(ob)5 │ │ │ │ │ -b(ject.)36 b(This)27 b(is)g(illustrated)0 490 y(in)h(this)g(co)r(de)g │ │ │ │ │ -(segmen)n(t)f(b)n(y)h(prin)n(ting)f(the)h(input)h(matrix)e(as)g(con)n │ │ │ │ │ -(tained)g(in)i(the)f Fp(InpMtx)d Fu(ob)5 b(ject,)28 b │ │ │ │ │ -Fp(mtxA)p Fu(.)e(T)-7 b(o)28 b(shorten)f(this)0 589 y(c)n(hapter)g(w)n │ │ │ │ │ -(e)g(will)g(from)g(no)n(w)g(on)g(omit)h(the)g(part)f(of)g(the)h(co)r │ │ │ │ │ -(de)f(that)h(prin)n(ts)f(debug)h(output)g(to)f Fp(msgFile)e │ │ │ │ │ -Fu(for)h(the)i(v)-5 b(arious)0 689 y(co)r(de)27 b(segmen)n(ts.)36 │ │ │ │ │ -b(The)28 b(complete)g(sample)f(program)e(in)j(Section)g(A)g(con)n │ │ │ │ │ -(tains)e(all)i(of)f(the)h(debug)g(prin)n(t)f(statemen)n(ts.)125 │ │ │ │ │ -807 y(After)f(the)g(matrix)g Fq(A)g Fu(has)f(b)r(een)i(read)e(in)h │ │ │ │ │ -(from)g(the)g(\014le)g(and)g(placed)g(in)g(an)f Fp(InpMtx)f │ │ │ │ │ +1186 4 v 1379 w(Jan)n(uary)f(7,)h(2024)125 390 y Fu(Ev)n(ery)e(ob)5 │ │ │ │ │ +b(ject)27 b(in)g Ft(SPOOLES)g Fu(has)g(prin)n(t)g(metho)r(ds)g(to)g │ │ │ │ │ +(output)h(the)f(con)n(ten)n(ts)f(of)h(that)h(ob)5 b(ject.)36 │ │ │ │ │ +b(This)27 b(is)g(illustrated)0 490 y(in)h(this)g(co)r(de)g(segmen)n(t)f │ │ │ │ │ +(b)n(y)h(prin)n(ting)f(the)h(input)h(matrix)e(as)g(con)n(tained)g(in)i │ │ │ │ │ +(the)f Fp(InpMtx)d Fu(ob)5 b(ject,)28 b Fp(mtxA)p Fu(.)e(T)-7 │ │ │ │ │ +b(o)28 b(shorten)f(this)0 589 y(c)n(hapter)g(w)n(e)g(will)g(from)g(no)n │ │ │ │ │ +(w)g(on)g(omit)h(the)g(part)f(of)g(the)h(co)r(de)f(that)h(prin)n(ts)f │ │ │ │ │ +(debug)h(output)g(to)f Fp(msgFile)e Fu(for)h(the)i(v)-5 │ │ │ │ │ +b(arious)0 689 y(co)r(de)27 b(segmen)n(ts.)36 b(The)28 │ │ │ │ │ +b(complete)g(sample)f(program)e(in)j(Section)g(A)g(con)n(tains)e(all)i │ │ │ │ │ +(of)f(the)h(debug)g(prin)n(t)f(statemen)n(ts.)125 807 │ │ │ │ │ +y(After)f(the)g(matrix)g Fq(A)g Fu(has)f(b)r(een)i(read)e(in)h(from)g │ │ │ │ │ +(the)g(\014le)g(and)g(placed)g(in)g(an)f Fp(InpMtx)f │ │ │ │ │ Fu(ob)5 b(ject,)26 b(the)g(righ)n(t)g(hand)g(matrix)0 │ │ │ │ │ 907 y Fq(Y)46 b Fu(is)28 b(read)f(in)g(from)h(a)f(\014le)h(and)f │ │ │ │ │ (placed)g(in)h(a)f Fp(DenseMtx)e Fu(ob)5 b(ject.)36 b(The)28 │ │ │ │ │ b(follo)n(wing)f(co)r(de)g(fragmen)n(t)g(do)r(es)g(this)h(op)r │ │ │ │ │ (eration.)0 1066 y Fp(inputFile)40 b(=)j(fopen\(rhsFileNam)o(e,)37 │ │ │ │ │ b("r"\))42 b(;)0 1165 y(fscanf\(inputFile)o(,)c("\045d)k(\045d",)g │ │ │ │ │ (&nrow,)f(&nrhs\))g(;)0 1265 y(mtxB)h(=)h(DenseMtx_new\(\))38 │ │ │ │ │ @@ -9215,17 +9189,17 @@ │ │ │ │ │ 5308 y(The)j(righ)n(t)f(hand)h(side)g(en)n(tries)f(are)g(then)h(in,)h │ │ │ │ │ (ro)n(w)e(b)n(y)h(ro)n(w,)f(and)h(placed)g(in)n(to)g(their)g(lo)r │ │ │ │ │ (cations)f(via)g(one)h(of)g(the)g(t)n(w)n(o)0 5407 y(\\set)c(en)n │ │ │ │ │ (tries")g(metho)r(ds.)37 b(Note,)27 b(the)h(nonzero)f(ro)n(ws)f(can)h │ │ │ │ │ (b)r(e)h(read)f(from)g(the)h(\014le)g(in)g(an)n(y)e(order.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 0 100 a Fs(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -696 100 1179 4 v 1342 w Ft(SPOOLES)k(2.2)27 b Fs(|)g(Solving)g(Linear)g │ │ │ │ │ -(Systems)327 b Fu(9)0 390 y Fh(2.3)112 b(Reordering)38 │ │ │ │ │ +TeXDict begin 9 8 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1214 4 v 1377 w Ft(SPOOLES)32 b(2.2)27 b Fs(|)g(Solving)g │ │ │ │ │ +(Linear)g(Systems)327 b Fu(9)0 390 y Fh(2.3)112 b(Reordering)38 │ │ │ │ │ b(the)f(linear)h(system)0 564 y Fu(The)30 b(\014rst)g(step)h(is)f(to)g │ │ │ │ │ (\014nd)h(the)g(p)r(erm)n(utation)f(matrix)f Fq(P)12 │ │ │ │ │ b Fu(,)31 b(and)g(then)f(p)r(erm)n(ute)h Fq(AX)j Fu(=)27 │ │ │ │ │ b Fq(Y)49 b Fu(in)n(to)30 b(\()p Fq(P)12 b(AP)3336 534 │ │ │ │ │ y Fl(T)3389 564 y Fu(\)\()p Fq(P)g(X)7 b Fu(\))27 b(=)g │ │ │ │ │ Fq(P)12 b(Y)19 b Fu(.)0 664 y(The)32 b(result)g(of)g(the)h │ │ │ │ │ Ft(SPOOLES)f Fu(ordering)f(step)h(is)g(not)g(just)h Fq(P)44 │ │ │ │ │ @@ -9311,23 +9285,23 @@ │ │ │ │ │ b(ject.)p 0 5330 1560 4 v 92 5384 a Fg(3)127 5407 y Ff(IVL)24 │ │ │ │ │ b Fv(stands)h(for)e Ff(I)p Fv(n)n(teger)i Ff(V)p Fv(ector)f │ │ │ │ │ Ff(L)p Fv(ist,)g(i.e.,)e(a)i(list)f(of)g(in)n(teger)h(v)n(ectors.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ TeXDict begin 10 9 bop 0 100 a Fu(10)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)125 390 │ │ │ │ │ -y Fu(Once)i(w)n(e)h(ha)n(v)n(e)f(the)i(p)r(erm)n(utation)f(v)n(ector,)f │ │ │ │ │ -(w)n(e)h(apply)g(it)g(to)g(the)h(fron)n(t)f(tree,)g(b)n(y)g(the)h │ │ │ │ │ -Fp(ETree)p 3135 390 27 4 v 29 w(permuteVertices\()o(\))0 │ │ │ │ │ -490 y Fu(metho)r(d,)41 b(and)c(then)h(to)g(the)g(matrix)f(with)h(the)g │ │ │ │ │ -Fp(InpMtx)p 1874 490 V 29 w(permute\(\))c Fu(metho)r(d.)67 │ │ │ │ │ -b(If)38 b(the)g(matrix)f Fq(A)h Fu(is)g(symmetric)f(or)0 │ │ │ │ │ -589 y(Hermitian,)32 b(w)n(e)e(exp)r(ect)h(all)f(nonzero)g(en)n(tries)g │ │ │ │ │ -(to)g(b)r(e)h(in)g(the)g(upp)r(er)g(triangle.)46 b(P)n(erm)n(uting)29 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)125 390 y Fu(Once)i(w)n(e)h(ha)n │ │ │ │ │ +(v)n(e)f(the)i(p)r(erm)n(utation)f(v)n(ector,)f(w)n(e)h(apply)g(it)g │ │ │ │ │ +(to)g(the)h(fron)n(t)f(tree,)g(b)n(y)g(the)h Fp(ETree)p │ │ │ │ │ +3135 390 27 4 v 29 w(permuteVertices\()o(\))0 490 y Fu(metho)r(d,)41 │ │ │ │ │ +b(and)c(then)h(to)g(the)g(matrix)f(with)h(the)g Fp(InpMtx)p │ │ │ │ │ +1874 490 V 29 w(permute\(\))c Fu(metho)r(d.)67 b(If)38 │ │ │ │ │ +b(the)g(matrix)f Fq(A)h Fu(is)g(symmetric)f(or)0 589 │ │ │ │ │ +y(Hermitian,)32 b(w)n(e)e(exp)r(ect)h(all)f(nonzero)g(en)n(tries)g(to)g │ │ │ │ │ +(b)r(e)h(in)g(the)g(upp)r(er)g(triangle.)46 b(P)n(erm)n(uting)29 │ │ │ │ │ b(the)i(matrix)f(yields)h Fq(P)12 b(AP)3825 559 y Fl(T)3877 │ │ │ │ │ 589 y Fu(,)0 689 y(whic)n(h)36 b(ma)n(y)f(not)h(ha)n(v)n(e)f(all)h(of)g │ │ │ │ │ (its)g(en)n(tries)g(in)g(the)g(upp)r(er)h(triangle.)61 │ │ │ │ │ b(If)37 b Fq(A)f Fu(is)g(symmetric)g(or)f(Hermitian,)j(the)f(call)e(to) │ │ │ │ │ 0 789 y Fp(InpMtx)p 269 789 V 29 w(mapToUpperTriang)o(le)o(\(\))24 │ │ │ │ │ b Fu(ensures)29 b(that)i(all)f(en)n(tries)f(of)i Fq(P)12 │ │ │ │ │ b(AP)2348 759 y Fl(T)2430 789 y Fu(are)29 b(in)i(its)f(upp)r(er)h │ │ │ │ │ @@ -9407,23 +9381,22 @@ │ │ │ │ │ Fd(i)p Fv(-th)f(c)n(hevron)i(of)e Fd(A)g Fv(consists)h(of)f(the)i │ │ │ │ │ (diagonal)f(en)n(try)g Fd(A)1829 5338 y Fc(i;i)1896 5328 │ │ │ │ │ y Fv(,)g(the)g Fd(i)p Fv(-th)g(ro)n(w)f(of)g(the)h(upp)r(er)g(triangle) │ │ │ │ │ g(of)f Fd(A)p Fv(,)g(and)h(the)h Fd(i)p Fv(-th)e(column)h(of)0 │ │ │ │ │ 5407 y(the)f(lo)n(w)n(er)e(triangle)h(of)f Fd(A)p Fv(.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(11)0 390 │ │ │ │ │ -y Fp(chvmanager)39 b(=)44 b(ChvManager_new\()o(\))38 │ │ │ │ │ -b(;)0 490 y(ChvManager_init\()o(chv)o(ma)o(na)o(ger)o(,)f(NO_LOCK,)k │ │ │ │ │ -(1\))h(;)0 589 y(DVfill\(10,)d(cpus,)j(0.0\))g(;)0 689 │ │ │ │ │ -y(IVfill\(20,)d(stats,)j(0\))g(;)0 789 y(rootchv)f(=)i │ │ │ │ │ -(FrontMtx_factorI)o(np)o(Mtx)o(\(f)o(ron)o(tm)o(tx)o(,)38 │ │ │ │ │ -b(mtxA,)j(tau,)h(droptol,)567 888 y(chvmanager,)d(&error,)h(cpus,)i │ │ │ │ │ +TeXDict begin 11 10 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(11)0 390 y Fp(chvmanager)39 │ │ │ │ │ +b(=)44 b(ChvManager_new\()o(\))38 b(;)0 490 y(ChvManager_init\()o(chv)o │ │ │ │ │ +(ma)o(na)o(ger)o(,)f(NO_LOCK,)k(1\))h(;)0 589 y(DVfill\(10,)d(cpus,)j │ │ │ │ │ +(0.0\))g(;)0 689 y(IVfill\(20,)d(stats,)j(0\))g(;)0 789 │ │ │ │ │ +y(rootchv)f(=)i(FrontMtx_factorI)o(np)o(Mtx)o(\(f)o(ron)o(tm)o(tx)o(,) │ │ │ │ │ +38 b(mtxA,)j(tau,)h(droptol,)567 888 y(chvmanager,)d(&error,)h(cpus,)i │ │ │ │ │ (stats,)f(msglvl,)g(msgFile\))f(;)0 988 y(ChvManager_free\()o(chv)o(ma) │ │ │ │ │ o(na)o(ger)o(\))d(;)0 1169 y Fu(W)-7 b(orking)25 b(storage)e(used)j │ │ │ │ │ (during)f(the)h(factorization)e(is)h(found)h(in)g(the)g(form)f(of)h │ │ │ │ │ (blo)r(c)n(k)f Fk(chevr)l(ons)p Fu(,)i(in)f(a)f Fp(Chv)f │ │ │ │ │ Fu(ob)5 b(ject,)26 b(whic)n(h)0 1269 y(hold)j(the)g(partial)g(fron)n │ │ │ │ │ (tal)f(matrix)g(for)h(a)f(fron)n(t.)41 b(Muc)n(h)29 b(as)g(with)g(the)g │ │ │ │ │ Fp(SubMtx)e Fu(ob)5 b(ject,)29 b(the)h Fp(FrontMtx)c │ │ │ │ │ @@ -9502,17 +9475,17 @@ │ │ │ │ │ b(for)g(w)n(orking)f(storage.)34 b(The)25 b(last)f(step)h(is)f(to)h(p)r │ │ │ │ │ (erm)n(ute)g(the)g(ro)n(ws)e(of)h(the)h Fp(DenseMtx)d │ │ │ │ │ Fu(from)i(the)h(new)f(ordering)f(in)n(to)0 5407 y(the)28 │ │ │ │ │ b(old)f(ordering.)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ TeXDict begin 12 11 bop 0 100 a Fu(12)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fh(2.7)112 b(Sample)39 b(Matrix)f(and)h(Righ)m(t)d(Hand)i(Side)h(Files) │ │ │ │ │ -0 568 y Fu(Immediately)34 b(b)r(elo)n(w)g(are)f(t)n(w)n(o)g(sample)h │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fh(2.7)112 │ │ │ │ │ +b(Sample)39 b(Matrix)f(and)h(Righ)m(t)d(Hand)i(Side)h(Files)0 │ │ │ │ │ +568 y Fu(Immediately)34 b(b)r(elo)n(w)g(are)f(t)n(w)n(o)g(sample)h │ │ │ │ │ (\014les:)50 b Fp(matrix.input)29 b Fu(holds)34 b(the)g(matrix)g(input) │ │ │ │ │ h(and)f Fp(rhs.input)c Fu(holds)k(the)0 668 y(righ)n(t)20 │ │ │ │ │ b(hand)h(side.)35 b(This)21 b(example)g(is)g(for)f(a)h(symmetric)g │ │ │ │ │ (Laplacian)f(op)r(erator)f(on)i(a)f(3)5 b Fb(\002)g Fu(3)21 │ │ │ │ │ b(grid.)34 b(Only)21 b(en)n(tries)f(in)h(the)h(upp)r(er)0 │ │ │ │ │ 768 y(triangle)j(are)h(stored.)35 b(The)27 b(righ)n(t)e(hand)h(side)h │ │ │ │ │ (is)f(the)g(9)16 b Fb(\002)f Fu(9)26 b(iden)n(tit)n(y)g(matrix.)36 │ │ │ │ │ @@ -9539,29 +9512,29 @@ │ │ │ │ │ (0.0)h(0.0)f(0.0)1533 2351 y(5)h(0.0)g(0.0)f(0.0)g(0.0)h(0.0)f(1.0)g │ │ │ │ │ (0.0)h(0.0)f(0.0)1533 2451 y(6)h(0.0)g(0.0)f(0.0)g(0.0)h(0.0)f(0.0)g │ │ │ │ │ (1.0)h(0.0)f(0.0)1533 2550 y(7)h(0.0)g(0.0)f(0.0)g(0.0)h(0.0)f(0.0)g │ │ │ │ │ (0.0)h(1.0)f(0.0)1533 2650 y(8)h(0.0)g(0.0)f(0.0)g(0.0)h(0.0)f(0.0)g │ │ │ │ │ (0.0)h(0.0)f(1.0)p 3231 2650 V 1483 2653 1750 4 v eop │ │ │ │ │ end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(13)0 390 │ │ │ │ │ -y Fr(3)135 b(Multithreaded)45 b(Solution)h(of)f Fj(AX)e │ │ │ │ │ -Fi(=)33 b Fj(Y)71 b Fr(using)45 b(an)f Fj(LU)57 b Fr(factorization)0 │ │ │ │ │ -599 y Fu(The)26 b(only)f(computations)g(that)h(are)f(m)n(ultithreaded)g │ │ │ │ │ -(are)g(the)h(factorization)e(and)i(forw)n(ard)e(and)h(bac)n(ksolv)n │ │ │ │ │ -(es.)34 b(Therefore,)0 699 y(this)c(section)g(will)g(describ)r(e)g │ │ │ │ │ -(only)g(the)g(di\013erences)g(b)r(et)n(w)n(een)g(the)h(serial)e(driv)n │ │ │ │ │ -(er)g(in)h(Section)g(A)h(and)f(the)g(m)n(ultithreaded)0 │ │ │ │ │ -798 y(driv)n(er)35 b(whose)i(complete)f(listing)h(is)g(found)g(in)g │ │ │ │ │ -(Section)f(B.)65 b(This)36 b(section)h(will)g(refer)f(the)h(reader)e │ │ │ │ │ -(to)i(subsections)f(in)0 898 y(Section)28 b(2)f(for)g(the)h(parts)f(of) │ │ │ │ │ -g(the)h(co)r(de)g(where)f(the)h(t)n(w)n(o)e(driv)n(ers)h(are)f(iden)n │ │ │ │ │ -(tical.)125 1023 y(The)h(shared)g(memory)g(parallel)g(v)n(ersion)f(of)i │ │ │ │ │ +TeXDict begin 13 12 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(13)0 390 y Fr(3)135 b(Multithreaded)45 │ │ │ │ │ +b(Solution)h(of)f Fj(AX)e Fi(=)33 b Fj(Y)71 b Fr(using)45 │ │ │ │ │ +b(an)f Fj(LU)57 b Fr(factorization)0 599 y Fu(The)26 │ │ │ │ │ +b(only)f(computations)g(that)h(are)f(m)n(ultithreaded)g(are)g(the)h │ │ │ │ │ +(factorization)e(and)i(forw)n(ard)e(and)h(bac)n(ksolv)n(es.)34 │ │ │ │ │ +b(Therefore,)0 699 y(this)c(section)g(will)g(describ)r(e)g(only)g(the)g │ │ │ │ │ +(di\013erences)g(b)r(et)n(w)n(een)g(the)h(serial)e(driv)n(er)g(in)h │ │ │ │ │ +(Section)g(A)h(and)f(the)g(m)n(ultithreaded)0 798 y(driv)n(er)35 │ │ │ │ │ +b(whose)i(complete)f(listing)h(is)g(found)g(in)g(Section)f(B.)65 │ │ │ │ │ +b(This)36 b(section)h(will)g(refer)f(the)h(reader)e(to)i(subsections)f │ │ │ │ │ +(in)0 898 y(Section)28 b(2)f(for)g(the)h(parts)f(of)g(the)h(co)r(de)g │ │ │ │ │ +(where)f(the)h(t)n(w)n(o)e(driv)n(ers)h(are)f(iden)n(tical.)125 │ │ │ │ │ +1023 y(The)h(shared)g(memory)g(parallel)g(v)n(ersion)f(of)i │ │ │ │ │ Ft(SPOOLES)g Fu(is)g(implemen)n(ted)g(using)g(thread)f(based)h │ │ │ │ │ (parallelism.)36 b(The)0 1123 y(m)n(ulti-threaded)24 │ │ │ │ │ b(co)r(de)h(uses)f(m)n(uc)n(h)g(of)h(the)g(serial)f(co)r(de)g(|)h(the)g │ │ │ │ │ (basic)f(steps)g(are)g(the)h(same)f(and)h(use)f(the)h(serial)f(metho)r │ │ │ │ │ (ds.)0 1223 y(The)31 b(usage)e(of)i Ft(SPOOLES)g Fu(for)f(comm)n │ │ │ │ │ (unicating)g(the)h(data)g(for)f(the)h(problem)f(and)h(reordering)d(the) │ │ │ │ │ k(linear)e(system)g(is)0 1322 y(iden)n(tical)25 b(in)g(the)h(serial)e │ │ │ │ │ @@ -9627,42 +9600,41 @@ │ │ │ │ │ 5308 y(DV_init\(cumopsDV)o(,)d(nthread,)i(NULL\))h(;)0 │ │ │ │ │ 5407 y(ownersIV)f(=)j(ETree_ddMap\(front)o(ETr)o(ee)o(,)38 │ │ │ │ │ b(type,)j(symmetryflag,)d(cumopsDV,)i(1./\(2.*nthread\)\))d(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ TeXDict begin 14 13 bop 0 100 a Fu(14)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fu(The)d(\014rst)f(step)h(is)f(to)h(ensure)f(that)g(eac)n(h)g(thread)g │ │ │ │ │ -(has)g(a)h(fron)n(t)f(to)g(o)n(wn,)h(decreasing)e(the)i(n)n(um)n(b)r │ │ │ │ │ -(er)f(of)h(threads)f(if)h(necessary)-7 b(.)0 490 y(W)g(e)31 │ │ │ │ │ -b(then)f(construct)g(the)h(o)n(wners)d(map)i(using)g(the)h(fron)n(t)f │ │ │ │ │ -(tree)f(ob)5 b(ject.)45 b(The)30 b Fp(cumopsDV)d Fu(ob)5 │ │ │ │ │ -b(ject)30 b(is)g(a)g(double)g(precision)0 589 y(v)n(ector)e(ob)5 │ │ │ │ │ -b(ject)29 b(whose)f(length)h(is)g(the)h(n)n(um)n(b)r(er)f(of)g │ │ │ │ │ -(threads.)41 b(On)29 b(return)f(from)h(the)h(map)f(call,)g(it)h(con)n │ │ │ │ │ -(tains)e(the)h(n)n(um)n(b)r(er)0 689 y(of)f(factor)e(op)r(erations)h │ │ │ │ │ -(that)g(will)h(b)r(e)g(p)r(erformed)f(b)n(y)h(eac)n(h)f(thread)g(when)g │ │ │ │ │ -(piv)n(oting)g(for)g(stabilit)n(y)h(is)f(not)h(enabled.)0 │ │ │ │ │ -946 y Fh(3.5)112 b(The)38 b(Matrix)g(F)-9 b(actorization)0 │ │ │ │ │ -1124 y Fu(During)38 b(the)g(factorization)e(and)i(solv)n(es,)h(the)f │ │ │ │ │ -(threads)f(access)g(data)g(and)h(mo)r(dify)g(the)g(state)g(of)f(the)i │ │ │ │ │ -Fp(FrontMtx)34 b Fu(and)0 1223 y Fp(SubMtxManager)20 │ │ │ │ │ -b Fu(ob)5 b(jects)25 b(in)g(a)g(concurren)n(t)f(fashion,)i(so)e(there)h │ │ │ │ │ -(m)n(ust)h(b)r(e)f(some)g(w)n(a)n(y)f(to)h(con)n(trol)f(this)i(access)e │ │ │ │ │ -(for)h(critical)0 1323 y(sections)h(of)g(co)r(de.)36 │ │ │ │ │ -b(Inside)26 b(eac)n(h)g(of)g(the)h(t)n(w)n(o)e(ob)5 b(jects)26 │ │ │ │ │ -b(w)n(e)g(ha)n(v)n(e)f(placed)h(a)g Fp(Lock)f Fu(ob)5 │ │ │ │ │ -b(ject.)36 b(The)26 b Ft(SPOOLES)h Fp(Lock)d Fu(ob)5 │ │ │ │ │ -b(ject)0 1423 y(is)25 b(little)i(more)d(than)i(a)f(wrapp)r(er)g(around) │ │ │ │ │ -f(a)h(m)n(utual)h(exclusion)e(lo)r(c)n(k.)36 b(It)26 │ │ │ │ │ -b(pro)n(vides)e(a)h(simple)h(abstract)e(in)n(terface)h(so)g(that)0 │ │ │ │ │ -1522 y(other)30 b(ob)5 b(jects)29 b(whic)n(h)h(con)n(tain)g(lo)r(c)n │ │ │ │ │ -(ks)f(need)h(not)g(kno)n(w)f(ab)r(out)i(the)f(particular)f(thread)g │ │ │ │ │ -(pac)n(k)-5 b(age)29 b(w)n(e)h(use,)g(b)r(e)h(it)f(Solaris)0 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fu(The)d(\014rst)f(step) │ │ │ │ │ +h(is)f(to)h(ensure)f(that)g(eac)n(h)g(thread)g(has)g(a)h(fron)n(t)f(to) │ │ │ │ │ +g(o)n(wn,)h(decreasing)e(the)i(n)n(um)n(b)r(er)f(of)h(threads)f(if)h │ │ │ │ │ +(necessary)-7 b(.)0 490 y(W)g(e)31 b(then)f(construct)g(the)h(o)n │ │ │ │ │ +(wners)d(map)i(using)g(the)h(fron)n(t)f(tree)f(ob)5 b(ject.)45 │ │ │ │ │ +b(The)30 b Fp(cumopsDV)d Fu(ob)5 b(ject)30 b(is)g(a)g(double)g │ │ │ │ │ +(precision)0 589 y(v)n(ector)e(ob)5 b(ject)29 b(whose)f(length)h(is)g │ │ │ │ │ +(the)h(n)n(um)n(b)r(er)f(of)g(threads.)41 b(On)29 b(return)f(from)h │ │ │ │ │ +(the)h(map)f(call,)g(it)h(con)n(tains)e(the)h(n)n(um)n(b)r(er)0 │ │ │ │ │ +689 y(of)f(factor)e(op)r(erations)h(that)g(will)h(b)r(e)g(p)r(erformed) │ │ │ │ │ +f(b)n(y)h(eac)n(h)f(thread)g(when)g(piv)n(oting)g(for)g(stabilit)n(y)h │ │ │ │ │ +(is)f(not)h(enabled.)0 946 y Fh(3.5)112 b(The)38 b(Matrix)g(F)-9 │ │ │ │ │ +b(actorization)0 1124 y Fu(During)38 b(the)g(factorization)e(and)i │ │ │ │ │ +(solv)n(es,)h(the)f(threads)f(access)g(data)g(and)h(mo)r(dify)g(the)g │ │ │ │ │ +(state)g(of)f(the)i Fp(FrontMtx)34 b Fu(and)0 1223 y │ │ │ │ │ +Fp(SubMtxManager)20 b Fu(ob)5 b(jects)25 b(in)g(a)g(concurren)n(t)f │ │ │ │ │ +(fashion,)i(so)e(there)h(m)n(ust)h(b)r(e)f(some)g(w)n(a)n(y)f(to)h(con) │ │ │ │ │ +n(trol)f(this)i(access)e(for)h(critical)0 1323 y(sections)h(of)g(co)r │ │ │ │ │ +(de.)36 b(Inside)26 b(eac)n(h)g(of)g(the)h(t)n(w)n(o)e(ob)5 │ │ │ │ │ +b(jects)26 b(w)n(e)g(ha)n(v)n(e)f(placed)h(a)g Fp(Lock)f │ │ │ │ │ +Fu(ob)5 b(ject.)36 b(The)26 b Ft(SPOOLES)h Fp(Lock)d │ │ │ │ │ +Fu(ob)5 b(ject)0 1423 y(is)25 b(little)i(more)d(than)i(a)f(wrapp)r(er)g │ │ │ │ │ +(around)f(a)h(m)n(utual)h(exclusion)e(lo)r(c)n(k.)36 │ │ │ │ │ +b(It)26 b(pro)n(vides)e(a)h(simple)h(abstract)e(in)n(terface)h(so)g │ │ │ │ │ +(that)0 1522 y(other)30 b(ob)5 b(jects)29 b(whic)n(h)h(con)n(tain)g(lo) │ │ │ │ │ +r(c)n(ks)f(need)h(not)g(kno)n(w)f(ab)r(out)i(the)f(particular)f(thread) │ │ │ │ │ +g(pac)n(k)-5 b(age)29 b(w)n(e)h(use,)g(b)r(e)h(it)f(Solaris)0 │ │ │ │ │ 1622 y(threads,)d(or)g(POSIX)g(threads,)g(or)f(another.)125 │ │ │ │ │ 1746 y(T)-7 b(o)39 b(notify)g(the)h Fp(FrontMtx)d Fu(and)i │ │ │ │ │ Fp(SubMtxManager)34 b Fu(ob)5 b(jects)39 b(that)h(they)g(m)n(ust)f(ha)n │ │ │ │ │ (v)n(e)g(a)g(lo)r(c)n(k,)j(their)d(initialization)0 1846 │ │ │ │ │ y(metho)r(d)31 b(calls)g(di\013er)f(sligh)n(tly)h(from)f(the)h(serial)f │ │ │ │ │ (v)n(ersion.)45 b(See)31 b(Section)g(2.5)f(for)g(a)g(discussion)h(of)f │ │ │ │ │ (the)i(similar)e(features.)0 1945 y(The)e(co)r(de)f(fragmen)n(t)g(b)r │ │ │ │ │ @@ -9717,22 +9689,21 @@ │ │ │ │ │ b(Mo)r(derate)33 b(sp)r(eedups)g(in)g(the)g(factorization)f(ha)n(v)n(e) │ │ │ │ │ g(b)r(een)h(for)g(v)-5 b(alues)32 b(of)h Fp(lookahead)d │ │ │ │ │ Fu(up)j(to)g(the)g(n)n(um)n(b)r(er)208 5308 y(of)i(threads.)58 │ │ │ │ │ b(F)-7 b(or)35 b(nonzero)f Fp(lookahead)d Fu(v)-5 b(alues,)37 │ │ │ │ │ b(the)f(amoun)n(t)e(of)h(w)n(orking)f(storage)f(can)i(increase,)g │ │ │ │ │ (sometimes)208 5407 y(appreciably)-7 b(.)p eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(15)0 390 │ │ │ │ │ -y(The)22 b(p)r(ost-pro)r(cessing)f(of)h(the)g(factorization)f(is)h │ │ │ │ │ -(exactly)g(the)g(same)g(as)g(the)g(serial)f(co)r(de.)35 │ │ │ │ │ -b(Note,)24 b(this)e(step)g(can)g(b)r(e)h(trivially)0 │ │ │ │ │ -490 y(parallelized,)j(but)j(is)e(not)h(done)f(at)h(presen)n(t.)125 │ │ │ │ │ -614 y(After)d(the)g(p)r(ost-pro)r(cessing)e(step,)j(the)f │ │ │ │ │ +TeXDict begin 15 14 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(15)0 390 y(The)22 b(p)r(ost-pro)r(cessing)f │ │ │ │ │ +(of)h(the)g(factorization)f(is)h(exactly)g(the)g(same)g(as)g(the)g │ │ │ │ │ +(serial)f(co)r(de.)35 b(Note,)24 b(this)e(step)g(can)g(b)r(e)h │ │ │ │ │ +(trivially)0 490 y(parallelized,)j(but)j(is)e(not)h(done)f(at)h(presen) │ │ │ │ │ +n(t.)125 614 y(After)d(the)g(p)r(ost-pro)r(cessing)e(step,)j(the)f │ │ │ │ │ Fp(FrontMtx)d Fu(ob)5 b(ject)24 b(con)n(tains)g(the)i │ │ │ │ │ Fq(L)2539 626 y Fl(J)n(;I)2631 614 y Fu(,)g Fq(D)2749 │ │ │ │ │ 626 y Fl(I)5 b(;I)2865 614 y Fu(and)25 b Fq(U)3081 626 │ │ │ │ │ y Fl(I)5 b(;J)3206 614 y Fu(submatrices.)35 b(What)0 │ │ │ │ │ 714 y(remains)24 b(to)h(b)r(e)g(done)f(is)h(to)g(sp)r(ecify)g(whic)n(h) │ │ │ │ │ g(threads)f(o)n(wn)g(whic)n(h)h(submatrices,)f(and)h(th)n(us)g(p)r │ │ │ │ │ (erform)f(computations)h(with)0 814 y(them.)37 b(This)28 │ │ │ │ │ @@ -9763,18 +9734,18 @@ │ │ │ │ │ b(in)h(the)g(latter.)0 3167 y Fh(3.7)112 b(Sample)39 │ │ │ │ │ b(Matrix)f(and)h(Righ)m(t)d(Hand)i(Side)h(Files)0 3345 │ │ │ │ │ y Fu(The)28 b(m)n(ultithreaded)f(driv)n(er)g(uses)g(the)h(same)f(input) │ │ │ │ │ h(\014les)g(as)f(found)g(in)h(Section)g(2.7.)p eop end │ │ │ │ │ %%Page: 16 16 │ │ │ │ │ TeXDict begin 16 15 bop 0 100 a Fu(16)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fr(4)135 b(MPI)44 b(Solution)i(of)f Fj(AX)d Fi(=)34 b │ │ │ │ │ -Fj(Y)70 b Fr(using)45 b(an)g Fj(LU)57 b Fr(factorization)0 │ │ │ │ │ -597 y Fu(Unlik)n(e)30 b(the)h(serial)d(and)i(m)n(ultithreaded)g(en)n │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fr(4)135 │ │ │ │ │ +b(MPI)44 b(Solution)i(of)f Fj(AX)d Fi(=)34 b Fj(Y)70 │ │ │ │ │ +b Fr(using)45 b(an)g Fj(LU)57 b Fr(factorization)0 597 │ │ │ │ │ +y Fu(Unlik)n(e)30 b(the)h(serial)d(and)i(m)n(ultithreaded)g(en)n │ │ │ │ │ (vironmen)n(ts)f(where)h(the)g(data)g(structures)f(are)g(global,)h │ │ │ │ │ (existing)g(under)f(one)0 697 y(address)d(space,)g(in)h(the)h(MPI)e(en) │ │ │ │ │ n(vironmen)n(t,)g(data)h(is)g(lo)r(cal,)f(eac)n(h)g(pro)r(cess)g(or)g │ │ │ │ │ (pro)r(cessor)f(has)h(its)h(o)n(wn)g(distinct)g(address)0 │ │ │ │ │ 797 y(space.)36 b(The)26 b(MPI)f(step-b)n(y-step)h(pro)r(cess)e(to)i │ │ │ │ │ (solv)n(e)f(a)h(linear)f(system)h(is)g(exactly)f(the)i(same)e(as)g(the) │ │ │ │ │ i(m)n(ultithreaded)f(case,)0 896 y(with)g(the)f(additional)g(trouble)f │ │ │ │ │ @@ -9858,34 +9829,34 @@ │ │ │ │ │ (cessors,)e(w)n(e)h(use)0 5407 y(the)e(distributed)g │ │ │ │ │ Fp(InpMtx)p 837 5407 27 4 v 29 w(MPI)p 998 5407 V 30 │ │ │ │ │ w(fullAdjacency\(\))22 b Fu(metho)r(d)28 b(to)f(construct)g(the)h │ │ │ │ │ Fp(IVL)f Fu(ob)5 b(ject)27 b(of)h(the)f(graph)g(of)g │ │ │ │ │ Fq(A)19 b Fu(+)f Fq(A)3819 5377 y Fl(T)3872 5407 y Fu(.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 17 17 │ │ │ │ │ -TeXDict begin 17 16 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(17)125 390 │ │ │ │ │ -y(A)n(t)31 b(this)h(p)r(oin)n(t,)h(eac)n(h)d(pro)r(cessor)g(has)h │ │ │ │ │ -(computed)g(its)h(o)n(wn)f(minim)n(um)h(degree)e(ordering)g(and)i │ │ │ │ │ -(created)e(a)h(fron)n(t)g(tree)0 490 y(ob)5 b(ject.)36 │ │ │ │ │ -b(The)26 b(orderings)e(will)i(lik)n(ely)g(b)r(e)g(di\013eren)n(t,)h(b)r │ │ │ │ │ -(ecause)e(eac)n(h)h(pro)r(cessors)d(input)k(a)e(di\013eren)n(t)i │ │ │ │ │ -(random)e(n)n(um)n(b)r(er)g(seed)0 589 y(to)30 b(the)g(ordering)e │ │ │ │ │ -(metho)r(d.)43 b(Only)29 b(one)h(ordering)e(can)h(b)r(e)h(used)g(for)f │ │ │ │ │ -(the)h(factorization,)f(so)g(the)h(pro)r(cessors)d(collectiv)n(ely)0 │ │ │ │ │ -689 y(determine)f(whic)n(h)f(of)h(the)g(orderings)d(is)j(b)r(est,)g │ │ │ │ │ -(whic)n(h)g(is)f(then)h(broadcast)e(to)i(all)f(the)h(pro)r(cessors,)e │ │ │ │ │ -(as)h(the)h(co)r(de)f(fragmen)n(t)0 789 y(b)r(elo)n(w)i(illustrates.)0 │ │ │ │ │ -972 y Fp(opcounts)40 b(=)j(DVinit\(nproc,)c(0.0\))j(;)0 │ │ │ │ │ -1072 y(opcounts[myid])c(=)43 b(ETree_nFactorOps)o(\(fr)o(on)o(tE)o(Tre) │ │ │ │ │ -o(e,)37 b(type,)k(symmetryflag\))e(;)0 1171 y(MPI_Allgather\(\(v)o(oid) │ │ │ │ │ -e(*\))42 b(&opcounts[myid],)37 b(1,)43 b(MPI_DOUBLE,)610 │ │ │ │ │ -1271 y(\(void)f(*\))g(opcounts,)e(1,)j(MPI_DOUBLE,)c(MPI_COMM_WORLD\))f │ │ │ │ │ -(;)0 1370 y(minops)j(=)i(DVmin\(nproc,)c(opcounts,)h(&root\))h(;)0 │ │ │ │ │ +TeXDict begin 17 16 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(17)125 390 y(A)n(t)31 b(this)h(p)r(oin)n(t,) │ │ │ │ │ +h(eac)n(h)d(pro)r(cessor)g(has)h(computed)g(its)h(o)n(wn)f(minim)n(um)h │ │ │ │ │ +(degree)e(ordering)g(and)i(created)e(a)h(fron)n(t)g(tree)0 │ │ │ │ │ +490 y(ob)5 b(ject.)36 b(The)26 b(orderings)e(will)i(lik)n(ely)g(b)r(e)g │ │ │ │ │ +(di\013eren)n(t,)h(b)r(ecause)e(eac)n(h)h(pro)r(cessors)d(input)k(a)e │ │ │ │ │ +(di\013eren)n(t)i(random)e(n)n(um)n(b)r(er)g(seed)0 589 │ │ │ │ │ +y(to)30 b(the)g(ordering)e(metho)r(d.)43 b(Only)29 b(one)h(ordering)e │ │ │ │ │ +(can)h(b)r(e)h(used)g(for)f(the)h(factorization,)f(so)g(the)h(pro)r │ │ │ │ │ +(cessors)d(collectiv)n(ely)0 689 y(determine)f(whic)n(h)f(of)h(the)g │ │ │ │ │ +(orderings)d(is)j(b)r(est,)g(whic)n(h)g(is)f(then)h(broadcast)e(to)i │ │ │ │ │ +(all)f(the)h(pro)r(cessors,)e(as)h(the)h(co)r(de)f(fragmen)n(t)0 │ │ │ │ │ +789 y(b)r(elo)n(w)i(illustrates.)0 972 y Fp(opcounts)40 │ │ │ │ │ +b(=)j(DVinit\(nproc,)c(0.0\))j(;)0 1072 y(opcounts[myid])c(=)43 │ │ │ │ │ +b(ETree_nFactorOps)o(\(fr)o(on)o(tE)o(Tre)o(e,)37 b(type,)k │ │ │ │ │ +(symmetryflag\))e(;)0 1171 y(MPI_Allgather\(\(v)o(oid)e(*\))42 │ │ │ │ │ +b(&opcounts[myid],)37 b(1,)43 b(MPI_DOUBLE,)610 1271 │ │ │ │ │ +y(\(void)f(*\))g(opcounts,)e(1,)j(MPI_DOUBLE,)c(MPI_COMM_WORLD\))f(;)0 │ │ │ │ │ +1370 y(minops)j(=)i(DVmin\(nproc,)c(opcounts,)h(&root\))h(;)0 │ │ │ │ │ 1470 y(DVfree\(opcounts\))c(;)0 1570 y(frontETree)i(=)44 │ │ │ │ │ b(ETree_MPI_Bcast)o(\(fr)o(on)o(tET)o(re)o(e,)37 b(root,)42 │ │ │ │ │ b(msglvl,)e(msgFile,)h(MPI_COMM_WORLD\))c(;)0 1824 y │ │ │ │ │ Fh(4.4)112 b(Non-n)m(umeric)39 b(w)m(ork)0 2001 y Fu(Once)28 │ │ │ │ │ b(the)h(fron)n(t)f(tree)g(is)h(replicated)f(across)f(the)h(pro)r │ │ │ │ │ (cessors,)f(w)n(e)h(obtain)g(the)h(p)r(erm)n(utation)g(v)n(ectors)e │ │ │ │ │ (and)h(p)r(erm)n(ute)h(the)0 2100 y(v)n(ertices)h(in)h(the)h(fron)n(t)e │ │ │ │ │ @@ -9931,18 +9902,18 @@ │ │ │ │ │ b(=)j(0)h(;)0 5208 y(newA)e(=)h(InpMtx_MPI_split)o(\(mt)o(xA)o(,)38 │ │ │ │ │ b(vtxmapIV,)h(stats,)j(msglvl,)e(msgFile,)h(firsttag,)0 │ │ │ │ │ 5308 y(MPI_COMM_WORLD\))c(;)0 5407 y(InpMtx_free\(mtxA)o(\))h(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 18 18 │ │ │ │ │ TeXDict begin 18 17 bop 0 100 a Fu(18)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fp(mtxA)42 b(=)h(newA)f(;)0 490 y(InpMtx_changeSto)o(rag)o(eM)o(od)o │ │ │ │ │ -(e\(m)o(tx)o(A,)37 b(INPMTX_BY_VECTORS)o(\))g(;)0 589 │ │ │ │ │ -y(newY)42 b(=)h(DenseMtx_MPI_spl)o(itB)o(yR)o(ows)o(\(m)o(txY)o(,)37 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fp(mtxA)42 │ │ │ │ │ +b(=)h(newA)f(;)0 490 y(InpMtx_changeSto)o(rag)o(eM)o(od)o(e\(m)o(tx)o │ │ │ │ │ +(A,)37 b(INPMTX_BY_VECTORS)o(\))g(;)0 589 y(newY)42 b(=)h │ │ │ │ │ +(DenseMtx_MPI_spl)o(itB)o(yR)o(ows)o(\(m)o(txY)o(,)37 │ │ │ │ │ b(vtxmapIV,)j(stats,)h(msglvl,)1395 689 y(msgFile,)f(firsttag,)g │ │ │ │ │ (MPI_COMM_WORLD\))d(;)0 789 y(DenseMtx_free\(mt)o(xY\))g(;)0 │ │ │ │ │ 888 y(mtxY)42 b(=)h(newY)f(;)0 1073 y Fu(The)27 b Fp(InpMtx)p │ │ │ │ │ 439 1073 27 4 v 29 w(MPI)p 600 1073 V 30 w(split\(\))e │ │ │ │ │ Fu(metho)r(d)i(assem)n(bles)f(and)h(redistributes)g(the)h(matrix)e(en)n │ │ │ │ │ (tries)h(b)n(y)g(the)g(v)n(ectors)f(of)h(the)h(lo)r(cal)0 │ │ │ │ │ 1173 y(matrix.)58 b(Recall)34 b(ab)r(o)n(v)n(e)g(that)h(the)g(co)r │ │ │ │ │ @@ -10006,26 +9977,26 @@ │ │ │ │ │ (addition)f(of)h(the)g Fp(firsttag)c Fu(and)k(MPI)f(comm)n(unicator)f │ │ │ │ │ (at)i(the)g(end.)125 5308 y(The)h(p)r(ost-pro)r(cessing)e(of)j(the)f │ │ │ │ │ (factorization)f(is)h(the)h(same)f(in)g(principle)g(as)g(in)g(the)h │ │ │ │ │ (serial)e(co)r(de)h(but)h(di\013ers)f(in)h(that)0 5407 │ │ │ │ │ y(is)d(uses)h(the)g(distributed)g(data)f(structures.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 19 19 │ │ │ │ │ -TeXDict begin 19 18 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(19)0 390 │ │ │ │ │ -y Fp(FrontMtx_MPI_pos)o(tPr)o(oc)o(es)o(s\(f)o(ro)o(ntm)o(tx)o(,)38 │ │ │ │ │ -b(ownersIV,)h(stats,)i(msglvl,)1090 490 y(msgFile,)f(firsttag,)g │ │ │ │ │ -(MPI_COMM_WORLD\))d(;)0 682 y Fu(After)f(the)g(p)r(ost-pro)r(cessing)e │ │ │ │ │ -(step,)j(eac)n(h)e(lo)r(cal)g Fp(FrontMtx)d Fu(ob)5 b(ject)36 │ │ │ │ │ -b(con)n(tains)e(the)i Fq(L)2759 694 y Fl(J)n(;I)2851 │ │ │ │ │ -682 y Fu(,)i Fq(D)2981 694 y Fl(I)5 b(;I)3108 682 y Fu(and)36 │ │ │ │ │ -b Fq(U)3335 694 y Fl(I)5 b(;J)3470 682 y Fu(submatrices)0 │ │ │ │ │ -782 y(for)37 b(the)g(fron)n(ts)g(that)g(w)n(ere)f(o)n(wned)h(b)n(y)g │ │ │ │ │ -(the)g(particular)f(pro)r(cessor.)64 b(Ho)n(w)n(ev)n(er,)37 │ │ │ │ │ +TeXDict begin 19 18 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(19)0 390 y Fp(FrontMtx_MPI_pos)o(tPr)o(oc)o │ │ │ │ │ +(es)o(s\(f)o(ro)o(ntm)o(tx)o(,)38 b(ownersIV,)h(stats,)i(msglvl,)1090 │ │ │ │ │ +490 y(msgFile,)f(firsttag,)g(MPI_COMM_WORLD\))d(;)0 682 │ │ │ │ │ +y Fu(After)f(the)g(p)r(ost-pro)r(cessing)e(step,)j(eac)n(h)e(lo)r(cal)g │ │ │ │ │ +Fp(FrontMtx)d Fu(ob)5 b(ject)36 b(con)n(tains)e(the)i │ │ │ │ │ +Fq(L)2759 694 y Fl(J)n(;I)2851 682 y Fu(,)i Fq(D)2981 │ │ │ │ │ +694 y Fl(I)5 b(;I)3108 682 y Fu(and)36 b Fq(U)3335 694 │ │ │ │ │ +y Fl(I)5 b(;J)3470 682 y Fu(submatrices)0 782 y(for)37 │ │ │ │ │ +b(the)g(fron)n(ts)g(that)g(w)n(ere)f(o)n(wned)h(b)n(y)g(the)g │ │ │ │ │ +(particular)f(pro)r(cessor.)64 b(Ho)n(w)n(ev)n(er,)37 │ │ │ │ │ b(the)h(parallel)e(solv)n(e)g(is)h(based)g(on)g(the)0 │ │ │ │ │ 881 y(submatrices)27 b(b)r(eing)g(distributed)i(across)c(the)j(pro)r │ │ │ │ │ (cessors,)d(not)j(just)g(the)g(fron)n(ts.)125 1006 y(W)-7 │ │ │ │ │ b(e)30 b(m)n(ust)g(sp)r(ecify)g(whic)n(h)g(threads)f(o)n(wn)g(whic)n(h) │ │ │ │ │ h(submatrices,)g(and)f(so)h(p)r(erform)f(computations)g(with)i(them.)44 │ │ │ │ │ b(This)0 1106 y(is)27 b(done)h(b)n(y)f(constructing)g(a)g │ │ │ │ │ Fk(\\solve{map")i Fu(ob)5 b(ject,)28 b(as)f(w)n(e)g(see)g(b)r(elo)n(w.) │ │ │ │ │ @@ -10078,32 +10049,32 @@ │ │ │ │ │ b(=)43 b(FrontMtx_ownedCo)o(lum)o(ns)o(IV)o(\(fr)o(on)o(tmt)o(x,)37 │ │ │ │ │ b(myid,)k(ownersIV,)1787 5308 y(msglvl,)g(msgFile\))f(;)0 │ │ │ │ │ 5407 y(nmycol)h(=)i(IV_size\(ownedColu)o(mn)o(sIV)o(\))37 │ │ │ │ │ b(;)p eop end │ │ │ │ │ %%Page: 20 20 │ │ │ │ │ TeXDict begin 20 19 bop 0 100 a Fu(20)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fp(mtxX)42 b(=)h(DenseMtx_new\(\))38 b(;)0 490 y(if)43 │ │ │ │ │ -b(\()g(nmycol)e(>)i(0)g(\))h({)131 589 y(DenseMtx_init\(mt)o(xX)o(,)37 │ │ │ │ │ -b(type,)42 b(0,)h(0,)g(nmycol,)d(nrhs,)i(1,)g(nmycol\))f(;)131 │ │ │ │ │ -689 y(DenseMtx_rowIndi)o(ce)o(s\()o(mtx)o(X,)c(&nrow,)k(&rowind\))f(;) │ │ │ │ │ -131 789 y(IVcopy\(nmycol,)e(rowind,)i(IV_entries\(ownedC)o(ol)o(umn)o │ │ │ │ │ -(sI)o(V\))o(\))e(;)0 888 y(})0 1079 y Fu(If)25 b Fq(A)h │ │ │ │ │ -Fu(is)f(symmetric,)g(or)f(if)i(piv)n(oting)e(for)h(stabilit)n(y)g(w)n │ │ │ │ │ -(as)f(not)h(used,)g(then)h Fp(mtxX)d Fu(can)i(just)h(b)r(e)f(a)g(p)r │ │ │ │ │ -(oin)n(ter)g(to)g Fp(mtxY)p Fu(,)e(i.e.,)j Fq(P)12 b(X)0 │ │ │ │ │ -1179 y Fu(could)27 b(o)n(v)n(erwrite)f Fq(P)12 b(Y)18 │ │ │ │ │ -b Fu(.)125 1303 y(The)27 b(parallel)g(solv)n(e)f(is)h(remark)-5 │ │ │ │ │ -b(ably)27 b(similar)f(to)i(the)g(serial)e(solv)n(e,)h(as)g(w)n(e)g(see) │ │ │ │ │ -g(with)h(the)g(co)r(de)g(fragmen)n(t)e(b)r(elo)n(w.)0 │ │ │ │ │ -1494 y Fp(solvemanager)39 b(=)k(SubMtxManager_ne)o(w\()o(\))38 │ │ │ │ │ -b(;)0 1594 y(SubMtxManager_in)o(it\()o(so)o(lv)o(ema)o(na)o(ger)o(,)f │ │ │ │ │ -(NO_LOCK,)k(0\))h(;)0 1694 y(FrontMtx_MPI_sol)o(ve\()o(fr)o(on)o(tmt)o │ │ │ │ │ -(x,)37 b(mtxX,)42 b(mtxY,)f(solvemanager,)d(solvemap,)i(cpus,)828 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fp(mtxX)42 │ │ │ │ │ +b(=)h(DenseMtx_new\(\))38 b(;)0 490 y(if)43 b(\()g(nmycol)e(>)i(0)g(\)) │ │ │ │ │ +h({)131 589 y(DenseMtx_init\(mt)o(xX)o(,)37 b(type,)42 │ │ │ │ │ +b(0,)h(0,)g(nmycol,)d(nrhs,)i(1,)g(nmycol\))f(;)131 689 │ │ │ │ │ +y(DenseMtx_rowIndi)o(ce)o(s\()o(mtx)o(X,)c(&nrow,)k(&rowind\))f(;)131 │ │ │ │ │ +789 y(IVcopy\(nmycol,)e(rowind,)i(IV_entries\(ownedC)o(ol)o(umn)o(sI)o │ │ │ │ │ +(V\))o(\))e(;)0 888 y(})0 1079 y Fu(If)25 b Fq(A)h Fu(is)f(symmetric,)g │ │ │ │ │ +(or)f(if)i(piv)n(oting)e(for)h(stabilit)n(y)g(w)n(as)f(not)h(used,)g │ │ │ │ │ +(then)h Fp(mtxX)d Fu(can)i(just)h(b)r(e)f(a)g(p)r(oin)n(ter)g(to)g │ │ │ │ │ +Fp(mtxY)p Fu(,)e(i.e.,)j Fq(P)12 b(X)0 1179 y Fu(could)27 │ │ │ │ │ +b(o)n(v)n(erwrite)f Fq(P)12 b(Y)18 b Fu(.)125 1303 y(The)27 │ │ │ │ │ +b(parallel)g(solv)n(e)f(is)h(remark)-5 b(ably)27 b(similar)f(to)i(the)g │ │ │ │ │ +(serial)e(solv)n(e,)h(as)g(w)n(e)g(see)g(with)h(the)g(co)r(de)g │ │ │ │ │ +(fragmen)n(t)e(b)r(elo)n(w.)0 1494 y Fp(solvemanager)39 │ │ │ │ │ +b(=)k(SubMtxManager_ne)o(w\()o(\))38 b(;)0 1594 y(SubMtxManager_in)o │ │ │ │ │ +(it\()o(so)o(lv)o(ema)o(na)o(ger)o(,)f(NO_LOCK,)k(0\))h(;)0 │ │ │ │ │ +1694 y(FrontMtx_MPI_sol)o(ve\()o(fr)o(on)o(tmt)o(x,)37 │ │ │ │ │ +b(mtxX,)42 b(mtxY,)f(solvemanager,)d(solvemap,)i(cpus,)828 │ │ │ │ │ 1793 y(stats,)h(msglvl,)g(msgFile,)f(firsttag,)g(MPI_COMM_WORLD\))d(;)0 │ │ │ │ │ 1893 y(SubMtxManager_fr)o(ee\()o(so)o(lv)o(ema)o(na)o(ger)o(\))g(;)0 │ │ │ │ │ 2084 y Fu(The)30 b(only)g(di\013erence)f(b)r(et)n(w)n(een)h(the)h(m)n │ │ │ │ │ (ultithreaded)e(and)h(MPI)g(solv)n(e)f(metho)r(ds)h(is)g(the)g │ │ │ │ │ (presence)f(of)h(the)g(\014rst)g(tag)f(and)0 2183 y(MPI)e(comm)n │ │ │ │ │ (unicator)f(in)i(the)g(latter.)125 2308 y(The)i(last)f(step)i(is)f(to)g │ │ │ │ │ (p)r(erm)n(ute)g(the)g(ro)n(ws)f(of)h(the)g(lo)r(cal)g(solution)f │ │ │ │ │ @@ -10142,48 +10113,47 @@ │ │ │ │ │ 1205 4918 V 1222 4918 V 1273 4520 a(2)h(1)1273 4619 y(2)g(0.0)1273 │ │ │ │ │ 4719 y(3)g(0.0)p 1932 4918 V 1948 4918 V 2000 4520 a(2)f(1)2000 │ │ │ │ │ 4619 y(4)87 b(1.0)2000 4719 y(5)g(0.0)p 2658 4918 V 2675 │ │ │ │ │ 4918 V 2726 4520 a(3)43 b(1)2726 4619 y(6)87 b(0.0)2726 │ │ │ │ │ 4719 y(7)g(0.0)2726 4818 y(8)g(0.0)p 3385 4918 V 3401 │ │ │ │ │ 4918 V 497 4921 2906 4 v eop end │ │ │ │ │ %%Page: 21 21 │ │ │ │ │ -TeXDict begin 21 20 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(21)0 390 │ │ │ │ │ -y Fr(5)135 b(Serial)46 b(Solution)f(of)g Fj(AX)e Fi(=)33 │ │ │ │ │ -b Fj(Y)71 b Fr(using)45 b(an)g Fj(QR)g Fr(factorization)0 │ │ │ │ │ -595 y Fu(Let)28 b(us)f(review)g(the)h(steps)g(is)f(solving)g │ │ │ │ │ -Fq(AX)i Fu(=)23 b Fq(Y)46 b Fu(using)27 b(a)h Fq(QR)g │ │ │ │ │ -Fu(factorization.)125 777 y Fo(\210)42 b Ft(comm)m(unicate)27 │ │ │ │ │ -b Fu(the)h(data)f(for)g(the)h(problem)f(as)g Fq(A)p Fu(,)h │ │ │ │ │ -Fq(X)34 b Fu(and)28 b Fq(Y)18 b Fu(.)125 940 y Fo(\210)42 │ │ │ │ │ -b Ft(reorder)27 b Fu(as)663 919 y Fn(e)643 940 y Fq(A)727 │ │ │ │ │ -919 y Fn(e)706 940 y Fq(X)i Fu(=)23 b Fq(Y)18 b Fu(,)28 │ │ │ │ │ -b(where)1269 919 y Fn(e)1249 940 y Fq(A)23 b Fu(=)g Fq(AP)1549 │ │ │ │ │ -909 y Fl(T)1629 940 y Fu(and)1812 919 y Fn(e)1791 940 │ │ │ │ │ -y Fq(X)29 b Fu(=)23 b Fq(P)12 b(X)7 b Fu(.)36 b(and)27 │ │ │ │ │ -b Fq(P)40 b Fu(is)27 b(a)g(p)r(erm)n(utation)h(matrix.)125 │ │ │ │ │ -1102 y Fo(\210)42 b Ft(factor)497 1081 y Fn(e)477 1102 │ │ │ │ │ -y Fq(A)24 b Fu(=)e Fq(QR)q Fu(,)27 b(where)h Fq(Q)f Fu(is)g(orthogonal) │ │ │ │ │ -f(and)h Fq(R)h Fu(is)g(upp)r(er)g(triangular.)125 1264 │ │ │ │ │ -y Fo(\210)42 b Ft(solv)m(e)27 b Fq(R)503 1234 y Fl(T)555 │ │ │ │ │ -1264 y Fq(R)q Fu(\()p Fq(P)12 b(X)7 b Fu(\))22 b(=)h │ │ │ │ │ -Fq(A)996 1234 y Fl(T)1048 1264 y Fq(Y)47 b Fu(\(if)28 │ │ │ │ │ -b(real\))f(or)g Ft(solv)m(e)g Fq(R)1842 1234 y Fl(H)1904 │ │ │ │ │ -1264 y Fq(R)q Fu(\()p Fq(P)12 b(X)7 b Fu(\))23 b(=)f │ │ │ │ │ -Fq(A)2345 1234 y Fl(H)2409 1264 y Fq(Y)46 b Fu(\(if)28 │ │ │ │ │ -b(complex\).)125 1446 y(A)21 b(complete)h(listing)f(of)h(a)f(sample)g │ │ │ │ │ -(program)e(is)i(found)h(in)g(Section)f(D.)36 b(W)-7 b(e)21 │ │ │ │ │ -b(will)h(no)n(w)f(b)r(egin)h(to)f(w)n(ork)f(our)h(w)n(a)n(y)f(through)0 │ │ │ │ │ -1546 y(the)28 b(program)e(to)h(illustrate)g(the)h(use)g(of)f │ │ │ │ │ -Ft(SPOOLES)h Fu(to)f(solv)n(e)g(a)g(system)g(of)h(linear)f(equations.)0 │ │ │ │ │ -1800 y Fh(5.1)112 b(Reading)39 b(the)e(input)h(parameters)0 │ │ │ │ │ -1976 y Fu(The)31 b(input)h(parameters)d(are)h(iden)n(tical)h(to)g │ │ │ │ │ -(those)g(of)g(the)g(serial)f Fq(LU)39 b Fu(driv)n(er)30 │ │ │ │ │ -b(program)f(describ)r(ed)i(in)g(Section)g(2.1)g(with)0 │ │ │ │ │ +TeXDict begin 21 20 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(21)0 390 y Fr(5)135 b(Serial)46 │ │ │ │ │ +b(Solution)f(of)g Fj(AX)e Fi(=)33 b Fj(Y)71 b Fr(using)45 │ │ │ │ │ +b(an)g Fj(QR)g Fr(factorization)0 595 y Fu(Let)28 b(us)f(review)g(the)h │ │ │ │ │ +(steps)g(is)f(solving)g Fq(AX)i Fu(=)23 b Fq(Y)46 b Fu(using)27 │ │ │ │ │ +b(a)h Fq(QR)g Fu(factorization.)125 777 y Fo(\210)42 │ │ │ │ │ +b Ft(comm)m(unicate)27 b Fu(the)h(data)f(for)g(the)h(problem)f(as)g │ │ │ │ │ +Fq(A)p Fu(,)h Fq(X)34 b Fu(and)28 b Fq(Y)18 b Fu(.)125 │ │ │ │ │ +940 y Fo(\210)42 b Ft(reorder)27 b Fu(as)663 919 y Fn(e)643 │ │ │ │ │ +940 y Fq(A)727 919 y Fn(e)706 940 y Fq(X)i Fu(=)23 b │ │ │ │ │ +Fq(Y)18 b Fu(,)28 b(where)1269 919 y Fn(e)1249 940 y │ │ │ │ │ +Fq(A)23 b Fu(=)g Fq(AP)1549 909 y Fl(T)1629 940 y Fu(and)1812 │ │ │ │ │ +919 y Fn(e)1791 940 y Fq(X)29 b Fu(=)23 b Fq(P)12 b(X)7 │ │ │ │ │ +b Fu(.)36 b(and)27 b Fq(P)40 b Fu(is)27 b(a)g(p)r(erm)n(utation)h │ │ │ │ │ +(matrix.)125 1102 y Fo(\210)42 b Ft(factor)497 1081 y │ │ │ │ │ +Fn(e)477 1102 y Fq(A)24 b Fu(=)e Fq(QR)q Fu(,)27 b(where)h │ │ │ │ │ +Fq(Q)f Fu(is)g(orthogonal)f(and)h Fq(R)h Fu(is)g(upp)r(er)g │ │ │ │ │ +(triangular.)125 1264 y Fo(\210)42 b Ft(solv)m(e)27 b │ │ │ │ │ +Fq(R)503 1234 y Fl(T)555 1264 y Fq(R)q Fu(\()p Fq(P)12 │ │ │ │ │ +b(X)7 b Fu(\))22 b(=)h Fq(A)996 1234 y Fl(T)1048 1264 │ │ │ │ │ +y Fq(Y)47 b Fu(\(if)28 b(real\))f(or)g Ft(solv)m(e)g │ │ │ │ │ +Fq(R)1842 1234 y Fl(H)1904 1264 y Fq(R)q Fu(\()p Fq(P)12 │ │ │ │ │ +b(X)7 b Fu(\))23 b(=)f Fq(A)2345 1234 y Fl(H)2409 1264 │ │ │ │ │ +y Fq(Y)46 b Fu(\(if)28 b(complex\).)125 1446 y(A)21 b(complete)h │ │ │ │ │ +(listing)f(of)h(a)f(sample)g(program)e(is)i(found)h(in)g(Section)f(D.) │ │ │ │ │ +36 b(W)-7 b(e)21 b(will)h(no)n(w)f(b)r(egin)h(to)f(w)n(ork)f(our)h(w)n │ │ │ │ │ +(a)n(y)f(through)0 1546 y(the)28 b(program)e(to)h(illustrate)g(the)h │ │ │ │ │ +(use)g(of)f Ft(SPOOLES)h Fu(to)f(solv)n(e)g(a)g(system)g(of)h(linear)f │ │ │ │ │ +(equations.)0 1800 y Fh(5.1)112 b(Reading)39 b(the)e(input)h │ │ │ │ │ +(parameters)0 1976 y Fu(The)31 b(input)h(parameters)d(are)h(iden)n │ │ │ │ │ +(tical)h(to)g(those)g(of)g(the)g(serial)f Fq(LU)39 b │ │ │ │ │ +Fu(driv)n(er)30 b(program)f(describ)r(ed)i(in)g(Section)g(2.1)g(with)0 │ │ │ │ │ 2076 y(the)d(exception)f(that)h(the)g Fp(symmetryflag)23 │ │ │ │ │ b Fu(is)k(not)h(presen)n(t.)0 2330 y Fh(5.2)112 b(Comm)m(unicating)39 │ │ │ │ │ b(the)f(data)g(for)f(the)h(problem)0 2506 y Fu(This)28 │ │ │ │ │ b(step)f(is)h(iden)n(tical)f(to)h(the)g(serial)e(co)r(de,)i(as)f │ │ │ │ │ (describ)r(ed)g(in)h(Section)f(2.2)0 2760 y Fh(5.3)112 │ │ │ │ │ b(Reordering)38 b(the)f(linear)h(system)0 2937 y Fu(F)-7 │ │ │ │ │ b(or)30 b(the)h Fq(LU)39 b Fu(factorization)30 b(of)g │ │ │ │ │ @@ -10221,44 +10191,44 @@ │ │ │ │ │ (ETr)o(ee)o(\))38 b(;)0 5208 y(newToOld)127 b(=)44 b(IV_entries\(newT)o │ │ │ │ │ (oOl)o(dI)o(V\))37 b(;)0 5308 y(InpMtx_permute\(m)o(txA)o(,)g(NULL,)42 │ │ │ │ │ b(oldToNew\)\))d(;)0 5407 y(InpMtx_changeSto)o(rag)o(eM)o(od)o(e\(m)o │ │ │ │ │ (tx)o(A,)e(INPMTX_BY_VECTORS)o(\))g(;)p eop end │ │ │ │ │ %%Page: 22 22 │ │ │ │ │ TeXDict begin 22 21 bop 0 100 a Fu(22)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fu(The)j Fp(oldToNewIV)25 b Fu(and)k Fp(newToOldIV)d │ │ │ │ │ -Fu(v)-5 b(ariables)28 b(are)g Fp(IV)h Fu(ob)5 b(jects)29 │ │ │ │ │ -b(that)h(represen)n(t)e(an)h(in)n(teger)g(v)n(ector.)41 │ │ │ │ │ -b(The)29 b Fp(oldToNew)0 490 y Fu(and)21 b Fp(newToOld)e │ │ │ │ │ -Fu(v)-5 b(ariables)20 b(are)g(p)r(oin)n(ters)h(to)g Fp(int)p │ │ │ │ │ -Fu(,)h(whic)n(h)f(p)r(oin)n(t)h(to)f(the)h(base)f(address)f(of)h(the)h │ │ │ │ │ -Fp(int)f Fu(v)n(ector)f(in)h(an)h Fp(IV)e Fu(ob)5 b(ject.)0 │ │ │ │ │ -589 y(Once)38 b(w)n(e)g(ha)n(v)n(e)f(the)h(p)r(erm)n(utation)g(v)n │ │ │ │ │ -(ector,)i(w)n(e)e(apply)g(it)g(to)g(the)h(fron)n(t)f(tree,)i(b)n(y)e │ │ │ │ │ -(the)h Fp(ETree)p 3135 589 27 4 v 29 w(permuteVertices\()o(\))0 │ │ │ │ │ -689 y Fu(metho)r(d.)55 b(W)-7 b(e)34 b(need)f Fq(AP)827 │ │ │ │ │ -659 y Fl(T)880 689 y Fu(,)h(so)f(w)n(e)g(p)r(erm)n(ute)h(the)g │ │ │ │ │ -Fp(InpMtx)d Fu(ob)5 b(ject)33 b(using)g(a)g Fp(NULL)f │ │ │ │ │ -Fu(p)r(oin)n(ter)h(for)f(the)i(ro)n(w)e(p)r(erm)n(utation)0 │ │ │ │ │ -789 y(\(whic)n(h)25 b(means)f(do)g(not)g(p)r(erm)n(ute)h(the)g(ro)n │ │ │ │ │ -(ws\))e(and)h(the)h Fp(oldToNew)c Fu(v)n(ector)j(for)g(the)g(column)h │ │ │ │ │ -(p)r(erm)n(utation.)35 b(A)n(t)25 b(this)g(p)r(oin)n(t)0 │ │ │ │ │ -888 y(the)j Fp(InpMtx)d Fu(ob)5 b(ject)28 b(holds)f Fq(AP)1028 │ │ │ │ │ -858 y Fl(T)1108 888 y Fu(in)h(the)g(form)f(required)g(b)n(y)g(the)h │ │ │ │ │ -(factorization.)125 1013 y(The)38 b(\014nal)h(steps)f(are)g(to)g │ │ │ │ │ -(compute)h(the)g(sym)n(b)r(olic)f(factorization,)i(whic)n(h)e(is)h │ │ │ │ │ -(stored)e(in)i(an)f Fp(IVL)g Fu(ob)5 b(ject,)41 b(and)d(to)0 │ │ │ │ │ -1112 y(p)r(erm)n(ute)28 b(the)g(v)n(ertices)e(in)i(the)g(fron)n(t)f │ │ │ │ │ -(tree.)37 b(The)27 b(sym)n(b)r(olic)g(factorization)g(di\013ers)g │ │ │ │ │ -(sligh)n(tly)g(from)g(the)h Fq(LU)36 b Fu(case.)0 1302 │ │ │ │ │ -y Fp(symbfacIVL)j(=)44 b(SymbFac_initFro)o(mGr)o(ap)o(h\(f)o(ro)o(nt)o │ │ │ │ │ -(ETr)o(ee)o(,)38 b(graph\))j(;)0 1401 y(IVL_overwrite\(sy)o(mbf)o(ac)o │ │ │ │ │ -(IV)o(L,)c(oldToNewIV\))i(;)0 1501 y(IVL_sortUp\(symbf)o(acI)o(VL)o(\)) │ │ │ │ │ -e(;)0 1600 y(ETree_permuteVer)o(tic)o(es)o(\(f)o(ron)o(tE)o(Tre)o(e,)g │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fu(The)j │ │ │ │ │ +Fp(oldToNewIV)25 b Fu(and)k Fp(newToOldIV)d Fu(v)-5 b(ariables)28 │ │ │ │ │ +b(are)g Fp(IV)h Fu(ob)5 b(jects)29 b(that)h(represen)n(t)e(an)h(in)n │ │ │ │ │ +(teger)g(v)n(ector.)41 b(The)29 b Fp(oldToNew)0 490 y │ │ │ │ │ +Fu(and)21 b Fp(newToOld)e Fu(v)-5 b(ariables)20 b(are)g(p)r(oin)n(ters) │ │ │ │ │ +h(to)g Fp(int)p Fu(,)h(whic)n(h)f(p)r(oin)n(t)h(to)f(the)h(base)f │ │ │ │ │ +(address)f(of)h(the)h Fp(int)f Fu(v)n(ector)f(in)h(an)h │ │ │ │ │ +Fp(IV)e Fu(ob)5 b(ject.)0 589 y(Once)38 b(w)n(e)g(ha)n(v)n(e)f(the)h(p) │ │ │ │ │ +r(erm)n(utation)g(v)n(ector,)i(w)n(e)e(apply)g(it)g(to)g(the)h(fron)n │ │ │ │ │ +(t)f(tree,)i(b)n(y)e(the)h Fp(ETree)p 3135 589 27 4 v │ │ │ │ │ +29 w(permuteVertices\()o(\))0 689 y Fu(metho)r(d.)55 │ │ │ │ │ +b(W)-7 b(e)34 b(need)f Fq(AP)827 659 y Fl(T)880 689 y │ │ │ │ │ +Fu(,)h(so)f(w)n(e)g(p)r(erm)n(ute)h(the)g Fp(InpMtx)d │ │ │ │ │ +Fu(ob)5 b(ject)33 b(using)g(a)g Fp(NULL)f Fu(p)r(oin)n(ter)h(for)f(the) │ │ │ │ │ +i(ro)n(w)e(p)r(erm)n(utation)0 789 y(\(whic)n(h)25 b(means)f(do)g(not)g │ │ │ │ │ +(p)r(erm)n(ute)h(the)g(ro)n(ws\))e(and)h(the)h Fp(oldToNew)c │ │ │ │ │ +Fu(v)n(ector)j(for)g(the)g(column)h(p)r(erm)n(utation.)35 │ │ │ │ │ +b(A)n(t)25 b(this)g(p)r(oin)n(t)0 888 y(the)j Fp(InpMtx)d │ │ │ │ │ +Fu(ob)5 b(ject)28 b(holds)f Fq(AP)1028 858 y Fl(T)1108 │ │ │ │ │ +888 y Fu(in)h(the)g(form)f(required)g(b)n(y)g(the)h(factorization.)125 │ │ │ │ │ +1013 y(The)38 b(\014nal)h(steps)f(are)g(to)g(compute)h(the)g(sym)n(b)r │ │ │ │ │ +(olic)f(factorization,)i(whic)n(h)e(is)h(stored)e(in)i(an)f │ │ │ │ │ +Fp(IVL)g Fu(ob)5 b(ject,)41 b(and)d(to)0 1112 y(p)r(erm)n(ute)28 │ │ │ │ │ +b(the)g(v)n(ertices)e(in)i(the)g(fron)n(t)f(tree.)37 │ │ │ │ │ +b(The)27 b(sym)n(b)r(olic)g(factorization)g(di\013ers)g(sligh)n(tly)g │ │ │ │ │ +(from)g(the)h Fq(LU)36 b Fu(case.)0 1302 y Fp(symbfacIVL)j(=)44 │ │ │ │ │ +b(SymbFac_initFro)o(mGr)o(ap)o(h\(f)o(ro)o(nt)o(ETr)o(ee)o(,)38 │ │ │ │ │ +b(graph\))j(;)0 1401 y(IVL_overwrite\(sy)o(mbf)o(ac)o(IV)o(L,)c │ │ │ │ │ +(oldToNewIV\))i(;)0 1501 y(IVL_sortUp\(symbf)o(acI)o(VL)o(\))e(;)0 │ │ │ │ │ +1600 y(ETree_permuteVer)o(tic)o(es)o(\(f)o(ron)o(tE)o(Tre)o(e,)g │ │ │ │ │ (oldToNewIV\))i(;)0 1790 y Fu(W)-7 b(e)29 b(do)g(not)f(ha)n(v)n(e)g │ │ │ │ │ (the)h Fq(A)808 1760 y Fl(T)861 1790 y Fq(A)g Fu(matrix)f(ob)5 │ │ │ │ │ b(ject,)29 b(so)f(w)n(e)g(constuct)h(the)g(sym)n(b)r(olic)g │ │ │ │ │ (factorization)e(using)h(the)h(fron)n(t)g(tree)f(and)0 │ │ │ │ │ 1889 y(the)34 b Fp(Graph)d Fu(ob)5 b(ject.)55 b(Note,)35 │ │ │ │ │ b(at)e(this)h(p)r(oin)n(t)g(in)f(time,)j(b)r(oth)e(the)g(graph)e(and)i │ │ │ │ │ (fron)n(t)f(tree)g(are)f(in)i(terms)f(of)h(the)g(original)0 │ │ │ │ │ @@ -10300,192 +10270,191 @@ │ │ │ │ │ b(;)0 5009 y(ChvManager_init\()o(chv)o(ma)o(na)o(ger)o(,)f(NO_LOCK,)k │ │ │ │ │ (1\))h(;)0 5108 y(DVzero\(10,)d(cpus\))j(;)0 5208 y(facops)f(=)i(0.0)g │ │ │ │ │ (;)0 5308 y(FrontMtx_QR_fact)o(or\()o(fr)o(on)o(tmt)o(x,)37 │ │ │ │ │ b(mtxA,)42 b(chvmanager,)d(cpus,)i(&facops,)f(msglvl,)h(msgFile\))f(;)0 │ │ │ │ │ 5407 y(ChvManager_free\()o(chv)o(ma)o(na)o(ger)o(\))d(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 23 23 │ │ │ │ │ -TeXDict begin 23 22 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(23)0 390 │ │ │ │ │ -y(W)-7 b(orking)38 b(storage)g(used)h(during)g(the)g(factorization)f │ │ │ │ │ -(is)i(found)f(in)h(the)f(form)g(of)h(blo)r(c)n(k)e Fk(chevr)l(ons)p │ │ │ │ │ -Fu(,)44 b(in)39 b(a)g Fp(Chv)f Fu(ob)5 b(ject,)0 490 │ │ │ │ │ -y(whic)n(h)34 b(hold)g(the)h(partial)e(fron)n(tal)g(matrix)h(for)g(a)f │ │ │ │ │ -(fron)n(t.)57 b(Muc)n(h)34 b(as)f(with)i(the)f Fp(SubMtx)e │ │ │ │ │ -Fu(ob)5 b(ject,)36 b(the)e Fp(FrontMtx)d Fu(ob)5 b(ject)0 │ │ │ │ │ -589 y(do)r(es)28 b(not)g(concern)f(itself)i(with)f(managing)f(w)n │ │ │ │ │ -(orking)f(storage,)h(instead)h(it)g(relies)g(on)g(a)f │ │ │ │ │ -Fp(ChvManager)d Fu(ob)5 b(ject)28 b(to)g(manage)0 689 │ │ │ │ │ -y(the)i Fp(Chv)f Fu(ob)5 b(jects.)43 b(On)30 b(return)f │ │ │ │ │ -Fp(facops)f Fu(con)n(tains)h(the)h(n)n(um)n(b)r(er)f(of)h(\015oating)f │ │ │ │ │ -(p)r(oin)n(t)h(op)r(erations)f(p)r(erformed)g(during)h(the)0 │ │ │ │ │ -789 y(factorization.)125 910 y(The)i(factorization)f(is)h(p)r(erformed) │ │ │ │ │ -f(using)h(a)g(one-dimensional)f(decomp)r(osition)g(of)h(the)h(factor)e │ │ │ │ │ -(matrices.)50 b(Keeping)0 1010 y(the)34 b(factor)f(matrices)f(in)i │ │ │ │ │ -(this)g(form)f(sev)n(erely)f(limits)i(the)g(amoun)n(t)f(of)g │ │ │ │ │ -(parallelism)f(for)h(the)h(forw)n(ard)e(and)h(bac)n(ksolv)n(es.)0 │ │ │ │ │ -1110 y(W)-7 b(e)29 b(p)r(erform)f(a)f(p)r(ost-pro)r(cessing)g(step)h │ │ │ │ │ -(to)g(con)n(v)n(ert)f(the)i(one-dimensional)e(data)h(structures)f(to)i │ │ │ │ │ -(submatrices)e(of)h(a)g(t)n(w)n(o-)0 1209 y(dimensional)19 │ │ │ │ │ -b(blo)r(c)n(k)g(decomp)r(osition)f(of)h(the)h(factor)f(matrices.)33 │ │ │ │ │ -b(The)19 b(follo)n(wing)f(co)r(de)i(fragmen)n(t)e(p)r(erforms)h(this)g │ │ │ │ │ -(op)r(eration.)0 1387 y Fp(FrontMtx_postPro)o(ces)o(s\()o(fr)o(ont)o │ │ │ │ │ -(mt)o(x,)37 b(msglvl,)k(msgFile\))f(;)0 1639 y Fh(5.6)112 │ │ │ │ │ -b(Solving)39 b(the)e(linear)h(system)0 1823 y Fu(The)28 │ │ │ │ │ -b(follo)n(wing)e(co)r(de)i(fragmen)n(t)e(solv)n(es)h(the)h(linear)e │ │ │ │ │ -(system)i Fq(R)2013 1793 y Fl(T)2065 1823 y Fq(R)2150 │ │ │ │ │ -1802 y Fn(b)2129 1823 y Fq(X)h Fu(=)2334 1802 y Fn(b)2314 │ │ │ │ │ -1823 y Fq(A)2376 1793 y Fl(T)2429 1823 y Fq(Y)46 b Fu(if)28 │ │ │ │ │ -b(real)f(or)g Fq(R)2927 1793 y Fl(H)2989 1823 y Fq(R)3075 │ │ │ │ │ -1802 y Fn(b)3053 1823 y Fq(X)i Fu(=)3259 1802 y Fn(b)3239 │ │ │ │ │ -1823 y Fq(A)3301 1793 y Fl(H)3364 1823 y Fq(Y)47 b Fu(if)28 │ │ │ │ │ -b(complex.)0 2000 y Fp(mtxX)42 b(=)h(DenseMtx_new\(\))38 │ │ │ │ │ -b(;)0 2100 y(DenseMtx_init\(mt)o(xX,)f(type,)k(0,)i(0,)g(neqns,)e │ │ │ │ │ -(nrhs,)g(1,)i(neqns\))e(;)0 2200 y(FrontMtx_QR_solv)o(e\(f)o(ro)o(nt)o │ │ │ │ │ -(mtx)o(,)c(mtxA,)42 b(mtxX,)f(mtxB,)h(mtxmanager,)785 │ │ │ │ │ -2299 y(cpus,)f(msglvl,)g(msgFile\))f(;)0 2476 y Fu(Last,)27 │ │ │ │ │ -b(w)n(e)g(p)r(erm)n(ute)h(the)g(ro)n(ws)e(of)i Fp(widehatX)c │ │ │ │ │ -Fu(bac)n(k)j(in)n(to)g Fq(X)7 b Fu(.)0 2654 y Fp(DenseMtx_permute)o │ │ │ │ │ -(Row)o(s\()o(mt)o(xX,)37 b(newToOldIV\))i(;)0 2906 y │ │ │ │ │ -Fh(5.7)112 b(Sample)39 b(Matrix)f(and)h(Righ)m(t)d(Hand)i(Side)h(Files) │ │ │ │ │ -0 3081 y Fu(Immediately)26 b(b)r(elo)n(w)g(are)e(t)n(w)n(o)i(sample)f │ │ │ │ │ -(\014les:)36 b Fp(qr.matrix.input)20 b Fu(holds)25 b(the)i(matrix)e │ │ │ │ │ -(input)i(and)e Fp(qr.rhs.input)c Fu(holds)0 3181 y(the)28 │ │ │ │ │ -b(righ)n(t)e(hand)i(side.)37 b(This)27 b(simple)h(example)f(is)g(an)g │ │ │ │ │ -(8)18 b Fb(\002)f Fu(6)27 b(matrix)g Fq(A)h Fu(and)f(a)g(single)g(righ) │ │ │ │ │ -n(t)g(hand)g(side.)37 b(The)27 b(solution)g(is)0 3280 │ │ │ │ │ -y(the)h(v)n(ector)e(of)i(all)f(ones.)36 b(Note)28 b(ho)n(w)f(the)h │ │ │ │ │ -(indices)g(are)e(zero-based)g(as)h(for)g(C,)g(instead)h(of)f(one-based) │ │ │ │ │ -g(as)g(for)g(F)-7 b(ortran.)1346 3452 y Fp(matrix.input)p │ │ │ │ │ -1296 3485 623 4 v 1294 5348 4 1864 v 1346 3555 a(8)43 │ │ │ │ │ -b(6)g(18)1346 3655 y(0)g(1)g(1.0)1346 3754 y(0)g(3)g(2.0)1346 │ │ │ │ │ -3854 y(1)g(2)g(3.0)1346 3954 y(1)g(3)g(1.0)1346 4053 │ │ │ │ │ -y(1)g(5)g(1.0)1346 4153 y(2)g(0)g(1.0)1346 4253 y(2)g(2)g(2.0)1346 │ │ │ │ │ -4352 y(3)g(0)g(3.0)1346 4452 y(3)g(2)g(4.0)1346 4551 │ │ │ │ │ -y(3)g(4)g(2.0)1346 4651 y(4)g(3)g(1.0)1346 4751 y(5)g(1)g(2.0)1346 │ │ │ │ │ -4850 y(5)g(4)g(3.0)1346 4950 y(5)g(5)g(1.0)1346 5050 │ │ │ │ │ -y(6)g(0)g(2.0)1346 5149 y(6)g(3)g(3.0)1346 5249 y(7)g(1)g(1.0)1346 │ │ │ │ │ -5348 y(7)g(4)g(3.0)p 1917 5348 V 1296 5352 623 4 v 2162 │ │ │ │ │ -3950 a(rhs.input)p 2112 3984 492 4 v 2111 4850 4 867 │ │ │ │ │ -v 2162 4053 a(8)g(1)2162 4153 y(0)g(3.0)2162 4253 y(1)g(5.0)2162 │ │ │ │ │ +TeXDict begin 23 22 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(23)0 390 y(W)-7 b(orking)38 │ │ │ │ │ +b(storage)g(used)h(during)g(the)g(factorization)f(is)i(found)f(in)h │ │ │ │ │ +(the)f(form)g(of)h(blo)r(c)n(k)e Fk(chevr)l(ons)p Fu(,)44 │ │ │ │ │ +b(in)39 b(a)g Fp(Chv)f Fu(ob)5 b(ject,)0 490 y(whic)n(h)34 │ │ │ │ │ +b(hold)g(the)h(partial)e(fron)n(tal)g(matrix)h(for)g(a)f(fron)n(t.)57 │ │ │ │ │ +b(Muc)n(h)34 b(as)f(with)i(the)f Fp(SubMtx)e Fu(ob)5 │ │ │ │ │ +b(ject,)36 b(the)e Fp(FrontMtx)d Fu(ob)5 b(ject)0 589 │ │ │ │ │ +y(do)r(es)28 b(not)g(concern)f(itself)i(with)f(managing)f(w)n(orking)f │ │ │ │ │ +(storage,)h(instead)h(it)g(relies)g(on)g(a)f Fp(ChvManager)d │ │ │ │ │ +Fu(ob)5 b(ject)28 b(to)g(manage)0 689 y(the)i Fp(Chv)f │ │ │ │ │ +Fu(ob)5 b(jects.)43 b(On)30 b(return)f Fp(facops)f Fu(con)n(tains)h │ │ │ │ │ +(the)h(n)n(um)n(b)r(er)f(of)h(\015oating)f(p)r(oin)n(t)h(op)r(erations) │ │ │ │ │ +f(p)r(erformed)g(during)h(the)0 789 y(factorization.)125 │ │ │ │ │ +910 y(The)i(factorization)f(is)h(p)r(erformed)f(using)h(a)g │ │ │ │ │ +(one-dimensional)f(decomp)r(osition)g(of)h(the)h(factor)e(matrices.)50 │ │ │ │ │ +b(Keeping)0 1010 y(the)34 b(factor)f(matrices)f(in)i(this)g(form)f(sev) │ │ │ │ │ +n(erely)f(limits)i(the)g(amoun)n(t)f(of)g(parallelism)f(for)h(the)h │ │ │ │ │ +(forw)n(ard)e(and)h(bac)n(ksolv)n(es.)0 1110 y(W)-7 b(e)29 │ │ │ │ │ +b(p)r(erform)f(a)f(p)r(ost-pro)r(cessing)g(step)h(to)g(con)n(v)n(ert)f │ │ │ │ │ +(the)i(one-dimensional)e(data)h(structures)f(to)i(submatrices)e(of)h(a) │ │ │ │ │ +g(t)n(w)n(o-)0 1209 y(dimensional)19 b(blo)r(c)n(k)g(decomp)r(osition)f │ │ │ │ │ +(of)h(the)h(factor)f(matrices.)33 b(The)19 b(follo)n(wing)f(co)r(de)i │ │ │ │ │ +(fragmen)n(t)e(p)r(erforms)h(this)g(op)r(eration.)0 1387 │ │ │ │ │ +y Fp(FrontMtx_postPro)o(ces)o(s\()o(fr)o(ont)o(mt)o(x,)37 │ │ │ │ │ +b(msglvl,)k(msgFile\))f(;)0 1639 y Fh(5.6)112 b(Solving)39 │ │ │ │ │ +b(the)e(linear)h(system)0 1823 y Fu(The)28 b(follo)n(wing)e(co)r(de)i │ │ │ │ │ +(fragmen)n(t)e(solv)n(es)h(the)h(linear)e(system)i Fq(R)2013 │ │ │ │ │ +1793 y Fl(T)2065 1823 y Fq(R)2150 1802 y Fn(b)2129 1823 │ │ │ │ │ +y Fq(X)h Fu(=)2334 1802 y Fn(b)2314 1823 y Fq(A)2376 │ │ │ │ │ +1793 y Fl(T)2429 1823 y Fq(Y)46 b Fu(if)28 b(real)f(or)g │ │ │ │ │ +Fq(R)2927 1793 y Fl(H)2989 1823 y Fq(R)3075 1802 y Fn(b)3053 │ │ │ │ │ +1823 y Fq(X)i Fu(=)3259 1802 y Fn(b)3239 1823 y Fq(A)3301 │ │ │ │ │ +1793 y Fl(H)3364 1823 y Fq(Y)47 b Fu(if)28 b(complex.)0 │ │ │ │ │ +2000 y Fp(mtxX)42 b(=)h(DenseMtx_new\(\))38 b(;)0 2100 │ │ │ │ │ +y(DenseMtx_init\(mt)o(xX,)f(type,)k(0,)i(0,)g(neqns,)e(nrhs,)g(1,)i │ │ │ │ │ +(neqns\))e(;)0 2200 y(FrontMtx_QR_solv)o(e\(f)o(ro)o(nt)o(mtx)o(,)c │ │ │ │ │ +(mtxA,)42 b(mtxX,)f(mtxB,)h(mtxmanager,)785 2299 y(cpus,)f(msglvl,)g │ │ │ │ │ +(msgFile\))f(;)0 2476 y Fu(Last,)27 b(w)n(e)g(p)r(erm)n(ute)h(the)g(ro) │ │ │ │ │ +n(ws)e(of)i Fp(widehatX)c Fu(bac)n(k)j(in)n(to)g Fq(X)7 │ │ │ │ │ +b Fu(.)0 2654 y Fp(DenseMtx_permute)o(Row)o(s\()o(mt)o(xX,)37 │ │ │ │ │ +b(newToOldIV\))i(;)0 2906 y Fh(5.7)112 b(Sample)39 b(Matrix)f(and)h │ │ │ │ │ +(Righ)m(t)d(Hand)i(Side)h(Files)0 3081 y Fu(Immediately)26 │ │ │ │ │ +b(b)r(elo)n(w)g(are)e(t)n(w)n(o)i(sample)f(\014les:)36 │ │ │ │ │ +b Fp(qr.matrix.input)20 b Fu(holds)25 b(the)i(matrix)e(input)i(and)e │ │ │ │ │ +Fp(qr.rhs.input)c Fu(holds)0 3181 y(the)28 b(righ)n(t)e(hand)i(side.)37 │ │ │ │ │ +b(This)27 b(simple)h(example)f(is)g(an)g(8)18 b Fb(\002)f │ │ │ │ │ +Fu(6)27 b(matrix)g Fq(A)h Fu(and)f(a)g(single)g(righ)n(t)g(hand)g │ │ │ │ │ +(side.)37 b(The)27 b(solution)g(is)0 3280 y(the)h(v)n(ector)e(of)i(all) │ │ │ │ │ +f(ones.)36 b(Note)28 b(ho)n(w)f(the)h(indices)g(are)e(zero-based)g(as)h │ │ │ │ │ +(for)g(C,)g(instead)h(of)f(one-based)g(as)g(for)g(F)-7 │ │ │ │ │ +b(ortran.)1346 3452 y Fp(matrix.input)p 1296 3485 623 │ │ │ │ │ +4 v 1294 5348 4 1864 v 1346 3555 a(8)43 b(6)g(18)1346 │ │ │ │ │ +3655 y(0)g(1)g(1.0)1346 3754 y(0)g(3)g(2.0)1346 3854 │ │ │ │ │ +y(1)g(2)g(3.0)1346 3954 y(1)g(3)g(1.0)1346 4053 y(1)g(5)g(1.0)1346 │ │ │ │ │ +4153 y(2)g(0)g(1.0)1346 4253 y(2)g(2)g(2.0)1346 4352 │ │ │ │ │ +y(3)g(0)g(3.0)1346 4452 y(3)g(2)g(4.0)1346 4551 y(3)g(4)g(2.0)1346 │ │ │ │ │ +4651 y(4)g(3)g(1.0)1346 4751 y(5)g(1)g(2.0)1346 4850 │ │ │ │ │ +y(5)g(4)g(3.0)1346 4950 y(5)g(5)g(1.0)1346 5050 y(6)g(0)g(2.0)1346 │ │ │ │ │ +5149 y(6)g(3)g(3.0)1346 5249 y(7)g(1)g(1.0)1346 5348 │ │ │ │ │ +y(7)g(4)g(3.0)p 1917 5348 V 1296 5352 623 4 v 2162 3950 │ │ │ │ │ +a(rhs.input)p 2112 3984 492 4 v 2111 4850 4 867 v 2162 │ │ │ │ │ +4053 a(8)g(1)2162 4153 y(0)g(3.0)2162 4253 y(1)g(5.0)2162 │ │ │ │ │ 4352 y(2)g(3.0)2162 4452 y(3)g(9.0)2162 4551 y(4)g(1.0)2162 │ │ │ │ │ 4651 y(5)g(6.0)2162 4751 y(6)g(5.0)2162 4850 y(7)g(4.0)p │ │ │ │ │ 2602 4850 V 2112 4854 492 4 v eop end │ │ │ │ │ %%Page: 24 24 │ │ │ │ │ TeXDict begin 24 23 bop 0 100 a Fu(24)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fr(A)134 b Fa(allInOne.c)40 b Fr({)45 b(A)g(Serial)h │ │ │ │ │ -Fj(LU)56 b Fr(Driv)l(er)46 b(Program)0 625 y Fp(/*)86 │ │ │ │ │ -b(allInOne.c)d(*/)0 824 y(#include)40 b("../../misc.h")0 │ │ │ │ │ -924 y(#include)g("../../FrontMtx.h)o(")0 1024 y(#include)g │ │ │ │ │ -("../../SymbFac.h")0 1223 y(/*--------------)o(---)o(--)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(---)o(--)o(--)o(-*/)0 1322 y(int)0 1422 y(main)i(\()h(int)f │ │ │ │ │ -(argc,)g(char)g(*argv[])f(\))i({)0 1522 y(/*)131 1621 │ │ │ │ │ -y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)131 │ │ │ │ │ -1721 y(all-in-one)c(program)i(to)i(solve)e(A)i(X)h(=)f(Y)131 │ │ │ │ │ -1920 y(\(1\))f(read)g(in)h(matrix)e(entries)g(for)h(A)h(and)f(form)g │ │ │ │ │ -(InpMtx)f(object)131 2020 y(\(2\))h(read)g(in)h(right)e(hand)h(side)g │ │ │ │ │ -(for)h(Y)g(entries)d(and)j(form)f(DenseMtx)e(object)131 │ │ │ │ │ -2120 y(\(3\))i(form)g(Graph)g(object,)e(order)i(matrix)f(and)h(form)g │ │ │ │ │ -(front)g(tree)131 2219 y(\(4\))g(get)g(the)h(permutation,)38 │ │ │ │ │ -b(permute)j(the)h(front)g(tree,)f(matrix)305 2319 y(and)h(right)g(hand) │ │ │ │ │ -g(side)g(and)g(get)h(the)f(symbolic)e(factorization)131 │ │ │ │ │ -2418 y(\(5\))i(initialize)e(the)i(front)f(matrix)h(object)f(to)h(hold)g │ │ │ │ │ -(the)h(factor)e(matrices)131 2518 y(\(6\))h(compute)f(the)h(numeric)f │ │ │ │ │ -(factorization)131 2618 y(\(7\))h(post-process)d(the)j(factor)f │ │ │ │ │ -(matrices)131 2717 y(\(8\))h(compute)f(the)h(solution)131 │ │ │ │ │ -2817 y(\(9\))g(permute)f(the)h(solution)e(into)i(the)h(original)d │ │ │ │ │ -(ordering)131 3016 y(created)g(--)j(98jun04,)d(cca)131 │ │ │ │ │ -3116 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)0 │ │ │ │ │ -3215 y(*/)0 3315 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(-*/)0 3415 y(char)521 b(*matrixFileName,)37 │ │ │ │ │ -b(*rhsFileName)i(;)0 3514 y(DenseMtx)345 b(*mtxY,)41 │ │ │ │ │ -b(*mtxX)h(;)0 3614 y(Chv)565 b(*rootchv)41 b(;)0 3714 │ │ │ │ │ -y(ChvManager)257 b(*chvmanager)83 b(;)0 3813 y(SubMtxManager)125 │ │ │ │ │ -b(*mtxmanager)83 b(;)0 3913 y(FrontMtx)345 b(*frontmtx)40 │ │ │ │ │ -b(;)0 4012 y(InpMtx)433 b(*mtxA)42 b(;)0 4112 y(double)433 │ │ │ │ │ -b(droptol)41 b(=)i(0.0,)f(tau)h(=)g(100.)f(;)0 4212 y(double)433 │ │ │ │ │ -b(cpus[10])41 b(;)0 4311 y(ETree)477 b(*frontETree)39 │ │ │ │ │ -b(;)0 4411 y(FILE)521 b(*inputFile,)39 b(*msgFile)i(;)0 │ │ │ │ │ -4511 y(Graph)477 b(*graph)41 b(;)0 4610 y(int)565 b(error,)41 │ │ │ │ │ -b(ient,)h(irow,)g(jcol,)f(jrhs,)h(jrow,)f(msglvl,)g(ncol,)697 │ │ │ │ │ -4710 y(nedges,)g(nent,)h(neqns,)f(nrhs,)g(nrow,)h(pivotingflag,)c │ │ │ │ │ -(seed,)697 4809 y(symmetryflag,)h(type)j(;)0 4909 y(int)565 │ │ │ │ │ -b(*newToOld,)40 b(*oldToNew)g(;)0 5009 y(int)565 b(stats[20])40 │ │ │ │ │ -b(;)0 5108 y(IV)609 b(*newToOldIV,)39 b(*oldToNewIV)g(;)0 │ │ │ │ │ -5208 y(IVL)565 b(*adjIVL,)41 b(*symbfacIVL)e(;)0 5308 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fr(A)134 │ │ │ │ │ +b Fa(allInOne.c)40 b Fr({)45 b(A)g(Serial)h Fj(LU)56 │ │ │ │ │ +b Fr(Driv)l(er)46 b(Program)0 625 y Fp(/*)86 b(allInOne.c)d(*/)0 │ │ │ │ │ +824 y(#include)40 b("../../misc.h")0 924 y(#include)g │ │ │ │ │ +("../../FrontMtx.h)o(")0 1024 y(#include)g("../../SymbFac.h")0 │ │ │ │ │ +1223 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(-*/)0 1322 y(int)0 1422 y(main)i(\()h(int)f(argc,)g(char)g │ │ │ │ │ +(*argv[])f(\))i({)0 1522 y(/*)131 1621 y(----------------)o(--)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(--)131 1721 y(all-in-one)c(program)i(to)i │ │ │ │ │ +(solve)e(A)i(X)h(=)f(Y)131 1920 y(\(1\))f(read)g(in)h(matrix)e(entries) │ │ │ │ │ +g(for)h(A)h(and)f(form)g(InpMtx)f(object)131 2020 y(\(2\))h(read)g(in)h │ │ │ │ │ +(right)e(hand)h(side)g(for)h(Y)g(entries)d(and)j(form)f(DenseMtx)e │ │ │ │ │ +(object)131 2120 y(\(3\))i(form)g(Graph)g(object,)e(order)i(matrix)f │ │ │ │ │ +(and)h(form)g(front)g(tree)131 2219 y(\(4\))g(get)g(the)h(permutation,) │ │ │ │ │ +38 b(permute)j(the)h(front)g(tree,)f(matrix)305 2319 │ │ │ │ │ +y(and)h(right)g(hand)g(side)g(and)g(get)h(the)f(symbolic)e │ │ │ │ │ +(factorization)131 2418 y(\(5\))i(initialize)e(the)i(front)f(matrix)h │ │ │ │ │ +(object)f(to)h(hold)g(the)h(factor)e(matrices)131 2518 │ │ │ │ │ +y(\(6\))h(compute)f(the)h(numeric)f(factorization)131 │ │ │ │ │ +2618 y(\(7\))h(post-process)d(the)j(factor)f(matrices)131 │ │ │ │ │ +2717 y(\(8\))h(compute)f(the)h(solution)131 2817 y(\(9\))g(permute)f │ │ │ │ │ +(the)h(solution)e(into)i(the)h(original)d(ordering)131 │ │ │ │ │ +3016 y(created)g(--)j(98jun04,)d(cca)131 3116 y(----------------)o(--)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(---)o(--)o(--)0 3215 y(*/)0 3315 │ │ │ │ │ y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(-*/)0 5407 y(/*)p eop end │ │ │ │ │ +(-*/)0 3415 y(char)521 b(*matrixFileName,)37 b(*rhsFileName)i(;)0 │ │ │ │ │ +3514 y(DenseMtx)345 b(*mtxY,)41 b(*mtxX)h(;)0 3614 y(Chv)565 │ │ │ │ │ +b(*rootchv)41 b(;)0 3714 y(ChvManager)257 b(*chvmanager)83 │ │ │ │ │ +b(;)0 3813 y(SubMtxManager)125 b(*mtxmanager)83 b(;)0 │ │ │ │ │ +3913 y(FrontMtx)345 b(*frontmtx)40 b(;)0 4012 y(InpMtx)433 │ │ │ │ │ +b(*mtxA)42 b(;)0 4112 y(double)433 b(droptol)41 b(=)i(0.0,)f(tau)h(=)g │ │ │ │ │ +(100.)f(;)0 4212 y(double)433 b(cpus[10])41 b(;)0 4311 │ │ │ │ │ +y(ETree)477 b(*frontETree)39 b(;)0 4411 y(FILE)521 b(*inputFile,)39 │ │ │ │ │ +b(*msgFile)i(;)0 4511 y(Graph)477 b(*graph)41 b(;)0 4610 │ │ │ │ │ +y(int)565 b(error,)41 b(ient,)h(irow,)g(jcol,)f(jrhs,)h(jrow,)f │ │ │ │ │ +(msglvl,)g(ncol,)697 4710 y(nedges,)g(nent,)h(neqns,)f(nrhs,)g(nrow,)h │ │ │ │ │ +(pivotingflag,)c(seed,)697 4809 y(symmetryflag,)h(type)j(;)0 │ │ │ │ │ +4909 y(int)565 b(*newToOld,)40 b(*oldToNew)g(;)0 5009 │ │ │ │ │ +y(int)565 b(stats[20])40 b(;)0 5108 y(IV)609 b(*newToOldIV,)39 │ │ │ │ │ +b(*oldToNewIV)g(;)0 5208 y(IVL)565 b(*adjIVL,)41 b(*symbfacIVL)e(;)0 │ │ │ │ │ +5308 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(-*/)0 5407 y(/*)p eop end │ │ │ │ │ %%Page: 25 25 │ │ │ │ │ -TeXDict begin 25 24 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(25)131 390 │ │ │ │ │ -y Fp(----------------)o(--)o(--)131 490 y(get)42 b(input)g(parameters) │ │ │ │ │ -131 589 y(----------------)o(--)o(--)0 689 y(*/)0 789 │ │ │ │ │ -y(if)h(\()g(argc)f(!=)h(9)g(\))g({)131 888 y(fprintf\(stdout,)37 │ │ │ │ │ -b("\\n")262 988 y("\\n)42 b(usage:)f(\045s)i(msglvl)e(msgFile)g(type)g │ │ │ │ │ -(symmetryflag)e(pivotingflag")262 1088 y("\\n)347 b(matrixFileName)38 │ │ │ │ │ -b(rhsFileName)h(seed")262 1187 y("\\n)173 b(msglvl)41 │ │ │ │ │ -b(--)h(message)f(level")262 1287 y("\\n)173 b(msgFile)40 │ │ │ │ │ -b(--)j(message)e(file")262 1386 y("\\n)173 b(type)f(--)43 │ │ │ │ │ -b(type)f(of)h(entries")262 1486 y("\\n)260 b(1)43 b(\(SPOOLES_REAL\)) │ │ │ │ │ -169 b(--)42 b(real)g(entries")262 1586 y("\\n)260 b(2)43 │ │ │ │ │ -b(\(SPOOLES_COMPLEX)o(\))38 b(--)k(complex)f(entries")262 │ │ │ │ │ -1685 y("\\n)173 b(symmetryflag)38 b(--)43 b(type)f(of)h(matrix")262 │ │ │ │ │ -1785 y("\\n)260 b(0)43 b(\(SPOOLES_SYMMETR)o(IC\))167 │ │ │ │ │ -b(--)43 b(symmetric)d(entries")262 1885 y("\\n)260 b(1)43 │ │ │ │ │ -b(\(SPOOLES_HERMITI)o(AN\))167 b(--)43 b(Hermitian)d(entries")262 │ │ │ │ │ -1984 y("\\n)260 b(2)43 b(\(SPOOLES_NONSYMM)o(ETR)o(IC)o(\))37 │ │ │ │ │ -b(--)43 b(nonsymmetric)c(entries")262 2084 y("\\n)173 │ │ │ │ │ -b(pivotingflag)38 b(--)43 b(type)f(of)h(pivoting")262 │ │ │ │ │ -2183 y("\\n)260 b(0)43 b(\(SPOOLES_NO_PIVO)o(TIN)o(G\))37 │ │ │ │ │ -b(--)43 b(no)f(pivoting)f(used")262 2283 y("\\n)260 b(1)43 │ │ │ │ │ -b(\(SPOOLES_PIVOTIN)o(G\))168 b(--)43 b(pivoting)d(used")262 │ │ │ │ │ -2383 y("\\n)173 b(matrixFileName)37 b(--)43 b(matrix)e(file)h(name,)g │ │ │ │ │ -(format")262 2482 y("\\n)303 b(nrow)42 b(ncol)g(nent")262 │ │ │ │ │ -2582 y("\\n)303 b(irow)42 b(jcol)g(entry")262 2682 y("\\n)347 │ │ │ │ │ -b(...")262 2781 y("\\n)g(note:)41 b(indices)g(are)i(zero)e(based")262 │ │ │ │ │ -2881 y("\\n)173 b(rhsFileName)39 b(--)j(right)g(hand)g(side)g(file)g │ │ │ │ │ -(name,)f(format")262 2980 y("\\n)303 b(nrow)42 b(nrhs)g(")262 │ │ │ │ │ -3080 y("\\n)303 b(...")262 3180 y("\\n)g(jrow)42 b(entry\(jrow,0\))d │ │ │ │ │ -(...)j(entry\(jrow,nrhs-)o(1\))o(")262 3279 y("\\n)303 │ │ │ │ │ -b(...")262 3379 y("\\n)173 b(seed)42 b(--)g(random)f(number)h(seed,)f │ │ │ │ │ -(used)h(for)g(ordering")262 3479 y("\\n",)f(argv[0]\))f(;)131 │ │ │ │ │ -3578 y(return\(0\))g(;)0 3678 y(})0 3778 y(msglvl)h(=)i │ │ │ │ │ -(atoi\(argv[1]\))38 b(;)0 3877 y(if)43 b(\()g(strcmp\(argv[2],)37 │ │ │ │ │ -b("stdout"\))j(==)j(0)g(\))g({)131 3977 y(msgFile)d(=)k(stdout)d(;)0 │ │ │ │ │ -4076 y(})i(else)f(if)h(\()g(\(msgFile)d(=)j(fopen\(argv[2],)38 │ │ │ │ │ -b("a"\)\))k(==)h(NULL)e(\))j({)131 4176 y(fprintf\(stderr,)37 │ │ │ │ │ -b("\\n)42 b(fatal)g(error)g(in)g(\045s")479 4276 y("\\n)h(unable)e(to)i │ │ │ │ │ -(open)f(file)g(\045s\\n",)479 4375 y(argv[0],)f(argv[2]\))f(;)131 │ │ │ │ │ -4475 y(return\(-1\))f(;)0 4575 y(})0 4674 y(type)478 │ │ │ │ │ -b(=)43 b(atoi\(argv[3]\))38 b(;)0 4774 y(symmetryflag)126 │ │ │ │ │ -b(=)43 b(atoi\(argv[4]\))38 b(;)0 4873 y(pivotingflag)126 │ │ │ │ │ -b(=)43 b(atoi\(argv[5]\))38 b(;)0 4973 y(matrixFileName)g(=)43 │ │ │ │ │ -b(argv[6])e(;)0 5073 y(rhsFileName)170 b(=)43 b(argv[7])e(;)0 │ │ │ │ │ -5172 y(seed)478 b(=)43 b(atoi\(argv[8]\))38 b(;)0 5272 │ │ │ │ │ -y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(-*/)0 5372 y(/*)p eop end │ │ │ │ │ +TeXDict begin 25 24 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(25)131 390 y Fp(----------------)o(--)o(--) │ │ │ │ │ +131 490 y(get)42 b(input)g(parameters)131 589 y(----------------)o(--)o │ │ │ │ │ +(--)0 689 y(*/)0 789 y(if)h(\()g(argc)f(!=)h(9)g(\))g({)131 │ │ │ │ │ +888 y(fprintf\(stdout,)37 b("\\n")262 988 y("\\n)42 b(usage:)f(\045s)i │ │ │ │ │ +(msglvl)e(msgFile)g(type)g(symmetryflag)e(pivotingflag")262 │ │ │ │ │ +1088 y("\\n)347 b(matrixFileName)38 b(rhsFileName)h(seed")262 │ │ │ │ │ +1187 y("\\n)173 b(msglvl)41 b(--)h(message)f(level")262 │ │ │ │ │ +1287 y("\\n)173 b(msgFile)40 b(--)j(message)e(file")262 │ │ │ │ │ +1386 y("\\n)173 b(type)f(--)43 b(type)f(of)h(entries")262 │ │ │ │ │ +1486 y("\\n)260 b(1)43 b(\(SPOOLES_REAL\))169 b(--)42 │ │ │ │ │ +b(real)g(entries")262 1586 y("\\n)260 b(2)43 b(\(SPOOLES_COMPLEX)o(\)) │ │ │ │ │ +38 b(--)k(complex)f(entries")262 1685 y("\\n)173 b(symmetryflag)38 │ │ │ │ │ +b(--)43 b(type)f(of)h(matrix")262 1785 y("\\n)260 b(0)43 │ │ │ │ │ +b(\(SPOOLES_SYMMETR)o(IC\))167 b(--)43 b(symmetric)d(entries")262 │ │ │ │ │ +1885 y("\\n)260 b(1)43 b(\(SPOOLES_HERMITI)o(AN\))167 │ │ │ │ │ +b(--)43 b(Hermitian)d(entries")262 1984 y("\\n)260 b(2)43 │ │ │ │ │ +b(\(SPOOLES_NONSYMM)o(ETR)o(IC)o(\))37 b(--)43 b(nonsymmetric)c │ │ │ │ │ +(entries")262 2084 y("\\n)173 b(pivotingflag)38 b(--)43 │ │ │ │ │ +b(type)f(of)h(pivoting")262 2183 y("\\n)260 b(0)43 b(\(SPOOLES_NO_PIVO) │ │ │ │ │ +o(TIN)o(G\))37 b(--)43 b(no)f(pivoting)f(used")262 2283 │ │ │ │ │ +y("\\n)260 b(1)43 b(\(SPOOLES_PIVOTIN)o(G\))168 b(--)43 │ │ │ │ │ +b(pivoting)d(used")262 2383 y("\\n)173 b(matrixFileName)37 │ │ │ │ │ +b(--)43 b(matrix)e(file)h(name,)g(format")262 2482 y("\\n)303 │ │ │ │ │ +b(nrow)42 b(ncol)g(nent")262 2582 y("\\n)303 b(irow)42 │ │ │ │ │ +b(jcol)g(entry")262 2682 y("\\n)347 b(...")262 2781 y("\\n)g(note:)41 │ │ │ │ │ +b(indices)g(are)i(zero)e(based")262 2881 y("\\n)173 b(rhsFileName)39 │ │ │ │ │ +b(--)j(right)g(hand)g(side)g(file)g(name,)f(format")262 │ │ │ │ │ +2980 y("\\n)303 b(nrow)42 b(nrhs)g(")262 3080 y("\\n)303 │ │ │ │ │ +b(...")262 3180 y("\\n)g(jrow)42 b(entry\(jrow,0\))d(...)j │ │ │ │ │ +(entry\(jrow,nrhs-)o(1\))o(")262 3279 y("\\n)303 b(...")262 │ │ │ │ │ +3379 y("\\n)173 b(seed)42 b(--)g(random)f(number)h(seed,)f(used)h(for)g │ │ │ │ │ +(ordering")262 3479 y("\\n",)f(argv[0]\))f(;)131 3578 │ │ │ │ │ +y(return\(0\))g(;)0 3678 y(})0 3778 y(msglvl)h(=)i(atoi\(argv[1]\))38 │ │ │ │ │ +b(;)0 3877 y(if)43 b(\()g(strcmp\(argv[2],)37 b("stdout"\))j(==)j(0)g │ │ │ │ │ +(\))g({)131 3977 y(msgFile)d(=)k(stdout)d(;)0 4076 y(})i(else)f(if)h │ │ │ │ │ +(\()g(\(msgFile)d(=)j(fopen\(argv[2],)38 b("a"\)\))k(==)h(NULL)e(\))j │ │ │ │ │ +({)131 4176 y(fprintf\(stderr,)37 b("\\n)42 b(fatal)g(error)g(in)g │ │ │ │ │ +(\045s")479 4276 y("\\n)h(unable)e(to)i(open)f(file)g(\045s\\n",)479 │ │ │ │ │ +4375 y(argv[0],)f(argv[2]\))f(;)131 4475 y(return\(-1\))f(;)0 │ │ │ │ │ +4575 y(})0 4674 y(type)478 b(=)43 b(atoi\(argv[3]\))38 │ │ │ │ │ +b(;)0 4774 y(symmetryflag)126 b(=)43 b(atoi\(argv[4]\))38 │ │ │ │ │ +b(;)0 4873 y(pivotingflag)126 b(=)43 b(atoi\(argv[5]\))38 │ │ │ │ │ +b(;)0 4973 y(matrixFileName)g(=)43 b(argv[6])e(;)0 5073 │ │ │ │ │ +y(rhsFileName)170 b(=)43 b(argv[7])e(;)0 5172 y(seed)478 │ │ │ │ │ +b(=)43 b(atoi\(argv[8]\))38 b(;)0 5272 y(/*--------------)o(---)o(--)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 5372 y(/*)p │ │ │ │ │ +eop end │ │ │ │ │ %%Page: 26 26 │ │ │ │ │ TeXDict begin 26 25 bop 0 100 a Fu(26)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)131 390 │ │ │ │ │ -y Fp(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(--)131 490 y(STEP)42 b(1:)g(read)g(the)h(entries)d(from)i │ │ │ │ │ -(the)h(input)e(file)479 589 y(and)i(create)e(the)h(InpMtx)f(object)131 │ │ │ │ │ -689 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--) │ │ │ │ │ -o(---)o(--)o(--)0 789 y(*/)0 888 y(inputFile)f(=)j(fopen\(matrixFile)o │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)131 390 y Fp(----------------)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(--)131 │ │ │ │ │ +490 y(STEP)42 b(1:)g(read)g(the)h(entries)d(from)i(the)h(input)e(file) │ │ │ │ │ +479 589 y(and)i(create)e(the)h(InpMtx)f(object)131 689 │ │ │ │ │ +y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ +(---)o(--)o(--)0 789 y(*/)0 888 y(inputFile)f(=)j(fopen\(matrixFile)o │ │ │ │ │ (Nam)o(e,)37 b("r"\))42 b(;)0 988 y(fscanf\(inputFile)o(,)c("\045d)k │ │ │ │ │ (\045d)h(\045d",)f(&nrow,)f(&ncol,)g(&nent\))g(;)0 1088 │ │ │ │ │ y(neqns)h(=)h(nrow)f(;)0 1187 y(mtxA)g(=)h(InpMtx_new\(\))c(;)0 │ │ │ │ │ 1287 y(InpMtx_init\(mtxA)o(,)f(INPMTX_BY_ROWS,)f(type,)k(nent,)h │ │ │ │ │ (neqns\))f(;)0 1386 y(if)i(\()g(type)f(==)h(SPOOLES_REAL)38 │ │ │ │ │ b(\))43 b({)131 1486 y(double)128 b(value)42 b(;)131 │ │ │ │ │ 1586 y(for)g(\()h(ient)f(=)h(0)h(;)f(ient)f(<)h(nent)f(;)h(ient++)e(\)) │ │ │ │ │ @@ -10521,33 +10490,33 @@ │ │ │ │ │ 4774 y(fscanf\(inputFil)o(e,)37 b("\045d",)42 b(&jrow\))f(;)262 │ │ │ │ │ 4873 y(for)h(\()h(jrhs)f(=)h(0)g(;)g(jrhs)f(<)i(nrhs)e(;)h(jrhs++)e(\)) │ │ │ │ │ i({)392 4973 y(fscanf\(inputFile,)37 b("\045le",)k(&value\))g(;)392 │ │ │ │ │ 5073 y(DenseMtx_setRealE)o(nt)o(ry\()o(mt)o(xY,)c(jrow,)k(jrhs,)h │ │ │ │ │ (value\))f(;)262 5172 y(})131 5272 y(})0 5372 y(})i(else)f({)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 27 27 │ │ │ │ │ -TeXDict begin 27 26 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(27)131 390 │ │ │ │ │ -y Fp(double)128 b(imag,)42 b(real)f(;)131 490 y(for)h(\()h(irow)f(=)h │ │ │ │ │ -(0)h(;)f(irow)f(<)h(nrow)f(;)h(irow++)e(\))i({)262 589 │ │ │ │ │ -y(fscanf\(inputFil)o(e,)37 b("\045d",)42 b(&jrow\))f(;)262 │ │ │ │ │ -689 y(for)h(\()h(jrhs)f(=)h(0)g(;)g(jrhs)f(<)i(nrhs)e(;)h(jrhs++)e(\))i │ │ │ │ │ -({)392 789 y(fscanf\(inputFile,)37 b("\045le)42 b(\045le",)f(&real,)g │ │ │ │ │ -(&imag\))g(;)392 888 y(DenseMtx_setCompl)o(ex)o(Ent)o(ry)o(\(mt)o(xY)o │ │ │ │ │ -(,)c(jrow,)42 b(jrhs,)f(real,)h(imag\))g(;)262 988 y(})131 │ │ │ │ │ -1088 y(})0 1187 y(})0 1287 y(fclose\(inputFile)o(\))c(;)0 │ │ │ │ │ -1386 y(if)43 b(\()g(msglvl)e(>)i(2)g(\))h({)131 1486 │ │ │ │ │ -y(fprintf\(msgFile,)37 b("\\n\\n)k(rhs)i(matrix)e(in)h(original)f │ │ │ │ │ -(ordering"\))e(;)131 1586 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o │ │ │ │ │ -(\(mt)o(xY)o(,)f(msgFile\))i(;)131 1685 y(fflush\(msgFile\))d(;)0 │ │ │ │ │ -1785 y(})0 1885 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(-*/)0 1984 y(/*)131 2084 y(----------------)o(--)o(--) │ │ │ │ │ -o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)131 │ │ │ │ │ +TeXDict begin 27 26 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(27)131 390 y Fp(double)128 │ │ │ │ │ +b(imag,)42 b(real)f(;)131 490 y(for)h(\()h(irow)f(=)h(0)h(;)f(irow)f(<) │ │ │ │ │ +h(nrow)f(;)h(irow++)e(\))i({)262 589 y(fscanf\(inputFil)o(e,)37 │ │ │ │ │ +b("\045d",)42 b(&jrow\))f(;)262 689 y(for)h(\()h(jrhs)f(=)h(0)g(;)g │ │ │ │ │ +(jrhs)f(<)i(nrhs)e(;)h(jrhs++)e(\))i({)392 789 y(fscanf\(inputFile,)37 │ │ │ │ │ +b("\045le)42 b(\045le",)f(&real,)g(&imag\))g(;)392 888 │ │ │ │ │ +y(DenseMtx_setCompl)o(ex)o(Ent)o(ry)o(\(mt)o(xY)o(,)c(jrow,)42 │ │ │ │ │ +b(jrhs,)f(real,)h(imag\))g(;)262 988 y(})131 1088 y(})0 │ │ │ │ │ +1187 y(})0 1287 y(fclose\(inputFile)o(\))c(;)0 1386 y(if)43 │ │ │ │ │ +b(\()g(msglvl)e(>)i(2)g(\))h({)131 1486 y(fprintf\(msgFile,)37 │ │ │ │ │ +b("\\n\\n)k(rhs)i(matrix)e(in)h(original)f(ordering"\))e(;)131 │ │ │ │ │ +1586 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(mt)o(xY)o(,)f │ │ │ │ │ +(msgFile\))i(;)131 1685 y(fflush\(msgFile\))d(;)0 1785 │ │ │ │ │ +y(})0 1885 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(-*/)0 1984 y(/*)131 2084 y(----------------)o(--)o(--)o(---) │ │ │ │ │ +o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)131 │ │ │ │ │ 2183 y(STEP)42 b(3)h(:)g(find)f(a)h(low-fill)d(ordering)131 │ │ │ │ │ 2283 y(\(1\))i(create)f(the)i(Graph)e(object)131 2383 │ │ │ │ │ y(\(2\))h(order)g(the)g(graph)f(using)h(multiple)e(minimum)h(degree)131 │ │ │ │ │ 2482 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)0 2582 y(*/)0 2682 y(graph)h(=)h │ │ │ │ │ (Graph_new\(\))c(;)0 2781 y(adjIVL)i(=)i(InpMtx_fullAdjace)o(nc)o(y\(m) │ │ │ │ │ o(tx)o(A\))37 b(;)0 2881 y(nedges)k(=)i(IVL_tsize\(adjIVL\))37 │ │ │ │ │ @@ -10576,25 +10545,24 @@ │ │ │ │ │ (oNe)o(wI)o(V\))37 b(;)0 5272 y(newToOldIV)i(=)44 b(ETree_newToOldV)o │ │ │ │ │ (txP)o(er)o(m\(f)o(ro)o(nt)o(ETr)o(ee)o(\))38 b(;)0 5372 │ │ │ │ │ y(newToOld)127 b(=)44 b(IV_entries\(newT)o(oOl)o(dI)o(V\))37 │ │ │ │ │ b(;)p eop end │ │ │ │ │ %%Page: 28 28 │ │ │ │ │ TeXDict begin 28 27 bop 0 100 a Fu(28)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fp(ETree_permuteVer)o(tic)o(es)o(\(f)o(ron)o(tE)o(Tre)o(e,)37 │ │ │ │ │ -b(oldToNewIV\))i(;)0 490 y(InpMtx_permute\(m)o(txA)o(,)e(oldToNew,)j │ │ │ │ │ -(oldToNew\))g(;)0 589 y(if)j(\()87 b(symmetryflag)38 │ │ │ │ │ -b(==)43 b(SPOOLES_SYMMETRI)o(C)131 689 y(||)g(symmetryflag)38 │ │ │ │ │ -b(==)43 b(SPOOLES_HERMITIA)o(N)37 b(\))44 b({)131 789 │ │ │ │ │ -y(InpMtx_mapToUppe)o(rT)o(ri)o(ang)o(le)o(\(mt)o(xA)o(\))38 │ │ │ │ │ -b(;)0 888 y(})0 988 y(InpMtx_changeCoo)o(rdT)o(yp)o(e\()o(mtx)o(A,)f │ │ │ │ │ -(INPMTX_BY_CHEVRO)o(NS\))g(;)0 1088 y(InpMtx_changeSto)o(rag)o(eM)o(od) │ │ │ │ │ -o(e\(m)o(tx)o(A,)g(INPMTX_BY_VECTORS)o(\))g(;)0 1187 │ │ │ │ │ -y(DenseMtx_permute)o(Row)o(s\()o(mt)o(xY,)g(oldToNewIV\))i(;)0 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fp(ETree_permuteVer)o │ │ │ │ │ +(tic)o(es)o(\(f)o(ron)o(tE)o(Tre)o(e,)37 b(oldToNewIV\))i(;)0 │ │ │ │ │ +490 y(InpMtx_permute\(m)o(txA)o(,)e(oldToNew,)j(oldToNew\))g(;)0 │ │ │ │ │ +589 y(if)j(\()87 b(symmetryflag)38 b(==)43 b(SPOOLES_SYMMETRI)o(C)131 │ │ │ │ │ +689 y(||)g(symmetryflag)38 b(==)43 b(SPOOLES_HERMITIA)o(N)37 │ │ │ │ │ +b(\))44 b({)131 789 y(InpMtx_mapToUppe)o(rT)o(ri)o(ang)o(le)o(\(mt)o │ │ │ │ │ +(xA)o(\))38 b(;)0 888 y(})0 988 y(InpMtx_changeCoo)o(rdT)o(yp)o(e\()o │ │ │ │ │ +(mtx)o(A,)f(INPMTX_BY_CHEVRO)o(NS\))g(;)0 1088 y(InpMtx_changeSto)o │ │ │ │ │ +(rag)o(eM)o(od)o(e\(m)o(tx)o(A,)g(INPMTX_BY_VECTORS)o(\))g(;)0 │ │ │ │ │ +1187 y(DenseMtx_permute)o(Row)o(s\()o(mt)o(xY,)g(oldToNewIV\))i(;)0 │ │ │ │ │ 1287 y(symbfacIVL)g(=)44 b(SymbFac_initFro)o(mIn)o(pM)o(tx\()o(fr)o(on) │ │ │ │ │ o(tET)o(re)o(e,)37 b(mtxA\))42 b(;)0 1386 y(if)h(\()g(msglvl)e(>)i(2)g │ │ │ │ │ (\))h({)131 1486 y(fprintf\(msgFile,)37 b("\\n\\n)k(old-to-new)f │ │ │ │ │ (permutation)f(vector"\))h(;)131 1586 y(IV_writeForHuman)o(Ey)o(e\()o │ │ │ │ │ (old)o(To)o(New)o(IV)o(,)e(msgFile\))i(;)131 1685 y(fprintf\(msgFile,)d │ │ │ │ │ ("\\n\\n)k(new-to-old)f(permutation)f(vector"\))h(;)131 │ │ │ │ │ 1785 y(IV_writeForHuman)o(Ey)o(e\()o(new)o(To)o(Old)o(IV)o(,)e │ │ │ │ │ @@ -10634,45 +10602,45 @@ │ │ │ │ │ (0.0\))g(;)0 4973 y(IVfill\(20,)d(stats,)j(0\))g(;)0 │ │ │ │ │ 5073 y(rootchv)f(=)i(FrontMtx_factorI)o(np)o(Mtx)o(\(f)o(ron)o(tm)o(tx) │ │ │ │ │ o(,)38 b(mtxA,)j(tau,)h(droptol,)567 5172 y(chvmanager,)d(&error,)h │ │ │ │ │ (cpus,)i(stats,)f(msglvl,)g(msgFile\))f(;)0 5272 y(ChvManager_free\()o │ │ │ │ │ (chv)o(ma)o(na)o(ger)o(\))d(;)0 5372 y(if)43 b(\()g(msglvl)e(>)i(2)g │ │ │ │ │ (\))h({)p eop end │ │ │ │ │ %%Page: 29 29 │ │ │ │ │ -TeXDict begin 29 28 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(29)131 390 │ │ │ │ │ -y Fp(fprintf\(msgFile,)37 b("\\n\\n)k(factor)g(matrix"\))g(;)131 │ │ │ │ │ -490 y(FrontMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(fr)o(on)o(tmt)o(x,)c │ │ │ │ │ -(msgFile\))j(;)131 589 y(fflush\(msgFile\))d(;)0 689 │ │ │ │ │ -y(})0 789 y(if)43 b(\()g(rootchv)e(!=)h(NULL)g(\))h({)131 │ │ │ │ │ -888 y(fprintf\(msgFile,)37 b("\\n\\n)k(matrix)g(found)h(to)h(be)f │ │ │ │ │ -(singular\\n"\))d(;)131 988 y(exit\(-1\))h(;)0 1088 y(})0 │ │ │ │ │ -1187 y(if)j(\()g(error)e(>=)i(0)g(\))h({)131 1287 y(fprintf\(msgFile,) │ │ │ │ │ -37 b("\\n\\n)k(error)h(encountered)d(at)k(front)e(\045d",)h(error\))f │ │ │ │ │ -(;)131 1386 y(exit\(-1\))f(;)0 1486 y(})0 1586 y(/*--------------)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ -1685 y(/*)131 1785 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(-)131 1885 y(STEP)i(7:)g(post-process)d(the)j │ │ │ │ │ -(factorization)131 1984 y(----------------)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(--)o(-)0 2084 y(*/)0 2183 y(FrontMtx_postPro)o(ces)o │ │ │ │ │ -(s\()o(fr)o(ont)o(mt)o(x,)37 b(msglvl,)k(msgFile\))f(;)0 │ │ │ │ │ -2283 y(if)j(\()g(msglvl)e(>)i(2)g(\))h({)131 2383 y(fprintf\(msgFile,) │ │ │ │ │ -37 b("\\n\\n)k(factor)g(matrix)g(after)h(post-processing")o(\))c(;)131 │ │ │ │ │ -2482 y(FrontMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(fr)o(on)o(tmt)o(x,)f │ │ │ │ │ -(msgFile\))j(;)131 2582 y(fflush\(msgFile\))d(;)0 2682 │ │ │ │ │ -y(})0 2781 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(-*/)0 2881 y(/*)131 2980 y(----------------)o(--)o(--)o(---) │ │ │ │ │ -o(--)o(---)o(--)o(-)131 3080 y(STEP)42 b(8:)g(solve)g(the)g(linear)f │ │ │ │ │ -(system)131 3180 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(-)0 3279 y(*/)0 3379 y(mtxX)h(=)h(DenseMtx_new\(\))38 │ │ │ │ │ -b(;)0 3479 y(DenseMtx_init\(mt)o(xX,)f(type,)k(0,)i(0,)g(neqns,)e │ │ │ │ │ -(nrhs,)g(1,)i(neqns\))e(;)0 3578 y(DenseMtx_zero\(mt)o(xX\))c(;)0 │ │ │ │ │ +TeXDict begin 29 28 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(29)131 390 y Fp(fprintf\(msgFile,)37 │ │ │ │ │ +b("\\n\\n)k(factor)g(matrix"\))g(;)131 490 y(FrontMtx_writeFo)o(rH)o │ │ │ │ │ +(um)o(anE)o(ye)o(\(fr)o(on)o(tmt)o(x,)c(msgFile\))j(;)131 │ │ │ │ │ +589 y(fflush\(msgFile\))d(;)0 689 y(})0 789 y(if)43 b(\()g(rootchv)e │ │ │ │ │ +(!=)h(NULL)g(\))h({)131 888 y(fprintf\(msgFile,)37 b("\\n\\n)k(matrix)g │ │ │ │ │ +(found)h(to)h(be)f(singular\\n"\))d(;)131 988 y(exit\(-1\))h(;)0 │ │ │ │ │ +1088 y(})0 1187 y(if)j(\()g(error)e(>=)i(0)g(\))h({)131 │ │ │ │ │ +1287 y(fprintf\(msgFile,)37 b("\\n\\n)k(error)h(encountered)d(at)k │ │ │ │ │ +(front)e(\045d",)h(error\))f(;)131 1386 y(exit\(-1\))f(;)0 │ │ │ │ │ +1486 y(})0 1586 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(--)o(-*/)0 1685 y(/*)131 1785 y(----------------)o(--)o(--) │ │ │ │ │ +o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-)131 1885 y(STEP)i(7:)g │ │ │ │ │ +(post-process)d(the)j(factorization)131 1984 y(----------------)o(--)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-)0 2084 │ │ │ │ │ +y(*/)0 2183 y(FrontMtx_postPro)o(ces)o(s\()o(fr)o(ont)o(mt)o(x,)37 │ │ │ │ │ +b(msglvl,)k(msgFile\))f(;)0 2283 y(if)j(\()g(msglvl)e(>)i(2)g(\))h({) │ │ │ │ │ +131 2383 y(fprintf\(msgFile,)37 b("\\n\\n)k(factor)g(matrix)g(after)h │ │ │ │ │ +(post-processing")o(\))c(;)131 2482 y(FrontMtx_writeFo)o(rH)o(um)o(anE) │ │ │ │ │ +o(ye)o(\(fr)o(on)o(tmt)o(x,)f(msgFile\))j(;)131 2582 │ │ │ │ │ +y(fflush\(msgFile\))d(;)0 2682 y(})0 2781 y(/*--------------)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 2881 │ │ │ │ │ +y(/*)131 2980 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(-) │ │ │ │ │ +131 3080 y(STEP)42 b(8:)g(solve)g(the)g(linear)f(system)131 │ │ │ │ │ +3180 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(-)0 │ │ │ │ │ +3279 y(*/)0 3379 y(mtxX)h(=)h(DenseMtx_new\(\))38 b(;)0 │ │ │ │ │ +3479 y(DenseMtx_init\(mt)o(xX,)f(type,)k(0,)i(0,)g(neqns,)e(nrhs,)g(1,) │ │ │ │ │ +i(neqns\))e(;)0 3578 y(DenseMtx_zero\(mt)o(xX\))c(;)0 │ │ │ │ │ 3678 y(FrontMtx_solve\(f)o(ron)o(tm)o(tx)o(,)h(mtxX,)j(mtxY,)h │ │ │ │ │ (mtxmanager,)654 3778 y(cpus,)f(msglvl,)g(msgFile\))f(;)0 │ │ │ │ │ 3877 y(if)j(\()g(msglvl)e(>)i(2)g(\))h({)131 3977 y(fprintf\(msgFile,) │ │ │ │ │ 37 b("\\n\\n)k(solution)g(matrix)g(in)h(new)h(ordering"\))c(;)131 │ │ │ │ │ 4076 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(mt)o(xX)o(,)f │ │ │ │ │ (msgFile\))i(;)131 4176 y(fflush\(msgFile\))d(;)0 4276 │ │ │ │ │ y(})0 4375 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ @@ -10687,47 +10655,47 @@ │ │ │ │ │ 5172 y(fprintf\(msgFile,)37 b("\\n\\n)k(solution)g(matrix)g(in)h │ │ │ │ │ (original)f(ordering"\))e(;)131 5272 y(DenseMtx_writeFo)o(rH)o(um)o │ │ │ │ │ (anE)o(ye)o(\(mt)o(xX)o(,)f(msgFile\))i(;)131 5372 y(fflush\(msgFile\)) │ │ │ │ │ d(;)p eop end │ │ │ │ │ %%Page: 30 30 │ │ │ │ │ TeXDict begin 30 29 bop 0 100 a Fu(30)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fp(})0 490 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(-*/)0 589 y(/*)131 689 y(-----------)131 789 │ │ │ │ │ -y(free)42 b(memory)131 888 y(-----------)0 988 y(*/)0 │ │ │ │ │ -1088 y(FrontMtx_free\(fr)o(ont)o(mt)o(x\))37 b(;)0 1187 │ │ │ │ │ -y(DenseMtx_free\(mt)o(xX\))g(;)0 1287 y(DenseMtx_free\(mt)o(xY\))g(;)0 │ │ │ │ │ -1386 y(IV_free\(newToOld)o(IV\))g(;)0 1486 y(IV_free\(oldToNew)o(IV\))g │ │ │ │ │ -(;)0 1586 y(InpMtx_free\(mtxA)o(\))h(;)0 1685 y(ETree_free\(front)o │ │ │ │ │ -(ETr)o(ee)o(\))f(;)0 1785 y(IVL_free\(symbfac)o(IVL)o(\))g(;)0 │ │ │ │ │ -1885 y(SubMtxManager_fr)o(ee\()o(mt)o(xm)o(ana)o(ge)o(r\))g(;)0 │ │ │ │ │ -1984 y(Graph_free\(graph)o(\))h(;)0 2084 y(/*--------------)o(---)o(--) │ │ │ │ │ -o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 2183 y(return\(1\))i(;)j │ │ │ │ │ -(})0 2283 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fp(})0 │ │ │ │ │ +490 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(-*/)0 589 y(/*)131 689 y(-----------)131 789 y(free)42 │ │ │ │ │ +b(memory)131 888 y(-----------)0 988 y(*/)0 1088 y(FrontMtx_free\(fr)o │ │ │ │ │ +(ont)o(mt)o(x\))37 b(;)0 1187 y(DenseMtx_free\(mt)o(xX\))g(;)0 │ │ │ │ │ +1287 y(DenseMtx_free\(mt)o(xY\))g(;)0 1386 y(IV_free\(newToOld)o(IV\))g │ │ │ │ │ +(;)0 1486 y(IV_free\(oldToNew)o(IV\))g(;)0 1586 y(InpMtx_free\(mtxA)o │ │ │ │ │ +(\))h(;)0 1685 y(ETree_free\(front)o(ETr)o(ee)o(\))f(;)0 │ │ │ │ │ +1785 y(IVL_free\(symbfac)o(IVL)o(\))g(;)0 1885 y(SubMtxManager_fr)o │ │ │ │ │ +(ee\()o(mt)o(xm)o(ana)o(ge)o(r\))g(;)0 1984 y(Graph_free\(graph)o(\))h │ │ │ │ │ +(;)0 2084 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(-*/)p eop end │ │ │ │ │ -%%Page: 31 31 │ │ │ │ │ -TeXDict begin 31 30 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(31)0 390 │ │ │ │ │ -y Fr(B)134 b Fa(allInOne.c)40 b Fr({)45 b(A)g(Serial)h │ │ │ │ │ -Fj(LU)56 b Fr(Driv)l(er)46 b(Program)0 625 y Fp(/*)86 │ │ │ │ │ -b(allInOneMT.c)d(*/)0 824 y(#include)40 b("../spoolesMT.h")0 │ │ │ │ │ -924 y(#include)g("../../misc.h")0 1024 y(#include)g("../../FrontMtx.h)o │ │ │ │ │ -(")0 1123 y(#include)g("../../SymbFac.h")0 1322 y(/*--------------)o │ │ │ │ │ +(--)o(--)o(-*/)0 2183 y(return\(1\))i(;)j(})0 2283 y(/*--------------)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ -1422 y(int)0 1522 y(main)i(\()h(int)f(argc,)g(char)g(*argv[])f(\))i({)0 │ │ │ │ │ -1621 y(/*)131 1721 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)131 1821 y(all-in-one)c(program)i(to)i(solve)e(A)i(X)h(=)f(Y) │ │ │ │ │ -131 1920 y(using)e(a)i(multithreaded)c(factorization)f(and)k(solve)131 │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)p │ │ │ │ │ +eop end │ │ │ │ │ +%%Page: 31 31 │ │ │ │ │ +TeXDict begin 31 30 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(31)0 390 y Fr(B)134 b Fa(allInOne.c)40 │ │ │ │ │ +b Fr({)45 b(A)g(Serial)h Fj(LU)56 b Fr(Driv)l(er)46 b(Program)0 │ │ │ │ │ +625 y Fp(/*)86 b(allInOneMT.c)d(*/)0 824 y(#include)40 │ │ │ │ │ +b("../spoolesMT.h")0 924 y(#include)g("../../misc.h")0 │ │ │ │ │ +1024 y(#include)g("../../FrontMtx.h)o(")0 1123 y(#include)g │ │ │ │ │ +("../../SymbFac.h")0 1322 y(/*--------------)o(---)o(--)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(--)o(-*/)0 1422 y(int)0 1522 y(main)i(\()h(int)f │ │ │ │ │ +(argc,)g(char)g(*argv[])f(\))i({)0 1621 y(/*)131 1721 │ │ │ │ │ +y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)131 │ │ │ │ │ +1821 y(all-in-one)c(program)i(to)i(solve)e(A)i(X)h(=)f(Y)131 │ │ │ │ │ +1920 y(using)e(a)i(multithreaded)c(factorization)f(and)k(solve)131 │ │ │ │ │ 2120 y(\(1\))g(read)g(in)h(matrix)e(entries)g(for)h(A)h(and)f(form)g │ │ │ │ │ (InpMtx)f(object)131 2219 y(\(2\))h(read)g(in)h(right)e(hand)h(side)g │ │ │ │ │ (for)h(Y)g(entries)d(and)j(form)f(DenseMtx)e(object)131 │ │ │ │ │ 2319 y(\(3\))i(form)g(Graph)g(object,)e(order)i(matrix)f(and)h(form)g │ │ │ │ │ (front)g(tree)131 2418 y(\(4\))g(get)g(the)h(permutation,)38 │ │ │ │ │ b(permute)j(the)h(front)g(tree,)f(matrix)305 2518 y(and)h(right)g(hand) │ │ │ │ │ g(side)g(and)g(get)h(the)f(symbolic)e(factorization)131 │ │ │ │ │ @@ -10757,17 +10725,17 @@ │ │ │ │ │ 5108 y(ncol,)i(nedges,)f(nent,)g(neqns,)g(nfront,)g(nrhs,)g(nrow,)697 │ │ │ │ │ 5208 y(nthread,)g(pivotingflag,)d(seed,)j(symmetryflag,)e(type)j(;)0 │ │ │ │ │ 5308 y(int)565 b(*newToOld,)40 b(*oldToNew)g(;)0 5407 │ │ │ │ │ y(int)565 b(stats[20])40 b(;)p eop end │ │ │ │ │ %%Page: 32 32 │ │ │ │ │ TeXDict begin 32 31 bop 0 100 a Fu(32)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fp(IV)609 b(*newToOldIV,)39 b(*oldToNewIV,)g(*ownersIV)g(;)0 │ │ │ │ │ -490 y(IVL)565 b(*adjIVL,)41 b(*symbfacIVL)e(;)0 589 y(SolveMap)345 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fp(IV)609 │ │ │ │ │ +b(*newToOldIV,)39 b(*oldToNewIV,)g(*ownersIV)g(;)0 490 │ │ │ │ │ +y(IVL)565 b(*adjIVL,)41 b(*symbfacIVL)e(;)0 589 y(SolveMap)345 │ │ │ │ │ b(*solvemap)40 b(;)0 689 y(SubMtxManager)125 b(*mtxmanager)83 │ │ │ │ │ b(;)0 789 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(-*/)0 888 y(/*)131 988 y(----------------)o(--)o(--)131 │ │ │ │ │ 1088 y(get)42 b(input)g(parameters)131 1187 y(----------------)o(--)o │ │ │ │ │ (--)0 1287 y(*/)0 1386 y(if)h(\()g(argc)f(!=)h(10)f(\))i({)131 │ │ │ │ │ 1486 y(fprintf\(stdout,)37 b("\\n")262 1586 y("\\n)42 │ │ │ │ │ @@ -10806,30 +10774,30 @@ │ │ │ │ │ 4774 y(})i(else)f(if)h(\()g(\(msgFile)d(=)j(fopen\(argv[2],)38 │ │ │ │ │ b("a"\)\))k(==)h(NULL)e(\))j({)131 4873 y(fprintf\(stderr,)37 │ │ │ │ │ b("\\n)42 b(fatal)g(error)g(in)g(\045s")479 4973 y("\\n)h(unable)e(to)i │ │ │ │ │ (open)f(file)g(\045s\\n",)479 5073 y(argv[0],)f(argv[2]\))f(;)131 │ │ │ │ │ 5172 y(return\(-1\))f(;)0 5272 y(})0 5372 y(type)478 │ │ │ │ │ b(=)43 b(atoi\(argv[3]\))38 b(;)p eop end │ │ │ │ │ %%Page: 33 33 │ │ │ │ │ -TeXDict begin 33 32 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(33)0 390 │ │ │ │ │ -y Fp(symmetryflag)126 b(=)43 b(atoi\(argv[4]\))38 b(;)0 │ │ │ │ │ -490 y(pivotingflag)126 b(=)43 b(atoi\(argv[5]\))38 b(;)0 │ │ │ │ │ -589 y(matrixFileName)g(=)43 b(argv[6])e(;)0 689 y(rhsFileName)170 │ │ │ │ │ -b(=)43 b(argv[7])e(;)0 789 y(seed)478 b(=)43 b(atoi\(argv[8]\))38 │ │ │ │ │ -b(;)0 888 y(nthread)346 b(=)43 b(atoi\(argv[9]\))38 b(;)0 │ │ │ │ │ -988 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(--)o(-*/)0 1088 y(/*)131 1187 y(----------------)o(--)o(--)o(---)o(--) │ │ │ │ │ -o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(--)131 1287 y(STEP)k(1:)g(read) │ │ │ │ │ -g(the)h(entries)d(from)i(the)h(input)e(file)479 1386 │ │ │ │ │ -y(and)i(create)e(the)h(InpMtx)f(object)131 1486 y(----------------)o │ │ │ │ │ -(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(--)0 │ │ │ │ │ -1586 y(*/)0 1685 y(inputFile)f(=)j(fopen\(matrixFile)o(Nam)o(e,)37 │ │ │ │ │ +TeXDict begin 33 32 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(33)0 390 y Fp(symmetryflag)126 │ │ │ │ │ +b(=)43 b(atoi\(argv[4]\))38 b(;)0 490 y(pivotingflag)126 │ │ │ │ │ +b(=)43 b(atoi\(argv[5]\))38 b(;)0 589 y(matrixFileName)g(=)43 │ │ │ │ │ +b(argv[6])e(;)0 689 y(rhsFileName)170 b(=)43 b(argv[7])e(;)0 │ │ │ │ │ +789 y(seed)478 b(=)43 b(atoi\(argv[8]\))38 b(;)0 888 │ │ │ │ │ +y(nthread)346 b(=)43 b(atoi\(argv[9]\))38 b(;)0 988 y(/*--------------) │ │ │ │ │ +o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---) │ │ │ │ │ +o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ +1088 y(/*)131 1187 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(--)o(---)o(--)o(--)131 1287 y(STEP)k(1:)g(read)g(the)h │ │ │ │ │ +(entries)d(from)i(the)h(input)e(file)479 1386 y(and)i(create)e(the)h │ │ │ │ │ +(InpMtx)f(object)131 1486 y(----------------)o(--)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(--)o(---)o(--)o(--)0 1586 y(*/)0 │ │ │ │ │ +1685 y(inputFile)f(=)j(fopen\(matrixFile)o(Nam)o(e,)37 │ │ │ │ │ b("r"\))42 b(;)0 1785 y(fscanf\(inputFile)o(,)c("\045d)k(\045d)h │ │ │ │ │ (\045d",)f(&nrow,)f(&ncol,)g(&nent\))g(;)0 1885 y(neqns)h(=)h(nrow)f(;) │ │ │ │ │ 0 1984 y(mtxA)g(=)h(InpMtx_new\(\))c(;)0 2084 y(InpMtx_init\(mtxA)o(,)f │ │ │ │ │ (INPMTX_BY_ROWS,)f(type,)k(nent,)h(0\))h(;)0 2183 y(if)g(\()g(type)f │ │ │ │ │ (==)h(SPOOLES_REAL)38 b(\))43 b({)131 2283 y(double)128 │ │ │ │ │ b(value)42 b(;)131 2383 y(for)g(\()h(ient)f(=)h(0)h(;)f(ient)f(<)h │ │ │ │ │ (nent)f(;)h(ient++)e(\))i({)262 2482 y(fscanf\(inputFil)o(e,)37 │ │ │ │ │ @@ -10859,38 +10827,37 @@ │ │ │ │ │ b(;)0 5073 y(DenseMtx_init\(mt)o(xY,)f(type,)k(0,)i(0,)g(neqns,)e │ │ │ │ │ (nrhs,)g(1,)i(neqns\))e(;)0 5172 y(DenseMtx_zero\(mt)o(xY\))c(;)0 │ │ │ │ │ 5272 y(if)43 b(\()g(type)f(==)h(SPOOLES_REAL)38 b(\))43 │ │ │ │ │ b({)131 5372 y(double)128 b(value)42 b(;)p eop end │ │ │ │ │ %%Page: 34 34 │ │ │ │ │ TeXDict begin 34 33 bop 0 100 a Fu(34)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)131 390 │ │ │ │ │ -y Fp(for)42 b(\()h(irow)f(=)h(0)h(;)f(irow)f(<)h(nrow)f(;)h(irow++)e │ │ │ │ │ -(\))i({)262 490 y(fscanf\(inputFil)o(e,)37 b("\045d",)42 │ │ │ │ │ -b(&jrow\))f(;)262 589 y(for)h(\()h(jrhs)f(=)h(0)g(;)g(jrhs)f(<)i(nrhs)e │ │ │ │ │ -(;)h(jrhs++)e(\))i({)392 689 y(fscanf\(inputFile,)37 │ │ │ │ │ -b("\045le",)k(&value\))g(;)392 789 y(DenseMtx_setRealE)o(nt)o(ry\()o │ │ │ │ │ -(mt)o(xY,)c(jrow,)k(jrhs,)h(value\))f(;)262 888 y(})131 │ │ │ │ │ -988 y(})0 1088 y(})i(else)f({)131 1187 y(double)128 b(imag,)42 │ │ │ │ │ -b(real)f(;)131 1287 y(for)h(\()h(irow)f(=)h(0)h(;)f(irow)f(<)h(nrow)f │ │ │ │ │ -(;)h(irow++)e(\))i({)262 1386 y(fscanf\(inputFil)o(e,)37 │ │ │ │ │ -b("\045d",)42 b(&jrow\))f(;)262 1486 y(for)h(\()h(jrhs)f(=)h(0)g(;)g │ │ │ │ │ -(jrhs)f(<)i(nrhs)e(;)h(jrhs++)e(\))i({)392 1586 y(fscanf\(inputFile,)37 │ │ │ │ │ -b("\045le)42 b(\045le",)f(&real,)g(&imag\))g(;)392 1685 │ │ │ │ │ -y(DenseMtx_setCompl)o(ex)o(Ent)o(ry)o(\(mt)o(xY)o(,)c(jrow,)42 │ │ │ │ │ -b(jrhs,)f(real,)h(imag\))g(;)262 1785 y(})131 1885 y(})0 │ │ │ │ │ -1984 y(})0 2084 y(fclose\(inputFile)o(\))c(;)0 2183 y(if)43 │ │ │ │ │ -b(\()g(msglvl)e(>)i(1)g(\))h({)131 2283 y(fprintf\(msgFile,)37 │ │ │ │ │ -b("\\n\\n)k(rhs)i(matrix)e(in)h(original)f(ordering"\))e(;)131 │ │ │ │ │ -2383 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(mt)o(xY)o(,)f │ │ │ │ │ -(msgFile\))i(;)131 2482 y(fflush\(msgFile\))d(;)0 2582 │ │ │ │ │ -y(})0 2682 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(-*/)0 2781 y(/*)131 2881 y(----------------)o(--)o(--)o(---) │ │ │ │ │ -o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)131 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)131 390 y Fp(for)42 │ │ │ │ │ +b(\()h(irow)f(=)h(0)h(;)f(irow)f(<)h(nrow)f(;)h(irow++)e(\))i({)262 │ │ │ │ │ +490 y(fscanf\(inputFil)o(e,)37 b("\045d",)42 b(&jrow\))f(;)262 │ │ │ │ │ +589 y(for)h(\()h(jrhs)f(=)h(0)g(;)g(jrhs)f(<)i(nrhs)e(;)h(jrhs++)e(\))i │ │ │ │ │ +({)392 689 y(fscanf\(inputFile,)37 b("\045le",)k(&value\))g(;)392 │ │ │ │ │ +789 y(DenseMtx_setRealE)o(nt)o(ry\()o(mt)o(xY,)c(jrow,)k(jrhs,)h │ │ │ │ │ +(value\))f(;)262 888 y(})131 988 y(})0 1088 y(})i(else)f({)131 │ │ │ │ │ +1187 y(double)128 b(imag,)42 b(real)f(;)131 1287 y(for)h(\()h(irow)f(=) │ │ │ │ │ +h(0)h(;)f(irow)f(<)h(nrow)f(;)h(irow++)e(\))i({)262 1386 │ │ │ │ │ +y(fscanf\(inputFil)o(e,)37 b("\045d",)42 b(&jrow\))f(;)262 │ │ │ │ │ +1486 y(for)h(\()h(jrhs)f(=)h(0)g(;)g(jrhs)f(<)i(nrhs)e(;)h(jrhs++)e(\)) │ │ │ │ │ +i({)392 1586 y(fscanf\(inputFile,)37 b("\045le)42 b(\045le",)f(&real,)g │ │ │ │ │ +(&imag\))g(;)392 1685 y(DenseMtx_setCompl)o(ex)o(Ent)o(ry)o(\(mt)o(xY)o │ │ │ │ │ +(,)c(jrow,)42 b(jrhs,)f(real,)h(imag\))g(;)262 1785 y(})131 │ │ │ │ │ +1885 y(})0 1984 y(})0 2084 y(fclose\(inputFile)o(\))c(;)0 │ │ │ │ │ +2183 y(if)43 b(\()g(msglvl)e(>)i(1)g(\))h({)131 2283 │ │ │ │ │ +y(fprintf\(msgFile,)37 b("\\n\\n)k(rhs)i(matrix)e(in)h(original)f │ │ │ │ │ +(ordering"\))e(;)131 2383 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o │ │ │ │ │ +(\(mt)o(xY)o(,)f(msgFile\))i(;)131 2482 y(fflush\(msgFile\))d(;)0 │ │ │ │ │ +2582 y(})0 2682 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(--)o(-*/)0 2781 y(/*)131 2881 y(----------------)o(--)o(--) │ │ │ │ │ +o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)131 │ │ │ │ │ 2980 y(STEP)42 b(3)h(:)g(find)f(a)h(low-fill)d(ordering)131 │ │ │ │ │ 3080 y(\(1\))i(create)f(the)i(Graph)e(object)131 3180 │ │ │ │ │ y(\(2\))h(order)g(the)g(graph)f(using)h(multiple)e(minimum)h(degree)131 │ │ │ │ │ 3279 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)0 3379 y(*/)0 3479 y(graph)h(=)h │ │ │ │ │ (Graph_new\(\))c(;)0 3578 y(adjIVL)i(=)i(InpMtx_fullAdjace)o(nc)o(y\(m) │ │ │ │ │ o(tx)o(A\))37 b(;)0 3678 y(nedges)k(=)i(IVL_tsize\(adjIVL\))37 │ │ │ │ │ @@ -10908,18 +10875,18 @@ │ │ │ │ │ 4973 y(})0 5073 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(-*/)0 5172 y(/*)131 5272 y(----------------)o(--)o(--) │ │ │ │ │ o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---) │ │ │ │ │ 131 5372 y(STEP)42 b(4:)g(get)h(the)f(permutation,)d(permute)h(the)j │ │ │ │ │ (front)e(tree,)p eop end │ │ │ │ │ %%Page: 35 35 │ │ │ │ │ -TeXDict begin 35 34 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(35)479 390 │ │ │ │ │ -y Fp(permute)41 b(the)h(matrix)g(and)g(right)f(hand)h(side,)g(and)479 │ │ │ │ │ +TeXDict begin 35 34 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(35)479 390 y Fp(permute)41 │ │ │ │ │ +b(the)h(matrix)g(and)g(right)f(hand)h(side,)g(and)479 │ │ │ │ │ 490 y(get)h(the)f(symbolic)e(factorization)131 589 y(----------------)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)0 689 y(*/)0 789 y(oldToNewIV)f(=)44 b(ETree_oldToNewV)o(txP) │ │ │ │ │ o(er)o(m\(f)o(ro)o(nt)o(ETr)o(ee)o(\))38 b(;)0 888 y(oldToNew)127 │ │ │ │ │ b(=)44 b(IV_entries\(oldT)o(oNe)o(wI)o(V\))37 b(;)0 988 │ │ │ │ │ y(newToOldIV)i(=)44 b(ETree_newToOldV)o(txP)o(er)o(m\(f)o(ro)o(nt)o │ │ │ │ │ (ETr)o(ee)o(\))38 b(;)0 1088 y(newToOld)127 b(=)44 b(IV_entries\(newT)o │ │ │ │ │ @@ -10969,24 +10936,24 @@ │ │ │ │ │ (sIV)o(,)d(msgFile\))k(;)131 5272 y(fprintf\(msgFile,)c("\\n\\n)k │ │ │ │ │ (factor)g(operations)f(for)i(each)g(front"\))f(;)131 │ │ │ │ │ 5372 y(DV_writeForHuman)o(Ey)o(e\()o(cum)o(op)o(sDV)o(,)c(msgFile\))k │ │ │ │ │ (;)p eop end │ │ │ │ │ %%Page: 36 36 │ │ │ │ │ TeXDict begin 36 35 bop 0 100 a Fu(36)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)131 390 │ │ │ │ │ -y Fp(fflush\(msgFile\))37 b(;)0 490 y(})0 589 y(DV_free\(cumopsDV)o(\)) │ │ │ │ │ -h(;)0 689 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(-*/)0 789 y(/*)131 888 y(----------------)o(--)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)131 988 y(STEP)k(6:)g │ │ │ │ │ -(initialize)e(the)i(front)g(matrix)f(object)131 1088 │ │ │ │ │ -y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)0 1187 y(*/)0 1287 y(frontmtx)127 b(=)44 b(FrontMtx_new\(\)) │ │ │ │ │ -37 b(;)0 1386 y(mtxmanager)i(=)44 b(SubMtxManager_n)o(ew\()o(\))37 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)131 390 y Fp(fflush\(msgFile\)) │ │ │ │ │ +37 b(;)0 490 y(})0 589 y(DV_free\(cumopsDV)o(\))h(;)0 │ │ │ │ │ +689 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(-*/)0 789 y(/*)131 888 y(----------------)o(--)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(--)o(---)o(--)131 988 y(STEP)k(6:)g(initialize)e │ │ │ │ │ +(the)i(front)g(matrix)f(object)131 1088 y(----------------)o(--)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)0 1187 │ │ │ │ │ +y(*/)0 1287 y(frontmtx)127 b(=)44 b(FrontMtx_new\(\))37 │ │ │ │ │ +b(;)0 1386 y(mtxmanager)i(=)44 b(SubMtxManager_n)o(ew\()o(\))37 │ │ │ │ │ b(;)0 1486 y(SubMtxManager_in)o(it\()o(mt)o(xm)o(ana)o(ge)o(r,)g │ │ │ │ │ (LOCK_IN_PROCESS,)g(0\))43 b(;)0 1586 y(FrontMtx_init\(fr)o(ont)o(mt)o │ │ │ │ │ (x,)37 b(frontETree,)i(symbfacIVL,)g(type,)j(symmetryflag,)610 │ │ │ │ │ 1685 y(FRONTMTX_DENSE_FR)o(ON)o(TS,)37 b(pivotingflag,)h │ │ │ │ │ (LOCK_IN_PROCESS,)610 1785 y(0,)43 b(NULL,)e(mtxmanager,)f(msglvl,)g │ │ │ │ │ (msgFile\))g(;)0 1885 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ @@ -11020,27 +10987,27 @@ │ │ │ │ │ (post-process)d(the)j(factorization)131 4973 y(----------------)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-)0 5073 │ │ │ │ │ y(*/)0 5172 y(FrontMtx_postPro)o(ces)o(s\()o(fr)o(ont)o(mt)o(x,)37 │ │ │ │ │ b(msglvl,)k(msgFile\))f(;)0 5272 y(if)j(\()g(msglvl)e(>)i(1)g(\))h({) │ │ │ │ │ 131 5372 y(fprintf\(msgFile,)37 b("\\n\\n)k(factor)g(matrix)g(after)h │ │ │ │ │ (post-processing")o(\))c(;)p eop end │ │ │ │ │ %%Page: 37 37 │ │ │ │ │ -TeXDict begin 37 36 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(37)131 390 │ │ │ │ │ -y Fp(FrontMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(fr)o(on)o(tmt)o(x,)37 │ │ │ │ │ -b(msgFile\))j(;)131 490 y(fflush\(msgFile\))d(;)0 589 │ │ │ │ │ -y(})0 689 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(-*/)0 789 y(/*)131 888 y(----------------)o(--)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ -(-)131 988 y(STEP)42 b(9:)g(get)h(the)f(solve)g(map)g(object)f(for)h │ │ │ │ │ -(the)h(parallel)d(solve)131 1088 y(----------------)o(--)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ -(-)0 1187 y(*/)0 1287 y(solvemap)g(=)j(SolveMap_new\(\))38 │ │ │ │ │ +TeXDict begin 37 36 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(37)131 390 y Fp(FrontMtx_writeFo)o(rH)o(um)o │ │ │ │ │ +(anE)o(ye)o(\(fr)o(on)o(tmt)o(x,)37 b(msgFile\))j(;)131 │ │ │ │ │ +490 y(fflush\(msgFile\))d(;)0 589 y(})0 689 y(/*--------------)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 789 │ │ │ │ │ +y(/*)131 888 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(-)131 │ │ │ │ │ +988 y(STEP)42 b(9:)g(get)h(the)f(solve)g(map)g(object)f(for)h(the)h │ │ │ │ │ +(parallel)d(solve)131 1088 y(----------------)o(--)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(-)0 │ │ │ │ │ +1187 y(*/)0 1287 y(solvemap)g(=)j(SolveMap_new\(\))38 │ │ │ │ │ b(;)0 1386 y(SolveMap_ddMap\(s)o(olv)o(em)o(ap)o(,)g(symmetryflag,)g │ │ │ │ │ (FrontMtx_upperBl)o(oc)o(kIV)o(L\()o(fro)o(nt)o(mt)o(x\),)654 │ │ │ │ │ 1486 y(FrontMtx_lowerBl)o(oc)o(kIV)o(L\()o(fr)o(ont)o(mt)o(x\),)f │ │ │ │ │ (nthread,)j(ownersIV,)654 1586 y(FrontMtx_frontTr)o(ee)o(\(fr)o(on)o │ │ │ │ │ (tm)o(tx\))o(,)d(seed,)42 b(msglvl,)f(msgFile\))f(;)0 │ │ │ │ │ 1685 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ @@ -11075,41 +11042,40 @@ │ │ │ │ │ 4774 y(free)42 b(memory)131 4873 y(-----------)0 4973 │ │ │ │ │ y(*/)0 5073 y(FrontMtx_free\(fr)o(ont)o(mt)o(x\))37 b(;)0 │ │ │ │ │ 5172 y(DenseMtx_free\(mt)o(xX\))g(;)0 5272 y(DenseMtx_free\(mt)o(xY\))g │ │ │ │ │ (;)0 5372 y(IV_free\(newToOld)o(IV\))g(;)p eop end │ │ │ │ │ %%Page: 38 38 │ │ │ │ │ TeXDict begin 38 37 bop 0 100 a Fu(38)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fp(IV_free\(oldToNew)o(IV\))37 b(;)0 490 y(InpMtx_free\(mtxA)o(\))h(;)0 │ │ │ │ │ -589 y(ETree_free\(front)o(ETr)o(ee)o(\))f(;)0 689 y(IVL_free\(symbfac)o │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fp(IV_free\(oldToNew)o │ │ │ │ │ +(IV\))37 b(;)0 490 y(InpMtx_free\(mtxA)o(\))h(;)0 589 │ │ │ │ │ +y(ETree_free\(front)o(ETr)o(ee)o(\))f(;)0 689 y(IVL_free\(symbfac)o │ │ │ │ │ (IVL)o(\))g(;)0 789 y(SubMtxManager_fr)o(ee\()o(mt)o(xm)o(ana)o(ge)o │ │ │ │ │ (r\))g(;)0 888 y(Graph_free\(graph)o(\))h(;)0 988 y(SolveMap_free\(so)o │ │ │ │ │ (lve)o(ma)o(p\))f(;)0 1088 y(IV_free\(ownersIV)o(\))h(;)0 │ │ │ │ │ 1187 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(-*/)0 1287 y(return\(1\))i(;)j(})0 1386 y(/*--------------)o(---) │ │ │ │ │ o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 39 39 │ │ │ │ │ -TeXDict begin 39 38 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(39)0 390 │ │ │ │ │ -y Fr(C)135 b Fa(allInOne.c)40 b Fr({)45 b(A)f(Serial)i │ │ │ │ │ -Fj(LU)57 b Fr(Driv)l(er)45 b(Program)0 625 y Fp(/*)86 │ │ │ │ │ -b(allInOneMPI.c)c(*/)0 824 y(#include)40 b("../spoolesMPI.h")0 │ │ │ │ │ -924 y(#include)g("../../timings.h")0 1123 y(/*--------------)o(---)o │ │ │ │ │ -(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 1223 │ │ │ │ │ -y(int)0 1322 y(main)i(\()h(int)f(argc,)g(char)g(*argv[])f(\))i({)0 │ │ │ │ │ -1422 y(/*)131 1522 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(-)131 │ │ │ │ │ -1621 y(all-in-one)c(MPI)k(program)d(for)j(each)f(process)131 │ │ │ │ │ -1821 y(order,)f(factor)g(and)h(solve)g(A)h(X)g(=)g(Y)131 │ │ │ │ │ +TeXDict begin 39 38 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(39)0 390 y Fr(C)135 b Fa(allInOne.c)40 │ │ │ │ │ +b Fr({)45 b(A)f(Serial)i Fj(LU)57 b Fr(Driv)l(er)45 b(Program)0 │ │ │ │ │ +625 y Fp(/*)86 b(allInOneMPI.c)c(*/)0 824 y(#include)40 │ │ │ │ │ +b("../spoolesMPI.h")0 924 y(#include)g("../../timings.h")0 │ │ │ │ │ +1123 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(-*/)0 1223 y(int)0 1322 y(main)i(\()h(int)f(argc,)g(char)g │ │ │ │ │ +(*argv[])f(\))i({)0 1422 y(/*)131 1522 y(----------------)o(--)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(--)o(-)131 1621 y(all-in-one)c(MPI)k(program)d(for)j(each)f │ │ │ │ │ +(process)131 1821 y(order,)f(factor)g(and)h(solve)g(A)h(X)g(=)g(Y)131 │ │ │ │ │ 2020 y(\()g(1\))g(read)f(in)g(matrix)f(entries)g(and)i(form)e(InpMtx)h │ │ │ │ │ (object)f(for)h(A)131 2120 y(\()h(2\))g(order)e(the)i(system)e(using)g │ │ │ │ │ (minimum)g(degree)131 2219 y(\()i(3\))g(permute)d(the)j(front)e(tree) │ │ │ │ │ 131 2319 y(\()i(4\))g(create)e(the)h(owners)f(map)i(IV)f(object)131 │ │ │ │ │ 2418 y(\()h(5\))g(permute)d(the)j(matrix)e(A)i(and)f(redistribute)131 │ │ │ │ │ 2518 y(\()h(6\))g(compute)d(the)j(symbolic)d(factorization)131 │ │ │ │ │ 2618 y(\()j(7\))g(compute)d(the)j(numeric)d(factorization)131 │ │ │ │ │ @@ -11137,20 +11103,20 @@ │ │ │ │ │ b(*inputFile,)39 b(*msgFile)i(;)0 5208 y(Graph)477 b(*graph)41 │ │ │ │ │ b(;)0 5308 y(int)565 b(error,)41 b(firsttag,)f(ient,)i(irow,)f(jcol,)h │ │ │ │ │ (lookahead)e(=)j(0,)697 5407 y(msglvl,)e(myid,)h(nedges,)e(nent,)i │ │ │ │ │ (neqns,)f(nmycol,)g(nproc,)g(nrhs,)p eop end │ │ │ │ │ %%Page: 40 40 │ │ │ │ │ TeXDict begin 40 39 bop 0 100 a Fu(40)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)697 390 │ │ │ │ │ -y Fp(nrow,)42 b(pivotingflag,)c(root,)k(seed,)f(symmetryflag,)d(type)k │ │ │ │ │ -(;)0 490 y(int)565 b(stats[20])40 b(;)0 589 y(int)565 │ │ │ │ │ -b(*rowind)41 b(;)0 689 y(IV)609 b(*oldToNewIV,)39 b(*ownedColumnsIV,)e │ │ │ │ │ -(*ownersIV,)697 789 y(*newToOldIV,)i(*vtxmapIV)h(;)0 │ │ │ │ │ -888 y(IVL)565 b(*adjIVL,)41 b(*symbfacIVL)e(;)0 988 y(SolveMap)345 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)697 390 y Fp(nrow,)42 │ │ │ │ │ +b(pivotingflag,)c(root,)k(seed,)f(symmetryflag,)d(type)k(;)0 │ │ │ │ │ +490 y(int)565 b(stats[20])40 b(;)0 589 y(int)565 b(*rowind)41 │ │ │ │ │ +b(;)0 689 y(IV)609 b(*oldToNewIV,)39 b(*ownedColumnsIV,)e(*ownersIV,) │ │ │ │ │ +697 789 y(*newToOldIV,)i(*vtxmapIV)h(;)0 888 y(IVL)565 │ │ │ │ │ +b(*adjIVL,)41 b(*symbfacIVL)e(;)0 988 y(SolveMap)345 │ │ │ │ │ b(*solvemap)40 b(;)0 1088 y(/*--------------)o(---)o(--)o(--)o(---)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(--)o(-*/)0 1187 y(/*)131 1287 │ │ │ │ │ y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(-)131 │ │ │ │ │ 1386 y(find)i(out)g(the)g(identity)f(of)h(this)g(process)f(and)h(the)h │ │ │ │ │ (number)e(of)i(process)131 1486 y(----------------)o(--)o(--)o(---)o │ │ │ │ │ @@ -11190,44 +11156,44 @@ │ │ │ │ │ (number")262 4674 y("\\n",)g(argv[0]\))f(;)131 4774 y(return\(0\))g(;)0 │ │ │ │ │ 4873 y(})0 4973 y(msglvl)h(=)i(atoi\(argv[1]\))38 b(;)0 │ │ │ │ │ 5073 y(if)43 b(\()g(strcmp\(argv[2],)37 b("stdout"\))j(==)j(0)g(\))g({) │ │ │ │ │ 131 5172 y(msgFile)d(=)k(stdout)d(;)0 5272 y(})i(else)f({)131 │ │ │ │ │ 5372 y(sprintf\(buffer,)37 b("res.\045d",)j(myid\))i(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 41 41 │ │ │ │ │ -TeXDict begin 41 40 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(41)131 390 │ │ │ │ │ -y Fp(if)43 b(\()g(\(msgFile)d(=)j(fopen\(buffer,)38 b("w"\)\))k(==)h │ │ │ │ │ -(NULL)f(\))h({)262 490 y(fprintf\(stderr,)37 b("\\n)42 │ │ │ │ │ -b(fatal)g(error)f(in)i(\045s")610 589 y("\\n)g(unable)e(to)h(open)g │ │ │ │ │ -(file)g(\045s\\n",)610 689 y(argv[0],)e(buffer\))h(;)262 │ │ │ │ │ -789 y(return\(-1\))e(;)131 888 y(})0 988 y(})0 1088 y(type)391 │ │ │ │ │ -b(=)43 b(atoi\(argv[3]\))38 b(;)0 1187 y(symmetryflag)h(=)k │ │ │ │ │ -(atoi\(argv[4]\))38 b(;)0 1287 y(pivotingflag)h(=)k(atoi\(argv[5]\))38 │ │ │ │ │ -b(;)0 1386 y(seed)391 b(=)43 b(atoi\(argv[6]\))38 b(;)0 │ │ │ │ │ -1486 y(IVzero\(20,)h(stats\))j(;)0 1586 y(DVzero\(20,)d(cpus\))j(;)0 │ │ │ │ │ -1685 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(--)o(-*/)0 1785 y(/*)131 1885 y(----------------)o(--)o(--)o(---)o(--) │ │ │ │ │ -o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(--)131 1984 y(STEP)g(1:)g(read) │ │ │ │ │ -g(the)h(entries)d(from)i(the)h(input)e(file)479 2084 │ │ │ │ │ -y(and)i(create)e(the)h(InpMtx)f(object)131 2183 y(----------------)o │ │ │ │ │ -(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(--)0 │ │ │ │ │ -2283 y(*/)0 2383 y(sprintf\(buffer,)c("matrix.\045d.input")o(,)h │ │ │ │ │ -(myid\))j(;)0 2482 y(inputFile)f(=)j(fopen\(buffer,)38 │ │ │ │ │ -b("r"\))k(;)0 2582 y(fscanf\(inputFile)o(,)c("\045d)k(\045d)h(\045d",)f │ │ │ │ │ -(&neqns,)e(&neqns,)h(&nent\))g(;)0 2682 y(mtxA)h(=)h(InpMtx_new\(\))c │ │ │ │ │ -(;)0 2781 y(InpMtx_init\(mtxA)o(,)f(INPMTX_BY_ROWS,)f(type,)k(nent,)h │ │ │ │ │ -(0\))h(;)0 2881 y(if)g(\()g(type)f(==)h(SPOOLES_REAL)38 │ │ │ │ │ -b(\))43 b({)131 2980 y(double)128 b(value)42 b(;)131 │ │ │ │ │ -3080 y(for)g(\()h(ient)f(=)h(0)h(;)f(ient)f(<)h(nent)f(;)h(ient++)e(\)) │ │ │ │ │ -i({)262 3180 y(fscanf\(inputFil)o(e,)37 b("\045d)42 b(\045d)h(\045le",) │ │ │ │ │ -f(&irow,)f(&jcol,)g(&value\))g(;)262 3279 y(InpMtx_inputRea)o(lE)o(ntr) │ │ │ │ │ -o(y\()o(mtx)o(A,)c(irow,)k(jcol,)h(value\))f(;)131 3379 │ │ │ │ │ +TeXDict begin 41 40 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(41)131 390 y Fp(if)43 b(\()g(\(msgFile)d(=)j │ │ │ │ │ +(fopen\(buffer,)38 b("w"\)\))k(==)h(NULL)f(\))h({)262 │ │ │ │ │ +490 y(fprintf\(stderr,)37 b("\\n)42 b(fatal)g(error)f(in)i(\045s")610 │ │ │ │ │ +589 y("\\n)g(unable)e(to)h(open)g(file)g(\045s\\n",)610 │ │ │ │ │ +689 y(argv[0],)e(buffer\))h(;)262 789 y(return\(-1\))e(;)131 │ │ │ │ │ +888 y(})0 988 y(})0 1088 y(type)391 b(=)43 b(atoi\(argv[3]\))38 │ │ │ │ │ +b(;)0 1187 y(symmetryflag)h(=)k(atoi\(argv[4]\))38 b(;)0 │ │ │ │ │ +1287 y(pivotingflag)h(=)k(atoi\(argv[5]\))38 b(;)0 1386 │ │ │ │ │ +y(seed)391 b(=)43 b(atoi\(argv[6]\))38 b(;)0 1486 y(IVzero\(20,)h │ │ │ │ │ +(stats\))j(;)0 1586 y(DVzero\(20,)d(cpus\))j(;)0 1685 │ │ │ │ │ +y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ +(-*/)0 1785 y(/*)131 1885 y(----------------)o(--)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(--)o(---)o(--)o(--)131 1984 y(STEP)g(1:)g(read)g │ │ │ │ │ +(the)h(entries)d(from)i(the)h(input)e(file)479 2084 y(and)i(create)e │ │ │ │ │ +(the)h(InpMtx)f(object)131 2183 y(----------------)o(--)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(--)0 2283 │ │ │ │ │ +y(*/)0 2383 y(sprintf\(buffer,)c("matrix.\045d.input")o(,)h(myid\))j(;) │ │ │ │ │ +0 2482 y(inputFile)f(=)j(fopen\(buffer,)38 b("r"\))k(;)0 │ │ │ │ │ +2582 y(fscanf\(inputFile)o(,)c("\045d)k(\045d)h(\045d",)f(&neqns,)e │ │ │ │ │ +(&neqns,)h(&nent\))g(;)0 2682 y(mtxA)h(=)h(InpMtx_new\(\))c(;)0 │ │ │ │ │ +2781 y(InpMtx_init\(mtxA)o(,)f(INPMTX_BY_ROWS,)f(type,)k(nent,)h(0\))h │ │ │ │ │ +(;)0 2881 y(if)g(\()g(type)f(==)h(SPOOLES_REAL)38 b(\))43 │ │ │ │ │ +b({)131 2980 y(double)128 b(value)42 b(;)131 3080 y(for)g(\()h(ient)f │ │ │ │ │ +(=)h(0)h(;)f(ient)f(<)h(nent)f(;)h(ient++)e(\))i({)262 │ │ │ │ │ +3180 y(fscanf\(inputFil)o(e,)37 b("\045d)42 b(\045d)h(\045le",)f │ │ │ │ │ +(&irow,)f(&jcol,)g(&value\))g(;)262 3279 y(InpMtx_inputRea)o(lE)o(ntr)o │ │ │ │ │ +(y\()o(mtx)o(A,)c(irow,)k(jcol,)h(value\))f(;)131 3379 │ │ │ │ │ y(})0 3479 y(})i(else)f(if)h(\()g(type)f(==)h(SPOOLES_COMPLEX)37 │ │ │ │ │ b(\))43 b({)131 3578 y(double)128 b(imag,)42 b(real)f(;)131 │ │ │ │ │ 3678 y(for)h(\()h(ient)f(=)h(0)h(;)f(ient)f(<)h(nent)f(;)h(ient++)e(\)) │ │ │ │ │ i({)262 3778 y(fscanf\(inputFil)o(e,)37 b("\045d)42 b(\045d)h(\045le)g │ │ │ │ │ (\045le",)e(&irow,)g(&jcol,)g(&real,)g(&imag\))g(;)262 │ │ │ │ │ 3877 y(InpMtx_inputCom)o(pl)o(exE)o(nt)o(ry\()o(mt)o(xA,)c(irow,)k │ │ │ │ │ (jcol,)h(real,)f(imag\))h(;)131 3977 y(})0 4076 y(})0 │ │ │ │ │ @@ -11243,23 +11209,23 @@ │ │ │ │ │ o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ (---)131 5272 y(STEP)42 b(2:)g(read)g(the)h(rhs)f(entries)f(from)h(the) │ │ │ │ │ g(rhs)g(input)g(file)131 5372 y(and)g(create)f(the)i(DenseMtx)d(object) │ │ │ │ │ h(for)h(Y)p eop end │ │ │ │ │ %%Page: 42 42 │ │ │ │ │ TeXDict begin 42 41 bop 0 100 a Fu(42)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)131 390 │ │ │ │ │ -y Fp(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(---)o(--)o(--)o(---)0 490 y(*/)0 589 y(sprintf\(buffer,)37 │ │ │ │ │ -b("rhs.\045d.input",)h(myid\))j(;)0 689 y(inputFile)f(=)j │ │ │ │ │ -(fopen\(buffer,)38 b("r"\))k(;)0 789 y(fscanf\(inputFile)o(,)c("\045d)k │ │ │ │ │ -(\045d",)g(&nrow,)f(&nrhs\))g(;)0 888 y(mtxY)h(=)h(DenseMtx_new\(\))38 │ │ │ │ │ -b(;)0 988 y(DenseMtx_init\(mt)o(xY,)f(type,)k(0,)i(0,)g(nrow,)e(nrhs,)h │ │ │ │ │ -(1,)h(nrow\))e(;)0 1088 y(DenseMtx_rowIndi)o(ces)o(\(m)o(tx)o(Y,)c │ │ │ │ │ -(&nrow,)k(&rowind\))g(;)0 1187 y(if)i(\()g(type)f(==)h(SPOOLES_REAL)38 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)131 390 y Fp(----------------)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(---)0 490 y(*/)0 589 y(sprintf\(buffer,)37 b("rhs.\045d.input",)h │ │ │ │ │ +(myid\))j(;)0 689 y(inputFile)f(=)j(fopen\(buffer,)38 │ │ │ │ │ +b("r"\))k(;)0 789 y(fscanf\(inputFile)o(,)c("\045d)k(\045d",)g(&nrow,)f │ │ │ │ │ +(&nrhs\))g(;)0 888 y(mtxY)h(=)h(DenseMtx_new\(\))38 b(;)0 │ │ │ │ │ +988 y(DenseMtx_init\(mt)o(xY,)f(type,)k(0,)i(0,)g(nrow,)e(nrhs,)h(1,)h │ │ │ │ │ +(nrow\))e(;)0 1088 y(DenseMtx_rowIndi)o(ces)o(\(m)o(tx)o(Y,)c(&nrow,)k │ │ │ │ │ +(&rowind\))g(;)0 1187 y(if)i(\()g(type)f(==)h(SPOOLES_REAL)38 │ │ │ │ │ b(\))43 b({)131 1287 y(double)128 b(value)42 b(;)131 │ │ │ │ │ 1386 y(for)g(\()h(irow)f(=)h(0)h(;)f(irow)f(<)h(nrow)f(;)h(irow++)e(\)) │ │ │ │ │ i({)262 1486 y(fscanf\(inputFil)o(e,)37 b("\045d",)42 │ │ │ │ │ b(rowind)f(+)i(irow\))e(;)262 1586 y(for)h(\()h(jcol)f(=)h(0)g(;)g │ │ │ │ │ (jcol)f(<)i(nrhs)e(;)h(jcol++)e(\))i({)392 1685 y(fscanf\(inputFile,)37 │ │ │ │ │ b("\045le",)k(&value\))g(;)392 1785 y(DenseMtx_setRealE)o(nt)o(ry\()o │ │ │ │ │ (mt)o(xY,)c(irow,)k(jcol,)h(value\))f(;)262 1885 y(})131 │ │ │ │ │ @@ -11294,20 +11260,19 @@ │ │ │ │ │ 4973 y(nedges)k(=)i(IVL_tsize\(adjIVL\))37 b(;)0 5073 │ │ │ │ │ y(Graph_init2\(grap)o(h,)g(0,)43 b(neqns,)e(0,)i(nedges,)d(neqns,)i │ │ │ │ │ (nedges,)e(adjIVL,)523 5172 y(NULL,)i(NULL\))f(;)0 5272 │ │ │ │ │ y(if)i(\()g(msglvl)e(>)i(2)g(\))h({)131 5372 y(fprintf\(msgFile,)37 │ │ │ │ │ b("\\n\\n)k(graph)h(of)h(the)f(input)f(matrix"\))g(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 43 43 │ │ │ │ │ -TeXDict begin 43 42 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(43)131 390 │ │ │ │ │ -y Fp(Graph_writeForHu)o(ma)o(nE)o(ye\()o(gr)o(aph)o(,)37 │ │ │ │ │ -b(msgFile\))k(;)131 490 y(fflush\(msgFile\))c(;)0 589 │ │ │ │ │ -y(})0 689 y(frontETree)i(=)44 b(orderViaMMD\(gra)o(ph,)37 │ │ │ │ │ +TeXDict begin 43 42 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(43)131 390 y Fp(Graph_writeForHu)o(ma)o(nE)o │ │ │ │ │ +(ye\()o(gr)o(aph)o(,)37 b(msgFile\))k(;)131 490 y(fflush\(msgFile\))c │ │ │ │ │ +(;)0 589 y(})0 689 y(frontETree)i(=)44 b(orderViaMMD\(gra)o(ph,)37 │ │ │ │ │ b(seed)42 b(+)h(myid,)e(msglvl,)g(msgFile\))f(;)0 789 │ │ │ │ │ y(Graph_free\(graph)o(\))e(;)0 888 y(if)43 b(\()g(msglvl)e(>)i(2)g(\))h │ │ │ │ │ ({)131 988 y(fprintf\(msgFile,)37 b("\\n\\n)k(front)h(tree)g(from)g │ │ │ │ │ (ordering"\))d(;)131 1088 y(ETree_writeForHu)o(ma)o(nE)o(ye\()o(fr)o │ │ │ │ │ (ont)o(ET)o(ree)o(,)e(msgFile\))k(;)131 1187 y(fflush\(msgFile\))c(;)0 │ │ │ │ │ 1287 y(})0 1386 y(opcounts)j(=)j(DVinit\(nproc,)c(0.0\))j(;)0 │ │ │ │ │ 1486 y(opcounts[myid])c(=)43 b(ETree_nFactorOps)o(\(fr)o(on)o(tE)o(Tre) │ │ │ │ │ @@ -11354,19 +11319,19 @@ │ │ │ │ │ o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(-)131 5272 │ │ │ │ │ y(STEP)42 b(4:)g(generate)f(the)h(owners)f(map)i(IV)f(object)479 │ │ │ │ │ 5372 y(and)h(the)f(map)g(from)g(vertices)f(to)h(owners)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 44 44 │ │ │ │ │ TeXDict begin 44 43 bop 0 100 a Fu(44)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)131 390 │ │ │ │ │ -y Fp(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(-)0 490 y(*/)0 589 y(cutoff)128 b(=)43 b(1./\(2*nproc\))c │ │ │ │ │ -(;)0 689 y(cumopsDV)h(=)j(DV_new\(\))e(;)0 789 y(DV_init\(cumopsDV)o(,) │ │ │ │ │ -d(nproc,)j(NULL\))g(;)0 888 y(ownersIV)f(=)j(ETree_ddMap\(front)o(ETr)o │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)131 390 y Fp(----------------)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(-)0 │ │ │ │ │ +490 y(*/)0 589 y(cutoff)128 b(=)43 b(1./\(2*nproc\))c(;)0 │ │ │ │ │ +689 y(cumopsDV)h(=)j(DV_new\(\))e(;)0 789 y(DV_init\(cumopsDV)o(,)d │ │ │ │ │ +(nproc,)j(NULL\))g(;)0 888 y(ownersIV)f(=)j(ETree_ddMap\(front)o(ETr)o │ │ │ │ │ (ee)o(,)1002 988 y(type,)f(symmetryflag,)c(cumopsDV,)i(cutoff\))h(;)0 │ │ │ │ │ 1088 y(DV_free\(cumopsDV)o(\))d(;)0 1187 y(vtxmapIV)i(=)j(IV_new\(\))e │ │ │ │ │ (;)0 1287 y(IV_init\(vtxmapIV)o(,)d(neqns,)j(NULL\))g(;)0 │ │ │ │ │ 1386 y(IVgather\(neqns,)c(IV_entries\(vtxmap)o(IV\))o(,)392 │ │ │ │ │ 1486 y(IV_entries\(owners)o(IV)o(\),)g(ETree_vtxToFront\()o(fr)o(on)o │ │ │ │ │ (tET)o(re)o(e\)\))g(;)0 1586 y(if)43 b(\()g(msglvl)e(>)i(2)g(\))h({)131 │ │ │ │ │ 1685 y(fprintf\(msgFile,)37 b("\\n\\n)k(map)i(from)f(fronts)f(to)h │ │ │ │ │ @@ -11402,32 +11367,32 @@ │ │ │ │ │ 4873 y(fflush\(msgFile\))d(;)0 4973 y(})0 5073 y(/*--------------)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ 5172 y(/*)131 5272 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)131 5372 y(STEP)42 b(6:)g(compute)f(the)h │ │ │ │ │ (symbolic)f(factorization)p eop end │ │ │ │ │ %%Page: 45 45 │ │ │ │ │ -TeXDict begin 45 44 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(45)131 390 │ │ │ │ │ -y Fp(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)0 490 y(*/)0 589 y(symbfacIVL)39 b(=)44 b(SymbFac_MPI_ini)o │ │ │ │ │ -(tFr)o(om)o(Inp)o(Mt)o(x\()o(fro)o(nt)o(ETr)o(ee)o(,)37 │ │ │ │ │ -b(ownersIV,)j(mtxA,)915 689 y(stats,)h(msglvl,)g(msgFile,)f(firsttag,)g │ │ │ │ │ -(MPI_COMM_WORLD\))e(;)0 789 y(firsttag)i(+=)j(frontETree->nfro)o(nt)37 │ │ │ │ │ -b(;)0 888 y(if)43 b(\()g(msglvl)e(>)i(2)g(\))h({)131 │ │ │ │ │ -988 y(fprintf\(msgFile,)37 b("\\n\\n)k(local)h(symbolic)e │ │ │ │ │ -(factorization"\))d(;)131 1088 y(IVL_writeForHuma)o(nE)o(ye)o(\(sy)o │ │ │ │ │ -(mb)o(fac)o(IV)o(L,)g(msgFile\))j(;)131 1187 y(fflush\(msgFile\))d(;)0 │ │ │ │ │ -1287 y(})0 1386 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(-*/)0 1486 y(/*)131 1586 y(----------------)o(--)o(--) │ │ │ │ │ -o(---)o(--)o(---)o(--)o(---)o(--)131 1685 y(STEP)42 b(7:)g(initialize)e │ │ │ │ │ -(the)i(front)g(matrix)131 1785 y(----------------)o(--)o(--)o(---)o(--) │ │ │ │ │ -o(---)o(--)o(---)o(--)0 1885 y(*/)0 1984 y(mtxmanager)d(=)44 │ │ │ │ │ +TeXDict begin 45 44 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(45)131 390 y Fp(----------------)o(--)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)0 490 │ │ │ │ │ +y(*/)0 589 y(symbfacIVL)39 b(=)44 b(SymbFac_MPI_ini)o(tFr)o(om)o(Inp)o │ │ │ │ │ +(Mt)o(x\()o(fro)o(nt)o(ETr)o(ee)o(,)37 b(ownersIV,)j(mtxA,)915 │ │ │ │ │ +689 y(stats,)h(msglvl,)g(msgFile,)f(firsttag,)g(MPI_COMM_WORLD\))e(;)0 │ │ │ │ │ +789 y(firsttag)i(+=)j(frontETree->nfro)o(nt)37 b(;)0 │ │ │ │ │ +888 y(if)43 b(\()g(msglvl)e(>)i(2)g(\))h({)131 988 y(fprintf\(msgFile,) │ │ │ │ │ +37 b("\\n\\n)k(local)h(symbolic)e(factorization"\))d(;)131 │ │ │ │ │ +1088 y(IVL_writeForHuma)o(nE)o(ye)o(\(sy)o(mb)o(fac)o(IV)o(L,)g │ │ │ │ │ +(msgFile\))j(;)131 1187 y(fflush\(msgFile\))d(;)0 1287 │ │ │ │ │ +y(})0 1386 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(-*/)0 1486 y(/*)131 1586 y(----------------)o(--)o(--)o(---) │ │ │ │ │ +o(--)o(---)o(--)o(---)o(--)131 1685 y(STEP)42 b(7:)g(initialize)e(the)i │ │ │ │ │ +(front)g(matrix)131 1785 y(----------------)o(--)o(--)o(---)o(--)o(---) │ │ │ │ │ +o(--)o(---)o(--)0 1885 y(*/)0 1984 y(mtxmanager)d(=)44 │ │ │ │ │ b(SubMtxManager_n)o(ew\()o(\))37 b(;)0 2084 y(SubMtxManager_in)o(it\()o │ │ │ │ │ (mt)o(xm)o(ana)o(ge)o(r,)g(NO_LOCK,)j(0\))j(;)0 2183 │ │ │ │ │ y(frontmtx)d(=)j(FrontMtx_new\(\))38 b(;)0 2283 y(FrontMtx_init\(fr)o │ │ │ │ │ (ont)o(mt)o(x,)f(frontETree,)i(symbfacIVL,)g(type,)j(symmetryflag,)610 │ │ │ │ │ 2383 y(FRONTMTX_DENSE_FR)o(ON)o(TS,)37 b(pivotingflag,)h(NO_LOCK,)i │ │ │ │ │ (myid,)610 2482 y(ownersIV,)g(mtxmanager,)f(msglvl,)i(msgFile\))f(;)0 │ │ │ │ │ 2582 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ @@ -11457,37 +11422,37 @@ │ │ │ │ │ o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(-)131 │ │ │ │ │ 5272 y(STEP)i(9:)g(post-process)d(the)j(factorization)d(and)j(split)131 │ │ │ │ │ 5372 y(the)g(factor)f(matrices)f(into)i(submatrices)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 46 46 │ │ │ │ │ TeXDict begin 46 45 bop 0 100 a Fu(46)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)131 390 │ │ │ │ │ -y Fp(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(---)o(--)o(-)0 490 y(*/)0 589 y(FrontMtx_MPI_pos)o(tPr)o │ │ │ │ │ -(oc)o(es)o(s\(f)o(ro)o(ntm)o(tx)o(,)38 b(ownersIV,)h(stats,)i(msglvl,) │ │ │ │ │ -1090 689 y(msgFile,)f(firsttag,)g(MPI_COMM_WORLD\))d(;)0 │ │ │ │ │ -789 y(firsttag)j(+=)j(5*nproc)e(;)0 888 y(if)i(\()g(msglvl)e(>)i(2)g │ │ │ │ │ -(\))h({)131 988 y(fprintf\(msgFile,)37 b("\\n\\n)k(numeric)g │ │ │ │ │ -(factorization)d(after)k(post-processing)o("\);)131 1088 │ │ │ │ │ -y(FrontMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(fr)o(on)o(tmt)o(x,)37 │ │ │ │ │ -b(msgFile\))j(;)131 1187 y(fflush\(msgFile\))d(;)0 1287 │ │ │ │ │ -y(})0 1386 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(-*/)0 1486 y(/*)131 1586 y(----------------)o(--)o(--)o(---) │ │ │ │ │ -o(--)o(---)o(--)o(---)o(--)131 1685 y(STEP)42 b(10:)g(create)f(the)h │ │ │ │ │ -(solve)g(map)g(object)131 1785 y(----------------)o(--)o(--)o(---)o(--) │ │ │ │ │ -o(---)o(--)o(---)o(--)0 1885 y(*/)0 1984 y(solvemap)e(=)j │ │ │ │ │ -(SolveMap_new\(\))38 b(;)0 2084 y(SolveMap_ddMap\(s)o(olv)o(em)o(ap)o │ │ │ │ │ -(,)g(symmetryflag,)654 2183 y(FrontMtx_upperBl)o(oc)o(kIV)o(L\()o(fr)o │ │ │ │ │ -(ont)o(mt)o(x\),)654 2283 y(FrontMtx_lowerBl)o(oc)o(kIV)o(L\()o(fr)o │ │ │ │ │ -(ont)o(mt)o(x\),)654 2383 y(nproc,)j(ownersIV,)f(FrontMtx_frontTr)o(ee) │ │ │ │ │ -o(\(f)o(ron)o(tm)o(tx\))o(,)654 2482 y(seed,)h(msglvl,)g(msgFile\);)0 │ │ │ │ │ -2582 y(if)i(\()g(msglvl)e(>)i(3)g(\))h({)131 2682 y(SolveMap_writeFo)o │ │ │ │ │ -(rH)o(um)o(anE)o(ye)o(\(so)o(lv)o(ema)o(p,)37 b(msgFile\))j(;)131 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)131 390 y Fp(----------------)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(-)0 490 y(*/)0 589 y(FrontMtx_MPI_pos)o(tPr)o(oc)o(es)o(s\(f)o(ro)o │ │ │ │ │ +(ntm)o(tx)o(,)38 b(ownersIV,)h(stats,)i(msglvl,)1090 │ │ │ │ │ +689 y(msgFile,)f(firsttag,)g(MPI_COMM_WORLD\))d(;)0 789 │ │ │ │ │ +y(firsttag)j(+=)j(5*nproc)e(;)0 888 y(if)i(\()g(msglvl)e(>)i(2)g(\))h │ │ │ │ │ +({)131 988 y(fprintf\(msgFile,)37 b("\\n\\n)k(numeric)g(factorization)d │ │ │ │ │ +(after)k(post-processing)o("\);)131 1088 y(FrontMtx_writeFo)o(rH)o(um)o │ │ │ │ │ +(anE)o(ye)o(\(fr)o(on)o(tmt)o(x,)37 b(msgFile\))j(;)131 │ │ │ │ │ +1187 y(fflush\(msgFile\))d(;)0 1287 y(})0 1386 y(/*--------------)o │ │ │ │ │ +(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ +1486 y(/*)131 1586 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)131 1685 y(STEP)42 b(10:)g(create)f(the)h(solve)g(map)g │ │ │ │ │ +(object)131 1785 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)0 1885 y(*/)0 1984 y(solvemap)e(=)j(SolveMap_new\(\))38 │ │ │ │ │ +b(;)0 2084 y(SolveMap_ddMap\(s)o(olv)o(em)o(ap)o(,)g(symmetryflag,)654 │ │ │ │ │ +2183 y(FrontMtx_upperBl)o(oc)o(kIV)o(L\()o(fr)o(ont)o(mt)o(x\),)654 │ │ │ │ │ +2283 y(FrontMtx_lowerBl)o(oc)o(kIV)o(L\()o(fr)o(ont)o(mt)o(x\),)654 │ │ │ │ │ +2383 y(nproc,)j(ownersIV,)f(FrontMtx_frontTr)o(ee)o(\(f)o(ron)o(tm)o │ │ │ │ │ +(tx\))o(,)654 2482 y(seed,)h(msglvl,)g(msgFile\);)0 2582 │ │ │ │ │ +y(if)i(\()g(msglvl)e(>)i(3)g(\))h({)131 2682 y(SolveMap_writeFo)o(rH)o │ │ │ │ │ +(um)o(anE)o(ye)o(\(so)o(lv)o(ema)o(p,)37 b(msgFile\))j(;)131 │ │ │ │ │ 2781 y(fflush\(msgFile\))d(;)0 2881 y(})0 2980 y(/*--------------)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ 3080 y(/*)131 3180 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)131 3279 │ │ │ │ │ y(STEP)42 b(11:)g(redistribute)d(the)j(submatrices)d(of)k(the)f │ │ │ │ │ (factors)131 3379 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ @@ -11509,27 +11474,26 @@ │ │ │ │ │ b(\))43 b({)131 4973 y(IV)130 b(*rowmapIV)40 b(;)0 5073 │ │ │ │ │ y(/*)131 5172 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---) │ │ │ │ │ o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(-)131 │ │ │ │ │ 5272 y(pivoting)g(has)i(taken)g(place,)f(redistribute)e(the)j(right)f │ │ │ │ │ (hand)h(side)131 5372 y(to)h(match)e(the)h(final)g(rows)g(and)g │ │ │ │ │ (columns)f(in)i(the)f(fronts)p eop end │ │ │ │ │ %%Page: 47 47 │ │ │ │ │ -TeXDict begin 47 46 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(47)131 390 │ │ │ │ │ -y Fp(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(-)0 490 │ │ │ │ │ -y(*/)131 589 y(rowmapIV)40 b(=)j(FrontMtx_MPI_rowm)o(ap)o(IV\()o(fr)o │ │ │ │ │ -(on)o(tmt)o(x,)37 b(ownersIV,)j(msglvl,)1569 689 y(msgFile,)g │ │ │ │ │ -(MPI_COMM_WORLD\))e(;)131 789 y(newY)k(=)h(DenseMtx_MPI_spl)o(it)o(ByR) │ │ │ │ │ -o(ow)o(s\(m)o(tx)o(Y,)37 b(rowmapIV,)j(stats,)h(msglvl,)1526 │ │ │ │ │ -888 y(msgFile,)f(firsttag,)g(MPI_COMM_WORLD\))d(;)131 │ │ │ │ │ -988 y(DenseMtx_free\(mt)o(xY)o(\))g(;)131 1088 y(mtxY)42 │ │ │ │ │ -b(=)h(newY)f(;)131 1187 y(IV_free\(rowmapIV)o(\))37 b(;)0 │ │ │ │ │ -1287 y(})0 1386 y(if)43 b(\()g(msglvl)e(>)i(2)g(\))h({)131 │ │ │ │ │ +TeXDict begin 47 46 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(47)131 390 y Fp(----------------)o(--)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(-)0 490 y(*/)131 589 y(rowmapIV)40 b(=)j(FrontMtx_MPI_rowm) │ │ │ │ │ +o(ap)o(IV\()o(fr)o(on)o(tmt)o(x,)37 b(ownersIV,)j(msglvl,)1569 │ │ │ │ │ +689 y(msgFile,)g(MPI_COMM_WORLD\))e(;)131 789 y(newY)k(=)h │ │ │ │ │ +(DenseMtx_MPI_spl)o(it)o(ByR)o(ow)o(s\(m)o(tx)o(Y,)37 │ │ │ │ │ +b(rowmapIV,)j(stats,)h(msglvl,)1526 888 y(msgFile,)f(firsttag,)g │ │ │ │ │ +(MPI_COMM_WORLD\))d(;)131 988 y(DenseMtx_free\(mt)o(xY)o(\))g(;)131 │ │ │ │ │ +1088 y(mtxY)42 b(=)h(newY)f(;)131 1187 y(IV_free\(rowmapIV)o(\))37 │ │ │ │ │ +b(;)0 1287 y(})0 1386 y(if)43 b(\()g(msglvl)e(>)i(2)g(\))h({)131 │ │ │ │ │ 1486 y(fprintf\(msgFile,)37 b("\\n\\n)k(rhs)i(matrix)e(after)g │ │ │ │ │ (split"\))g(;)131 1586 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(mt)o │ │ │ │ │ (xY)o(,)d(msgFile\))i(;)131 1685 y(fflush\(msgFile\))d(;)0 │ │ │ │ │ 1785 y(})0 1885 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(-*/)0 1984 y(/*)131 2084 y(----------------)o(--)o(--) │ │ │ │ │ o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)131 │ │ │ │ │ @@ -11569,50 +11533,50 @@ │ │ │ │ │ (ordering)523 5272 y(and)i(assemble)f(the)h(solution)e(onto)i │ │ │ │ │ (processor)e(zero)131 5372 y(----------------)o(--)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(--)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 48 48 │ │ │ │ │ TeXDict begin 48 47 bop 0 100 a Fu(48)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fp(*/)0 490 y(DenseMtx_permute)o(Row)o(s\()o(mt)o(xX,)37 │ │ │ │ │ -b(newToOldIV\))i(;)0 589 y(if)k(\()g(msglvl)e(>)i(2)g(\))h({)131 │ │ │ │ │ -689 y(fprintf\(msgFile,)37 b("\\n\\n)k(solution)g(in)h(old)h │ │ │ │ │ -(ordering"\))c(;)131 789 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o │ │ │ │ │ -(\(mt)o(xX)o(,)f(msgFile\))i(;)131 888 y(fflush\(msgFile\))d(;)0 │ │ │ │ │ -988 y(})0 1088 y(IV_fill\(vtxmapIV)o(,)h(0\))k(;)0 1187 │ │ │ │ │ -y(firsttag++)d(;)0 1287 y(mtxX)j(=)h(DenseMtx_MPI_spl)o(itB)o(yR)o(ows) │ │ │ │ │ -o(\(m)o(txX)o(,)37 b(vtxmapIV,)j(stats,)h(msglvl,)g(msgFile,)1395 │ │ │ │ │ -1386 y(firsttag,)f(MPI_COMM_WORLD\))d(;)0 1486 y(if)43 │ │ │ │ │ -b(\()g(myid)f(==)h(0)g(&&)g(msglvl)e(>)i(0)g(\))g({)131 │ │ │ │ │ -1586 y(fprintf\(msgFile,)37 b("\\n\\n)k(complete)g(solution)f(in)j(old) │ │ │ │ │ -f(ordering"\))d(;)131 1685 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o │ │ │ │ │ -(\(mt)o(xX)o(,)f(msgFile\))i(;)131 1785 y(fflush\(msgFile\))d(;)0 │ │ │ │ │ -1885 y(})0 1984 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(-*/)0 2084 y(MPI_Finalize\(\))h(;)0 │ │ │ │ │ -2283 y(return\(1\))i(;)j(})0 2383 y(/*--------------)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(---)o(--)o(--)o(-*/)p eop end │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fp(*/)0 │ │ │ │ │ +490 y(DenseMtx_permute)o(Row)o(s\()o(mt)o(xX,)37 b(newToOldIV\))i(;)0 │ │ │ │ │ +589 y(if)k(\()g(msglvl)e(>)i(2)g(\))h({)131 689 y(fprintf\(msgFile,)37 │ │ │ │ │ +b("\\n\\n)k(solution)g(in)h(old)h(ordering"\))c(;)131 │ │ │ │ │ +789 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(mt)o(xX)o(,)f │ │ │ │ │ +(msgFile\))i(;)131 888 y(fflush\(msgFile\))d(;)0 988 │ │ │ │ │ +y(})0 1088 y(IV_fill\(vtxmapIV)o(,)h(0\))k(;)0 1187 y(firsttag++)d(;)0 │ │ │ │ │ +1287 y(mtxX)j(=)h(DenseMtx_MPI_spl)o(itB)o(yR)o(ows)o(\(m)o(txX)o(,)37 │ │ │ │ │ +b(vtxmapIV,)j(stats,)h(msglvl,)g(msgFile,)1395 1386 y(firsttag,)f │ │ │ │ │ +(MPI_COMM_WORLD\))d(;)0 1486 y(if)43 b(\()g(myid)f(==)h(0)g(&&)g │ │ │ │ │ +(msglvl)e(>)i(0)g(\))g({)131 1586 y(fprintf\(msgFile,)37 │ │ │ │ │ +b("\\n\\n)k(complete)g(solution)f(in)j(old)f(ordering"\))d(;)131 │ │ │ │ │ +1685 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o(\(mt)o(xX)o(,)f │ │ │ │ │ +(msgFile\))i(;)131 1785 y(fflush\(msgFile\))d(;)0 1885 │ │ │ │ │ +y(})0 1984 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(-*/)0 2084 y(MPI_Finalize\(\))h(;)0 2283 y(return\(1\))i(;)j │ │ │ │ │ +(})0 2383 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(--)o(-*/)p eop end │ │ │ │ │ %%Page: 49 49 │ │ │ │ │ -TeXDict begin 49 48 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(49)0 390 │ │ │ │ │ -y Fr(D)135 b Fa(allInOne.c)40 b Fr({)45 b(A)f(Serial)i │ │ │ │ │ -Fj(QR)g Fr(Driv)l(er)f(Program)0 625 y Fp(/*)86 b(QRallInOne.c)d(*/)0 │ │ │ │ │ -824 y(#include)40 b("../../misc.h")0 924 y(#include)g │ │ │ │ │ -("../../FrontMtx.h)o(")0 1024 y(#include)g("../../SymbFac.h")0 │ │ │ │ │ -1223 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(--)o(-*/)0 1322 y(int)0 1422 y(main)i(\()h(int)f(argc,)g(char)g │ │ │ │ │ -(*argv[])f(\))i({)0 1522 y(/*)131 1621 y(----------------)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(-)131 │ │ │ │ │ -1721 y(QR)g(all-in-one)c(program)131 1821 y(\(1\))j(read)g(in)h(matrix) │ │ │ │ │ -e(entries)g(and)h(form)g(InpMtx)f(object)305 1920 y(of)i(A)g(and)f │ │ │ │ │ -(A^TA)131 2020 y(\(2\))g(form)g(Graph)g(object)f(of)h(A^TA)131 │ │ │ │ │ +TeXDict begin 49 48 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(49)0 390 y Fr(D)135 b Fa(allInOne.c)40 │ │ │ │ │ +b Fr({)45 b(A)f(Serial)i Fj(QR)g Fr(Driv)l(er)f(Program)0 │ │ │ │ │ +625 y Fp(/*)86 b(QRallInOne.c)d(*/)0 824 y(#include)40 │ │ │ │ │ +b("../../misc.h")0 924 y(#include)g("../../FrontMtx.h)o(")0 │ │ │ │ │ +1024 y(#include)g("../../SymbFac.h")0 1223 y(/*--------------)o(---)o │ │ │ │ │ +(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 1322 │ │ │ │ │ +y(int)0 1422 y(main)i(\()h(int)f(argc,)g(char)g(*argv[])f(\))i({)0 │ │ │ │ │ +1522 y(/*)131 1621 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(-)131 1721 │ │ │ │ │ +y(QR)g(all-in-one)c(program)131 1821 y(\(1\))j(read)g(in)h(matrix)e │ │ │ │ │ +(entries)g(and)h(form)g(InpMtx)f(object)305 1920 y(of)i(A)g(and)f(A^TA) │ │ │ │ │ +131 2020 y(\(2\))g(form)g(Graph)g(object)f(of)h(A^TA)131 │ │ │ │ │ 2120 y(\(3\))g(order)g(matrix)f(and)h(form)g(front)g(tree)131 │ │ │ │ │ 2219 y(\(4\))g(get)g(the)h(permutation,)38 b(permute)j(the)h(matrix)g │ │ │ │ │ (and)305 2319 y(front)g(tree)g(and)g(get)g(the)h(symbolic)d │ │ │ │ │ (factorization)131 2418 y(\(5\))i(compute)f(the)h(numeric)f │ │ │ │ │ (factorization)131 2518 y(\(6\))h(read)g(in)h(right)e(hand)h(side)g │ │ │ │ │ (entries)131 2618 y(\(7\))g(compute)f(the)h(solution)131 │ │ │ │ │ 2817 y(created)e(--)j(98jun11,)d(cca)131 2917 y(----------------)o(--)o │ │ │ │ │ @@ -11637,24 +11601,23 @@ │ │ │ │ │ (-*/)0 4809 y(/*)131 4909 y(----------------)o(--)o(--)131 │ │ │ │ │ 5009 y(get)j(input)g(parameters)131 5108 y(----------------)o(--)o(--)0 │ │ │ │ │ 5208 y(*/)0 5308 y(if)h(\()g(argc)f(!=)h(7)g(\))g({)131 │ │ │ │ │ 5407 y(fprintf\(stdout,)p eop end │ │ │ │ │ %%Page: 50 50 │ │ │ │ │ TeXDict begin 50 49 bop 0 100 a Fu(50)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)262 390 │ │ │ │ │ -y Fp("\\n)42 b(usage:)f(\045s)i(msglvl)e(msgFile)g(type)g │ │ │ │ │ -(matrixFileName)d(rhsFileName)h(seed")262 490 y("\\n)173 │ │ │ │ │ -b(msglvl)41 b(--)h(message)f(level")262 589 y("\\n)173 │ │ │ │ │ -b(msgFile)40 b(--)j(message)e(file")262 689 y("\\n)173 │ │ │ │ │ -b(type)f(--)43 b(type)f(of)h(entries")262 789 y("\\n)260 │ │ │ │ │ -b(1)43 b(\(SPOOLES_REAL\))169 b(--)42 b(real)g(entries")262 │ │ │ │ │ -888 y("\\n)260 b(2)43 b(\(SPOOLES_COMPLEX)o(\))38 b(--)k(complex)f │ │ │ │ │ -(entries")262 988 y("\\n)173 b(matrixFileName)37 b(--)43 │ │ │ │ │ -b(matrix)e(file)h(name,)g(format")262 1088 y("\\n)303 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)262 390 y Fp("\\n)42 │ │ │ │ │ +b(usage:)f(\045s)i(msglvl)e(msgFile)g(type)g(matrixFileName)d │ │ │ │ │ +(rhsFileName)h(seed")262 490 y("\\n)173 b(msglvl)41 b(--)h(message)f │ │ │ │ │ +(level")262 589 y("\\n)173 b(msgFile)40 b(--)j(message)e(file")262 │ │ │ │ │ +689 y("\\n)173 b(type)f(--)43 b(type)f(of)h(entries")262 │ │ │ │ │ +789 y("\\n)260 b(1)43 b(\(SPOOLES_REAL\))169 b(--)42 │ │ │ │ │ +b(real)g(entries")262 888 y("\\n)260 b(2)43 b(\(SPOOLES_COMPLEX)o(\))38 │ │ │ │ │ +b(--)k(complex)f(entries")262 988 y("\\n)173 b(matrixFileName)37 │ │ │ │ │ +b(--)43 b(matrix)e(file)h(name,)g(format")262 1088 y("\\n)303 │ │ │ │ │ b(nrow)42 b(ncol)g(nent")262 1187 y("\\n)303 b(irow)42 │ │ │ │ │ b(jcol)g(entry")262 1287 y("\\n)347 b(...")262 1386 y("\\n)g(note:)41 │ │ │ │ │ b(indices)g(are)i(zero)e(based")262 1486 y("\\n)173 b(rhsFileName)39 │ │ │ │ │ b(--)j(right)g(hand)g(side)g(file)g(name,)f(format")262 │ │ │ │ │ 1586 y("\\n)303 b(nrow)42 b(")262 1685 y("\\n)303 b(entry[0]")262 │ │ │ │ │ 1785 y("\\n)g(...")262 1885 y("\\n)g(entry[nrow-1]")262 │ │ │ │ │ 1984 y("\\n)173 b(seed)42 b(--)g(random)f(number)h(seed,)f(used)h(for)g │ │ │ │ │ @@ -11686,23 +11649,23 @@ │ │ │ │ │ (ient++)e(\))i({)262 4973 y(fscanf\(inputFil)o(e,)37 │ │ │ │ │ b("\045d)42 b(\045d)h(\045le",)f(&irow,)f(&jcol,)g(&value\))g(;)262 │ │ │ │ │ 5073 y(InpMtx_inputRea)o(lE)o(ntr)o(y\()o(mtx)o(A,)c(irow,)k(jcol,)h │ │ │ │ │ (value\))f(;)131 5172 y(})0 5272 y(})i(else)f({)131 5372 │ │ │ │ │ y(for)g(\()h(ient)f(=)h(0)h(;)f(ient)f(<)h(nent)f(;)h(ient++)e(\))i({)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 51 51 │ │ │ │ │ -TeXDict begin 51 50 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(51)262 390 │ │ │ │ │ -y Fp(fscanf\(inputFil)o(e,)37 b("\045d)42 b(\045d)h(\045le)g(\045le",)e │ │ │ │ │ -(&irow,)g(&jcol,)g(&real,)g(&imag\))g(;)262 490 y(InpMtx_inputCom)o(pl) │ │ │ │ │ -o(exE)o(nt)o(ry\()o(mt)o(xA,)c(irow,)k(jcol,)h(real,)f(imag\))h(;)131 │ │ │ │ │ -589 y(})0 689 y(})0 789 y(fclose\(inputFile)o(\))c(;)0 │ │ │ │ │ -888 y(if)43 b(\()g(msglvl)e(>)i(1)g(\))h({)131 988 y(fprintf\(msgFile,) │ │ │ │ │ -37 b("\\n\\n)k(input)h(matrix"\))e(;)131 1088 y(InpMtx_writeForH)o(um)o │ │ │ │ │ +TeXDict begin 51 50 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(51)262 390 y Fp(fscanf\(inputFil)o(e,)37 │ │ │ │ │ +b("\045d)42 b(\045d)h(\045le)g(\045le",)e(&irow,)g(&jcol,)g(&real,)g │ │ │ │ │ +(&imag\))g(;)262 490 y(InpMtx_inputCom)o(pl)o(exE)o(nt)o(ry\()o(mt)o │ │ │ │ │ +(xA,)c(irow,)k(jcol,)h(real,)f(imag\))h(;)131 589 y(})0 │ │ │ │ │ +689 y(})0 789 y(fclose\(inputFile)o(\))c(;)0 888 y(if)43 │ │ │ │ │ +b(\()g(msglvl)e(>)i(1)g(\))h({)131 988 y(fprintf\(msgFile,)37 │ │ │ │ │ +b("\\n\\n)k(input)h(matrix"\))e(;)131 1088 y(InpMtx_writeForH)o(um)o │ │ │ │ │ (an)o(Eye)o(\(m)o(txA)o(,)d(msgFile\))k(;)131 1187 y(fflush\(msgFile\)) │ │ │ │ │ c(;)0 1287 y(})0 1386 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(---)o(--)o(--)o(-*/)0 1486 y(/*)131 1586 y(----------------)o(--) │ │ │ │ │ o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)131 │ │ │ │ │ 1685 y(STEP)42 b(2:)g(read)g(the)h(right)e(hand)h(side)g(entries)131 │ │ │ │ │ 1785 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ @@ -11738,37 +11701,36 @@ │ │ │ │ │ 5172 y(\(1\))i(create)f(the)i(Graph)e(object)g(for)i(A^TA)e(or)i(A^HA) │ │ │ │ │ 131 5272 y(\(2\))f(order)g(the)g(graph)f(using)h(multiple)e(minimum)h │ │ │ │ │ (degree)131 5372 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)p eop end │ │ │ │ │ %%Page: 52 52 │ │ │ │ │ TeXDict begin 52 51 bop 0 100 a Fu(52)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fp(*/)0 490 y(graph)42 b(=)h(Graph_new\(\))c(;)0 589 │ │ │ │ │ -y(adjIVL)i(=)i(InpMtx_adjForATA\()o(mt)o(xA\))37 b(;)0 │ │ │ │ │ -689 y(nedges)k(=)i(IVL_tsize\(adjIVL\))37 b(;)0 789 y │ │ │ │ │ -(Graph_init2\(grap)o(h,)g(0,)43 b(neqns,)e(0,)i(nedges,)d(neqns,)i │ │ │ │ │ -(nedges,)e(adjIVL,)523 888 y(NULL,)i(NULL\))f(;)0 988 │ │ │ │ │ -y(if)i(\()g(msglvl)e(>)i(1)g(\))h({)131 1088 y(fprintf\(msgFile,)37 │ │ │ │ │ -b("\\n\\n)k(graph)h(of)h(A^T)f(A"\))g(;)131 1187 y(Graph_writeForHu)o │ │ │ │ │ -(ma)o(nE)o(ye\()o(gr)o(aph)o(,)37 b(msgFile\))k(;)131 │ │ │ │ │ -1287 y(fflush\(msgFile\))c(;)0 1386 y(})0 1486 y(frontETree)i(=)44 │ │ │ │ │ -b(orderViaMMD\(gra)o(ph,)37 b(seed,)k(msglvl,)g(msgFile\))f(;)0 │ │ │ │ │ -1586 y(if)j(\()g(msglvl)e(>)i(1)g(\))h({)131 1685 y(fprintf\(msgFile,) │ │ │ │ │ -37 b("\\n\\n)k(front)h(tree)g(from)g(ordering"\))d(;)131 │ │ │ │ │ -1785 y(ETree_writeForHu)o(ma)o(nE)o(ye\()o(fr)o(ont)o(ET)o(ree)o(,)e │ │ │ │ │ -(msgFile\))k(;)131 1885 y(fflush\(msgFile\))c(;)0 1984 │ │ │ │ │ -y(})0 2084 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(--)o(-*/)0 2183 y(/*)131 2283 y(----------------)o(--)o(--)o(---) │ │ │ │ │ -o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(-) │ │ │ │ │ -131 2383 y(STEP)42 b(4:)g(get)h(the)f(permutation,)d(permute)h(the)j │ │ │ │ │ -(matrix)e(and)479 2482 y(front)h(tree)g(and)g(get)h(the)f(symbolic)e │ │ │ │ │ -(factorization)131 2582 y(----------------)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(-)0 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fp(*/)0 │ │ │ │ │ +490 y(graph)42 b(=)h(Graph_new\(\))c(;)0 589 y(adjIVL)i(=)i │ │ │ │ │ +(InpMtx_adjForATA\()o(mt)o(xA\))37 b(;)0 689 y(nedges)k(=)i │ │ │ │ │ +(IVL_tsize\(adjIVL\))37 b(;)0 789 y(Graph_init2\(grap)o(h,)g(0,)43 │ │ │ │ │ +b(neqns,)e(0,)i(nedges,)d(neqns,)i(nedges,)e(adjIVL,)523 │ │ │ │ │ +888 y(NULL,)i(NULL\))f(;)0 988 y(if)i(\()g(msglvl)e(>)i(1)g(\))h({)131 │ │ │ │ │ +1088 y(fprintf\(msgFile,)37 b("\\n\\n)k(graph)h(of)h(A^T)f(A"\))g(;)131 │ │ │ │ │ +1187 y(Graph_writeForHu)o(ma)o(nE)o(ye\()o(gr)o(aph)o(,)37 │ │ │ │ │ +b(msgFile\))k(;)131 1287 y(fflush\(msgFile\))c(;)0 1386 │ │ │ │ │ +y(})0 1486 y(frontETree)i(=)44 b(orderViaMMD\(gra)o(ph,)37 │ │ │ │ │ +b(seed,)k(msglvl,)g(msgFile\))f(;)0 1586 y(if)j(\()g(msglvl)e(>)i(1)g │ │ │ │ │ +(\))h({)131 1685 y(fprintf\(msgFile,)37 b("\\n\\n)k(front)h(tree)g │ │ │ │ │ +(from)g(ordering"\))d(;)131 1785 y(ETree_writeForHu)o(ma)o(nE)o(ye\()o │ │ │ │ │ +(fr)o(ont)o(ET)o(ree)o(,)e(msgFile\))k(;)131 1885 y(fflush\(msgFile\))c │ │ │ │ │ +(;)0 1984 y(})0 2084 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(--)o(--)o(-*/)0 2183 y(/*)131 2283 y(----------------)o(--) │ │ │ │ │ +o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ +(---)o(-)131 2383 y(STEP)42 b(4:)g(get)h(the)f(permutation,)d(permute)h │ │ │ │ │ +(the)j(matrix)e(and)479 2482 y(front)h(tree)g(and)g(get)h(the)f │ │ │ │ │ +(symbolic)e(factorization)131 2582 y(----------------)o(--)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(-)0 │ │ │ │ │ 2682 y(*/)0 2781 y(oldToNewIV)f(=)44 b(ETree_oldToNewV)o(txP)o(er)o │ │ │ │ │ (m\(f)o(ro)o(nt)o(ETr)o(ee)o(\))38 b(;)0 2881 y(newToOldIV)h(=)44 │ │ │ │ │ b(ETree_newToOldV)o(txP)o(er)o(m\(f)o(ro)o(nt)o(ETr)o(ee)o(\))38 │ │ │ │ │ b(;)0 2980 y(InpMtx_permute\(m)o(txA)o(,)f(NULL,)42 b │ │ │ │ │ (IV_entries\(oldTo)o(Ne)o(wIV)o(\)\))37 b(;)0 3080 y(InpMtx_changeSto)o │ │ │ │ │ (rag)o(eM)o(od)o(e\(m)o(tx)o(A,)g(INPMTX_BY_VECTORS)o(\))g(;)0 │ │ │ │ │ 3180 y(symbfacIVL)i(=)44 b(SymbFac_initFro)o(mGr)o(ap)o(h\(f)o(ro)o(nt) │ │ │ │ │ @@ -11793,36 +11755,36 @@ │ │ │ │ │ (--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(-*/)0 4973 y(/*)131 5073 y(----------------)o(--)o(--) │ │ │ │ │ o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)131 │ │ │ │ │ 5172 y(STEP)42 b(5:)g(initialize)e(the)i(front)g(matrix)f(object)131 │ │ │ │ │ 5272 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)0 5372 y(*/)p eop end │ │ │ │ │ %%Page: 53 53 │ │ │ │ │ -TeXDict begin 53 52 bop 0 100 a Fs(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1138 4 v 1301 w Ft(SPOOLES)k(2.2)26 │ │ │ │ │ -b Fs(|)i(Solving)f(Linear)f(Systems)328 b Fu(53)0 390 │ │ │ │ │ -y Fp(frontmtx)40 b(=)j(FrontMtx_new\(\))38 b(;)0 490 │ │ │ │ │ -y(mtxmanager)h(=)44 b(SubMtxManager_n)o(ew\()o(\))37 │ │ │ │ │ -b(;)0 589 y(SubMtxManager_in)o(it\()o(mt)o(xm)o(ana)o(ge)o(r,)g │ │ │ │ │ -(NO_LOCK,)j(0\))j(;)0 689 y(if)g(\()g(type)f(==)h(SPOOLES_REAL)38 │ │ │ │ │ -b(\))43 b({)131 789 y(FrontMtx_init\(fr)o(on)o(tm)o(tx,)37 │ │ │ │ │ -b(frontETree,)i(symbfacIVL,)g(type,)741 888 y(SPOOLES_SYMMETRI)o(C,)e │ │ │ │ │ -(FRONTMTX_DENSE_F)o(RON)o(TS)o(,)741 988 y(SPOOLES_NO_PIVOT)o(ING)o(,)g │ │ │ │ │ -(NO_LOCK,)k(0,)h(NULL,)741 1088 y(mtxmanager,)d(msglvl,)i(msgFile\))f │ │ │ │ │ -(;)0 1187 y(})j(else)f({)131 1287 y(FrontMtx_init\(fr)o(on)o(tm)o(tx,) │ │ │ │ │ -37 b(frontETree,)i(symbfacIVL,)g(type,)741 1386 y(SPOOLES_HERMITIA)o │ │ │ │ │ -(N,)e(FRONTMTX_DENSE_F)o(RON)o(TS)o(,)741 1486 y(SPOOLES_NO_PIVOT)o │ │ │ │ │ -(ING)o(,)g(NO_LOCK,)k(0,)h(NULL,)741 1586 y(mtxmanager,)d(msglvl,)i │ │ │ │ │ -(msgFile\))f(;)0 1685 y(})0 1785 y(/*--------------)o(---)o(--)o(--)o │ │ │ │ │ -(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 1885 y(/*)131 │ │ │ │ │ -1984 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ -(--)o(---)o(-)131 2084 y(STEP)i(6:)g(compute)f(the)h(numeric)f │ │ │ │ │ -(factorization)131 2183 y(----------------)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ -(--)o(---)o(--)o(--)o(---)o(-)0 2283 y(*/)0 2383 y(chvmanager)e(=)44 │ │ │ │ │ +TeXDict begin 53 52 bop 0 100 a Fs(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1172 4 v 1336 w Ft(SPOOLES)32 b(2.2)26 b Fs(|)i(Solving)f │ │ │ │ │ +(Linear)f(Systems)328 b Fu(53)0 390 y Fp(frontmtx)40 │ │ │ │ │ +b(=)j(FrontMtx_new\(\))38 b(;)0 490 y(mtxmanager)h(=)44 │ │ │ │ │ +b(SubMtxManager_n)o(ew\()o(\))37 b(;)0 589 y(SubMtxManager_in)o(it\()o │ │ │ │ │ +(mt)o(xm)o(ana)o(ge)o(r,)g(NO_LOCK,)j(0\))j(;)0 689 y(if)g(\()g(type)f │ │ │ │ │ +(==)h(SPOOLES_REAL)38 b(\))43 b({)131 789 y(FrontMtx_init\(fr)o(on)o │ │ │ │ │ +(tm)o(tx,)37 b(frontETree,)i(symbfacIVL,)g(type,)741 │ │ │ │ │ +888 y(SPOOLES_SYMMETRI)o(C,)e(FRONTMTX_DENSE_F)o(RON)o(TS)o(,)741 │ │ │ │ │ +988 y(SPOOLES_NO_PIVOT)o(ING)o(,)g(NO_LOCK,)k(0,)h(NULL,)741 │ │ │ │ │ +1088 y(mtxmanager,)d(msglvl,)i(msgFile\))f(;)0 1187 y(})j(else)f({)131 │ │ │ │ │ +1287 y(FrontMtx_init\(fr)o(on)o(tm)o(tx,)37 b(frontETree,)i │ │ │ │ │ +(symbfacIVL,)g(type,)741 1386 y(SPOOLES_HERMITIA)o(N,)e │ │ │ │ │ +(FRONTMTX_DENSE_F)o(RON)o(TS)o(,)741 1486 y(SPOOLES_NO_PIVOT)o(ING)o(,) │ │ │ │ │ +g(NO_LOCK,)k(0,)h(NULL,)741 1586 y(mtxmanager,)d(msglvl,)i(msgFile\))f │ │ │ │ │ +(;)0 1685 y(})0 1785 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ +(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ +(--)o(---)o(--)o(--)o(-*/)0 1885 y(/*)131 1984 y(----------------)o(--) │ │ │ │ │ +o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(-)131 │ │ │ │ │ +2084 y(STEP)i(6:)g(compute)f(the)h(numeric)f(factorization)131 │ │ │ │ │ +2183 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ +(--)o(---)o(-)0 2283 y(*/)0 2383 y(chvmanager)e(=)44 │ │ │ │ │ b(ChvManager_new\()o(\))38 b(;)0 2482 y(ChvManager_init\()o(chv)o(ma)o │ │ │ │ │ (na)o(ger)o(,)f(NO_LOCK,)k(1\))h(;)0 2582 y(DVzero\(10,)d(cpus\))j(;)0 │ │ │ │ │ 2682 y(facops)f(=)i(0.0)g(;)0 2781 y(FrontMtx_QR_fact)o(or\()o(fr)o(on) │ │ │ │ │ o(tmt)o(x,)37 b(mtxA,)42 b(chvmanager,)828 2881 y(cpus,)g(&facops,)e │ │ │ │ │ (msglvl,)h(msgFile\))f(;)0 2980 y(ChvManager_free\()o(chv)o(ma)o(na)o │ │ │ │ │ (ger)o(\))d(;)0 3080 y(if)43 b(\()g(msglvl)e(>)i(1)g(\))h({)131 │ │ │ │ │ 3180 y(fprintf\(msgFile,)37 b("\\n\\n)k(factor)g(matrix"\))g(;)131 │ │ │ │ │ @@ -11846,23 +11808,22 @@ │ │ │ │ │ y(/*)131 5073 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(-) │ │ │ │ │ 131 5172 y(STEP)42 b(8:)g(solve)g(the)g(linear)f(system)131 │ │ │ │ │ 5272 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(-)0 │ │ │ │ │ 5372 y(*/)p eop end │ │ │ │ │ %%Page: 54 54 │ │ │ │ │ TeXDict begin 54 53 bop 0 100 a Fu(54)327 b Ft(SPOOLES)31 │ │ │ │ │ b(2.2)c Fs(|)h(Solving)f(Linear)f(Systems)p 2095 100 │ │ │ │ │ -1110 4 v 1303 w(F)-7 b(ebruary)27 b(8,)g(2025)0 390 y │ │ │ │ │ -Fp(mtxX)42 b(=)h(DenseMtx_new\(\))38 b(;)0 490 y(DenseMtx_init\(mt)o │ │ │ │ │ -(xX,)f(type,)k(0,)i(0,)g(neqns,)e(nrhs,)g(1,)i(neqns\))e(;)0 │ │ │ │ │ -589 y(FrontMtx_QR_solv)o(e\(f)o(ro)o(nt)o(mtx)o(,)c(mtxA,)42 │ │ │ │ │ -b(mtxX,)f(mtxB,)h(mtxmanager,)785 689 y(cpus,)f(msglvl,)g(msgFile\))f │ │ │ │ │ -(;)0 789 y(if)j(\()g(msglvl)e(>)i(1)g(\))h({)131 888 │ │ │ │ │ -y(fprintf\(msgFile,)37 b("\\n\\n)k(solution)g(matrix)g(in)h(new)h │ │ │ │ │ -(ordering"\))c(;)131 988 y(DenseMtx_writeFo)o(rH)o(um)o(anE)o(ye)o │ │ │ │ │ -(\(mt)o(xX)o(,)f(msgFile\))i(;)131 1088 y(fflush\(msgFile\))d(;)0 │ │ │ │ │ +1145 4 v 1338 w(Jan)n(uary)g(7,)h(2024)0 390 y Fp(mtxX)42 │ │ │ │ │ +b(=)h(DenseMtx_new\(\))38 b(;)0 490 y(DenseMtx_init\(mt)o(xX,)f(type,)k │ │ │ │ │ +(0,)i(0,)g(neqns,)e(nrhs,)g(1,)i(neqns\))e(;)0 589 y(FrontMtx_QR_solv)o │ │ │ │ │ +(e\(f)o(ro)o(nt)o(mtx)o(,)c(mtxA,)42 b(mtxX,)f(mtxB,)h(mtxmanager,)785 │ │ │ │ │ +689 y(cpus,)f(msglvl,)g(msgFile\))f(;)0 789 y(if)j(\()g(msglvl)e(>)i(1) │ │ │ │ │ +g(\))h({)131 888 y(fprintf\(msgFile,)37 b("\\n\\n)k(solution)g(matrix)g │ │ │ │ │ +(in)h(new)h(ordering"\))c(;)131 988 y(DenseMtx_writeFo)o(rH)o(um)o(anE) │ │ │ │ │ +o(ye)o(\(mt)o(xX)o(,)f(msgFile\))i(;)131 1088 y(fflush\(msgFile\))d(;)0 │ │ │ │ │ 1187 y(})0 1287 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(-*/)0 1386 y(/*)131 1486 y(----------------)o(--)o(--) │ │ │ │ │ o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---) │ │ │ │ │ o(--)o(-)131 1586 y(STEP)42 b(9:)g(permute)f(the)h(solution)f(into)h │ │ │ │ │ (the)g(original)e(ordering)131 1685 y(----------------)o(--)o(--)o(---) │ │ │ │ │ o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -1,16 +1,16 @@ │ │ │ │ │ │ Solving Linear Systems using SPOOLES 2.2 │ │ │ │ │ │ C. C. Ashcraft, R. G. Grimes, D. J. Pierce, D. K. Wah │ │ │ │ │ │ Boeing Phantom Works∗ │ │ │ │ │ │ - February 8, 2025 │ │ │ │ │ │ + January 7, 2024 │ │ │ │ │ │ ∗P. O. Box 24346, Mail Stop 7L-22, Seattle, Washington 98124. This research was supported in part by the DARPA │ │ │ │ │ │ Contract DABT63-95-C-0122 and the DoD High Performance Computing Modernization Program Common HPC Software │ │ │ │ │ │ Support Initiative. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 SPOOLES 2.2 — Solving Linear Systems February 8, 2025 │ │ │ │ │ │ + 2 SPOOLES 2.2 — Solving Linear Systems January 7, 2024 │ │ │ │ │ │ Contents │ │ │ │ │ │ 1 Overview 4 │ │ │ │ │ │ 2 Serial Solution of AX = Y using an LU factorization 6 │ │ │ │ │ │ 2.1 Reading the input parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 │ │ │ │ │ │ 2.2 Communicating the data for the problem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 │ │ │ │ │ │ 2.3 Reordering the linear system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 │ │ │ │ │ │ 2.4 Non-numeric work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 │ │ │ │ │ │ @@ -39,18 +39,18 @@ │ │ │ │ │ │ 5.3 Reordering the linear system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 │ │ │ │ │ │ 5.4 Non-numeric work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 │ │ │ │ │ │ 5.5 The Matrix Factorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 │ │ │ │ │ │ 5.6 Solving the linear system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 │ │ │ │ │ │ 5.7 Sample Matrix and Right Hand Side Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 │ │ │ │ │ │ A allInOne.c – A Serial LU Driver Program 24 │ │ │ │ │ │ B allInOne.c – A Serial LU Driver Program 31 │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2 — Solving Linear Systems 3 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2 — Solving Linear Systems 3 │ │ │ │ │ │ C allInOne.c – A Serial LU Driver Program 39 │ │ │ │ │ │ D allInOne.c – A Serial QR Driver Program 49 │ │ │ │ │ │ - 4 SPOOLES 2.2 — Solving Linear Systems February 8, 2025 │ │ │ │ │ │ + 4 SPOOLES 2.2 — Solving Linear Systems January 7, 2024 │ │ │ │ │ │ 1 Overview │ │ │ │ │ │ The SPOOLES software library is designed to solve sparse systems of linear equations AX = Y for X, │ │ │ │ │ │ whereAisfullrankandX andY aredensematrices. ThematrixAcanbeeitherrealorcomplex,symmetric, │ │ │ │ │ │ Hermitian, square nonsymmetric, or overdetermined. When A is square, there are four steps in the process │ │ │ │ │ │ of solving AX = Y. │ │ │ │ │ │ • communicate the data for the problem as A, X and Y. │ │ │ │ │ │ ee e e T e e │ │ │ │ │ │ @@ -94,26 +94,26 @@ │ │ │ │ │ │ The SPOOLES library is based on an object oriented design philosophy. There are several data struc- │ │ │ │ │ │ tures or objects that the user must interact with. These interactions are performed with a set of methods │ │ │ │ │ │ for each object. Every object has some standard methods, such as initializing the object, placing data into │ │ │ │ │ │ the object, extracting data out of the object, writing and reading the object to a input/output file, printing │ │ │ │ │ │ the contents of the object to a specified file, and freeing the object. │ │ │ │ │ │ For example, consider the DenseMtx object that models a dense matrix. The DenseMtx/DenseMtx.h │ │ │ │ │ │ header file defines the object’s C struct and has prototypes (with extensive comments) of the object’s │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2 — Solving Linear Systems 5 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2 — Solving Linear Systems 5 │ │ │ │ │ │ A │ │ │ │ │ │ methods. Thesourcefiles arefound in the DenseMtx/srcdirectory. The LT X documentation files are found │ │ │ │ │ │ E │ │ │ │ │ │ in the DenseMtx/docdirectory. The files can be used to create the DenseMtxobject’s chapter in the Reference │ │ │ │ │ │ Manual,orinastandalonemannertogeneratetheobject’sdocumentation. TheDenseMtx/driversdirectory │ │ │ │ │ │ contains driver programs that exercise and validate the object’s functionality. │ │ │ │ │ │ Almost all the methods in the library are associated with a particular object. There are some exceptions, │ │ │ │ │ │ mostly found in the misc/src directory. The misc/drivers directory contains the serial LU and QR driver │ │ │ │ │ │ programs. The MT/drivers and MPI/drivers directories contain the multithreaded and MPI LU driver │ │ │ │ │ │ programs. │ │ │ │ │ │ - 6 SPOOLES 2.2 — Solving Linear Systems February 8, 2025 │ │ │ │ │ │ + 6 SPOOLES 2.2 — Solving Linear Systems January 7, 2024 │ │ │ │ │ │ 2 Serial Solution of AX = Y using an LU factorization │ │ │ │ │ │ The user has some representation of the data which represents the linear system, AX = Y . The user wants │ │ │ │ │ │ the solution X. The SPOOLES library will use A and Y and provide X back to the user. │ │ │ │ │ │ The SPOOLESlibrary is based on an object oriented design philosophy. The first object that the user │ │ │ │ │ │ mustinteract with is InpMtx1. The InpMtx object is where the SPOOLES representation of A is assembled. │ │ │ │ │ │ The user can input the representation of A into the InpMtx object with methods for single matrix entry │ │ │ │ │ │ (consisting of the row index, the column index, and the value), for an array of entries, for a set of entries in │ │ │ │ │ │ @@ -145,15 +145,15 @@ │ │ │ │ │ │ nrhs floating point numbers if the system is real, or 2*nrhs numbers if the system is complex. │ │ │ │ │ │ • The seed parameter is a random number seed used in the ordering process. │ │ │ │ │ │ 2.2 Communicating the data for the problem │ │ │ │ │ │ The following code segment from the full sample program opens the file matrixFileName, reads the first │ │ │ │ │ │ line of the file, and then initializes the InpMtx object. The program continues by reading each line of the │ │ │ │ │ │ input matrix data and uses either the method InpMtx inputRealEntry()or InpMtx inputComplexEntry() │ │ │ │ │ │ 1InpMtx stands for Input Matrix, for it is the object into which the user inputs the matrix entries. │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2 — Solving Linear Systems 7 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2 — Solving Linear Systems 7 │ │ │ │ │ │ to place that entry into the InpMtx object. Finally this code segment closes the file. finalizes the input to │ │ │ │ │ │ InpMtx by converting the internal storage of the matrix entries to a vector form. (This is necessary for later │ │ │ │ │ │ steps.) │ │ │ │ │ │ inputFile = fopen(matrixFileName, "r") ; │ │ │ │ │ │ fscanf(inputFile, "%d %d %d", &nrow, &ncol, &nent) ; │ │ │ │ │ │ neqns = nrow ; │ │ │ │ │ │ mtxA = InpMtx_new() ; │ │ │ │ │ │ @@ -192,15 +192,15 @@ │ │ │ │ │ │ • The fifth argument maxnvector is an estimate of the number of number of vectors that will be used, │ │ │ │ │ │ e.g., number of rows or numbers of columns. │ │ │ │ │ │ The maxnent and maxnvector arguments only have to be estimates as they are used in the initial sizing of │ │ │ │ │ │ the object. Either can be 0. The InpMtx object resizes itself as required to handle the linear system. │ │ │ │ │ │ 2Note that SPOOLES has some pre-defined parameters such as INPMTX BY ROWS for some objects. These parameters are │ │ │ │ │ │ always uppercase and either begin with the name of the object which they apply to, or the library name, e.g., SPOOLES REAL. │ │ │ │ │ │ They are described in the reference manual in the section for the particular object. │ │ │ │ │ │ - 8 SPOOLES 2.2 — Solving Linear Systems February 8, 2025 │ │ │ │ │ │ + 8 SPOOLES 2.2 — Solving Linear Systems January 7, 2024 │ │ │ │ │ │ Every object in SPOOLES has print methods to output the contents of that object. This is illustrated │ │ │ │ │ │ in this code segment by printing the input matrix as contained in the InpMtx object, mtxA. To shorten this │ │ │ │ │ │ chapter we will from now on omit the part of the code that prints debug output to msgFile for the various │ │ │ │ │ │ code segments. The complete sample program in Section A contains all of the debug print statements. │ │ │ │ │ │ After the matrix A has been read in from the file and placed in an InpMtx object, the right hand matrix │ │ │ │ │ │ Y is read in from a file and placed in a DenseMtx object. The following code fragment does this operation. │ │ │ │ │ │ inputFile = fopen(rhsFileName, "r") ; │ │ │ │ │ │ @@ -240,15 +240,15 @@ │ │ │ │ │ │ number of rows, or neqns. │ │ │ │ │ │ Theinitialization step allocates storage for the matrix entries, but it does not fill them with any values. This │ │ │ │ │ │ is done explicitly via the DenseMtx zero() method, which places zeroes in all the entries. This is necessary │ │ │ │ │ │ since the right hand side matrix Y may be sparse, and so the number of rows in the file may not equal the │ │ │ │ │ │ number of equations. │ │ │ │ │ │ The right hand side entries are then in, row by row, and placed into their locations via one of the two │ │ │ │ │ │ “set entries” methods. Note, the nonzero rows can be read from the file in any order. │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2 — Solving Linear Systems 9 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2 — Solving Linear Systems 9 │ │ │ │ │ │ 2.3 Reordering the linear system │ │ │ │ │ │ The first step is to find the permutation matrix P, and then permute AX = Y into (PAPT)(PX) = PY. │ │ │ │ │ │ The result of the SPOOLES ordering step is not just P or its permutation vector, it is a front tree that │ │ │ │ │ │ defines not just the permutation, but the blocking of the factor matrices, which in turn specifies the data │ │ │ │ │ │ structures and the computations that are performed during the factor and solves. To determine this ETree │ │ │ │ │ │ front tree object takes three step, as seen in the code fragment below. │ │ │ │ │ │ adjIVL = InpMtx_fullAdjacency(mtxA) ; │ │ │ │ │ │ @@ -287,15 +287,15 @@ │ │ │ │ │ │ InpMtx_changeCoordType(mtxA, INPMTX_BY_CHEVRONS) ; │ │ │ │ │ │ InpMtx_changeStorageMode(mtxA, INPMTX_BY_VECTORS) ; │ │ │ │ │ │ DenseMtx_permuteRows(mtxB, oldToNewIV) ; │ │ │ │ │ │ The oldToNewIV and newToOldIV variables are IV objects that represent an integer vector. The oldToNew │ │ │ │ │ │ and newToOld variables are pointers to int, which point to the base address of the int vector in an IV │ │ │ │ │ │ object. │ │ │ │ │ │ 3IVL stands for Integer Vector List, i.e., a list of integer vectors. │ │ │ │ │ │ - 10 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 10 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ Once we have the permutation vector, we apply it to the front tree, by the ETree permuteVertices() │ │ │ │ │ │ method, and then to the matrix with the InpMtx permute() method. If the matrix A is symmetric or │ │ │ │ │ │ Hermitian, we expect all nonzero entries to be in the upper triangle. Permuting the matrix yields PAPT, │ │ │ │ │ │ which may not have all of its entries in the upper triangle. If A is symmetric or Hermitian, the call to │ │ │ │ │ │ InpMtx mapToUpperTriangle() ensures that all entries of PAPT are in its upper triangle. Permuting the │ │ │ │ │ │ matrix destroys the internal vector structure, which has to be restored. But first we need to change the │ │ │ │ │ │ 4 │ │ │ │ │ │ @@ -330,15 +330,15 @@ │ │ │ │ │ │ little internal code differences, and it is the hook we have left in the library to extend its capabilities │ │ │ │ │ │ to out-of-core factors and solves. │ │ │ │ │ │ • The twelveth and thirteenth parameters define the message level and message file for the factorization. │ │ │ │ │ │ The numeric factorization is performed by the FrontMtx factorInpMtx() method. The code segment │ │ │ │ │ │ from the sample program for the numerical factorization step is found below. │ │ │ │ │ │ 4The i-th chevron of A consists of the diagonal entry Ai,i, the i-th row of the upper triangle of A, and the i-th column of │ │ │ │ │ │ the lower triangle of A. │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 11 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 11 │ │ │ │ │ │ chvmanager = ChvManager_new() ; │ │ │ │ │ │ ChvManager_init(chvmanager, NO_LOCK, 1) ; │ │ │ │ │ │ DVfill(10, cpus, 0.0) ; │ │ │ │ │ │ IVfill(20, stats, 0) ; │ │ │ │ │ │ rootchv = FrontMtx_factorInpMtx(frontmtx, mtxA, tau, droptol, │ │ │ │ │ │ chvmanager, &error, cpus, stats, msglvl, msgFile) ; │ │ │ │ │ │ ChvManager_free(chvmanager) ; │ │ │ │ │ │ @@ -373,15 +373,15 @@ │ │ │ │ │ │ First we initialize a new DenseMtx object to hold X (and also PX). (Note, in all cases but a nonsymmetric │ │ │ │ │ │ matrix with pivoting enabled in an MPI environment, X may overwrite Y, and so we can use the same │ │ │ │ │ │ DenseMtx object for X and Y.) We then solve the linear system with a call to FrontMtx solve(). Note │ │ │ │ │ │ that one of the arguments is the mtxmanager object, first created for the numerical factorization. The solve │ │ │ │ │ │ requires working submatrices, and so we continue the convention of having the FrontMtx ask the manager │ │ │ │ │ │ object for working storage. The last step is to permute the rows of the DenseMtx from the new ordering into │ │ │ │ │ │ the old ordering. │ │ │ │ │ │ - 12 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 12 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ 2.7 Sample Matrix and Right Hand Side Files │ │ │ │ │ │ Immediately below are two sample files: matrix.input holds the matrix input and rhs.input holds the │ │ │ │ │ │ right hand side. This example is for a symmetric Laplacian operator on a 3×3 grid. Only entries in the upper │ │ │ │ │ │ triangle are stored. The right hand side is the 9×9 identity matrix. Note how the indices are zero-based as │ │ │ │ │ │ for C, instead of one-based as for Fortran. │ │ │ │ │ │ matrix.input │ │ │ │ │ │ 9 9 21 │ │ │ │ │ │ @@ -402,15 +402,15 @@ │ │ │ │ │ │ 7 8 -1.0 8 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 │ │ │ │ │ │ 0 3 -1.0 │ │ │ │ │ │ 1 4 -1.0 │ │ │ │ │ │ 2 5 -1.0 │ │ │ │ │ │ 3 6 -1.0 │ │ │ │ │ │ 4 7 -1.0 │ │ │ │ │ │ 5 8 -1.0 │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 13 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 13 │ │ │ │ │ │ 3 Multithreaded Solution of AX = Y using an LU factorization │ │ │ │ │ │ The only computations that are multithreaded are the factorization and forward and backsolves. Therefore, │ │ │ │ │ │ this section will describe only the differences between the serial driver in Section A and the multithreaded │ │ │ │ │ │ driver whose complete listing is found in Section B. This section will refer the reader to subsections in │ │ │ │ │ │ Section 2 for the parts of the code where the two drivers are identical. │ │ │ │ │ │ The shared memory parallel version of SPOOLES is implemented using thread based parallelism. The │ │ │ │ │ │ multi-threaded code uses much of the serial code — the basic steps are the same and use the serial methods. │ │ │ │ │ │ @@ -443,15 +443,15 @@ │ │ │ │ │ │ over a range of orderings, and this is what we recommend, as we see in the code fragment below. │ │ │ │ │ │ if ( nthread > (nfront = FrontMtx_nfront(frontmtx)) ) { │ │ │ │ │ │ nthread = nfront ; │ │ │ │ │ │ } │ │ │ │ │ │ cumopsDV = DV_new() ; │ │ │ │ │ │ DV_init(cumopsDV, nthread, NULL) ; │ │ │ │ │ │ ownersIV = ETree_ddMap(frontETree, type, symmetryflag, cumopsDV, 1./(2.*nthread)) ; │ │ │ │ │ │ - 14 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 14 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ The first step is to ensure that each thread has a front to own, decreasing the number of threads if necessary. │ │ │ │ │ │ We then construct the owners map using the front tree object. The cumopsDV object is a double precision │ │ │ │ │ │ vector object whose length is the number of threads. On return from the map call, it contains the number │ │ │ │ │ │ of factor operations that will be performed by each thread when pivoting for stability is not enabled. │ │ │ │ │ │ 3.5 The Matrix Factorization │ │ │ │ │ │ During the factorization and solves, the threads access data and modify the state of the FrontMtx and │ │ │ │ │ │ SubMtxManagerobjects in a concurrent fashion, so there must be some way to control this access for critical │ │ │ │ │ │ @@ -487,15 +487,15 @@ │ │ │ │ │ │ workcooperativelyto compute the factor matrices, there is idle time while one thread waits on another. │ │ │ │ │ │ The lookahead parameter controls the ability of the thread to look past the present idle point and │ │ │ │ │ │ performworkthatisnotsoimmediate. Unfortunately, whileathreadisoffdoingthiswork,itmayblock │ │ │ │ │ │ a thread at a more crucial point. When lookahead = 0, each processor tries to do only “immediate” │ │ │ │ │ │ work. Moderate speedups in the factorization have been for values of lookahead up to the number │ │ │ │ │ │ of threads. For nonzero lookahead values, the amount of working storage can increase, sometimes │ │ │ │ │ │ appreciably. │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 15 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 15 │ │ │ │ │ │ Thepost-processing of the factorization is exactly the same as the serial code. Note, this step can be trivially │ │ │ │ │ │ parallelized, but is not done at present. │ │ │ │ │ │ After the post-processing step, the FrontMtx object contains the L , D and U submatrices. What │ │ │ │ │ │ J,I I,I I,J │ │ │ │ │ │ remains to be done is to specify which threads own which submatrices, and thus perform computations with │ │ │ │ │ │ them. This is done by constructing a “solve–map” object, as we see below. │ │ │ │ │ │ solvemap = SolveMap_new() ; │ │ │ │ │ │ @@ -511,15 +511,15 @@ │ │ │ │ │ │ DenseMtx_zero(mtxX) ; │ │ │ │ │ │ FrontMtx_MT_solve(frontmtx, mtxX, mtxY, mtxmanager, solvemap, cpus, msglvl, msgFile) ; │ │ │ │ │ │ DenseMtx_permuteRows(mtxX, newToOldIV) ; │ │ │ │ │ │ The only difference between the serial and multithreaded solve methods is the presence of the solve–map │ │ │ │ │ │ object in the latter. │ │ │ │ │ │ 3.7 Sample Matrix and Right Hand Side Files │ │ │ │ │ │ The multithreaded driver uses the same input files as found in Section 2.7. │ │ │ │ │ │ - 16 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 16 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ 4 MPISolution of AX =Y using an LU factorization │ │ │ │ │ │ Unlike the serial and multithreaded environments where the data structures are global, existing under one │ │ │ │ │ │ address space, in the MPI environment, data is local, each process or processor has its own distinct address │ │ │ │ │ │ space. The MPI step-by-step process to solve a linear system is exactly the same as the multithreaded case, │ │ │ │ │ │ with the additional trouble that the data structures are distributed and need to be re-distributed as needed. │ │ │ │ │ │ The ownership of the factor matrices during the factorization and solves is exactly the same as for the │ │ │ │ │ │ multithreaded case – the map from fronts to processors and map from submatrices to processors are identical │ │ │ │ │ │ @@ -552,15 +552,15 @@ │ │ │ │ │ │ adjIVL = InpMtx_MPI_fullAdjacency(mtxA, stats, msglvl, msgFile, MPI_COMM_WORLD) ; │ │ │ │ │ │ nedges = IVL_tsize(adjIVL) ; │ │ │ │ │ │ Graph_init2(graph, 0, neqns, 0, nedges, neqns, nedges, adjIVL, NULL, NULL) ; │ │ │ │ │ │ frontETree = orderViaMMD(graph, seed + myid, msglvl, msgFile) ; │ │ │ │ │ │ Whilethedataandcomputationsaredistributedacrosstheprocessors,the orderingprocessis not. Therefore │ │ │ │ │ │ we need a global graph on each processor. Since the matrix A is distributed across the processors, we use │ │ │ │ │ │ the distributed InpMtx MPI fullAdjacency() method to construct the IVL object of the graph of A+AT. │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 17 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 17 │ │ │ │ │ │ At this point, each processor has computed its own minimum degree ordering and created a front tree │ │ │ │ │ │ object. The orderings will likely be different, because each processors input a different random number seed │ │ │ │ │ │ to the ordering method. Only one ordering can be used for the factorization, so the processors collectively │ │ │ │ │ │ determine which of the orderings is best, which is then broadcast to all the processors, as the code fragment │ │ │ │ │ │ below illustrates. │ │ │ │ │ │ opcounts = DVinit(nproc, 0.0) ; │ │ │ │ │ │ opcounts[myid] = ETree_nFactorOps(frontETree, type, symmetryflag) ; │ │ │ │ │ │ @@ -597,15 +597,15 @@ │ │ │ │ │ │ IV_init(vtxmapIV, neqns, NULL) ; │ │ │ │ │ │ IVgather(neqns, IV_entries(vtxmapIV), IV_entries(ownersIV), ETree_vtxToFront(frontETree)) ; │ │ │ │ │ │ At this point we are ready to assemble and distribute the entries of A and Y . │ │ │ │ │ │ firsttag = 0 ; │ │ │ │ │ │ newA = InpMtx_MPI_split(mtxA, vtxmapIV, stats, msglvl, msgFile, firsttag, │ │ │ │ │ │ MPI_COMM_WORLD) ; │ │ │ │ │ │ InpMtx_free(mtxA) ; │ │ │ │ │ │ - 18 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 18 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ mtxA = newA ; │ │ │ │ │ │ InpMtx_changeStorageMode(mtxA, INPMTX_BY_VECTORS) ; │ │ │ │ │ │ newY = DenseMtx_MPI_splitByRows(mtxY, vtxmapIV, stats, msglvl, │ │ │ │ │ │ msgFile, firsttag, MPI_COMM_WORLD) ; │ │ │ │ │ │ DenseMtx_free(mtxY) ; │ │ │ │ │ │ mtxY = newY ; │ │ │ │ │ │ The InpMtx MPI split() method assembles and redistributes the matrix entries by the vectors of the local │ │ │ │ │ │ @@ -640,15 +640,15 @@ │ │ │ │ │ │ chvmanager, ownersIV, lookahead, &error, cpus, │ │ │ │ │ │ stats, msglvl, msgFile, firsttag, MPI_COMM_WORLD) ; │ │ │ │ │ │ ChvManager_free(chvmanager) ; │ │ │ │ │ │ Note that the ChvManager is not locked. The calling sequence is identical to that of the multithreaded │ │ │ │ │ │ factorization except for the addition of the firsttag and MPI communicator at the end. │ │ │ │ │ │ The post-processing of the factorization is the same in principle as in the serial code but differs in that │ │ │ │ │ │ is uses the distributed data structures. │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 19 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 19 │ │ │ │ │ │ FrontMtx_MPI_postProcess(frontmtx, ownersIV, stats, msglvl, │ │ │ │ │ │ msgFile, firsttag, MPI_COMM_WORLD) ; │ │ │ │ │ │ After the post-processing step, each local FrontMtx object contains the L , D and U submatrices │ │ │ │ │ │ J,I I,I I,J │ │ │ │ │ │ for the fronts that were owned by the particular processor. However, the parallel solve is based on the │ │ │ │ │ │ submatrices being distributed across the processors, not just the fronts. │ │ │ │ │ │ We must specify which threads own which submatrices, and so perform computations with them. This │ │ │ │ │ │ @@ -683,15 +683,15 @@ │ │ │ │ │ │ mtxY = newY ; │ │ │ │ │ │ IV_free(rowmapIV) ; │ │ │ │ │ │ } │ │ │ │ │ │ Each processor now must create a local DenseMtx object to hold the rows of PX that it owns. │ │ │ │ │ │ ownedColumnsIV = FrontMtx_ownedColumnsIV(frontmtx, myid, ownersIV, │ │ │ │ │ │ msglvl, msgFile) ; │ │ │ │ │ │ nmycol = IV_size(ownedColumnsIV) ; │ │ │ │ │ │ - 20 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 20 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ mtxX = DenseMtx_new() ; │ │ │ │ │ │ if ( nmycol > 0 ) { │ │ │ │ │ │ DenseMtx_init(mtxX, type, 0, 0, nmycol, nrhs, 1, nmycol) ; │ │ │ │ │ │ DenseMtx_rowIndices(mtxX, &nrow, &rowind) ; │ │ │ │ │ │ IVcopy(nmycol, rowind, IV_entries(ownedColumnsIV)) ; │ │ │ │ │ │ } │ │ │ │ │ │ If A is symmetric, or if pivoting for stability was not used, then mtxX can just be a pointer to mtxY, i.e., PX │ │ │ │ │ │ @@ -722,15 +722,15 @@ │ │ │ │ │ │ 1 4 -1.0 6 6 4.0 │ │ │ │ │ │ 6 7 -1.0 │ │ │ │ │ │ rhs.0.input rhs.1.input rhs.2.input rhs.3.input │ │ │ │ │ │ 2 1 2 1 2 1 3 1 │ │ │ │ │ │ 0 0.0 2 0.0 4 1.0 6 0.0 │ │ │ │ │ │ 1 0.0 3 0.0 5 0.0 7 0.0 │ │ │ │ │ │ 8 0.0 │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 21 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 21 │ │ │ │ │ │ 5 Serial Solution of AX = Y using an QR factorization │ │ │ │ │ │ Let us review the steps is solving AX = Y using a QR factorization. │ │ │ │ │ │ • communicate the data for the problem as A, X and Y. │ │ │ │ │ │ ee e T e │ │ │ │ │ │ • reorder as AX = Y, where A = AP and X =PX. and P is a permutation matrix. │ │ │ │ │ │ e │ │ │ │ │ │ • factor A = QR, where Q is orthogonal and R is upper triangular. │ │ │ │ │ │ @@ -762,15 +762,15 @@ │ │ │ │ │ │ apply it to the matrix A. This is done by the following code fragment. │ │ │ │ │ │ oldToNewIV = ETree_oldToNewVtxPerm(frontETree) ; │ │ │ │ │ │ oldToNew = IV_entries(oldToNewIV) ; │ │ │ │ │ │ newToOldIV = ETree_newToOldVtxPerm(frontETree) ; │ │ │ │ │ │ newToOld = IV_entries(newToOldIV) ; │ │ │ │ │ │ InpMtx_permute(mtxA, NULL, oldToNew)) ; │ │ │ │ │ │ InpMtx_changeStorageMode(mtxA, INPMTX_BY_VECTORS) ; │ │ │ │ │ │ - 22 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 22 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ The oldToNewIV and newToOldIV variables are IV objects that represent an integer vector. The oldToNew │ │ │ │ │ │ andnewToOldvariablesarepointers to int, which point to the base address of the int vector in an IV object. │ │ │ │ │ │ Once we have the permutation vector, we apply it to the front tree, by the ETree permuteVertices() │ │ │ │ │ │ method. We need APT, so we permute the InpMtx object using a NULL pointer for the row permutation │ │ │ │ │ │ (which means do not permute the rows) and the oldToNew vector for the column permutation. At this point │ │ │ │ │ │ the InpMtx object holds APT in the form required by the factorization. │ │ │ │ │ │ The final steps are to compute the symbolic factorization, which is stored in an IVL object, and to │ │ │ │ │ │ @@ -808,15 +808,15 @@ │ │ │ │ │ │ the sample program for the numerical factorization step is found below. │ │ │ │ │ │ chvmanager = ChvManager_new() ; │ │ │ │ │ │ ChvManager_init(chvmanager, NO_LOCK, 1) ; │ │ │ │ │ │ DVzero(10, cpus) ; │ │ │ │ │ │ facops = 0.0 ; │ │ │ │ │ │ FrontMtx_QR_factor(frontmtx, mtxA, chvmanager, cpus, &facops, msglvl, msgFile) ; │ │ │ │ │ │ ChvManager_free(chvmanager) ; │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 23 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 23 │ │ │ │ │ │ Working storage used during the factorization is found in the form of block chevrons, in a Chv object, │ │ │ │ │ │ which hold the partial frontal matrix for a front. Much as with the SubMtx object, the FrontMtx object │ │ │ │ │ │ does not concern itself with managing working storage, instead it relies on a ChvManager object to manage │ │ │ │ │ │ the Chv objects. On return facops contains the number of floating point operations performed during the │ │ │ │ │ │ factorization. │ │ │ │ │ │ The factorization is performed using a one-dimensional decomposition of the factor matrices. Keeping │ │ │ │ │ │ the factor matrices in this form severely limits the amount of parallelism for the forward and backsolves. │ │ │ │ │ │ @@ -853,15 +853,15 @@ │ │ │ │ │ │ 5 1 2.0 6 5.0 │ │ │ │ │ │ 5 4 3.0 7 4.0 │ │ │ │ │ │ 5 5 1.0 │ │ │ │ │ │ 6 0 2.0 │ │ │ │ │ │ 6 3 3.0 │ │ │ │ │ │ 7 1 1.0 │ │ │ │ │ │ 7 4 3.0 │ │ │ │ │ │ - 24 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 24 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ A allInOne.c – A Serial LU Driver Program │ │ │ │ │ │ /* allInOne.c */ │ │ │ │ │ │ #include "../../misc.h" │ │ │ │ │ │ #include "../../FrontMtx.h" │ │ │ │ │ │ #include "../../SymbFac.h" │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ int │ │ │ │ │ │ @@ -900,15 +900,15 @@ │ │ │ │ │ │ symmetryflag, type ; │ │ │ │ │ │ int *newToOld, *oldToNew ; │ │ │ │ │ │ int stats[20] ; │ │ │ │ │ │ IV *newToOldIV, *oldToNewIV ; │ │ │ │ │ │ IVL *adjIVL, *symbfacIVL ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 25 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 25 │ │ │ │ │ │ -------------------- │ │ │ │ │ │ get input parameters │ │ │ │ │ │ -------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ if ( argc != 9 ) { │ │ │ │ │ │ fprintf(stdout, "\n" │ │ │ │ │ │ "\n usage: %s msglvl msgFile type symmetryflag pivotingflag" │ │ │ │ │ │ @@ -952,15 +952,15 @@ │ │ │ │ │ │ symmetryflag = atoi(argv[4]) ; │ │ │ │ │ │ pivotingflag = atoi(argv[5]) ; │ │ │ │ │ │ matrixFileName = argv[6] ; │ │ │ │ │ │ rhsFileName = argv[7] ; │ │ │ │ │ │ seed = atoi(argv[8]) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ - 26 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 26 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ -------------------------------------------- │ │ │ │ │ │ STEP 1: read the entries from the input file │ │ │ │ │ │ and create the InpMtx object │ │ │ │ │ │ -------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ inputFile = fopen(matrixFileName, "r") ; │ │ │ │ │ │ fscanf(inputFile, "%d %d %d", &nrow, &ncol, &nent) ; │ │ │ │ │ │ @@ -1004,15 +1004,15 @@ │ │ │ │ │ │ fscanf(inputFile, "%d", &jrow) ; │ │ │ │ │ │ for ( jrhs = 0 ; jrhs < nrhs ; jrhs++ ) { │ │ │ │ │ │ fscanf(inputFile, "%le", &value) ; │ │ │ │ │ │ DenseMtx_setRealEntry(mtxY, jrow, jrhs, value) ; │ │ │ │ │ │ } │ │ │ │ │ │ } │ │ │ │ │ │ } else { │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 27 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 27 │ │ │ │ │ │ double imag, real ; │ │ │ │ │ │ for ( irow = 0 ; irow < nrow ; irow++ ) { │ │ │ │ │ │ fscanf(inputFile, "%d", &jrow) ; │ │ │ │ │ │ for ( jrhs = 0 ; jrhs < nrhs ; jrhs++ ) { │ │ │ │ │ │ fscanf(inputFile, "%le %le", &real, &imag) ; │ │ │ │ │ │ DenseMtx_setComplexEntry(mtxY, jrow, jrhs, real, imag) ; │ │ │ │ │ │ } │ │ │ │ │ │ @@ -1056,15 +1056,15 @@ │ │ │ │ │ │ get the symbolic factorization │ │ │ │ │ │ ---------------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ oldToNewIV = ETree_oldToNewVtxPerm(frontETree) ; │ │ │ │ │ │ oldToNew = IV_entries(oldToNewIV) ; │ │ │ │ │ │ newToOldIV = ETree_newToOldVtxPerm(frontETree) ; │ │ │ │ │ │ newToOld = IV_entries(newToOldIV) ; │ │ │ │ │ │ - 28 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 28 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ ETree_permuteVertices(frontETree, oldToNewIV) ; │ │ │ │ │ │ InpMtx_permute(mtxA, oldToNew, oldToNew) ; │ │ │ │ │ │ if ( symmetryflag == SPOOLES_SYMMETRIC │ │ │ │ │ │ || symmetryflag == SPOOLES_HERMITIAN ) { │ │ │ │ │ │ InpMtx_mapToUpperTriangle(mtxA) ; │ │ │ │ │ │ } │ │ │ │ │ │ InpMtx_changeCoordType(mtxA, INPMTX_BY_CHEVRONS) ; │ │ │ │ │ │ @@ -1108,15 +1108,15 @@ │ │ │ │ │ │ ChvManager_init(chvmanager, NO_LOCK, 1) ; │ │ │ │ │ │ DVfill(10, cpus, 0.0) ; │ │ │ │ │ │ IVfill(20, stats, 0) ; │ │ │ │ │ │ rootchv = FrontMtx_factorInpMtx(frontmtx, mtxA, tau, droptol, │ │ │ │ │ │ chvmanager, &error, cpus, stats, msglvl, msgFile) ; │ │ │ │ │ │ ChvManager_free(chvmanager) ; │ │ │ │ │ │ if ( msglvl > 2 ) { │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 29 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 29 │ │ │ │ │ │ fprintf(msgFile, "\n\n factor matrix") ; │ │ │ │ │ │ FrontMtx_writeForHumanEye(frontmtx, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ if ( rootchv != NULL ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n matrix found to be singular\n") ; │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ @@ -1160,15 +1160,15 @@ │ │ │ │ │ │ ------------------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ DenseMtx_permuteRows(mtxX, newToOldIV) ; │ │ │ │ │ │ if ( msglvl > 0 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n solution matrix in original ordering") ; │ │ │ │ │ │ DenseMtx_writeForHumanEye(mtxX, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ - 30 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 30 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ----------- │ │ │ │ │ │ free memory │ │ │ │ │ │ ----------- │ │ │ │ │ │ */ │ │ │ │ │ │ @@ -1181,15 +1181,15 @@ │ │ │ │ │ │ ETree_free(frontETree) ; │ │ │ │ │ │ IVL_free(symbfacIVL) ; │ │ │ │ │ │ SubMtxManager_free(mtxmanager) ; │ │ │ │ │ │ Graph_free(graph) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ return(1) ; } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 31 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 31 │ │ │ │ │ │ B allInOne.c – A Serial LU Driver Program │ │ │ │ │ │ /* allInOneMT.c */ │ │ │ │ │ │ #include "../spoolesMT.h" │ │ │ │ │ │ #include "../../misc.h" │ │ │ │ │ │ #include "../../FrontMtx.h" │ │ │ │ │ │ #include "../../SymbFac.h" │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ @@ -1228,15 +1228,15 @@ │ │ │ │ │ │ Graph *graph ; │ │ │ │ │ │ InpMtx *mtxA ; │ │ │ │ │ │ int error, ient, irow, jcol, jrhs, jrow, lookahead, msglvl, │ │ │ │ │ │ ncol, nedges, nent, neqns, nfront, nrhs, nrow, │ │ │ │ │ │ nthread, pivotingflag, seed, symmetryflag, type ; │ │ │ │ │ │ int *newToOld, *oldToNew ; │ │ │ │ │ │ int stats[20] ; │ │ │ │ │ │ - 32 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 32 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ IV *newToOldIV, *oldToNewIV, *ownersIV ; │ │ │ │ │ │ IVL *adjIVL, *symbfacIVL ; │ │ │ │ │ │ SolveMap *solvemap ; │ │ │ │ │ │ SubMtxManager *mtxmanager ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ -------------------- │ │ │ │ │ │ @@ -1280,15 +1280,15 @@ │ │ │ │ │ │ } else if ( (msgFile = fopen(argv[2], "a")) == NULL ) { │ │ │ │ │ │ fprintf(stderr, "\n fatal error in %s" │ │ │ │ │ │ "\n unable to open file %s\n", │ │ │ │ │ │ argv[0], argv[2]) ; │ │ │ │ │ │ return(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ type = atoi(argv[3]) ; │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 33 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 33 │ │ │ │ │ │ symmetryflag = atoi(argv[4]) ; │ │ │ │ │ │ pivotingflag = atoi(argv[5]) ; │ │ │ │ │ │ matrixFileName = argv[6] ; │ │ │ │ │ │ rhsFileName = argv[7] ; │ │ │ │ │ │ seed = atoi(argv[8]) ; │ │ │ │ │ │ nthread = atoi(argv[9]) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ @@ -1332,15 +1332,15 @@ │ │ │ │ │ │ inputFile = fopen(rhsFileName, "r") ; │ │ │ │ │ │ fscanf(inputFile, "%d %d", &nrow, &nrhs) ; │ │ │ │ │ │ mtxY = DenseMtx_new() ; │ │ │ │ │ │ DenseMtx_init(mtxY, type, 0, 0, neqns, nrhs, 1, neqns) ; │ │ │ │ │ │ DenseMtx_zero(mtxY) ; │ │ │ │ │ │ if ( type == SPOOLES_REAL ) { │ │ │ │ │ │ double value ; │ │ │ │ │ │ - 34 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 34 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ for ( irow = 0 ; irow < nrow ; irow++ ) { │ │ │ │ │ │ fscanf(inputFile, "%d", &jrow) ; │ │ │ │ │ │ for ( jrhs = 0 ; jrhs < nrhs ; jrhs++ ) { │ │ │ │ │ │ fscanf(inputFile, "%le", &value) ; │ │ │ │ │ │ DenseMtx_setRealEntry(mtxY, jrow, jrhs, value) ; │ │ │ │ │ │ } │ │ │ │ │ │ } │ │ │ │ │ │ @@ -1384,15 +1384,15 @@ │ │ │ │ │ │ ETree_writeForHumanEye(frontETree, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ---------------------------------------------------- │ │ │ │ │ │ STEP 4: get the permutation, permute the front tree, │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 35 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 35 │ │ │ │ │ │ permute the matrix and right hand side, and │ │ │ │ │ │ get the symbolic factorization │ │ │ │ │ │ ---------------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ oldToNewIV = ETree_oldToNewVtxPerm(frontETree) ; │ │ │ │ │ │ oldToNew = IV_entries(oldToNewIV) ; │ │ │ │ │ │ newToOldIV = ETree_newToOldVtxPerm(frontETree) ; │ │ │ │ │ │ @@ -1436,15 +1436,15 @@ │ │ │ │ │ │ ownersIV = ETree_ddMap(frontETree, type, symmetryflag, │ │ │ │ │ │ cumopsDV, 1./(2.*nthread)) ; │ │ │ │ │ │ if ( msglvl > 1 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n map from fronts to threads") ; │ │ │ │ │ │ IV_writeForHumanEye(ownersIV, msgFile) ; │ │ │ │ │ │ fprintf(msgFile, "\n\n factor operations for each front") ; │ │ │ │ │ │ DV_writeForHumanEye(cumopsDV, msgFile) ; │ │ │ │ │ │ - 36 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 36 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ DV_free(cumopsDV) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------------------------ │ │ │ │ │ │ STEP 6: initialize the front matrix object │ │ │ │ │ │ @@ -1488,15 +1488,15 @@ │ │ │ │ │ │ -------------------------------------- │ │ │ │ │ │ STEP 8: post-process the factorization │ │ │ │ │ │ -------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ FrontMtx_postProcess(frontmtx, msglvl, msgFile) ; │ │ │ │ │ │ if ( msglvl > 1 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n factor matrix after post-processing") ; │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 37 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 37 │ │ │ │ │ │ FrontMtx_writeForHumanEye(frontmtx, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------------------------------------- │ │ │ │ │ │ STEP 9: get the solve map object for the parallel solve │ │ │ │ │ │ @@ -1540,27 +1540,27 @@ │ │ │ │ │ │ free memory │ │ │ │ │ │ ----------- │ │ │ │ │ │ */ │ │ │ │ │ │ FrontMtx_free(frontmtx) ; │ │ │ │ │ │ DenseMtx_free(mtxX) ; │ │ │ │ │ │ DenseMtx_free(mtxY) ; │ │ │ │ │ │ IV_free(newToOldIV) ; │ │ │ │ │ │ - 38 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 38 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ IV_free(oldToNewIV) ; │ │ │ │ │ │ InpMtx_free(mtxA) ; │ │ │ │ │ │ ETree_free(frontETree) ; │ │ │ │ │ │ IVL_free(symbfacIVL) ; │ │ │ │ │ │ SubMtxManager_free(mtxmanager) ; │ │ │ │ │ │ Graph_free(graph) ; │ │ │ │ │ │ SolveMap_free(solvemap) ; │ │ │ │ │ │ IV_free(ownersIV) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ return(1) ; } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 39 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 39 │ │ │ │ │ │ C allInOne.c – A Serial LU Driver Program │ │ │ │ │ │ /* allInOneMPI.c */ │ │ │ │ │ │ #include "../spoolesMPI.h" │ │ │ │ │ │ #include "../../timings.h" │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ int │ │ │ │ │ │ main ( int argc, char *argv[] ) { │ │ │ │ │ │ @@ -1598,15 +1598,15 @@ │ │ │ │ │ │ double *opcounts ; │ │ │ │ │ │ DV *cumopsDV ; │ │ │ │ │ │ ETree *frontETree ; │ │ │ │ │ │ FILE *inputFile, *msgFile ; │ │ │ │ │ │ Graph *graph ; │ │ │ │ │ │ int error, firsttag, ient, irow, jcol, lookahead = 0, │ │ │ │ │ │ msglvl, myid, nedges, nent, neqns, nmycol, nproc, nrhs, │ │ │ │ │ │ - 40 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 40 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ nrow, pivotingflag, root, seed, symmetryflag, type ; │ │ │ │ │ │ int stats[20] ; │ │ │ │ │ │ int *rowind ; │ │ │ │ │ │ IV *oldToNewIV, *ownedColumnsIV, *ownersIV, │ │ │ │ │ │ *newToOldIV, *vtxmapIV ; │ │ │ │ │ │ IVL *adjIVL, *symbfacIVL ; │ │ │ │ │ │ SolveMap *solvemap ; │ │ │ │ │ │ @@ -1650,15 +1650,15 @@ │ │ │ │ │ │ return(0) ; │ │ │ │ │ │ } │ │ │ │ │ │ msglvl = atoi(argv[1]) ; │ │ │ │ │ │ if ( strcmp(argv[2], "stdout") == 0 ) { │ │ │ │ │ │ msgFile = stdout ; │ │ │ │ │ │ } else { │ │ │ │ │ │ sprintf(buffer, "res.%d", myid) ; │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 41 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 41 │ │ │ │ │ │ if ( (msgFile = fopen(buffer, "w")) == NULL ) { │ │ │ │ │ │ fprintf(stderr, "\n fatal error in %s" │ │ │ │ │ │ "\n unable to open file %s\n", │ │ │ │ │ │ argv[0], buffer) ; │ │ │ │ │ │ return(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ } │ │ │ │ │ │ @@ -1702,15 +1702,15 @@ │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ---------------------------------------------------- │ │ │ │ │ │ STEP 2: read the rhs entries from the rhs input file │ │ │ │ │ │ and create the DenseMtx object for Y │ │ │ │ │ │ - 42 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 42 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ ---------------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ sprintf(buffer, "rhs.%d.input", myid) ; │ │ │ │ │ │ inputFile = fopen(buffer, "r") ; │ │ │ │ │ │ fscanf(inputFile, "%d %d", &nrow, &nrhs) ; │ │ │ │ │ │ mtxY = DenseMtx_new() ; │ │ │ │ │ │ DenseMtx_init(mtxY, type, 0, 0, nrow, nrhs, 1, nrow) ; │ │ │ │ │ │ @@ -1754,15 +1754,15 @@ │ │ │ │ │ │ adjIVL = InpMtx_MPI_fullAdjacency(mtxA, stats, │ │ │ │ │ │ msglvl, msgFile, MPI_COMM_WORLD) ; │ │ │ │ │ │ nedges = IVL_tsize(adjIVL) ; │ │ │ │ │ │ Graph_init2(graph, 0, neqns, 0, nedges, neqns, nedges, adjIVL, │ │ │ │ │ │ NULL, NULL) ; │ │ │ │ │ │ if ( msglvl > 2 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n graph of the input matrix") ; │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 43 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 43 │ │ │ │ │ │ Graph_writeForHumanEye(graph, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ frontETree = orderViaMMD(graph, seed + myid, msglvl, msgFile) ; │ │ │ │ │ │ Graph_free(graph) ; │ │ │ │ │ │ if ( msglvl > 2 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n front tree from ordering") ; │ │ │ │ │ │ @@ -1806,15 +1806,15 @@ │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------------------------- │ │ │ │ │ │ STEP 4: generate the owners map IV object │ │ │ │ │ │ and the map from vertices to owners │ │ │ │ │ │ - 44 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 44 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ ------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ cutoff = 1./(2*nproc) ; │ │ │ │ │ │ cumopsDV = DV_new() ; │ │ │ │ │ │ DV_init(cumopsDV, nproc, NULL) ; │ │ │ │ │ │ ownersIV = ETree_ddMap(frontETree, │ │ │ │ │ │ type, symmetryflag, cumopsDV, cutoff) ; │ │ │ │ │ │ @@ -1858,15 +1858,15 @@ │ │ │ │ │ │ DenseMtx_writeForHumanEye(mtxY, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------------------------ │ │ │ │ │ │ STEP 6: compute the symbolic factorization │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 45 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 45 │ │ │ │ │ │ ------------------------------------------ │ │ │ │ │ │ */ │ │ │ │ │ │ symbfacIVL = SymbFac_MPI_initFromInpMtx(frontETree, ownersIV, mtxA, │ │ │ │ │ │ stats, msglvl, msgFile, firsttag, MPI_COMM_WORLD) ; │ │ │ │ │ │ firsttag += frontETree->nfront ; │ │ │ │ │ │ if ( msglvl > 2 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n local symbolic factorization") ; │ │ │ │ │ │ @@ -1910,15 +1910,15 @@ │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------------------------------ │ │ │ │ │ │ STEP 9: post-process the factorization and split │ │ │ │ │ │ the factor matrices into submatrices │ │ │ │ │ │ - 46 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 46 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ ------------------------------------------------ │ │ │ │ │ │ */ │ │ │ │ │ │ FrontMtx_MPI_postProcess(frontmtx, ownersIV, stats, msglvl, │ │ │ │ │ │ msgFile, firsttag, MPI_COMM_WORLD) ; │ │ │ │ │ │ firsttag += 5*nproc ; │ │ │ │ │ │ if ( msglvl > 2 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n numeric factorization after post-processing"); │ │ │ │ │ │ @@ -1962,15 +1962,15 @@ │ │ │ │ │ │ */ │ │ │ │ │ │ if ( FRONTMTX_IS_PIVOTING(frontmtx) ) { │ │ │ │ │ │ IV *rowmapIV ; │ │ │ │ │ │ /* │ │ │ │ │ │ ---------------------------------------------------------- │ │ │ │ │ │ pivoting has taken place, redistribute the right hand side │ │ │ │ │ │ to match the final rows and columns in the fronts │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 47 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 47 │ │ │ │ │ │ ---------------------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ rowmapIV = FrontMtx_MPI_rowmapIV(frontmtx, ownersIV, msglvl, │ │ │ │ │ │ msgFile, MPI_COMM_WORLD) ; │ │ │ │ │ │ newY = DenseMtx_MPI_splitByRows(mtxY, rowmapIV, stats, msglvl, │ │ │ │ │ │ msgFile, firsttag, MPI_COMM_WORLD) ; │ │ │ │ │ │ DenseMtx_free(mtxY) ; │ │ │ │ │ │ @@ -2014,15 +2014,15 @@ │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ -------------------------------------------------------- │ │ │ │ │ │ STEP 15: permute the solution into the original ordering │ │ │ │ │ │ and assemble the solution onto processor zero │ │ │ │ │ │ -------------------------------------------------------- │ │ │ │ │ │ - 48 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 48 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ */ │ │ │ │ │ │ DenseMtx_permuteRows(mtxX, newToOldIV) ; │ │ │ │ │ │ if ( msglvl > 2 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n solution in old ordering") ; │ │ │ │ │ │ DenseMtx_writeForHumanEye(mtxX, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ @@ -2035,15 +2035,15 @@ │ │ │ │ │ │ DenseMtx_writeForHumanEye(mtxX, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ MPI_Finalize() ; │ │ │ │ │ │ return(1) ; } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 49 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 49 │ │ │ │ │ │ D allInOne.c – A Serial QR Driver Program │ │ │ │ │ │ /* QRallInOne.c */ │ │ │ │ │ │ #include "../../misc.h" │ │ │ │ │ │ #include "../../FrontMtx.h" │ │ │ │ │ │ #include "../../SymbFac.h" │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ int │ │ │ │ │ │ @@ -2083,15 +2083,15 @@ │ │ │ │ │ │ /* │ │ │ │ │ │ -------------------- │ │ │ │ │ │ get input parameters │ │ │ │ │ │ -------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ if ( argc != 7 ) { │ │ │ │ │ │ fprintf(stdout, │ │ │ │ │ │ - 50 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 50 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ "\n usage: %s msglvl msgFile type matrixFileName rhsFileName seed" │ │ │ │ │ │ "\n msglvl -- message level" │ │ │ │ │ │ "\n msgFile -- message file" │ │ │ │ │ │ "\n type -- type of entries" │ │ │ │ │ │ "\n 1 (SPOOLES_REAL) -- real entries" │ │ │ │ │ │ "\n 2 (SPOOLES_COMPLEX) -- complex entries" │ │ │ │ │ │ "\n matrixFileName -- matrix file name, format" │ │ │ │ │ │ @@ -2135,15 +2135,15 @@ │ │ │ │ │ │ if ( type == SPOOLES_REAL ) { │ │ │ │ │ │ for ( ient = 0 ; ient < nent ; ient++ ) { │ │ │ │ │ │ fscanf(inputFile, "%d %d %le", &irow, &jcol, &value) ; │ │ │ │ │ │ InpMtx_inputRealEntry(mtxA, irow, jcol, value) ; │ │ │ │ │ │ } │ │ │ │ │ │ } else { │ │ │ │ │ │ for ( ient = 0 ; ient < nent ; ient++ ) { │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 51 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 51 │ │ │ │ │ │ fscanf(inputFile, "%d %d %le %le", &irow, &jcol, &real, &imag) ; │ │ │ │ │ │ InpMtx_inputComplexEntry(mtxA, irow, jcol, real, imag) ; │ │ │ │ │ │ } │ │ │ │ │ │ } │ │ │ │ │ │ fclose(inputFile) ; │ │ │ │ │ │ if ( msglvl > 1 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n input matrix") ; │ │ │ │ │ │ @@ -2187,15 +2187,15 @@ │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------------------------------- │ │ │ │ │ │ STEP 3 : find a low-fill ordering │ │ │ │ │ │ (1) create the Graph object for A^TA or A^HA │ │ │ │ │ │ (2) order the graph using multiple minimum degree │ │ │ │ │ │ ------------------------------------------------- │ │ │ │ │ │ - 52 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 52 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ */ │ │ │ │ │ │ graph = Graph_new() ; │ │ │ │ │ │ adjIVL = InpMtx_adjForATA(mtxA) ; │ │ │ │ │ │ nedges = IVL_tsize(adjIVL) ; │ │ │ │ │ │ Graph_init2(graph, 0, neqns, 0, nedges, neqns, nedges, adjIVL, │ │ │ │ │ │ NULL, NULL) ; │ │ │ │ │ │ if ( msglvl > 1 ) { │ │ │ │ │ │ @@ -2239,15 +2239,15 @@ │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------------------------ │ │ │ │ │ │ STEP 5: initialize the front matrix object │ │ │ │ │ │ ------------------------------------------ │ │ │ │ │ │ */ │ │ │ │ │ │ - February 8, 2025 SPOOLES 2.2—Solving Linear Systems 53 │ │ │ │ │ │ + January 7, 2024 SPOOLES 2.2—Solving Linear Systems 53 │ │ │ │ │ │ frontmtx = FrontMtx_new() ; │ │ │ │ │ │ mtxmanager = SubMtxManager_new() ; │ │ │ │ │ │ SubMtxManager_init(mtxmanager, NO_LOCK, 0) ; │ │ │ │ │ │ if ( type == SPOOLES_REAL ) { │ │ │ │ │ │ FrontMtx_init(frontmtx, frontETree, symbfacIVL, type, │ │ │ │ │ │ SPOOLES_SYMMETRIC, FRONTMTX_DENSE_FRONTS, │ │ │ │ │ │ SPOOLES_NO_PIVOTING, NO_LOCK, 0, NULL, │ │ │ │ │ │ @@ -2291,15 +2291,15 @@ │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------------- │ │ │ │ │ │ STEP 8: solve the linear system │ │ │ │ │ │ ------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ - 54 SPOOLES2.2—SolvingLinearSystems February 8, 2025 │ │ │ │ │ │ + 54 SPOOLES2.2—SolvingLinearSystems January 7, 2024 │ │ │ │ │ │ mtxX = DenseMtx_new() ; │ │ │ │ │ │ DenseMtx_init(mtxX, type, 0, 0, neqns, nrhs, 1, neqns) ; │ │ │ │ │ │ FrontMtx_QR_solve(frontmtx, mtxA, mtxX, mtxB, mtxmanager, │ │ │ │ │ │ cpus, msglvl, msgFile) ; │ │ │ │ │ │ if ( msglvl > 1 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n solution matrix in new ordering") ; │ │ │ │ │ │ DenseMtx_writeForHumanEye(mtxX, msgFile) ; │ │ │ ├── ./usr/share/doc/spooles-doc/BKL.ps.gz │ │ │ │ ├── BKL.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o BKL.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0424 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2554,21 +2554,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2752,88 +2751,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4123,16 +4117,16 @@ │ │ │ │ │ 2[25 47[58 11[{}6 90.9091 /CMMI10 rf /Fd 149[25 72[91 │ │ │ │ │ 29[45 2[71{}4 90.9091 /CMSY10 rf /Fe 133[50 59 2[59 62 │ │ │ │ │ 44 44 46 1[62 56 62 93 31 2[31 62 2[51 62 2[54 11[86 │ │ │ │ │ 4[77 6[42 20[56 56 56 56 2[31 46[{}25 99.6264 /CMBX12 │ │ │ │ │ rf /Ff 179[62 62 8[62 66[{}3 119.552 /CMTT12 rf /Fg 141[38 │ │ │ │ │ 2[46 51 1[23 42 1[28 46 42 1[42 1[42 1[46 12[65 1[66 │ │ │ │ │ 11[59 62 69 2[68 6[28 58[{}18 90.9091 /CMTI10 rf /Fh │ │ │ │ │ -134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 │ │ │ │ │ -2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf │ │ │ │ │ +134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 1[45 │ │ │ │ │ +1[45 3[25 44[{}12 90.9091 /CMSL10 rf │ │ │ │ │ %DVIPSBitmapFont: Fi tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -4241,17 +4235,17 @@ │ │ │ │ │ 5294 y Fi(\210)45 b Fk(int)i(*cweights)28 b Fl(:)40 b(p)s(oin)m(ter)30 │ │ │ │ │ b(to)h(an)f Fk(int)f Fl(v)m(ector)j(of)e(size)h(3,)g │ │ │ │ │ Fk(cweights[0])c Fl(con)m(tains)32 b(the)e(w)m(eigh)m(t)h(of)g(the)227 │ │ │ │ │ 5407 y(separator,)h Fk(cweights[1])27 b Fl(and)j Fk(cweights[2])d │ │ │ │ │ Fl(con)m(tains)k(the)g(w)m(eigh)m(ts)h(of)e(the)h(t)m(w)m(o)h(comp)s │ │ │ │ │ (onen)m(ts)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fl(2)p 136 100 1163 4 v │ │ │ │ │ -1345 w Fk(BKL)29 b Fh(:)i Fg(DRAFT)f Fh(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2738 100 V 137 399 a Fi(\210)45 b Fk(int)i(*regwghts)39 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fl(2)p 136 100 1182 4 v │ │ │ │ │ +1364 w Fk(BKL)29 b Fh(:)i Fg(DRAFT)f Fh(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2719 100 V 137 399 a Fi(\210)45 b Fk(int)i(*regwghts)39 │ │ │ │ │ b Fl(:)62 b(p)s(oin)m(ter)41 b(to)h(an)f Fk(int)f Fl(v)m(ector)j(of)e │ │ │ │ │ (size)h Fk(nreg)p Fl(,)h(used)d(to)i(store)g(the)f(w)m(eigh)m(ts)h(of)g │ │ │ │ │ (the)227 511 y(domains)30 b(and)g(segmen)m(ts)137 738 │ │ │ │ │ y Fi(\210)45 b Fk(float)i(alpha)41 b Fl(:)65 b(n)m(um)m(b)s(er)41 │ │ │ │ │ b(used)g(to)j(store)f(the)f(partition)i(ev)-5 b(aluation)44 │ │ │ │ │ b(parameter,)i(the)d(cost)g(of)g(the)227 851 y(partition)31 │ │ │ │ │ b(is)227 1124 y Fk(balance)46 b(=)i(max\(cweights[1],)43 │ │ │ │ │ @@ -4296,17 +4290,17 @@ │ │ │ │ │ (call)h(to)f Fk(BKL)p 2265 5125 V 34 w(clearData\(\))c │ │ │ │ │ Fl(then)j(free's)h(the)f(storage)i(for)227 5238 y(the)31 │ │ │ │ │ b(structure)f(with)g(a)h(call)g(to)g Fk(free\(\))p Fl(.)227 │ │ │ │ │ 5407 y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fl(If)30 │ │ │ │ │ b Fk(bkl)g Fl(is)g Fk(NULL)p Fl(,)g(an)g(error)g(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)g(the)g(program)g(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1163 4 v 1344 100 a Fk(BKL)30 │ │ │ │ │ -b Fh(:)g Fg(DRAFT)121 b Fh(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2690 100 V 1163 w Fl(3)0 399 y Fe(1.3.1)112 b(Initializer)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1182 4 v 1363 100 a Fk(BKL)30 │ │ │ │ │ +b Fh(:)g Fg(DRAFT)121 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2671 100 V 1182 w Fl(3)0 399 y Fe(1.3.1)112 b(Initializer)38 │ │ │ │ │ b(metho)s(ds)111 590 y Fl(1.)46 b Fk(void)h(BKL_init)e(\()j(BKL)f │ │ │ │ │ (*bkl,)f(BPG)h(*bpg,)f(float)h(alpha)f(\))i(;)227 736 │ │ │ │ │ y Fl(This)34 b(metho)s(d)g(initializes)j(the)d Fk(BKL)g │ │ │ │ │ Fl(ob)5 b(ject)35 b(giv)m(en)h(a)f(bipartite)g(graph)f(ob)5 │ │ │ │ │ b(ject)35 b(and)f(cost)i(function)e(pa-)227 849 y(rameter)g(as)f │ │ │ │ │ (input.)48 b(An)m(y)33 b(previous)g(data)h(is)f(cleared)h(with)f(a)h │ │ │ │ │ (call)g(to)g Fk(BKL)p 2868 849 29 4 v 33 w(clearData\(\))p │ │ │ │ │ @@ -4370,17 +4364,17 @@ │ │ │ │ │ y(6.)46 b Fk(float)h(BKL_setInitPart)c(\()48 b(BKL)f(*bkl,)f(int)h │ │ │ │ │ (flag,)f(int)h(seed,)g(int)f(domcolors[])f(\))j(;)227 │ │ │ │ │ 5294 y Fl(This)43 b(metho)s(d)g(sets)h(the)f(initial)i(partition)f(b)m │ │ │ │ │ (y)f(coloring)i(the)e(domains)h(and)e(segmen)m(ts.)81 │ │ │ │ │ b(The)43 b Fk(flag)227 5407 y Fl(parameter)31 b(has)f(the)h(follo)m │ │ │ │ │ (wing)h(v)-5 b(alues.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fl(4)p 136 100 1163 4 v │ │ │ │ │ -1345 w Fk(BKL)29 b Fh(:)i Fg(DRAFT)f Fh(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2738 100 V 337 399 a Fi(\210)45 b Fk(flag)i(=)g(1)30 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fl(4)p 136 100 1182 4 v │ │ │ │ │ +1364 w Fk(BKL)29 b Fh(:)i Fg(DRAFT)f Fh(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2719 100 V 337 399 a Fi(\210)45 b Fk(flag)i(=)g(1)30 │ │ │ │ │ b Fd(\000)-15 b(!)30 b Fl(random)g(coloring)h(of)g(the)g(domains)337 │ │ │ │ │ 558 y Fi(\210)45 b Fk(flag)i(=)g(2)30 b Fd(\000)-15 b(!)30 │ │ │ │ │ b Fl(one)h(blac)m(k)g(domain,)g(\()p Fk(seed)e Fl(\045)h │ │ │ │ │ Fk(ndom)p Fl(\),)g(rest)h(are)f(white)337 717 y Fi(\210)45 │ │ │ │ │ b Fk(flag)i(=)g(3)32 b Fd(\000)-15 b(!)32 b Fl(one)g(blac)m(k)i │ │ │ │ │ (pseudop)s(eripheral)c(domain,)j(found)e(using)g(domain)h(\()p │ │ │ │ │ Fk(seed)g Fl(\045)g Fk(ndom)p Fl(\))427 830 y(as)f(ro)s(ot,)g(rest)f │ │ │ │ │ @@ -4448,17 +4442,17 @@ │ │ │ │ │ b(it)g(returns)e(\()p Fd(j)p Fc(S)5 b Fd(j)21 b Fl(+)f │ │ │ │ │ Fd(j)p Fc(B)5 b Fd(j)20 b Fl(+)g Fd(j)p Fc(W)13 b Fd(j)p │ │ │ │ │ Fl(\))1714 5211 y Fa(2)1754 5244 y Fl(.)227 5407 y Fg(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fl(If)30 b Fk(bkl)g Fl(is)g │ │ │ │ │ Fk(NULL)p Fl(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)g(the)g │ │ │ │ │ (program)g(exits.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1163 4 v 1344 100 a Fk(BKL)30 │ │ │ │ │ -b Fh(:)g Fg(DRAFT)121 b Fh(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2690 100 V 1163 w Fl(5)111 399 y(3.)46 b Fk(float)h(BKL_eval)e(\()j │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1182 4 v 1363 100 a Fk(BKL)30 │ │ │ │ │ +b Fh(:)g Fg(DRAFT)121 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2671 100 V 1182 w Fl(5)111 399 y(3.)46 b Fk(float)h(BKL_eval)e(\()j │ │ │ │ │ (BKL)f(*bkl,)f(int)h(Sweight,)e(int)i(Bweight,)f(int)h(Wweight)f(\))h │ │ │ │ │ (;)227 549 y Fl(The)31 b Fd(j)p Fc(S)5 b Fd(j)p Fl(,)31 │ │ │ │ │ b Fd(j)p Fc(B)5 b Fd(j)31 b Fl(and)f Fd(j)p Fc(W)13 b │ │ │ │ │ Fd(j)31 b Fl(v)-5 b(alues)31 b(are)g(tak)m(en)h(from)e(the)h │ │ │ │ │ Fk(Sweight)p Fl(,)f Fk(Bweight)e Fl(and)j Fk(Wweight)d │ │ │ │ │ Fl(parameters.)227 662 y(If)i(min\()p Fd(j)p Fc(B)5 b │ │ │ │ │ Fd(j)p Fc(;)15 b Fd(j)p Fc(W)e Fd(j)p Fl(\))26 b Fc(>)f │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -18,15 +18,15 @@ │ │ │ │ │ │ • int ngaineval : number of gain evaluations, roughly equivalent to the number of degree │ │ │ │ │ │ evaluations in the minimum degree algorithm │ │ │ │ │ │ • int *colors : pointer to an int vector of size nreg, colors[idom] is 1 or 2 for domain │ │ │ │ │ │ idom, colors[iseg] is 0, 1 or 2 for segment iseg. │ │ │ │ │ │ • int *cweights : pointer to an int vector of size 3, cweights[0] contains the weight of the │ │ │ │ │ │ separator, cweights[1] and cweights[2] contains the weights of the two components │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 BKL : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 BKL : DRAFT January 7, 2024 │ │ │ │ │ │ • int *regwghts : pointer to an int vector of size nreg, used to store the weights of the │ │ │ │ │ │ domains and segments │ │ │ │ │ │ • float alpha : number used to store the partition evaluation parameter, the cost of the │ │ │ │ │ │ partition is │ │ │ │ │ │ balance = max(cweights[1], cweights[2])/min(cweights[1], cweights[2]) ; │ │ │ │ │ │ cost = cweights[0]*(1. + alpha*balance) ; │ │ │ │ │ │ 1.2 Prototypes and descriptions of BKL methods │ │ │ │ │ │ @@ -47,15 +47,15 @@ │ │ │ │ │ │ This method clears any data allocated by the object, namely the colors and regwghts vec- │ │ │ │ │ │ tors. It then fills the structure’s fields with default values with a call to BKL setDefaultFields(). │ │ │ │ │ │ Error checking: If bkl is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void BKL_free ( BKL *bkl ) ; │ │ │ │ │ │ This method releases any storage by a call to BKL clearData() then free’s the storage for │ │ │ │ │ │ the structure with a call to free(). │ │ │ │ │ │ Error checking: If bkl is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - BKL : DRAFT February 8, 2025 3 │ │ │ │ │ │ + BKL : DRAFT January 7, 2024 3 │ │ │ │ │ │ 1.3.1 Initializer methods │ │ │ │ │ │ 1. void BKL_init ( BKL *bkl, BPG *bpg, float alpha ) ; │ │ │ │ │ │ This method initializes the BKL object given a bipartite graph object and cost function pa- │ │ │ │ │ │ rameter as input. Any previous data is cleared with a call to BKL clearData(). The ndom, │ │ │ │ │ │ nseg and nreg scalars are set, the regwghts[] vector allocated and filled, and the colors[] │ │ │ │ │ │ vector allocated and filled with zeros. │ │ │ │ │ │ Error checking: If bkl or bpg is NULL, an error message is printed and the program exits. │ │ │ │ │ │ @@ -84,15 +84,15 @@ │ │ │ │ │ │ This method returns the next domain id in a grey code sequence, used to exhaustively search │ │ │ │ │ │ of a subspace of partitions defined by set of candidate domains to flip. The value count │ │ │ │ │ │ ranges from 1 to 2ndom. │ │ │ │ │ │ Error checking: If bkl is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 6. float BKL_setInitPart ( BKL *bkl, int flag, int seed, int domcolors[] ) ; │ │ │ │ │ │ This method sets the initial partition by coloring the domains and segments. The flag │ │ │ │ │ │ parameter has the following values. │ │ │ │ │ │ - 4 BKL : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 BKL : DRAFT January 7, 2024 │ │ │ │ │ │ • flag = 1 −→ random coloring of the domains │ │ │ │ │ │ • flag = 2 −→ one black domain, (seed % ndom), rest are white │ │ │ │ │ │ • flag = 3 −→ one black pseudoperipheral domain, found using domain (seed % ndom) │ │ │ │ │ │ as root, rest are white │ │ │ │ │ │ • flag = 4 −→ roughly half-half split, breadth first search of domains, (seed % ndom) as │ │ │ │ │ │ root │ │ │ │ │ │ • flag = 5 −→ roughly half-half split, breadth first search of domains, (seed % ndom) as │ │ │ │ │ │ @@ -119,15 +119,15 @@ │ │ │ │ │ │ The |S|, |B| and |W| values are taken from the cweights[] vector. If min(|B|,|W|) > 0, this │ │ │ │ │ │ function returns   │ │ │ │ │ │ |S| 1+α∗max(|B|,|W|) , │ │ │ │ │ │ min(|B|,|W|) │ │ │ │ │ │ 2 │ │ │ │ │ │ otherwise it returns (|S| + |B| + |W|) . │ │ │ │ │ │ Error checking: If bkl is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - BKL : DRAFT February 8, 2025 5 │ │ │ │ │ │ + BKL : DRAFT January 7, 2024 5 │ │ │ │ │ │ 3. float BKL_eval ( BKL *bkl, int Sweight, int Bweight, int Wweight ) ; │ │ │ │ │ │ The |S|, |B| and |W| values are taken from the Sweight, Bweight and Wweight parameters. │ │ │ │ │ │ If min(|B|,|W|) > 0, this function returns │ │ │ │ │ │ |S|1+α∗ max(|B|,|W|), │ │ │ │ │ │ min(|B|,|W|) │ │ │ │ │ │ 2 │ │ │ │ │ │ otherwise it returns (|S| + |B| + |W|) . The method checks that bkl is not NULL. │ │ │ ├── ./usr/share/doc/spooles-doc/BPG.ps.gz │ │ │ │ ├── BPG.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o BPG.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0424 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1426,21 +1426,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1624,88 +1623,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4749,19 +4743,18 @@ │ │ │ │ │ @start /Fa 173[50 8[29 3[49 69[{}3 58.1154 /CMMI7 rf │ │ │ │ │ /Fb 133[50 59 3[62 44 44 46 1[62 56 62 93 31 2[31 62 │ │ │ │ │ 56 1[51 62 50 1[54 11[86 5[84 1[106 3[42 1[88 2[86 1[80 │ │ │ │ │ 11[56 56 56 56 56 56 2[31 37 45[{}33 99.6264 /CMBX12 │ │ │ │ │ rf /Fc 175[62 8[62 4[62 66[{}3 119.552 /CMTT12 rf /Fd │ │ │ │ │ 134[71 2[71 75 52 53 55 1[75 67 75 112 2[41 37 75 67 │ │ │ │ │ 41 61 75 60 75 65 13[75 2[92 11[103 16[67 67 67 2[37 │ │ │ │ │ -46[{}27 119.552 /CMBX12 rf /Fe 134[44 3[46 2[33 12[37 │ │ │ │ │ -2[46 42 26[54 11[23 1[42 2[42 2[42 1[42 3[23 44[{}13 │ │ │ │ │ -83.022 /CMSL10 rf /Ff 156[83 46 35[74 1[74 1[74 1[74 │ │ │ │ │ -56[{}6 83.022 /CMEX10 rf /Fg 192[45 63[{}1 83.022 /CMBX10 │ │ │ │ │ -rf │ │ │ │ │ +46[{}27 119.552 /CMBX12 rf /Fe 134[44 3[46 2[33 3[46 │ │ │ │ │ +12[42 22[43 15[23 2[42 2[42 1[42 1[42 3[23 44[{}12 83.022 │ │ │ │ │ +/CMSL10 rf /Ff 156[83 46 35[74 1[74 1[74 1[74 56[{}6 │ │ │ │ │ +83.022 /CMEX10 rf /Fg 192[45 63[{}1 83.022 /CMBX10 rf │ │ │ │ │ %DVIPSBitmapFont: Fh tcrm1000 10 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -4908,30 +4901,29 @@ │ │ │ │ │ y(Finding)27 b(the)g(Dulmage-Mendelsohn)g(decomp)r(osition)f(of)h(a)g │ │ │ │ │ (bipartite)g(graph)f(is)h(a)f(little)i(less)f(clear)f(cut.)37 │ │ │ │ │ b(When)28 b(the)0 5215 y(v)n(ertices)e(in)i(the)g(bipartite)g(graph)e │ │ │ │ │ (ha)n(v)n(e)h(unit)h(w)n(eigh)n(t,)f(the)h(pro)r(cess)e(is)i(straigh)n │ │ │ │ │ (tforw)n(ard.)125 5407 y Fh(\210)42 b Fm(Find)28 b(a)f(maxim)n(um)g │ │ │ │ │ (matc)n(hing.)1929 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fm(2)p 125 100 1231 4 v │ │ │ │ │ -1396 w Fl(BPG)27 b Fe(:)g Fk(DRAFT)h Fe(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)h(2025)p 2669 100 V 125 390 a Fh(\210)42 b Fm(Drop)27 │ │ │ │ │ -b(an)g(alternating)g(lev)n(el)g(structure)g(from)g(exp)r(osed)g(no)r │ │ │ │ │ -(des)h(in)f Fj(X)7 b Fm(.)125 564 y Fh(\210)42 b Fm(Drop)27 │ │ │ │ │ -b(an)g(alternating)g(lev)n(el)g(structure)g(from)g(exp)r(osed)g(no)r │ │ │ │ │ -(des)h(in)f Fj(Y)19 b Fm(.)125 738 y Fh(\210)42 b Fm(Based)24 │ │ │ │ │ -b(on)h(the)g(t)n(w)n(o)g(previous)f(steps,)h(partition)g │ │ │ │ │ -Fj(X)32 b Fm(in)n(to)25 b(three)g(pieces)g(and)g Fj(Y)44 │ │ │ │ │ -b Fm(in)n(to)24 b(three)h(pieces)g(and)g(form)g(a)g(new)208 │ │ │ │ │ -838 y(separator)g(from)i(the)h(pieces.)0 1035 y(\(If)21 │ │ │ │ │ -b(these)f(terms)g(are)g(not)g(familiar,)h(see)f([)p Fg(?)p │ │ │ │ │ -Fm(];)j(our)d(presen)n(t)f(purp)r(ose)h(is)g(a)g(discussion)g(of)g │ │ │ │ │ -(soft)n(w)n(are)e(design,)k(not)e(algorithms.\))0 1134 │ │ │ │ │ -y(A)29 b(matc)n(hing)f(is)g(a)g(v)n(ery)f(common)h(op)r(eration)f(on)i │ │ │ │ │ -(a)f(bipartite)g(graph,)f(so)h(it)h(is)f(not)h(unreasonable)d(to)j │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 125 100 1249 4 v │ │ │ │ │ +1414 w Fl(BPG)26 b Fe(:)i Fk(DRAFT)f Fe(Jan)n(uary)f(7,)h(2024)p │ │ │ │ │ +2652 100 V 125 390 a Fh(\210)42 b Fm(Drop)27 b(an)g(alternating)g(lev)n │ │ │ │ │ +(el)g(structure)g(from)g(exp)r(osed)g(no)r(des)h(in)f │ │ │ │ │ +Fj(X)7 b Fm(.)125 564 y Fh(\210)42 b Fm(Drop)27 b(an)g(alternating)g │ │ │ │ │ +(lev)n(el)g(structure)g(from)g(exp)r(osed)g(no)r(des)h(in)f │ │ │ │ │ +Fj(Y)19 b Fm(.)125 738 y Fh(\210)42 b Fm(Based)24 b(on)h(the)g(t)n(w)n │ │ │ │ │ +(o)g(previous)f(steps,)h(partition)g Fj(X)32 b Fm(in)n(to)25 │ │ │ │ │ +b(three)g(pieces)g(and)g Fj(Y)44 b Fm(in)n(to)24 b(three)h(pieces)g │ │ │ │ │ +(and)g(form)g(a)g(new)208 838 y(separator)g(from)i(the)h(pieces.)0 │ │ │ │ │ +1035 y(\(If)21 b(these)f(terms)g(are)g(not)g(familiar,)h(see)f([)p │ │ │ │ │ +Fg(?)p Fm(];)j(our)d(presen)n(t)f(purp)r(ose)h(is)g(a)g(discussion)g │ │ │ │ │ +(of)g(soft)n(w)n(are)e(design,)k(not)e(algorithms.\))0 │ │ │ │ │ +1134 y(A)29 b(matc)n(hing)f(is)g(a)g(v)n(ery)f(common)h(op)r(eration)f │ │ │ │ │ +(on)i(a)f(bipartite)g(graph,)f(so)h(it)h(is)f(not)h(unreasonable)d(to)j │ │ │ │ │ (expand)f(the)h(data)0 1234 y(ob)5 b(ject)34 b(to)g(include)h(some)e │ │ │ │ │ (mec)n(hanism)h(for)g(matc)n(hing,)h(e.g.,)h(a)e Fl(mate[])e │ │ │ │ │ Fm(v)n(ector.)55 b(Finding)35 b(a)e(maxim)n(um)h(matc)n(hing)g(is)0 │ │ │ │ │ 1334 y(a)d(bit)h(more)f(tric)n(ky)g(for)g(there)g(are)g(a)g(n)n(um)n(b) │ │ │ │ │ r(er)h(of)f(algorithms)f(to)i(do)f(so,)h(some)f(fast,)i(some)e(slo)n │ │ │ │ │ (w,)h(some)f(simple,)i(some)0 1433 y(complex.)j(Whic)n(h)28 │ │ │ │ │ b(to)g(c)n(ho)r(ose?)125 1560 y(If)23 b(w)n(e)h(only)f(w)n(ork)n(ed)f │ │ │ │ │ @@ -5039,17 +5031,17 @@ │ │ │ │ │ b(The)28 b(dra)n(wbac)n(k)e(is)i(that)h(the)f(net)n(w)n(ork)f(induced)0 │ │ │ │ │ 5407 y(b)n(y)e Fj(S)17 b Fi([)c Fm(\()p Fj(Ad)-9 b(j)5 │ │ │ │ │ b Fm(\()p Fj(S)g Fm(\))13 b Fi(\\)g Fj(B)t Fm(\))27 b(need)e(not)g(b)r │ │ │ │ │ (e)g(bipartite.)36 b(In)25 b(other)f(w)n(ords,)g(a)h(bipartite)g │ │ │ │ │ (induced)g(graph)f(necessarily)f(implies)i(t)n(w)n(o)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 83 100 1231 4 v 1397 100 a Fl(BPG)26 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)110 b Fe(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2630 100 V 1231 w Fm(3)0 390 y(la)n(y)n(ers)e(to)i(the)g(wide)g │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1249 4 v 1414 100 a Fl(BPG)27 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)111 b Fe(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2612 100 V 1249 w Fm(3)0 390 y(la)n(y)n(ers)e(to)i(the)g(wide)g │ │ │ │ │ (separator,)e(but)j(the)f(con)n(v)n(erse)e(do)r(es)h(not)h(hold.)37 │ │ │ │ │ b(W)-7 b(e)27 b(w)n(ere)f(then)i(free)e(to)h(examine)g(wide)g │ │ │ │ │ (separators)0 490 y(that)f(had)f(more)g(than)g(t)n(w)n(o)g(la)n(y)n │ │ │ │ │ (ers)e(from)i(whic)n(h)g(to)h(\014nd)g(a)f(minimal)g(w)n(eigh)n(t)g │ │ │ │ │ (separator.)34 b(It)26 b(turns)f(out)g(that)h(three)f(la)n(y)n(ers)0 │ │ │ │ │ 589 y(is)i(b)r(etter)h(than)g(t)n(w)n(o,)f(in)h(practice.)125 │ │ │ │ │ 720 y(W)-7 b(e)34 b(did)g(write)f(a)g(separate)f(ob)5 │ │ │ │ │ @@ -5110,55 +5102,55 @@ │ │ │ │ │ 5162 V 30 w(clearData\(\))c Fm(then)23 b(free's)f(the)h(storage)d(for)i │ │ │ │ │ (the)h(structure)208 5262 y(with)28 b(a)f(call)g(to)h │ │ │ │ │ Fl(free\(\))p Fm(.)208 5407 y Fk(Err)l(or)i(che)l(cking:)38 │ │ │ │ │ b Fm(If)28 b Fl(bpg)f Fm(is)g Fl(NULL)p Fm(,)f(an)i(error)d(message)i │ │ │ │ │ (is)g(prin)n(ted)h(and)f(the)h(program)e(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fm(4)p 125 100 1231 4 v │ │ │ │ │ -1396 w Fl(BPG)27 b Fe(:)g Fk(DRAFT)h Fe(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)h(2025)p 2669 100 V 0 390 a Fb(1.2.2)112 b(Initializer)38 │ │ │ │ │ -b(metho)s(ds)0 562 y Fm(There)27 b(are)g(t)n(w)n(o)f(initializer)i │ │ │ │ │ -(metho)r(ds.)101 731 y(1.)42 b Fl(void)f(BPG_init)g(\()i(BPG)f(*bpg,)g │ │ │ │ │ -(int)g(nX,)g(int)h(nY,)f(Graph)g(*graph)f(\))i(;)208 │ │ │ │ │ -858 y Fm(This)23 b(metho)r(d)i(initializes)e(the)h Fl(BPG)f │ │ │ │ │ -Fm(ob)5 b(ject)23 b(when)h(all)g(three)f(of)h(its)g(\014elds)g(are)f │ │ │ │ │ -(giv)n(en)g(in)h(the)g(calling)f(sequence.)35 b(The)208 │ │ │ │ │ -958 y Fl(Graph)22 b Fm(ob)5 b(ject)25 b(has)f Fl(nX)42 │ │ │ │ │ -b(+)i(nY)23 b Fm(v)n(ertices.)35 b(Note,)26 b(the)f Fl(BPG)e │ │ │ │ │ -Fm(ob)5 b(ject)24 b(no)n(w)g(\\o)n(wns")f(the)i Fl(Graph)e │ │ │ │ │ -Fm(ob)5 b(ject)24 b(and)h(so)e(will)i(free)208 1057 y(the)31 │ │ │ │ │ -b Fl(Graph)d Fm(ob)5 b(ject)31 b(when)g(it)g(is)g(free'd.)46 │ │ │ │ │ -b(The)31 b Fl(Graph)e Fm(ob)5 b(ject)30 b(ma)n(y)g(con)n(tains)g(edges) │ │ │ │ │ -g(b)r(et)n(w)n(een)h(no)r(des)f(in)h Fl(X)g Fm(and)f │ │ │ │ │ -Fl(Y)p Fm(,)208 1157 y(but)e(these)f(edges)g(are)g(sw)n(app)r(ed)g(to)g │ │ │ │ │ -(the)h(end)g(of)g(eac)n(h)f(adjacency)f(list)i(and)g(the)g(size)f(of)h │ │ │ │ │ -(eac)n(h)e(list)i(is)g(then)g(set.)208 1283 y Fk(Err)l(or)k(che)l │ │ │ │ │ -(cking:)44 b Fm(If)30 b Fl(bpg)f Fm(or)g Fl(graph)f Fm(are)i │ │ │ │ │ -Fl(NULL)p Fm(,)e(or)h(if)i Fl(nX)26 b Fi(\024)h Fm(0,)j(or)g(if)g │ │ │ │ │ -Fl(nY)d Fi(\024)f Fm(0,)31 b(an)e(error)g(message)f(is)i(prin)n(ted)g │ │ │ │ │ -(and)208 1383 y(the)e(program)d(exits.)101 1536 y(2.)42 │ │ │ │ │ -b Fl(void)f(BPG_initFromColor)o(ing)c(\()43 b(BPG)f(*bpg,)g(Graph)f │ │ │ │ │ -(*graph,)g(int)h(colors[],)e(int)j(cX,)1428 1636 y(int)f(cY,)h(int)f │ │ │ │ │ -(cmap[],)f(int)h(indX[],)f(int)h(indY[])f(\))i(;)208 │ │ │ │ │ -1762 y Fm(This)22 b(metho)r(d)h(extracts)f(a)g(bipartite)g(graph)g │ │ │ │ │ -(from)g(a)g Fl(Graph)f Fm(ob)5 b(ject)22 b(where)g(the)h │ │ │ │ │ -Fl(X)f Fm(v)n(ertices)g(are)f(those)h(with)h Fl(cmap[])208 │ │ │ │ │ -1862 y Fm(v)-5 b(alue)26 b(equal)g(to)h Fl(cX)f Fm(and)h(the)g │ │ │ │ │ -Fl(Y)f Fm(v)n(ertices)g(are)f(those)i(with)g Fl(cmap[])d │ │ │ │ │ -Fm(v)-5 b(alue)27 b(equal)f(to)h Fl(cY)p Fm(.)f(The)h(v)n(ectors)e │ │ │ │ │ -Fl(indX[])f Fm(and)208 1962 y Fl(indY[])h Fm(hold)i(the)h(global)f(v)n │ │ │ │ │ -(ertex)f(ids)i(of)f(the)h Fl(X)g Fm(and)f Fl(Y)g Fm(v)n(ertices)g(resp) │ │ │ │ │ -r(ectiv)n(ely)-7 b(.)208 2088 y Fk(Err)l(or)32 b(che)l(cking:)43 │ │ │ │ │ -b Fm(If)31 b Fl(bpg)p Fm(,)e Fl(graph)p Fm(,)g Fl(colors)e │ │ │ │ │ -Fm(or)i Fl(cmap)g Fm(are)f Fl(NULL)p Fm(,)h(or)g(if)h │ │ │ │ │ -Fl(cX)c Fi(\024)h Fm(0,)j(or)f(if)i Fl(cY)26 b Fi(\024)g │ │ │ │ │ -Fm(0,)k(or)f(if)i Fl(cX)26 b Fm(=)h Fl(cY)o Fm(,)j(an)208 │ │ │ │ │ -2188 y(error)25 b(message)h(is)i(prin)n(ted)f(and)h(the)g(program)d │ │ │ │ │ -(exits.)0 2433 y Fb(1.2.3)112 b(Generate)38 b(induced)h(graphs)0 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 125 100 1249 4 v │ │ │ │ │ +1414 w Fl(BPG)26 b Fe(:)i Fk(DRAFT)f Fe(Jan)n(uary)f(7,)h(2024)p │ │ │ │ │ +2652 100 V 0 390 a Fb(1.2.2)112 b(Initializer)38 b(metho)s(ds)0 │ │ │ │ │ +562 y Fm(There)27 b(are)g(t)n(w)n(o)f(initializer)i(metho)r(ds.)101 │ │ │ │ │ +731 y(1.)42 b Fl(void)f(BPG_init)g(\()i(BPG)f(*bpg,)g(int)g(nX,)g(int)h │ │ │ │ │ +(nY,)f(Graph)g(*graph)f(\))i(;)208 858 y Fm(This)23 b(metho)r(d)i │ │ │ │ │ +(initializes)e(the)h Fl(BPG)f Fm(ob)5 b(ject)23 b(when)h(all)g(three)f │ │ │ │ │ +(of)h(its)g(\014elds)g(are)f(giv)n(en)g(in)h(the)g(calling)f(sequence.) │ │ │ │ │ +35 b(The)208 958 y Fl(Graph)22 b Fm(ob)5 b(ject)25 b(has)f │ │ │ │ │ +Fl(nX)42 b(+)i(nY)23 b Fm(v)n(ertices.)35 b(Note,)26 │ │ │ │ │ +b(the)f Fl(BPG)e Fm(ob)5 b(ject)24 b(no)n(w)g(\\o)n(wns")f(the)i │ │ │ │ │ +Fl(Graph)e Fm(ob)5 b(ject)24 b(and)h(so)e(will)i(free)208 │ │ │ │ │ +1057 y(the)31 b Fl(Graph)d Fm(ob)5 b(ject)31 b(when)g(it)g(is)g │ │ │ │ │ +(free'd.)46 b(The)31 b Fl(Graph)e Fm(ob)5 b(ject)30 b(ma)n(y)g(con)n │ │ │ │ │ +(tains)g(edges)g(b)r(et)n(w)n(een)h(no)r(des)f(in)h Fl(X)g │ │ │ │ │ +Fm(and)f Fl(Y)p Fm(,)208 1157 y(but)e(these)f(edges)g(are)g(sw)n(app)r │ │ │ │ │ +(ed)g(to)g(the)h(end)g(of)g(eac)n(h)f(adjacency)f(list)i(and)g(the)g │ │ │ │ │ +(size)f(of)h(eac)n(h)e(list)i(is)g(then)g(set.)208 1283 │ │ │ │ │ +y Fk(Err)l(or)k(che)l(cking:)44 b Fm(If)30 b Fl(bpg)f │ │ │ │ │ +Fm(or)g Fl(graph)f Fm(are)i Fl(NULL)p Fm(,)e(or)h(if)i │ │ │ │ │ +Fl(nX)26 b Fi(\024)h Fm(0,)j(or)g(if)g Fl(nY)d Fi(\024)f │ │ │ │ │ +Fm(0,)31 b(an)e(error)g(message)f(is)i(prin)n(ted)g(and)208 │ │ │ │ │ +1383 y(the)e(program)d(exits.)101 1536 y(2.)42 b Fl(void)f │ │ │ │ │ +(BPG_initFromColor)o(ing)c(\()43 b(BPG)f(*bpg,)g(Graph)f(*graph,)g(int) │ │ │ │ │ +h(colors[],)e(int)j(cX,)1428 1636 y(int)f(cY,)h(int)f(cmap[],)f(int)h │ │ │ │ │ +(indX[],)f(int)h(indY[])f(\))i(;)208 1762 y Fm(This)22 │ │ │ │ │ +b(metho)r(d)h(extracts)f(a)g(bipartite)g(graph)g(from)g(a)g │ │ │ │ │ +Fl(Graph)f Fm(ob)5 b(ject)22 b(where)g(the)h Fl(X)f Fm(v)n(ertices)g │ │ │ │ │ +(are)f(those)h(with)h Fl(cmap[])208 1862 y Fm(v)-5 b(alue)26 │ │ │ │ │ +b(equal)g(to)h Fl(cX)f Fm(and)h(the)g Fl(Y)f Fm(v)n(ertices)g(are)f │ │ │ │ │ +(those)i(with)g Fl(cmap[])d Fm(v)-5 b(alue)27 b(equal)f(to)h │ │ │ │ │ +Fl(cY)p Fm(.)f(The)h(v)n(ectors)e Fl(indX[])f Fm(and)208 │ │ │ │ │ +1962 y Fl(indY[])h Fm(hold)i(the)h(global)f(v)n(ertex)f(ids)i(of)f(the) │ │ │ │ │ +h Fl(X)g Fm(and)f Fl(Y)g Fm(v)n(ertices)g(resp)r(ectiv)n(ely)-7 │ │ │ │ │ +b(.)208 2088 y Fk(Err)l(or)32 b(che)l(cking:)43 b Fm(If)31 │ │ │ │ │ +b Fl(bpg)p Fm(,)e Fl(graph)p Fm(,)g Fl(colors)e Fm(or)i │ │ │ │ │ +Fl(cmap)g Fm(are)f Fl(NULL)p Fm(,)h(or)g(if)h Fl(cX)c │ │ │ │ │ +Fi(\024)h Fm(0,)j(or)f(if)i Fl(cY)26 b Fi(\024)g Fm(0,)k(or)f(if)i │ │ │ │ │ +Fl(cX)26 b Fm(=)h Fl(cY)o Fm(,)j(an)208 2188 y(error)25 │ │ │ │ │ +b(message)h(is)i(prin)n(ted)f(and)h(the)g(program)d(exits.)0 │ │ │ │ │ +2433 y Fb(1.2.3)112 b(Generate)38 b(induced)h(graphs)0 │ │ │ │ │ 2605 y Fm(Sometimes)25 b(w)n(e)f(need)h(to)g(kno)n(w)f(whic)n(h)h │ │ │ │ │ Fl(X)g Fm(or)f Fl(Y)g Fm(v)n(ertices)g(share)g(an)g(edge,)h(e.g.,)g(in) │ │ │ │ │ g(the)h Fl(BKL)d Fm(ob)5 b(ject)25 b(w)n(e)g(need)g(the)g(domain-)0 │ │ │ │ │ 2705 y(domain)k(adjacency)g(graph)f(\(the)i(domains)f(are)g(the)g │ │ │ │ │ Fl(X)h Fm(v)n(ertices\))e(to)i(e\016cien)n(tly)f(implemen)n(t)h(the)g │ │ │ │ │ (Fiduccia-Mattheyses)0 2804 y(algorithm.)36 b(W)-7 b(e)28 │ │ │ │ │ b(ha)n(v)n(e)e(t)n(w)n(o)h(metho)r(ds)h(to)f(generate)g(the)h(t)n(w)n │ │ │ │ │ @@ -5204,17 +5196,17 @@ │ │ │ │ │ Fk(Err)l(or)i(che)l(cking:)39 b Fm(If)27 b Fl(bpg)p Fm(,)f │ │ │ │ │ Fl(list)p Fm(,)g Fl(dist)f Fm(or)i Fl(mark)e Fm(is)i │ │ │ │ │ Fl(NULL)p Fm(,)f(or)g(if)i Fl(root)d Fm(is)i(not)g(in)g │ │ │ │ │ Fl([0,)43 b(nX+nY\))p Fm(,)25 b(an)h(error)g(message)208 │ │ │ │ │ 5407 y(is)h(prin)n(ted)h(and)f(the)h(program)e(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 83 100 1231 4 v 1397 100 a Fl(BPG)26 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)110 b Fe(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2630 100 V 1231 w Fm(5)0 390 y Fb(1.2.5)112 b(Dulmage-Mendelsohn)42 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1249 4 v 1414 100 a Fl(BPG)27 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)111 b Fe(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2612 100 V 1249 w Fm(5)0 390 y Fb(1.2.5)112 b(Dulmage-Mendelsohn)42 │ │ │ │ │ b(decomp)s(osition)c(metho)s(d)0 563 y Fm(There)32 b(is)h(one)f(metho)r │ │ │ │ │ (d)h(to)f(\014nd)h(the)g(Dulmage-Mendelsohn)f(decomp)r(osition)g(that)h │ │ │ │ │ (uses)f(matc)n(hing)g(when)h(the)g(graph)0 662 y(is)41 │ │ │ │ │ b(unit)g(w)n(eigh)n(t)f(and)g(a)h(generalized)e(matc)n(hing)h(tec)n │ │ │ │ │ (hnique)h(otherwise.)75 b(There)40 b(is)h(a)f(second)g(metho)r(d)h(to)g │ │ │ │ │ (\014nd)g(the)0 762 y(decomp)r(osition)30 b(using)g(a)h(F)-7 │ │ │ │ │ b(ord-F)g(ulk)n(erson)28 b(algorithm)i(to)g(\014nd)h(a)f(max)h(\015o)n │ │ │ │ │ @@ -5309,34 +5301,34 @@ │ │ │ │ │ 208 5280 y(v)-5 b(alue)27 b Fl(1)g Fm(is)h(returned.)36 │ │ │ │ │ b(If)28 b(an)g(IO)f(error)e(is)j(encoun)n(tered)f(from)g │ │ │ │ │ Fl(fscanf)p Fm(,)e(zero)i(is)g(returned.)208 5407 y Fk(Err)l(or)j(che)l │ │ │ │ │ (cking:)38 b Fm(If)28 b Fl(bpg)f Fm(or)g Fl(fp)f Fm(is)i │ │ │ │ │ Fl(NULL)e Fm(an)h(error)f(message)g(is)i(prin)n(ted)f(and)g(zero)g(is)g │ │ │ │ │ (returned.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fm(6)p 125 100 1231 4 v │ │ │ │ │ -1396 w Fl(BPG)27 b Fe(:)g Fk(DRAFT)h Fe(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)h(2025)p 2669 100 V 101 390 a Fm(3.)42 b Fl(int)g │ │ │ │ │ -(BPG_readFromBina)o(ry)o(Fil)o(e)37 b(\()44 b(BPG)e(*bpg,)f(FILE)h(*fp) │ │ │ │ │ -h(\))g(;)208 523 y Fm(This)24 b(metho)r(d)i(reads)e(a)g │ │ │ │ │ -Fl(BPG)g Fm(ob)5 b(ject)25 b(from)f(a)h(binary)f(\014le.)36 │ │ │ │ │ -b(If)26 b(there)e(are)g(no)h(errors)e(in)i(reading)f(the)h(data,)g(the) │ │ │ │ │ -g(v)-5 b(alue)208 623 y Fl(1)27 b Fm(is)g(returned.)37 │ │ │ │ │ -b(If)28 b(an)f(IO)g(error)f(is)h(encoun)n(tered)g(from)g │ │ │ │ │ -Fl(fread)p Fm(,)f(zero)h(is)g(returned.)208 756 y Fk(Err)l(or)j(che)l │ │ │ │ │ -(cking:)38 b Fm(If)28 b Fl(bpg)f Fm(or)g Fl(fp)f Fm(is)i │ │ │ │ │ -Fl(NULL)e Fm(an)h(error)f(message)g(is)i(prin)n(ted)f(and)g(zero)g(is)g │ │ │ │ │ -(returned.)101 922 y(4.)42 b Fl(int)g(BPG_writeToFile)37 │ │ │ │ │ -b(\()43 b(BPG)g(*bpg,)e(char)h(*fn)h(\))g(;)208 1055 │ │ │ │ │ -y Fm(This)20 b(metho)r(d)h(writes)g(a)f Fl(BPG)g Fm(ob)5 │ │ │ │ │ -b(ject)20 b(to)h(a)f(\014le.)35 b(The)20 b(metho)r(d)i(tries)e(to)g(op) │ │ │ │ │ -r(en)h(the)g(\014le)g(and)g(if)g(it)g(is)g(successful,)g(it)h(then)208 │ │ │ │ │ -1154 y(calls)h Fl(BPG)p 526 1154 27 4 v 30 w(writeFromFormatte)o(dF)o │ │ │ │ │ -(ile)o(\(\))18 b Fm(or)23 b Fl(BPG)p 1857 1154 V 30 w(writeFromBinaryF) │ │ │ │ │ -o(il)o(e\(\))o Fm(,)c(closes)k(the)i(\014le)f(and)g(returns)g(the)208 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fm(6)p 125 100 1249 4 v │ │ │ │ │ +1414 w Fl(BPG)26 b Fe(:)i Fk(DRAFT)f Fe(Jan)n(uary)f(7,)h(2024)p │ │ │ │ │ +2652 100 V 101 390 a Fm(3.)42 b Fl(int)g(BPG_readFromBina)o(ry)o(Fil)o │ │ │ │ │ +(e)37 b(\()44 b(BPG)e(*bpg,)f(FILE)h(*fp)h(\))g(;)208 │ │ │ │ │ +523 y Fm(This)24 b(metho)r(d)i(reads)e(a)g Fl(BPG)g Fm(ob)5 │ │ │ │ │ +b(ject)25 b(from)f(a)h(binary)f(\014le.)36 b(If)26 b(there)e(are)g(no)h │ │ │ │ │ +(errors)e(in)i(reading)f(the)h(data,)g(the)g(v)-5 b(alue)208 │ │ │ │ │ +623 y Fl(1)27 b Fm(is)g(returned.)37 b(If)28 b(an)f(IO)g(error)f(is)h │ │ │ │ │ +(encoun)n(tered)g(from)g Fl(fread)p Fm(,)f(zero)h(is)g(returned.)208 │ │ │ │ │ +756 y Fk(Err)l(or)j(che)l(cking:)38 b Fm(If)28 b Fl(bpg)f │ │ │ │ │ +Fm(or)g Fl(fp)f Fm(is)i Fl(NULL)e Fm(an)h(error)f(message)g(is)i(prin)n │ │ │ │ │ +(ted)f(and)g(zero)g(is)g(returned.)101 922 y(4.)42 b │ │ │ │ │ +Fl(int)g(BPG_writeToFile)37 b(\()43 b(BPG)g(*bpg,)e(char)h(*fn)h(\))g │ │ │ │ │ +(;)208 1055 y Fm(This)20 b(metho)r(d)h(writes)g(a)f Fl(BPG)g │ │ │ │ │ +Fm(ob)5 b(ject)20 b(to)h(a)f(\014le.)35 b(The)20 b(metho)r(d)i(tries)e │ │ │ │ │ +(to)g(op)r(en)h(the)g(\014le)g(and)g(if)g(it)g(is)g(successful,)g(it)h │ │ │ │ │ +(then)208 1154 y(calls)h Fl(BPG)p 526 1154 27 4 v 30 │ │ │ │ │ +w(writeFromFormatte)o(dF)o(ile)o(\(\))18 b Fm(or)23 b │ │ │ │ │ +Fl(BPG)p 1857 1154 V 30 w(writeFromBinaryF)o(il)o(e\(\))o │ │ │ │ │ +Fm(,)c(closes)k(the)i(\014le)f(and)g(returns)g(the)208 │ │ │ │ │ 1254 y(v)-5 b(alue)27 b(returned)g(from)g(the)h(called)g(routine.)208 │ │ │ │ │ 1387 y Fk(Err)l(or)f(che)l(cking:)38 b Fm(If)25 b Fl(bpg)f │ │ │ │ │ Fm(or)g Fl(fn)g Fm(is)h Fl(NULL)p Fm(,)e(or)h(if)i Fl(fn)e │ │ │ │ │ Fm(is)h(not)g(of)g(the)g(form)g Fl(*.bpgf)d Fm(\(for)j(a)f(formatted)h │ │ │ │ │ (\014le\))g(or)f Fl(*.bpgb)208 1487 y Fm(\(for)j(a)g(binary)g │ │ │ │ │ (\014le\),)h(an)f(error)f(message)g(is)i(prin)n(ted)f(and)h(the)g │ │ │ │ │ (metho)r(d)g(returns)f(zero.)101 1653 y(5.)42 b Fl(int)g │ │ │ │ │ @@ -5402,17 +5394,17 @@ │ │ │ │ │ (the)h(input)g(\014le)f(for)g(the)h Fl(BPG)e Fm(ob)5 │ │ │ │ │ b(ject.)60 b(It)35 b(m)n(ust)h(b)r(e)f(of)h(the)f(form)g │ │ │ │ │ Fl(*.bpgf)e Fm(or)390 5407 y Fl(*.bpgb)p Fm(.)i(The)27 │ │ │ │ │ b Fl(BPG)g Fm(ob)5 b(ject)27 b(is)h(read)e(from)i(the)g(\014le)f(via)g │ │ │ │ │ (the)h Fl(BPG)p 2449 5407 V 31 w(readFromFile\(\))21 │ │ │ │ │ b Fm(metho)r(d.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 83 100 1231 4 v 1397 100 a Fl(BPG)26 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)110 b Fe(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2630 100 V 1231 w Fm(7)307 390 y Fh(\210)42 b Fm(The)33 │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1249 4 v 1414 100 a Fl(BPG)27 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)111 b Fe(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2612 100 V 1249 w Fm(7)307 390 y Fh(\210)42 b Fm(The)33 │ │ │ │ │ b Fl(outFile)d Fm(parameter)i(is)g(the)i(output)f(\014le)g(for)g(the)g │ │ │ │ │ Fl(BPG)f Fm(ob)5 b(ject.)52 b(If)33 b Fl(outFile)d Fm(is)j │ │ │ │ │ Fl(none)f Fm(then)h(the)g Fl(BPG)390 490 y Fm(ob)5 b(ject)30 │ │ │ │ │ b(is)f(not)h(written)f(to)h(a)f(\014le.)43 b(Otherwise,)30 │ │ │ │ │ b(the)g Fl(BPG)p 2219 490 27 4 v 30 w(writeToFile\(\))24 │ │ │ │ │ b Fm(metho)r(d)30 b(is)g(called)f(to)g(write)h(the)390 │ │ │ │ │ 589 y(graph)c(to)g(a)h(formatted)f(\014le)h(\(if)g Fl(outFile)d │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -29,15 +29,15 @@ │ │ │ │ │ │ code for the process outweighed (outline’d?) the BPG code for the data. Now if someone wants to modify │ │ │ │ │ │ (and hopefully improve) the Kernighan-Lin process, they won’t alter the behavior of the bipartite graph │ │ │ │ │ │ object. │ │ │ │ │ │ Finding the Dulmage-Mendelsohn decomposition of a bipartite graph is a little less clear cut. When the │ │ │ │ │ │ vertices in the bipartite graph have unit weight, the process is straightforward. │ │ │ │ │ │ • Find a maximum matching. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 BPG : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 BPG : DRAFT January 7, 2024 │ │ │ │ │ │ • Drop an alternating level structure from exposed nodes in X. │ │ │ │ │ │ • Drop an alternating level structure from exposed nodes in Y . │ │ │ │ │ │ • Based on the two previous steps, partition X into three pieces and Y into three pieces and form a new │ │ │ │ │ │ separator from the pieces. │ │ │ │ │ │ (If these terms are not familiar, see [?]; our present purpose is a discussion of software design, not algorithms.) │ │ │ │ │ │ Amatching is a very common operation on a bipartite graph, so it is not unreasonable to expand the data │ │ │ │ │ │ object to include some mechanism for matching, e.g., a mate[] vector. Finding a maximum matching is │ │ │ │ │ │ @@ -78,15 +78,15 @@ │ │ │ │ │ │ b │ │ │ │ │ │ separator size. But, if we consider S ∪ (Adj(S) ∩ B) to be a wide separator, the resulting separator S need │ │ │ │ │ │ not be a separator with minimal weight that is found within the wide separator. The trick is that some │ │ │ │ │ │ nodes in Adj(S)∩B might be absorbed into W. │ │ │ │ │ │ Onecanfindaseparatorwith minimal weight from the wide separator S∪(Adj(S)∩B), in fact from any │ │ │ │ │ │ wide separator that contains S, by solving a max flow problem. The drawback is that the network induced │ │ │ │ │ │ by S∪(Adj(S)∩B) need not be bipartite. In other words, a bipartite induced graph necessarily implies two │ │ │ │ │ │ - BPG : DRAFT February 8, 2025 3 │ │ │ │ │ │ + BPG : DRAFT January 7, 2024 3 │ │ │ │ │ │ layers to the wide separator, but the converse does not hold. We were then free to examine wide separators │ │ │ │ │ │ that had more than two layers from which to find a minimal weight separator. It turns out that three layers │ │ │ │ │ │ is better than two, in practice. │ │ │ │ │ │ We did write a separate object to solve our max flow problem; see the Network object. To smooth a │ │ │ │ │ │ separator, i.e., to improve a 2-set partition, we no longer have need of the bipartite graph object. We leave │ │ │ │ │ │ the two Dulmage-Mendelsohn methods in the BPG object for historical and sentimental reasons. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ @@ -110,15 +110,15 @@ │ │ │ │ │ │ This method releases the storage for graph via a call to Graph clearData(), and then the structure’s │ │ │ │ │ │ fields are then set to their default values with a call to BPG setDefaultFields(). │ │ │ │ │ │ Error checking: If bpg is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void BPG_free ( BPG *bpg ) ; │ │ │ │ │ │ This method releases any storage by a call to BPG clearData()then free’s the storage for the structure │ │ │ │ │ │ with a call to free(). │ │ │ │ │ │ Error checking: If bpg is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 4 BPG : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 BPG : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.2 Initializer methods │ │ │ │ │ │ There are two initializer methods. │ │ │ │ │ │ 1. void BPG_init ( BPG *bpg, int nX, int nY, Graph *graph ) ; │ │ │ │ │ │ This method initializes the BPG object when all three of its fields are given in the calling sequence. The │ │ │ │ │ │ Graphobject has nX + nY vertices. Note, the BPG object now “owns” the Graph object and so will free │ │ │ │ │ │ the Graph object when it is free’d. The Graph object may contains edges between nodes in X and Y, │ │ │ │ │ │ but these edges are swapped to the end of each adjacency list and the size of each list is then set. │ │ │ │ │ │ @@ -151,15 +151,15 @@ │ │ │ │ │ │ int mark[], int tag ) ; │ │ │ │ │ │ This method drops a level structure from vertex root, fills the dist[] vector with the distances from │ │ │ │ │ │ root, and returns the number of levels created. The mark[] vector is used to mark nodes with the tag │ │ │ │ │ │ value as they are placed in the level structure. The list[] vector is used to accumulate the nodes as │ │ │ │ │ │ they are placed in the level structure. │ │ │ │ │ │ Error checking: If bpg, list, dist or mark is NULL, or if root is not in [0, nX+nY), an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ - BPG : DRAFT February 8, 2025 5 │ │ │ │ │ │ + BPG : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.2.5 Dulmage-Mendelsohn decomposition method │ │ │ │ │ │ There is one method to find the Dulmage-Mendelsohn decomposition that uses matching when the graph │ │ │ │ │ │ is unit weight and a generalized matching technique otherwise. There is a second method to find the │ │ │ │ │ │ decomposition using a Ford-Fulkerson algorithm to find a max flow and a min-cut on a bipartite network. │ │ │ │ │ │ This has largely been superceded by the Network object. │ │ │ │ │ │ 1. void BPG_DMdecomposition ( BPG *bpg, int dmflags[], int stats[], │ │ │ │ │ │ int msglvl, FILE *msgFile ) │ │ │ │ │ │ @@ -204,15 +204,15 @@ │ │ │ │ │ │ the value returned from the called routine. │ │ │ │ │ │ Error checking: If bpg or fn is NULL, or if fn is not of the form *.bpgf (for a formatted file) or *.bpgb │ │ │ │ │ │ (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ 2. int BPG_readFromFormattedFile ( BPG *bpg, FILE *fp ) ; │ │ │ │ │ │ This method reads a BPG object from a formatted file. If there are no errors in reading the data, the │ │ │ │ │ │ value 1 is returned. If an IO error is encountered from fscanf, zero is returned. │ │ │ │ │ │ Error checking: If bpg or fp is NULL an error message is printed and zero is returned. │ │ │ │ │ │ - 6 BPG : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 BPG : DRAFT January 7, 2024 │ │ │ │ │ │ 3. int BPG_readFromBinaryFile ( BPG *bpg, FILE *fp ) ; │ │ │ │ │ │ This method reads a BPG object from a binary file. If there are no errors in reading the data, the value │ │ │ │ │ │ 1 is returned. If an IO error is encountered from fread, zero is returned. │ │ │ │ │ │ Error checking: If bpg or fp is NULL an error message is printed and zero is returned. │ │ │ │ │ │ 4. int BPG_writeToFile ( BPG *bpg, char *fn ) ; │ │ │ │ │ │ ThismethodwritesaBPGobjecttoafile. Themethodtriestoopenthefileandifitissuccessful,it then │ │ │ │ │ │ calls BPG writeFromFormattedFile()or BPG writeFromBinaryFile(),closes the file and returns the │ │ │ │ │ │ @@ -243,15 +243,15 @@ │ │ │ │ │ │ BPG writeStats() method). │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means the BPG │ │ │ │ │ │ object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • The inFile parameter is the input file for the BPG object. It must be of the form *.bpgf or │ │ │ │ │ │ *.bpgb. The BPG object is read from the file via the BPG readFromFile() method. │ │ │ │ │ │ - BPG : DRAFT February 8, 2025 7 │ │ │ │ │ │ + BPG : DRAFT January 7, 2024 7 │ │ │ │ │ │ • The outFile parameter is the output file for the BPG object. If outFile is none then the BPG │ │ │ │ │ │ object is not written to a file. Otherwise, the BPG writeToFile() method is called to write the │ │ │ │ │ │ graph to a formatted file (if outFile is of the form *.bpgf), or a binary file (if outFile is of the │ │ │ │ │ │ form *.bpgb). │ │ │ │ │ │ 2. extractBPG msglvl msgFile inGraphFile inCompidsIVfile │ │ │ │ │ │ icomp outMapFile outBPGfile │ │ │ │ │ │ This driver program reads in a Graph object and an IV object that contains the component ids. (A │ │ │ ├── ./usr/share/doc/spooles-doc/Chv.ps.gz │ │ │ │ ├── Chv.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Chv.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2517,21 +2517,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2715,88 +2714,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5386,15 +5380,15 @@ │ │ │ │ │ X/IEn X │ │ │ │ │ %EndDVIPSBitmapFont │ │ │ │ │ /Ff 134[71 2[71 75 52 53 55 1[75 67 75 112 3[37 75 67 │ │ │ │ │ 41 61 75 60 1[65 13[75 2[92 11[103 16[67 67 67 2[37 46[{}25 │ │ │ │ │ 119.552 /CMBX12 rf /Fg 132[52 8[43 1[58 52 58 10[46 99[{}6 │ │ │ │ │ 90.9091 /CMBX10 rf /Fh 149[25 2[45 45 60[91 19[71 71 │ │ │ │ │ 17[71 1[71{}8 90.9091 /CMSY10 rf /Fi 134[48 3[51 2[36 │ │ │ │ │ -12[40 2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 │ │ │ │ │ +3[51 12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 │ │ │ │ │ 90.9091 /CMSL10 rf /Fj 138[56 1[42 55 1[51 2[68 47 58 │ │ │ │ │ 4[49 51 1[54 1[56 97[{}11 90.9091 /CMCSC10 rf /Fk 163[47 │ │ │ │ │ 77[35 14[{}2 66.4176 /CMSY8 rf /Fl 134[44 42 2[49 30 │ │ │ │ │ 37 38 42 46 46 51 74 23 42 1[28 46 42 28 42 46 42 42 │ │ │ │ │ 46 12[65 1[66 11[59 62 69 2[68 6[28 44[53 1[56 11[{}31 │ │ │ │ │ 90.9091 /CMTI10 rf /Fm 133[48 48 48 48 48 48 48 48 48 │ │ │ │ │ 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 1[48 │ │ │ │ │ @@ -5522,34 +5516,34 @@ │ │ │ │ │ (\(e.g.,)i Fj(umfp)-6 b(a)n(ck)34 b Fn(and)j Fj(superlu)p │ │ │ │ │ Fn(\),)f(then)h(w)m(e)g(can)g(mo)s(dify)0 5272 y(the)31 │ │ │ │ │ b Fm(Chv)e Fn(ob)5 b(ject)31 b(to)g(handle)f(unequal)g(ro)m(ws)h(and)e │ │ │ │ │ (columns.)141 5407 y(During)h(a)h(factorization,)i(a)e(fron)m(t)f(has)h │ │ │ │ │ (to)g(tak)m(e)h(part)e(in)g(four)g(distinct)g(op)s(erations.)1927 │ │ │ │ │ 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fn(2)p 136 100 1158 4 v │ │ │ │ │ -1340 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2743 100 V 111 399 a Fn(1.)46 b(Assem)m(ble)39 │ │ │ │ │ -b(en)m(tries)g(from)f(the)h(original)g(matrix)g(\(or)g(matrix)f(p)s │ │ │ │ │ -(encil\).)65 b(\(See)39 b(the)g Fm(Chv)p 3300 399 29 │ │ │ │ │ -4 v 33 w(addChevron\(\))227 511 y Fn(metho)s(d.\))111 │ │ │ │ │ -698 y(2.)46 b(Accum)m(ulate)32 b(up)s(dates)e(from)g(descendan)m(t)g │ │ │ │ │ -(fron)m(ts.)41 b(\(See)31 b(the)f Fm(Chv)p 2548 698 V │ │ │ │ │ -34 w(update)p Fh(f)p Fm(S,H,N)p Fh(g)p Fm(\(\))e Fn(metho)s(ds.\))111 │ │ │ │ │ -885 y(3.)46 b(Assem)m(ble)21 b(an)m(y)g(p)s(ostp)s(oned)e(data)i(from)e │ │ │ │ │ -(its)i(c)m(hildren)f(fron)m(ts.)37 b(\(See)21 b(the)g │ │ │ │ │ -Fm(Chv)p 2837 885 V 33 w(assemblePostponedData\(\))227 │ │ │ │ │ -998 y Fn(metho)s(d.\))111 1185 y(4.)46 b(Compute)20 b(the)h │ │ │ │ │ -(factorization)i(of)d(the)g(completely)i(assem)m(bled)f(fron)m(t.)38 │ │ │ │ │ -b(\(See)20 b(the)h Fm(Chv)p 3118 1185 V 33 w(factor\(\))d │ │ │ │ │ -Fn(metho)s(d.\))141 1396 y(The)35 b(implemen)m(tor)h(of)g(a)f(fron)m(t) │ │ │ │ │ -h(ob)5 b(ject)36 b(has)f(a)h(great)g(deal)g(of)g(freedom)f(to)h(design) │ │ │ │ │ -f(the)h(underlying)e(data)0 1509 y(structures.)57 b(W)-8 │ │ │ │ │ -b(e)37 b(ha)m(v)m(e)h(c)m(hosen)e(to)h(store)g(the)f(en)m(tries)h(in)f │ │ │ │ │ -(eac)m(h)h(single)g(c)m(hevron)f(in)g(con)m(tiguous)h(memory)f(|)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 136 100 1177 4 v │ │ │ │ │ +1359 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2724 100 V 111 399 a Fn(1.)46 b(Assem)m(ble)39 b(en)m(tries)g(from)f │ │ │ │ │ +(the)h(original)g(matrix)g(\(or)g(matrix)f(p)s(encil\).)65 │ │ │ │ │ +b(\(See)39 b(the)g Fm(Chv)p 3300 399 29 4 v 33 w(addChevron\(\))227 │ │ │ │ │ +511 y Fn(metho)s(d.\))111 698 y(2.)46 b(Accum)m(ulate)32 │ │ │ │ │ +b(up)s(dates)e(from)g(descendan)m(t)g(fron)m(ts.)41 b(\(See)31 │ │ │ │ │ +b(the)f Fm(Chv)p 2548 698 V 34 w(update)p Fh(f)p Fm(S,H,N)p │ │ │ │ │ +Fh(g)p Fm(\(\))e Fn(metho)s(ds.\))111 885 y(3.)46 b(Assem)m(ble)21 │ │ │ │ │ +b(an)m(y)g(p)s(ostp)s(oned)e(data)i(from)e(its)i(c)m(hildren)f(fron)m │ │ │ │ │ +(ts.)37 b(\(See)21 b(the)g Fm(Chv)p 2837 885 V 33 w │ │ │ │ │ +(assemblePostponedData\(\))227 998 y Fn(metho)s(d.\))111 │ │ │ │ │ +1185 y(4.)46 b(Compute)20 b(the)h(factorization)i(of)d(the)g │ │ │ │ │ +(completely)i(assem)m(bled)f(fron)m(t.)38 b(\(See)20 │ │ │ │ │ +b(the)h Fm(Chv)p 3118 1185 V 33 w(factor\(\))d Fn(metho)s(d.\))141 │ │ │ │ │ +1396 y(The)35 b(implemen)m(tor)h(of)g(a)f(fron)m(t)h(ob)5 │ │ │ │ │ +b(ject)36 b(has)f(a)h(great)g(deal)g(of)g(freedom)f(to)h(design)f(the)h │ │ │ │ │ +(underlying)e(data)0 1509 y(structures.)57 b(W)-8 b(e)37 │ │ │ │ │ +b(ha)m(v)m(e)h(c)m(hosen)e(to)h(store)g(the)f(en)m(tries)h(in)f(eac)m │ │ │ │ │ +(h)h(single)g(c)m(hevron)f(in)g(con)m(tiguous)h(memory)f(|)0 │ │ │ │ │ 1621 y(the)31 b(\014rst)f(en)m(try)h(of)g(a)h(c)m(hevron)f(is)g(in)f │ │ │ │ │ (the)h(last)h(ro)m(w)f(of)g(the)g(fron)m(t,)g(the)g(last)h(en)m(try)f │ │ │ │ │ (of)g(a)g(c)m(hevron)h(is)e(in)h(the)g(last)0 1734 y(column)h(of)h(the) │ │ │ │ │ g(fron)m(t.)47 b(The)32 b(\014gure)g(b)s(elo)m(w)g(sho)m(ws)h(the)f │ │ │ │ │ (storage)i(lo)s(cations)g(for)e(the)h(en)m(tries)g(|)g(on)f(the)h(left) │ │ │ │ │ g(is)0 1847 y(a)e(nonsymmetric)f(c)m(hevron,)h(on)f(the)h(righ)m(t)g │ │ │ │ │ (is)f(a)h(symmetric)f(or)h(hermitian)f(c)m(hevron.)1290 │ │ │ │ │ @@ -5715,17 +5709,17 @@ │ │ │ │ │ b(is)f(inheren)m(tly)g(a)h(serial,)g(single)g(threaded)e(ob)5 │ │ │ │ │ b(ject,)34 b(meaning)e(it)g(is)g(designed)g(so)g(that)h(only)0 │ │ │ │ │ 5407 y(one)h(thread)g(or)f(pro)s(cess)h(\\o)m(wns")g(or)g(op)s(erates)g │ │ │ │ │ (on)g(a)g(particular)g Fm(Chv)f Fn(ob)5 b(ject.)51 b(A)34 │ │ │ │ │ b Fm(Chv)f Fn(ob)5 b(ject)35 b(is)e(an)h(\\atom")p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1158 4 v 1339 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)121 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2695 100 V 1158 w Fn(3)0 399 y(of)38 b(comm)m(unication.)63 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1177 4 v 1358 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)40 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2676 100 V 1177 w Fn(3)0 399 y(of)38 b(comm)m(unication.)63 │ │ │ │ │ b(It)37 b(stores)h(p)s(ostp)s(oned)e(ro)m(ws)h(and)g(columns)g(to)h(b)s │ │ │ │ │ (e)f(assem)m(bled)h(in)f(a)g(paren)m(t)h(fron)m(t.)62 │ │ │ │ │ b(It)0 511 y(migh)m(t)28 b(ha)m(v)m(e)h(to)f(b)s(e)f(written)g(to)h │ │ │ │ │ (and)f(read)g(from)g(a)h(\014le)f(in)h(an)f(out-of-core)i(implemen)m │ │ │ │ │ (tation.)41 b(In)27 b(a)h(distributed)0 624 y(en)m(vironmen)m(t,)34 │ │ │ │ │ b(it)e(is)h(comm)m(unicated)g(b)s(et)m(w)m(een)g(pro)s(cesses.)46 │ │ │ │ │ b(F)-8 b(or)33 b(these)g(reasons,)g(w)m(e)g(designed)f(the)h(ob)5 │ │ │ │ │ @@ -5794,19 +5788,19 @@ │ │ │ │ │ b Fm(int)i(*colind)29 b Fn(:)40 b(p)s(oin)m(ter)31 b(to)g(the)f(base)h │ │ │ │ │ (address)e(of)i(the)f Fm(int)g Fn(v)m(ector)i(that)f(con)m(tains)g │ │ │ │ │ (column)g(indices.)137 5407 y Fe(\210)45 b Fm(double)h(*entries)22 │ │ │ │ │ b Fn(:)37 b(p)s(oin)m(ter)23 b(to)h(the)g(base)g(address)e(of)i(the)g │ │ │ │ │ Fm(double)d Fn(v)m(ector)k(that)g(con)m(tains)f(the)g(en)m(tries.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fn(4)p 136 100 1158 4 v │ │ │ │ │ -1340 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2743 100 V 137 399 a Fe(\210)45 b Fm(DV)i(wrkDV)29 │ │ │ │ │ -b Fn(:)i(ob)5 b(ject)31 b(that)g(manages)g(the)g(o)m(wned)f(w)m(orking) │ │ │ │ │ -h(storage.)137 586 y Fe(\210)45 b Fm(Chv)i(*next)29 b │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 136 100 1177 4 v │ │ │ │ │ +1359 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2724 100 V 137 399 a Fe(\210)45 b Fm(DV)i(wrkDV)29 b │ │ │ │ │ +Fn(:)i(ob)5 b(ject)31 b(that)g(manages)g(the)g(o)m(wned)f(w)m(orking)h │ │ │ │ │ +(storage.)137 586 y Fe(\210)45 b Fm(Chv)i(*next)29 b │ │ │ │ │ Fn(:)41 b(link)30 b(to)h(a)g(next)f(ob)5 b(ject)32 b(in)e(a)h(singly)f │ │ │ │ │ (link)m(ed)h(list.)141 798 y(One)f(can)h(query)f(the)g(t)m(yp)s(e)h │ │ │ │ │ (and)e(symmetry)h(of)h(the)f(ob)5 b(ject)32 b(using)e(these)g(simple)h │ │ │ │ │ (macros.)137 1011 y Fe(\210)45 b Fm(CHV)p 377 1011 29 │ │ │ │ │ 4 v 34 w(IS)p 507 1011 V 34 w(REAL\(chv\))27 b Fn(is)k │ │ │ │ │ Fm(1)f Fn(if)g Fm(chv)g Fn(has)g(real)h(en)m(tries)g(and)f │ │ │ │ │ Fm(0)g Fn(otherwise.)137 1198 y Fe(\210)45 b Fm(CHV)p │ │ │ │ │ @@ -5864,17 +5858,17 @@ │ │ │ │ │ (call)i(to)f Fm(Chv)p 2235 5144 V 33 w(clearData\(\))c │ │ │ │ │ Fn(and)i(then)h(free)g(the)h(space)f(for)227 5257 y Fm(chv)p │ │ │ │ │ Fn(.)227 5407 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fn(If)30 b Fm(chv)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)g(the)g(program)g(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1158 4 v 1339 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)121 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2695 100 V 1158 w Fn(5)0 399 y Fc(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1177 4 v 1358 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)40 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2676 100 V 1177 w Fn(5)0 399 y Fc(1.2.2)112 b(Instance)38 │ │ │ │ │ b(metho)s(ds)111 595 y Fn(1.)46 b Fm(int)h(Chv_id)f(\()i(Chv)f(*chv)f │ │ │ │ │ (\))i(;)227 746 y Fn(This)30 b(metho)s(d)g(returns)f(the)h │ │ │ │ │ Fl(id)h Fn(of)g(the)f(ob)5 b(ject.)227 897 y Fl(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 b Fm(chv)g Fn(is)g │ │ │ │ │ Fm(NULL)p Fn(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)g(zero)h │ │ │ │ │ (is)f(returned.)111 1086 y(2.)46 b Fm(int)h(Chv_type)f(\()h(Chv)g(*chv) │ │ │ │ │ g(\))g(;)227 1236 y Fn(This)30 b(metho)s(d)g(returns)f(the)h │ │ │ │ │ @@ -5934,25 +5928,25 @@ │ │ │ │ │ Fl(double)k(pr)-5 b(e)g(cision)32 b(c)-5 b(omplex)30 │ │ │ │ │ b Fn(en)m(tries,)g(equal)f(to)g(one)g(half)g(the)f(n)m(um)m(b)s(er)227 │ │ │ │ │ 5256 y(of)j(double)f(precision)g(en)m(tries)h(that)g(are)g(stored.)227 │ │ │ │ │ 5407 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ b Fm(chv)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)g(zero)h(is)f(returned.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fn(6)p 136 100 1158 4 v │ │ │ │ │ -1340 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2743 100 V 111 399 a Fn(8.)46 b Fm(double)g(*)i │ │ │ │ │ -(Chv_entries)d(\()i(Chv)g(*chv)g(\))g(;)227 548 y Fn(This)40 │ │ │ │ │ -b(metho)s(d)h(returns)f(the)h Fl(entries)g Fn(\014eld)g(of)g(the)g(ob)5 │ │ │ │ │ -b(ject,)45 b(a)c(p)s(oin)m(ter)g(to)h(the)f(base)g(lo)s(cation)i(of)e │ │ │ │ │ -(the)227 661 y(double)30 b(precision)h(arra)m(y)g(that)g(stores)f(the)h │ │ │ │ │ -(complex)g(data.)227 810 y Fl(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ -b(cking:)40 b Fn(If)30 b Fm(chv)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ -(message)h(is)g(prin)m(ted)f(and)g(zero)h(is)f(returned.)111 │ │ │ │ │ -995 y(9.)46 b Fm(double)g(*)i(Chv_diagLocation)43 b(\()48 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 136 100 1177 4 v │ │ │ │ │ +1359 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2724 100 V 111 399 a Fn(8.)46 b Fm(double)g(*)i(Chv_entries)d(\()i(Chv) │ │ │ │ │ +g(*chv)g(\))g(;)227 548 y Fn(This)40 b(metho)s(d)h(returns)f(the)h │ │ │ │ │ +Fl(entries)g Fn(\014eld)g(of)g(the)g(ob)5 b(ject,)45 │ │ │ │ │ +b(a)c(p)s(oin)m(ter)g(to)h(the)f(base)g(lo)s(cation)i(of)e(the)227 │ │ │ │ │ +661 y(double)30 b(precision)h(arra)m(y)g(that)g(stores)f(the)h(complex) │ │ │ │ │ +g(data.)227 810 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fn(If)30 b Fm(chv)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g(message)h │ │ │ │ │ +(is)g(prin)m(ted)f(and)g(zero)h(is)f(returned.)111 995 │ │ │ │ │ +y(9.)46 b Fm(double)g(*)i(Chv_diagLocation)43 b(\()48 │ │ │ │ │ b(Chv)f(*chv,)f(int)h(ichv)f(\))i(;)227 1145 y Fn(This)33 │ │ │ │ │ b(metho)s(d)f(returns)g(a)i(p)s(oin)m(ter)f(to)h(the)f(address)f(of)i │ │ │ │ │ (the)f(en)m(try)g(in)g(the)h Fm(ichv)p Fn('th)e(diagonal)i(lo)s │ │ │ │ │ (cation.)227 1257 y(F)-8 b(or)31 b(a)g(real)g(c)m(hevron,)g(to)g │ │ │ │ │ (\014nd)e(the)i(en)m(try)f Fm(k)h Fn(places)g(to)g(the)g(righ)m(t)g(of) │ │ │ │ │ f(the)h(diagonal)g(en)m(try)-8 b(,)32 b(add)e Fm(k)g │ │ │ │ │ Fn(to)h(the)227 1370 y(address.)62 b(T)-8 b(o)38 b(\014nd)e(an)i(en)m │ │ │ │ │ @@ -6024,17 +6018,17 @@ │ │ │ │ │ b Fn(+)g Fm(nU)o Fn(.)227 5294 y Fl(Err)-5 b(or)37 b(che)-5 │ │ │ │ │ b(cking:)45 b Fn(If)32 b Fm(chv)p Fn(,)h Fm(pReal)e Fn(or)i │ │ │ │ │ Fm(pImag)e Fn(is)i Fm(NULL)p Fn(,)f(or)h(if)g Fm(irow)e │ │ │ │ │ Fn(or)i Fm(jcol)f Fn(is)h(out)g(of)g(range,)h(an)e(error)227 │ │ │ │ │ 5407 y(message)g(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1158 4 v 1339 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)121 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2695 100 V 1158 w Fn(7)66 399 y(15.)46 b Fm(Chv_locationOfComplexEntr)o │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1177 4 v 1358 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)40 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2676 100 V 1177 w Fn(7)66 399 y(15.)46 b Fm(Chv_locationOfComplexEntr)o │ │ │ │ │ (y)c(\()47 b(Chv)g(*chv,)g(int)g(irow,)f(int)h(jcol,)1611 │ │ │ │ │ 511 y(double)f(**ppReal,)g(double)g(**ppImag)f(\))j(;)227 │ │ │ │ │ 666 y Fn(This)29 b(metho)s(d)g(\014lls)h Fm(*ppReal)e │ │ │ │ │ Fn(with)h(a)h(p)s(oin)m(ter)g(to)h(the)f(real)g(part)g(and)f │ │ │ │ │ Fm(*ppImag)f Fn(with)h(a)h(p)s(oin)m(ter)g(to)h(the)227 │ │ │ │ │ 779 y(imaginary)37 b(part)g(of)f(the)h(en)m(try)f(in)g(ro)m(w)h │ │ │ │ │ Fm(irow)e Fn(and)h(column)g Fm(jcol)p Fn(.)58 b(Note,)39 │ │ │ │ │ @@ -6107,30 +6101,29 @@ │ │ │ │ │ b(,)33 b(the)f(w)m(orkspace)h(bu\013er)e(o)m(wned)h(b)m(y)f(the)h │ │ │ │ │ Fm(Chv)f Fn(ob)5 b(ject)33 b(is)f(sen)m(t)h(and)227 5253 │ │ │ │ │ y(receiv)m(ed.)227 5407 y Fl(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fn(If)30 b Fm(chv)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ (message)h(is)g(prin)m(ted)f(and)g(zero)h(is)f(returned.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fn(8)p 136 100 1158 4 v │ │ │ │ │ -1340 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2743 100 V 0 399 a Fc(1.2.4)112 b(Searc)m(h)38 │ │ │ │ │ -b(metho)s(ds)111 604 y Fn(1.)46 b Fm(int)h(Chv_maxabsInDiagonal11)42 │ │ │ │ │ -b(\()47 b(Chv)g(*chv,)g(int)g(mark[],)e(int)i(tag,)g(double)f(*pmaxval) │ │ │ │ │ -g(\))h(;)227 763 y Fn(This)34 b(metho)s(d)g(returns)f(the)i(lo)s │ │ │ │ │ -(cation)h(of)f(the)g(\014rst)f(tagged)i(elemen)m(t)g(with)e(the)h │ │ │ │ │ -(largest)h(magnitude)e(in)227 876 y(the)i(diagonal)i(of)e(the)g │ │ │ │ │ -(\(1,1\))i(blo)s(c)m(k.)58 b(Elemen)m(t)37 b Fm(jj)e │ │ │ │ │ -Fn(m)m(ust)h(ha)m(v)m(e)h Fm(mark[jj])46 b(=)h(tag)36 │ │ │ │ │ -b Fn(to)g(b)s(e)g(eligible.)59 b(Its)227 989 y(magnitude)30 │ │ │ │ │ -b(is)g(returned)e(in)i Fm(*pmaxval)p Fn(.)38 b(Note,)31 │ │ │ │ │ -b(if)f(the)g(c)m(hevron)f(is)h(complex,)h(the)f(lo)s(cation)h(is)f(in)f │ │ │ │ │ -(terms)227 1101 y(of)g(the)g(complex)g(en)m(tries,)h(not)e(in)h(the)f │ │ │ │ │ -(real)i(en)m(tries,)f(i.e.,)i(if)d Fm(k)48 b(=)f(Chv)p │ │ │ │ │ -2654 1101 29 4 v 34 w(maxabsDiagonal11\(chv,..)o(.\))p │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fn(8)p 136 100 1177 4 v │ │ │ │ │ +1359 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2724 100 V 0 399 a Fc(1.2.4)112 b(Searc)m(h)38 b(metho)s(ds)111 │ │ │ │ │ +604 y Fn(1.)46 b Fm(int)h(Chv_maxabsInDiagonal11)42 b(\()47 │ │ │ │ │ +b(Chv)g(*chv,)g(int)g(mark[],)e(int)i(tag,)g(double)f(*pmaxval)g(\))h │ │ │ │ │ +(;)227 763 y Fn(This)34 b(metho)s(d)g(returns)f(the)i(lo)s(cation)h(of) │ │ │ │ │ +f(the)g(\014rst)f(tagged)i(elemen)m(t)g(with)e(the)h(largest)h │ │ │ │ │ +(magnitude)e(in)227 876 y(the)i(diagonal)i(of)e(the)g(\(1,1\))i(blo)s │ │ │ │ │ +(c)m(k.)58 b(Elemen)m(t)37 b Fm(jj)e Fn(m)m(ust)h(ha)m(v)m(e)h │ │ │ │ │ +Fm(mark[jj])46 b(=)h(tag)36 b Fn(to)g(b)s(e)g(eligible.)59 │ │ │ │ │ +b(Its)227 989 y(magnitude)30 b(is)g(returned)e(in)i Fm(*pmaxval)p │ │ │ │ │ +Fn(.)38 b(Note,)31 b(if)f(the)g(c)m(hevron)f(is)h(complex,)h(the)f(lo)s │ │ │ │ │ +(cation)h(is)f(in)f(terms)227 1101 y(of)g(the)g(complex)g(en)m(tries,)h │ │ │ │ │ +(not)e(in)h(the)f(real)i(en)m(tries,)f(i.e.,)i(if)d Fm(k)48 │ │ │ │ │ +b(=)f(Chv)p 2654 1101 29 4 v 34 w(maxabsDiagonal11\(chv,..)o(.\))p │ │ │ │ │ Fn(,)227 1214 y(then)30 b(the)h(complex)g(en)m(try)g(is)f(found)f(in)h │ │ │ │ │ Fm(chv->entries[2*kk:2*kk+1])o Fn(.)227 1373 y Fl(Err)-5 │ │ │ │ │ b(or)30 b(che)-5 b(cking:)38 b Fn(If)25 b Fm(chv)p Fn(,)g │ │ │ │ │ Fm(mark)g Fn(or)g Fm(pmaxval)f Fn(is)h Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ (message)i(is)f(prin)m(ted)f(and)f(the)i(program)227 │ │ │ │ │ 1486 y(exits.)111 1692 y(2.)46 b Fm(int)h(Chv_maxabsInRow11)c(\()48 │ │ │ │ │ b(Chv)f(*chv,)f(int)h(irow,)f(int)h(colmark[],)1373 1804 │ │ │ │ │ @@ -6186,17 +6179,17 @@ │ │ │ │ │ b Fn(If)33 b Fm(chv)g Fn(is)h Fm(NULL)f Fn(or)h Fm(irow)f │ │ │ │ │ Fn(is)h(not)g(in)g Fm([0,n1-1])p Fn(,)f(an)g(error)h(message)h(is)f │ │ │ │ │ (prin)m(ted)g(and)227 5089 y(the)d(program)f(exits.)111 │ │ │ │ │ 5294 y(5.)46 b Fm(int)h(Chv_maxabsInColumn)c(\()k(Chv)g(*chv,)g(int)g │ │ │ │ │ (jcol,)f(int)h(rowmark[],)1420 5407 y(int)g(tag,)g(double)f(*pmaxval)g │ │ │ │ │ (\))h(;)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1158 4 v 1339 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)121 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2695 100 V 1158 w Fn(9)227 399 y(This)h(metho)s(d)g(returns)g(the)h(lo) │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1177 4 v 1358 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)40 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2676 100 V 1177 w Fn(9)227 399 y(This)h(metho)s(d)g(returns)g(the)h(lo) │ │ │ │ │ s(cation)h(of)f(the)g(\014rst)f(elemen)m(t)i(with)f(the)g(largest)h │ │ │ │ │ (magnitude)f(in)f(column)227 511 y Fm(jcol)p Fn(.)52 │ │ │ │ │ b(Elemen)m(t)35 b Fm(jj)f Fn(m)m(ust)g(ha)m(v)m(e)i Fm(rowmark[jj])45 │ │ │ │ │ b(=)i(tag)33 b Fn(to)j(b)s(e)d(eligible.)55 b(Its)34 │ │ │ │ │ b(magnitude)h(is)f(returned)227 624 y(in)28 b Fm(*pmaxval)p │ │ │ │ │ Fn(.)38 b(Note,)30 b(if)e(the)h(c)m(hevron)f(is)g(complex,)i(the)e(lo)s │ │ │ │ │ (cation)i(is)e(in)g(terms)g(of)h(the)f(complex)h(en)m(tries,)227 │ │ │ │ │ @@ -6280,33 +6273,32 @@ │ │ │ │ │ (symmetric,)h(w)m(e)f(can)h(\014nd)d(a)j(1)21 b Fh(\002)g │ │ │ │ │ Fn(1)33 b(or)f(2)22 b Fh(\002)f Fn(2)32 b(piv)m(ot.)47 │ │ │ │ │ b(If)31 b(the)i(c)m(hevron)227 5294 y(is)d(nonsymmetric,)g(w)m(e)h │ │ │ │ │ (only)f(\014nd)e(a)i(1)20 b Fh(\002)f Fn(1)30 b(piv)m(ot.)42 │ │ │ │ │ b(A)30 b(return)e(v)-5 b(alue)31 b(of)f(zero)h(means)e(that)i(no)f(piv) │ │ │ │ │ m(ot)h(w)m(as)227 5407 y(found.)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fn(10)p 182 100 1135 4 │ │ │ │ │ -v 1317 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2765 100 V 227 399 a Fl(Err)-5 │ │ │ │ │ -b(or)47 b(che)-5 b(cking:)67 b Fn(If)43 b Fm(chv)p Fn(,)j │ │ │ │ │ -Fm(workDV)p Fn(,)d Fm(pirow)p Fn(,)j Fm(pjcol)c Fn(or)i │ │ │ │ │ -Fm(pntest)e Fn(is)h Fm(NULL)p Fn(,)g(or)h(if)g Fm(tau)j │ │ │ │ │ -Fb(<)g Fn(1)p Fb(:)p Fn(0,)h(or)c(if)227 511 y Fm(ndelay)24 │ │ │ │ │ -b Fb(<)h Fn(0,)31 b(an)f(error)g(message)i(is)e(prin)m(ted)g(and)g(the) │ │ │ │ │ -g(program)g(exits.)0 782 y Fc(1.2.6)112 b(Up)s(date)39 │ │ │ │ │ -b(metho)s(ds)111 980 y Fn(1.)46 b Fm(void)h(Chv_updateS)e(\()i(Chv)g │ │ │ │ │ -(*chv,)f(SubMtx)g(*mtxD,)h(SubMtx)f(*mtxU,)g(DV)h(*tempDV)f(\))h(;)227 │ │ │ │ │ -1093 y(void)g(Chv_updateH)e(\()i(Chv)g(*chv,)f(SubMtx)g(*mtxD,)h │ │ │ │ │ -(SubMtx)f(*mtxU,)g(DV)h(*tempDV)f(\))h(;)227 1206 y(void)g(Chv_updateN) │ │ │ │ │ -e(\()i(Chv)g(*chv,)f(SubMtx)g(*mtxL,)h(SubMtx)f(*mtxD,)g(SubMtx)g │ │ │ │ │ -(*mtxU,)1134 1318 y(DV)h(*tempDV)f(\))i(;)227 1470 y │ │ │ │ │ -Fn(These)36 b(metho)s(ds)f(p)s(erform)f(an)i(up)s(date)f(to)i(a)f(c)m │ │ │ │ │ -(hevron)g(during)f(the)h(factorization.)60 b(F)-8 b(or)36 │ │ │ │ │ -b(a)h(symmetric)227 1582 y(c)m(hevron,)31 b(w)m(e)g(compute)1067 │ │ │ │ │ -1788 y Fb(T)1120 1803 y Fa(J)6 b Fk(\\)p Fa(@)t(I)f(;J)h │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fn(10)p 182 100 1154 4 │ │ │ │ │ +v 1336 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2746 100 V 227 399 a Fl(Err)-5 b(or)47 b(che)-5 b(cking:)67 │ │ │ │ │ +b Fn(If)43 b Fm(chv)p Fn(,)j Fm(workDV)p Fn(,)d Fm(pirow)p │ │ │ │ │ +Fn(,)j Fm(pjcol)c Fn(or)i Fm(pntest)e Fn(is)h Fm(NULL)p │ │ │ │ │ +Fn(,)g(or)h(if)g Fm(tau)j Fb(<)g Fn(1)p Fb(:)p Fn(0,)h(or)c(if)227 │ │ │ │ │ +511 y Fm(ndelay)24 b Fb(<)h Fn(0,)31 b(an)f(error)g(message)i(is)e │ │ │ │ │ +(prin)m(ted)g(and)g(the)g(program)g(exits.)0 782 y Fc(1.2.6)112 │ │ │ │ │ +b(Up)s(date)39 b(metho)s(ds)111 980 y Fn(1.)46 b Fm(void)h(Chv_updateS) │ │ │ │ │ +e(\()i(Chv)g(*chv,)f(SubMtx)g(*mtxD,)h(SubMtx)f(*mtxU,)g(DV)h(*tempDV)f │ │ │ │ │ +(\))h(;)227 1093 y(void)g(Chv_updateH)e(\()i(Chv)g(*chv,)f(SubMtx)g │ │ │ │ │ +(*mtxD,)h(SubMtx)f(*mtxU,)g(DV)h(*tempDV)f(\))h(;)227 │ │ │ │ │ +1206 y(void)g(Chv_updateN)e(\()i(Chv)g(*chv,)f(SubMtx)g(*mtxL,)h │ │ │ │ │ +(SubMtx)f(*mtxD,)g(SubMtx)g(*mtxU,)1134 1318 y(DV)h(*tempDV)f(\))i(;) │ │ │ │ │ +227 1470 y Fn(These)36 b(metho)s(ds)f(p)s(erform)f(an)i(up)s(date)f(to) │ │ │ │ │ +i(a)f(c)m(hevron)g(during)f(the)h(factorization.)60 b(F)-8 │ │ │ │ │ +b(or)36 b(a)h(symmetric)227 1582 y(c)m(hevron,)31 b(w)m(e)g(compute) │ │ │ │ │ +1067 1788 y Fb(T)1120 1803 y Fa(J)6 b Fk(\\)p Fa(@)t(I)f(;J)h │ │ │ │ │ Fk(\\)p Fa(@)t(I)1564 1788 y Fn(:=)83 b Fb(T)1796 1803 │ │ │ │ │ y Fa(J)6 b Fk(\\)p Fa(@)t(I)f(;J)h Fk(\\)p Fa(@)t(I)2177 │ │ │ │ │ 1788 y Fh(\000)20 b Fb(U)2340 1751 y Fa(T)2330 1811 y(I)5 │ │ │ │ │ b(;J)h Fk(\\)p Fa(@)t(I)2559 1788 y Fb(D)2634 1802 y │ │ │ │ │ Fa(I)f(;I)2729 1788 y Fb(U)2791 1803 y Fa(I)g(;J)h Fk(\\)p │ │ │ │ │ Fa(@)t(I)1026 1940 y Fb(T)1079 1955 y Fa(J)g Fk(\\)p │ │ │ │ │ Fa(@)t(I)f(;@)t(J)h Fk(\\)p Fa(@)t(I)1564 1940 y Fn(:=)83 │ │ │ │ │ @@ -6388,17 +6380,17 @@ │ │ │ │ │ b Fb(<)h Fn(0,)30 b(then)f(the)h(en)m(try)f(is)g(found)f(in)h(lo)s │ │ │ │ │ (cation)i Fm(\(ichv-off,)45 b(ichv\))28 b Fn(of)h(the)g(matrix.)227 │ │ │ │ │ 5407 y(The)35 b(v)-5 b(alue\(s\))37 b(in)e Fm(alpha[])e │ │ │ │ │ Fn(form)i(a)h(scalar)h(used)d(to)i(scale)h(the)f(en)m(tire)g(c)m │ │ │ │ │ (hevron)g(for)f(its)h(assem)m(bly)-8 b(.)57 b(A)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1135 4 v 1316 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)122 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2673 100 V 1135 w Fn(11)227 399 y(call)e(to)g(assem)m(ble)g(en)m(tries) │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1154 4 v 1335 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2654 100 V 1154 w Fn(11)227 399 y(call)e(to)g(assem)m(ble)g(en)m(tries) │ │ │ │ │ g(in)e Fb(A)h Fn(\(from)g(the)g(p)s(encil)g Fb(A)15 b │ │ │ │ │ Fn(+)g Fb(\033)s(B)5 b Fn(\))28 b(w)m(ould)f(ha)m(v)m(e)i │ │ │ │ │ Fm(alpha[])46 b(=)i(\(1.0,0.0\))p Fn(;)26 b(to)227 511 │ │ │ │ │ y(assem)m(ble)32 b(en)m(tries)f(in)f Fb(B)35 b Fn(\(from)30 │ │ │ │ │ b(the)g(p)s(encil)h Fb(A)20 b Fn(+)g Fb(\033)s(B)5 b │ │ │ │ │ Fn(\))30 b(w)m(ould)g(ha)m(v)m(e)i Fm(alpha[])23 b Fn(=)i(\()p │ │ │ │ │ Fb(R)q(eal)r Fn(\()p Fb(\033)s Fn(\))p Fb(;)15 b(I)7 │ │ │ │ │ @@ -6486,31 +6478,31 @@ │ │ │ │ │ (functionalit)m(y)-8 b(,)33 b(where)d(if)h(a)g(small)g(or)g(zero)g(en)m │ │ │ │ │ (try)g(is)g(found)e(in)i(the)g(diagonal)g(elemen)m(t)227 │ │ │ │ │ 5294 y(that)45 b(is)f(to)h(b)s(e)f(eliminated,)49 b(some)c(action)h │ │ │ │ │ (can)e(b)s(e)g(tak)m(en.)83 b(The)44 b(return)f(v)-5 │ │ │ │ │ b(alue)45 b(is)f(the)h(n)m(um)m(b)s(er)e(of)227 5407 │ │ │ │ │ y(eliminated)32 b(ro)m(ws)e(and)g(columns.)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fn(12)p 182 100 1135 │ │ │ │ │ -4 v 1317 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2765 100 V 227 399 a Fl(Err)-5 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fn(12)p 182 100 1154 │ │ │ │ │ +4 v 1336 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2746 100 V 227 399 a Fl(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +b(cking:)40 b Fn(If)30 b Fm(chv)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ +(message)h(is)g(prin)m(ted)f(and)g(the)g(program)g(exits.)111 │ │ │ │ │ +588 y(3.)46 b Fm(int)h(Chv_r1upd)e(\()j(Chv)f(*chv)f(\))i(;)227 │ │ │ │ │ +739 y Fn(This)29 b(metho)s(d)f(is)i(used)e(during)g(the)h │ │ │ │ │ +(factorization)j(of)e(a)f(fron)m(t,)h(p)s(erforming)e(a)i(rank-one)f │ │ │ │ │ +(up)s(date)f(of)i(the)227 852 y(c)m(hevron.)41 b(The)30 │ │ │ │ │ +b(return)f(v)-5 b(alue)31 b(is)g Fm(1)f Fn(if)g(the)h(piv)m(ot)g(is)f │ │ │ │ │ +(nonzero,)h Fm(0)f Fn(otherwise.)227 1003 y Fl(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 b Fm(chv)g Fn(is)g │ │ │ │ │ Fm(NULL)p Fn(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)g(the)g │ │ │ │ │ -(program)g(exits.)111 588 y(3.)46 b Fm(int)h(Chv_r1upd)e(\()j(Chv)f │ │ │ │ │ -(*chv)f(\))i(;)227 739 y Fn(This)29 b(metho)s(d)f(is)i(used)e(during)g │ │ │ │ │ -(the)h(factorization)j(of)e(a)f(fron)m(t,)h(p)s(erforming)e(a)i │ │ │ │ │ -(rank-one)f(up)s(date)f(of)i(the)227 852 y(c)m(hevron.)41 │ │ │ │ │ -b(The)30 b(return)f(v)-5 b(alue)31 b(is)g Fm(1)f Fn(if)g(the)h(piv)m │ │ │ │ │ -(ot)g(is)f(nonzero,)h Fm(0)f Fn(otherwise.)227 1003 y │ │ │ │ │ -Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 b Fm(chv)g │ │ │ │ │ -Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)g │ │ │ │ │ -(the)g(program)g(exits.)111 1192 y(4.)46 b Fm(int)h(Chv_r2upd)e(\()j │ │ │ │ │ -(Chv)f(*chv)f(\))i(;)227 1343 y Fn(This)28 b(metho)s(d)h(is)g(used)f │ │ │ │ │ -(during)f(the)i(factorization)j(of)d(a)g(fron)m(t,)h(p)s(erforming)d(a) │ │ │ │ │ -j(rank-t)m(w)m(o)g(up)s(date)e(of)h(the)227 1456 y(c)m(hevron.)41 │ │ │ │ │ +(program)g(exits.)111 1192 y(4.)46 b Fm(int)h(Chv_r2upd)e(\()j(Chv)f │ │ │ │ │ +(*chv)f(\))i(;)227 1343 y Fn(This)28 b(metho)s(d)h(is)g(used)f(during)f │ │ │ │ │ +(the)i(factorization)j(of)d(a)g(fron)m(t,)h(p)s(erforming)d(a)j(rank-t) │ │ │ │ │ +m(w)m(o)g(up)s(date)e(of)h(the)227 1456 y(c)m(hevron.)41 │ │ │ │ │ b(The)30 b(return)f(v)-5 b(alue)31 b(is)g Fm(1)f Fn(if)g(the)h(piv)m │ │ │ │ │ (ot)g(is)f(nonsingular,)g Fm(0)g Fn(otherwise.)227 1607 │ │ │ │ │ y Fl(Err)-5 b(or)31 b(che)-5 b(cking:)39 b Fn(If)26 b │ │ │ │ │ Fm(chv)h Fn(is)g Fm(NULL)p Fn(,)f(or)h(if)g(the)g(c)m(hevron)h(is)f │ │ │ │ │ (nonsymmetric,)g(an)g(error)g(message)h(is)f(prin)m(ted)227 │ │ │ │ │ 1720 y(and)j(the)h(program)f(exits.)111 1909 y(5.)46 │ │ │ │ │ b Fm(void)h(Chv_maxabsInChevron)42 b(\()48 b(Chv)f(*chv,)f(int)h(ichv,) │ │ │ │ │ @@ -6564,17 +6556,17 @@ │ │ │ │ │ 1172 5260 V 33 w(11)29 b Fn(=)-15 b Fh(\))30 b Fn(coun)m(t)h(strict)g │ │ │ │ │ (upp)s(er)e(en)m(tries)i(in)f(the)g(\(1,1\))j(blo)s(c)m(k)337 │ │ │ │ │ 5407 y Fe(\210)45 b Fm(CHV)p 577 5407 V 34 w(UPPER)p │ │ │ │ │ 851 5407 V 33 w(12)30 b Fn(=)-16 b Fh(\))30 b Fn(coun)m(t)h(upp)s(er)e │ │ │ │ │ (en)m(tries)i(in)f(the)g(\(1,2\))j(blo)s(c)m(k)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 91 100 1135 4 v 1316 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)122 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2673 100 V 1135 w Fn(13)227 399 y(This)f(metho)s(d)g(is)g(used)g(to)h │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1154 4 v 1335 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2654 100 V 1154 w Fn(13)227 399 y(This)f(metho)s(d)g(is)g(used)g(to)h │ │ │ │ │ (compute)f(the)h(necessary)g(storage)h(to)f(store)g(a)g(c)m(hevron)f │ │ │ │ │ (as)h(a)g(dense)f(fron)m(t.)227 551 y Fl(Err)-5 b(or)36 │ │ │ │ │ b(che)-5 b(cking:)45 b Fn(If)32 b Fm(chv)g Fn(is)h Fm(NULL)e │ │ │ │ │ Fn(or)i(if)g Fm(countflag)d Fn(is)i(not)h(v)-5 b(alid,)34 │ │ │ │ │ b(an)f(error)f(message)i(is)e(prin)m(ted)h(and)227 664 │ │ │ │ │ y(the)e(program)f(exits.)111 855 y(2.)46 b Fm(int)h │ │ │ │ │ (Chv_countBigEntries)c(\()k(Chv)g(*chv,)f(int)h(npivot,)f(int)h │ │ │ │ │ @@ -6654,19 +6646,19 @@ │ │ │ │ │ b(che)-5 b(cking:)45 b Fn(If)32 b Fm(chv)g Fn(or)g Fm(dvec)g │ │ │ │ │ Fn(is)h Fm(NULL)e Fn(or)i(if)f Fm(length)f Fn(is)i(less)g(than)f(the)h │ │ │ │ │ (n)m(um)m(b)s(er)e(of)i(en)m(tries)g(to)h(b)s(e)227 5294 │ │ │ │ │ y(copied,)k(or)d(if)g Fm(copyflag)e Fn(or)j Fm(storeflag)c │ │ │ │ │ Fn(is)k(v)-5 b(alid,)37 b(an)e(error)g(message)i(is)e(prin)m(ted)g(and) │ │ │ │ │ g(the)g(program)227 5407 y(exits.)p eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ -TeXDict begin 14 13 bop 0 100 a Fn(14)p 182 100 1135 │ │ │ │ │ -4 v 1317 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2765 100 V 111 399 a Fn(4.)46 │ │ │ │ │ -b Fm(int)h(Chv_copyBigEntriesToVecto)o(r)42 b(\()47 b(Chv)g(*chv,)g │ │ │ │ │ -(int)f(npivot,)g(int)h(pivotsizes[],)1420 511 y(int)g(sizes[],)f(int)h │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fn(14)p 182 100 1154 │ │ │ │ │ +4 v 1336 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2746 100 V 111 399 a Fn(4.)46 b Fm(int)h │ │ │ │ │ +(Chv_copyBigEntriesToVecto)o(r)42 b(\()47 b(Chv)g(*chv,)g(int)f │ │ │ │ │ +(npivot,)g(int)h(pivotsizes[],)1420 511 y(int)g(sizes[],)f(int)h │ │ │ │ │ (ivec[],)f(double)g(dvec[],)1420 624 y(int)h(copyflag,)f(int)h │ │ │ │ │ (storeflag,)e(double)h(droptol)f(\))j(;)227 769 y Fn(This)32 │ │ │ │ │ b(metho)s(d)f(also)j(copies)f(some)g(en)m(tries)g(the)f(c)m(hevron)h │ │ │ │ │ (ob)5 b(ject)33 b(in)m(to)g(a)g(double)f(precision)g(v)m(ector,)j(but) │ │ │ │ │ 227 882 y(only)40 b(those)f(en)m(tries)h(whose)f(magnitude)g(is)h │ │ │ │ │ (greater)g(than)f(or)g(equal)h(to)g Fm(droptol)d Fn(are)i(copied.)68 │ │ │ │ │ b(This)227 995 y(metho)s(d)27 b(is)g(called)h(after)f(a)h(fron)m(t)f │ │ │ │ │ @@ -6753,17 +6745,17 @@ │ │ │ │ │ 227 5294 y(width)e Fm(nD)h Fn(of)g(the)g(c)m(hevron.)58 │ │ │ │ │ b(The)36 b(ro)m(w)g(ids)f(of)i(the)f(t)m(w)m(o)h(ro)m(ws)f(are)g(also)h │ │ │ │ │ (sw)m(app)s(ed.)57 b(If)35 b(the)i(c)m(hevron)f(is)227 │ │ │ │ │ 5407 y(symmetric,)31 b(then)f(the)h(metho)s(d)f Fm(Chv)p │ │ │ │ │ 1540 5407 V 33 w(swapRowsAndColumns\(\))25 b Fn(is)30 │ │ │ │ │ b(called.)p eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 91 100 1135 4 v 1316 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)122 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2673 100 V 1135 w Fn(15)227 399 y Fl(Err)-5 b(or)35 b(che)-5 │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1154 4 v 1335 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2654 100 V 1154 w Fn(15)227 399 y Fl(Err)-5 b(or)35 b(che)-5 │ │ │ │ │ b(cking:)43 b Fn(If)31 b Fm(chv)g Fn(is)h Fm(NULL)e Fn(or)i(if)g │ │ │ │ │ Fm(irow)e Fn(or)i Fm(jrow)e Fn(are)i(less)g(than)f(0)i(or)e(greater)i │ │ │ │ │ (than)e(or)h(equal)g(to)227 511 y Fm(nD)p Fn(,)e(an)h(error)f(message)h │ │ │ │ │ (is)f(prin)m(ted)g(and)g(the)h(program)f(exits.)111 699 │ │ │ │ │ y(2.)46 b Fm(void)h(Chv_swapColumns)d(\()j(Chv)g(*chv,)f(int)h(icol,)g │ │ │ │ │ (int)f(jcol)h(\))h(;)227 849 y Fn(This)29 b(metho)s(d)g(sw)m(aps)g │ │ │ │ │ (columns)g Fm(icol)g Fn(and)g Fm(jcol)f Fn(of)h(the)h(c)m(hevron.)41 │ │ │ │ │ @@ -6833,55 +6825,54 @@ │ │ │ │ │ Fn(is)i(p)s(ositiv)m(e,)k(the)41 b(\014rst)g Fm(shift)f │ │ │ │ │ Fn(c)m(hevrons)i(are)g(remo)m(v)m(ed)g(from)f(the)h(c)m(hevron.)75 │ │ │ │ │ b(If)41 b Fm(shift)f Fn(is)227 5407 y(negativ)m(e,)j(the)38 │ │ │ │ │ b Fm(shift)f Fn(previous)g(c)m(hevrons)h(are)h(prep)s(ended)d(to)i(the) │ │ │ │ │ h(c)m(hevron.)64 b(This)37 b(is)h(a)g(dangerous)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 16 16 │ │ │ │ │ -TeXDict begin 16 15 bop 0 100 a Fn(16)p 182 100 1135 │ │ │ │ │ -4 v 1317 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2765 100 V 227 399 a Fn(metho)s(d)j(as)h(it) │ │ │ │ │ -g(c)m(hanges)h(the)e(state)i(of)f(the)g(ob)5 b(ject.)54 │ │ │ │ │ -b(W)-8 b(e)35 b(use)g(it)g(during)e(the)i(factorization)i(of)e(a)g │ │ │ │ │ -(fron)m(t,)227 511 y(where)c(one)g Fm(Chv)e Fn(ob)5 b(ject)32 │ │ │ │ │ -b(p)s(oin)m(ts)f(to)g(the)g(en)m(tire)h(c)m(hevron)f(in)f(order)g(to)i │ │ │ │ │ -(sw)m(ap)e(ro)m(ws)h(and)f(columns,)h(while)227 624 y(another)36 │ │ │ │ │ -b(c)m(hevron)g(p)s(oin)m(ts)g(to)g(the)g(uneliminated)g(ro)m(ws)g(and)f │ │ │ │ │ -(columns)g(of)h(the)g(fron)m(t.)57 b(It)36 b(is)g(the)g(latter)227 │ │ │ │ │ -737 y(c)m(hevron)31 b(that)g(is)f(shifted)g(during)f(the)i │ │ │ │ │ -(factorization.)227 910 y Fl(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ -b(cking:)40 b Fn(If)30 b Fm(chv)g Fn(is)g Fm(NULL)f Fn(an)i(error)f │ │ │ │ │ -(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ -1142 y(6.)46 b Fm(void)h(Chv_fill11block)d(\()j(Chv)g(*chv,)f(A2)h │ │ │ │ │ -(*mtx)g(\))h(;)227 1315 y Fn(This)27 b(metho)s(d)h(is)g(used)f(to)h │ │ │ │ │ -(\014ll)g(a)h Fm(A2)e Fn(dense)g(matrix)i(ob)5 b(ject)28 │ │ │ │ │ -b(with)g(the)g(en)m(tries)h(in)e(the)h(\(1)p Fb(;)15 │ │ │ │ │ -b Fn(1\))30 b(blo)s(c)m(k)f(of)f(the)227 1428 y(c)m(hevron.)227 │ │ │ │ │ -1601 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ -b Fm(chv)g Fn(or)g Fm(mtx)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ -(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ -1833 y(7.)46 b Fm(void)h(Chv_fill12block)d(\()j(Chv)g(*chv,)f(A2)h │ │ │ │ │ -(*mtx)g(\))h(;)227 2006 y Fn(This)27 b(metho)s(d)h(is)g(used)f(to)h │ │ │ │ │ -(\014ll)g(a)h Fm(A2)e Fn(dense)g(matrix)i(ob)5 b(ject)28 │ │ │ │ │ -b(with)g(the)g(en)m(tries)h(in)e(the)h(\(1)p Fb(;)15 │ │ │ │ │ -b Fn(2\))30 b(blo)s(c)m(k)f(of)f(the)227 2119 y(c)m(hevron.)227 │ │ │ │ │ -2292 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ -b Fm(chv)g Fn(or)g Fm(mtx)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ -(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ -2524 y(8.)46 b Fm(void)h(Chv_fill21block)d(\()j(Chv)g(*chv,)f(A2)h │ │ │ │ │ -(*mtx)g(\))h(;)227 2697 y Fn(This)27 b(metho)s(d)h(is)g(used)f(to)h │ │ │ │ │ -(\014ll)g(a)h Fm(A2)e Fn(dense)g(matrix)i(ob)5 b(ject)28 │ │ │ │ │ -b(with)g(the)g(en)m(tries)h(in)e(the)h(\(2)p Fb(;)15 │ │ │ │ │ -b Fn(1\))30 b(blo)s(c)m(k)f(of)f(the)227 2810 y(c)m(hevron.)227 │ │ │ │ │ -2983 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ -b Fm(chv)g Fn(or)g Fm(mtx)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ -(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ -3215 y(9.)46 b Fm(double)g(Chv_maxabs)f(\()j(Chv)f(*chv)f(\))i(;)227 │ │ │ │ │ -3388 y Fn(This)30 b(metho)s(d)g(returns)f(the)h(magnitude)h(of)f(the)h │ │ │ │ │ -(en)m(try)g(of)f(largest)i(magnitude)e(in)g(the)h(ob)5 │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fn(16)p 182 100 1154 │ │ │ │ │ +4 v 1336 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2746 100 V 227 399 a Fn(metho)s(d)j(as)h(it)g(c)m(hanges)h(the) │ │ │ │ │ +e(state)i(of)f(the)g(ob)5 b(ject.)54 b(W)-8 b(e)35 b(use)g(it)g(during) │ │ │ │ │ +e(the)i(factorization)i(of)e(a)g(fron)m(t,)227 511 y(where)c(one)g │ │ │ │ │ +Fm(Chv)e Fn(ob)5 b(ject)32 b(p)s(oin)m(ts)f(to)g(the)g(en)m(tire)h(c)m │ │ │ │ │ +(hevron)f(in)f(order)g(to)i(sw)m(ap)e(ro)m(ws)h(and)f(columns,)h(while) │ │ │ │ │ +227 624 y(another)36 b(c)m(hevron)g(p)s(oin)m(ts)g(to)g(the)g │ │ │ │ │ +(uneliminated)g(ro)m(ws)g(and)f(columns)g(of)h(the)g(fron)m(t.)57 │ │ │ │ │ +b(It)36 b(is)g(the)g(latter)227 737 y(c)m(hevron)31 b(that)g(is)f │ │ │ │ │ +(shifted)g(during)f(the)i(factorization.)227 910 y Fl(Err)-5 │ │ │ │ │ +b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 b Fm(chv)g Fn(is)g │ │ │ │ │ +Fm(NULL)f Fn(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i │ │ │ │ │ +(program)f(exits.)111 1142 y(6.)46 b Fm(void)h(Chv_fill11block)d(\()j │ │ │ │ │ +(Chv)g(*chv,)f(A2)h(*mtx)g(\))h(;)227 1315 y Fn(This)27 │ │ │ │ │ +b(metho)s(d)h(is)g(used)f(to)h(\014ll)g(a)h Fm(A2)e Fn(dense)g(matrix)i │ │ │ │ │ +(ob)5 b(ject)28 b(with)g(the)g(en)m(tries)h(in)e(the)h(\(1)p │ │ │ │ │ +Fb(;)15 b Fn(1\))30 b(blo)s(c)m(k)f(of)f(the)227 1428 │ │ │ │ │ +y(c)m(hevron.)227 1601 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fn(If)30 b Fm(chv)g Fn(or)g Fm(mtx)g Fn(is)g Fm(NULL)p │ │ │ │ │ +Fn(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ +(exits.)111 1833 y(7.)46 b Fm(void)h(Chv_fill12block)d(\()j(Chv)g │ │ │ │ │ +(*chv,)f(A2)h(*mtx)g(\))h(;)227 2006 y Fn(This)27 b(metho)s(d)h(is)g │ │ │ │ │ +(used)f(to)h(\014ll)g(a)h Fm(A2)e Fn(dense)g(matrix)i(ob)5 │ │ │ │ │ +b(ject)28 b(with)g(the)g(en)m(tries)h(in)e(the)h(\(1)p │ │ │ │ │ +Fb(;)15 b Fn(2\))30 b(blo)s(c)m(k)f(of)f(the)227 2119 │ │ │ │ │ +y(c)m(hevron.)227 2292 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fn(If)30 b Fm(chv)g Fn(or)g Fm(mtx)g Fn(is)g Fm(NULL)p │ │ │ │ │ +Fn(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ +(exits.)111 2524 y(8.)46 b Fm(void)h(Chv_fill21block)d(\()j(Chv)g │ │ │ │ │ +(*chv,)f(A2)h(*mtx)g(\))h(;)227 2697 y Fn(This)27 b(metho)s(d)h(is)g │ │ │ │ │ +(used)f(to)h(\014ll)g(a)h Fm(A2)e Fn(dense)g(matrix)i(ob)5 │ │ │ │ │ +b(ject)28 b(with)g(the)g(en)m(tries)h(in)e(the)h(\(2)p │ │ │ │ │ +Fb(;)15 b Fn(1\))30 b(blo)s(c)m(k)f(of)f(the)227 2810 │ │ │ │ │ +y(c)m(hevron.)227 2983 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fn(If)30 b Fm(chv)g Fn(or)g Fm(mtx)g Fn(is)g Fm(NULL)p │ │ │ │ │ +Fn(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ +(exits.)111 3215 y(9.)46 b Fm(double)g(Chv_maxabs)f(\()j(Chv)f(*chv)f │ │ │ │ │ +(\))i(;)227 3388 y Fn(This)30 b(metho)s(d)g(returns)f(the)h(magnitude)h │ │ │ │ │ +(of)f(the)h(en)m(try)g(of)f(largest)i(magnitude)e(in)g(the)h(ob)5 │ │ │ │ │ b(ject.)227 3560 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fn(If)30 b Fm(chv)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)g(the)g(program)g(exits.)66 3793 │ │ │ │ │ y(10.)46 b Fm(double)g(Chv_frobNorm)f(\()i(Chv)g(*chv)g(\))g(;)227 │ │ │ │ │ 3966 y Fn(This)30 b(metho)s(d)g(returns)f(the)h(F)-8 │ │ │ │ │ b(rob)s(enius)30 b(norm)g(of)g(the)h(c)m(hevron.)227 │ │ │ │ │ 4138 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ @@ -6898,17 +6889,17 @@ │ │ │ │ │ y(12.)46 b Fm(void)h(Chv_zero)e(\()j(Chv)f(*chv)f(\))i(;)227 │ │ │ │ │ 5234 y Fn(This)30 b(metho)s(d)g(zero)s(es)h(the)f(en)m(tries)h(in)f │ │ │ │ │ (the)h(c)m(hevron.)227 5407 y Fl(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fn(If)30 b Fm(chv)g Fn(is)g Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ (message)h(is)g(prin)m(ted)f(and)g(the)g(program)g(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 17 17 │ │ │ │ │ -TeXDict begin 17 16 bop 91 100 1135 4 v 1316 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)122 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2673 100 V 1135 w Fn(17)0 399 y Fc(1.2.12)113 b(IO)37 │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1154 4 v 1335 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2654 100 V 1154 w Fn(17)0 399 y Fc(1.2.12)113 b(IO)37 │ │ │ │ │ b(metho)s(ds)111 592 y Fn(1.)46 b Fm(void)h(Chv_writeForHumanEye)42 │ │ │ │ │ b(\()48 b(Chv)f(*chv,)f(FILE)h(*fp)f(\))i(;)227 739 y │ │ │ │ │ Fn(This)30 b(metho)s(d)g(writes)g(a)h Fm(Chv)e Fn(ob)5 │ │ │ │ │ b(ject)32 b(to)f(a)f(\014le)h(in)f(an)g(easily)i(readable)f(format.)227 │ │ │ │ │ 887 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ b Fm(chv)g Fn(or)g Fm(fp)g Fn(are)h Fm(NULL)p Fn(,)e(an)h(error)g │ │ │ │ │ (message)i(is)e(prin)m(ted)g(and)g(zero)h(is)g(returned.)111 │ │ │ │ │ @@ -6968,20 +6959,20 @@ │ │ │ │ │ Fn(is)h(\(1.0,0.0\),)j(when)c(w)m(e)h(are)g(just)g(loading)g(matrix)g │ │ │ │ │ (en)m(tries)h(in)m(to)g(a)427 5294 y(fron)m(t.)41 b(Ho)m(w)m(ev)m(er,) │ │ │ │ │ 33 b(when)c(w)m(e)i(factor)g Fb(A)20 b Fn(+)g Fb(\013B)5 │ │ │ │ │ b Fn(,)31 b(the)f(en)m(tries)h(of)g Fb(B)j Fn(will)d(b)s(e)f(loaded)h │ │ │ │ │ (with)f Fm(alpha)e Fn(set)427 5407 y(equal)j(to)g Fb(\013)p │ │ │ │ │ Fn([0)c(:)e(1].)p eop end │ │ │ │ │ %%Page: 18 18 │ │ │ │ │ -TeXDict begin 18 17 bop 0 100 a Fn(18)p 182 100 1135 │ │ │ │ │ -4 v 1317 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2765 100 V 111 399 a Fn(2.)46 │ │ │ │ │ -b Fm(test_assmbChv)e(msglvl)j(msgFile)e(nDJ)i(nUJ)g(nDI)g(nUI)g(type)g │ │ │ │ │ -(symflag)e(seed)227 553 y Fn(This)30 b(driv)m(er)h(program)g(tests)g │ │ │ │ │ -(the)h Fm(Chv)p 1585 553 29 4 v 33 w(assembleChv)c Fn(metho)s(d.)42 │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fn(18)p 182 100 1154 │ │ │ │ │ +4 v 1336 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2746 100 V 111 399 a Fn(2.)46 b Fm(test_assmbChv)e(msglvl)j │ │ │ │ │ +(msgFile)e(nDJ)i(nUJ)g(nDI)g(nUI)g(type)g(symflag)e(seed)227 │ │ │ │ │ +553 y Fn(This)30 b(driv)m(er)h(program)g(tests)g(the)h │ │ │ │ │ +Fm(Chv)p 1585 553 29 4 v 33 w(assembleChv)c Fn(metho)s(d.)42 │ │ │ │ │ b(It)31 b(assem)m(bles)g(a)h(c)m(hevron)f Fb(T)3517 567 │ │ │ │ │ y Fa(I)3588 553 y Fn(in)m(to)h Fb(T)3826 567 y Fa(J)3875 │ │ │ │ │ 553 y Fn(,)227 666 y(as)c(is)f(done)h(during)e(the)h(assem)m(bly)h(of)g │ │ │ │ │ (p)s(ostp)s(oned)e(ro)m(ws)h(and)g(columns)g(during)f(the)i │ │ │ │ │ (factorization)i(when)227 779 y(piv)m(oting)42 b(is)f(enabled.)72 │ │ │ │ │ b(Use)41 b(the)f(script)h(\014le)g Fm(do)p 1967 779 V │ │ │ │ │ 34 w(assmbChv)d Fn(for)j(testing.)72 b(When)41 b(the)g(output)f(\014le) │ │ │ │ │ @@ -7055,17 +7046,17 @@ │ │ │ │ │ 881 5144 V 32 w(NONSYMMETRIC)p Fn(.)337 5294 y Fe(\210)45 │ │ │ │ │ b Fn(The)32 b Fm(pivotingflag)d Fn(parameter)k(is)g(the)g(piv)m(oting)g │ │ │ │ │ (\015ag)g(|)g Fm(SPOOLES)p 2906 5294 V 32 w(NO)p 3034 │ │ │ │ │ 5294 V 34 w(PIVOTING)d Fn(for)j(no)f(piv-)427 5407 y(oting,)g │ │ │ │ │ Fm(SPOOLES)p 1027 5407 V 32 w(PIVOTING)c Fn(for)j(piv)m(oting.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 19 19 │ │ │ │ │ -TeXDict begin 19 18 bop 91 100 1135 4 v 1316 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)122 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2673 100 V 1135 w Fn(19)337 399 y Fe(\210)45 b Fn(The)35 │ │ │ │ │ +TeXDict begin 19 18 bop 91 100 1154 4 v 1335 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2654 100 V 1154 w Fn(19)337 399 y Fe(\210)45 b Fn(The)35 │ │ │ │ │ b Fm(storeflag)e Fn(parameter)j(is)g(the)g(storage)h(\015ag,)g(to)g │ │ │ │ │ (store)f(b)m(y)f(ro)m(ws,)i(use)f Fm(SPOOLES)p 3528 399 │ │ │ │ │ 29 4 v 32 w(BY)p 3656 399 V 34 w(ROWS)p Fn(,)427 511 │ │ │ │ │ y(to)31 b(store)g(b)m(y)g(columns,)f(use)g Fm(SPOOLES)p │ │ │ │ │ 1766 511 V 32 w(BY)p 1894 511 V 34 w(COLUMNS)p Fn(.)337 │ │ │ │ │ 651 y Fe(\210)45 b Fn(The)30 b Fm(seed)f Fn(parameter)i(is)g(a)f │ │ │ │ │ (random)g(n)m(um)m(b)s(er)f(seed.)111 853 y(4.)46 b Fm │ │ │ │ │ @@ -7141,21 +7132,21 @@ │ │ │ │ │ Fn(parameter)j(determines)f(the)h(message)g(\014le)f(|)h(if)f │ │ │ │ │ Fm(msgFile)e Fn(is)i Fm(stdout)p Fn(,)g(then)g(the)427 │ │ │ │ │ 5294 y(message)27 b(\014le)f(is)g Fl(stdout)p Fn(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Fl(app)-5 b(end)28 │ │ │ │ │ b Fn(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 5407 │ │ │ │ │ y(data.)p eop end │ │ │ │ │ %%Page: 20 20 │ │ │ │ │ -TeXDict begin 20 19 bop 0 100 a Fn(20)p 182 100 1135 │ │ │ │ │ -4 v 1317 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2765 100 V 337 399 a Fe(\210)45 │ │ │ │ │ -b Fn(The)30 b Fm(nD)g Fn(parameter)h(is)f(the)h(n)m(um)m(b)s(er)e(of)h │ │ │ │ │ -(ro)m(ws)h(and)e(columns)h(in)h(the)f(\(1,1\))i(blo)s(c)m(k.)337 │ │ │ │ │ -551 y Fe(\210)45 b Fn(The)30 b Fm(nU)g Fn(parameter)h(is)f(the)h(n)m │ │ │ │ │ -(um)m(b)s(er)e(of)h(columns)g(in)g(the)h(\(1,2\))h(blo)s(c)m(k.)337 │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fn(20)p 182 100 1154 │ │ │ │ │ +4 v 1336 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2746 100 V 337 399 a Fe(\210)45 b Fn(The)30 b │ │ │ │ │ +Fm(nD)g Fn(parameter)h(is)f(the)h(n)m(um)m(b)s(er)e(of)h(ro)m(ws)h(and) │ │ │ │ │ +e(columns)h(in)h(the)f(\(1,1\))i(blo)s(c)m(k.)337 551 │ │ │ │ │ +y Fe(\210)45 b Fn(The)30 b Fm(nU)g Fn(parameter)h(is)f(the)h(n)m(um)m │ │ │ │ │ +(b)s(er)e(of)h(columns)g(in)g(the)h(\(1,2\))h(blo)s(c)m(k.)337 │ │ │ │ │ 703 y Fe(\210)45 b Fn(The)30 b Fm(type)f Fn(parameter)i(denotes)g(the)g │ │ │ │ │ (t)m(yp)s(e)f(of)h(en)m(tries)g(|)f Fm(SPOOLES)p 2818 │ │ │ │ │ 703 29 4 v 32 w(REAL)g Fn(or)g Fm(SPOOLES)p 3519 703 │ │ │ │ │ V 32 w(COMPLEX)337 855 y Fe(\210)45 b Fn(The)20 b Fm(symflag)e │ │ │ │ │ Fn(parameter)j(is)f(the)h(symmetry)f(\015ag)g(|)g Fm(SPOOLES)p │ │ │ │ │ 2640 855 V 33 w(SYMMETRIC)p Fn(,)e Fm(SPOOLES)p 3484 │ │ │ │ │ 855 V 32 w(HERMITIAN)427 968 y Fn(or)31 b Fm(SPOOLES)p │ │ │ │ │ @@ -7223,17 +7214,17 @@ │ │ │ │ │ b Fm(rowerror)p Fn(,)f Fm(colerror)p Fn(,)h Fm(rowerror11)p │ │ │ │ │ Fn(,)e Fm(colerror11)f Fn(and)h Fm(diag11error)p Fn(.)59 │ │ │ │ │ b(All)38 b(should)f(b)s(e)227 5067 y(zero.)337 5294 y │ │ │ │ │ Fe(\210)45 b Fn(The)f Fm(msglvl)e Fn(parameter)j(determines)f(the)g │ │ │ │ │ (amoun)m(t)h(of)f(output.)82 b(Use)44 b Fm(msglvl)i(=)i(1)c │ │ │ │ │ Fn(for)g(just)427 5407 y(timing)31 b(output.)p eop end │ │ │ │ │ %%Page: 21 21 │ │ │ │ │ -TeXDict begin 21 20 bop 91 100 1135 4 v 1316 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)122 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2673 100 V 1135 w Fn(21)337 399 y Fe(\210)45 b Fn(The)33 │ │ │ │ │ +TeXDict begin 21 20 bop 91 100 1154 4 v 1335 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2654 100 V 1154 w Fn(21)337 399 y Fe(\210)45 b Fn(The)33 │ │ │ │ │ b Fm(msgFile)e Fn(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ (if)f Fm(msgFile)e Fn(is)i Fm(stdout)p Fn(,)g(then)g(the)427 │ │ │ │ │ 511 y(message)27 b(\014le)f(is)g Fl(stdout)p Fn(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Fl(app)-5 b(end)28 │ │ │ │ │ b Fn(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 624 │ │ │ │ │ y(data.)337 772 y Fe(\210)45 b Fn(The)30 b Fm(nD)g Fn(parameter)h(is)f │ │ │ │ │ (the)h(n)m(um)m(b)s(er)e(of)h(ro)m(ws)h(and)e(columns)h(in)h(the)f │ │ │ │ │ @@ -7303,19 +7294,19 @@ │ │ │ │ │ (\(1,1\))i(blo)s(c)m(k.)337 5259 y Fe(\210)45 b Fn(The)30 │ │ │ │ │ b Fm(nU)g Fn(parameter)h(is)f(the)h(n)m(um)m(b)s(er)e(of)h(columns)g │ │ │ │ │ (in)g(the)h(\(1,2\))h(blo)s(c)m(k.)337 5407 y Fe(\210)45 │ │ │ │ │ b Fn(The)30 b Fm(type)f Fn(parameter)i(denotes)g(the)g(t)m(yp)s(e)f(of) │ │ │ │ │ h(en)m(tries)g(|)f Fm(SPOOLES)p 2818 5407 V 32 w(REAL)g │ │ │ │ │ Fn(or)g Fm(SPOOLES)p 3519 5407 V 32 w(COMPLEX)p eop end │ │ │ │ │ %%Page: 22 22 │ │ │ │ │ -TeXDict begin 22 21 bop 0 100 a Fn(22)p 182 100 1135 │ │ │ │ │ -4 v 1317 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2765 100 V 337 399 a Fe(\210)45 │ │ │ │ │ -b Fn(The)20 b Fm(symflag)e Fn(parameter)j(is)f(the)h(symmetry)f(\015ag) │ │ │ │ │ -g(|)g Fm(SPOOLES)p 2640 399 29 4 v 33 w(SYMMETRIC)p Fn(,)e │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fn(22)p 182 100 1154 │ │ │ │ │ +4 v 1336 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2746 100 V 337 399 a Fe(\210)45 b Fn(The)20 b │ │ │ │ │ +Fm(symflag)e Fn(parameter)j(is)f(the)h(symmetry)f(\015ag)g(|)g │ │ │ │ │ +Fm(SPOOLES)p 2640 399 29 4 v 33 w(SYMMETRIC)p Fn(,)e │ │ │ │ │ Fm(SPOOLES)p 3484 399 V 32 w(HERMITIAN)427 511 y Fn(or)31 │ │ │ │ │ b Fm(SPOOLES)p 881 511 V 32 w(NONSYMMETRIC)p Fn(.)337 │ │ │ │ │ 659 y Fe(\210)45 b Fn(The)30 b Fm(seed)f Fn(parameter)i(is)g(a)f │ │ │ │ │ (random)g(n)m(um)m(b)s(er)f(seed.)66 876 y(10.)46 b Fm(test_swap)g │ │ │ │ │ (msglvl)g(msgFile)f(nD)j(nU)f(type)f(symflag)g(seed)227 │ │ │ │ │ 1027 y Fn(This)26 b(driv)m(er)g(program)g(tests)h(three)g(metho)s(ds:) │ │ │ │ │ 38 b Fm(Chv)p 2038 1027 V 33 w(swapRowsAndColumns\(\))p │ │ │ │ │ @@ -7389,17 +7380,17 @@ │ │ │ │ │ 5260 y Fe(\210)k Fn(The)30 b Fm(ncolT)f Fn(parameter)i(is)f(the)h(n)m │ │ │ │ │ (um)m(b)s(er)e(of)i(columns)f(in)g(the)g(\(1,1\))i(and)e(\(1,2\))i(blo) │ │ │ │ │ s(c)m(ks)f(of)g Fb(T)13 b Fn(.)337 5407 y Fe(\210)45 │ │ │ │ │ b Fn(The)30 b Fm(nDT)g Fn(parameter)g(is)h(the)f(n)m(um)m(b)s(er)g(of)g │ │ │ │ │ (ro)m(ws)g(and)g(columns)g(in)g(the)h(\(1,1\))h(blo)s(c)m(k)f(of)f │ │ │ │ │ Fb(T)13 b Fn(.)p eop end │ │ │ │ │ %%Page: 23 23 │ │ │ │ │ -TeXDict begin 23 22 bop 91 100 1135 4 v 1316 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)122 b Fi(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2673 100 V 1135 w Fn(23)337 399 y Fe(\210)45 b Fn(The)30 │ │ │ │ │ +TeXDict begin 23 22 bop 91 100 1154 4 v 1335 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2654 100 V 1154 w Fn(23)337 399 y Fe(\210)45 b Fn(The)30 │ │ │ │ │ b Fm(ncolU)f Fn(parameter)i(is)f(the)h(n)m(um)m(b)s(er)e(of)i(columns)f │ │ │ │ │ (in)g Fb(U)10 b Fn(.)337 545 y Fe(\210)45 b Fn(The)30 │ │ │ │ │ b Fm(nrowD)f Fn(parameter)i(is)f(the)h(n)m(um)m(b)s(er)e(of)i(ro)m(ws)f │ │ │ │ │ (and)g(columns)g(in)g Fb(D)s Fn(.)337 691 y Fe(\210)45 │ │ │ │ │ b Fn(The)30 b Fm(nentU)f Fn(parameter)i(is)f(the)h(n)m(um)m(b)s(er)e │ │ │ │ │ (en)m(tries)i(in)f Fb(U)10 b Fn(,)31 b(ignored)f(if)h │ │ │ │ │ Fm(sparsityflag)44 b(=)j(0)p Fn(.)337 837 y Fe(\210)e │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -23,15 +23,15 @@ │ │ │ │ │ │ unnecessary, that we put on the Chv object — the number of rows in the (2,1) block and number of │ │ │ │ │ │ columns in the (1,2) block are equal. The Chv object is used within the context of a factorization of │ │ │ │ │ │ a sparse matrix that is assumed to have symmetric structure. If we ever extend the code to handle │ │ │ │ │ │ a true nonsymmetric structure factorization (e.g., umfpack and superlu), then we can modify │ │ │ │ │ │ the Chv object to handle unequal rows and columns. │ │ │ │ │ │ During a factorization, a front has to take part in four distinct operations. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ 1. Assemble entries from the original matrix (or matrix pencil). (See the Chv addChevron() │ │ │ │ │ │ method.) │ │ │ │ │ │ 2. Accumulate updates from descendant fronts. (See the Chv update{S,H,N}() methods.) │ │ │ │ │ │ 3. Assembleanypostponeddatafromitschildrenfronts. (SeetheChv assemblePostponedData() │ │ │ │ │ │ method.) │ │ │ │ │ │ 4. Computethefactorization ofthecompletely assembledfront. (SeetheChv factor()method.) │ │ │ │ │ │ The implementor of a front object has a great deal of freedom to design the underlying data │ │ │ │ │ │ @@ -65,15 +65,15 @@ │ │ │ │ │ │ defineitsrowsandcolumns. ForasymmetricorHermitianmatrix, weonlystorethecolumnindices. │ │ │ │ │ │ For a nonsymmetric matrix, we store the both the row and column indices. This second case may │ │ │ │ │ │ seem unnecessary, since we assume that the larger global matrix has symmetric structure. However, │ │ │ │ │ │ during a factorization with pivoting enabled, a pivot element may be chosen from anywhere in the │ │ │ │ │ │ (1,1) block, so the row indices and column indices may no longer be identical. │ │ │ │ │ │ AChv object is inherently a serial, single threaded object, meaning it is designed so that only │ │ │ │ │ │ one thread or process “owns” or operates on a particular Chv object. A Chv object is an “atom” │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 3 │ │ │ │ │ │ of communication. It stores postponed rows and columns to be assembled in a parent front. It │ │ │ │ │ │ might have to be written to and read from a file in an out-of-core implementation. In a distributed │ │ │ │ │ │ environment, it is communicated between processes. For these reasons, we designed the object so │ │ │ │ │ │ that its data (the scalars that describe its dimensions, id and type, the row and column indices, │ │ │ │ │ │ and its entries) are found in contiguous storage managed by a DV object. A file operation can be │ │ │ │ │ │ done with a single read or write, a message can be sent without packing and unpacking data, or │ │ │ │ │ │ defining a new datatype. Managing working storage for a number of Chv objects is now simpler. │ │ │ │ │ │ @@ -100,15 +100,15 @@ │ │ │ │ │ │ • int symflag : symmetry flag │ │ │ │ │ │ – SPOOLES SYMMETRIC =⇒ symmetric entries │ │ │ │ │ │ – SPOOLES HERMITIAN =⇒ Hermitian entries │ │ │ │ │ │ – SPOOLES NONSYMMETRIC =⇒ nonsymmetric entries │ │ │ │ │ │ • int *rowind : pointer to the base address of the int vector that contains row indices. │ │ │ │ │ │ • int *colind : pointer to the base address of the int vector that contains column indices. │ │ │ │ │ │ • double *entries: pointer to the base address of the double vector that contains the entries. │ │ │ │ │ │ - 4 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ • DV wrkDV : object that manages the owned working storage. │ │ │ │ │ │ • Chv *next : link to a next object in a singly linked list. │ │ │ │ │ │ One can query the type and symmetry of the object using these simple macros. │ │ │ │ │ │ • CHV IS REAL(chv) is 1 if chv has real entries and 0 otherwise. │ │ │ │ │ │ • CHV IS COMPLEX(chv) is 1 if chv has complex entries and 0 otherwise. │ │ │ │ │ │ • CHV IS SYMMETRIC(chv) is 1 if chv is symmetric and 0 otherwise. │ │ │ │ │ │ • CHV IS HERMITIAN(chv) is 1 if chv is Hermitian and 0 otherwise. │ │ │ │ │ │ @@ -131,15 +131,15 @@ │ │ │ │ │ │ This method clears the object and free’s any owned data by invoking the clearData() │ │ │ │ │ │ methods for its internal DV object. There is a concluding call to Chv setDefaultFields(). │ │ │ │ │ │ Error checking: If chv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void Chv_free ( Chv *chv ) ; │ │ │ │ │ │ This method releases any storage by a call to Chv clearData() and then free the space for │ │ │ │ │ │ chv. │ │ │ │ │ │ Error checking: If chv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 5 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.2.2 Instance methods │ │ │ │ │ │ 1. int Chv_id ( Chv *chv ) ; │ │ │ │ │ │ This method returns the id of the object. │ │ │ │ │ │ Error checking: If chv is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 2. int Chv_type ( Chv *chv ) ; │ │ │ │ │ │ This method returns the type of the object. │ │ │ │ │ │ • SPOOLES REAL =⇒ real entries │ │ │ │ │ │ @@ -167,15 +167,15 @@ │ │ │ │ │ │ Error checking: If chv, pncol or pcolind is NULL, an error message is printed and zero is │ │ │ │ │ │ returned. │ │ │ │ │ │ 7. int Chv_nent ( Chv *chv ) ; │ │ │ │ │ │ This method returns number of matrix entries that the object contains. Note, for a complex │ │ │ │ │ │ chevron, this is the number of double precision complex entries, equal to one half the number │ │ │ │ │ │ of double precision entries that are stored. │ │ │ │ │ │ Error checking: If chv is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - 6 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ 8. double * Chv_entries ( Chv *chv ) ; │ │ │ │ │ │ This method returns the entries field of the object, a pointer to the base location of the │ │ │ │ │ │ double precision array that stores the complex data. │ │ │ │ │ │ Error checking: If chv is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 9. double * Chv_diagLocation ( Chv *chv, int ichv ) ; │ │ │ │ │ │ This method returns a pointer to the address of the entry in the ichv’th diagonal location. │ │ │ │ │ │ For a real chevron, to find the entry k places to the right of the diagonal entry, add k to the │ │ │ │ │ │ @@ -205,15 +205,15 @@ │ │ │ │ │ │ 14. void Chv_complexEntry ( Chv *chv, int irow, int jcol, │ │ │ │ │ │ double *pReal, double *pImag ) ; │ │ │ │ │ │ This method fills *pReal with the real part and *pImag with the imaginary part of the the │ │ │ │ │ │ entry in row irow and column jcol. Note, irow and jcol are local indices, i.e., 0 ≤ irow < │ │ │ │ │ │ nD+nLand0≤jcolentries[2*kk:2*kk+1]. │ │ │ │ │ │ @@ -281,15 +281,15 @@ │ │ │ │ │ │ in *pmaxval. Note, if the chevron is complex, the location is in terms of the complex entries, │ │ │ │ │ │ not in the real entries, i.e., if k = Chv maxabsRow(chv,...), then the complex entry is found │ │ │ │ │ │ in chv->entries[2*kk:2*kk+1]. │ │ │ │ │ │ Error checking: If chv is NULL or irow is not in [0,n1-1], an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 5. int Chv_maxabsInColumn ( Chv *chv, int jcol, int rowmark[], │ │ │ │ │ │ int tag, double *pmaxval ) ; │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 9 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 9 │ │ │ │ │ │ This method returns the location of the first element with the largest magnitude in column │ │ │ │ │ │ jcol. Element jj must have rowmark[jj] = tag to be eligible. Its magnitude is returned │ │ │ │ │ │ in *pmaxval. Note, if the chevron is complex, the location is in terms of the complex entries, │ │ │ │ │ │ not in the real entries, i.e., if k = Chv maxabsColumn11(chv,...), then the complex entry │ │ │ │ │ │ is found in chv->entries[2*kk:2*kk+1]. │ │ │ │ │ │ Error checking: If chv is NULL or irow is not in [0,n1-1], an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ @@ -322,15 +322,15 @@ │ │ │ │ │ │ number of leading rows and columns to ignore, useful when delayed rows and columns have │ │ │ │ │ │ been placed in the leading portion of the chevron. The pirow, pjcol and pntest addresses │ │ │ │ │ │ are filled with the pivot row, pivot column, and number of pivot tests performed to find the │ │ │ │ │ │ pivot. If no pivot was found, pirow and pjcol are filled with -1. The return value is the size │ │ │ │ │ │ of the pivot. If the chevron is symmetric, we can find a 1 × 1 or 2 × 2 pivot. If the chevron │ │ │ │ │ │ is nonsymmetric, we only find a 1×1 pivot. A return value of zero means that no pivot was │ │ │ │ │ │ found. │ │ │ │ │ │ - 10 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ Error checking: If chv, workDV, pirow, pjcol or pntest is NULL, or if tau < 1.0, or if │ │ │ │ │ │ ndelay < 0, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.6 Update methods │ │ │ │ │ │ 1. void Chv_updateS ( Chv *chv, SubMtx *mtxD, SubMtx *mtxU, DV *tempDV ) ; │ │ │ │ │ │ void Chv_updateH ( Chv *chv, SubMtx *mtxD, SubMtx *mtxU, DV *tempDV ) ; │ │ │ │ │ │ void Chv_updateN ( Chv *chv, SubMtx *mtxL, SubMtx *mtxD, SubMtx *mtxU, │ │ │ │ │ │ DV *tempDV ) ; │ │ │ │ │ │ @@ -364,15 +364,15 @@ │ │ │ │ │ │ This method is used to assemble entries from the matrix pencil A+σB into the block chevron │ │ │ │ │ │ object. Typically the entries from A or B will come from a InpMtx object, one of whose modes │ │ │ │ │ │ of storage is by single chevrons. The value ichvis the row and column location of the diagonal │ │ │ │ │ │ entry. The indices found in chvind[] are offsets. Let off = chvind[ii] be the offset for one │ │ │ │ │ │ of the chevron’s entries. If off ≥ 0, then the entry is found in location (ichv, ichv+off) of │ │ │ │ │ │ the matrix. If off < 0, then the entry is found in location (ichv-off, ichv) of the matrix. │ │ │ │ │ │ The value(s) in alpha[] form a scalar used to scale the entire chevron for its assembly. A │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 11 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 11 │ │ │ │ │ │ call to assemble entries in A (from the pencil A+σB) would have alpha[] = (1.0,0.0); to │ │ │ │ │ │ assemble entries in B (from the pencil A+σB) would have alpha[] = (Real(σ),Imag(σ)). │ │ │ │ │ │ Error checking: If chv, chvind, chvent or alpha is NULL, or if ichv or chvsize are less than │ │ │ │ │ │ zero, an error message is printed and the program exits. │ │ │ │ │ │ 2. void Chv_assembleChv ( Chv *chvJ, Chv *chvI ) ; │ │ │ │ │ │ This method is used to assemble entries from one Chv object into another. The application │ │ │ │ │ │ is during a factorization with pivoting, postponed entries from the children are stored in the │ │ │ │ │ │ @@ -386,15 +386,15 @@ │ │ │ │ │ │ data from the children (objects are held in a list where firstchild is the head) into a Chv │ │ │ │ │ │ object newchv. The return value is the number of delayed rows and columns from the children │ │ │ │ │ │ fronts which are found in the leading rows and columns of the chevron. │ │ │ │ │ │ Error checking: If newchv, oldchv or firstchild is NULL, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 1.2.8 Factorization methods │ │ │ │ │ │ 1. int Chv_factorWithPivoting ( Chv *chv, int ndelay, int pivotflag, │ │ │ │ │ │ - IV *pivotsizesIV, DV *workDV, double tau, int *pntest ) ; │ │ │ │ │ │ + IV *pivotsizesIV, DV *workDV, double tau, int *pntest ) ; │ │ │ │ │ │ This method factors a front using pivoting for numerical stability. The number of rows and │ │ │ │ │ │ columns that have been delayed (assembled from the children) is given by ndelay, this allows │ │ │ │ │ │ the method that finds the pivots to skip over these rows and columns since no pivot can be │ │ │ │ │ │ found there. When pivoting is enabled (pivotflag is SPOOLES PIVOTING), the workDV object │ │ │ │ │ │ used during the search process for pivots must be non-NULL, tau is the upper bound on factor │ │ │ │ │ │ entries, and pivotsizesIV must be non-NULL when the front is symmetric or Hermitian. │ │ │ │ │ │ The address pntest is incremented with the number of pivot tests by the Chv findPivot() │ │ │ │ │ │ @@ -404,15 +404,15 @@ │ │ │ │ │ │ chevron is symmetric or Hermitian, pivotflag == SPOOLES PIVOTING and pivotsizesIV is │ │ │ │ │ │ NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. int Chv_factorWithNoPivoting ( Chv *chv, PatchAndGoInfo *info ) ; │ │ │ │ │ │ This method factors a front without using pivoting for numerical stability. It does support │ │ │ │ │ │ “patch-and-go” functionality, where if a small or zero entry is found in the diagonal element │ │ │ │ │ │ that is to be eliminated, some action can be taken. The return value is the number of │ │ │ │ │ │ eliminated rows and columns. │ │ │ │ │ │ - 12 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ Error checking: If chv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. int Chv_r1upd ( Chv *chv ) ; │ │ │ │ │ │ This method is used during the factorization of a front, performing a rank-one update of the │ │ │ │ │ │ chevron. The return value is 1 if the pivot is nonzero, 0 otherwise. │ │ │ │ │ │ Error checking: If chv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. int Chv_r2upd ( Chv *chv ) ; │ │ │ │ │ │ This method is used during the factorization of a front, performing a rank-two update of the │ │ │ │ │ │ @@ -440,15 +440,15 @@ │ │ │ │ │ │ • CHV STRICT LOWER =⇒ count strict lower entries │ │ │ │ │ │ • CHV DIAGONAL =⇒ count diagonal entries │ │ │ │ │ │ • CHV STRICT UPPER =⇒ count strict upper entries │ │ │ │ │ │ • CHV STRICT LOWER 11 =⇒ count strict lower entries in the (1,1) block │ │ │ │ │ │ • CHV LOWER 21 =⇒ count lower entries in the (2,1) block │ │ │ │ │ │ • CHV STRICT UPPER 11 =⇒ count strict upper entries in the (1,1) block │ │ │ │ │ │ • CHV UPPER 12 =⇒ count upper entries in the (1,2) block │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 13 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 13 │ │ │ │ │ │ This method is used to compute the necessary storage to store a chevron as a dense front. │ │ │ │ │ │ Error checking: If chv is NULL or if countflag is not valid, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 2. int Chv_countBigEntries ( Chv *chv, int npivot, int pivotsizes[], │ │ │ │ │ │ int countflag, double droptol ) ; │ │ │ │ │ │ This method counts the number of entries in the chevron that are larger in magnitude than │ │ │ │ │ │ droptol. countflag has the following meaning. │ │ │ │ │ │ @@ -458,15 +458,15 @@ │ │ │ │ │ │ • CHV LOWER 21 =⇒ count lower entries in the (2,1) block │ │ │ │ │ │ • CHV STRICT UPPER 11 =⇒ count strict upper entries in the (1,1) block │ │ │ │ │ │ • CHV UPPER 12 =⇒ count upper entries in the (1,2) block │ │ │ │ │ │ This method is used to compute the necessary storage to store a chevron as a sparse front. │ │ │ │ │ │ Error checking: If chv is NULL or if countflag is not valid, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 3. int Chv_copyEntriesToVector ( Chv *chv, int npivot, int pivotsizes[], │ │ │ │ │ │ - int length, double dvec[], int copyflag, int storeflag) ; │ │ │ │ │ │ + int length, double dvec[], int copyflag, int storeflag) ; │ │ │ │ │ │ This method copies some entries the chevron object into a double precision vector. This │ │ │ │ │ │ method is called after a front has been factored and is used to store the factor entries into │ │ │ │ │ │ the storage for the factor matrix. If the front is nonsymmetric, the front contains entries of │ │ │ │ │ │ L, D and U, where D is diagonal. If the front is symmetric or Hermitian, the front contains │ │ │ │ │ │ entries of D and U, and D is diagonal if pivotsizesIV is NULL or may contain a mixture of │ │ │ │ │ │ 1×1and2×2pivots otherwise. copyflag has the following meaning. │ │ │ │ │ │ • CHV STRICT LOWER =⇒ copy strict lower entries │ │ │ │ │ │ @@ -477,15 +477,15 @@ │ │ │ │ │ │ • CHV STRICT UPPER 11 =⇒ copy strict upper entries in the (1,1) block │ │ │ │ │ │ • CHV UPPER 12 =⇒ copy upper entries in the (1,2) block │ │ │ │ │ │ If storeflagisCHV BY ROWS,theentriesarestoredbyrowsandifstoreflagisCHV BY COLUMNS, │ │ │ │ │ │ the entries are stored by columns. │ │ │ │ │ │ Error checking: If chv or dvec is NULL or if length is less than the number of entries to be │ │ │ │ │ │ copied, or if copyflag or storeflag is valid, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - 14 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 14 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ 4. int Chv_copyBigEntriesToVector ( Chv *chv, int npivot, int pivotsizes[], │ │ │ │ │ │ int sizes[], int ivec[], double dvec[], │ │ │ │ │ │ int copyflag, int storeflag, double droptol ) ; │ │ │ │ │ │ This method also copies some entries the chevron object into a double precision vector, but │ │ │ │ │ │ only those entries whose magnitude is greater than or equal to droptol are copied. This │ │ │ │ │ │ method is called after a front has been factored and is used to store the factor entries of large │ │ │ │ │ │ magnitude into the storage for the factor matrix. If the front is nonsymmetric, the front │ │ │ │ │ │ @@ -517,15 +517,15 @@ │ │ │ │ │ │ Error checking: If chvI or chvJ is NULL, or if offset < 0 or offset is greater than the │ │ │ │ │ │ number of chevrons in chvJ, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.10 Swap methods │ │ │ │ │ │ 1. void Chv_swapRows ( Chv *chv, int irow, int jrow ) ; │ │ │ │ │ │ This method swaps rows irow and jrow of the chevron. Both rows must be less than the │ │ │ │ │ │ width nD of the chevron. The row ids of the two rows are also swapped. If the chevron is │ │ │ │ │ │ symmetric, then the method Chv swapRowsAndColumns() is called. │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 15 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 15 │ │ │ │ │ │ Error checking: If chv is NULL or if irow or jrow are less than 0 or greater than or equal to │ │ │ │ │ │ nD, an error message is printed and the program exits. │ │ │ │ │ │ 2. void Chv_swapColumns ( Chv *chv, int icol, int jcol ) ; │ │ │ │ │ │ This method swaps columns icol and jcol of the chevron. Both columns must be less than │ │ │ │ │ │ the width nD of the chevron. The column ids of the two columns are also swapped. If the │ │ │ │ │ │ chevron is symmetric, then the method Chv swapRowsAndColumns() is called. │ │ │ │ │ │ Error checking: If chv is NULL or if icol or jcol are less than 0 or greater than or equal to │ │ │ │ │ │ @@ -553,15 +553,15 @@ │ │ │ │ │ │ This method sets the scalar fields and rowind, colind and entries pointers. │ │ │ │ │ │ Error checking: If chv is NULL, or if nD ≤ 0, or if nL or nU are less than zero, or if type or │ │ │ │ │ │ symflag are not valid, an error message is printed and the program exits. │ │ │ │ │ │ 5. void Chv_shift ( Chv *chv, int shift ) ; │ │ │ │ │ │ This method is used to shift the base of the entries and adjust dimensions of the Chv object. │ │ │ │ │ │ If shift is positive, the first shift chevrons are removed from the chevron. If shift is │ │ │ │ │ │ negative, the shift previous chevrons are prepended to the chevron. This is a dangerous │ │ │ │ │ │ - 16 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 16 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ method as it changes the state of the object. We use it during the factorization of a front, │ │ │ │ │ │ where one Chv object points to the entire chevron in order to swap rows and columns, while │ │ │ │ │ │ another chevron points to the uneliminated rows and columns of the front. It is the latter │ │ │ │ │ │ chevron that is shifted during the factorization. │ │ │ │ │ │ Error checking: If chv is NULL an error message is printed and the program exits. │ │ │ │ │ │ 6. void Chv_fill11block ( Chv *chv, A2 *mtx ) ; │ │ │ │ │ │ This method is used to fill a A2 dense matrix object with the entries in the (1,1) block of the │ │ │ │ │ │ @@ -584,15 +584,15 @@ │ │ │ │ │ │ 11. void Chv_sub ( Chv *chvJ, Chv *chvI ) ; │ │ │ │ │ │ This method subtracts chvI from chvJ. │ │ │ │ │ │ Error checking: If chvJ or chvI is NULL, or if their dimensions are not the same, or if either │ │ │ │ │ │ of their entries fields are NULL, an error message is printed and the program exits. │ │ │ │ │ │ 12. void Chv_zero ( Chv *chv ) ; │ │ │ │ │ │ This method zeroes the entries in the chevron. │ │ │ │ │ │ Error checking: If chv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 17 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 17 │ │ │ │ │ │ 1.2.12 IO methods │ │ │ │ │ │ 1. void Chv_writeForHumanEye ( Chv *chv, FILE *fp ) ; │ │ │ │ │ │ This method writes a Chv object to a file in an easily readable format. │ │ │ │ │ │ Error checking: If chv or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 2. void Chv_writeForMatlab ( Chv *chv, char *chvname, FILE *fp ) ; │ │ │ │ │ │ This method writes a Chv object to a file in a matlab format. For a real chevron, a sample │ │ │ │ │ │ line is │ │ │ │ │ │ @@ -605,29 +605,29 @@ │ │ │ │ │ │ returned. │ │ │ │ │ │ 1.3 Driver programs for the Chv object │ │ │ │ │ │ 1. test_addChevron msglvl msgFile nD nU type symflag seed alphareal alphaimag │ │ │ │ │ │ This driver program tests the Chv addChevron method. Use the script file do addChevron │ │ │ │ │ │ for testing. When the output file is loaded into matlab, the last line to the screen is the error │ │ │ │ │ │ of the assembly. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ - timing output. │ │ │ │ │ │ + timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ - message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ - data. │ │ │ │ │ │ + message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ + data. │ │ │ │ │ │ • The nD parameter is the number of rows and columns in the (1,1) block. │ │ │ │ │ │ • The nU parameter is the number of columns in the (1,2) block. │ │ │ │ │ │ • The type parameter denotes the type of entries — SPOOLES REAL or SPOOLES COMPLEX │ │ │ │ │ │ • Thesymflagparameteristhesymmetryflag—SPOOLES SYMMETRIC,SPOOLES HERMITIAN │ │ │ │ │ │ - or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ + or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ • The alphareal and alphaimag parameters form a complex number that is a scaling │ │ │ │ │ │ - parameter. Normally alpha is (1.0,0.0), when we are just loading matrix entries into a │ │ │ │ │ │ - front. However, when we factor A+αB, the entries of B will be loaded with alpha set │ │ │ │ │ │ - equal to α[0 : 1]. │ │ │ │ │ │ - 18 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + parameter. Normally alpha is (1.0,0.0), when we are just loading matrix entries into a │ │ │ │ │ │ + front. However, when we factor A+αB, the entries of B will be loaded with alpha set │ │ │ │ │ │ + equal to α[0 : 1]. │ │ │ │ │ │ + 18 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ 2. test_assmbChv msglvl msgFile nDJ nUJ nDI nUI type symflag seed │ │ │ │ │ │ This driver program tests the Chv assembleChv method. It assembles a chevron T into T , │ │ │ │ │ │ I J │ │ │ │ │ │ as is done during the assembly of postponed rows and columns during the factorization when │ │ │ │ │ │ pivoting is enabled. Use the script file do assmbChv for testing. When the output file is │ │ │ │ │ │ loaded into matlab, the last line to the screen is the error of the assembly. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ @@ -658,55 +658,55 @@ │ │ │ │ │ │ • The nD parameter is the number of rows and columns in the (1,1) block. │ │ │ │ │ │ • The nU parameter is the number of columns in the (1,2) block. │ │ │ │ │ │ • The type parameter denotes the type of entries — SPOOLES REAL or SPOOLES COMPLEX │ │ │ │ │ │ • Thesymflagparameteristhesymmetryflag—SPOOLES SYMMETRIC,SPOOLES HERMITIAN │ │ │ │ │ │ or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ • The pivotingflag parameter is the pivoting flag — SPOOLES NO PIVOTING for no piv- │ │ │ │ │ │ oting, SPOOLES PIVOTING for pivoting. │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 19 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 19 │ │ │ │ │ │ • The storeflag parameter is the storage flag, to store by rows, use SPOOLES BY ROWS, │ │ │ │ │ │ - to store by columns, use SPOOLES BY COLUMNS. │ │ │ │ │ │ + to store by columns, use SPOOLES BY COLUMNS. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ 4. test_copyBigEntriesToVector msglvl msgFile nD nU type symflag │ │ │ │ │ │ pivotingflag storeflag seed droptol │ │ │ │ │ │ This driver program tests the Chv copyBigEntriesToVector method which is used when │ │ │ │ │ │ after a front has been factored to store the entries into sparse L and U submatrices. Use │ │ │ │ │ │ the script file do copyBigEntriesToVector for testing. When the output file is loaded into │ │ │ │ │ │ matlab, the last line to the screen is a matrix that contains three entries. The first two are │ │ │ │ │ │ the maximum magnitudes of the entries that were not copied (two different ways), and the │ │ │ │ │ │ third is the drop tolerance. If the program executes correctly, the third term is larger than │ │ │ │ │ │ the first two. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ - timing output. │ │ │ │ │ │ + timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ - message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ - data. │ │ │ │ │ │ + message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ + data. │ │ │ │ │ │ • The nD parameter is the number of rows and columns in the (1,1) block. │ │ │ │ │ │ • The nU parameter is the number of columns in the (1,2) block. │ │ │ │ │ │ • The type parameter denotes the type of entries — SPOOLES REAL or SPOOLES COMPLEX │ │ │ │ │ │ • Thesymflagparameteristhesymmetryflag—SPOOLES SYMMETRIC,SPOOLES HERMITIAN │ │ │ │ │ │ - or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ + or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ • The pivotingflag parameter is the pivoting flag — SPOOLES NO PIVOTING for no piv- │ │ │ │ │ │ - oting, SPOOLES PIVOTING for pivoting. │ │ │ │ │ │ + oting, SPOOLES PIVOTING for pivoting. │ │ │ │ │ │ • The storeflag parameter is the storage flag, to store by rows, use SPOOLES BY ROWS, │ │ │ │ │ │ - to store by columns, use SPOOLES BY COLUMNS. │ │ │ │ │ │ + to store by columns, use SPOOLES BY COLUMNS. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ • The droptol parameter is a drop tolerance parameters, entries whose magnitude is │ │ │ │ │ │ - smaller than droptol are not copied. │ │ │ │ │ │ + smaller than droptol are not copied. │ │ │ │ │ │ 5. test_factor msglvl msgFile nD nU type symflag pivotingflag seed tau │ │ │ │ │ │ This driver program tests the Chv factor method. Use the script file do factor for testing. │ │ │ │ │ │ Whentheoutputfileisloadedinto matlab, the last line to the screen is a matrix that contains │ │ │ │ │ │ three entries. The first entry is the error in the factorization. The second and third entries │ │ │ │ │ │ are the maximum magnitudes of the entries in L and U, respectively. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ - timing output. │ │ │ │ │ │ + timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ - message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ - data. │ │ │ │ │ │ - 20 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ + data. │ │ │ │ │ │ + 20 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ • The nD parameter is the number of rows and columns in the (1,1) block. │ │ │ │ │ │ • The nU parameter is the number of columns in the (1,2) block. │ │ │ │ │ │ • The type parameter denotes the type of entries — SPOOLES REAL or SPOOLES COMPLEX │ │ │ │ │ │ • Thesymflagparameteristhesymmetryflag—SPOOLES SYMMETRIC,SPOOLES HERMITIAN │ │ │ │ │ │ or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ • The pivotingflag parameter is the pivoting flag — SPOOLES NO PIVOTING for no piv- │ │ │ │ │ │ oting, SPOOLES PIVOTING for pivoting. │ │ │ │ │ │ @@ -735,52 +735,52 @@ │ │ │ │ │ │ ThisdriverprogramteststheChv maxabsInRow(),Chv maxabsInRow11(),Chv maxabsInColumn(), │ │ │ │ │ │ Chv maxabsInColumn11() and Chv maxabsInDiagonal11() methods. Use the script file │ │ │ │ │ │ do maxabs for testing. When the output file is loaded into matlab, look on the screen for the │ │ │ │ │ │ variables rowerror, colerror, rowerror11, colerror11 and diag11error. All should be │ │ │ │ │ │ zero. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ timing output. │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 21 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 21 │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ - message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ - data. │ │ │ │ │ │ + message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ + data. │ │ │ │ │ │ • The nD parameter is the number of rows and columns in the (1,1) block. │ │ │ │ │ │ • The nU parameter is the number of columns in the (1,2) block. │ │ │ │ │ │ • The type parameter denotes the type of entries — SPOOLES REAL or SPOOLES COMPLEX │ │ │ │ │ │ • Thesymflagparameteristhesymmetryflag—SPOOLES SYMMETRIC,SPOOLES HERMITIAN │ │ │ │ │ │ - or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ + or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ • The pivotingflag parameter is the pivoting flag — SPOOLES NO PIVOTING for no piv- │ │ │ │ │ │ - oting, SPOOLES PIVOTING for pivoting. │ │ │ │ │ │ + oting, SPOOLES PIVOTING for pivoting. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ 8. test_r1upd msglvl msgFile nD nU type symflag seed │ │ │ │ │ │ This driver program tests the Chv r1upd() method. Use the script file do r1upd for testing. │ │ │ │ │ │ When the output file is loaded into matlab, the last line is the error of the update. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ - timing output. │ │ │ │ │ │ + timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ - message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ - data. │ │ │ │ │ │ + message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ + data. │ │ │ │ │ │ • The nD parameter is the number of rows and columns in the (1,1) block. │ │ │ │ │ │ • The nU parameter is the number of columns in the (1,2) block. │ │ │ │ │ │ • The type parameter denotes the type of entries — SPOOLES REAL or SPOOLES COMPLEX │ │ │ │ │ │ • Thesymflagparameteristhesymmetryflag—SPOOLES SYMMETRIC,SPOOLES HERMITIAN │ │ │ │ │ │ - or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ + or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ 9. test_r2upd msglvl msgFile nD nU type symflag seed │ │ │ │ │ │ This driver program tests the Chv r2upd() method. Use the script file do r2upd for testing. │ │ │ │ │ │ When the output file is loaded into matlab, the last line is the error of the update. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ - timing output. │ │ │ │ │ │ + timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ - message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ - data. │ │ │ │ │ │ + message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ + data. │ │ │ │ │ │ • The nD parameter is the number of rows and columns in the (1,1) block. │ │ │ │ │ │ • The nU parameter is the number of columns in the (1,2) block. │ │ │ │ │ │ • The type parameter denotes the type of entries — SPOOLES REAL or SPOOLES COMPLEX │ │ │ │ │ │ - 22 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 22 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ • Thesymflagparameteristhesymmetryflag—SPOOLES SYMMETRIC,SPOOLES HERMITIAN │ │ │ │ │ │ or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ 10. test_swap msglvl msgFile nD nU type symflag seed │ │ │ │ │ │ This driver program tests three methods: Chv swapRowsAndColumns(), Chv swapRows() and │ │ │ │ │ │ Chv swapColumns(). Use the script file do swap for testing. When the output file is loaded │ │ │ │ │ │ into matlab, look for the maxerrrowswap1, maxerrcolswap1, maxerrswap, maxerrsymswap1 │ │ │ │ │ │ @@ -810,15 +810,15 @@ │ │ │ │ │ │ • The type parameter denotes the type of entries — SPOOLES REAL or SPOOLES COMPLEX │ │ │ │ │ │ • Thesymflagparameteristhesymmetryflag—SPOOLES SYMMETRIC,SPOOLES HERMITIAN │ │ │ │ │ │ or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ • The sparsityflag parameter should be zero for dense U and L, or 1 for sparse U and │ │ │ │ │ │ L. │ │ │ │ │ │ • The ncolT parameter is the number of columns in the (1,1) and (1,2) blocks of T. │ │ │ │ │ │ • The nDT parameter is the number of rows and columns in the (1,1) block of T. │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 23 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 23 │ │ │ │ │ │ • The ncolU parameter is the number of columns in U. │ │ │ │ │ │ • The nrowD parameter is the number of rows and columns in D. │ │ │ │ │ │ • The nentU parameter is the number entries in U, ignored if sparsityflag = 0. │ │ │ │ │ │ • The offset parameter is the offset of first index in T from the last index in D. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ Index │ │ │ │ │ │ Chv addChevron(), 10 Chv new(), 4 │ │ │ ├── ./usr/share/doc/spooles-doc/ChvList.ps.gz │ │ │ │ ├── ChvList.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o ChvList.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1761,21 +1761,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1959,88 +1958,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3306,17 +3300,17 @@ │ │ │ │ │ 59 4[44 44 3[56 62 93 31 2[31 62 2[51 62 50 1[54 11[86 │ │ │ │ │ 5[84 5[42 6[80 13[56 56 56 56 2[31 46[{}23 99.6264 /CMBX12 │ │ │ │ │ rf /Fc 137[62 1[62 62 9[62 62 27[62 8[62 67[{}7 119.552 │ │ │ │ │ /CMTT12 rf /Fd 134[71 3[75 52 53 55 1[75 67 75 112 3[37 │ │ │ │ │ 75 1[41 61 75 60 1[65 13[75 2[92 11[103 17[67 67 2[37 │ │ │ │ │ 46[{}22 119.552 /CMBX12 rf /Fe 141[38 2[46 51 2[42 1[28 │ │ │ │ │ 46 42 1[42 1[42 14[65 1[66 11[59 62 69 2[68 6[28 58[{}16 │ │ │ │ │ -90.9091 /CMTI10 rf /Ff 134[48 3[51 2[36 12[40 2[51 45 │ │ │ │ │ -26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 90.9091 │ │ │ │ │ -/CMSL10 rf │ │ │ │ │ +90.9091 /CMTI10 rf /Ff 134[48 3[51 2[36 3[51 12[45 22[47 │ │ │ │ │ +15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 │ │ │ │ │ +rf │ │ │ │ │ %DVIPSBitmapFont: Fg tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3427,25 +3421,25 @@ │ │ │ │ │ (not)h(y)m(et)h(zero.)141 5294 y(Ha)m(ving)27 b(a)g(lo)s(c)m(k)g(asso)s │ │ │ │ │ (ciated)g(with)f(a)h Fh(ChvList)d Fi(ob)5 b(ject)27 b(is)f(optional,)i │ │ │ │ │ (for)e(example,)i(it)e(is)g(not)g(needed)g(during)0 5407 │ │ │ │ │ y(a)31 b(serial)h(factorization)i(nor)c(a)i(MPI)f(factorization.)45 │ │ │ │ │ b(In)31 b(the)g(latter)h(case)g(there)g(is)f(one)g Fh(ChvList)e │ │ │ │ │ Fi(p)s(er)h(pro)s(cess.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fi(2)p 136 100 1062 4 v │ │ │ │ │ -1244 w Fh(ChvList)28 b Ff(:)41 b Fe(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2838 100 V 0 399 a Fi(F)-8 │ │ │ │ │ -b(or)35 b(a)g(m)m(ultithreaded)g(factorization)i(there)d(is)h(one)f │ │ │ │ │ -Fh(ChvList)f Fi(ob)5 b(ject)35 b(that)g(is)g(shared)e(b)m(y)i(all)g │ │ │ │ │ -(threads.)52 b(The)0 511 y(m)m(utual)22 b(exclusion)h(lo)s(c)m(k)g │ │ │ │ │ -(that)f(is)g(\(optionally\))i(em)m(b)s(edded)d(in)h(the)g │ │ │ │ │ -Fh(ChvList)e Fi(ob)5 b(ject)23 b(is)f(a)g Fh(Lock)f Fi(ob)5 │ │ │ │ │ -b(ject)23 b(from)e(this)0 624 y(library)-8 b(.)39 b(It)27 │ │ │ │ │ -b(is)f(inside)g(the)g Fh(Lock)f Fi(ob)5 b(ject)27 b(that)g(w)m(e)f(ha)m │ │ │ │ │ -(v)m(e)i(a)e(m)m(utual)h(exclusion)g(lo)s(c)m(k.)40 b(Presen)m(tly)27 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fi(2)p 136 100 1081 4 v │ │ │ │ │ +1263 w Fh(ChvList)29 b Ff(:)40 b Fe(DRAFT)30 b Ff(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2819 100 V 0 399 a Fi(F)-8 b(or)35 b(a)g(m)m(ultithreaded)g │ │ │ │ │ +(factorization)i(there)d(is)h(one)f Fh(ChvList)f Fi(ob)5 │ │ │ │ │ +b(ject)35 b(that)g(is)g(shared)e(b)m(y)i(all)g(threads.)52 │ │ │ │ │ +b(The)0 511 y(m)m(utual)22 b(exclusion)h(lo)s(c)m(k)g(that)f(is)g │ │ │ │ │ +(\(optionally\))i(em)m(b)s(edded)d(in)h(the)g Fh(ChvList)e │ │ │ │ │ +Fi(ob)5 b(ject)23 b(is)f(a)g Fh(Lock)f Fi(ob)5 b(ject)23 │ │ │ │ │ +b(from)e(this)0 624 y(library)-8 b(.)39 b(It)27 b(is)f(inside)g(the)g │ │ │ │ │ +Fh(Lock)f Fi(ob)5 b(ject)27 b(that)g(w)m(e)f(ha)m(v)m(e)i(a)e(m)m │ │ │ │ │ +(utual)h(exclusion)g(lo)s(c)m(k.)40 b(Presen)m(tly)27 │ │ │ │ │ b(w)m(e)f(supp)s(ort)f(the)0 737 y(Solaris)32 b(and)g(POSIX)f(thread)h │ │ │ │ │ (pac)m(k)-5 b(ages.)48 b(P)m(orting)33 b(the)g(m)m(ultithreaded)f(co)s │ │ │ │ │ (des)g(to)h(another)g(platform)f(should)0 850 y(b)s(e)37 │ │ │ │ │ b(simple)h(if)g(the)h(POSIX)e(thread)h(pac)m(k)-5 b(age)40 │ │ │ │ │ b(is)e(presen)m(t.)64 b(Another)38 b(t)m(yp)s(e)g(of)g(thread)g(pac)m │ │ │ │ │ (k)-5 b(age)40 b(will)e(require)0 963 y(some)31 b(mo)s(di\014cations)f │ │ │ │ │ (to)h(the)g Fh(Lock)e Fi(ob)5 b(ject,)32 b(but)d(none)i(to)g(the)f │ │ │ │ │ @@ -3490,17 +3484,17 @@ │ │ │ │ │ (and)d Fh(heads)p Fi(,)227 5251 y Fh(counts)p Fi(,)29 │ │ │ │ │ b Fh(lock)g Fi(and)h Fh(flags)f Fi(are)i(set)g(to)g Fh(NULL)e │ │ │ │ │ Fi(.)227 5407 y Fe(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fi(If)30 b Fh(list)g Fi(is)g Fh(NULL)p Fi(,)f(an)i(error)f(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1062 4 v 1244 100 a Fh(ChvList)28 │ │ │ │ │ -b Ff(:)41 b Fe(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2791 100 V 1062 w Fi(3)111 399 y(3.)46 b Fh(void)h(ChvList_clearData)c │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1081 4 v 1263 100 a Fh(ChvList)28 │ │ │ │ │ +b Ff(:)41 b Fe(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2772 100 V 1081 w Fi(3)111 399 y(3.)46 b Fh(void)h(ChvList_clearData)c │ │ │ │ │ (\()k(ChvList)f(*list)h(\))g(;)227 555 y Fi(This)41 b(metho)s(d)g │ │ │ │ │ (clears)h(the)g(ob)5 b(ject)42 b(and)f(free's)h(an)m(y)g(o)m(wned)f │ │ │ │ │ (data)i(b)m(y)e(calling)i Fh(Chv)p 3220 555 29 4 v 34 │ │ │ │ │ w(free\(\))c Fi(for)j(eac)m(h)227 668 y(ob)5 b(ject)36 │ │ │ │ │ b(on)f(the)h(free)f(list.)56 b(If)35 b Fh(heads)f Fi(is)h(not)g │ │ │ │ │ Fh(NULL)p Fi(,)g(it)g(is)h(free'd.)55 b(If)35 b Fh(counts)e │ │ │ │ │ Fi(is)i(not)h Fh(NULL)p Fi(,)e(it)i(is)f(free'd)227 781 │ │ │ │ │ @@ -3563,27 +3557,27 @@ │ │ │ │ │ 5138 y(metho)s(d)e(returns)f(0.)227 5294 y Fe(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fi(If)29 b Fh(list)g Fi(is)h │ │ │ │ │ Fh(NULL)p Fi(,)f(or)h(if)g Fh(ilist)e Fi(is)i(not)h(in)e(the)h(range)h │ │ │ │ │ Fh([0,nlist\))p Fi(,)c(an)j(error)g(message)227 5407 │ │ │ │ │ y(is)h(prin)m(ted)f(and)f(zero)j(is)e(returned.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fi(4)p 136 100 1062 4 v │ │ │ │ │ -1244 w Fh(ChvList)28 b Ff(:)41 b Fe(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2838 100 V 111 399 a Fi(3.)46 │ │ │ │ │ -b Fh(Chv)h(*)h(ChvList_getList)43 b(\()48 b(ChvList)e(*list,)g(int)h │ │ │ │ │ -(ilist)f(\))h(;)227 549 y Fi(If)28 b(list)h Fh(ilist)e │ │ │ │ │ -Fi(is)h(empt)m(y)-8 b(,)30 b(the)f(metho)s(d)f(returns)f │ │ │ │ │ -Fh(NULL)p Fi(.)g(Otherwise,)i(if)f(the)h(list)g(needs)f(to)h(b)s(e)e │ │ │ │ │ -(lo)s(c)m(k)m(ed,)k(the)227 662 y(lo)s(c)m(k)37 b(is)e(lo)s(c)m(k)m │ │ │ │ │ -(ed.)57 b(The)34 b(head)h(of)h(the)f(list)h(is)f(sa)m(v)m(ed)i(to)f(a)f │ │ │ │ │ -(p)s(oin)m(ter)h(and)e(then)h(the)h(head)f(is)g(set)h(to)g │ │ │ │ │ -Fh(NULL)p Fi(.)227 775 y(If)c(the)h(list)g(w)m(as)f(lo)s(c)m(k)m(ed,)j │ │ │ │ │ -(the)d(n)m(um)m(b)s(er)f(of)i(lo)s(c)m(ks)g(is)g(incremen)m(ted)f(and)g │ │ │ │ │ -(the)h(lo)s(c)m(k)g(unlo)s(c)m(k)m(ed.)47 b(The)32 b(sa)m(v)m(ed)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fi(4)p 136 100 1081 4 v │ │ │ │ │ +1263 w Fh(ChvList)29 b Ff(:)40 b Fe(DRAFT)30 b Ff(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2819 100 V 111 399 a Fi(3.)46 b Fh(Chv)h(*)h(ChvList_getList)43 │ │ │ │ │ +b(\()48 b(ChvList)e(*list,)g(int)h(ilist)f(\))h(;)227 │ │ │ │ │ +549 y Fi(If)28 b(list)h Fh(ilist)e Fi(is)h(empt)m(y)-8 │ │ │ │ │ +b(,)30 b(the)f(metho)s(d)f(returns)f Fh(NULL)p Fi(.)g(Otherwise,)i(if)f │ │ │ │ │ +(the)h(list)g(needs)f(to)h(b)s(e)e(lo)s(c)m(k)m(ed,)k(the)227 │ │ │ │ │ +662 y(lo)s(c)m(k)37 b(is)e(lo)s(c)m(k)m(ed.)57 b(The)34 │ │ │ │ │ +b(head)h(of)h(the)f(list)h(is)f(sa)m(v)m(ed)i(to)f(a)f(p)s(oin)m(ter)h │ │ │ │ │ +(and)e(then)h(the)h(head)f(is)g(set)h(to)g Fh(NULL)p │ │ │ │ │ +Fi(.)227 775 y(If)c(the)h(list)g(w)m(as)f(lo)s(c)m(k)m(ed,)j(the)d(n)m │ │ │ │ │ +(um)m(b)s(er)f(of)i(lo)s(c)m(ks)g(is)g(incremen)m(ted)f(and)g(the)h(lo) │ │ │ │ │ +s(c)m(k)g(unlo)s(c)m(k)m(ed.)47 b(The)32 b(sa)m(v)m(ed)227 │ │ │ │ │ 888 y(p)s(oin)m(ter)f(is)f(returned.)227 1038 y Fe(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fi(If)29 b Fh(list)g Fi(is)h │ │ │ │ │ Fh(NULL)p Fi(,)f(or)h(if)g Fh(ilist)e Fi(is)i(not)h(in)e(the)h(range)h │ │ │ │ │ Fh([0,nlist\))p Fi(,)c(an)j(error)g(message)227 1151 │ │ │ │ │ y(is)h(prin)m(ted)f(and)f(zero)j(is)e(returned.)111 1338 │ │ │ │ │ y(4.)46 b Fh(void)h(ChvList_addObjectToList)41 b(\()48 │ │ │ │ │ b(ChvList)e(*list,)g(Chv)h(*chv,)f(int)h(ilist)f(\))i(;)227 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -22,15 +22,15 @@ │ │ │ │ │ │ The first two operations are queries, and can be done without locking the list. The third operation │ │ │ │ │ │ needs a lock only when two or more threads will be inserting objects into the list. The fourth │ │ │ │ │ │ operation requires a lock only when one thread will add an object while another thread removes │ │ │ │ │ │ the object and the incoming count is not yet zero. │ │ │ │ │ │ Having a lock associated with a ChvList object is optional, for example, it is not needed during │ │ │ │ │ │ a serial factorization nor a MPI factorization. In the latter case there is one ChvList per process. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 ChvList : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 ChvList : DRAFT January 7, 2024 │ │ │ │ │ │ For a multithreaded factorization there is one ChvList object that is shared by all threads. The │ │ │ │ │ │ mutualexclusion lock that is (optionally) embedded in the ChvListobject is a Lock object from this │ │ │ │ │ │ library. It is inside the Lock object that we have a mutual exclusion lock. Presently we support the │ │ │ │ │ │ Solaris and POSIX thread packages. Porting the multithreaded codes to another platform should │ │ │ │ │ │ be simple if the POSIX thread package is present. Another type of thread package will require │ │ │ │ │ │ some modifications to the Lock object, but none to the ChvList objects. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ @@ -52,15 +52,15 @@ │ │ │ │ │ │ 1. ChvList * ChvList_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the ChvList structure and then sets the default │ │ │ │ │ │ fields by a call to ChvList setDefaultFields(). │ │ │ │ │ │ 2. void ChvList_setDefaultFields ( ChvList *list ) ; │ │ │ │ │ │ The structure’s fields are set to default values: nlist and nlocks set to zero, and heads, │ │ │ │ │ │ counts, lock and flags are set to NULL . │ │ │ │ │ │ Error checking: If list is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - ChvList : DRAFT February 8, 2025 3 │ │ │ │ │ │ + ChvList : DRAFT January 7, 2024 3 │ │ │ │ │ │ 3. void ChvList_clearData ( ChvList *list ) ; │ │ │ │ │ │ This method clears the object and free’s any owned data by calling Chv free() for each │ │ │ │ │ │ object on the free list. If heads is not NULL, it is free’d. If counts is not NULL, it is free’d │ │ │ │ │ │ via a call to IVfree(). If flags is not NULL, it is free’d via a call to CVfree(). If the │ │ │ │ │ │ lock is not NULL, it is destroyed via a call to Lock free(). There is a concluding call to │ │ │ │ │ │ ChvList setDefaultFields(). │ │ │ │ │ │ Error checking: If list is NULL, an error message is printed and the program exits. │ │ │ │ │ │ @@ -87,15 +87,15 @@ │ │ │ │ │ │ Error checking: If list is NULL, or if ilist is not in the range [0,nlist), an error message │ │ │ │ │ │ is printed and zero is returned. │ │ │ │ │ │ 2. int ChvList_isCountZero ( ChvList *list, int ilist ) ; │ │ │ │ │ │ If counts is NULL, or if counts[ilist] equal to zero, the method returns 1. Otherwise, the │ │ │ │ │ │ method returns 0. │ │ │ │ │ │ Error checking: If list is NULL, or if ilist is not in the range [0,nlist), an error message │ │ │ │ │ │ is printed and zero is returned. │ │ │ │ │ │ - 4 ChvList : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 ChvList : DRAFT January 7, 2024 │ │ │ │ │ │ 3. Chv * ChvList_getList ( ChvList *list, int ilist ) ; │ │ │ │ │ │ If list ilist is empty, the method returns NULL. Otherwise, if the list needs to be locked, the │ │ │ │ │ │ lock is locked. The head of the list is saved to a pointer and then the head is set to NULL. │ │ │ │ │ │ If the list was locked, the number of locks is incremented and the lock unlocked. The saved │ │ │ │ │ │ pointer is returned. │ │ │ │ │ │ Error checking: If list is NULL, or if ilist is not in the range [0,nlist), an error message │ │ │ │ │ │ is printed and zero is returned. │ │ │ ├── ./usr/share/doc/spooles-doc/ChvManager.ps.gz │ │ │ │ ├── ChvManager.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o ChvManager.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1158,21 +1158,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1356,88 +1355,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3108,16 +3102,16 @@ │ │ │ │ │ TeXDict begin 40258437 52099151 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 133[50 59 4[44 44 3[56 62 93 31 2[31 62 2[51 │ │ │ │ │ 62 50 1[54 11[86 5[84 5[42 6[80 13[56 56 56 56 2[31 46[{}23 │ │ │ │ │ 99.6264 /CMBX12 rf /Fb 137[62 3[62 3[62 5[62 62 1[62 │ │ │ │ │ 3[62 19[62 9[62 67[{}9 119.552 /CMTT12 rf /Fc 134[71 │ │ │ │ │ 3[75 52 53 55 1[75 67 75 112 3[37 75 1[41 61 75 60 1[65 │ │ │ │ │ 13[75 2[92 11[103 17[67 67 2[37 46[{}22 119.552 /CMBX12 │ │ │ │ │ -rf /Fd 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 │ │ │ │ │ -2[45 2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf /Fe 134[44 │ │ │ │ │ +rf /Fd 134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 │ │ │ │ │ +1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf /Fe 134[44 │ │ │ │ │ 4[30 37 38 2[46 51 74 23 42 1[28 46 42 1[42 46 42 1[46 │ │ │ │ │ 12[65 1[66 11[59 62 69 2[68 6[28 12[33 45[{}24 90.9091 │ │ │ │ │ /CMTI10 rf │ │ │ │ │ %DVIPSBitmapFont: Ff tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ @@ -3237,21 +3231,21 @@ │ │ │ │ │ (recycling)i(mo)s(de.)141 5294 y(A)39 b(m)m(ultithreaded)g(en)m │ │ │ │ │ (vironmen)m(t)g(creates)h(some)f(di\016culties.)66 b(Should)37 │ │ │ │ │ b(there)i(b)s(e)f(one)h(manager)g(ob)5 b(ject)0 5407 │ │ │ │ │ y(p)s(er)30 b(thread,)h(or)g(should)e(all)j(the)f(threads)g(share)f │ │ │ │ │ (one)h(ob)5 b(ject?)43 b(W)-8 b(e)32 b(ha)m(v)m(e)g(c)m(hosen)f(the)g │ │ │ │ │ (latter)i(course,)e(but)f(this)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fh(2)p 136 100 1038 4 v │ │ │ │ │ -1220 w Fg(DChvList)28 b Fd(:)41 b Fe(DRAFT)30 b Fd(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2862 100 V 0 399 a Fh(requires)f(that)i(a)f │ │ │ │ │ -(lo)s(c)m(k)h(b)s(e)e(presen)m(t)h(to)h(guard)e(the)h(critical)i │ │ │ │ │ -(section)f(of)f(co)s(de)g(where)f(one)h(searc)m(hes)h(or)f(adds)f(an)0 │ │ │ │ │ -511 y(ob)5 b(ject)38 b(to)g(the)f(list.)61 b(The)36 b(lo)s(c)m(k)i(w)m │ │ │ │ │ -(e)g(use)e(is)h(a)h Fg(Lock)d Fh(ob)5 b(ject,)40 b(and)d(so)g(the)g │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fh(2)p 136 100 1057 4 v │ │ │ │ │ +1239 w Fg(DChvList)28 b Fd(:)41 b Fe(DRAFT)30 b Fd(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2843 100 V 0 399 a Fh(requires)f(that)i(a)f(lo)s(c)m(k)h(b)s(e) │ │ │ │ │ +e(presen)m(t)h(to)h(guard)e(the)h(critical)i(section)f(of)f(co)s(de)g │ │ │ │ │ +(where)f(one)h(searc)m(hes)h(or)f(adds)f(an)0 511 y(ob)5 │ │ │ │ │ +b(ject)38 b(to)g(the)f(list.)61 b(The)36 b(lo)s(c)m(k)i(w)m(e)g(use)e │ │ │ │ │ +(is)h(a)h Fg(Lock)d Fh(ob)5 b(ject,)40 b(and)d(so)g(the)g │ │ │ │ │ Fg(ChvManager)d Fh(co)s(de)j(is)g(completely)0 624 y(indep)s(enden)m(t) │ │ │ │ │ c(of)i(the)f(thread)g(pac)m(k)-5 b(age.)55 b(P)m(orting)35 │ │ │ │ │ b(to)g(a)g(new)e(system)i(migh)m(t)g(require)f(some)h(mo)s │ │ │ │ │ (di\014cation)f(to)0 737 y(the)d Fg(Lock)p Fh(,)e(but)h(none)g(to)h │ │ │ │ │ (the)g(manager)f(ob)5 b(ject.)141 873 y(Eac)m(h)46 b(manager)g(ob)5 │ │ │ │ │ b(ject)46 b(k)m(eeps)f(trac)m(k)i(of)e(certain)h(statistics,)51 │ │ │ │ │ b(b)m(ytes)46 b(in)f(their)g(w)m(orkspaces,)50 b(the)45 │ │ │ │ │ @@ -3300,17 +3294,17 @@ │ │ │ │ │ (free'ing)h(the)g(ob)5 b(ject.)111 5146 y(1.)46 b Fg(ChvManager)f(*)j │ │ │ │ │ (ChvManager_new)c(\()j(void)g(\))g(;)227 5294 y Fh(This)28 │ │ │ │ │ b(metho)s(d)f(simply)h(allo)s(cates)i(storage)g(for)e(the)g │ │ │ │ │ Fg(ChvManager)e Fh(structure)h(and)h(then)g(sets)g(the)h(default)227 │ │ │ │ │ 5407 y(\014elds)h(b)m(y)g(a)h(call)h(to)f Fg(ChvManager)p │ │ │ │ │ 1426 5407 V 32 w(setDefaultFields\(\))p Fh(.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1038 4 v 1220 100 a Fg(DChvList)28 │ │ │ │ │ -b Fd(:)41 b Fe(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2815 100 V 1038 w Fh(3)111 399 y(2.)46 b Fg(void)h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1057 4 v 1239 100 a Fg(DChvList)28 │ │ │ │ │ +b Fd(:)41 b Fe(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2796 100 V 1057 w Fh(3)111 399 y(2.)46 b Fg(void)h │ │ │ │ │ (ChvManager_setDefaultFie)o(lds)41 b(\()48 b(ChvManager)d(*manager)g │ │ │ │ │ (\))j(;)227 548 y Fh(The)20 b(structure's)g(\014elds)g(are)g(set)h(to)g │ │ │ │ │ (default)g(v)-5 b(alues:)36 b Fg(mode)p Fh(,)21 b Fg(nactive)p │ │ │ │ │ Fh(,)g Fg(nbytesactive)p Fh(,)e Fg(nbytesrequested)p │ │ │ │ │ Fh(,)227 661 y Fg(nbytesalloc)p Fh(,)26 b Fg(nrequests)p │ │ │ │ │ Fh(,)h Fg(nreleases)p Fh(,)g Fg(nlocks)g Fh(and)h Fg(nunlocks)e │ │ │ │ │ Fh(set)j(to)h(zero,)g(and)e Fg(head)f Fh(and)h Fg(lock)227 │ │ │ │ │ @@ -3377,25 +3371,24 @@ │ │ │ │ │ Fg(Chv)f Fh(ob)5 b(jects)33 b(in)m(to)g(the)g(free)f(p)s(o)s(ol)g(of)g │ │ │ │ │ (ob)5 b(jects.)47 b(The)32 b(head)g(of)g(the)g(list)227 │ │ │ │ │ 5258 y(is)f(the)f Fg(chv)g Fh(instance.)227 5407 y Fe(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fh(If)30 b Fg(manager)f │ │ │ │ │ Fh(is)h Fg(NULL)p Fh(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)f │ │ │ │ │ (zero)j(is)e(returned.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fh(4)p 136 100 1038 4 v │ │ │ │ │ -1220 w Fg(DChvList)28 b Fd(:)41 b Fe(DRAFT)30 b Fd(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2862 100 V 0 399 a Fa(1.2.4)112 │ │ │ │ │ -b(IO)38 b(metho)s(ds)111 595 y Fh(1.)46 b Fg(void)h │ │ │ │ │ -(ChvManager_writeForHuman)o(Eye)41 b(\()48 b(ChvManager)d(*manager,)g │ │ │ │ │ -(FILE)i(*fp)g(\))g(;)227 745 y Fh(This)30 b(metho)s(d)g(writes)g(the)h │ │ │ │ │ -(statistics)h(to)f(a)g(\014le)f(in)g(user)g(readable)h(form.)227 │ │ │ │ │ -896 y Fe(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fh(If)30 │ │ │ │ │ -b Fg(manager)f Fh(or)h Fg(fp)g Fh(are)h Fg(NULL)p Fh(,)e(an)h(error)g │ │ │ │ │ -(message)i(is)e(prin)m(ted)g(and)g(zero)h(is)g(returned.)p │ │ │ │ │ -eop end │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fh(4)p 136 100 1057 4 v │ │ │ │ │ +1239 w Fg(DChvList)28 b Fd(:)41 b Fe(DRAFT)30 b Fd(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2843 100 V 0 399 a Fa(1.2.4)112 b(IO)38 b(metho)s(ds)111 │ │ │ │ │ +595 y Fh(1.)46 b Fg(void)h(ChvManager_writeForHuman)o(Eye)41 │ │ │ │ │ +b(\()48 b(ChvManager)d(*manager,)g(FILE)i(*fp)g(\))g(;)227 │ │ │ │ │ +745 y Fh(This)30 b(metho)s(d)g(writes)g(the)h(statistics)h(to)f(a)g │ │ │ │ │ +(\014le)f(in)g(user)g(readable)h(form.)227 896 y Fe(Err)-5 │ │ │ │ │ +b(or)34 b(che)-5 b(cking:)40 b Fh(If)30 b Fg(manager)f │ │ │ │ │ +Fh(or)h Fg(fp)g Fh(are)h Fg(NULL)p Fh(,)e(an)h(error)g(message)i(is)e │ │ │ │ │ +(prin)m(ted)g(and)g(zero)h(is)g(returned.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ TeXDict begin 5 4 bop 0 866 a Fi(Index)0 1289 y Fg(ChvManager)p │ │ │ │ │ 486 1289 29 4 v 32 w(clearData\(\))p Fh(,)27 b(3)0 1402 │ │ │ │ │ y Fg(ChvManager)p 486 1402 V 32 w(free\(\))p Fh(,)i(3)0 │ │ │ │ │ 1515 y Fg(ChvManager)p 486 1515 V 32 w(init\(\))p Fh(,)g(3)0 │ │ │ │ │ 1628 y Fg(ChvManager)p 486 1628 V 32 w(new\(\))p Fh(,)g(2)0 │ │ │ │ │ 1741 y Fg(ChvManager)p 486 1741 V 32 w(newObjectOfSizeNbytes\(\))o │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -23,15 +23,15 @@ │ │ │ │ │ │ finds a smallest object of that size or larger.) If there is no object on the free pool of sufficient │ │ │ │ │ │ size, one is created and returned. When the user releases an object to the manager, the object │ │ │ │ │ │ is placed on the free pool. │ │ │ │ │ │ For the factorization, serial, multithreaded or MPI, we recommend using the recycling mode. │ │ │ │ │ │ A multithreaded environment creates some difficulties. Should there be one manager object │ │ │ │ │ │ per thread, or should all the threads share one object? We have chosen the latter course, but this │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 DChvList : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 DChvList : DRAFT January 7, 2024 │ │ │ │ │ │ requires that a lock be present to guard the critical section of code where one searches or adds an │ │ │ │ │ │ object to the list. The lock we use is a Lock object, and so the ChvManager code is completely │ │ │ │ │ │ independent of the thread package. Porting to a new system might require some modification to │ │ │ │ │ │ the Lock, but none to the manager object. │ │ │ │ │ │ Each manager object keeps track of certain statistics, bytes in their workspaces, the total │ │ │ │ │ │ number of bytes requested, the number of requests for a Chv objects, the number of releases, and │ │ │ │ │ │ the number of locks and unlocks. │ │ │ │ │ │ @@ -54,15 +54,15 @@ │ │ │ │ │ │ ChvManager object. │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. ChvManager * ChvManager_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the ChvManager structure and then sets the default │ │ │ │ │ │ fields by a call to ChvManager setDefaultFields(). │ │ │ │ │ │ - DChvList : DRAFT February 8, 2025 3 │ │ │ │ │ │ + DChvList : DRAFT January 7, 2024 3 │ │ │ │ │ │ 2. void ChvManager_setDefaultFields ( ChvManager *manager ) ; │ │ │ │ │ │ Thestructure’sfieldsaresettodefaultvalues: mode,nactive,nbytesactive,nbytesrequested, │ │ │ │ │ │ nbytesalloc, nrequests, nreleases, nlocks and nunlocks set to zero, and head and lock │ │ │ │ │ │ are set to NULL . │ │ │ │ │ │ Error checking: If manager is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. void ChvManager_clearData ( ChvManager *manager ) ; │ │ │ │ │ │ This method clears the object and free’s any owned data by calling Chv free() for each │ │ │ │ │ │ @@ -89,15 +89,15 @@ │ │ │ │ │ │ 2. void ChvManager_releaseObject ( ChvManager *manager, Chv *chv ) ; │ │ │ │ │ │ This method releases the chv instance into the free pool of objects. │ │ │ │ │ │ Error checking: If manager is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 3. void ChvManager_releaseListOfObjects ( ChvManager *manager, Chv *chv ) ; │ │ │ │ │ │ This method releases a list of Chv objects into the free pool of objects. The head of the list │ │ │ │ │ │ is the chv instance. │ │ │ │ │ │ Error checking: If manager is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - 4 DChvList : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 DChvList : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.4 IO methods │ │ │ │ │ │ 1. void ChvManager_writeForHumanEye ( ChvManager *manager, FILE *fp ) ; │ │ │ │ │ │ This method writes the statistics to a file in user readable form. │ │ │ │ │ │ Error checking: If manager or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ Index │ │ │ │ │ │ ChvManager clearData(), 3 │ │ │ │ │ │ ChvManager free(), 3 │ │ │ ├── ./usr/share/doc/spooles-doc/Coords.ps.gz │ │ │ │ ├── Coords.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Coords.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1237,21 +1237,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1435,88 +1434,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3896,16 +3890,16 @@ │ │ │ │ │ cleartomark │ │ │ │ │ {restore}if │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 253[71 2[{}1 90.9091 /CMSY10 rf /Fb 138[49 │ │ │ │ │ 30 37 38 1[46 46 51 2[42 1[28 46 42 1[42 46 42 1[46 12[65 │ │ │ │ │ 1[66 11[59 62 69 2[68 6[28 58[{}22 90.9091 /CMTI10 rf │ │ │ │ │ -/Fc 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 │ │ │ │ │ -2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf /Fd 133[50 │ │ │ │ │ +/Fc 134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 │ │ │ │ │ +1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf /Fd 133[50 │ │ │ │ │ 59 4[44 44 46 2[56 62 93 31 2[31 62 2[51 62 50 1[54 11[86 │ │ │ │ │ 5[84 5[42 6[80 13[56 56 56 56 2[31 46[{}24 99.6264 /CMBX12 │ │ │ │ │ rf /Fe 140[62 62 2[62 10[62 32[62 67[{}5 119.552 /CMTT12 │ │ │ │ │ rf /Ff 199[35 35 35 3[35 35 35 48[{}6 66.4176 /CMR8 rf │ │ │ │ │ %DVIPSBitmapFont: Fg tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ @@ -4011,34 +4005,34 @@ │ │ │ │ │ (metho)s(ds)f(that)h(b)s(elong)f(to)h(the)0 4808 y Fj(Coords)29 │ │ │ │ │ b Fk(ob)5 b(ject.)0 5092 y Fd(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ 5294 y Fk(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ (supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ (\014elds,)h(clearing)0 5407 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ (free'ing)h(the)g(ob)5 b(ject.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)30 b Fc(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 111 399 a Fk(1.)46 │ │ │ │ │ -b Fj(Coords)g(*)i(Coords_new)d(\()i(void)g(\))g(;)227 │ │ │ │ │ -555 y Fk(This)25 b(metho)s(d)g(simply)f(allo)s(cates)k(storage)f(for)e │ │ │ │ │ -(the)h Fj(Coords)d Fk(structure)i(and)g(then)g(sets)g(the)h(default)f │ │ │ │ │ -(\014elds)227 668 y(b)m(y)31 b(a)f(call)i(to)f Fj(Coords)p │ │ │ │ │ -1001 668 29 4 v 33 w(setDefaultFields\(\))p Fk(.)111 │ │ │ │ │ -867 y(2.)46 b Fj(void)h(Coords_setDefaultFields)41 b(\()48 │ │ │ │ │ -b(Coords)e(*coords)g(\))h(;)227 1023 y Fk(This)34 b(metho)s(d)g(sets)h │ │ │ │ │ -(the)g(structure's)f(\014elds)g(are)h(set)h(to)f(default)g(v)-5 │ │ │ │ │ -b(alues:)49 b Fj(type)e(=)h(COORDS)p 3480 1023 V 32 w(BY)p │ │ │ │ │ -3608 1023 V 34 w(TUPLE)p Fk(,)227 1136 y Fj(ndim)f(=)g(ncoor)g(=)g(0)30 │ │ │ │ │ -b Fk(and)g Fj(coors)46 b(=)i(NULL)p Fk(.)227 1292 y Fb(Err)-5 │ │ │ │ │ -b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 b Fj(coords)f │ │ │ │ │ -Fk(is)h Fj(NULL)p Fk(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g │ │ │ │ │ -(the)g(program)g(exits.)111 1492 y(3.)46 b Fj(void)h(Coords_clearData)c │ │ │ │ │ -(\()48 b(Coords)e(*coords)g(\))h(;)227 1648 y Fk(This)29 │ │ │ │ │ -b(metho)s(d)g(clears)i(data)f(and)f(releases)i(an)m(y)f(storage)h(allo) │ │ │ │ │ -s(cated)h(b)m(y)d(the)h(ob)5 b(ject.)41 b(If)30 b Fj(coords->coors)227 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)31 b Fc(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 111 399 a Fk(1.)46 b Fj(Coords)g(*)i(Coords_new)d │ │ │ │ │ +(\()i(void)g(\))g(;)227 555 y Fk(This)25 b(metho)s(d)g(simply)f(allo)s │ │ │ │ │ +(cates)k(storage)f(for)e(the)h Fj(Coords)d Fk(structure)i(and)g(then)g │ │ │ │ │ +(sets)g(the)h(default)f(\014elds)227 668 y(b)m(y)31 b(a)f(call)i(to)f │ │ │ │ │ +Fj(Coords)p 1001 668 29 4 v 33 w(setDefaultFields\(\))p │ │ │ │ │ +Fk(.)111 867 y(2.)46 b Fj(void)h(Coords_setDefaultFields)41 │ │ │ │ │ +b(\()48 b(Coords)e(*coords)g(\))h(;)227 1023 y Fk(This)34 │ │ │ │ │ +b(metho)s(d)g(sets)h(the)g(structure's)f(\014elds)g(are)h(set)h(to)f │ │ │ │ │ +(default)g(v)-5 b(alues:)49 b Fj(type)e(=)h(COORDS)p │ │ │ │ │ +3480 1023 V 32 w(BY)p 3608 1023 V 34 w(TUPLE)p Fk(,)227 │ │ │ │ │ +1136 y Fj(ndim)f(=)g(ncoor)g(=)g(0)30 b Fk(and)g Fj(coors)46 │ │ │ │ │ +b(=)i(NULL)p Fk(.)227 1292 y Fb(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +b(cking:)40 b Fk(If)30 b Fj(coords)f Fk(is)h Fj(NULL)p │ │ │ │ │ +Fk(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g(the)g(program)g │ │ │ │ │ +(exits.)111 1492 y(3.)46 b Fj(void)h(Coords_clearData)c(\()48 │ │ │ │ │ +b(Coords)e(*coords)g(\))h(;)227 1648 y Fk(This)29 b(metho)s(d)g(clears) │ │ │ │ │ +i(data)f(and)f(releases)i(an)m(y)f(storage)h(allo)s(cated)h(b)m(y)d │ │ │ │ │ +(the)h(ob)5 b(ject.)41 b(If)30 b Fj(coords->coors)227 │ │ │ │ │ 1761 y Fk(is)e(not)f Fj(NULL)p Fk(,)f(then)h Fj │ │ │ │ │ (FVfree\(coords->coors\))22 b Fk(is)27 b(called)i(to)f(free)f(the)h │ │ │ │ │ Fj(float)d Fk(v)m(ector.)42 b(It)27 b(then)g(sets)h(the)227 │ │ │ │ │ 1874 y(structure's)i(default)h(\014elds)f(with)g(a)g(call)i(to)f │ │ │ │ │ Fj(Coords)p 2071 1874 V 33 w(setDefaultFields\(\))p Fk(.)227 │ │ │ │ │ 2030 y Fb(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 │ │ │ │ │ b Fj(coords)f Fk(is)h Fj(NULL)p Fk(,)g(an)g(error)g(message)i(is)e │ │ │ │ │ @@ -4090,17 +4084,17 @@ │ │ │ │ │ Fj(n2)e Fk(or)h Fj(ncomp)e Fk(are)j(nonp)s(ositiv)m(e,)h(an)d(error)h │ │ │ │ │ (message)h(is)f(prin)m(ted)f(and)g(the)h(program)227 │ │ │ │ │ 5095 y(exits.)111 5294 y(3.)46 b Fj(void)h(Coords_init27P)d(\()j │ │ │ │ │ (Coords)f(*coords,)g(float)g(bbox[],)g(int)h(type,)1277 │ │ │ │ │ 5407 y(int)g(n1,)g(int)g(n2,)g(int)g(n3,)g(int)g(ncomp)f(\))h(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1086 4 v 1267 100 a Fj(Coords)29 │ │ │ │ │ -b Fc(:)41 b Fb(DRAFT)121 b Fc(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2767 100 V 1086 w Fk(3)227 399 y(This)g(metho)s(d)g(initializes)i(a)f │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1105 4 v 1287 100 a Fj(Coords)28 │ │ │ │ │ +b Fc(:)41 b Fb(DRAFT)121 b Fc(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2748 100 V 1105 w Fk(3)227 399 y(This)g(metho)s(d)g(initializes)i(a)f │ │ │ │ │ Fj(Coords)e Fk(ob)5 b(ject)32 b(for)f(a)h(27-p)s(oin)m(t)h(op)s(erator) │ │ │ │ │ e(on)h(a)f Fj(n1)21 b Fa(\002)f Fj(n2)h Fa(\002)f Fj(n3)31 │ │ │ │ │ b Fk(grid)g(with)227 511 y Fj(ncomp)42 b Fk(degrees)j(of)e(freedom)h │ │ │ │ │ (at)g(a)g(grid)f(p)s(oin)m(t.)81 b(The)43 b(grid's)g(lo)s(cation)i(is)f │ │ │ │ │ (giv)m(en)h(b)m(y)e(the)h(b)s(ounding)227 624 y(b)s(o)m(x)34 │ │ │ │ │ b(v)m(ector,)i Fj(bbox[0])31 b Fk(=)i Fi(x)p Fk(-co)s(ordinate)i(of)f │ │ │ │ │ (the)f(south)m(w)m(est)i(p)s(oin)m(t,)f Fj(bbox[1])e │ │ │ │ │ @@ -4181,32 +4175,32 @@ │ │ │ │ │ Fk(2,)34 b Fj(Coords)p 3110 5294 V 32 w(setValue\(coords,)227 │ │ │ │ │ 5407 y(2,)47 b(16,)g(3.3\))30 b Fk(sets)g Fi(y)1005 5421 │ │ │ │ │ y Ff(16)1105 5407 y Fk(=)25 b(3)p Fi(:)p Fk(3,)32 b(and)d │ │ │ │ │ Fj(Coords)p 1843 5407 V 33 w(setValue\(coords,)43 b(3,)48 │ │ │ │ │ b(118,)e(0\))30 b Fk(sets)h Fi(z)3409 5421 y Ff(118)3544 │ │ │ │ │ 5407 y Fk(=)25 b(0.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)30 b Fc(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 227 399 a Fb(Err)-5 │ │ │ │ │ -b(or)34 b(che)-5 b(cking:)40 b Fk(If)29 b Fj(coords)g │ │ │ │ │ -Fk(is)h Fj(NULL)p Fk(,)f(or)h(if)g Fj(idim)f Fk(do)s(es)g(not)h(lie)h │ │ │ │ │ -(in)f(the)g(range)g Fj([1,ndim])p Fk(,)e(or)i(if)g Fj(icoor)227 │ │ │ │ │ -511 y Fk(do)s(es)g(not)h(lie)g(in)f(the)h(range)g Fj([0,ncoor\))p │ │ │ │ │ -Fk(,)d(an)i(error)g(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ -(exits.)0 790 y Fd(1.2.4)112 b(IO)38 b(metho)s(ds)0 989 │ │ │ │ │ -y Fk(There)29 b(are)g(the)g(usual)g(eigh)m(t)i(IO)d(routines.)40 │ │ │ │ │ -b(The)29 b(\014le)g(structure)g(of)g(a)h Fj(Coords)d │ │ │ │ │ -Fk(ob)5 b(ject)30 b(is)f(simple:)40 b Fj(type)p Fk(,)29 │ │ │ │ │ -b Fj(ndim)p Fk(,)0 1102 y Fj(ncoor)g Fk(follo)m(w)m(ed)j(b)m(y)e(the)h │ │ │ │ │ -Fj(coors[])d Fk(v)m(ector.)111 1348 y(1.)46 b Fj(int)h │ │ │ │ │ -(Coords_readFromFile)c(\()k(Coords)f(*coords,)g(char)g(*filename)g(\))h │ │ │ │ │ -(;)227 1502 y Fk(This)25 b(metho)s(d)h(read)g(a)g Fj(Coords)e │ │ │ │ │ -Fk(ob)5 b(ject)27 b(from)f(a)g(\014le.)39 b(It)26 b(tries)h(to)f(op)s │ │ │ │ │ -(en)g(the)g(\014le)g(and)f(if)h(it)h(is)f(successful,)g(it)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)31 b Fc(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 227 399 a Fb(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +b(cking:)40 b Fk(If)29 b Fj(coords)g Fk(is)h Fj(NULL)p │ │ │ │ │ +Fk(,)f(or)h(if)g Fj(idim)f Fk(do)s(es)g(not)h(lie)h(in)f(the)g(range)g │ │ │ │ │ +Fj([1,ndim])p Fk(,)e(or)i(if)g Fj(icoor)227 511 y Fk(do)s(es)g(not)h │ │ │ │ │ +(lie)g(in)f(the)h(range)g Fj([0,ncoor\))p Fk(,)d(an)i(error)g(message)h │ │ │ │ │ +(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)0 790 │ │ │ │ │ +y Fd(1.2.4)112 b(IO)38 b(metho)s(ds)0 989 y Fk(There)29 │ │ │ │ │ +b(are)g(the)g(usual)g(eigh)m(t)i(IO)d(routines.)40 b(The)29 │ │ │ │ │ +b(\014le)g(structure)g(of)g(a)h Fj(Coords)d Fk(ob)5 b(ject)30 │ │ │ │ │ +b(is)f(simple:)40 b Fj(type)p Fk(,)29 b Fj(ndim)p Fk(,)0 │ │ │ │ │ +1102 y Fj(ncoor)g Fk(follo)m(w)m(ed)j(b)m(y)e(the)h Fj(coors[])d │ │ │ │ │ +Fk(v)m(ector.)111 1348 y(1.)46 b Fj(int)h(Coords_readFromFile)c(\()k │ │ │ │ │ +(Coords)f(*coords,)g(char)g(*filename)g(\))h(;)227 1502 │ │ │ │ │ +y Fk(This)25 b(metho)s(d)h(read)g(a)g Fj(Coords)e Fk(ob)5 │ │ │ │ │ +b(ject)27 b(from)f(a)g(\014le.)39 b(It)26 b(tries)h(to)f(op)s(en)g(the) │ │ │ │ │ +g(\014le)g(and)f(if)h(it)h(is)f(successful,)g(it)227 │ │ │ │ │ 1615 y(then)j(calls)h Fj(Coords)p 928 1615 29 4 v 33 │ │ │ │ │ w(readFromFormattedFile\(\))23 b Fk(or)29 b Fj(Coords)p │ │ │ │ │ 2486 1615 V 32 w(readFromBinaryFile\(\))p Fk(,)c(closes)30 │ │ │ │ │ b(the)227 1728 y(\014le)h(and)f(returns)f(the)h(v)-5 │ │ │ │ │ b(alue)31 b(returned)e(from)h(the)h(called)g(routine.)227 │ │ │ │ │ 1882 y Fb(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)29 │ │ │ │ │ b Fj(coords)f Fk(or)i Fj(filename)d Fk(is)j Fj(NULL)p │ │ │ │ │ @@ -4268,17 +4262,17 @@ │ │ │ │ │ 5253 y(data,)32 b(the)e(v)-5 b(alue)31 b Fj(1)f Fk(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fj(fwrite)p Fk(,)f(zero)i(is)g(returned.)227 5407 y Fb(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 b Fj(coords)f │ │ │ │ │ Fk(or)h Fj(fp)g Fk(are)h Fj(NULL)e Fk(an)h(error)g(message)i(is)e(prin) │ │ │ │ │ m(ted)g(and)g(zero)h(is)g(returned.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1086 4 v 1267 100 a Fj(Coords)29 │ │ │ │ │ -b Fc(:)41 b Fb(DRAFT)121 b Fc(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2767 100 V 1086 w Fk(5)111 399 y(7.)46 b Fj(int)h │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1105 4 v 1287 100 a Fj(Coords)28 │ │ │ │ │ +b Fc(:)41 b Fb(DRAFT)121 b Fc(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2748 100 V 1105 w Fk(5)111 399 y(7.)46 b Fj(int)h │ │ │ │ │ (Coords_writeForHumanEye)42 b(\()47 b(Coords)f(*coords,)g(FILE)g(*fp)h │ │ │ │ │ (\))h(;)227 554 y Fk(This)43 b(metho)s(d)g(write)h(the)g │ │ │ │ │ Fj(Coords)e Fk(ob)5 b(ject)45 b(to)f(a)g(\014le)g(in)g(an)f(easy)i(to)f │ │ │ │ │ (read)g(fashion.)80 b(The)43 b(metho)s(d)227 667 y Fj(Coords)p │ │ │ │ │ 521 667 29 4 v 33 w(writeStats\(\))24 b Fk(is)k(called)h(to)f(write)g │ │ │ │ │ (out)g(the)g(header)g(and)f(statistics.)42 b(The)27 b │ │ │ │ │ Fj(coors[])f Fk(v)m(ector)j(is)227 780 y(then)h(prin)m(ted)g(out.)41 │ │ │ │ │ @@ -4342,26 +4336,26 @@ │ │ │ │ │ 5181 y Fg(\210)45 b Fk(The)33 b Fj(msgFile)e Fk(parameter)j(determines) │ │ │ │ │ f(the)h(message)g(\014le)f(|)h(if)f Fj(msgFile)e Fk(is)i │ │ │ │ │ Fj(stdout)p Fk(,)g(then)g(the)427 5294 y(message)24 b(\014le)e(is)h │ │ │ │ │ Fb(stdout)p Fk(,)i(otherwise)e(a)f(\014le)h(is)f(op)s(ened)g(with)g │ │ │ │ │ Fb(app)-5 b(end)24 b Fk(status)f(to)g(receiv)m(e)h(an)m(y)f(message)427 │ │ │ │ │ 5407 y(data.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fk(6)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)30 b Fc(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 337 399 a Fg(\210)45 │ │ │ │ │ -b Fk(The)20 b Fj(outCoordsFile)d Fk(parameter)j(is)h(the)f(output)g │ │ │ │ │ -(\014le)g(for)h(the)f Fj(Coords)f Fk(ob)5 b(ject.)38 │ │ │ │ │ -b(If)20 b Fj(outCoordsFile)427 511 y Fk(is)h Fj(none)e │ │ │ │ │ -Fk(then)h(the)g Fj(Coords)f Fk(ob)5 b(ject)21 b(is)f(not)h(written)f │ │ │ │ │ -(to)h(a)g(\014le.)37 b(Otherwise,)22 b(the)f Fj(Coords)p │ │ │ │ │ -3409 511 29 4 v 33 w(writeToFile\(\))427 624 y Fk(metho)s(d)27 │ │ │ │ │ -b(is)h(called)h(to)f(write)g(the)g(ob)5 b(ject)29 b(to)f(a)g(formatted) │ │ │ │ │ -g(\014le)g(\(if)g Fj(outCoordsFile)c Fk(is)k(of)g(the)f(form)427 │ │ │ │ │ -737 y Fj(*.coordsf)p Fk(\),)i(or)h(a)h(binary)e(\014le)i(\(if)g │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fk(6)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)31 b Fc(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 337 399 a Fg(\210)45 b Fk(The)20 b │ │ │ │ │ +Fj(outCoordsFile)d Fk(parameter)j(is)h(the)f(output)g(\014le)g(for)h │ │ │ │ │ +(the)f Fj(Coords)f Fk(ob)5 b(ject.)38 b(If)20 b Fj(outCoordsFile)427 │ │ │ │ │ +511 y Fk(is)h Fj(none)e Fk(then)h(the)g Fj(Coords)f Fk(ob)5 │ │ │ │ │ +b(ject)21 b(is)f(not)h(written)f(to)h(a)g(\014le.)37 │ │ │ │ │ +b(Otherwise,)22 b(the)f Fj(Coords)p 3409 511 29 4 v 33 │ │ │ │ │ +w(writeToFile\(\))427 624 y Fk(metho)s(d)27 b(is)h(called)h(to)f(write) │ │ │ │ │ +g(the)g(ob)5 b(ject)29 b(to)f(a)g(formatted)g(\014le)g(\(if)g │ │ │ │ │ +Fj(outCoordsFile)c Fk(is)k(of)g(the)f(form)427 737 y │ │ │ │ │ +Fj(*.coordsf)p Fk(\),)i(or)h(a)h(binary)e(\014le)i(\(if)g │ │ │ │ │ Fj(outCoordsFile)26 b Fk(is)31 b(of)f(the)h(form)f Fj(*.coordsb)p │ │ │ │ │ Fk(\).)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ TeXDict begin 7 6 bop 0 866 a Fl(Index)0 1289 y Fj(Coords)p │ │ │ │ │ 294 1289 29 4 v 33 w(clearData\(\))p Fk(,)27 b(2)0 1402 │ │ │ │ │ y Fj(Coords)p 294 1402 V 33 w(free\(\))p Fk(,)i(2)0 1515 │ │ │ │ │ y Fj(Coords)p 294 1515 V 33 w(init\(\))p Fk(,)g(2)0 1628 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -18,15 +18,15 @@ │ │ │ │ │ │ 1.2 Prototypes and descriptions of Coords methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ Coords object. │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Coords : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Coords : DRAFT January 7, 2024 │ │ │ │ │ │ 1. Coords * Coords_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the Coords structure and then sets the default fields │ │ │ │ │ │ by a call to Coords setDefaultFields(). │ │ │ │ │ │ 2. void Coords_setDefaultFields ( Coords *coords ) ; │ │ │ │ │ │ This method sets the structure’s fields are set to default values: type = COORDS BY TUPLE, │ │ │ │ │ │ ndim = ncoor = 0 and coors = NULL. │ │ │ │ │ │ Error checking: If coords is NULL, an error message is printed and the program exits. │ │ │ │ │ │ @@ -54,15 +54,15 @@ │ │ │ │ │ │ point, bbox[2] = x-coordinate of the northeast point, and bbox[3] = y-coordinate of the │ │ │ │ │ │ northeast point. │ │ │ │ │ │ Error checking: If coordsbboxisNULL,oriftypeisnotCOORDS BY TUPLEorCOORDS BY COORD, │ │ │ │ │ │ or if any of n1, n2 or ncomp are nonpositive, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 3. void Coords_init27P ( Coords *coords, float bbox[], int type, │ │ │ │ │ │ int n1, int n2, int n3, int ncomp ) ; │ │ │ │ │ │ - Coords : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Coords : DRAFT January 7, 2024 3 │ │ │ │ │ │ This method initializes a Coords object for a 27-point operator on a n1 ×n2 ×n3 grid with │ │ │ │ │ │ ncomp degrees of freedom at a grid point. The grid’s location is given by the bounding │ │ │ │ │ │ box vector, bbox[0] = x-coordinate of the southwest point, bbox[1] = y-coordinate of the │ │ │ │ │ │ southwest point, bbox[2] = z-coordinate of the southwest point, bbox[3] = x-coordinate │ │ │ │ │ │ of the northeast point, bbox[4] = y-coordinate of the northeast point, and bbox[5] = z- │ │ │ │ │ │ coordinate of the northeast point. │ │ │ │ │ │ Error checking: If coordsbboxisNULL,oriftypeisnotCOORDS BY TUPLEorCOORDS BY COORD, │ │ │ │ │ │ @@ -94,15 +94,15 @@ │ │ │ │ │ │ does not lie in the range [0,ncoor), an error message is printed and the program exits. │ │ │ │ │ │ 5. void Coords_setValue ( Coords *coords, int idim, int icoor, float val ) ; │ │ │ │ │ │ Thismethodsetsthefloatvalueoftheidim-thcoordinateoftheicoor-thgridpoint. Forex- │ │ │ │ │ │ ample, Coords setValue(coords, 1, 27, 1.2) sets x =1.2, Coords setValue(coords, │ │ │ │ │ │ 27 │ │ │ │ │ │ 2, 16, 3.3) sets y =3.3, and Coords setValue(coords, 3, 118, 0) sets z =0. │ │ │ │ │ │ 16 118 │ │ │ │ │ │ - 4 Coords : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Coords : DRAFT January 7, 2024 │ │ │ │ │ │ Error checking: If coords is NULL, or if idim does not lie in the range [1,ndim], or if icoor │ │ │ │ │ │ does not lie in the range [0,ncoor), an error message is printed and the program exits. │ │ │ │ │ │ 1.2.4 IO methods │ │ │ │ │ │ There are the usual eight IO routines. The file structure of a Coords object is simple: type, ndim, │ │ │ │ │ │ ncoor followed by the coors[] vector. │ │ │ │ │ │ 1. int Coords_readFromFile ( Coords *coords, char *filename ) ; │ │ │ │ │ │ This method read a Coords object from a file. It tries to open the file and if it is successful, it │ │ │ │ │ │ @@ -129,15 +129,15 @@ │ │ │ │ │ │ This method writes a Coords object to a formatted file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fprintf, zero is returned. │ │ │ │ │ │ Error checking: If coords or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 6. int Coords_writeToBinaryFile ( Coords *coords, FILE *fp ) ; │ │ │ │ │ │ This method writes a Coords object to a binary file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fwrite, zero is returned. │ │ │ │ │ │ Error checking: If coords or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ - Coords : DRAFT February 8, 2025 5 │ │ │ │ │ │ + Coords : DRAFT January 7, 2024 5 │ │ │ │ │ │ 7. int Coords_writeForHumanEye ( Coords *coords, FILE *fp ) ; │ │ │ │ │ │ This method write the Coords object to a file in an easy to read fashion. The method │ │ │ │ │ │ Coords writeStats() is called to write out the header and statistics. The coors[] vector is │ │ │ │ │ │ then printed out. The value 1 is returned. │ │ │ │ │ │ Error checking: If coords or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 8. int Coords_writeStats ( Coords *coords, FILE *fp ) ; │ │ │ │ │ │ The header and statistics are written. The value 1 is returned. │ │ │ │ │ │ @@ -164,15 +164,15 @@ │ │ │ │ │ │ This driver program creates a Coords object for 9-point finite difference operator on a n1×n2 │ │ │ │ │ │ grid and optionally writes it to a file. │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ that all objects are written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any message │ │ │ │ │ │ data. │ │ │ │ │ │ - 6 Coords : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 Coords : DRAFT January 7, 2024 │ │ │ │ │ │ • TheoutCoordsFileparameteristheoutputfilefortheCoordsobject. IfoutCoordsFile │ │ │ │ │ │ is nonethentheCoordsobjectisnotwrittentoafile. Otherwise,theCoords writeToFile() │ │ │ │ │ │ method is called to write the object to a formatted file (if outCoordsFile is of the form │ │ │ │ │ │ *.coordsf), or a binary file (if outCoordsFile is of the form *.coordsb). │ │ │ │ │ │ Index │ │ │ │ │ │ Coords clearData(), 2 │ │ │ │ │ │ Coords free(), 2 │ │ │ ├── ./usr/share/doc/spooles-doc/DSTree.ps.gz │ │ │ │ ├── DSTree.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o DSTree.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1407,21 +1407,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1605,88 +1604,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3659,17 +3653,17 @@ │ │ │ │ │ {restore}if │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 154[40 40 100[{}2 90.9091 /CMSY10 rf /Fb 133[50 │ │ │ │ │ 59 4[44 44 46 2[56 62 93 31 2[31 62 56 1[51 62 50 1[54 │ │ │ │ │ 11[86 1[62 3[84 5[42 6[80 11[56 56 56 56 56 56 2[31 46[{}28 │ │ │ │ │ 99.6264 /CMBX12 rf /Fc 141[62 12[62 16[62 62 14[62 68[{}5 │ │ │ │ │ -119.552 /CMTT12 rf /Fd 134[48 3[51 2[36 12[40 2[51 45 │ │ │ │ │ -26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 90.9091 │ │ │ │ │ -/CMSL10 rf │ │ │ │ │ +119.552 /CMTT12 rf /Fd 134[48 3[51 2[36 3[51 12[45 22[47 │ │ │ │ │ +15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 │ │ │ │ │ +rf │ │ │ │ │ %DVIPSBitmapFont: Fe tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3786,56 +3780,55 @@ │ │ │ │ │ 5074 y Fe(\210)45 b Fi(Tree)i(*tree)29 b Fj(:)41 b(p)s(oin)m(ter)30 │ │ │ │ │ b(to)h(the)g Fi(Tree)e Fj(ob)5 b(ject)137 5294 y Fe(\210)45 │ │ │ │ │ b Fi(IV)i(*mapIV)d Fj(:)h(p)s(oin)m(ter)g(to)h(the)f │ │ │ │ │ Fi(IV)g Fj(ob)5 b(ject)46 b(that)g(holds)e(the)i(map)e(from)h(v)m │ │ │ │ │ (ertices)i(to)f(domains)f(and)227 5407 y(separators.)1927 │ │ │ │ │ 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 0 399 a Ff(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ -b(and)f(descriptions)g(of)g Fc(DSTree)d Ff(metho)t(ds)0 │ │ │ │ │ -636 y Fj(This)f(section)j(con)m(tains)f(brief)f(descriptions)g │ │ │ │ │ -(including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f(that)h(b)s │ │ │ │ │ -(elong)f(to)h(the)0 749 y Fi(DSTree)29 b Fj(ob)5 b(ject.)0 │ │ │ │ │ -1047 y Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 1253 y │ │ │ │ │ -Fj(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g(supp)s │ │ │ │ │ -(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f(\014elds,)h │ │ │ │ │ -(clearing)0 1366 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h │ │ │ │ │ -(the)g(ob)5 b(ject.)111 1629 y(1.)46 b Fi(DSTree)g(*)i(DSTree_new)d(\() │ │ │ │ │ -i(void)g(\))g(;)227 1789 y Fj(This)27 b(metho)s(d)f(allo)s(cates)k │ │ │ │ │ -(storage)e(for)f(an)g(instance)h(of)f(the)g Fi(DSTree)f │ │ │ │ │ -Fj(ob)5 b(ject.)40 b(The)27 b(default)g(\014elds)g(are)g(set)227 │ │ │ │ │ -1902 y(b)m(y)k(a)f(call)i(to)f Fi(DSTree)p 1001 1902 │ │ │ │ │ -29 4 v 33 w(setDefaultFields\(\))p Fj(.)111 2110 y(2.)46 │ │ │ │ │ -b Fi(void)h(DSTree_setDefaultFields)41 b(\()48 b(DSTree)e(*dstree)g(\)) │ │ │ │ │ -h(;)227 2271 y Fj(This)30 b(metho)s(d)g(sets)g(the)h(data)g(\014elds)f │ │ │ │ │ -(to)h(default)g(v)-5 b(alues:)41 b Fi(tree)29 b Fj(and)h │ │ │ │ │ -Fi(mapIV)f Fj(are)h(set)h(to)g Fi(NULL)f Fj(;)227 2431 │ │ │ │ │ -y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b │ │ │ │ │ -Fi(dstree)f Fj(is)h Fi(NULL)p Fj(,)g(an)g(error)g(message)i(is)e(prin)m │ │ │ │ │ -(ted)g(and)g(the)g(program)g(exits.)111 2639 y(3.)46 │ │ │ │ │ -b Fi(void)h(DSTree_clearData)c(\()48 b(DSTree)e(*dstree)g(\))h(;)227 │ │ │ │ │ -2800 y Fj(This)27 b(metho)s(d)g(clears)i(the)f(data)g(\014elds,)g │ │ │ │ │ -(free'ing)g(storage)h(that)g(has)e(b)s(een)g(allo)s(cated)j(b)m(y)d │ │ │ │ │ -(the)h(ob)5 b(ject)29 b(and)227 2912 y(free'ing)39 b(ob)5 │ │ │ │ │ -b(jects)39 b(that)f(it)h(o)m(wns.)63 b(This)37 b(metho)s(d)h(c)m(hec)m │ │ │ │ │ -(ks)h(to)g(see)g(whether)e Fi(dstree)f Fj(is)i Fi(NULL)p │ │ │ │ │ -Fj(.)g(If)f Fi(tree)227 3025 y Fj(is)c(not)g Fi(NULL)p │ │ │ │ │ -Fj(,)f(then)g Fi(Tree)p 1141 3025 V 33 w(free\(tree\))e │ │ │ │ │ -Fj(is)j(called.)48 b(If)33 b Fi(mapIV)e Fj(is)i(not)f │ │ │ │ │ -Fi(NULL)p Fj(,)g(then)h Fi(IV)p 3254 3025 V 33 w(free\(mapIV\))d │ │ │ │ │ -Fj(is)227 3138 y(called.)42 b(Then)29 b(the)h(structure's)g(default)g │ │ │ │ │ -(\014elds)f(are)i(set)f(via)h(a)f(call)h(to)g Fi(DSTree)p │ │ │ │ │ -2989 3138 V 33 w(setDefaultFields\(\))p Fj(.)227 3299 │ │ │ │ │ -y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b │ │ │ │ │ -Fi(dstree)f Fj(is)h Fi(NULL)p Fj(,)g(an)g(error)g(message)i(is)e(prin)m │ │ │ │ │ -(ted)g(and)g(the)g(program)g(exits.)111 3507 y(4.)46 │ │ │ │ │ -b Fi(void)h(DSTree_free)e(\()i(DSTree)f(*dstree)g(\))h(;)227 │ │ │ │ │ -3667 y Fj(This)37 b(metho)s(d)f(c)m(hec)m(ks)j(to)f(see)g(whether)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 0 399 a Ff(1.2)135 b(Protot)l(yp)t(es)46 b(and)f │ │ │ │ │ +(descriptions)g(of)g Fc(DSTree)d Ff(metho)t(ds)0 636 │ │ │ │ │ +y Fj(This)f(section)j(con)m(tains)f(brief)f(descriptions)g(including)f │ │ │ │ │ +(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f(that)h(b)s(elong)f(to)h │ │ │ │ │ +(the)0 749 y Fi(DSTree)29 b Fj(ob)5 b(ject.)0 1047 y │ │ │ │ │ +Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 1253 y Fj(As)d(usual,)h(there)f │ │ │ │ │ +(are)g(four)f(basic)h(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 │ │ │ │ │ +b(ject)36 b(creation,)i(setting)e(default)f(\014elds,)h(clearing)0 │ │ │ │ │ +1366 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h(the)g(ob)5 │ │ │ │ │ +b(ject.)111 1629 y(1.)46 b Fi(DSTree)g(*)i(DSTree_new)d(\()i(void)g(\)) │ │ │ │ │ +g(;)227 1789 y Fj(This)27 b(metho)s(d)f(allo)s(cates)k(storage)e(for)f │ │ │ │ │ +(an)g(instance)h(of)f(the)g Fi(DSTree)f Fj(ob)5 b(ject.)40 │ │ │ │ │ +b(The)27 b(default)g(\014elds)g(are)g(set)227 1902 y(b)m(y)k(a)f(call)i │ │ │ │ │ +(to)f Fi(DSTree)p 1001 1902 29 4 v 33 w(setDefaultFields\(\))p │ │ │ │ │ +Fj(.)111 2110 y(2.)46 b Fi(void)h(DSTree_setDefaultFields)41 │ │ │ │ │ +b(\()48 b(DSTree)e(*dstree)g(\))h(;)227 2271 y Fj(This)30 │ │ │ │ │ +b(metho)s(d)g(sets)g(the)h(data)g(\014elds)f(to)h(default)g(v)-5 │ │ │ │ │ +b(alues:)41 b Fi(tree)29 b Fj(and)h Fi(mapIV)f Fj(are)h(set)h(to)g │ │ │ │ │ +Fi(NULL)f Fj(;)227 2431 y Fh(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +b(cking:)40 b Fj(If)30 b Fi(dstree)f Fj(is)h Fi(NULL)p │ │ │ │ │ +Fj(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g(the)g(program)g │ │ │ │ │ +(exits.)111 2639 y(3.)46 b Fi(void)h(DSTree_clearData)c(\()48 │ │ │ │ │ +b(DSTree)e(*dstree)g(\))h(;)227 2800 y Fj(This)27 b(metho)s(d)g(clears) │ │ │ │ │ +i(the)f(data)g(\014elds,)g(free'ing)g(storage)h(that)g(has)e(b)s(een)g │ │ │ │ │ +(allo)s(cated)j(b)m(y)d(the)h(ob)5 b(ject)29 b(and)227 │ │ │ │ │ +2912 y(free'ing)39 b(ob)5 b(jects)39 b(that)f(it)h(o)m(wns.)63 │ │ │ │ │ +b(This)37 b(metho)s(d)h(c)m(hec)m(ks)h(to)g(see)g(whether)e │ │ │ │ │ +Fi(dstree)f Fj(is)i Fi(NULL)p Fj(.)g(If)f Fi(tree)227 │ │ │ │ │ +3025 y Fj(is)c(not)g Fi(NULL)p Fj(,)f(then)g Fi(Tree)p │ │ │ │ │ +1141 3025 V 33 w(free\(tree\))e Fj(is)j(called.)48 b(If)33 │ │ │ │ │ +b Fi(mapIV)e Fj(is)i(not)f Fi(NULL)p Fj(,)g(then)h Fi(IV)p │ │ │ │ │ +3254 3025 V 33 w(free\(mapIV\))d Fj(is)227 3138 y(called.)42 │ │ │ │ │ +b(Then)29 b(the)h(structure's)g(default)g(\014elds)f(are)i(set)f(via)h │ │ │ │ │ +(a)f(call)h(to)g Fi(DSTree)p 2989 3138 V 33 w(setDefaultFields\(\))p │ │ │ │ │ +Fj(.)227 3299 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fj(If)30 b Fi(dstree)f Fj(is)h Fi(NULL)p Fj(,)g(an)g(error)g(message) │ │ │ │ │ +i(is)e(prin)m(ted)g(and)g(the)g(program)g(exits.)111 │ │ │ │ │ +3507 y(4.)46 b Fi(void)h(DSTree_free)e(\()i(DSTree)f(*dstree)g(\))h(;) │ │ │ │ │ +227 3667 y Fj(This)37 b(metho)s(d)f(c)m(hec)m(ks)j(to)f(see)g(whether)f │ │ │ │ │ Fi(dstree)e Fj(is)i Fi(NULL)p Fj(.)g(If)g(so,)i(an)e(error)g(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)227 3780 y(the)31 b(program)g(exits.)43 │ │ │ │ │ b(Otherwise,)31 b(it)g(releases)h(an)m(y)g(storage)g(b)m(y)f(a)g(call)h │ │ │ │ │ (to)g Fi(DSTree)p 3141 3780 V 32 w(clearData\(\))c Fj(then)227 │ │ │ │ │ 3893 y(free's)j(the)f(storage)i(for)e(the)h(structure)f(with)g(a)h │ │ │ │ │ (call)g(to)h Fi(free\(\))p Fj(.)227 4053 y Fh(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b Fi(dstree)f │ │ │ │ │ @@ -3851,17 +3844,17 @@ │ │ │ │ │ 5247 y Fj(This)27 b(metho)s(d)f(returns)g(a)h(p)s(oin)m(ter)g(to)h(its) │ │ │ │ │ g Fi(IV)e Fj(ob)5 b(ject)28 b(that)g(maps)e(v)m(ertices)j(to)f(domains) │ │ │ │ │ f(and)f(separators.)227 5407 y Fh(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fj(If)30 b Fi(dstree)f Fj(is)h Fi(NULL)p │ │ │ │ │ Fj(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g(the)g(program)g │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1134 4 v 1315 100 a Fi(Tree)29 │ │ │ │ │ -b Fd(:)41 b Fh(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fj(3)0 399 y Fb(1.2.3)112 b(Initializer)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1153 4 v 1334 100 a Fi(Tree)29 │ │ │ │ │ +b Fd(:)41 b Fh(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fj(3)0 399 y Fb(1.2.3)112 b(Initializer)38 │ │ │ │ │ b(metho)s(ds)0 602 y Fj(There)c(are)h(three)f(initializers)j(and)d(t)m │ │ │ │ │ (w)m(o)h(help)s(er)f(functions)g(to)h(set)g(the)g(dimensions)e(of)i │ │ │ │ │ (the)g(dstree,)g(allo)s(cate)0 715 y(the)c(three)f(v)m(ectors,)i(and)e │ │ │ │ │ (\014ll)g(the)h(information.)111 969 y(1.)46 b Fi(void)h(DSTree_init1)d │ │ │ │ │ (\()k(DSTree)e(*dstree,)f(int)i(ndomsep,)f(int)h(nvtx)f(\))i(;)227 │ │ │ │ │ 1126 y Fj(This)28 b(metho)s(d)f(initializes)k(an)d(ob)5 │ │ │ │ │ b(ject)29 b(giv)m(en)g(the)f(n)m(um)m(b)s(er)f(of)h(v)m(ertices,)j │ │ │ │ │ @@ -3929,32 +3922,32 @@ │ │ │ │ │ (k,)f(its)f(stage)i(is)f Fa(d)p Fg(k)s(=)p Fj(2)p Fa(e)p │ │ │ │ │ Fj(.)227 5294 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)41 │ │ │ │ │ b Fj(If)29 b Fi(dstree)g Fj(is)i Fi(NULL)p Fj(,)e(or)h(if)h(the)f(ob)5 │ │ │ │ │ b(ject)32 b(has)e(not)g(b)s(een)g(initialized,)j(an)d(error)g(message) │ │ │ │ │ 227 5407 y(is)h(prin)m(ted)f(and)f(the)i(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 111 399 a Fj(3.)46 b Fi(IV)h(*)h │ │ │ │ │ -(DSTree_MS2stages)43 b(\()48 b(DSTree)e(*dstree)g(\))95 │ │ │ │ │ -b(;)227 553 y Fj(This)40 b(metho)s(d)g(returns)f(the)i(stages)h(for)e │ │ │ │ │ -(the)h(standard)f(m)m(ultisection)i(ordering.)71 b(The)40 │ │ │ │ │ -b(lev)m(els)i(of)f(the)227 666 y(domains)34 b(and)f(separators)h(are)g │ │ │ │ │ -(obtained)g(via)g(a)g(call)h(to)g Fi(Tree)p 2455 666 │ │ │ │ │ -29 4 v 33 w(setHeightImetric\(\))p Fj(.)45 b(A)34 b Fi(stagesIV)227 │ │ │ │ │ -779 y(IV)40 b Fj(ob)5 b(ject)41 b(is)f(created)h(of)f(size)h │ │ │ │ │ -Fi(nvtx)47 b(=)g(mapIV->size)p Fj(,)40 b(\014lled)g(and)f(then)h │ │ │ │ │ -(returned.)69 b(If)39 b(a)i(v)m(ertex)g(is)227 892 y(found)29 │ │ │ │ │ -b(in)h(a)h(domain,)g(its)f(stage)i(is)f(zero.)41 b(If)30 │ │ │ │ │ -b(a)h(v)m(ertex)g(is)g(found)e(in)h(a)h(separator,)g(its)g(stage)g(is)g │ │ │ │ │ -(one.)227 1046 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)41 │ │ │ │ │ -b Fj(If)29 b Fi(dstree)g Fj(is)i Fi(NULL)p Fj(,)e(or)h(if)h(the)f(ob)5 │ │ │ │ │ -b(ject)32 b(has)e(not)g(b)s(een)g(initialized,)j(an)d(error)g(message) │ │ │ │ │ -227 1159 y(is)h(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 111 399 a Fj(3.)46 b Fi(IV)h(*)h(DSTree_MS2stages)43 │ │ │ │ │ +b(\()48 b(DSTree)e(*dstree)g(\))95 b(;)227 553 y Fj(This)40 │ │ │ │ │ +b(metho)s(d)g(returns)f(the)i(stages)h(for)e(the)h(standard)f(m)m │ │ │ │ │ +(ultisection)i(ordering.)71 b(The)40 b(lev)m(els)i(of)f(the)227 │ │ │ │ │ +666 y(domains)34 b(and)f(separators)h(are)g(obtained)g(via)g(a)g(call)h │ │ │ │ │ +(to)g Fi(Tree)p 2455 666 29 4 v 33 w(setHeightImetric\(\))p │ │ │ │ │ +Fj(.)45 b(A)34 b Fi(stagesIV)227 779 y(IV)40 b Fj(ob)5 │ │ │ │ │ +b(ject)41 b(is)f(created)h(of)f(size)h Fi(nvtx)47 b(=)g(mapIV->size)p │ │ │ │ │ +Fj(,)40 b(\014lled)g(and)f(then)h(returned.)69 b(If)39 │ │ │ │ │ +b(a)i(v)m(ertex)g(is)227 892 y(found)29 b(in)h(a)h(domain,)g(its)f │ │ │ │ │ +(stage)i(is)f(zero.)41 b(If)30 b(a)h(v)m(ertex)g(is)g(found)e(in)h(a)h │ │ │ │ │ +(separator,)g(its)g(stage)g(is)g(one.)227 1046 y Fh(Err)-5 │ │ │ │ │ +b(or)34 b(che)-5 b(cking:)41 b Fj(If)29 b Fi(dstree)g │ │ │ │ │ +Fj(is)i Fi(NULL)p Fj(,)e(or)h(if)h(the)f(ob)5 b(ject)32 │ │ │ │ │ +b(has)e(not)g(b)s(een)g(initialized,)j(an)d(error)g(message)227 │ │ │ │ │ +1159 y(is)h(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ 1355 y(4.)46 b Fi(IV)h(*)h(DSTree_MS3stages)43 b(\()48 │ │ │ │ │ b(DSTree)e(*dstree)g(\))95 b(;)227 1510 y Fj(This)35 │ │ │ │ │ b(metho)s(d)h(returns)e(the)i(stages)h(for)f(a)g(three-stage)i(v)-5 │ │ │ │ │ b(arian)m(t)37 b(of)f(the)g(m)m(ultisection)i(ordering.)56 │ │ │ │ │ b(The)227 1623 y(lev)m(els)37 b(of)f(the)f(domains)h(and)e(separators)i │ │ │ │ │ (are)g(obtained)g(via)g(a)g(call)g(to)g Fi(Tree)p 2988 │ │ │ │ │ 1623 V 34 w(setHeightImetric\(\))p Fj(.)227 1736 y(A)c │ │ │ │ │ @@ -4010,17 +4003,17 @@ │ │ │ │ │ (in)h(the)f(tree)h(via)g(a)g(p)s(ost-order)f(tra)m(v)m(ersal.)227 │ │ │ │ │ 5294 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)41 b Fj(If)29 │ │ │ │ │ b Fi(dstree)g Fj(is)i Fi(NULL)p Fj(,)e(or)h(if)h(the)f(ob)5 │ │ │ │ │ b(ject)32 b(has)e(not)g(b)s(een)g(initialized,)j(an)d(error)g(message) │ │ │ │ │ 227 5407 y(is)h(prin)m(ted)f(and)f(the)i(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1134 4 v 1315 100 a Fi(Tree)29 │ │ │ │ │ -b Fd(:)41 b Fh(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fj(5)111 399 y(3.)46 b Fi(int)h(DSTree_domainWeight)c │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1153 4 v 1334 100 a Fi(Tree)29 │ │ │ │ │ +b Fd(:)41 b Fh(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fj(5)111 399 y(3.)46 b Fi(int)h(DSTree_domainWeight)c │ │ │ │ │ (\()k(DSTree)f(*dstree,)g(int)h(vwghts[])e(\))j(;)227 │ │ │ │ │ 560 y Fj(This)25 b(metho)s(d)g(returns)g(the)h(w)m(eigh)m(t)h(of)f(the) │ │ │ │ │ g(v)m(ertices)h(in)f(the)g(domains.)38 b(If)26 b Fi(vwghts)e │ │ │ │ │ Fj(is)i Fi(NULL)p Fj(,)e(the)i(v)m(ertices)227 673 y(ha)m(v)m(e)32 │ │ │ │ │ b(unit)e(w)m(eigh)m(t.)227 834 y Fh(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fj(If)30 b Fi(dstree)f Fj(is)h Fi(NULL)p │ │ │ │ │ Fj(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g(the)g(program)g │ │ │ │ │ @@ -4087,21 +4080,21 @@ │ │ │ │ │ b Fi(dstree)e Fj(or)h Fi(fn)g Fj(are)i Fi(NULL)p Fj(,)d(or)i(if)g │ │ │ │ │ Fi(fn)f Fj(is)h(not)g(of)f(the)h(form)g Fi(*.dstreef)d │ │ │ │ │ Fj(\(for)j(a)227 5294 y(formatted)32 b(\014le\))g(or)f │ │ │ │ │ Fi(*.dstreeb)e Fj(\(for)j(a)f(binary)g(\014le\),)h(an)f(error)g │ │ │ │ │ (message)i(is)e(prin)m(ted)g(and)g(the)g(metho)s(d)227 │ │ │ │ │ 5407 y(returns)e(zero.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fj(6)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 111 399 a Fj(5.)46 b Fi(int)h │ │ │ │ │ -(DSTree_writeToFormattedFi)o(le)42 b(\()47 b(DSTree)f(*dstree,)g(FILE)g │ │ │ │ │ -(*fp)h(\))h(;)227 548 y Fj(This)30 b(metho)s(d)g(writes)g(a)h │ │ │ │ │ -Fi(DSTree)e Fj(ob)5 b(ject)31 b(to)g(a)g(formatted)g(\014le.)41 │ │ │ │ │ -b(If)30 b(there)h(are)g(no)f(errors)g(in)g(writing)h(the)227 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fj(6)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 111 399 a Fj(5.)46 b Fi(int)h(DSTree_writeToFormattedFi)o │ │ │ │ │ +(le)42 b(\()47 b(DSTree)f(*dstree,)g(FILE)g(*fp)h(\))h(;)227 │ │ │ │ │ +548 y Fj(This)30 b(metho)s(d)g(writes)g(a)h Fi(DSTree)e │ │ │ │ │ +Fj(ob)5 b(ject)31 b(to)g(a)g(formatted)g(\014le.)41 b(If)30 │ │ │ │ │ +b(there)h(are)g(no)f(errors)g(in)g(writing)h(the)227 │ │ │ │ │ 661 y(data,)h(the)e(v)-5 b(alue)31 b Fi(1)f Fj(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fi(fprintf)p Fj(,)f(zero)i(is)f(returned.)227 810 y Fh(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b Fi(dstree)f │ │ │ │ │ Fj(or)h Fi(fp)g Fj(is)h Fi(NULL)p Fj(,)e(an)h(error)g(message)i(is)e │ │ │ │ │ (prin)m(ted)g(and)g(zero)h(is)f(returned.)111 996 y(6.)46 │ │ │ │ │ b Fi(int)h(DSTree_writeToBinaryFile)41 b(\()48 b(DSTree)e(*dstree,)f │ │ │ │ │ @@ -4171,17 +4164,17 @@ │ │ │ │ │ 5181 V 33 w(writeToFile\(\))17 b Fj(metho)s(d)427 5294 │ │ │ │ │ y(is)31 b(called)h(to)f(write)g(the)g(ob)5 b(ject)32 │ │ │ │ │ b(to)f(a)g(formatted)h(\014le)f(\(if)g Fi(outFile)d Fj(is)j(of)g(the)g │ │ │ │ │ (form)f Fi(*.dinpmtxf)p Fj(\),)427 5407 y(or)h(a)f(binary)g(\014le)g │ │ │ │ │ (\(if)h Fi(outFile)e Fj(is)h(of)g(the)h(form)f Fi(*.dinpmtxb)p │ │ │ │ │ Fj(\).)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1134 4 v 1315 100 a Fi(Tree)29 │ │ │ │ │ -b Fd(:)41 b Fh(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fj(7)111 399 y(2.)46 b Fi(writeStagesIV)e(msglvl)j │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1153 4 v 1334 100 a Fi(Tree)29 │ │ │ │ │ +b Fd(:)41 b Fh(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fj(7)111 399 y(2.)46 b Fi(writeStagesIV)e(msglvl)j │ │ │ │ │ (msgFile)e(inFile)h(type)h(outFile)227 544 y Fj(This)28 │ │ │ │ │ b(driv)m(er)h(program)g(reads)f(in)h(a)g Fi(DSTree)e │ │ │ │ │ Fj(from)h(a)i(\014le,)f(creates)h(a)g(stages)g Fi(IV)e │ │ │ │ │ Fj(ob)5 b(ject)30 b(and)e(writes)h(it)g(to)227 657 y(a)i(\014le.)337 │ │ │ │ │ 855 y Fe(\210)45 b Fj(The)28 b Fi(msglvl)f Fj(parameter)i(determines)g │ │ │ │ │ (the)g(amoun)m(t)g(of)f(output)h(|)f(taking)i Fi(msglvl)46 │ │ │ │ │ b(>=)h(3)28 b Fj(means)427 968 y(the)j Fi(DSTree)e Fj(ob)5 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -21,15 +21,15 @@ │ │ │ │ │ │ The DSTree object has a very simple data structure. It contains a Tree object to represent the │ │ │ │ │ │ tree fields of the domains and separators, and an IV object to hold the map from the vertices to │ │ │ │ │ │ the domains and separators. │ │ │ │ │ │ • Tree *tree : pointer to the Tree object │ │ │ │ │ │ • IV *mapIV : pointer to the IV object that holds the map from vertices to domains and │ │ │ │ │ │ separators. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Tree : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Tree : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2 Prototypes and descriptions of DSTree methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ DSTree object. │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. DSTree * DSTree_new ( void ) ; │ │ │ │ │ │ @@ -52,15 +52,15 @@ │ │ │ │ │ │ 1.2.2 Instance methods │ │ │ │ │ │ 1. Tree * DSTree_tree ( DSTree *dstree ) ; │ │ │ │ │ │ This method returns a pointer to its Tree object. │ │ │ │ │ │ Error checking: If dstree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. IV * DSTree_mapIV ( DSTree *dstree ) ; │ │ │ │ │ │ This method returns a pointer to its IV object that maps vertices to domains and separators. │ │ │ │ │ │ Error checking: If dstree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - Tree : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Tree : DRAFT January 7, 2024 3 │ │ │ │ │ │ 1.2.3 Initializer methods │ │ │ │ │ │ There are three initializers and two helper functions to set the dimensions of the dstree, allocate │ │ │ │ │ │ the three vectors, and fill the information. │ │ │ │ │ │ 1. void DSTree_init1 ( DSTree *dstree, int ndomsep, int nvtx ) ; │ │ │ │ │ │ This method initializes an object given the number of vertices, (the dimension of mapIV) and │ │ │ │ │ │ domains and separators (the number of nodes in tree). It then clears any previous data │ │ │ │ │ │ with a call to DSTree clearData(). The tree field is created and initialized via a call to │ │ │ │ │ │ @@ -88,15 +88,15 @@ │ │ │ │ │ │ This method returns the stages for a nested dissection variant, separators on two adjacent │ │ │ │ │ │ levels are put into the same stage. The levels of the domains and separators are obtained │ │ │ │ │ │ via a call to Tree setHeightImetric(). A stagesIV IV object is created of size nvtx = │ │ │ │ │ │ mapIV->size, filled and then returned. If a vertex is found in a domain, its stage is zero. If │ │ │ │ │ │ a vertex is found in a separator at level k, its stage is ⌈k/2⌉. │ │ │ │ │ │ Error checking: If dstree is NULL, or if the object has not been initialized, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ - 4 Tree : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Tree : DRAFT January 7, 2024 │ │ │ │ │ │ 3. IV * DSTree_MS2stages ( DSTree *dstree ) ; │ │ │ │ │ │ This method returns the stages for the standard multisection ordering. The levels of the │ │ │ │ │ │ domains and separators are obtained via a call to Tree setHeightImetric(). A stagesIV │ │ │ │ │ │ IV object is created of size nvtx = mapIV->size, filled and then returned. If a vertex is │ │ │ │ │ │ found in a domain, its stage is zero. If a vertex is found in a separator, its stage is one. │ │ │ │ │ │ Error checking: If dstree is NULL, or if the object has not been initialized, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ @@ -125,15 +125,15 @@ │ │ │ │ │ │ If dstree is NULL, an error message is printed and the program exits. Otherwise, the number │ │ │ │ │ │ of bytes taken by this object is returned. │ │ │ │ │ │ Error checking: If dstree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. void DSTree_renumberViaPostOT ( DSTree *dstree ) ; │ │ │ │ │ │ This method renumbers the fronts in the tree via a post-order traversal. │ │ │ │ │ │ Error checking: If dstree is NULL, or if the object has not been initialized, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ - Tree : DRAFT February 8, 2025 5 │ │ │ │ │ │ + Tree : DRAFT January 7, 2024 5 │ │ │ │ │ │ 3. int DSTree_domainWeight ( DSTree *dstree, int vwghts[] ) ; │ │ │ │ │ │ This method returns the weight of the vertices in the domains. If vwghts is NULL, the vertices │ │ │ │ │ │ have unit weight. │ │ │ │ │ │ Error checking: If dstree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. int DSTree_separatorWeight ( DSTree *dstree, int vwghts[] ) ; │ │ │ │ │ │ This method returns the weight of the vertices in the separators. If vwghts is NULL, the │ │ │ │ │ │ vertices have unit weight. │ │ │ │ │ │ @@ -159,15 +159,15 @@ │ │ │ │ │ │ 4. int DSTree_writeToFile ( DSTree *dstree, char *fn ) ; │ │ │ │ │ │ This method writes a DSTree object to a file. It tries to open the file and if it is successful, │ │ │ │ │ │ it then calls DSTree writeFromFormattedFile()or DSTree writeFromBinaryFile(),closes │ │ │ │ │ │ the file and returns the value returned from the called routine. │ │ │ │ │ │ Error checking: If dstree or fn are NULL, or if fn is not of the form *.dstreef (for a │ │ │ │ │ │ formatted file) or *.dstreeb (for a binary file), an error message is printed and the method │ │ │ │ │ │ returns zero. │ │ │ │ │ │ - 6 Tree : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 Tree : DRAFT January 7, 2024 │ │ │ │ │ │ 5. int DSTree_writeToFormattedFile ( DSTree *dstree, FILE *fp ) ; │ │ │ │ │ │ This method writes a DSTree object to a formatted file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fprintf, zero is returned. │ │ │ │ │ │ Error checking: If dstree or fp is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 6. int DSTree_writeToBinaryFile ( DSTree *dstree, FILE *fp ) ; │ │ │ │ │ │ This method writes a DSTree object to a binary file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fwrite, zero is returned. │ │ │ │ │ │ @@ -195,15 +195,15 @@ │ │ │ │ │ │ • The inFile parameter is the input file for the DSTree object. It must be of the │ │ │ │ │ │ form *.dinpmtxf or *.dinpmtxb. The DSTree object is read from the file via the │ │ │ │ │ │ DSTree readFromFile() method. │ │ │ │ │ │ • The outFileparameter is the output file for the DSTree object. If outFile is none then │ │ │ │ │ │ the DSTreeobject is not written to a file. Otherwise, the DSTree writeToFile()method │ │ │ │ │ │ is called to write the object to a formatted file (if outFile is of the form *.dinpmtxf), │ │ │ │ │ │ or a binary file (if outFile is of the form *.dinpmtxb). │ │ │ │ │ │ - Tree : DRAFT February 8, 2025 7 │ │ │ │ │ │ + Tree : DRAFT January 7, 2024 7 │ │ │ │ │ │ 2. writeStagesIV msglvl msgFile inFile type outFile │ │ │ │ │ │ This driver program reads in a DSTree from a file, creates a stages IV object and writes it to │ │ │ │ │ │ a file. │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the DSTree object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ ├── ./usr/share/doc/spooles-doc/DV.ps.gz │ │ │ │ ├── DV.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o DV.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2351,21 +2351,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2549,88 +2548,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4204,19 +4198,19 @@ │ │ │ │ │ /Fb 235[71 20[{}1 90.9091 /CMSY10 rf /Fc 206[35 35 48[{}2 │ │ │ │ │ 66.4176 /CMR8 rf /Fd 133[50 59 4[44 44 46 2[56 62 93 │ │ │ │ │ 31 2[31 62 2[51 62 50 1[54 11[86 5[84 5[42 6[80 12[56 │ │ │ │ │ 56 56 56 56 2[31 46[{}25 99.6264 /CMBX12 rf /Fe 139[62 │ │ │ │ │ 4[62 4[62 4[62 1[62 62 11[62 17[62 68[{}8 119.552 /CMTT12 │ │ │ │ │ rf /Ff 138[49 30 37 38 1[46 46 51 74 23 42 1[28 46 42 │ │ │ │ │ 1[42 46 42 42 46 12[65 1[66 11[59 62 69 2[68 6[28 58[{}25 │ │ │ │ │ -90.9091 /CMTI10 rf /Fg 134[48 3[51 2[36 12[40 2[51 45 │ │ │ │ │ -26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 90.9091 │ │ │ │ │ -/CMSL10 rf /Fh 134[71 2[71 75 52 53 55 1[75 67 75 112 │ │ │ │ │ -3[37 75 67 41 61 75 60 1[65 13[75 2[92 11[103 16[67 67 │ │ │ │ │ -67 2[37 46[{}25 119.552 /CMBX12 rf │ │ │ │ │ +90.9091 /CMTI10 rf /Fg 134[48 3[51 2[36 3[51 12[45 22[47 │ │ │ │ │ +15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 │ │ │ │ │ +rf /Fh 134[71 2[71 75 52 53 55 1[75 67 75 112 3[37 75 │ │ │ │ │ +67 41 61 75 60 1[65 13[75 2[92 11[103 16[67 67 67 2[37 │ │ │ │ │ +46[{}25 119.552 /CMBX12 rf │ │ │ │ │ %DVIPSBitmapFont: Fi tcrm1095 10.95 2 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -4331,17 +4325,17 @@ │ │ │ │ │ Fk(DV)g Fl(ob)5 b(ject.)41 b(On)29 b(the)g(other)h(hand,)e(the)i(con)m │ │ │ │ │ (v)m(enience)0 4684 y(mak)m(es)h(it)g(a)g(widely)f(used)g(ob)5 │ │ │ │ │ b(ject.)0 4989 y Fh(1.1)135 b(Data)46 b(Structure)0 5214 │ │ │ │ │ y Fl(The)30 b Fk(DV)g Fl(structure)g(has)g(three)g(\014elds.)137 │ │ │ │ │ 5407 y Fi(\210)45 b Fk(int)i(size)29 b Fl(:)41 b(presen)m(t)30 │ │ │ │ │ b(size)i(of)e(the)h(v)m(ector.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fl(2)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fk(DV)30 b Fg(:)h Ff(DRAFT)f Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 137 399 a Fi(\210)45 b Fk(int)i(maxsize)29 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fl(2)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 137 399 a Fi(\210)45 b Fk(int)i(maxsize)29 │ │ │ │ │ b Fl(:)40 b(maxim)m(um)30 b(size)i(of)e(the)h(v)m(ector.)137 │ │ │ │ │ 608 y Fi(\210)45 b Fk(int)i(owned)27 b Fl(:)40 b(o)m(wner)28 │ │ │ │ │ b(\015ag)h(for)f(the)h(data.)41 b(When)28 b Fk(owned)46 │ │ │ │ │ b(=)i(1)p Fl(,)28 b(storage)i(for)f Fk(owned)e(double)p │ │ │ │ │ Fl('s)f(has)j(b)s(een)227 721 y(allo)s(cated)k(b)m(y)d(this)h(ob)5 │ │ │ │ │ b(ject)31 b(and)f(can)h(b)s(e)f(free'd)g(b)m(y)h(the)f(ob)5 │ │ │ │ │ b(ject.)42 b(When)31 b Fk(owned)46 b(==)h(0)30 b Fl(but)g │ │ │ │ │ @@ -4395,17 +4389,17 @@ │ │ │ │ │ (storage)i(b)m(y)d(a)i(call)g(to)f Fk(DV)p 2148 5133 │ │ │ │ │ V 34 w(clearData\(\))d Fl(then)i(free's)h(the)g(storage)h(for)f(the)227 │ │ │ │ │ 5246 y(structure)h(with)g(a)h(call)h(to)f Fk(free\(\))p │ │ │ │ │ Fl(.)227 5407 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fl(If)30 b Fk(dv)g Fl(is)h Fk(NULL)e Fl(an)h(error)g(message)h(is)g │ │ │ │ │ (prin)m(ted)f(and)g(the)g(program)g(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1187 4 v 1368 100 a Fk(DV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fl(3)0 399 y Fd(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1206 4 v 1387 100 a Fk(DV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fl(3)0 399 y Fd(1.2.2)112 b(Instance)38 │ │ │ │ │ b(metho)s(ds)0 610 y Fl(These)33 b(metho)s(d)f(allo)m(w)j(access)g(to)e │ │ │ │ │ (information)h(in)f(the)g(data)h(\014elds)e(without)i(explicitly)g │ │ │ │ │ (follo)m(wing)h(p)s(oin)m(ters.)0 723 y(There)g(is)h(o)m(v)m(erhead)h │ │ │ │ │ (in)m(v)m(olv)m(ed)h(with)d(these)h(metho)s(d)g(due)f(to)h(the)g │ │ │ │ │ (function)g(call)h(and)e(error)h(c)m(hec)m(king)h(inside)0 │ │ │ │ │ 835 y(the)31 b(metho)s(ds.)111 1110 y(1.)46 b Fk(int)h(DV_owned)f(\()h │ │ │ │ │ (DV)g(*dv)g(\))h(;)227 1276 y Fl(This)24 b(metho)s(d)g(returns)g(the)g │ │ │ │ │ @@ -4459,33 +4453,33 @@ │ │ │ │ │ (double)h(value)f(\))h(;)227 5242 y Fl(This)30 b(metho)s(d)g(sets)g │ │ │ │ │ (the)h Fk(loc)p Fl('th)f(en)m(try)g(of)h(the)f(v)m(ector)i(to)f │ │ │ │ │ Fk(value)p Fl(.)227 5407 y Ff(Err)-5 b(or)33 b(che)-5 │ │ │ │ │ b(cking:)40 b Fl(If)28 b Fk(dv)h Fl(is)g Fk(NULL)e Fl(or)j │ │ │ │ │ Fk(loc)46 b(<)i(0)p Fl(,)29 b(an)g(error)g(message)h(is)f(prin)m(ted)f │ │ │ │ │ (and)h(the)g(program)g(exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fl(4)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fk(DV)30 b Fg(:)h Ff(DRAFT)f Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 0 399 a Fd(1.2.3)112 b(Initializer)38 │ │ │ │ │ -b(metho)s(ds)0 592 y Fl(There)30 b(are)h(three)f(initializer)j(metho)s │ │ │ │ │ -(ds.)111 806 y(1.)46 b Fk(void)h(DV_init)f(\()h(DV)g(*dv,)g(int)g │ │ │ │ │ -(size,)f(double)g(*entries)g(\))h(;)227 953 y Fl(This)36 │ │ │ │ │ -b(metho)s(d)g(initializes)j(the)d(ob)5 b(ject)38 b(giv)m(en)f(a)g(size) │ │ │ │ │ -h(for)e(the)h(v)m(ector)h(and)e(a)h(p)s(ossible)f(p)s(oin)m(ter)g(to)i │ │ │ │ │ -(the)227 1066 y(v)m(ectors')30 b(storage.)42 b(An)m(y)28 │ │ │ │ │ -b(previous)g(data)h(is)g(cleared)g(with)f(a)h(call)h(to)f │ │ │ │ │ -Fk(DV)p 2716 1066 29 4 v 34 w(clearData\(\))p Fl(.)37 │ │ │ │ │ -b(If)28 b Fk(entries)46 b(!=)227 1178 y(NULL)31 b Fl(then)h(the)h │ │ │ │ │ -Fk(vec)e Fl(\014eld)h(is)g(set)h(to)g Fk(entries)p Fl(,)e(the)h │ │ │ │ │ -Fk(size)f Fl(and)h Fk(maxsize)e Fl(\014elds)h(are)i(set)g(to)g │ │ │ │ │ -Fk(size)p Fl(,)f(and)227 1291 y Fk(owned)25 b Fl(is)h(set)g(to)h(zero)g │ │ │ │ │ -(b)s(ecause)f(the)g(ob)5 b(ject)27 b(do)s(es)f(not)g(o)m(wn)g(the)g(en) │ │ │ │ │ -m(tries.)40 b(If)26 b Fk(entries)e Fl(is)i Fk(NULL)f │ │ │ │ │ -Fl(and)g Fk(size)227 1404 y(>)48 b(0)30 b Fl(then)g(a)h(v)m(ector)h(is) │ │ │ │ │ -e(allo)s(cated)i(b)m(y)f(the)f(ob)5 b(ject,)32 b(and)d(the)i(ob)5 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fl(4)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 0 399 a Fd(1.2.3)112 b(Initializer)38 b(metho)s(ds)0 │ │ │ │ │ +592 y Fl(There)30 b(are)h(three)f(initializer)j(metho)s(ds.)111 │ │ │ │ │ +806 y(1.)46 b Fk(void)h(DV_init)f(\()h(DV)g(*dv,)g(int)g(size,)f │ │ │ │ │ +(double)g(*entries)g(\))h(;)227 953 y Fl(This)36 b(metho)s(d)g │ │ │ │ │ +(initializes)j(the)d(ob)5 b(ject)38 b(giv)m(en)f(a)g(size)h(for)e(the)h │ │ │ │ │ +(v)m(ector)h(and)e(a)h(p)s(ossible)f(p)s(oin)m(ter)g(to)i(the)227 │ │ │ │ │ +1066 y(v)m(ectors')30 b(storage.)42 b(An)m(y)28 b(previous)g(data)h(is) │ │ │ │ │ +g(cleared)g(with)f(a)h(call)h(to)f Fk(DV)p 2716 1066 │ │ │ │ │ +29 4 v 34 w(clearData\(\))p Fl(.)37 b(If)28 b Fk(entries)46 │ │ │ │ │ +b(!=)227 1178 y(NULL)31 b Fl(then)h(the)h Fk(vec)e Fl(\014eld)h(is)g │ │ │ │ │ +(set)h(to)g Fk(entries)p Fl(,)e(the)h Fk(size)f Fl(and)h │ │ │ │ │ +Fk(maxsize)e Fl(\014elds)h(are)i(set)g(to)g Fk(size)p │ │ │ │ │ +Fl(,)f(and)227 1291 y Fk(owned)25 b Fl(is)h(set)g(to)h(zero)g(b)s │ │ │ │ │ +(ecause)f(the)g(ob)5 b(ject)27 b(do)s(es)f(not)g(o)m(wn)g(the)g(en)m │ │ │ │ │ +(tries.)40 b(If)26 b Fk(entries)e Fl(is)i Fk(NULL)f Fl(and)g │ │ │ │ │ +Fk(size)227 1404 y(>)48 b(0)30 b Fl(then)g(a)h(v)m(ector)h(is)e(allo)s │ │ │ │ │ +(cated)i(b)m(y)f(the)f(ob)5 b(ject,)32 b(and)d(the)i(ob)5 │ │ │ │ │ b(ject)31 b(o)m(wns)g(this)f(storage.)227 1551 y Ff(Err)-5 │ │ │ │ │ b(or)30 b(che)-5 b(cking:)38 b Fl(If)26 b Fk(dv)f Fl(is)h │ │ │ │ │ Fk(NULL)e Fl(or)i Fk(size)47 b(<)g(0)p Fl(,)27 b(an)f(error)f(message)i │ │ │ │ │ (is)f(prin)m(ted)g(and)f(the)h(program)g(exits.)111 1732 │ │ │ │ │ y(2.)46 b Fk(void)h(DV_init1)e(\()j(DV)f(*dv,)g(int)g(size)f(\))i(;)227 │ │ │ │ │ 1879 y Fl(This)30 b(metho)s(d)g(initializes)i(the)f(ob)5 │ │ │ │ │ b(ject)31 b(giv)m(en)g(a)g(size)g(size)h(for)e(the)g(v)m(ector)i(via)f │ │ │ │ │ @@ -4545,17 +4539,17 @@ │ │ │ │ │ (offset)f(\))h(;)227 5294 y Fl(This)32 b(metho)s(d)h(shifts)f(the)i │ │ │ │ │ (base)f(en)m(tries)g(of)h(the)f(v)m(ector)h(and)f(decremen)m(ts)g(the)g │ │ │ │ │ (presen)m(t)g(size)h(and)f(max-)227 5407 y(im)m(um)g(size)g(of)g(the)f │ │ │ │ │ (v)m(ector)j(b)m(y)d Fk(offset)p Fl(.)46 b(This)31 b(is)i(a)g │ │ │ │ │ (dangerous)f(metho)s(d)g(to)h(use)g(b)s(ecause)f(the)h(state)h(of)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1187 4 v 1368 100 a Fk(DV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fl(5)227 399 y(the)37 b(v)m(ector)h(is)e(lost,)j │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1206 4 v 1387 100 a Fk(DV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fl(5)227 399 y(the)37 b(v)m(ector)h(is)e(lost,)j │ │ │ │ │ (namely)e Fk(vec)p Fl(,)g(the)g(base)f(of)h(the)f(en)m(tries,)j(is)e │ │ │ │ │ (corrupted.)58 b(If)35 b(the)i(ob)5 b(ject)37 b(o)m(wns)g(its)227 │ │ │ │ │ 511 y(en)m(tries)29 b(and)e Fk(DV)p 792 511 29 4 v 34 │ │ │ │ │ w(free\(\))p Fl(,)g Fk(DV)p 1262 511 V 34 w(setSize\(\))e │ │ │ │ │ Fl(or)j Fk(DV)p 1958 511 V 34 w(setMaxsize\(\))d Fl(is)j(called)h(b)s │ │ │ │ │ (efore)f(the)g(base)g(has)g(b)s(een)227 624 y(shifted)h(bac)m(k)g(to)g │ │ │ │ │ (its)h(original)f(p)s(osition,)h(a)f(segmen)m(tation)i(violation)f │ │ │ │ │ @@ -4614,28 +4608,28 @@ │ │ │ │ │ 5088 y(7.)46 b Fk(int)h(DV_sizeOf)e(\()j(DV)f(*dv)g(\))g(;)227 │ │ │ │ │ 5247 y Fl(This)30 b(metho)s(d)g(returns)f(the)h(n)m(um)m(b)s(er)f(of)i │ │ │ │ │ (b)m(ytes)g(tak)m(en)g(b)m(y)g(the)f(ob)5 b(ject.)227 │ │ │ │ │ 5407 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fl(If)30 │ │ │ │ │ b Fk(dv)g Fl(is)h Fk(NULL)e Fl(an)h(error)g(message)h(is)g(prin)m(ted)f │ │ │ │ │ (and)g(the)g(program)g(exits.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fl(6)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fk(DV)30 b Fg(:)h Ff(DRAFT)f Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 111 399 a Fl(8.)46 b Fk(double)g(*)i(DV_first) │ │ │ │ │ -d(\()j(DV)f(*dv)g(\))g(;)227 511 y(double)f(*)i(DV_next)e(\()h(DV)g │ │ │ │ │ -(*dv,)g(int)g(*pd)g(\))g(;)227 671 y Fl(These)30 b(t)m(w)m(o)i(metho)s │ │ │ │ │ -(ds)e(are)h(used)e(as)i(iterators,)h(e.g.,)227 921 y │ │ │ │ │ -Fk(for)47 b(\()h(pd)f(=)g(DV_first\(dv\))e(;)i(pd)g(!=)h(NULL)e(;)i(pd) │ │ │ │ │ -f(=)g(DV_next\(dv,)e(pd\))i(\))g({)370 1033 y(do)h(something)d(with)i │ │ │ │ │ -(entry)f(*pd)227 1146 y(})227 1396 y Fl(Eac)m(h)41 b(metho)s(d)f(c)m │ │ │ │ │ -(hec)m(ks)i(to)f(see)g(if)f Fk(dv)g Fl(or)g Fk(pd)g Fl(is)g │ │ │ │ │ -Fk(NULL)p Fl(,)f(if)i(so)f(an)g(error)g(message)i(is)e(prin)m(ted)g │ │ │ │ │ -(and)g(the)227 1509 y(program)f(exits.)69 b(In)38 b(metho)s(d)h │ │ │ │ │ -Fk(DV)p 1442 1509 29 4 v 34 w(next\(\))p Fl(,)h(if)f │ │ │ │ │ -Fk(pd)g Fl(is)g(not)g(in)g(the)h(v)-5 b(alid)39 b(range,)j(an)e(error)e │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fl(6)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 111 399 a Fl(8.)46 b Fk(double)g(*)i(DV_first)d(\()j(DV)f │ │ │ │ │ +(*dv)g(\))g(;)227 511 y(double)f(*)i(DV_next)e(\()h(DV)g(*dv,)g(int)g │ │ │ │ │ +(*pd)g(\))g(;)227 671 y Fl(These)30 b(t)m(w)m(o)i(metho)s(ds)e(are)h │ │ │ │ │ +(used)e(as)i(iterators,)h(e.g.,)227 921 y Fk(for)47 b(\()h(pd)f(=)g │ │ │ │ │ +(DV_first\(dv\))e(;)i(pd)g(!=)h(NULL)e(;)i(pd)f(=)g(DV_next\(dv,)e │ │ │ │ │ +(pd\))i(\))g({)370 1033 y(do)h(something)d(with)i(entry)f(*pd)227 │ │ │ │ │ +1146 y(})227 1396 y Fl(Eac)m(h)41 b(metho)s(d)f(c)m(hec)m(ks)i(to)f │ │ │ │ │ +(see)g(if)f Fk(dv)g Fl(or)g Fk(pd)g Fl(is)g Fk(NULL)p │ │ │ │ │ +Fl(,)f(if)i(so)f(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g(the)227 │ │ │ │ │ +1509 y(program)f(exits.)69 b(In)38 b(metho)s(d)h Fk(DV)p │ │ │ │ │ +1442 1509 29 4 v 34 w(next\(\))p Fl(,)h(if)f Fk(pd)g │ │ │ │ │ +Fl(is)g(not)g(in)g(the)h(v)-5 b(alid)39 b(range,)j(an)e(error)e │ │ │ │ │ (message)j(is)227 1621 y(prin)m(ted)30 b(and)g(the)h(program)f(exits.) │ │ │ │ │ 227 1781 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fl(If)30 │ │ │ │ │ b Fk(dv)g Fl(is)h Fk(NULL)e Fl(an)h(error)g(message)h(is)g(prin)m(ted)f │ │ │ │ │ (and)g(the)g(program)g(exits.)111 1988 y(9.)46 b Fk(void)h(DV_fill)f │ │ │ │ │ (\()h(DV)g(*dv,)g(double)f(value)g(\))i(;)227 2148 y │ │ │ │ │ Fl(This)30 b(metho)s(d)g(\014lls)g(the)g(v)m(ector)i(with)e(a)h(scalar) │ │ │ │ │ h(v)-5 b(alue.)227 2308 y Ff(Err)g(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ @@ -4684,17 +4678,17 @@ │ │ │ │ │ b(are)i(the)f(usual)f(eigh)m(t)i(IO)f(routines.)40 b(The)30 │ │ │ │ │ b(\014le)f(structure)h(of)g(a)g Fk(DV)f Fl(ob)5 b(ject)31 │ │ │ │ │ b(is)f(simple:)41 b(the)30 b(\014rst)f(en)m(try)h(is)0 │ │ │ │ │ 5407 y Fk(size)p Fl(,)f(follo)m(w)m(ed)j(b)m(y)f(the)f │ │ │ │ │ Fk(size)g Fl(en)m(tries)h(found)e(in)h Fk(vec[])p Fl(.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1187 4 v 1368 100 a Fk(DV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fl(7)111 399 y(1.)46 b Fk(int)h(DV_readFromFile)d(\() │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1206 4 v 1387 100 a Fk(DV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fl(7)111 399 y(1.)46 b Fk(int)h(DV_readFromFile)d(\() │ │ │ │ │ j(DV)g(*dv,)g(char)g(*fn)g(\))g(;)227 547 y Fl(This)33 │ │ │ │ │ b(metho)s(d)g(reads)g(a)h Fk(DV)f Fl(ob)5 b(ject)35 b(from)e(a)h │ │ │ │ │ (\014le.)50 b(It)34 b(tries)f(to)i(op)s(en)e(the)g(\014le)h(and)f(if)g │ │ │ │ │ (it)h(is)g(successful,)g(it)227 660 y(then)j(calls)g │ │ │ │ │ Fk(DV)p 751 660 29 4 v 34 w(readFromFormattedFile\(\))30 │ │ │ │ │ b Fl(or)37 b Fk(DV)p 2133 660 V 34 w(readFromBinaryFile\(\))p │ │ │ │ │ Fl(,)32 b(closes)38 b(the)f(\014le)g(and)227 772 y(returns)29 │ │ │ │ │ @@ -4775,41 +4769,41 @@ │ │ │ │ │ (\))h(;)227 5259 y Fl(This)30 b(metho)s(d)g(writes)g(the)h(header)f │ │ │ │ │ (and)g(statistics)i(to)f(a)g(\014le.)41 b(The)29 b(v)-5 │ │ │ │ │ b(alue)31 b Fk(1)f Fl(is)h(returned.)227 5407 y Ff(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fl(If)30 b Fk(dv)g Fl(or)g │ │ │ │ │ Fk(fp)g Fl(are)h Fk(NULL)p Fl(,)e(an)i(error)f(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)f(zero)i(is)g(returned.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fl(8)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fk(DV)30 b Fg(:)h Ff(DRAFT)f Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 111 399 a Fl(9.)46 b Fk(int)h │ │ │ │ │ -(DV_writeForMatlab)c(\()48 b(DV)f(*dv,)g(char)f(*name,)g(FILE)h(*fp)g │ │ │ │ │ -(\))g(;)227 549 y Fl(This)37 b(metho)s(d)h(writes)f(the)i(en)m(tries)f │ │ │ │ │ -(of)g(the)g(v)m(ector)i(to)e(a)g(\014le)g(suitable)h(to)f(b)s(e)g(read) │ │ │ │ │ -f(b)m(y)h(Matlab.)64 b(The)227 662 y(c)m(haracter)31 │ │ │ │ │ -b(string)e Fk(name)f Fl(is)h(the)g(name)g(of)g(the)g(v)m(ector,)i(e.g,) │ │ │ │ │ -g(if)e Fk(name)46 b(=)i("A")p Fl(,)28 b(then)h(w)m(e)g(ha)m(v)m(e)h │ │ │ │ │ -(lines)g(of)f(the)227 775 y(form)227 1000 y Fk(A\(1\))47 │ │ │ │ │ -b(=)g(1.000000000000e0)d(;)227 1112 y(A\(2\))j(=)g(2.000000000000e0)d │ │ │ │ │ -(;)227 1225 y(...)227 1450 y Fl(for)31 b(eac)m(h)h(en)m(try)g(in)e(the) │ │ │ │ │ -i(v)m(ector.)44 b(Note,)33 b(the)e(output)g(indexing)g(is)g(1-based,)h │ │ │ │ │ -(not)f(0-based.)43 b(The)31 b(v)-5 b(alue)31 b Fk(1)227 │ │ │ │ │ -1563 y Fl(is)g(returned.)227 1714 y Ff(Err)-5 b(or)34 │ │ │ │ │ -b(che)-5 b(cking:)40 b Fl(If)30 b Fk(dv)g Fl(or)g Fk(fp)g │ │ │ │ │ -Fl(are)h Fk(NULL)p Fl(,)e(an)i(error)f(message)h(is)g(prin)m(ted)f(and) │ │ │ │ │ -f(zero)i(is)g(returned.)0 2025 y Fh(1.3)135 b(Driv)l(er)46 │ │ │ │ │ -b(programs)g(for)f(the)g Fe(DV)60 b(object)111 2253 y │ │ │ │ │ -Fl(1.)46 b Fk(testIO)g(msglvl)g(msgFile)g(inFile)g(outFile)227 │ │ │ │ │ -2403 y Fl(This)f(driv)m(er)g(program)g(tests)h(the)f │ │ │ │ │ -Fk(DV)f Fl(IO)h(metho)s(ds,)k(and)44 b(is)h(useful)g(for)g(translating) │ │ │ │ │ -h(b)s(et)m(w)m(een)g(the)227 2516 y(formatted)31 b Fk(*.dvf)e │ │ │ │ │ -Fl(and)h(binary)g Fk(*.dvb)e Fl(\014les.)337 2728 y Fi(\210)45 │ │ │ │ │ -b Fl(The)f Fk(msglvl)e Fl(parameter)j(determines)f(the)g(amoun)m(t)h │ │ │ │ │ -(of)f(output.)82 b(Use)44 b Fk(msglvl)i(=)i(1)c Fl(for)g(just)427 │ │ │ │ │ -2841 y(timing)31 b(output.)337 2988 y Fi(\210)45 b Fl(The)33 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fl(8)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 111 399 a Fl(9.)46 b Fk(int)h(DV_writeForMatlab)c(\()48 │ │ │ │ │ +b(DV)f(*dv,)g(char)f(*name,)g(FILE)h(*fp)g(\))g(;)227 │ │ │ │ │ +549 y Fl(This)37 b(metho)s(d)h(writes)f(the)i(en)m(tries)f(of)g(the)g │ │ │ │ │ +(v)m(ector)i(to)e(a)g(\014le)g(suitable)h(to)f(b)s(e)g(read)f(b)m(y)h │ │ │ │ │ +(Matlab.)64 b(The)227 662 y(c)m(haracter)31 b(string)e │ │ │ │ │ +Fk(name)f Fl(is)h(the)g(name)g(of)g(the)g(v)m(ector,)i(e.g,)g(if)e │ │ │ │ │ +Fk(name)46 b(=)i("A")p Fl(,)28 b(then)h(w)m(e)g(ha)m(v)m(e)h(lines)g │ │ │ │ │ +(of)f(the)227 775 y(form)227 1000 y Fk(A\(1\))47 b(=)g │ │ │ │ │ +(1.000000000000e0)d(;)227 1112 y(A\(2\))j(=)g(2.000000000000e0)d(;)227 │ │ │ │ │ +1225 y(...)227 1450 y Fl(for)31 b(eac)m(h)h(en)m(try)g(in)e(the)i(v)m │ │ │ │ │ +(ector.)44 b(Note,)33 b(the)e(output)g(indexing)g(is)g(1-based,)h(not)f │ │ │ │ │ +(0-based.)43 b(The)31 b(v)-5 b(alue)31 b Fk(1)227 1563 │ │ │ │ │ +y Fl(is)g(returned.)227 1714 y Ff(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +b(cking:)40 b Fl(If)30 b Fk(dv)g Fl(or)g Fk(fp)g Fl(are)h │ │ │ │ │ +Fk(NULL)p Fl(,)e(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(zero)i │ │ │ │ │ +(is)g(returned.)0 2025 y Fh(1.3)135 b(Driv)l(er)46 b(programs)g(for)f │ │ │ │ │ +(the)g Fe(DV)60 b(object)111 2253 y Fl(1.)46 b Fk(testIO)g(msglvl)g │ │ │ │ │ +(msgFile)g(inFile)g(outFile)227 2403 y Fl(This)f(driv)m(er)g(program)g │ │ │ │ │ +(tests)h(the)f Fk(DV)f Fl(IO)h(metho)s(ds,)k(and)44 b(is)h(useful)g │ │ │ │ │ +(for)g(translating)h(b)s(et)m(w)m(een)g(the)227 2516 │ │ │ │ │ +y(formatted)31 b Fk(*.dvf)e Fl(and)h(binary)g Fk(*.dvb)e │ │ │ │ │ +Fl(\014les.)337 2728 y Fi(\210)45 b Fl(The)f Fk(msglvl)e │ │ │ │ │ +Fl(parameter)j(determines)f(the)g(amoun)m(t)h(of)f(output.)82 │ │ │ │ │ +b(Use)44 b Fk(msglvl)i(=)i(1)c Fl(for)g(just)427 2841 │ │ │ │ │ +y(timing)31 b(output.)337 2988 y Fi(\210)45 b Fl(The)33 │ │ │ │ │ b Fk(msgFile)e Fl(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ (if)f Fk(msgFile)e Fl(is)i Fk(stdout)p Fl(,)g(then)g(the)427 │ │ │ │ │ 3100 y(message)27 b(\014le)f(is)g Ff(stdout)p Fl(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Ff(app)-5 b(end)28 │ │ │ │ │ b Fl(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 3213 │ │ │ │ │ y(data.)337 3359 y Fi(\210)45 b Fl(The)29 b Fk(inFile)f │ │ │ │ │ Fl(parameter)j(is)e(the)h(name)g(of)g(the)g(\014le)f(from)h(whic)m(h)f │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -22,15 +22,15 @@ │ │ │ │ │ │ simplest operations, and so when we need to manipulate an double vector inside a loop, we extract │ │ │ │ │ │ out the size and pointer to the base array from the DV object. On the other hand, the convenience │ │ │ │ │ │ makes it a widely used object. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ The DV structure has three fields. │ │ │ │ │ │ • int size : present size of the vector. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 DV : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 DV : DRAFT January 7, 2024 │ │ │ │ │ │ • int maxsize : maximum size of the vector. │ │ │ │ │ │ • int owned : owner flag for the data. When owned = 1, storage for owned double’s has been │ │ │ │ │ │ allocated by this object and can be free’d by the object. When owned == 0 but size > 0 , │ │ │ │ │ │ this object points to entries that have been allocated elsewhere, and these entries will not be │ │ │ │ │ │ free’d by this object. │ │ │ │ │ │ • double *vec : pointer to the base address of the double vector │ │ │ │ │ │ The size, maxsize, nowned and vec fields need never be accessed directly — see the DV size(), │ │ │ │ │ │ @@ -53,15 +53,15 @@ │ │ │ │ │ │ the storage for vec is free’d by a call to DVfree(). The structure’s default fields are then set │ │ │ │ │ │ with a call to DV setDefaultFields(). │ │ │ │ │ │ Error checking: If dv is NULL an error message is printed and the program exits. │ │ │ │ │ │ 4. void DV_free ( DV *dv ) ; │ │ │ │ │ │ This method releases any storage by a call to DV clearData() then free’s the storage for the │ │ │ │ │ │ structure with a call to free(). │ │ │ │ │ │ Error checking: If dv is NULL an error message is printed and the program exits. │ │ │ │ │ │ - DV : DRAFT February 8, 2025 3 │ │ │ │ │ │ + DV : DRAFT January 7, 2024 3 │ │ │ │ │ │ 1.2.2 Instance methods │ │ │ │ │ │ These method allow access to information in the data fields without explicitly following pointers. │ │ │ │ │ │ There is overhead involved with these method due to the function call and error checking inside │ │ │ │ │ │ the methods. │ │ │ │ │ │ 1. int DV_owned ( DV *dv ) ; │ │ │ │ │ │ This method returns the value of owned. If owned > 0, then the object owns the data pointed │ │ │ │ │ │ to by vec and will free this data with a call to DVfree() when its data is cleared by a call to │ │ │ │ │ │ @@ -85,15 +85,15 @@ │ │ │ │ │ │ This method fills *psize with the size of the vector and **pentries with the base address │ │ │ │ │ │ of the vector. │ │ │ │ │ │ Error checking: If dv, psize or pentriesis NULL, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 7. void DV_setEntry ( DV *dv, int loc, double value ) ; │ │ │ │ │ │ This method sets the loc’th entry of the vector to value. │ │ │ │ │ │ Error checking: If dv is NULL or loc < 0, an error message is printed and the program exits. │ │ │ │ │ │ - 4 DV : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 DV : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.3 Initializer methods │ │ │ │ │ │ There are three initializer methods. │ │ │ │ │ │ 1. void DV_init ( DV *dv, int size, double *entries ) ; │ │ │ │ │ │ This method initializes the object given a size for the vector and a possible pointer to the │ │ │ │ │ │ vectors’ storage. Any previous data is cleared with a call to DV clearData(). If entries != │ │ │ │ │ │ NULL then the vec field is set to entries, the size and maxsize fields are set to size, and │ │ │ │ │ │ owned is set to zero because the object does not own the entries. If entries is NULL and size │ │ │ │ │ │ @@ -123,15 +123,15 @@ │ │ │ │ │ │ increased with a call to DV setMaxsize(). The size field is set to newsize. │ │ │ │ │ │ Error checking: If dv is NULL, or newsize < 0, or if 0 < maxsize < newsize and owned = │ │ │ │ │ │ 0, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.4 Utility methods │ │ │ │ │ │ 1. void DV_shiftBase ( DV *dv, int offset ) ; │ │ │ │ │ │ This method shifts the base entries of the vector and decrements the present size and max- │ │ │ │ │ │ imum size of the vector by offset. This is a dangerous method to use because the state of │ │ │ │ │ │ - DV : DRAFT February 8, 2025 5 │ │ │ │ │ │ + DV : DRAFT January 7, 2024 5 │ │ │ │ │ │ the vector is lost, namely vec, the base of the entries, is corrupted. If the object owns its │ │ │ │ │ │ entries and DV free(), DV setSize() or DV setMaxsize() is called before the base has been │ │ │ │ │ │ shifted back to its original position, a segmentation violation will likely result. This is a very │ │ │ │ │ │ useful method, but use with caution. │ │ │ │ │ │ Error checking: If dv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. void DV_push ( DV *dv, double val ) ; │ │ │ │ │ │ This method pushes an entry onto the vector. If the vector is full, i.e., if size == maxsize │ │ │ │ │ │ @@ -159,15 +159,15 @@ │ │ │ │ │ │ This method shuffles the entries in the vector using seed as a seed to a random number │ │ │ │ │ │ generator. │ │ │ │ │ │ Error checking: If dv is NULL, size <= 0 or if vec == NULL, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 7. int DV_sizeOf ( DV *dv ) ; │ │ │ │ │ │ This method returns the number of bytes taken by the object. │ │ │ │ │ │ Error checking: If dv is NULL an error message is printed and the program exits. │ │ │ │ │ │ - 6 DV : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 DV : DRAFT January 7, 2024 │ │ │ │ │ │ 8. double * DV_first ( DV *dv ) ; │ │ │ │ │ │ double * DV_next ( DV *dv, int *pd ) ; │ │ │ │ │ │ These two methods are used as iterators, e.g., │ │ │ │ │ │ for ( pd = DV_first(dv) ; pd != NULL ; pd = DV_next(dv, pd) ) { │ │ │ │ │ │ do something with entry *pd │ │ │ │ │ │ } │ │ │ │ │ │ Each method checks to see if dv or pd is NULL, if so an error message is printed and the │ │ │ │ │ │ @@ -193,15 +193,15 @@ │ │ │ │ │ │ smaller than tausmall, or larger than taubig are placed into pnzero, *pnsmall and *pnbig, │ │ │ │ │ │ respectively. On return, the size of the xDV and yDV objects is npts. │ │ │ │ │ │ Error checking: If dv, xDV, yDV, pnsmall or pnbig are NULL, or if npts ≤ 0, or if taubig < 0.0 │ │ │ │ │ │ or if tausmall > taubig, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.5 IO methods │ │ │ │ │ │ There are the usual eight IO routines. The file structure of a DV object is simple: the first entry is │ │ │ │ │ │ size, followed by the size entries found in vec[]. │ │ │ │ │ │ - DV : DRAFT February 8, 2025 7 │ │ │ │ │ │ + DV : DRAFT January 7, 2024 7 │ │ │ │ │ │ 1. int DV_readFromFile ( DV *dv, char *fn ) ; │ │ │ │ │ │ This method reads a DV object from a file. It tries to open the file and if it is successful, it │ │ │ │ │ │ then calls DV readFromFormattedFile() or DV readFromBinaryFile(), closes the file and │ │ │ │ │ │ returns the value returned from the called routine. │ │ │ │ │ │ Error checking: If dv or fn are NULL, or if fn is not of the form *.dvf (for a formatted file) │ │ │ │ │ │ or *.dvb (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ 2. int DV_readFromFormattedFile ( DV *dv, FILE *fp ) ; │ │ │ │ │ │ @@ -230,15 +230,15 @@ │ │ │ │ │ │ This method writes a DV object to a file in a human readable format. is called to write out │ │ │ │ │ │ the header and statistics. The entries of the vector then follow in eighty column format using │ │ │ │ │ │ the DVfprintf() method. The value 1 is returned. │ │ │ │ │ │ Error checking: If dv or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 8. int DV_writeStats ( DV *dv, FILE *fp ) ; │ │ │ │ │ │ This method writes the header and statistics to a file. The value 1 is returned. │ │ │ │ │ │ Error checking: If dv or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - 8 DV : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 DV : DRAFT January 7, 2024 │ │ │ │ │ │ 9. int DV_writeForMatlab ( DV *dv, char *name, FILE *fp ) ; │ │ │ │ │ │ This method writes the entries of the vector to a file suitable to be read by Matlab. The │ │ │ │ │ │ character string name is the name of the vector, e.g, if name = "A", then we have lines of the │ │ │ │ │ │ form │ │ │ │ │ │ A(1) = 1.000000000000e0 ; │ │ │ │ │ │ A(2) = 2.000000000000e0 ; │ │ │ │ │ │ ... │ │ │ ├── ./usr/share/doc/spooles-doc/DenseMtx.ps.gz │ │ │ │ ├── DenseMtx.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o DenseMtx.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1622,21 +1622,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1820,88 +1819,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3690,16 +3684,16 @@ │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 40258437 52099151 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 234[65 21[{}1 83.022 /CMSY10 rf /Fb 195[65 │ │ │ │ │ 60[{}1 83.022 /CMMI10 rf /Fc 133[50 59 4[44 44 3[56 62 │ │ │ │ │ 93 31 2[31 62 2[51 62 50 1[54 11[86 5[84 5[42 6[80 12[56 │ │ │ │ │ 56 56 56 56 2[31 46[{}24 99.6264 /CMBX12 rf /Fd 135[62 │ │ │ │ │ 3[62 62 4[62 8[62 23[62 8[62 68[{}7 119.552 /CMTT12 rf │ │ │ │ │ -/Fe 134[44 3[46 2[33 12[37 2[46 42 26[54 11[23 1[42 2[42 │ │ │ │ │ -2[42 1[42 3[23 44[{}13 83.022 /CMSL10 rf │ │ │ │ │ +/Fe 134[44 3[46 2[33 3[46 12[42 22[43 15[23 2[42 2[42 │ │ │ │ │ +1[42 1[42 3[23 44[{}12 83.022 /CMSL10 rf │ │ │ │ │ %DVIPSBitmapFont: Ff tcrm1000 10 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3822,41 +3816,40 @@ │ │ │ │ │ b Fj(returns)j Fi(1)g Fj(if)h(the)g(matrix)f(has)g(real)g(en)n(tries,)g │ │ │ │ │ (and)h Fi(0)f Fj(otherwise.)125 5407 y Ff(\210)42 b Fi(DENSEMTX)p │ │ │ │ │ 565 5407 V 28 w(IS)p 681 5407 V 30 w(COMPLEX\(mtx\))23 │ │ │ │ │ b Fj(returns)k Fi(1)g Fj(if)h(the)g(matrix)f(has)g(complex)g(en)n │ │ │ │ │ (tries,)g(and)h Fi(0)f Fj(otherwise.)1929 5656 y(1)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fj(2)p 125 100 1118 4 v │ │ │ │ │ -1283 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)27 b Fe(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2783 100 V 0 390 a Fg(1.2)135 │ │ │ │ │ -b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g Fd(DenseMtx)c │ │ │ │ │ -Fg(metho)t(ds)0 598 y Fj(This)35 b(section)f(con)n(tains)g(brief)h │ │ │ │ │ -(descriptions)f(including)h(protot)n(yp)r(es)f(of)h(all)f(metho)r(ds)i │ │ │ │ │ -(that)f(b)r(elong)f(to)h(the)g Fi(DenseMtx)0 698 y Fj(ob)5 │ │ │ │ │ -b(ject.)0 958 y Fc(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ -1138 y Fj(As)21 b(usual,)g(there)f(are)g(four)g(basic)g(metho)r(ds)g │ │ │ │ │ -(to)h(supp)r(ort)f(ob)5 b(ject)20 b(creation,)h(setting)f(default)h │ │ │ │ │ -(\014elds,)h(clearing)d(an)n(y)h(allo)r(cated)0 1237 │ │ │ │ │ -y(data,)27 b(and)h(free'ing)f(the)h(ob)5 b(ject.)101 │ │ │ │ │ -1447 y(1.)42 b Fi(DenseMtx)e(*)j(DenseMtx_new)c(\()k(void)f(\))h(;)208 │ │ │ │ │ -1581 y Fj(This)27 b(metho)r(d)h(simply)g(allo)r(cates)f(storage)f(for)h │ │ │ │ │ -(the)h Fi(DenseMtx)d Fj(structure)i(and)g(then)i(sets)e(the)h(default)g │ │ │ │ │ -(\014elds)g(b)n(y)f(a)208 1681 y(call)g(to)g Fi(DenseMtx)p │ │ │ │ │ -818 1681 27 4 v 28 w(setDefaultFields\()o(\))p Fj(.)101 │ │ │ │ │ -1849 y(2.)42 b Fi(void)f(DenseMtx_setDefau)o(ltF)o(ie)o(lds)c(\()43 │ │ │ │ │ -b(DenseMtx)d(*mtx)i(\))h(;)208 1983 y Fj(The)29 b(structure's)g │ │ │ │ │ -(\014elds)g(are)g(set)g(to)g(default)h(v)-5 b(alues:)40 │ │ │ │ │ -b Fi(type)28 b Fj(=)h Fi(SPOOLES)p 2558 1983 V 29 w(REAL)p │ │ │ │ │ -Fj(,)e Fi(rowid)h Fj(=)h Fi(colid)e Fj(=)i Fi(-1)p Fj(,)h │ │ │ │ │ -Fi(nrow)d Fj(=)208 2083 y Fi(ncol)h Fj(=)i Fi(inc1)f │ │ │ │ │ -Fj(=)h Fi(inc2)e Fj(=)i(0)g(and)g Fi(rowind)e Fj(=)i │ │ │ │ │ -Fi(colind)e Fj(=)i Fi(entries)d Fj(=)j Fi(next)f Fj(=)h │ │ │ │ │ -Fi(NULL)f Fj(.)h(The)g Fi(wrkDV)f Fj(ob)5 b(ject)30 b(has)208 │ │ │ │ │ -2183 y(its)d(default)h(\014elds)g(set)g(via)f(a)g(call)g(to)h │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 125 100 1135 4 v │ │ │ │ │ +1300 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)28 b Fe(Jan)n(uary)d(7,)i │ │ │ │ │ +(2024)p 2766 100 V 0 390 a Fg(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ +b(and)f(descriptions)g(of)g Fd(DenseMtx)c Fg(metho)t(ds)0 │ │ │ │ │ +598 y Fj(This)35 b(section)f(con)n(tains)g(brief)h(descriptions)f │ │ │ │ │ +(including)h(protot)n(yp)r(es)f(of)h(all)f(metho)r(ds)i(that)f(b)r │ │ │ │ │ +(elong)f(to)h(the)g Fi(DenseMtx)0 698 y Fj(ob)5 b(ject.)0 │ │ │ │ │ +958 y Fc(1.2.1)112 b(Basic)38 b(metho)s(ds)0 1138 y Fj(As)21 │ │ │ │ │ +b(usual,)g(there)f(are)g(four)g(basic)g(metho)r(ds)g(to)h(supp)r(ort)f │ │ │ │ │ +(ob)5 b(ject)20 b(creation,)h(setting)f(default)h(\014elds,)h(clearing) │ │ │ │ │ +d(an)n(y)h(allo)r(cated)0 1237 y(data,)27 b(and)h(free'ing)f(the)h(ob)5 │ │ │ │ │ +b(ject.)101 1447 y(1.)42 b Fi(DenseMtx)e(*)j(DenseMtx_new)c(\()k(void)f │ │ │ │ │ +(\))h(;)208 1581 y Fj(This)27 b(metho)r(d)h(simply)g(allo)r(cates)f │ │ │ │ │ +(storage)f(for)h(the)h Fi(DenseMtx)d Fj(structure)i(and)g(then)i(sets)e │ │ │ │ │ +(the)h(default)g(\014elds)g(b)n(y)f(a)208 1681 y(call)g(to)g │ │ │ │ │ +Fi(DenseMtx)p 818 1681 27 4 v 28 w(setDefaultFields\()o(\))p │ │ │ │ │ +Fj(.)101 1849 y(2.)42 b Fi(void)f(DenseMtx_setDefau)o(ltF)o(ie)o(lds)c │ │ │ │ │ +(\()43 b(DenseMtx)d(*mtx)i(\))h(;)208 1983 y Fj(The)29 │ │ │ │ │ +b(structure's)g(\014elds)g(are)g(set)g(to)g(default)h(v)-5 │ │ │ │ │ +b(alues:)40 b Fi(type)28 b Fj(=)h Fi(SPOOLES)p 2558 1983 │ │ │ │ │ +V 29 w(REAL)p Fj(,)e Fi(rowid)h Fj(=)h Fi(colid)e Fj(=)i │ │ │ │ │ +Fi(-1)p Fj(,)h Fi(nrow)d Fj(=)208 2083 y Fi(ncol)h Fj(=)i │ │ │ │ │ +Fi(inc1)f Fj(=)h Fi(inc2)e Fj(=)i(0)g(and)g Fi(rowind)e │ │ │ │ │ +Fj(=)i Fi(colind)e Fj(=)i Fi(entries)d Fj(=)j Fi(next)f │ │ │ │ │ +Fj(=)h Fi(NULL)f Fj(.)h(The)g Fi(wrkDV)f Fj(ob)5 b(ject)30 │ │ │ │ │ +b(has)208 2183 y(its)d(default)h(\014elds)g(set)g(via)f(a)g(call)g(to)h │ │ │ │ │ Fi(DV)p 1497 2183 V 30 w(setDefaultFields)o(\(\))p Fj(.)208 │ │ │ │ │ 2317 y Fh(Err)l(or)i(che)l(cking:)38 b Fj(If)28 b Fi(mtx)f │ │ │ │ │ Fj(is)g Fi(NULL)p Fj(,)f(an)i(error)d(message)i(is)g(prin)n(ted)h(and)f │ │ │ │ │ (the)h(program)e(exits.)101 2485 y(3.)42 b Fi(void)f(DenseMtx_clearDat) │ │ │ │ │ o(a)d(\()43 b(DenseMtx)d(*mtx)i(\))h(;)208 2619 y Fj(This)29 │ │ │ │ │ b(metho)r(d)i(clears)d(the)i(ob)5 b(ject)30 b(and)g(free's)f(an)n(y)g │ │ │ │ │ (o)n(wned)g(data)h(b)n(y)f(in)n(v)n(oking)g(the)p 2928 │ │ │ │ │ @@ -3897,17 +3890,17 @@ │ │ │ │ │ f(the)i(ro)n(w)e(incremen)n(t)g(of)h(the)h(ob)5 b(ject,)24 │ │ │ │ │ b(the)h(di\013erence)f(in)g(memory)f(lo)r(cations)h(of)g(t)n(w)n(o)f │ │ │ │ │ (en)n(tries)208 5273 y(in)k(consecutiv)n(e)g(columns)g(in)h(the)g(same) │ │ │ │ │ f(ro)n(w.)208 5407 y Fh(Err)l(or)j(che)l(cking:)38 b │ │ │ │ │ Fj(If)28 b Fi(mtx)f Fj(is)g Fi(NULL)p Fj(,)f(an)i(error)d(message)i(is) │ │ │ │ │ g(prin)n(ted)h(and)f(the)h(program)e(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 83 100 1118 4 v 1283 100 a Fi(DenseMtx)24 │ │ │ │ │ -b Fe(:)37 b Fh(DRAFT)111 b Fe(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1118 w Fj(3)101 390 y(5.)42 b Fi(int)g(DenseMtx_rowIncr)o │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1135 4 v 1301 100 a Fi(DenseMtx)24 │ │ │ │ │ +b Fe(:)37 b Fh(DRAFT)110 b Fe(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2726 100 V 1135 w Fj(3)101 390 y(5.)42 b Fi(int)g(DenseMtx_rowIncr)o │ │ │ │ │ (em)o(ent)37 b(\()43 b(DenseMtx)d(*mtx)i(\))h(;)208 529 │ │ │ │ │ y Fj(This)24 b(metho)r(d)g(returns)f(the)i(ro)n(w)e(incremen)n(t)g(of)h │ │ │ │ │ (the)h(ob)5 b(ject,)24 b(the)h(di\013erence)f(in)g(memory)f(lo)r │ │ │ │ │ (cations)h(of)g(t)n(w)n(o)f(en)n(tries)208 629 y(in)k(consecutiv)n(e)g │ │ │ │ │ (ro)n(ws)f(in)i(the)g(same)f(column.)208 767 y Fh(Err)l(or)j(che)l │ │ │ │ │ (cking:)38 b Fj(If)28 b Fi(mtx)f Fj(is)g Fi(NULL)p Fj(,)f(an)i(error)d │ │ │ │ │ (message)i(is)g(prin)n(ted)h(and)f(the)h(program)e(exits.)101 │ │ │ │ │ @@ -3978,31 +3971,31 @@ │ │ │ │ │ Fi(jcol)f Fj(to)i(b)r(e)208 5169 y Fi(\(real,imag\))p │ │ │ │ │ Fj(.)208 5308 y Fh(Err)l(or)31 b(che)l(cking:)42 b Fj(If)29 │ │ │ │ │ b Fi(mtx)f Fj(is)h Fi(NULL)p Fj(,)e(or)h(if)i(the)f(matrix)g(is)g(not)g │ │ │ │ │ (complex,)g(or)f(if)h Fi(irow)f Fj(or)g Fi(jcol)f Fj(is)i(out)g(of)g │ │ │ │ │ (range,)f(an)208 5407 y(error)d(message)h(is)i(prin)n(ted)f(and)h(the)g │ │ │ │ │ (program)d(exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fj(4)p 125 100 1118 4 v │ │ │ │ │ -1283 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)27 b Fe(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2783 100 V 60 390 a Fj(14.)41 │ │ │ │ │ -b Fi(int)h(DenseMtx_row)d(\()k(DenseMtx)d(*mtx,)h(int)i(irow,)e(double) │ │ │ │ │ -g(**prowent)f(\))j(;)208 517 y Fj(This)27 b(metho)r(d)h(\014lls)g │ │ │ │ │ -Fi(*prowent)c Fj(with)k(the)g(\014rst)g(lo)r(cation)f(of)g(the)h(en)n │ │ │ │ │ -(tries)f(in)h(ro)n(w)e Fi(irow)p Fj(.)208 644 y Fh(R)l(eturn)31 │ │ │ │ │ -b(c)l(o)l(des:)45 b Fi(1)31 b Fj(is)g(a)g(normal)f(return,)i │ │ │ │ │ -Fi(-1)e Fj(means)h Fi(mtx)f Fj(is)h Fi(NULL)p Fj(,)f │ │ │ │ │ -Fi(-2)g Fj(means)h(in)n(v)-5 b(alid)31 b(t)n(yp)r(e)g(for)g │ │ │ │ │ -Fi(mtx)p Fj(,)g Fi(-3)g Fj(means)208 744 y Fi(irow)26 │ │ │ │ │ -b Fj(is)h(out-of-range,)f Fi(-4)g Fj(means)h Fi(prowent)e │ │ │ │ │ -Fj(is)j Fi(NULL)p Fj(.)60 899 y(15.)41 b Fi(int)h(DenseMtx_column)37 │ │ │ │ │ -b(\()43 b(DenseMtx)e(*mtx,)g(int)i(jcol,)e(double)g(**pcolent)f(\))j(;) │ │ │ │ │ -208 1026 y Fj(This)27 b(metho)r(d)h(\014lls)g Fi(*pcolent)c │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 125 100 1135 4 v │ │ │ │ │ +1300 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)28 b Fe(Jan)n(uary)d(7,)i │ │ │ │ │ +(2024)p 2766 100 V 60 390 a Fj(14.)41 b Fi(int)h(DenseMtx_row)d(\()k │ │ │ │ │ +(DenseMtx)d(*mtx,)h(int)i(irow,)e(double)g(**prowent)f(\))j(;)208 │ │ │ │ │ +517 y Fj(This)27 b(metho)r(d)h(\014lls)g Fi(*prowent)c │ │ │ │ │ Fj(with)k(the)g(\014rst)g(lo)r(cation)f(of)g(the)h(en)n(tries)f(in)h │ │ │ │ │ -(column)g Fi(jcol)p Fj(.)208 1153 y Fh(R)l(eturn)j(c)l(o)l(des:)45 │ │ │ │ │ +(ro)n(w)e Fi(irow)p Fj(.)208 644 y Fh(R)l(eturn)31 b(c)l(o)l(des:)45 │ │ │ │ │ +b Fi(1)31 b Fj(is)g(a)g(normal)f(return,)i Fi(-1)e Fj(means)h │ │ │ │ │ +Fi(mtx)f Fj(is)h Fi(NULL)p Fj(,)f Fi(-2)g Fj(means)h(in)n(v)-5 │ │ │ │ │ +b(alid)31 b(t)n(yp)r(e)g(for)g Fi(mtx)p Fj(,)g Fi(-3)g │ │ │ │ │ +Fj(means)208 744 y Fi(irow)26 b Fj(is)h(out-of-range,)f │ │ │ │ │ +Fi(-4)g Fj(means)h Fi(prowent)e Fj(is)j Fi(NULL)p Fj(.)60 │ │ │ │ │ +899 y(15.)41 b Fi(int)h(DenseMtx_column)37 b(\()43 b(DenseMtx)e(*mtx,)g │ │ │ │ │ +(int)i(jcol,)e(double)g(**pcolent)f(\))j(;)208 1026 y │ │ │ │ │ +Fj(This)27 b(metho)r(d)h(\014lls)g Fi(*pcolent)c Fj(with)k(the)g │ │ │ │ │ +(\014rst)g(lo)r(cation)f(of)g(the)h(en)n(tries)f(in)h(column)g │ │ │ │ │ +Fi(jcol)p Fj(.)208 1153 y Fh(R)l(eturn)j(c)l(o)l(des:)45 │ │ │ │ │ b Fi(1)31 b Fj(is)g(a)g(normal)f(return,)i Fi(-1)e Fj(means)h │ │ │ │ │ Fi(mtx)f Fj(is)h Fi(NULL)p Fj(,)f Fi(-2)g Fj(means)h(in)n(v)-5 │ │ │ │ │ b(alid)31 b(t)n(yp)r(e)g(for)g Fi(mtx)p Fj(,)g Fi(-3)g │ │ │ │ │ Fj(means)208 1253 y Fi(jcol)26 b Fj(is)h(out-of-range,)f │ │ │ │ │ Fi(-4)g Fj(means)h Fi(pcolent)e Fj(is)j Fi(NULL)p Fj(.)0 │ │ │ │ │ 1499 y Fc(1.2.3)112 b(Initialization)39 b(metho)s(ds)0 │ │ │ │ │ 1672 y Fj(There)27 b(are)g(three)g(initializer)g(metho)r(ds.)101 │ │ │ │ │ @@ -4075,17 +4068,17 @@ │ │ │ │ │ y Fj(This)27 b(metho)r(d)h(initializes)g(the)g Fi(a2)f │ │ │ │ │ Fj(ob)5 b(ject)27 b(to)g(p)r(oin)n(t)h(in)n(to)f(the)h(en)n(tries)f(of) │ │ │ │ │ h(the)g(matrix.)208 5407 y Fh(Err)l(or)i(che)l(cking:)38 │ │ │ │ │ b Fj(If)28 b Fi(mtx)f Fj(or)g Fi(a2)f Fj(is)i Fi(NULL)p │ │ │ │ │ Fj(,)e(an)h(error)f(message)g(is)i(prin)n(ted)f(and)h(the)g(program)d │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 83 100 1118 4 v 1283 100 a Fi(DenseMtx)24 │ │ │ │ │ -b Fe(:)37 b Fh(DRAFT)111 b Fe(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1118 w Fj(5)0 390 y Fc(1.2.4)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1135 4 v 1301 100 a Fi(DenseMtx)24 │ │ │ │ │ +b Fe(:)37 b Fh(DRAFT)110 b Fe(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2726 100 V 1135 w Fj(5)0 390 y Fc(1.2.4)112 b(Utilit)m(y)38 │ │ │ │ │ b(metho)s(ds)101 570 y Fj(1.)k Fi(int)g(DenseMtx_nbytesN)o(ee)o(ded)37 │ │ │ │ │ b(\()43 b(int)f(type,)g(int)g(nrow,)g(int)g(ncol)g(\))h(;)208 │ │ │ │ │ 705 y Fj(This)27 b(metho)r(d)h(returns)f(the)h(n)n(um)n(b)r(er)f(of)h │ │ │ │ │ (b)n(ytes)f(required)g(to)g(store)g(the)h(ob)5 b(ject's)27 │ │ │ │ │ b(information)g(in)h(its)g(bu\013er.)208 839 y Fh(Err)l(or)h(che)l │ │ │ │ │ (cking:)38 b Fj(If)27 b Fi(type)e Fj(is)i(neither)f Fi(SPOOLES)p │ │ │ │ │ 1758 839 27 4 v 29 w(REAL)f Fj(nor)g Fi(SPOOLES)p 2442 │ │ │ │ │ @@ -4164,35 +4157,34 @@ │ │ │ │ │ Fi(irowB)e Fj(is)h(out)h(of)f(range,)h(or)f(if)h Fi(mtxA)e │ │ │ │ │ Fj(is)h Fi(NULL)p Fj(,)f(or)h(if)h Fi(irowA)e Fj(is)h(out)h(of)208 │ │ │ │ │ 5308 y(range,)23 b(or)h(if)g(the)h(n)n(um)n(b)r(er)f(of)h(columns)f(in) │ │ │ │ │ g Fi(mtxB)f Fj(and)h Fi(mtxA)f Fj(are)g(not)h(the)h(same,)g(an)f(error) │ │ │ │ │ e(message)h(is)h(prin)n(ted)g(and)208 5407 y(the)k(program)d(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fj(6)p 125 100 1118 4 v │ │ │ │ │ -1283 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)27 b Fe(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2783 100 V 101 390 a Fj(9.)42 │ │ │ │ │ -b Fi(void)f(DenseMtx_addRow)d(\()43 b(DenseMtx)d(*mtxB,)h(int)i(irowB,) │ │ │ │ │ -e(DenseMtx)f(*mtxA,)h(int)i(irowA)85 b(\))43 b(;)208 │ │ │ │ │ -525 y Fj(This)27 b(metho)r(d)h(adds)f(ro)n(w)g Fi(irowA)e │ │ │ │ │ -Fj(from)j(matrix)f Fi(mtxA)f Fj(in)n(to)h(ro)n(w)f Fi(irowB)g │ │ │ │ │ -Fj(of)i(matrix)f Fi(mtxB)p Fj(.)208 659 y Fh(Err)l(or)34 │ │ │ │ │ -b(che)l(cking:)46 b Fj(If)32 b Fi(mtxB)e Fj(is)i Fi(NULL)p │ │ │ │ │ -Fj(,)e(or)h(if)h Fi(irowB)e Fj(is)h(out)h(of)f(range,)h(or)f(if)h │ │ │ │ │ -Fi(mtxA)e Fj(is)h Fi(NULL)p Fj(,)f(or)h(if)h Fi(irowA)e │ │ │ │ │ -Fj(is)h(out)h(of)208 759 y(range,)23 b(or)h(if)g(the)h(n)n(um)n(b)r(er) │ │ │ │ │ -f(of)h(columns)f(in)g Fi(mtxB)f Fj(and)h Fi(mtxA)f Fj(are)g(not)h(the)h │ │ │ │ │ -(same,)g(an)f(error)e(message)h(is)h(prin)n(ted)g(and)208 │ │ │ │ │ -859 y(the)k(program)d(exits.)60 1028 y(10.)41 b Fi(void)g │ │ │ │ │ -(DenseMtx_zero)e(\()k(DenseMtx)d(*mtx)i(\))h(;)208 1163 │ │ │ │ │ -y Fj(This)27 b(metho)r(d)h(zeros)e(the)i(en)n(tries)f(in)h(the)g │ │ │ │ │ -(matrix.)208 1298 y Fh(Err)l(or)i(che)l(cking:)38 b Fj(If)28 │ │ │ │ │ -b Fi(mtx)f Fj(is)g Fi(NULL)p Fj(,)f(an)i(error)d(message)i(is)g(prin)n │ │ │ │ │ -(ted)h(and)f(the)h(program)e(exits.)60 1467 y(11.)41 │ │ │ │ │ -b Fi(void)g(DenseMtx_fillRand)o(omE)o(nt)o(rie)o(s)c(\()43 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fj(6)p 125 100 1135 4 v │ │ │ │ │ +1300 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)28 b Fe(Jan)n(uary)d(7,)i │ │ │ │ │ +(2024)p 2766 100 V 101 390 a Fj(9.)42 b Fi(void)f(DenseMtx_addRow)d(\() │ │ │ │ │ +43 b(DenseMtx)d(*mtxB,)h(int)i(irowB,)e(DenseMtx)f(*mtxA,)h(int)i │ │ │ │ │ +(irowA)85 b(\))43 b(;)208 525 y Fj(This)27 b(metho)r(d)h(adds)f(ro)n(w) │ │ │ │ │ +g Fi(irowA)e Fj(from)j(matrix)f Fi(mtxA)f Fj(in)n(to)h(ro)n(w)f │ │ │ │ │ +Fi(irowB)g Fj(of)i(matrix)f Fi(mtxB)p Fj(.)208 659 y │ │ │ │ │ +Fh(Err)l(or)34 b(che)l(cking:)46 b Fj(If)32 b Fi(mtxB)e │ │ │ │ │ +Fj(is)i Fi(NULL)p Fj(,)e(or)h(if)h Fi(irowB)e Fj(is)h(out)h(of)f │ │ │ │ │ +(range,)h(or)f(if)h Fi(mtxA)e Fj(is)h Fi(NULL)p Fj(,)f(or)h(if)h │ │ │ │ │ +Fi(irowA)e Fj(is)h(out)h(of)208 759 y(range,)23 b(or)h(if)g(the)h(n)n │ │ │ │ │ +(um)n(b)r(er)f(of)h(columns)f(in)g Fi(mtxB)f Fj(and)h │ │ │ │ │ +Fi(mtxA)f Fj(are)g(not)h(the)h(same,)g(an)f(error)e(message)h(is)h │ │ │ │ │ +(prin)n(ted)g(and)208 859 y(the)k(program)d(exits.)60 │ │ │ │ │ +1028 y(10.)41 b Fi(void)g(DenseMtx_zero)e(\()k(DenseMtx)d(*mtx)i(\))h │ │ │ │ │ +(;)208 1163 y Fj(This)27 b(metho)r(d)h(zeros)e(the)i(en)n(tries)f(in)h │ │ │ │ │ +(the)g(matrix.)208 1298 y Fh(Err)l(or)i(che)l(cking:)38 │ │ │ │ │ +b Fj(If)28 b Fi(mtx)f Fj(is)g Fi(NULL)p Fj(,)f(an)i(error)d(message)i │ │ │ │ │ +(is)g(prin)n(ted)h(and)f(the)h(program)e(exits.)60 1467 │ │ │ │ │ +y(11.)41 b Fi(void)g(DenseMtx_fillRand)o(omE)o(nt)o(rie)o(s)c(\()43 │ │ │ │ │ b(DenseMtx)e(*mtx,)g(Drand)h(*drand)f(\))i(;)208 1602 │ │ │ │ │ y Fj(This)27 b(metho)r(d)h(the)g(en)n(tries)f(in)h(the)g(matrix)f(with) │ │ │ │ │ h(random)f(n)n(um)n(b)r(ers)g(using)g(the)h Fi(drand)e │ │ │ │ │ Fj(ob)5 b(ject.)208 1737 y Fh(Err)l(or)30 b(che)l(cking:)38 │ │ │ │ │ b Fj(If)28 b Fi(mtx)f Fj(or)g Fi(drand)e Fj(is)j Fi(NULL)p │ │ │ │ │ Fj(,)e(an)h(error)f(message)g(is)h(prin)n(ted)h(and)f(the)h(program)e │ │ │ │ │ (exits.)60 1906 y(12.)41 b Fi(void)g(DenseMtx_checksum)o(s)d(\()43 │ │ │ │ │ @@ -4248,17 +4240,17 @@ │ │ │ │ │ Fj(in)n(to)j(ro)n(w)e Fi(irow)g Fj(of)i(matrix)f Fi(mtx)p │ │ │ │ │ Fj(.)208 5308 y Fh(Err)l(or)j(che)l(cking:)39 b Fj(If)28 │ │ │ │ │ b Fi(mtx)e Fj(or)h Fi(vec)f Fj(is)i Fi(NULL)p Fj(,)e(or)h(if)h │ │ │ │ │ Fi(irow)22 b Fb(<)g Fj(0)28 b(or)e Fi(irow)c Fa(\025)h │ │ │ │ │ Fi(nrow)n Fj(,)28 b(an)f(error)f(message)g(is)i(prin)n(ted)f(and)208 │ │ │ │ │ 5407 y(the)h(program)d(exits.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 83 100 1118 4 v 1283 100 a Fi(DenseMtx)24 │ │ │ │ │ -b Fe(:)37 b Fh(DRAFT)111 b Fe(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1118 w Fj(7)0 390 y Fc(1.2.5)112 b(IO)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1135 4 v 1301 100 a Fi(DenseMtx)24 │ │ │ │ │ +b Fe(:)37 b Fh(DRAFT)110 b Fe(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2726 100 V 1135 w Fj(7)0 390 y Fc(1.2.5)112 b(IO)38 b(metho)s(ds)0 │ │ │ │ │ 573 y Fj(The)23 b(\014le)g(structure)f(of)h(a)g Fi(DenseMtx)c │ │ │ │ │ Fj(ob)5 b(ject)23 b(is)g(simple.)35 b(First)23 b(comes)f(sev)n(en)g │ │ │ │ │ (scalars,)g Fi(type)p Fj(,)h Fi(rowid)p Fj(,)e Fi(colid)p │ │ │ │ │ Fj(,)h Fi(nrow)p Fj(,)h Fi(ncol)p Fj(,)0 672 y Fi(inc1)g │ │ │ │ │ Fj(and)h Fi(inc2)p Fj(,)f(follo)n(w)n(ed)g(b)n(y)h(the)h(ro)n(w)e │ │ │ │ │ (indices,)i(follo)n(w)n(ed)e(b)n(y)h(the)g(column)g(indices,)h(and)f │ │ │ │ │ (then)h(follo)n(w)n(ed)e(b)n(y)h(the)h(matrix)0 772 y(en)n(tries.)101 │ │ │ │ │ @@ -4345,22 +4337,21 @@ │ │ │ │ │ 5270 y Fj(This)27 b(metho)r(d)h(writes)f(a)h Fi(DenseMtx)c │ │ │ │ │ Fj(ob)5 b(ject)27 b(to)h(a)f(\014le)h(in)g(an)f(easily)g(readable)f │ │ │ │ │ (format.)208 5407 y Fh(Err)l(or)k(che)l(cking:)38 b Fj(If)28 │ │ │ │ │ b Fi(mtx)f Fj(or)g Fi(fp)f Fj(are)h Fi(NULL)p Fj(,)f(an)h(error)f │ │ │ │ │ (message)g(is)i(prin)n(ted)f(and)h(zero)e(is)i(returned.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fj(8)p 125 100 1118 4 v │ │ │ │ │ -1283 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)27 b Fe(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2783 100 V 101 390 a Fj(9.)42 │ │ │ │ │ -b Fi(void)f(DenseMtx_writeFor)o(Mat)o(la)o(b)d(\()43 │ │ │ │ │ -b(DenseMtx)d(*mtx,)i(char)f(*mtxname,)f(FILE)i(*fp)h(\))g(;)208 │ │ │ │ │ -523 y Fj(This)27 b(metho)r(d)h(writes)f(out)h(a)f Fi(DenseMtx)e │ │ │ │ │ -Fj(ob)5 b(ject)27 b(to)g(a)h(\014le)f(in)h(a)f(Matlab)h(format.)36 │ │ │ │ │ -b(A)28 b(sample)f(line)h(is)208 722 y Fi(a\(10,5\))40 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fj(8)p 125 100 1135 4 v │ │ │ │ │ +1300 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)28 b Fe(Jan)n(uary)d(7,)i │ │ │ │ │ +(2024)p 2766 100 V 101 390 a Fj(9.)42 b Fi(void)f(DenseMtx_writeFor)o │ │ │ │ │ +(Mat)o(la)o(b)d(\()43 b(DenseMtx)d(*mtx,)i(char)f(*mtxname,)f(FILE)i │ │ │ │ │ +(*fp)h(\))g(;)208 523 y Fj(This)27 b(metho)r(d)h(writes)f(out)h(a)f │ │ │ │ │ +Fi(DenseMtx)e Fj(ob)5 b(ject)27 b(to)g(a)h(\014le)f(in)h(a)f(Matlab)h │ │ │ │ │ +(format.)36 b(A)28 b(sample)f(line)h(is)208 722 y Fi(a\(10,5\))40 │ │ │ │ │ b(=)87 b(-1.550328201511e)o(-01)37 b(+)130 b(1.848033378871e+)o(00*)o │ │ │ │ │ (i)37 b(;)208 922 y Fj(for)27 b(complex)g(matrices,)g(or)208 │ │ │ │ │ 1121 y Fi(a\(10,5\))40 b(=)87 b(-1.550328201511e)o(-01)37 │ │ │ │ │ b(;)208 1320 y Fj(for)27 b(real)g(matrices,)h(where)f(m)n(txname)h(=)g │ │ │ │ │ Fi("a")p Fj(.)38 b(The)28 b(matrix)f(indices)h(come)g(from)g(the)g │ │ │ │ │ Fi(rowind[])d Fj(and)j Fi(colind[])208 1420 y Fj(v)n(ectors,)e(and)h │ │ │ │ │ (are)g(incremen)n(ted)g(b)n(y)g(one)h(to)f(follo)n(w)g(the)h(Matlab)f │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -22,15 +22,15 @@ │ │ │ │ │ │ • double *entries : pointer to the base address of the double vector that contains the entries. │ │ │ │ │ │ • DV wrkDV : object that manages the owned working storage. │ │ │ │ │ │ • DenseMtx *next : link to a next object in a singly linked list. │ │ │ │ │ │ One can query the type of entries via two macros. │ │ │ │ │ │ • DENSEMTX IS REAL(mtx) returns 1 if the matrix has real entries, and 0 otherwise. │ │ │ │ │ │ • DENSEMTX IS COMPLEX(mtx) returns 1 if the matrix has complex entries, and 0 otherwise. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 DenseMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 DenseMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2 Prototypes and descriptions of DenseMtx methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the DenseMtx │ │ │ │ │ │ object. │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ Asusual, there are four basic methods to support object creation, setting default fields, clearing any allocated │ │ │ │ │ │ data, and free’ing the object. │ │ │ │ │ │ 1. DenseMtx * DenseMtx_new ( void ) ; │ │ │ │ │ │ @@ -58,15 +58,15 @@ │ │ │ │ │ │ 3. void DenseMtx_dimensions ( DenseMtx *mtx, int *pnrow, int *pncol ) ; │ │ │ │ │ │ This method fills *pnrow and *pncol with nrow and ncol. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. int DenseMtx_columnIncrement ( DenseMtx *mtx ) ; │ │ │ │ │ │ This method returns the row increment of the object, the difference in memory locations of two entries │ │ │ │ │ │ in consecutive columns in the same row. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - DenseMtx : DRAFT February 8, 2025 3 │ │ │ │ │ │ + DenseMtx : DRAFT January 7, 2024 3 │ │ │ │ │ │ 5. int DenseMtx_rowIncrement ( DenseMtx *mtx ) ; │ │ │ │ │ │ This method returns the row increment of the object, the difference in memory locations of two entries │ │ │ │ │ │ in consecutive rows in the same column. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 6. void DenseMtx_rowIndices ( DenseMtx *mtx, int *pnrow, **prowind ) ; │ │ │ │ │ │ This method fills *pnrow with nrow, the number of rows, and *prowind with rowind, a pointer to the │ │ │ │ │ │ row indices. │ │ │ │ │ │ @@ -97,15 +97,15 @@ │ │ │ │ │ │ message is printed and the program exits. │ │ │ │ │ │ 13. void DenseMtx_setComplexEntry ( DenseMtx *mtx, int irow, int jcol, │ │ │ │ │ │ double real, double imag ) ; │ │ │ │ │ │ This method sets the real and imaginary parts of the entry in row irow and column jcol to be │ │ │ │ │ │ (real,imag). │ │ │ │ │ │ Error checking: If mtx is NULL, or if the matrix is not complex, or if irow or jcol is out of range, an │ │ │ │ │ │ error message is printed and the program exits. │ │ │ │ │ │ - 4 DenseMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 DenseMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 14. int DenseMtx_row ( DenseMtx *mtx, int irow, double **prowent ) ; │ │ │ │ │ │ This method fills *prowent with the first location of the entries in row irow. │ │ │ │ │ │ Return codes: 1 is a normal return, -1 means mtx is NULL, -2 means invalid type for mtx, -3 means │ │ │ │ │ │ irow is out-of-range, -4 means prowent is NULL. │ │ │ │ │ │ 15. int DenseMtx_column ( DenseMtx *mtx, int jcol, double **pcolent ) ; │ │ │ │ │ │ This method fills *pcolent with the first location of the entries in column jcol. │ │ │ │ │ │ Return codes: 1 is a normal return, -1 means mtx is NULL, -2 means invalid type for mtx, -3 means │ │ │ │ │ │ @@ -139,15 +139,15 @@ │ │ │ │ │ │ 4. void DenseMtx_initFromBuffer ( DenseMtx *mtx ) ; │ │ │ │ │ │ This method initializes the object using information present in the workspace buffer. This method is │ │ │ │ │ │ used to initialize the DenseMtx object when it has been received as an MPI message. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 5. void DenseMtx_setA2 ( DenseMtx *mtx, A2 *a2 ) ; │ │ │ │ │ │ This method initializes the a2 object to point into the entries of the matrix. │ │ │ │ │ │ Error checking: If mtx or a2 is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - DenseMtx : DRAFT February 8, 2025 5 │ │ │ │ │ │ + DenseMtx : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.2.4 Utility methods │ │ │ │ │ │ 1. int DenseMtx_nbytesNeeded ( int type, int nrow, int ncol ) ; │ │ │ │ │ │ This method returns the number of bytes required to store the object’s information in its buffer. │ │ │ │ │ │ Error checking: If type is neither SPOOLES REAL nor SPOOLES COMPLEX, or if nrow or ncol is less than │ │ │ │ │ │ zero, an error message is printed and the program exits. │ │ │ │ │ │ 2. int DenseMtx_nbytesInWorkspace ( DenseMtx *mtx ) ; │ │ │ │ │ │ This method returns the number of bytes in the workspace owned by this object. │ │ │ │ │ │ @@ -180,15 +180,15 @@ │ │ │ │ │ │ 8. void DenseMtx_copyRowAndIndex ( DenseMtx *mtxB, int irowB, │ │ │ │ │ │ DenseMtx *mtxA, int irowA ) ; │ │ │ │ │ │ This method copies row irowA from matrix mtxA into row irowB of matrix mtxB, and copies the index │ │ │ │ │ │ of row irowA of mtxA into location irowB of the row indices for mtxB. │ │ │ │ │ │ Error checking: If mtxB is NULL, or if irowB is out of range, or if mtxA is NULL, or if irowA is out of │ │ │ │ │ │ range, or if the number of columns in mtxB and mtxA are not the same, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ - 6 DenseMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 DenseMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 9. void DenseMtx_addRow ( DenseMtx *mtxB, int irowB, DenseMtx *mtxA, int irowA ) ; │ │ │ │ │ │ This method adds row irowA from matrix mtxA into row irowB of matrix mtxB. │ │ │ │ │ │ Error checking: If mtxB is NULL, or if irowB is out of range, or if mtxA is NULL, or if irowA is out of │ │ │ │ │ │ range, or if the number of columns in mtxB and mtxA are not the same, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 10. void DenseMtx_zero ( DenseMtx *mtx ) ; │ │ │ │ │ │ This method zeros the entries in the matrix. │ │ │ │ │ │ @@ -219,15 +219,15 @@ │ │ │ │ │ │ This method copies vector vec[] into row irow of matrix mtx. │ │ │ │ │ │ Error checking: If mtx or vec is NULL, or if irow < 0 or irow ≥ nrow, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 18. double DenseMtx_addVectorIntoRow ( DenseMtx *mtx, int irow, double vec[] ) ; │ │ │ │ │ │ This method adds vector vec[] into row irow of matrix mtx. │ │ │ │ │ │ Error checking: If mtx or vec is NULL, or if irow < 0 or irow ≥ nrow, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ - DenseMtx : DRAFT February 8, 2025 7 │ │ │ │ │ │ + DenseMtx : DRAFT January 7, 2024 7 │ │ │ │ │ │ 1.2.5 IO methods │ │ │ │ │ │ Thefile structure of a DenseMtxobject is simple. First comes seven scalars, type, rowid, colid, nrow, ncol, │ │ │ │ │ │ inc1 and inc2, followed by the row indices, followed by the column indices, and then followed by the matrix │ │ │ │ │ │ entries. │ │ │ │ │ │ 1. int DenseMtx_readFromFile ( DenseMtx *mtx, char *fn ) ; │ │ │ │ │ │ This method reads an DenseMtx object from a file. If the the file can be opened successfully, the │ │ │ │ │ │ method calls DenseMtx readFromFormattedFile() or DenseMtx readFromBinaryFile(), closes the │ │ │ │ │ │ @@ -258,15 +258,15 @@ │ │ │ │ │ │ Error checking: If mtx or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 7. int DenseMtx_writeStats ( DenseMtx *mtx, FILE *fp ) ; │ │ │ │ │ │ This method writes out a header and statistics to a file. The value 1 is returned. │ │ │ │ │ │ Error checking: If mtx or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 8. void DenseMtx_writeForHumanEye ( DenseMtx *mtx, FILE *fp ) ; │ │ │ │ │ │ This method writes a DenseMtx object to a file in an easily readable format. │ │ │ │ │ │ Error checking: If mtx or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - 8 DenseMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 DenseMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 9. void DenseMtx_writeForMatlab ( DenseMtx *mtx, char *mtxname, FILE *fp ) ; │ │ │ │ │ │ This method writes out a DenseMtx object to a file in a Matlab format. A sample line is │ │ │ │ │ │ a(10,5) = -1.550328201511e-01 + 1.848033378871e+00*i ; │ │ │ │ │ │ for complex matrices, or │ │ │ │ │ │ a(10,5) = -1.550328201511e-01 ; │ │ │ │ │ │ for real matrices, where mtxname = "a". The matrix indices come from the rowind[] and colind[] │ │ │ │ │ │ vectors, and are incremented by one to follow the Matlab and FORTRAN convention. │ │ │ ├── ./usr/share/doc/spooles-doc/Drand.ps.gz │ │ │ │ ├── Drand.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Drand.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1720,21 +1720,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1918,88 +1917,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3610,16 +3604,16 @@ │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 234[71 71 20[{}2 90.9091 /CMSY10 rf /Fb 133[50 │ │ │ │ │ 59 4[44 44 46 2[56 62 93 31 2[31 62 2[51 62 50 1[54 11[86 │ │ │ │ │ 11[42 6[80 14[56 56 56 2[31 46[{}22 99.6264 /CMBX12 rf │ │ │ │ │ /Fc 138[49 30 37 38 1[46 46 51 2[42 1[28 46 42 1[42 46 │ │ │ │ │ 42 1[46 12[65 1[66 11[59 62 69 2[68 6[28 58[{}22 90.9091 │ │ │ │ │ -/CMTI10 rf /Fd 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 │ │ │ │ │ -1[45 2[45 2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf /Fe │ │ │ │ │ +/CMTI10 rf /Fd 134[48 3[51 2[36 3[51 12[45 22[47 15[25 │ │ │ │ │ +2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf /Fe │ │ │ │ │ 141[62 3[62 9[62 2[62 28[62 68[{}5 119.552 /CMTT12 rf │ │ │ │ │ %DVIPSBitmapFont: Ff tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ @@ -3711,32 +3705,31 @@ │ │ │ │ │ b(ject,)31 b(uniform)e(is)i Fh(1)p Fj(,)f(normal)g(is)h │ │ │ │ │ Fh(2)0 5064 y Fg(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g │ │ │ │ │ (of)g Fe(Drand)e Fg(metho)t(ds)0 5294 y Fj(This)e(section)j(con)m │ │ │ │ │ (tains)f(brief)f(descriptions)g(including)f(protot)m(yp)s(es)i(of)f │ │ │ │ │ (all)h(metho)s(ds)f(that)h(b)s(elong)f(to)h(the)0 5407 │ │ │ │ │ y Fh(Drand)29 b Fj(ob)5 b(ject.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fh(Drand)29 b Fd(:)40 b Fc(DRAFT)31 b Fd(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 0 399 a Fb(1.2.1)112 │ │ │ │ │ -b(Basic)38 b(metho)s(ds)0 602 y Fj(As)d(usual,)h(there)f(are)g(four)f │ │ │ │ │ -(basic)h(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 │ │ │ │ │ -b(creation,)i(setting)e(default)f(\014elds,)h(clearing)0 │ │ │ │ │ -715 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h(the)g(ob)5 │ │ │ │ │ -b(ject.)111 972 y(1.)46 b Fh(Drand)h(*)g(Drand_new)e(\()j(void)e(\))i │ │ │ │ │ -(;)227 1130 y Fj(This)28 b(metho)s(d)g(simply)h(allo)s(cates)i(storage) │ │ │ │ │ -f(for)e(the)h Fh(Drand)f Fj(structure)g(and)g(then)g(sets)i(the)f │ │ │ │ │ -(default)f(\014elds)227 1243 y(b)m(y)j(a)f(call)i(to)f │ │ │ │ │ -Fh(Drand)p 953 1243 29 4 v 33 w(setDefaultFields\(\))p │ │ │ │ │ -Fj(.)111 1446 y(2.)46 b Fh(void)h(Drand_setDefaultFields)42 │ │ │ │ │ -b(\()47 b(Drand)f(*drand)h(\))g(;)227 1604 y Fj(This)30 │ │ │ │ │ -b(metho)s(d)g(sets)g(the)h(structure's)f(\014elds)g(to)h(default)g(v)-5 │ │ │ │ │ -b(alues.)227 1848 y Fh(drand->seed1)45 b(=)95 b(123456789.0)45 │ │ │ │ │ -b(;)i(drand->seed2)e(=)95 b(987654321.0)44 b(;)227 1961 │ │ │ │ │ -y(drand->base1)h(=)i(2147483563.0)e(;)i(drand->base2)e(=)i │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fh(Drand)29 b Fd(:)40 b Fc(DRAFT)31 b Fd(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 0 399 a Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +602 y Fj(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ +(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ +(\014elds,)h(clearing)0 715 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ +(free'ing)h(the)g(ob)5 b(ject.)111 972 y(1.)46 b Fh(Drand)h(*)g │ │ │ │ │ +(Drand_new)e(\()j(void)e(\))i(;)227 1130 y Fj(This)28 │ │ │ │ │ +b(metho)s(d)g(simply)h(allo)s(cates)i(storage)f(for)e(the)h │ │ │ │ │ +Fh(Drand)f Fj(structure)g(and)g(then)g(sets)i(the)f(default)f(\014elds) │ │ │ │ │ +227 1243 y(b)m(y)j(a)f(call)i(to)f Fh(Drand)p 953 1243 │ │ │ │ │ +29 4 v 33 w(setDefaultFields\(\))p Fj(.)111 1446 y(2.)46 │ │ │ │ │ +b Fh(void)h(Drand_setDefaultFields)42 b(\()47 b(Drand)f(*drand)h(\))g │ │ │ │ │ +(;)227 1604 y Fj(This)30 b(metho)s(d)g(sets)g(the)h(structure's)f │ │ │ │ │ +(\014elds)g(to)h(default)g(v)-5 b(alues.)227 1848 y Fh(drand->seed1)45 │ │ │ │ │ +b(=)95 b(123456789.0)45 b(;)i(drand->seed2)e(=)95 b(987654321.0)44 │ │ │ │ │ +b(;)227 1961 y(drand->base1)h(=)i(2147483563.0)e(;)i(drand->base2)e(=)i │ │ │ │ │ (2147483399.0)d(;)227 2074 y(drand->lower)h(=)477 b(0.0)47 │ │ │ │ │ b(;)g(drand->upper)e(=)477 b(1.0)46 b(;)227 2187 y(drand->mean)93 │ │ │ │ │ b(=)477 b(0.0)47 b(;)g(drand->sigma)e(=)477 b(1.0)46 │ │ │ │ │ b(;)227 2300 y(drand->mode)93 b(=)572 b(1)48 b(;)227 │ │ │ │ │ 2544 y Fj(The)30 b(default)h(mo)s(de)f(is)g(a)h(uniform)e(distribution) │ │ │ │ │ h(on)g Fh([0,1])p Fj(.)227 2702 y Fc(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fj(If)30 b Fh(drand)f Fj(is)i Fh(NULL)p │ │ │ │ │ @@ -3770,17 +3763,17 @@ │ │ │ │ │ (b)s(er)f(seeds)h(using)g(a)h(single)g(input)e(seed.)227 │ │ │ │ │ 5294 y Fc(Err)-5 b(or)30 b(che)-5 b(cking:)38 b Fj(If)25 │ │ │ │ │ b Fh(drand)f Fj(is)h Fh(NULL)p Fj(,)g(or)h(if)f Fh(seed1)f │ │ │ │ │ Fa(\024)h Fj(0,)i(or)f(if)f Fh(seed1)f Fa(\025)h Fj(2147483563,)31 │ │ │ │ │ b(an)26 b(error)f(message)227 5407 y(is)31 b(prin)m(ted)f(and)f(the)i │ │ │ │ │ (program)f(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1110 4 v 1291 100 a Fh(Drand)29 │ │ │ │ │ -b Fd(:)41 b Fc(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fj(3)111 399 y(3.)46 b Fh(void)h(Drand_setSeeds)d(\() │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1129 4 v 1310 100 a Fh(Drand)29 │ │ │ │ │ +b Fd(:)41 b Fc(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fj(3)111 399 y(3.)46 b Fh(void)h(Drand_setSeeds)d(\() │ │ │ │ │ j(Drand)g(*drand,)e(int)i(seed1,)f(int)h(seed2)g(\))g(;)227 │ │ │ │ │ 553 y Fj(This)30 b(metho)s(d)g(sets)g(the)h(random)f(n)m(um)m(b)s(er)f │ │ │ │ │ (seeds)h(using)g(t)m(w)m(o)i(input)d(seeds.)227 707 y │ │ │ │ │ Fc(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b Fh(drand)f │ │ │ │ │ Fj(is)i Fh(NULL)p Fj(,)e(an)h(error)g(message)i(is)e(prin)m(ted)g(and)g │ │ │ │ │ (the)h(program)f(exits.)227 862 y Fc(Err)-5 b(or)33 b(che)-5 │ │ │ │ │ b(cking:)39 b Fj(If)29 b Fh(drand)e Fj(is)i Fh(NULL)p │ │ │ │ │ @@ -3835,20 +3828,20 @@ │ │ │ │ │ Fh(n)47 b(<)h(0)f Fj(,)35 b(an)f(error)f(message)i(is)e(prin)m(ted)h │ │ │ │ │ (and)f(the)227 4852 y(program)d(exits.)0 5175 y Fg(1.3)135 │ │ │ │ │ b(Driv)l(er)46 b(programs)g(for)f(the)g Fe(Drand)d Fg(ob)7 │ │ │ │ │ b(ject)0 5407 y Fj(This)30 b(section)h(con)m(tains)h(brief)e │ │ │ │ │ (descriptions)g(of)g(the)h(driv)m(er)f(programs.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fh(Drand)29 b Fd(:)40 b Fc(DRAFT)31 b Fd(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 111 399 a Fj(1.)46 │ │ │ │ │ -b Fh(testDrand)g(msglvl)g(msgFile)f(distribution)g(param1)h(param2)g │ │ │ │ │ -(seed1)g(seed2)h(n)227 549 y Fj(This)30 b(driv)m(er)g(program)g(test)h │ │ │ │ │ -(the)g Fh(Drand)e Fj(random)g(n)m(um)m(b)s(er)h(generator.)337 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fh(Drand)29 b Fd(:)40 b Fc(DRAFT)31 b Fd(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 111 399 a Fj(1.)46 b Fh(testDrand)g(msglvl)g(msgFile)f │ │ │ │ │ +(distribution)g(param1)h(param2)g(seed1)g(seed2)h(n)227 │ │ │ │ │ +549 y Fj(This)30 b(driv)m(er)g(program)g(test)h(the)g │ │ │ │ │ +Fh(Drand)e Fj(random)g(n)m(um)m(b)s(er)h(generator.)337 │ │ │ │ │ 761 y Ff(\210)45 b Fj(The)30 b Fh(msglvl)f Fj(parameter)i(determines)f │ │ │ │ │ (the)h(amoun)m(t)f(of)h(output.)337 907 y Ff(\210)45 │ │ │ │ │ b Fj(The)33 b Fh(msgFile)e Fj(parameter)j(determines)f(the)h(message)g │ │ │ │ │ (\014le)f(|)h(if)f Fh(msgFile)e Fj(is)i Fh(stdout)p Fj(,)g(then)g(the) │ │ │ │ │ 427 1020 y(message)27 b(\014le)f(is)g Fc(stdout)p Fj(,)i(otherwise)e(a) │ │ │ │ │ h(\014le)f(is)f(op)s(ened)g(with)h Fc(app)-5 b(end)28 │ │ │ │ │ b Fj(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 1133 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -15,15 +15,15 @@ │ │ │ │ │ │ • double mean : mean for a normal distribution │ │ │ │ │ │ • double sigma : variation for a normal distribution │ │ │ │ │ │ • int mode: mode of the object, uniform is 1, normal is 2 │ │ │ │ │ │ 1.2 Prototypes and descriptions of Drand methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ Drand object. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Drand : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Drand : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. Drand * Drand_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the Drand structure and then sets the default fields │ │ │ │ │ │ by a call to Drand setDefaultFields(). │ │ │ │ │ │ 2. void Drand_setDefaultFields ( Drand *drand ) ; │ │ │ │ │ │ @@ -47,15 +47,15 @@ │ │ │ │ │ │ 1. void Drand_init ( Drand *drand ) ; │ │ │ │ │ │ This initializer simply sets the default fields with a call to Drand setDefaultFields(). │ │ │ │ │ │ Error checking: If drand is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. void Drand_setSeed ( Drand *drand, int seed1 ) ; │ │ │ │ │ │ This method sets the random number seeds using a single input seed. │ │ │ │ │ │ Error checking: If drand is NULL, or if seed1 ≤ 0, or if seed1 ≥ 2147483563, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ - Drand : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Drand : DRAFT January 7, 2024 3 │ │ │ │ │ │ 3. void Drand_setSeeds ( Drand *drand, int seed1, int seed2 ) ; │ │ │ │ │ │ This method sets the random number seeds using two input seeds. │ │ │ │ │ │ Error checking: If drand is NULL, an error message is printed and the program exits. │ │ │ │ │ │ Error checking: If drand is NULL, or if seed1 ≤ 0, or if seed1 ≥ 2147483563, or if seed2 ≤ 0, │ │ │ │ │ │ or if seed2 ≥ 2147483399, an error message is printed and the program exits. │ │ │ │ │ │ 4. void Drand_setNormal ( Drand *drand, double mean, double sigma ) ; │ │ │ │ │ │ This method sets the mode to be a normal distribution with mean mean and variation sigma. │ │ │ │ │ │ @@ -79,15 +79,15 @@ │ │ │ │ │ │ program exits. │ │ │ │ │ │ 4. void Drand_fillIvector ( Drand *drand, int n, int vec[] ) ; │ │ │ │ │ │ This method fills vec[] with n int random numbers. │ │ │ │ │ │ Error checking: If drand or vec are NULL or if n < 0 , an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 1.3 Driver programs for the Drand object │ │ │ │ │ │ This section contains brief descriptions of the driver programs. │ │ │ │ │ │ - 4 Drand : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Drand : DRAFT January 7, 2024 │ │ │ │ │ │ 1. testDrand msglvl msgFile distribution param1 param2 seed1 seed2 n │ │ │ │ │ │ This driver program test the Drand random number generator. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The distribution parameter specifies the mode of the object. If 1, the distribution is │ │ │ ├── ./usr/share/doc/spooles-doc/EGraph.ps.gz │ │ │ │ ├── EGraph.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o EGraph.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1406,21 +1406,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1604,88 +1603,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3905,16 +3899,16 @@ │ │ │ │ │ {restore}if │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 253[71 2[{}1 90.9091 /CMSY10 rf /Fb 133[50 │ │ │ │ │ 59 4[44 44 46 2[56 62 93 31 2[31 62 2[51 62 50 1[54 11[86 │ │ │ │ │ 5[84 5[42 6[80 13[56 56 56 56 2[31 46[{}24 99.6264 /CMBX12 │ │ │ │ │ rf /Fc 141[62 1[62 7[62 6[62 25[62 1[62 69[{}6 119.552 │ │ │ │ │ -/CMTT12 rf /Fd 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 │ │ │ │ │ -1[45 2[45 2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf │ │ │ │ │ +/CMTT12 rf /Fd 134[48 3[51 2[36 3[51 12[45 22[47 15[25 │ │ │ │ │ +2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf │ │ │ │ │ %DVIPSBitmapFont: Fe tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -4034,88 +4028,88 @@ │ │ │ │ │ (ts.)0 5294 y(A)37 b(correctly)i(initialized)g(and)d(non)m(trivial)i │ │ │ │ │ Fj(EGraph)e Fk(ob)5 b(ject)38 b(will)f(ha)m(v)m(e)i(p)s(ositiv)m(e)f │ │ │ │ │ Fj(nelem)e Fk(and)g Fj(nvtx)g Fk(v)-5 b(alues,)40 b(a)0 │ │ │ │ │ 5407 y(v)-5 b(alid)31 b Fj(adjIVL)d Fk(\014eld.)41 b(If)30 │ │ │ │ │ b Fj(type)46 b(=)i(1)p Fk(,)30 b(the)h Fj(vwghts)d Fk(will)j(b)s(e)f │ │ │ │ │ (non-)p Fj(NULL)p Fk(.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)30 b Fd(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 0 399 a Ff(1.2)135 │ │ │ │ │ -b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g Fc(EGraph)d │ │ │ │ │ -Ff(metho)t(ds)0 631 y Fk(This)f(section)j(con)m(tains)f(brief)f │ │ │ │ │ -(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f │ │ │ │ │ -(that)h(b)s(elong)f(to)h(the)0 744 y Fj(EGraph)29 b Fk(ob)5 │ │ │ │ │ -b(ject.)0 1025 y Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ -1226 y Fk(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ -(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ -(\014elds,)h(clearing)0 1339 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ -(free'ing)h(the)g(ob)5 b(ject.)111 1587 y(1.)46 b Fj(EGraph)g(*)i │ │ │ │ │ -(EGraph_new)d(\()i(void)g(\))g(;)227 1742 y Fk(This)25 │ │ │ │ │ -b(metho)s(d)g(simply)f(allo)s(cates)k(storage)f(for)e(the)h │ │ │ │ │ -Fj(EGraph)d Fk(structure)i(and)g(then)g(sets)g(the)h(default)f │ │ │ │ │ -(\014elds)227 1855 y(b)m(y)31 b(a)f(call)i(to)f Fj(EGraph)p │ │ │ │ │ -1001 1855 29 4 v 33 w(setDefaultFields\(\))p Fk(.)111 │ │ │ │ │ -2052 y(2.)46 b Fj(void)h(EGraph_setDefaultFields)41 b(\()48 │ │ │ │ │ -b(EGraph)e(*egraph)g(\))h(;)227 2206 y Fk(This)28 b(metho)s(d)f(sets)i │ │ │ │ │ -(the)f(structure's)g(\014elds)g(are)g(set)h(to)g(default)f(v)-5 │ │ │ │ │ -b(alues:)40 b Fj(type)47 b(=)g(nelem)f(=)i(nvtx)f(=)g(0)p │ │ │ │ │ -Fk(,)227 2319 y Fj(adjIVL)f(=)i(vwghts)e(=)h(NULL)p Fk(.)227 │ │ │ │ │ -2474 y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 │ │ │ │ │ -b Fj(egraph)f Fk(is)h Fj(NULL)g Fk(an)g(error)g(message)h(is)g(prin)m │ │ │ │ │ -(ted)f(and)f(the)i(program)f(exits.)111 2671 y(3.)46 │ │ │ │ │ -b Fj(void)h(EGraph_clearData)c(\()48 b(EGraph)e(*egraph)g(\))h(;)227 │ │ │ │ │ -2825 y Fk(This)25 b(metho)s(d)g(clears)i(data)g(and)e(releases)i(an)m │ │ │ │ │ -(y)f(storage)h(allo)s(cated)h(b)m(y)d(the)h(ob)5 b(ject.)41 │ │ │ │ │ -b(If)25 b Fj(egraph->adjIVL)227 2938 y Fk(is)c(not)f │ │ │ │ │ -Fj(NULL)p Fk(,)f(then)h Fj(IVL)p 1043 2938 V 34 w │ │ │ │ │ -(free\(egraph->adjIVL\))15 b Fk(is)20 b(called)h(to)h(free)e(the)g │ │ │ │ │ -Fj(IVL)g Fk(ob)5 b(ject.)38 b(If)20 b Fj(egraph->vwghts)227 │ │ │ │ │ -3051 y Fk(is)31 b(not)g Fj(NULL)p Fk(,)e(then)i Fj │ │ │ │ │ -(IVfree\(egraph->vwghts\))24 b Fk(is)31 b(called)g(to)h(free)e(the)h │ │ │ │ │ -Fj(int)f Fk(v)m(ector.)43 b(It)31 b(then)f(sets)h(the)227 │ │ │ │ │ -3164 y(structure's)f(default)h(\014elds)f(with)g(a)g(call)i(to)f │ │ │ │ │ -Fj(EGraph)p 2071 3164 V 33 w(setDefaultFields\(\))p Fk(.)227 │ │ │ │ │ -3319 y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 │ │ │ │ │ -b Fj(egraph)f Fk(is)h Fj(NULL)g Fk(an)g(error)g(message)h(is)g(prin)m │ │ │ │ │ -(ted)f(and)f(the)i(program)f(exits.)111 3516 y(4.)46 │ │ │ │ │ -b Fj(void)h(EGraph_free)e(\()i(EGraph)f(*egraph)g(\))h(;)227 │ │ │ │ │ -3670 y Fk(This)26 b(metho)s(d)f(releases)j(an)m(y)e(storage)i(b)m(y)e │ │ │ │ │ -(a)h(call)g(to)g Fj(EGraph)p 2317 3670 V 33 w(clearData\(\))c │ │ │ │ │ -Fk(then)j(free's)g(the)g(storage)i(for)227 3783 y(the)j(structure)f │ │ │ │ │ -(with)g(a)h(call)g(to)g Fj(free\(\))p Fk(.)227 3938 y │ │ │ │ │ -Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 b Fj(egraph)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)31 b Fd(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 0 399 a Ff(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ +b(and)f(descriptions)g(of)g Fc(EGraph)d Ff(metho)t(ds)0 │ │ │ │ │ +631 y Fk(This)f(section)j(con)m(tains)f(brief)f(descriptions)g │ │ │ │ │ +(including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f(that)h(b)s │ │ │ │ │ +(elong)f(to)h(the)0 744 y Fj(EGraph)29 b Fk(ob)5 b(ject.)0 │ │ │ │ │ +1025 y Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 1226 y │ │ │ │ │ +Fk(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g(supp)s │ │ │ │ │ +(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f(\014elds,)h │ │ │ │ │ +(clearing)0 1339 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h │ │ │ │ │ +(the)g(ob)5 b(ject.)111 1587 y(1.)46 b Fj(EGraph)g(*)i(EGraph_new)d(\() │ │ │ │ │ +i(void)g(\))g(;)227 1742 y Fk(This)25 b(metho)s(d)g(simply)f(allo)s │ │ │ │ │ +(cates)k(storage)f(for)e(the)h Fj(EGraph)d Fk(structure)i(and)g(then)g │ │ │ │ │ +(sets)g(the)h(default)f(\014elds)227 1855 y(b)m(y)31 │ │ │ │ │ +b(a)f(call)i(to)f Fj(EGraph)p 1001 1855 29 4 v 33 w │ │ │ │ │ +(setDefaultFields\(\))p Fk(.)111 2052 y(2.)46 b Fj(void)h │ │ │ │ │ +(EGraph_setDefaultFields)41 b(\()48 b(EGraph)e(*egraph)g(\))h(;)227 │ │ │ │ │ +2206 y Fk(This)28 b(metho)s(d)f(sets)i(the)f(structure's)g(\014elds)g │ │ │ │ │ +(are)g(set)h(to)g(default)f(v)-5 b(alues:)40 b Fj(type)47 │ │ │ │ │ +b(=)g(nelem)f(=)i(nvtx)f(=)g(0)p Fk(,)227 2319 y Fj(adjIVL)f(=)i │ │ │ │ │ +(vwghts)e(=)h(NULL)p Fk(.)227 2474 y Fg(Err)-5 b(or)34 │ │ │ │ │ +b(che)-5 b(cking:)40 b Fk(If)30 b Fj(egraph)f Fk(is)h │ │ │ │ │ +Fj(NULL)g Fk(an)g(error)g(message)h(is)g(prin)m(ted)f(and)f(the)i │ │ │ │ │ +(program)f(exits.)111 2671 y(3.)46 b Fj(void)h(EGraph_clearData)c(\()48 │ │ │ │ │ +b(EGraph)e(*egraph)g(\))h(;)227 2825 y Fk(This)25 b(metho)s(d)g(clears) │ │ │ │ │ +i(data)g(and)e(releases)i(an)m(y)f(storage)h(allo)s(cated)h(b)m(y)d │ │ │ │ │ +(the)h(ob)5 b(ject.)41 b(If)25 b Fj(egraph->adjIVL)227 │ │ │ │ │ +2938 y Fk(is)c(not)f Fj(NULL)p Fk(,)f(then)h Fj(IVL)p │ │ │ │ │ +1043 2938 V 34 w(free\(egraph->adjIVL\))15 b Fk(is)20 │ │ │ │ │ +b(called)h(to)h(free)e(the)g Fj(IVL)g Fk(ob)5 b(ject.)38 │ │ │ │ │ +b(If)20 b Fj(egraph->vwghts)227 3051 y Fk(is)31 b(not)g │ │ │ │ │ +Fj(NULL)p Fk(,)e(then)i Fj(IVfree\(egraph->vwghts\))24 │ │ │ │ │ +b Fk(is)31 b(called)g(to)h(free)e(the)h Fj(int)f Fk(v)m(ector.)43 │ │ │ │ │ +b(It)31 b(then)f(sets)h(the)227 3164 y(structure's)f(default)h │ │ │ │ │ +(\014elds)f(with)g(a)g(call)i(to)f Fj(EGraph)p 2071 3164 │ │ │ │ │ +V 33 w(setDefaultFields\(\))p Fk(.)227 3319 y Fg(Err)-5 │ │ │ │ │ +b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 b Fj(egraph)f │ │ │ │ │ Fk(is)h Fj(NULL)g Fk(an)g(error)g(message)h(is)g(prin)m(ted)f(and)f │ │ │ │ │ -(the)i(program)f(exits.)0 4219 y Fb(1.2.2)112 b(Initializer)38 │ │ │ │ │ -b(metho)s(ds)111 4420 y Fk(1.)46 b Fj(void)h(EGraph_init)e(\()i(EGraph) │ │ │ │ │ -f(*egraph,)g(int)h(type,)f(int)h(nelem,)f(int)h(nvtx,)1134 │ │ │ │ │ -4533 y(int)g(IVL_type)f(\))h(;)227 4688 y Fk(This)41 │ │ │ │ │ -b(metho)s(d)h(initializes)i(an)e Fj(EGraph)e Fk(ob)5 │ │ │ │ │ -b(ject)43 b(giv)m(en)g(the)f(t)m(yp)s(e)g(of)h(v)m(ertices,)j(n)m(um)m │ │ │ │ │ -(b)s(er)41 b(of)h(elemen)m(ts,)227 4801 y(n)m(um)m(b)s(er)g(of)h(v)m │ │ │ │ │ -(ertices,)49 b(and)42 b(storage)j(t)m(yp)s(e)e(for)g(the)h │ │ │ │ │ -Fj(IVL)e Fk(elemen)m(t)j(list)e(ob)5 b(ject.)80 b(It)44 │ │ │ │ │ -b(then)f(clears)h(an)m(y)227 4914 y(previous)39 b(data)i(with)e(a)h │ │ │ │ │ -(call)h(to)f Fj(EGraph)p 1706 4914 V 33 w(clearData\(\))p │ │ │ │ │ -Fk(.)65 b(The)39 b Fj(IVL)g Fk(ob)5 b(ject)40 b(is)g(initialized)h(b)m │ │ │ │ │ -(y)f(a)g(call)227 5027 y(to)35 b Fj(IVL)p 492 5027 V │ │ │ │ │ -33 w(init1\(\))p Fk(.)48 b(If)33 b Fj(type)47 b(=)g(1)p │ │ │ │ │ -Fk(,)35 b(the)e Fj(vwghts)f Fk(is)i(initialized)h(via)f(a)g(call)h(to)f │ │ │ │ │ -Fj(IVinit\(\))p Fk(.)48 b(See)34 b(the)g Fj(IVL)227 5140 │ │ │ │ │ -y Fk(ob)5 b(ject)32 b(for)e(a)g(description)h(of)f(the)h │ │ │ │ │ -Fj(IVL)p 1593 5140 V 33 w(type)f Fk(parameter.)227 5294 │ │ │ │ │ -y Fg(Err)-5 b(or)36 b(che)-5 b(cking:)45 b Fk(If)32 b │ │ │ │ │ -Fj(egraph)f Fk(is)i Fj(NULL)f Fk(or)g Fj(type)g Fk(is)h(not)g(zero)g │ │ │ │ │ -(or)g(one,)h(or)e(if)h(either)g Fj(nelem)e Fk(or)i Fj(nvtx)f │ │ │ │ │ -Fk(are)227 5407 y(nonp)s(ositiv)m(e,)f(an)g(error)f(message)h(is)g │ │ │ │ │ -(prin)m(ted)e(and)h(the)h(program)f(exits.)p eop end │ │ │ │ │ +(the)i(program)f(exits.)111 3516 y(4.)46 b Fj(void)h(EGraph_free)e(\()i │ │ │ │ │ +(EGraph)f(*egraph)g(\))h(;)227 3670 y Fk(This)26 b(metho)s(d)f │ │ │ │ │ +(releases)j(an)m(y)e(storage)i(b)m(y)e(a)h(call)g(to)g │ │ │ │ │ +Fj(EGraph)p 2317 3670 V 33 w(clearData\(\))c Fk(then)j(free's)g(the)g │ │ │ │ │ +(storage)i(for)227 3783 y(the)j(structure)f(with)g(a)h(call)g(to)g │ │ │ │ │ +Fj(free\(\))p Fk(.)227 3938 y Fg(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +b(cking:)40 b Fk(If)30 b Fj(egraph)f Fk(is)h Fj(NULL)g │ │ │ │ │ +Fk(an)g(error)g(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ +(exits.)0 4219 y Fb(1.2.2)112 b(Initializer)38 b(metho)s(ds)111 │ │ │ │ │ +4420 y Fk(1.)46 b Fj(void)h(EGraph_init)e(\()i(EGraph)f(*egraph,)g(int) │ │ │ │ │ +h(type,)f(int)h(nelem,)f(int)h(nvtx,)1134 4533 y(int)g(IVL_type)f(\))h │ │ │ │ │ +(;)227 4688 y Fk(This)41 b(metho)s(d)h(initializes)i(an)e │ │ │ │ │ +Fj(EGraph)e Fk(ob)5 b(ject)43 b(giv)m(en)g(the)f(t)m(yp)s(e)g(of)h(v)m │ │ │ │ │ +(ertices,)j(n)m(um)m(b)s(er)41 b(of)h(elemen)m(ts,)227 │ │ │ │ │ +4801 y(n)m(um)m(b)s(er)g(of)h(v)m(ertices,)49 b(and)42 │ │ │ │ │ +b(storage)j(t)m(yp)s(e)e(for)g(the)h Fj(IVL)e Fk(elemen)m(t)j(list)e │ │ │ │ │ +(ob)5 b(ject.)80 b(It)44 b(then)f(clears)h(an)m(y)227 │ │ │ │ │ +4914 y(previous)39 b(data)i(with)e(a)h(call)h(to)f Fj(EGraph)p │ │ │ │ │ +1706 4914 V 33 w(clearData\(\))p Fk(.)65 b(The)39 b Fj(IVL)g │ │ │ │ │ +Fk(ob)5 b(ject)40 b(is)g(initialized)h(b)m(y)f(a)g(call)227 │ │ │ │ │ +5027 y(to)35 b Fj(IVL)p 492 5027 V 33 w(init1\(\))p Fk(.)48 │ │ │ │ │ +b(If)33 b Fj(type)47 b(=)g(1)p Fk(,)35 b(the)e Fj(vwghts)f │ │ │ │ │ +Fk(is)i(initialized)h(via)f(a)g(call)h(to)f Fj(IVinit\(\))p │ │ │ │ │ +Fk(.)48 b(See)34 b(the)g Fj(IVL)227 5140 y Fk(ob)5 b(ject)32 │ │ │ │ │ +b(for)e(a)g(description)h(of)f(the)h Fj(IVL)p 1593 5140 │ │ │ │ │ +V 33 w(type)f Fk(parameter.)227 5294 y Fg(Err)-5 b(or)36 │ │ │ │ │ +b(che)-5 b(cking:)45 b Fk(If)32 b Fj(egraph)f Fk(is)i │ │ │ │ │ +Fj(NULL)f Fk(or)g Fj(type)g Fk(is)h(not)g(zero)g(or)g(one,)h(or)e(if)h │ │ │ │ │ +(either)g Fj(nelem)e Fk(or)i Fj(nvtx)f Fk(are)227 5407 │ │ │ │ │ +y(nonp)s(ositiv)m(e,)f(an)g(error)f(message)h(is)g(prin)m(ted)e(and)h │ │ │ │ │ +(the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1086 4 v 1267 100 a Fj(EGraph)29 │ │ │ │ │ -b Fd(:)41 b Fg(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2767 100 V 1086 w Fk(3)0 399 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1105 4 v 1287 100 a Fj(EGraph)28 │ │ │ │ │ +b Fd(:)41 b Fg(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2748 100 V 1105 w Fk(3)0 399 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ b(metho)s(ds)111 591 y Fk(1.)46 b Fj(Graph)h(EGraph_mkAdjGraph)c(\()k │ │ │ │ │ (EGraph)f(*egraph)g(\))i(;)227 736 y Fk(This)26 b(metho)s(d)h(creates)h │ │ │ │ │ (and)f(returns)f(a)h Fj(Graph)f Fk(ob)5 b(ject)27 b(with)g(v)m(ertex)h │ │ │ │ │ (adjacency)g(lists)g(from)e(the)h(elemen)m(t)227 849 │ │ │ │ │ y(graph)j(ob)5 b(ject.)227 995 y Fg(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fk(If)30 b Fj(egraph)f Fk(is)h Fj(NULL)p │ │ │ │ │ Fk(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g(the)g(program)g │ │ │ │ │ @@ -4187,37 +4181,37 @@ │ │ │ │ │ 5261 y(the)d(data,)h(the)f(v)-5 b(alue)30 b Fj(1)f Fk(is)h(returned.)39 │ │ │ │ │ b(If)29 b(an)h(IO)f(error)g(is)h(encoun)m(tered)g(from)f │ │ │ │ │ Fj(fread)p Fk(,)g(zero)h(is)g(returned.)227 5407 y Fg(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 b Fj(egraph)f │ │ │ │ │ Fk(or)h Fj(fp)g Fk(are)h Fj(NULL)e Fk(an)h(error)g(message)i(is)e(prin) │ │ │ │ │ m(ted)g(and)g(zero)h(is)g(returned.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)30 b Fd(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 111 399 a Fk(4.)46 │ │ │ │ │ -b Fj(int)h(EGraph_writeToFile)c(\()k(EGraph)g(*egraph,)e(char)i(*fn)g │ │ │ │ │ -(\))g(;)227 546 y Fk(This)29 b(metho)s(d)h(writes)g(an)g │ │ │ │ │ -Fj(EGraph)e Fk(ob)5 b(ject)31 b(to)g(a)f(\014le.)41 b(It)30 │ │ │ │ │ -b(tries)h(to)f(op)s(en)g(the)g(\014le)g(and)f(if)h(it)h(is)f │ │ │ │ │ -(successful,)227 658 y(it)25 b(then)e(calls)i Fj(EGraph)p │ │ │ │ │ -1002 658 29 4 v 33 w(writeFromFormattedFile\(\))17 b │ │ │ │ │ -Fk(or)24 b Fj(EGraph)p 2597 658 V 33 w(writeFromBinaryFile\(\))p │ │ │ │ │ -Fk(,)c(closes)227 771 y(the)31 b(\014le)f(and)g(returns)f(the)i(v)-5 │ │ │ │ │ -b(alue)31 b(returned)e(from)h(the)g(called)i(routine.)227 │ │ │ │ │ -918 y Fg(Err)-5 b(or)47 b(che)-5 b(cking:)66 b Fk(If)44 │ │ │ │ │ -b Fj(egraph)e Fk(or)h Fj(fn)g Fk(are)i Fj(NULL)p Fk(,)d(or)i(if)g │ │ │ │ │ -Fj(fn)f Fk(is)h(not)g(of)f(the)h(form)g Fj(*.egraphf)d │ │ │ │ │ -Fk(\(for)j(a)227 1031 y(formatted)32 b(\014le\))g(or)f │ │ │ │ │ -Fj(*.egraphb)e Fk(\(for)j(a)f(binary)g(\014le\),)h(an)f(error)g │ │ │ │ │ -(message)i(is)e(prin)m(ted)g(and)g(the)g(metho)s(d)227 │ │ │ │ │ -1144 y(returns)e(zero.)111 1325 y(5.)46 b Fj(int)h │ │ │ │ │ -(EGraph_writeToFormattedFi)o(le)42 b(\()47 b(EGraph)f(*egraph,)g(FILE)g │ │ │ │ │ -(*fp)h(\))h(;)227 1472 y Fk(This)27 b(metho)s(d)g(writes)g(an)g │ │ │ │ │ -Fj(EGraph)f Fk(ob)5 b(ject)28 b(to)g(a)g(formatted)g(\014le.)40 │ │ │ │ │ -b(If)27 b(there)g(are)h(no)f(errors)g(in)g(writing)h(the)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)31 b Fd(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 111 399 a Fk(4.)46 b Fj(int)h(EGraph_writeToFile)c │ │ │ │ │ +(\()k(EGraph)g(*egraph,)e(char)i(*fn)g(\))g(;)227 546 │ │ │ │ │ +y Fk(This)29 b(metho)s(d)h(writes)g(an)g Fj(EGraph)e │ │ │ │ │ +Fk(ob)5 b(ject)31 b(to)g(a)f(\014le.)41 b(It)30 b(tries)h(to)f(op)s(en) │ │ │ │ │ +g(the)g(\014le)g(and)f(if)h(it)h(is)f(successful,)227 │ │ │ │ │ +658 y(it)25 b(then)e(calls)i Fj(EGraph)p 1002 658 29 │ │ │ │ │ +4 v 33 w(writeFromFormattedFile\(\))17 b Fk(or)24 b Fj(EGraph)p │ │ │ │ │ +2597 658 V 33 w(writeFromBinaryFile\(\))p Fk(,)c(closes)227 │ │ │ │ │ +771 y(the)31 b(\014le)f(and)g(returns)f(the)i(v)-5 b(alue)31 │ │ │ │ │ +b(returned)e(from)h(the)g(called)i(routine.)227 918 y │ │ │ │ │ +Fg(Err)-5 b(or)47 b(che)-5 b(cking:)66 b Fk(If)44 b Fj(egraph)e │ │ │ │ │ +Fk(or)h Fj(fn)g Fk(are)i Fj(NULL)p Fk(,)d(or)i(if)g Fj(fn)f │ │ │ │ │ +Fk(is)h(not)g(of)f(the)h(form)g Fj(*.egraphf)d Fk(\(for)j(a)227 │ │ │ │ │ +1031 y(formatted)32 b(\014le\))g(or)f Fj(*.egraphb)e │ │ │ │ │ +Fk(\(for)j(a)f(binary)g(\014le\),)h(an)f(error)g(message)i(is)e(prin)m │ │ │ │ │ +(ted)g(and)g(the)g(metho)s(d)227 1144 y(returns)e(zero.)111 │ │ │ │ │ +1325 y(5.)46 b Fj(int)h(EGraph_writeToFormattedFi)o(le)42 │ │ │ │ │ +b(\()47 b(EGraph)f(*egraph,)g(FILE)g(*fp)h(\))h(;)227 │ │ │ │ │ +1472 y Fk(This)27 b(metho)s(d)g(writes)g(an)g Fj(EGraph)f │ │ │ │ │ +Fk(ob)5 b(ject)28 b(to)g(a)g(formatted)g(\014le.)40 b(If)27 │ │ │ │ │ +b(there)g(are)h(no)f(errors)g(in)g(writing)h(the)227 │ │ │ │ │ 1585 y(data,)k(the)e(v)-5 b(alue)31 b Fj(1)f Fk(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fj(fprintf)p Fk(,)f(zero)i(is)f(returned.)227 1732 y │ │ │ │ │ Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 b Fj(egraph)f │ │ │ │ │ Fk(or)h Fj(fp)g Fk(are)h Fj(NULL)e Fk(an)h(error)g(message)i(is)e(prin) │ │ │ │ │ m(ted)g(and)g(zero)h(is)g(returned.)111 1913 y(6.)46 │ │ │ │ │ b Fj(int)h(EGraph_writeToBinaryFile)41 b(\()48 b(EGraph)e(*egraph,)f │ │ │ │ │ @@ -4269,17 +4263,17 @@ │ │ │ │ │ y Fe(\210)45 b Fk(The)33 b Fj(msgFile)e Fk(parameter)j(determines)f │ │ │ │ │ (the)h(message)g(\014le)f(|)h(if)f Fj(msgFile)e Fk(is)i │ │ │ │ │ Fj(stdout)p Fk(,)g(then)g(the)427 5294 y(message)27 b(\014le)f(is)g │ │ │ │ │ Fg(stdout)p Fk(,)i(otherwise)e(a)h(\014le)f(is)f(op)s(ened)g(with)h │ │ │ │ │ Fg(app)-5 b(end)28 b Fk(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 │ │ │ │ │ 5407 y(data.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1086 4 v 1267 100 a Fj(EGraph)29 │ │ │ │ │ -b Fd(:)41 b Fg(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2767 100 V 1086 w Fk(5)337 399 y Fe(\210)45 b Fk(The)35 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1105 4 v 1287 100 a Fj(EGraph)28 │ │ │ │ │ +b Fd(:)41 b Fg(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2748 100 V 1105 w Fk(5)337 399 y Fe(\210)45 b Fk(The)35 │ │ │ │ │ b Fj(inFile)e Fk(parameter)i(is)g(the)h(input)e(\014le)h(for)f(the)h │ │ │ │ │ Fj(EGraph)f Fk(ob)5 b(ject.)55 b(It)35 b(m)m(ust)g(b)s(e)f(of)h(the)g │ │ │ │ │ (form)427 511 y Fj(*.egraphf)18 b Fk(or)i Fj(*.egraphb)p │ │ │ │ │ Fk(.)35 b(The)20 b Fj(EGraph)e Fk(ob)5 b(ject)22 b(is)e(read)g(from)g │ │ │ │ │ (the)g(\014le)h(via)g(the)f Fj(EGraph)p 3559 511 29 4 │ │ │ │ │ v 33 w(readFromFile\(\))427 624 y Fk(metho)s(d.)337 780 │ │ │ │ │ y Fe(\210)45 b Fk(The)25 b Fj(outFile)e Fk(parameter)j(is)f(the)h │ │ │ │ │ @@ -4351,26 +4345,26 @@ │ │ │ │ │ (b)s(e)g(greater)i(than)f(or)g(equal)g(to)427 5139 y(one.)337 │ │ │ │ │ 5294 y Fe(\210)45 b Fj(ncomp)26 b Fk(is)g(the)h(n)m(um)m(b)s(er)f(of)h │ │ │ │ │ (comp)s(onen)m(ts)f(\(i.e.,)k(the)c(n)m(um)m(b)s(er)g(of)h(degrees)g │ │ │ │ │ (of)g(freedom\))g(at)g(eac)m(h)h(grid)427 5407 y(p)s(oin)m(t,)j(m)m │ │ │ │ │ (ust)f(b)s(e)g(greater)h(than)g(or)f(equal)h(to)g(one.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fk(6)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)30 b Fd(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 337 399 a Fe(\210)45 │ │ │ │ │ -b Fk(The)20 b Fj(outEGraphFile)d Fk(parameter)j(is)h(the)f(output)g │ │ │ │ │ -(\014le)g(for)h(the)f Fj(EGraph)f Fk(ob)5 b(ject.)38 │ │ │ │ │ -b(If)20 b Fj(outEGraphFile)427 511 y Fk(is)h Fj(none)e │ │ │ │ │ -Fk(then)h(the)g Fj(EGraph)f Fk(ob)5 b(ject)21 b(is)f(not)h(written)f │ │ │ │ │ -(to)h(a)g(\014le.)37 b(Otherwise,)22 b(the)f Fj(EGraph)p │ │ │ │ │ -3409 511 29 4 v 33 w(writeToFile\(\))427 624 y Fk(metho)s(d)27 │ │ │ │ │ -b(is)h(called)h(to)f(write)g(the)g(ob)5 b(ject)29 b(to)f(a)g(formatted) │ │ │ │ │ -g(\014le)g(\(if)g Fj(outEGraphFile)c Fk(is)k(of)g(the)f(form)427 │ │ │ │ │ -737 y Fj(*.egraphf)p Fk(\),)i(or)h(a)h(binary)e(\014le)i(\(if)g │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fk(6)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)31 b Fd(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 337 399 a Fe(\210)45 b Fk(The)20 b │ │ │ │ │ +Fj(outEGraphFile)d Fk(parameter)j(is)h(the)f(output)g(\014le)g(for)h │ │ │ │ │ +(the)f Fj(EGraph)f Fk(ob)5 b(ject.)38 b(If)20 b Fj(outEGraphFile)427 │ │ │ │ │ +511 y Fk(is)h Fj(none)e Fk(then)h(the)g Fj(EGraph)f Fk(ob)5 │ │ │ │ │ +b(ject)21 b(is)f(not)h(written)f(to)h(a)g(\014le.)37 │ │ │ │ │ +b(Otherwise,)22 b(the)f Fj(EGraph)p 3409 511 29 4 v 33 │ │ │ │ │ +w(writeToFile\(\))427 624 y Fk(metho)s(d)27 b(is)h(called)h(to)f(write) │ │ │ │ │ +g(the)g(ob)5 b(ject)29 b(to)f(a)g(formatted)g(\014le)g(\(if)g │ │ │ │ │ +Fj(outEGraphFile)c Fk(is)k(of)g(the)f(form)427 737 y │ │ │ │ │ +Fj(*.egraphf)p Fk(\),)i(or)h(a)h(binary)e(\014le)i(\(if)g │ │ │ │ │ Fj(outEGraphFile)26 b Fk(is)31 b(of)f(the)h(form)f Fj(*.egraphb)p │ │ │ │ │ Fk(\).)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ TeXDict begin 7 6 bop 0 866 a Fl(Index)0 1289 y Fj(EGraph)p │ │ │ │ │ 294 1289 29 4 v 33 w(clearData\(\))p Fk(,)27 b(2)0 1402 │ │ │ │ │ y Fj(EGraph)p 294 1402 V 33 w(free\(\))p Fk(,)i(2)0 1515 │ │ │ │ │ y Fj(EGraph)p 294 1515 V 33 w(init\(\))p Fk(,)g(2)0 1628 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -21,15 +21,15 @@ │ │ │ │ │ │ • int nvtx : number of vertices in the graph │ │ │ │ │ │ • IVL *adjIVL : pointer to a IVL structure that holds the vertex lists for the elements. │ │ │ │ │ │ • int *vwghts : when type = 1, vwghts points to an int vector of size nvtx that holds the │ │ │ │ │ │ node weights. │ │ │ │ │ │ A correctly initialized and nontrivial EGraph object will have positive nelem and nvtx values, a │ │ │ │ │ │ valid adjIVL field. If type = 1, the vwghts will be non-NULL. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 EGraph : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 EGraph : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2 Prototypes and descriptions of EGraph methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ EGraph object. │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. EGraph * EGraph_new ( void ) ; │ │ │ │ │ │ @@ -55,15 +55,15 @@ │ │ │ │ │ │ This method initializes an EGraph object given the type of vertices, number of elements, │ │ │ │ │ │ number of vertices, and storage type for the IVL element list object. It then clears any │ │ │ │ │ │ previous data with a call to EGraph clearData(). The IVL object is initialized by a call │ │ │ │ │ │ to IVL init1(). If type = 1, the vwghts is initialized via a call to IVinit(). See the IVL │ │ │ │ │ │ object for a description of the IVL type parameter. │ │ │ │ │ │ Error checking: If egraph is NULL or type is not zero or one, or if either nelem or nvtx are │ │ │ │ │ │ nonpositive, an error message is printed and the program exits. │ │ │ │ │ │ - EGraph : DRAFT February 8, 2025 3 │ │ │ │ │ │ + EGraph : DRAFT January 7, 2024 3 │ │ │ │ │ │ 1.2.3 Utility methods │ │ │ │ │ │ 1. Graph EGraph_mkAdjGraph ( EGraph *egraph ) ; │ │ │ │ │ │ This method creates and returns a Graph object with vertex adjacency lists from the element │ │ │ │ │ │ graph object. │ │ │ │ │ │ Error checking: If egraph is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. EGraph * EGraph_make9P ( int n1, int n2, int ncomp ) ; │ │ │ │ │ │ This method creates and returns a EGraph object for a n1 × n2 grid for a 9-point operator │ │ │ │ │ │ @@ -92,15 +92,15 @@ │ │ │ │ │ │ This method reads in an EGraph object from a formatted file. If there are no errors in reading │ │ │ │ │ │ the data, the value 1 is returned. If an IO error is encountered from fscanf, zero is returned. │ │ │ │ │ │ Error checking: If egraph or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 3. int EGraph_readFromBinaryFile ( EGraph *egraph, FILE *fp ) ; │ │ │ │ │ │ This method reads in an EGraph object from a binary file. If there are no errors in reading │ │ │ │ │ │ the data, the value 1 is returned. If an IO error is encountered from fread, zero is returned. │ │ │ │ │ │ Error checking: If egraph or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ - 4 EGraph : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 EGraph : DRAFT January 7, 2024 │ │ │ │ │ │ 4. int EGraph_writeToFile ( EGraph *egraph, char *fn ) ; │ │ │ │ │ │ This method writes an EGraph object to a file. It tries to open the file and if it is successful, │ │ │ │ │ │ it then calls EGraph writeFromFormattedFile()or EGraph writeFromBinaryFile(),closes │ │ │ │ │ │ the file and returns the value returned from the called routine. │ │ │ │ │ │ Error checking: If egraph or fn are NULL, or if fn is not of the form *.egraphf (for a │ │ │ │ │ │ formatted file) or *.egraphb (for a binary file), an error message is printed and the method │ │ │ │ │ │ returns zero. │ │ │ │ │ │ @@ -128,15 +128,15 @@ │ │ │ │ │ │ binary files and vice versa. One can also read in a EGraph file and print out just the header │ │ │ │ │ │ information (see the EGraph writeStats() method). │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the EGraph object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ - EGraph : DRAFT February 8, 2025 5 │ │ │ │ │ │ + EGraph : DRAFT January 7, 2024 5 │ │ │ │ │ │ • The inFile parameter is the input file for the EGraph object. It must be of the form │ │ │ │ │ │ *.egraphfor*.egraphb. TheEGraphobjectisreadfromthefileviatheEGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The outFileparameter is the output file for the EGraph object. If outFile is none then │ │ │ │ │ │ the EGraphobject is not written to a file. Otherwise, the EGraph writeToFile()method │ │ │ │ │ │ is called to write the object to a formatted file (if outFile is of the form *.egraphf), │ │ │ │ │ │ or a binary file (if outFile is of the form *.egraphb). │ │ │ │ │ │ @@ -166,15 +166,15 @@ │ │ │ │ │ │ data. │ │ │ │ │ │ • n1 is the number of grid points in the first direction, must be greater than one. │ │ │ │ │ │ • n2 is the number of grid points in the second direction, must be greater than one. │ │ │ │ │ │ • n3 is the number of grid points in the third direction, must be greater than or equal to │ │ │ │ │ │ one. │ │ │ │ │ │ • ncomp is the number of components (i.e., the number of degrees of freedom) at each grid │ │ │ │ │ │ point, must be greater than or equal to one. │ │ │ │ │ │ - 6 EGraph : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 EGraph : DRAFT January 7, 2024 │ │ │ │ │ │ • TheoutEGraphFileparameteristheoutputfilefortheEGraphobject. IfoutEGraphFile │ │ │ │ │ │ is nonethentheEGraphobjectisnotwrittentoafile. Otherwise,theEGraph writeToFile() │ │ │ │ │ │ method is called to write the object to a formatted file (if outEGraphFile is of the form │ │ │ │ │ │ *.egraphf), or a binary file (if outEGraphFile is of the form *.egraphb). │ │ │ │ │ │ Index │ │ │ │ │ │ EGraph clearData(), 2 │ │ │ │ │ │ EGraph free(), 2 │ │ │ ├── ./usr/share/doc/spooles-doc/ETree.ps.gz │ │ │ │ ├── ETree.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o ETree.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -3606,21 +3606,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -3804,88 +3803,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5427,16 +5421,16 @@ │ │ │ │ │ /CMMI10 rf /Fh 133[50 59 3[62 44 44 46 1[62 56 62 93 │ │ │ │ │ 31 2[31 62 56 34 51 62 50 1[54 11[86 78 62 2[77 84 1[106 │ │ │ │ │ 2[58 42 5[81 80 8[56 56 56 56 56 56 56 56 56 56 1[31 │ │ │ │ │ 33[62 12[{}41 99.6264 /CMBX12 rf /Fi 141[62 12[62 16[62 │ │ │ │ │ 14[62 69[{}4 119.552 /CMTT12 rf /Fj 135[42 60 1[49 30 │ │ │ │ │ 37 38 1[46 46 51 74 23 42 1[28 46 42 1[42 46 42 42 46 │ │ │ │ │ 12[65 51 66 4[82 6[59 62 69 2[68 6[28 12[33 45[{}30 90.9091 │ │ │ │ │ -/CMTI10 rf /Fk 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 │ │ │ │ │ -1[45 2[45 2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf │ │ │ │ │ +/CMTI10 rf /Fk 134[48 3[51 2[36 3[51 12[45 22[47 15[25 │ │ │ │ │ +2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf │ │ │ │ │ %DVIPSBitmapFont: Fl tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -5549,31 +5543,30 @@ │ │ │ │ │ b Fo(:)i(p)s(oin)m(ter)h(to)g(an)f Fn(IV)g Fo(ob)5 b(ject)31 │ │ │ │ │ b(to)g(hold)f(fron)m(t)h(w)m(eigh)m(ts,)h(size)f Fn(nfront)137 │ │ │ │ │ 5294 y Fl(\210)45 b Fn(IV)i(*bndwghtsIV)28 b Fo(:)i(p)s(oin)m(ter)h(to) │ │ │ │ │ g(an)f Fn(IV)g Fo(ob)5 b(ject)31 b(to)g(hold)f(the)h(w)m(eigh)m(ts)g │ │ │ │ │ (of)g(the)f(fron)m(ts')h(b)s(oundaries,)e(size)227 5407 │ │ │ │ │ y Fn(nfront)1927 5656 y Fo(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 137 399 a Fl(\210)45 │ │ │ │ │ -b Fn(IV)i(*vtxToFrontIV)35 b Fo(:)j(p)s(oin)m(ter)h(to)g(an)f │ │ │ │ │ -Fn(IV)f Fo(ob)5 b(ject)39 b(to)g(hold)f(the)g(map)g(from)g(v)m(ertices) │ │ │ │ │ -i(to)f(fron)m(ts,)h(size)227 511 y Fn(nfront)0 727 y │ │ │ │ │ -Fo(A)d(correctly)i(initialized)g(and)d(non)m(trivial)i │ │ │ │ │ -Fn(ETree)e Fo(ob)5 b(ject)38 b(will)g(ha)m(v)m(e)g(p)s(ositiv)m(e)g │ │ │ │ │ -Fn(nfront)e Fo(and)g Fn(nvtx)g Fo(v)-5 b(alues,)40 b(a)0 │ │ │ │ │ -840 y(v)-5 b(alid)31 b Fn(tree)e Fo(\014eld)h(and)g(non-)p │ │ │ │ │ -Fn(NULL)f(nodwghtsIV)p Fo(,)e Fn(bndwghtsIV)h Fo(and)i │ │ │ │ │ -Fn(vtxToFrontIV)d Fo(p)s(oin)m(ters.)0 1155 y Fm(1.2)135 │ │ │ │ │ -b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g Fi(ETree)e │ │ │ │ │ -Fm(metho)t(ds)0 1385 y Fo(This)e(section)j(con)m(tains)f(brief)f │ │ │ │ │ -(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f │ │ │ │ │ -(that)h(b)s(elong)f(to)h(the)0 1497 y Fn(ETree)29 b Fo(ob)5 │ │ │ │ │ -b(ject.)0 1770 y Fh(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 137 399 a Fl(\210)45 b Fn(IV)i(*vtxToFrontIV)35 │ │ │ │ │ +b Fo(:)j(p)s(oin)m(ter)h(to)g(an)f Fn(IV)f Fo(ob)5 b(ject)39 │ │ │ │ │ +b(to)g(hold)f(the)g(map)g(from)g(v)m(ertices)i(to)f(fron)m(ts,)h(size) │ │ │ │ │ +227 511 y Fn(nfront)0 727 y Fo(A)d(correctly)i(initialized)g(and)d(non) │ │ │ │ │ +m(trivial)i Fn(ETree)e Fo(ob)5 b(ject)38 b(will)g(ha)m(v)m(e)g(p)s │ │ │ │ │ +(ositiv)m(e)g Fn(nfront)e Fo(and)g Fn(nvtx)g Fo(v)-5 │ │ │ │ │ +b(alues,)40 b(a)0 840 y(v)-5 b(alid)31 b Fn(tree)e Fo(\014eld)h(and)g │ │ │ │ │ +(non-)p Fn(NULL)f(nodwghtsIV)p Fo(,)e Fn(bndwghtsIV)h │ │ │ │ │ +Fo(and)i Fn(vtxToFrontIV)d Fo(p)s(oin)m(ters.)0 1155 │ │ │ │ │ +y Fm(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g │ │ │ │ │ +Fi(ETree)e Fm(metho)t(ds)0 1385 y Fo(This)e(section)j(con)m(tains)f │ │ │ │ │ +(brief)f(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h │ │ │ │ │ +(metho)s(ds)f(that)h(b)s(elong)f(to)h(the)0 1497 y Fn(ETree)29 │ │ │ │ │ +b Fo(ob)5 b(ject.)0 1770 y Fh(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ 1968 y Fo(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ (supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ (\014elds,)h(clearing)0 2081 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ (free'ing)h(the)g(ob)5 b(ject.)111 2322 y(1.)46 b Fn(ETree)h(*)g │ │ │ │ │ (ETree_new)e(\()j(void)e(\))i(;)227 2474 y Fo(This)28 │ │ │ │ │ b(metho)s(d)g(simply)h(allo)s(cates)i(storage)f(for)e(the)h │ │ │ │ │ Fn(ETree)f Fo(structure)g(and)g(then)g(sets)i(the)f(default)f(\014elds) │ │ │ │ │ @@ -5613,17 +5606,17 @@ │ │ │ │ │ b(metho)s(ds)111 5104 y Fo(1.)46 b Fn(int)h(ETree_nfront)e(\()i(ETree)f │ │ │ │ │ (*etree)h(\))g(;)227 5255 y Fo(This)30 b(metho)s(d)g(returns)f(the)h(n) │ │ │ │ │ m(um)m(b)s(er)f(of)i(fron)m(ts.)227 5407 y Fj(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b Fn(etree)f │ │ │ │ │ Fo(is)i Fn(NULL)p Fo(,)e(an)h(error)g(message)i(is)e(prin)m(ted)g(and)g │ │ │ │ │ (the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1110 4 v 1291 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)41 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fo(3)111 399 y(2.)46 b Fn(int)h(ETree_nvtx)e(\()j │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1129 4 v 1310 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)41 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fo(3)111 399 y(2.)46 b Fn(int)h(ETree_nvtx)e(\()j │ │ │ │ │ (ETree)e(*etree)g(\))i(;)227 556 y Fo(This)30 b(metho)s(d)g(returns)f │ │ │ │ │ (the)h(n)m(um)m(b)s(er)f(of)i(v)m(ertices.)227 713 y │ │ │ │ │ Fj(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b Fn(etree)f │ │ │ │ │ Fo(is)i Fn(NULL)p Fo(,)e(an)h(error)g(message)i(is)e(prin)m(ted)g(and)g │ │ │ │ │ (the)h(program)f(exits.)111 915 y(3.)46 b Fn(Tree)h(*)g(ETree_tree)e │ │ │ │ │ (\()j(ETree)e(*etree)g(\))i(;)227 1072 y Fo(This)30 b(metho)s(d)g │ │ │ │ │ (returns)f(a)i(p)s(oin)m(ter)f(to)h(the)g Fn(Tree)e Fo(ob)5 │ │ │ │ │ @@ -5671,30 +5664,30 @@ │ │ │ │ │ b(ETree)e(*etree)g(\))i(;)227 5250 y Fo(This)30 b(metho)s(d)g(returns)f │ │ │ │ │ (a)i(p)s(oin)m(ter)f(to)h(the)g Fn(bndwghtsIV)c Fo(ob)5 │ │ │ │ │ b(ject.)227 5407 y Fj(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fo(If)30 b Fn(etree)f Fo(is)i Fn(NULL)p Fo(,)e(an)h(error)g(message)i │ │ │ │ │ (is)e(prin)m(ted)g(and)g(the)h(program)f(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 66 399 a Fo(11.)46 │ │ │ │ │ -b Fn(int)h(*)h(ETree_bndwghts)c(\()j(ETree)f(*etree)g(\))i(;)227 │ │ │ │ │ -551 y Fo(This)30 b(metho)s(d)g(returns)f(a)i(p)s(oin)m(ter)f(to)h(the)g │ │ │ │ │ -Fn(bndwghts)d Fo(v)m(ector.)227 703 y Fj(Err)-5 b(or)32 │ │ │ │ │ -b(che)-5 b(cking:)39 b Fo(If)27 b Fn(etree)f Fo(or)i │ │ │ │ │ -Fn(etree->bndwghtsIV)23 b Fo(is)k Fn(NULL)p Fo(,)g(an)h(error)f │ │ │ │ │ -(message)i(is)e(prin)m(ted)h(and)f(the)227 816 y(program)j(exits.)66 │ │ │ │ │ -1008 y(12.)46 b Fn(IV)h(*)h(ETree_vtxToFrontIV)43 b(\()k(ETree)g │ │ │ │ │ -(*etree)f(\))h(;)227 1160 y Fo(This)30 b(metho)s(d)g(returns)f(a)i(p)s │ │ │ │ │ -(oin)m(ter)f(to)h(the)g Fn(vtxToFrontIV)c Fo(ob)5 b(ject.)227 │ │ │ │ │ -1312 y Fj(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ -b Fn(etree)f Fo(is)i Fn(NULL)p Fo(,)e(an)h(error)g(message)i(is)e(prin) │ │ │ │ │ -m(ted)g(and)g(the)h(program)f(exits.)66 1504 y(13.)46 │ │ │ │ │ -b Fn(int)h(*)h(ETree_vtxToFront)43 b(\()k(ETree)g(*etree)f(\))h(;)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 66 399 a Fo(11.)46 b Fn(int)h(*)h(ETree_bndwghts)c(\()j │ │ │ │ │ +(ETree)f(*etree)g(\))i(;)227 551 y Fo(This)30 b(metho)s(d)g(returns)f │ │ │ │ │ +(a)i(p)s(oin)m(ter)f(to)h(the)g Fn(bndwghts)d Fo(v)m(ector.)227 │ │ │ │ │ +703 y Fj(Err)-5 b(or)32 b(che)-5 b(cking:)39 b Fo(If)27 │ │ │ │ │ +b Fn(etree)f Fo(or)i Fn(etree->bndwghtsIV)23 b Fo(is)k │ │ │ │ │ +Fn(NULL)p Fo(,)g(an)h(error)f(message)i(is)e(prin)m(ted)h(and)f(the)227 │ │ │ │ │ +816 y(program)j(exits.)66 1008 y(12.)46 b Fn(IV)h(*)h │ │ │ │ │ +(ETree_vtxToFrontIV)43 b(\()k(ETree)g(*etree)f(\))h(;)227 │ │ │ │ │ +1160 y Fo(This)30 b(metho)s(d)g(returns)f(a)i(p)s(oin)m(ter)f(to)h(the) │ │ │ │ │ +g Fn(vtxToFrontIV)c Fo(ob)5 b(ject.)227 1312 y Fj(Err)-5 │ │ │ │ │ +b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b Fn(etree)f │ │ │ │ │ +Fo(is)i Fn(NULL)p Fo(,)e(an)h(error)g(message)i(is)e(prin)m(ted)g(and)g │ │ │ │ │ +(the)h(program)f(exits.)66 1504 y(13.)46 b Fn(int)h(*)h │ │ │ │ │ +(ETree_vtxToFront)43 b(\()k(ETree)g(*etree)f(\))h(;)227 │ │ │ │ │ 1656 y Fo(This)30 b(metho)s(d)g(returns)f(a)i(p)s(oin)m(ter)f(to)h(the) │ │ │ │ │ g Fn(vtxToFront)c Fo(v)m(ector.)227 1809 y Fj(Err)-5 │ │ │ │ │ b(or)36 b(che)-5 b(cking:)44 b Fo(If)31 b Fn(etree)g │ │ │ │ │ Fo(or)h Fn(etree->vtxToFrontIV)27 b Fo(is)32 b Fn(NULL)p │ │ │ │ │ Fo(,)g(an)g(error)f(message)j(is)e(prin)m(ted)g(and)227 │ │ │ │ │ 1922 y(the)f(program)f(exits.)66 2113 y(14.)46 b Fn(int)h │ │ │ │ │ (ETree_frontSize)d(\()j(ETree)g(*etree,)e(int)i(J)h(\))f(;)227 │ │ │ │ │ @@ -5739,17 +5732,17 @@ │ │ │ │ │ Fo(ob)5 b(ject)34 b(giv)m(en)g(the)f(n)m(um)m(b)s(er)f(of)h(fron)m(ts)g │ │ │ │ │ (and)f(n)m(um)m(b)s(er)g(of)h(v)m(ertices.)227 5407 y(An)m(y)26 │ │ │ │ │ b(previous)f(data)h(is)f(cleared)i(with)e(a)h(call)g(to)h │ │ │ │ │ Fn(ETree)p 2153 5407 V 33 w(clearData\(\))p Fo(,)c(The)i │ │ │ │ │ Fn(Tree)f Fo(ob)5 b(ject)27 b(is)e(initialized)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1110 4 v 1291 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)41 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fo(5)227 399 y(with)j(a)g(call)i(to)e │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1129 4 v 1310 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)41 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fo(5)227 399 y(with)j(a)g(call)i(to)e │ │ │ │ │ Fn(Tree)p 1000 399 29 4 v 34 w(init1\(\))p Fo(.)49 b(The)34 │ │ │ │ │ b Fn(nodwghtsIV)p Fo(,)d Fn(bndwghtsIV)h Fo(and)h Fn(vtxToFrontIV)e │ │ │ │ │ Fo(ob)5 b(jects)35 b(are)227 511 y(initialized)d(with)e(calls)h(to)g │ │ │ │ │ Fn(IV)p 1268 511 V 34 w(init\(\))p Fo(.)39 b(The)30 b(en)m(tries)h(in)f │ │ │ │ │ Fn(nodwghtsIV)d Fo(and)i Fn(bndwghtsIV)f Fo(are)i(set)h(to)g │ │ │ │ │ Fn(0)p Fo(,)227 624 y(while)g(the)f(en)m(tries)h(in)f │ │ │ │ │ Fn(vtxToFrontIV)d Fo(are)k(set)g(to)g Fn(-1)p Fo(.)227 │ │ │ │ │ @@ -5827,26 +5820,26 @@ │ │ │ │ │ 5294 y Fo(This)f(metho)s(d)g(initializes)j Fn(subtree)c │ │ │ │ │ Fo(from)h Fn(tree)f Fo(using)h(the)h(no)s(des)f(of)h │ │ │ │ │ Fn(etree)e Fo(that)i(are)g(found)e(in)227 5407 y Fn(nodeidsIV)p │ │ │ │ │ Fo(.)28 b(The)i(map)g(from)g(no)s(des)g(in)g Fn(subtree)e │ │ │ │ │ Fo(to)j(no)s(des)f(in)g Fn(etree)f Fo(is)h(returned)f(in)h │ │ │ │ │ Fn(vtxIV)p Fo(.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 227 399 a Fj(R)-5 │ │ │ │ │ -b(eturn)40 b(c)-5 b(o)g(de:)111 b Fo(1)38 b(for)f(a)h(normal)g(return,) │ │ │ │ │ -g(-1)h(if)e Fn(subtree)f Fo(is)h Fn(NULL)p Fo(,)g(-2)h(if)g │ │ │ │ │ -Fn(nodeidsIV)d Fo(is)i Fn(NULL)p Fo(,)g(-3)h(if)227 511 │ │ │ │ │ -y Fn(etree)29 b Fo(is)i Fn(NULL)p Fo(,)e(-4)i(if)f Fn(nodeidsIV)e │ │ │ │ │ -Fo(is)j(in)m(v)-5 b(alid,)31 b(-5)g(if)f Fn(vtxIV)f Fo(is)i │ │ │ │ │ -Fn(NULL)p Fo(.)0 809 y Fh(1.2.4)112 b(Utilit)m(y)38 b(metho)s(ds)0 │ │ │ │ │ -1015 y Fo(The)23 b(utilit)m(y)h(metho)s(ds)f(return)f(the)h(n)m(um)m(b) │ │ │ │ │ -s(er)f(of)h(b)m(ytes)h(tak)m(en)g(b)m(y)f(the)h(ob)5 │ │ │ │ │ -b(ject,)26 b(or)d(the)g(n)m(um)m(b)s(er)f(of)h(factor)i(indices,)0 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 227 399 a Fj(R)-5 b(eturn)40 b(c)-5 b(o)g(de:)111 │ │ │ │ │ +b Fo(1)38 b(for)f(a)h(normal)g(return,)g(-1)h(if)e Fn(subtree)f │ │ │ │ │ +Fo(is)h Fn(NULL)p Fo(,)g(-2)h(if)g Fn(nodeidsIV)d Fo(is)i │ │ │ │ │ +Fn(NULL)p Fo(,)g(-3)h(if)227 511 y Fn(etree)29 b Fo(is)i │ │ │ │ │ +Fn(NULL)p Fo(,)e(-4)i(if)f Fn(nodeidsIV)e Fo(is)j(in)m(v)-5 │ │ │ │ │ +b(alid,)31 b(-5)g(if)f Fn(vtxIV)f Fo(is)i Fn(NULL)p Fo(.)0 │ │ │ │ │ +809 y Fh(1.2.4)112 b(Utilit)m(y)38 b(metho)s(ds)0 1015 │ │ │ │ │ +y Fo(The)23 b(utilit)m(y)h(metho)s(ds)f(return)f(the)h(n)m(um)m(b)s(er) │ │ │ │ │ +f(of)h(b)m(ytes)h(tak)m(en)g(b)m(y)f(the)h(ob)5 b(ject,)26 │ │ │ │ │ +b(or)d(the)g(n)m(um)m(b)s(er)f(of)h(factor)i(indices,)0 │ │ │ │ │ 1128 y(en)m(tries)31 b(or)g(op)s(erations)f(required)g(b)m(y)g(the)h │ │ │ │ │ (ob)5 b(ject.)111 1391 y(1.)46 b Fn(int)h(ETree_sizeOf)e(\()i(ETree)f │ │ │ │ │ (*etree)h(\))g(;)227 1551 y Fo(This)24 b(metho)s(d)g(returns)f(the)h(n) │ │ │ │ │ m(um)m(b)s(er)f(of)h(b)m(ytes)h(tak)m(en)h(b)m(y)e(this)g(ob)5 │ │ │ │ │ b(ject)25 b(\(whic)m(h)g(includes)f(the)g(b)m(ytes)h(tak)m(en)227 │ │ │ │ │ 1664 y(b)m(y)31 b(the)f(in)m(ternal)h Fn(Tree)e Fo(structure\).)227 │ │ │ │ │ 1825 y Fj(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ @@ -5912,17 +5905,17 @@ │ │ │ │ │ b Fo(If)37 b Fn(etree)f Fo(or)h Fn(tree)g Fo(is)g Fn(NULL)p │ │ │ │ │ Fo(,)g(or)h(if)f Fn(nfront)f Fg(<)h Fo(1,)j(or)d(if)h │ │ │ │ │ Fn(symflag)e Fo(is)h(in)m(v)-5 b(alid,)40 b(or)e(if)227 │ │ │ │ │ 5407 y Fn(J)25 b Fg(<)g Fo(0,)31 b(or)g(if)f Fn(J)25 │ │ │ │ │ b Ff(\025)g Fn(nfront)n Fo(,)31 b(an)f(error)g(message)i(is)e(prin)m │ │ │ │ │ (ted)g(and)g(the)g(program)g(exits.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1110 4 v 1291 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)41 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fo(7)111 399 y(6.)46 b Fn(double)g │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1129 4 v 1310 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)41 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fo(7)111 399 y(6.)46 b Fn(double)g │ │ │ │ │ (ETree_nInternalOpsInFront)41 b(\()48 b(ETree)e(*etree,)g(int)h(type,)f │ │ │ │ │ (int)h(symflag,)f(int)h(J)g(\))g(;)227 554 y Fo(This)20 │ │ │ │ │ b(metho)s(d)f(returns)h(the)g(n)m(um)m(b)s(er)f(of)h(in)m(ternal)h(op)s │ │ │ │ │ (erations)g(p)s(erformed)e(b)m(y)h(fron)m(t)g Fn(J)g │ │ │ │ │ Fo(on)h(its)f(\(1)p Fg(;)15 b Fo(1\),)25 b(\(2)p Fg(;)15 │ │ │ │ │ b Fo(1\),)227 667 y(and)37 b(\(1)p Fg(;)15 b Fo(2\))38 │ │ │ │ │ b(blo)s(c)m(ks)g(during)d(a)j(factorization.)63 b(The)36 │ │ │ │ │ @@ -6008,25 +6001,24 @@ │ │ │ │ │ 39 b(The)27 b(map)f(from)227 5138 y(compressed)k(v)m(ertices)i(to)f │ │ │ │ │ (uncompressed)f(v)m(ertices)i(is)e(found)f(in)h(the)h │ │ │ │ │ Fn(eqmapIV)d Fo(ob)5 b(ject.)227 5294 y Fj(Err)-5 b(or)39 │ │ │ │ │ b(che)-5 b(cking:)50 b Fo(If)34 b Fn(etree)g Fo(or)h │ │ │ │ │ Fn(eqmapIV)e Fo(is)j Fn(NULL)p Fo(,)e(an)h(error)g(message)h(is)f(prin) │ │ │ │ │ m(ted)g(and)g(the)g(program)227 5407 y(exits.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 66 399 a Fo(12.)46 │ │ │ │ │ -b Fn(ETree)h(*)g(ETree_spliceTwoEtrees)42 b(\()48 b(ETree)e(*etree0,)f │ │ │ │ │ -(Graph)i(*graph,)f(IV)h(*mapIV,)f(ETree)g(*etree1)g(\))h(;)227 │ │ │ │ │ -562 y Fo(This)38 b(metho)s(d)h(creates)h(and)e(returns)g(an)h │ │ │ │ │ -Fn(ETree)e Fo(ob)5 b(ject)40 b(that)g(is)f(formed)f(b)m(y)h(splicing)g │ │ │ │ │ -(together)i(t)m(w)m(o)227 675 y(fron)m(t)28 b(trees,)h │ │ │ │ │ -Fn(etree0)c Fo(for)j(the)f(v)m(ertices)i(the)f(eliminated)g(domains,)g │ │ │ │ │ -Fn(etree1)e Fo(for)h(the)h(v)m(ertices)h(the)f(Sc)m(h)m(ur)227 │ │ │ │ │ -788 y(complemen)m(t.)43 b(The)30 b Fn(mapIV)f Fo(ob)5 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 66 399 a Fo(12.)46 b Fn(ETree)h(*)g(ETree_spliceTwoEtrees) │ │ │ │ │ +42 b(\()48 b(ETree)e(*etree0,)f(Graph)i(*graph,)f(IV)h(*mapIV,)f(ETree) │ │ │ │ │ +g(*etree1)g(\))h(;)227 562 y Fo(This)38 b(metho)s(d)h(creates)h(and)e │ │ │ │ │ +(returns)g(an)h Fn(ETree)e Fo(ob)5 b(ject)40 b(that)g(is)f(formed)f(b)m │ │ │ │ │ +(y)h(splicing)g(together)i(t)m(w)m(o)227 675 y(fron)m(t)28 │ │ │ │ │ +b(trees,)h Fn(etree0)c Fo(for)j(the)f(v)m(ertices)i(the)f(eliminated)g │ │ │ │ │ +(domains,)g Fn(etree1)e Fo(for)h(the)h(v)m(ertices)h(the)f(Sc)m(h)m(ur) │ │ │ │ │ +227 788 y(complemen)m(t.)43 b(The)30 b Fn(mapIV)f Fo(ob)5 │ │ │ │ │ b(ject)31 b(maps)f(v)m(ertices)i(to)g(domains)e(or)g(the)h(Sc)m(h)m(ur) │ │ │ │ │ f(complemen)m(t)i(|)e(if)h(the)227 901 y(en)m(try)g(is)f │ │ │ │ │ Fn(0)p Fo(,)h(the)f(v)m(ertex)i(is)e(in)g(the)h(Sc)m(h)m(ur)e │ │ │ │ │ (complemen)m(t,)j(otherwise)f(it)g(is)f(in)g(a)h(domain.)227 │ │ │ │ │ 1064 y Fj(Err)-5 b(or)35 b(che)-5 b(cking:)41 b Fo(If)31 │ │ │ │ │ b Fn(etree0)p Fo(,)e Fn(graph)p Fo(,)h Fn(mapIV)g Fo(or)g │ │ │ │ │ Fn(etree1)g Fo(is)h Fn(NULL)p Fo(,)f(an)h(error)f(message)i(is)f(prin)m │ │ │ │ │ @@ -6087,17 +6079,17 @@ │ │ │ │ │ b(che)-5 b(cking:)45 b Fo(If)32 b Fn(etree)f Fo(is)i │ │ │ │ │ Fn(NULL)p Fo(,)f(or)h(if)g Fn(nfront)28 b Fg(<)h Fo(1,)34 │ │ │ │ │ b(or)f(if)f Fn(nvtx)d Fg(<)g Fo(1,)34 b(or)f(if)g Fn(type)e │ │ │ │ │ Fo(or)i Fn(symflag)e Fo(is)227 5407 y(in)m(v)-5 b(alid,)31 │ │ │ │ │ b(an)g(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1110 4 v 1291 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)41 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fo(9)0 399 y Fh(1.2.6)112 b(Compression)39 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1129 4 v 1310 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)41 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fo(9)0 399 y Fh(1.2.6)112 b(Compression)39 │ │ │ │ │ b(metho)s(ds)0 604 y Fo(F)-8 b(requen)m(tly)30 b(an)f │ │ │ │ │ Fn(ETree)f Fo(ob)5 b(ject)30 b(will)g(need)e(to)i(b)s(e)f(compressed)g │ │ │ │ │ (in)f(some)i(manner.)40 b(Elimination)29 b(trees)h(usually)0 │ │ │ │ │ 717 y(ha)m(v)m(e)42 b(long)g(c)m(hains)g(of)f(v)m(ertices)i(at)f(the)f │ │ │ │ │ (higher)g(lev)m(els,)46 b(where)41 b(eac)m(h)h(c)m(hain)g(of)f(v)m │ │ │ │ │ (ertices)i(corresp)s(onds)d(to)i(a)0 830 y(sup)s(erno)s(de.)d(Liu's)30 │ │ │ │ │ b(generalized)i(ro)m(w)e(en)m(v)m(elop)s(e)i(metho)s(ds)e(partition)h │ │ │ │ │ @@ -6165,25 +6157,25 @@ │ │ │ │ │ b(then)j(returned.)227 5294 y Fj(Err)-5 b(or)35 b(che)-5 │ │ │ │ │ b(cking:)41 b Fo(If)31 b Fn(etree)e Fo(or)i Fn(tree)f │ │ │ │ │ Fo(is)h Fn(NULL)p Fo(,)f(or)h(if)g Fn(nfront)24 b Fg(<)i │ │ │ │ │ Fo(1,)32 b(or)f(if)g Fn(nvtx)25 b Fg(<)h Fo(1,)31 b(an)g(error)g │ │ │ │ │ (message)227 5407 y(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1087 4 │ │ │ │ │ -v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 111 399 a Fo(3.)46 │ │ │ │ │ -b Fn(ETree)h(*)g(ETree_compress)d(\()j(ETree)g(*etree,)f(IV)h │ │ │ │ │ -(*frontMapIV)e(\))i(;)227 562 y Fo(Using)41 b Fn(frontMapIV)p │ │ │ │ │ -Fo(,)d(a)j(new)f Fn(ETree)f Fo(ob)5 b(ject)41 b(is)g(created)g(and)f │ │ │ │ │ -(returned.)70 b(If)40 b Fn(frontMapIV)e Fo(do)s(es)i(not)227 │ │ │ │ │ -675 y(de\014ne)30 b(eac)m(h)i(in)m(v)m(erse)f(map)f(of)h(a)g(new)f(no)s │ │ │ │ │ -(de)g(to)h(b)s(e)f(connected)i(set)f(of)f(no)s(des)g(in)g(the)h(old)g │ │ │ │ │ -Fn(ETree)e Fo(ob)5 b(ject,)227 788 y(the)31 b(new)f Fn(ETree)f │ │ │ │ │ -Fo(ob)5 b(ject)31 b(will)g(not)f(b)s(e)g(w)m(ell)h(de\014ned.)227 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1106 4 │ │ │ │ │ +v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 111 399 a Fo(3.)46 b Fn(ETree)h(*)g(ETree_compress)d │ │ │ │ │ +(\()j(ETree)g(*etree,)f(IV)h(*frontMapIV)e(\))i(;)227 │ │ │ │ │ +562 y Fo(Using)41 b Fn(frontMapIV)p Fo(,)d(a)j(new)f │ │ │ │ │ +Fn(ETree)f Fo(ob)5 b(ject)41 b(is)g(created)g(and)f(returned.)70 │ │ │ │ │ +b(If)40 b Fn(frontMapIV)e Fo(do)s(es)i(not)227 675 y(de\014ne)30 │ │ │ │ │ +b(eac)m(h)i(in)m(v)m(erse)f(map)f(of)h(a)g(new)f(no)s(de)g(to)h(b)s(e)f │ │ │ │ │ +(connected)i(set)f(of)f(no)s(des)g(in)g(the)h(old)g Fn(ETree)e │ │ │ │ │ +Fo(ob)5 b(ject,)227 788 y(the)31 b(new)f Fn(ETree)f Fo(ob)5 │ │ │ │ │ +b(ject)31 b(will)g(not)f(b)s(e)g(w)m(ell)h(de\014ned.)227 │ │ │ │ │ 951 y Fj(Err)-5 b(or)37 b(che)-5 b(cking:)47 b Fo(If)33 │ │ │ │ │ b Fn(etree)g Fo(or)g Fn(frontMapIV)e Fo(is)j Fn(NULL)p │ │ │ │ │ Fo(,)f(or)g(if)h Fn(nfront)29 b Fg(<)i Fo(1,)k(or)f(if)f │ │ │ │ │ Fn(nvtx)d Fg(<)h Fo(1,)k(an)e(error)227 1064 y(message)f(is)e(prin)m │ │ │ │ │ (ted)g(and)g(the)g(program)h(exits.)0 1369 y Fh(1.2.7)112 │ │ │ │ │ b(Justi\014cation)38 b(metho)s(ds)0 1578 y Fo(Giv)m(en)g(an)g │ │ │ │ │ Fn(ETree)e Fo(ob)5 b(ject,)40 b(ho)m(w)e(should)e(the)i(c)m(hildren)f │ │ │ │ │ @@ -6239,17 +6231,17 @@ │ │ │ │ │ (ectiv)m(e)g Fn(Tree)e Fo(metho)s(ds.)227 5294 y Fj(Err)-5 │ │ │ │ │ b(or)31 b(che)-5 b(cking:)38 b Fo(If)26 b Fn(etree)e │ │ │ │ │ Fo(is)j Fn(NULL)p Fo(,)e(or)h(if)h Fn(nfront)c Fg(<)i │ │ │ │ │ Fo(1,)j(or)e(if)h Fn(nvtx)d Fg(<)h Fo(1,)i(an)g(error)f(message)h(is)f │ │ │ │ │ (prin)m(ted)227 5407 y(and)k(the)h(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(11)111 399 y(2.)46 b Fn(IV)h(*)h │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(11)111 399 y(2.)46 b Fn(IV)h(*)h │ │ │ │ │ (ETree_newToOldVtxPerm)42 b(\()47 b(ETree)g(*etree)f(\))h(;)227 │ │ │ │ │ 511 y(IV)g(*)h(ETree_oldToNewVtxPerm)42 b(\()47 b(ETree)g(*etree)f(\))h │ │ │ │ │ (;)227 663 y Fo(An)29 b Fn(IV)f Fo(ob)5 b(ject)30 b(is)g(created)g │ │ │ │ │ (with)f(size)h Fn(nvtx)p Fo(.)39 b(First)29 b(w)m(e)h(\014nd)d(a)j │ │ │ │ │ (new-to-old)g(p)s(erm)m(utation)f(of)g(the)h(fron)m(ts.)227 │ │ │ │ │ 776 y(Then)j(w)m(e)i(searc)m(h)f(o)m(v)m(er)h(the)g(fron)m(ts)f(in)f │ │ │ │ │ (their)h(new)g(order)f(to)i(\014ll)f(the)g(v)m(ertex)h(new-to-old)g(p)s │ │ │ │ │ @@ -6321,21 +6313,21 @@ │ │ │ │ │ b(Multisector)47 b(no)s(des)227 5294 y(ha)m(v)m(e)36 │ │ │ │ │ b(their)e(comp)s(onen)m(t)g(id)g(zero,)i(domain)e(no)s(des)f(ha)m(v)m │ │ │ │ │ (e)i(their)f(comp)s(onen)m(t)h(id)e(one.)52 b(Inclusion)34 │ │ │ │ │ b(in)g(the)227 5407 y(m)m(ultisector)g(is)e(based)f(on)h(the)g(n)m(um)m │ │ │ │ │ (b)s(er)e(of)i(factor)h(en)m(tries)g(in)e(the)i(subtree)e(that)h(a)h(v) │ │ │ │ │ m(ertex)g(b)s(elongs,)f(or)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 227 399 a Fo(strictly)36 │ │ │ │ │ -b(sp)s(eaking,)f(the)f(n)m(um)m(b)s(er)f(of)i(factor)g(en)m(tries)g(in) │ │ │ │ │ -f(the)g(subtree)g(of)g(the)h(fron)m(t)f(to)h(whic)m(h)f(a)h(v)m(ertex) │ │ │ │ │ -227 511 y(b)s(elongs.)63 b(If)37 b(w)m(eigh)m(t)i(of)f(the)g(subtree)g │ │ │ │ │ -(is)f(more)h(than)g Fn(cutoff)e Fo(times)i(the)g(n)m(um)m(b)s(er)e(of)i │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 227 399 a Fo(strictly)36 b(sp)s(eaking,)f(the)f(n)m │ │ │ │ │ +(um)m(b)s(er)f(of)i(factor)g(en)m(tries)g(in)f(the)g(subtree)g(of)g │ │ │ │ │ +(the)h(fron)m(t)f(to)h(whic)m(h)f(a)h(v)m(ertex)227 511 │ │ │ │ │ +y(b)s(elongs.)63 b(If)37 b(w)m(eigh)m(t)i(of)f(the)g(subtree)g(is)f │ │ │ │ │ +(more)h(than)g Fn(cutoff)e Fo(times)i(the)g(n)m(um)m(b)s(er)e(of)i │ │ │ │ │ (factor)h(en)m(tries,)227 624 y(the)31 b(v)m(ertex)h(is)f(in)g(the)g(m) │ │ │ │ │ m(ultisector.)44 b(The)31 b Fn(symflag)e Fo(parameter)i(can)g(b)s(e)f │ │ │ │ │ (one)i(of)f Fn(SPOOLES)p 3419 624 29 4 v 32 w(SYMMETRIC)p │ │ │ │ │ Fo(,)227 737 y Fn(SPOOLES)p 569 737 V 33 w(HERMITIAN)d │ │ │ │ │ Fo(or)i Fn(SPOOLES)p 1509 737 V 32 w(NONSYMMETRIC)p Fo(.)227 │ │ │ │ │ 905 y Fj(Err)-5 b(or)37 b(che)-5 b(cking:)47 b Fo(If)33 │ │ │ │ │ b Fn(etree)f Fo(is)h Fn(NULL)p Fo(,)g(or)h(if)f Fn(nfront)c │ │ │ │ │ @@ -6424,17 +6416,17 @@ │ │ │ │ │ b Fo(means)227 5127 y(that)31 b Fn(J)f Fo(is)h(in)f(domain)g │ │ │ │ │ Fn(compids[J])p Fo(.)227 5294 y Fj(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)41 b Fo(If)30 b Fn(etree)p Fo(,)g Fn(graph)f │ │ │ │ │ Fo(or)h Fn(symbfacIVL)e Fo(is)j Fn(NULL)p Fo(,)f(an)g(error)g(message)i │ │ │ │ │ (is)f(prin)m(ted)f(and)g(the)227 5407 y(program)g(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(13)0 399 y Fh(1.2.10)113 b(T)-9 │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(13)0 399 y Fh(1.2.10)113 b(T)-9 │ │ │ │ │ b(ransformation)38 b(metho)s(ds)0 592 y Fo(Often)g(the)h(elimination)h │ │ │ │ │ (tree)g(or)e(fron)m(t)h(tree)g(that)h(w)m(e)f(obtain)g(from)f(an)h │ │ │ │ │ (ordering)f(of)h(the)g(graph)f(is)h(not)g(as)0 705 y(appropriate)30 │ │ │ │ │ b(for)h(a)f(factorization)j(as)e(w)m(e)g(w)m(ould)f(lik)m(e.)42 │ │ │ │ │ b(There)30 b(are)h(t)m(w)m(o)g(imp)s(ortan)m(t)g(cases.)137 │ │ │ │ │ 898 y Fl(\210)45 b Fo(Near)h(the)g(lea)m(v)m(es)i(of)d(the)h(tree)g │ │ │ │ │ (the)g(fron)m(ts)f(are)h(t)m(ypically)i(small)e(in)f(size.)87 │ │ │ │ │ @@ -6523,31 +6515,31 @@ │ │ │ │ │ (recom-)0 5294 y(mend)32 b(\014rst)g(using)h Fn(ETree)p │ │ │ │ │ 927 5294 V 33 w(mergeFrontsOne\(\))c Fo(follo)m(w)m(ed)34 │ │ │ │ │ b(b)m(y)f Fn(ETree)p 2479 5294 V 33 w(mergeFrontsAll\(\))p │ │ │ │ │ Fo(.)45 b(See)33 b(the)g(driv)m(er)0 5407 y(programs)d │ │ │ │ │ Fn(testTransform)d Fo(and)j Fn(mkNDETree)d Fo(for)k(examples)f(of)h(ho) │ │ │ │ │ m(w)f(to)h(call)h(the)f(metho)s(ds.)p eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ -TeXDict begin 14 13 bop 0 100 a Fo(14)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 111 399 a Fo(1.)46 │ │ │ │ │ -b Fn(ETree)h(*)g(ETree_mergeFrontsOne)42 b(\()48 b(ETree)e(*etree,)g │ │ │ │ │ -(int)h(maxzeros,)e(IV)i(*nzerosIV)f(\))h(;)227 549 y │ │ │ │ │ -Fo(This)27 b(metho)s(d)g(only)g(tries)h(to)g(merge)g(a)g(fron)m(t)f │ │ │ │ │ -(with)g(its)h(only)f(c)m(hild.)40 b(It)28 b(returns)e(an)h │ │ │ │ │ -Fn(ETree)f Fo(ob)5 b(ject)28 b(where)227 662 y(one)34 │ │ │ │ │ -b(or)g(more)f(subtrees)g(that)h(con)m(tain)h(m)m(ultiple)f(fron)m(ts)g │ │ │ │ │ -(ha)m(v)m(e)g(b)s(een)f(merged)h(in)m(to)g(single)g(fron)m(ts.)50 │ │ │ │ │ -b(The)227 775 y(parameter)28 b(that)g(go)m(v)m(erns)g(the)f(merging)h │ │ │ │ │ -(pro)s(cess)f(is)g Fn(maxzeros)p Fo(,)e(the)j(n)m(um)m(b)s(er)e(of)h │ │ │ │ │ -(zero)h(en)m(tries)g(that)g(can)227 888 y(b)s(e)36 b(in)m(tro)s(duced)f │ │ │ │ │ -(b)m(y)h(merging)h(a)f(c)m(hild)h(and)e(paren)m(t)h(fron)m(t)h │ │ │ │ │ -(together.)59 b(On)35 b(input,)i Fn(nzerosIV)d Fo(con)m(tains)227 │ │ │ │ │ -1001 y(the)d(n)m(um)m(b)s(er)e(of)i(zeros)g(presen)m(tly)g(in)f(eac)m │ │ │ │ │ -(h)i(fron)m(t.)41 b(It)31 b(is)f(mo)s(di\014ed)f(on)i(output)f(to)h │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fo(14)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 111 399 a Fo(1.)46 b Fn(ETree)h(*)g │ │ │ │ │ +(ETree_mergeFrontsOne)42 b(\()48 b(ETree)e(*etree,)g(int)h(maxzeros,)e │ │ │ │ │ +(IV)i(*nzerosIV)f(\))h(;)227 549 y Fo(This)27 b(metho)s(d)g(only)g │ │ │ │ │ +(tries)h(to)g(merge)g(a)g(fron)m(t)f(with)g(its)h(only)f(c)m(hild.)40 │ │ │ │ │ +b(It)28 b(returns)e(an)h Fn(ETree)f Fo(ob)5 b(ject)28 │ │ │ │ │ +b(where)227 662 y(one)34 b(or)g(more)f(subtrees)g(that)h(con)m(tain)h │ │ │ │ │ +(m)m(ultiple)f(fron)m(ts)g(ha)m(v)m(e)g(b)s(een)f(merged)h(in)m(to)g │ │ │ │ │ +(single)g(fron)m(ts.)50 b(The)227 775 y(parameter)28 │ │ │ │ │ +b(that)g(go)m(v)m(erns)g(the)f(merging)h(pro)s(cess)f(is)g │ │ │ │ │ +Fn(maxzeros)p Fo(,)e(the)j(n)m(um)m(b)s(er)e(of)h(zero)h(en)m(tries)g │ │ │ │ │ +(that)g(can)227 888 y(b)s(e)36 b(in)m(tro)s(duced)f(b)m(y)h(merging)h │ │ │ │ │ +(a)f(c)m(hild)h(and)e(paren)m(t)h(fron)m(t)h(together.)59 │ │ │ │ │ +b(On)35 b(input,)i Fn(nzerosIV)d Fo(con)m(tains)227 1001 │ │ │ │ │ +y(the)d(n)m(um)m(b)s(er)e(of)i(zeros)g(presen)m(tly)g(in)f(eac)m(h)i │ │ │ │ │ +(fron)m(t.)41 b(It)31 b(is)f(mo)s(di\014ed)f(on)i(output)f(to)h │ │ │ │ │ (corresp)s(ond)f(with)g(the)227 1114 y(new)g(fron)m(t)h(tree.)41 │ │ │ │ │ b(This)30 b(metho)s(d)f(only)i(tries)g(to)g(merge)g(a)f(fron)m(t)h │ │ │ │ │ (with)f(its)h(only)f(c)m(hild.)227 1265 y Fj(Err)-5 b(or)31 │ │ │ │ │ b(che)-5 b(cking:)38 b Fo(If)26 b Fn(etree)e Fo(is)j │ │ │ │ │ Fn(NULL)p Fo(,)e(or)h(if)h Fn(nfront)c Fg(<)i Fo(1,)j(or)e(if)h │ │ │ │ │ Fn(nvtx)d Fg(<)h Fo(1,)i(an)g(error)f(message)h(is)f(prin)m(ted)227 │ │ │ │ │ 1377 y(and)k(the)h(program)f(exits.)111 1566 y(2.)46 │ │ │ │ │ @@ -6613,17 +6605,17 @@ │ │ │ │ │ b(or)f(if)f Fn(maxfrontsize)26 b Ff(\024)i Fo(0,)227 │ │ │ │ │ 5106 y(an)j(error)f(message)h(is)f(prin)m(ted)g(and)g(the)h(program)f │ │ │ │ │ (exits.)111 5294 y(5.)46 b Fn(ETree)h(*)g(ETree_transform)91 │ │ │ │ │ b(\()48 b(ETree)e(*etree,)g(int)h(vwghts[],)e(int)i(maxzeros,)1516 │ │ │ │ │ 5407 y(int)g(maxfrontsize,)d(int)j(seed)g(\))g(;)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(15)227 399 y Fn(ETree)47 b(*)g(ETree_transform2)c │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(15)227 399 y Fn(ETree)47 b(*)g(ETree_transform2)c │ │ │ │ │ (\()48 b(ETree)e(*etree,)g(int)h(vwghts[],)e(int)i(maxzeros,)1516 │ │ │ │ │ 511 y(int)g(maxfrontsize,)d(int)j(seed)g(\))g(;)227 675 │ │ │ │ │ y Fo(These)37 b(metho)s(ds)g(returns)f(an)i Fn(ETree)e │ │ │ │ │ Fo(ob)5 b(ject)38 b(where)f(one)h(or)f(more)h(subtrees)e(that)i(con)m │ │ │ │ │ (tain)h(m)m(ultiple)227 788 y(fron)m(ts)28 b(ha)m(v)m(e)g(b)s(een)f │ │ │ │ │ (merged)h(in)m(to)g(single)g(fron)m(ts)g(and)f(where)g(one)g(or)h(more) │ │ │ │ │ f(large)i(fron)m(ts)e(ha)m(v)m(e)i(b)s(een)e(split)227 │ │ │ │ │ @@ -6688,51 +6680,51 @@ │ │ │ │ │ 5181 y(assigned)i(to)f(all)h(pro)s(cessors.\))49 b(The)33 │ │ │ │ │ b(tree)h(is)f(then)g(visited)g(in)g(a)h(p)s(ost-order)e(tra)m(v)m │ │ │ │ │ (ersal,)k(and)d(eac)m(h)427 5294 y(fron)m(t)27 b(is)g(assigned)g(to)g │ │ │ │ │ (an)g(eligible)h(thread)e(or)h(pro)s(cessor)f(with)h(the)f(least)i(n)m │ │ │ │ │ (um)m(b)s(er)e(of)h(accum)m(ulated)427 5407 y(ops)j(so)h(far.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 16 16 │ │ │ │ │ -TeXDict begin 16 15 bop 0 100 a Fo(16)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 337 399 a Fl(\210)45 │ │ │ │ │ -b Fo(The)28 b Fj(domain)k(de)-5 b(c)g(omp)g(osition)34 │ │ │ │ │ -b(map)c Fo(is)e(also)h(complex,)h(where)e(domains)g(are)g(mapp)s(ed)f │ │ │ │ │ -(to)i(threads,)427 511 y(then)d(the)h(fron)m(ts)f(in)g(the)g(sc)m(h)m │ │ │ │ │ -(ur)g(complemen)m(t)i(are)e(mapp)s(ed)f(to)i(threads,)g(b)s(oth)e │ │ │ │ │ -(using)h(indep)s(enden)m(t)427 624 y(balanced)38 b(maps.)61 │ │ │ │ │ -b(The)36 b(metho)s(d)h Fn(ETree)p 1884 624 29 4 v 33 │ │ │ │ │ -w(ddMapNew\(\))e Fo(is)i(more)g(robust)g(than)g Fn(ETree)p │ │ │ │ │ -3514 624 V 33 w(ddMap\(\))p Fo(,)427 737 y(and)c(is)h(more)g(general)g │ │ │ │ │ -(in)g(the)f(sense)h(that)g(it)g(tak)m(es)h(a)f(m)m(ultisector)h(v)m │ │ │ │ │ -(ector)h(as)e(input.)49 b(The)33 b Fn(msIV)427 850 y │ │ │ │ │ -Fo(ob)5 b(ject)41 b(is)f(a)g(map)g(from)f(the)h(v)m(ertices)h(to)g │ │ │ │ │ -Ff(f)p Fo(0)p Fg(;)15 b Fo(1)p Ff(g)p Fo(.)71 b(A)40 │ │ │ │ │ -b(v)m(ertex)h(mapp)s(ed)e(to)h(0)g(lies)h(in)e(the)i(Sc)m(h)m(ur)427 │ │ │ │ │ -963 y(complemen)m(t,)32 b(a)f(v)m(ertex)g(mapp)s(ed)e(to)i(1)g(lies)g │ │ │ │ │ -(in)f(a)h(domain.)227 1196 y Fj(Err)-5 b(or)44 b(che)-5 │ │ │ │ │ -b(cking:)61 b Fo(If)41 b Fn(etree)f Fo(or)g Fn(cumopsDV)f │ │ │ │ │ -Fo(is)i Fn(NULL)p Fo(,)f(or)h(if)g Fn(type)f Fo(or)h │ │ │ │ │ -Fn(symflag)e Fo(is)i(in)m(v)-5 b(alid,)44 b(an)d(error)227 │ │ │ │ │ -1309 y(message)32 b(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)0 │ │ │ │ │ -1600 y Fh(1.2.12)113 b(Storage)37 b(pro\014le)h(metho)s(ds)0 │ │ │ │ │ -1804 y Fo(These)33 b(metho)s(ds)f(\014ll)h(a)h(v)m(ector)g(with)f(the)g │ │ │ │ │ -(total)i(amoun)m(t)e(of)h(w)m(orking)f(storage)h(necessary)g(during)e │ │ │ │ │ -(the)h(factor)0 1917 y(and)d(solv)m(es.)111 2175 y(1.)46 │ │ │ │ │ -b Fn(void)h(ETree_MFstackProfile)42 b(\()48 b(ETree)e(*etree,)g(int)h │ │ │ │ │ -(type,)f(double)g(dvec[])g(\))i(;)227 2333 y Fo(On)38 │ │ │ │ │ -b(return,)h Fn(dvec[J])d Fo(con)m(tains)k(the)e(amoun)m(t)h(of)f(activ) │ │ │ │ │ -m(e)j(storage)e(to)g(eliminate)h Fn(J)e Fo(using)g(the)g(m)m(ulti-)227 │ │ │ │ │ -2446 y(fron)m(tal)c(metho)s(d)e(and)g(the)h(natural)g(p)s(ost-order)f │ │ │ │ │ -(tra)m(v)m(ersal.)50 b(The)32 b Fn(symflag)e Fo(parameter)k(can)f(b)s │ │ │ │ │ -(e)f(one)h(of)227 2559 y Fn(SPOOLES)p 569 2559 V 33 w(SYMMETRIC)p │ │ │ │ │ -Fo(,)28 b Fn(SPOOLES)p 1423 2559 V 32 w(HERMITIAN)g Fo(or)i │ │ │ │ │ -Fn(SPOOLES)p 2362 2559 V 33 w(NONSYMMETRIC)p Fo(.)227 │ │ │ │ │ -2717 y Fj(Err)-5 b(or)28 b(che)-5 b(cking:)37 b Fo(If)23 │ │ │ │ │ -b Fn(etree)f Fo(or)h Fn(dvec)g Fo(are)g Fn(NULL)p Fo(,)g(or)h(if)f │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fo(16)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 337 399 a Fl(\210)45 b Fo(The)28 b │ │ │ │ │ +Fj(domain)k(de)-5 b(c)g(omp)g(osition)34 b(map)c Fo(is)e(also)h │ │ │ │ │ +(complex,)h(where)e(domains)g(are)g(mapp)s(ed)f(to)i(threads,)427 │ │ │ │ │ +511 y(then)d(the)h(fron)m(ts)f(in)g(the)g(sc)m(h)m(ur)g(complemen)m(t)i │ │ │ │ │ +(are)e(mapp)s(ed)f(to)i(threads,)g(b)s(oth)e(using)h(indep)s(enden)m(t) │ │ │ │ │ +427 624 y(balanced)38 b(maps.)61 b(The)36 b(metho)s(d)h │ │ │ │ │ +Fn(ETree)p 1884 624 29 4 v 33 w(ddMapNew\(\))e Fo(is)i(more)g(robust)g │ │ │ │ │ +(than)g Fn(ETree)p 3514 624 V 33 w(ddMap\(\))p Fo(,)427 │ │ │ │ │ +737 y(and)c(is)h(more)g(general)g(in)g(the)f(sense)h(that)g(it)g(tak)m │ │ │ │ │ +(es)h(a)f(m)m(ultisector)h(v)m(ector)h(as)e(input.)49 │ │ │ │ │ +b(The)33 b Fn(msIV)427 850 y Fo(ob)5 b(ject)41 b(is)f(a)g(map)g(from)f │ │ │ │ │ +(the)h(v)m(ertices)h(to)g Ff(f)p Fo(0)p Fg(;)15 b Fo(1)p │ │ │ │ │ +Ff(g)p Fo(.)71 b(A)40 b(v)m(ertex)h(mapp)s(ed)e(to)h(0)g(lies)h(in)e │ │ │ │ │ +(the)i(Sc)m(h)m(ur)427 963 y(complemen)m(t,)32 b(a)f(v)m(ertex)g(mapp)s │ │ │ │ │ +(ed)e(to)i(1)g(lies)g(in)f(a)h(domain.)227 1196 y Fj(Err)-5 │ │ │ │ │ +b(or)44 b(che)-5 b(cking:)61 b Fo(If)41 b Fn(etree)f │ │ │ │ │ +Fo(or)g Fn(cumopsDV)f Fo(is)i Fn(NULL)p Fo(,)f(or)h(if)g │ │ │ │ │ +Fn(type)f Fo(or)h Fn(symflag)e Fo(is)i(in)m(v)-5 b(alid,)44 │ │ │ │ │ +b(an)d(error)227 1309 y(message)32 b(is)e(prin)m(ted)g(and)g(the)g │ │ │ │ │ +(program)h(exits.)0 1600 y Fh(1.2.12)113 b(Storage)37 │ │ │ │ │ +b(pro\014le)h(metho)s(ds)0 1804 y Fo(These)33 b(metho)s(ds)f(\014ll)h │ │ │ │ │ +(a)h(v)m(ector)g(with)f(the)g(total)i(amoun)m(t)e(of)h(w)m(orking)f │ │ │ │ │ +(storage)h(necessary)g(during)e(the)h(factor)0 1917 y(and)d(solv)m(es.) │ │ │ │ │ +111 2175 y(1.)46 b Fn(void)h(ETree_MFstackProfile)42 │ │ │ │ │ +b(\()48 b(ETree)e(*etree,)g(int)h(type,)f(double)g(dvec[])g(\))i(;)227 │ │ │ │ │ +2333 y Fo(On)38 b(return,)h Fn(dvec[J])d Fo(con)m(tains)k(the)e(amoun)m │ │ │ │ │ +(t)h(of)f(activ)m(e)j(storage)e(to)g(eliminate)h Fn(J)e │ │ │ │ │ +Fo(using)g(the)g(m)m(ulti-)227 2446 y(fron)m(tal)c(metho)s(d)e(and)g │ │ │ │ │ +(the)h(natural)g(p)s(ost-order)f(tra)m(v)m(ersal.)50 │ │ │ │ │ +b(The)32 b Fn(symflag)e Fo(parameter)k(can)f(b)s(e)f(one)h(of)227 │ │ │ │ │ +2559 y Fn(SPOOLES)p 569 2559 V 33 w(SYMMETRIC)p Fo(,)28 │ │ │ │ │ +b Fn(SPOOLES)p 1423 2559 V 32 w(HERMITIAN)g Fo(or)i Fn(SPOOLES)p │ │ │ │ │ +2362 2559 V 33 w(NONSYMMETRIC)p Fo(.)227 2717 y Fj(Err)-5 │ │ │ │ │ +b(or)28 b(che)-5 b(cking:)37 b Fo(If)23 b Fn(etree)f │ │ │ │ │ +Fo(or)h Fn(dvec)g Fo(are)g Fn(NULL)p Fo(,)g(or)h(if)f │ │ │ │ │ Fn(symflag)f Fo(is)h(in)m(v)-5 b(alid,)26 b(an)d(error)g(message)i(is)e │ │ │ │ │ (prin)m(ted)227 2830 y(and)30 b(the)h(program)f(exits.)111 │ │ │ │ │ 3034 y(2.)46 b Fn(void)h(ETree_GSstorageProfile)42 b(\()47 │ │ │ │ │ b(ETree)f(*etree,)g(int)h(type,)g(IVL)f(*symbfacIVL,)1659 │ │ │ │ │ 3147 y(int)h(*vwghts,)f(double)g(dvec[])g(\))h(;)227 │ │ │ │ │ 3305 y Fo(On)23 b(return,)h Fn(dvec[J])d Fo(con)m(tains)k(the)f(amoun)m │ │ │ │ │ (t)g(of)f(activ)m(e)j(storage)f(to)f(eliminate)h Fn(J)e │ │ │ │ │ @@ -6767,17 +6759,17 @@ │ │ │ │ │ (of)f(stac)m(k)i(storage)g(to)f(solv)m(e)h(for)e Fn(J)g │ │ │ │ │ Fo(using)g(the)g(m)m(ultifron)m(tal-)227 5249 y(based)30 │ │ │ │ │ b(forw)m(ard)g(solv)m(e.)227 5407 y Fj(Err)-5 b(or)29 │ │ │ │ │ b(che)-5 b(cking:)38 b Fo(If)25 b Fn(etree)e Fo(or)j │ │ │ │ │ Fn(dvec)d Fo(are)j Fn(NULL)p Fo(,)e(an)h(error)g(message)h(is)f(prin)m │ │ │ │ │ (ted)g(and)g(the)g(program)g(exits.)p eop end │ │ │ │ │ %%Page: 17 17 │ │ │ │ │ -TeXDict begin 17 16 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(17)111 399 y(5.)46 b Fn(void)h │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(17)111 399 y(5.)46 b Fn(void)h │ │ │ │ │ (ETree_backSolveProfile)42 b(\()47 b(ETree)f(*etree,)g(double)g(dvec[]) │ │ │ │ │ g(\))i(;)227 555 y Fo(On)24 b(return,)g Fn(dvec[J])f │ │ │ │ │ Fo(con)m(tains)i(the)g(amoun)m(t)g(of)f(stac)m(k)i(storage)g(to)f(solv) │ │ │ │ │ m(e)h(for)e Fn(J)g Fo(using)g(the)g(m)m(ultifron)m(tal-)227 │ │ │ │ │ 668 y(based)30 b(bac)m(kw)m(ard)h(solv)m(e.)227 825 y │ │ │ │ │ Fj(Err)-5 b(or)29 b(che)-5 b(cking:)38 b Fo(If)25 b Fn(etree)e │ │ │ │ │ Fo(or)j Fn(dvec)d Fo(are)j Fn(NULL)p Fo(,)e(an)h(error)g(message)h(is)f │ │ │ │ │ @@ -6851,19 +6843,19 @@ │ │ │ │ │ e(v)-5 b(alue)34 b Fn(1)e Fo(is)i(returned.)47 b(If)33 │ │ │ │ │ b(an)g(IO)f(error)h(is)227 5250 y(encoun)m(tered)e(from)f │ │ │ │ │ Fn(fprintf)p Fo(,)f(zero)i(is)f(returned.)227 5407 y │ │ │ │ │ Fj(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b Fn(etree)f │ │ │ │ │ Fo(or)i Fn(fp)e Fo(are)i Fn(NULL)p Fo(,)f(an)g(error)g(message)h(is)g │ │ │ │ │ (prin)m(ted)f(and)f(zero)j(is)e(returned.)p eop end │ │ │ │ │ %%Page: 18 18 │ │ │ │ │ -TeXDict begin 18 17 bop 0 100 a Fo(18)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 111 399 a Fo(6.)46 │ │ │ │ │ -b Fn(int)h(ETree_writeToBinaryFile)42 b(\()47 b(ETree)f(*etree,)g(FILE) │ │ │ │ │ -h(*fp)g(\))g(;)227 557 y Fo(This)37 b(metho)s(d)g(writes)g(an)h │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fo(18)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 111 399 a Fo(6.)46 b Fn(int)h │ │ │ │ │ +(ETree_writeToBinaryFile)42 b(\()47 b(ETree)f(*etree,)g(FILE)h(*fp)g │ │ │ │ │ +(\))g(;)227 557 y Fo(This)37 b(metho)s(d)g(writes)g(an)h │ │ │ │ │ Fn(ETree)e Fo(ob)5 b(ject)38 b(to)g(a)g(binary)f(\014le.)62 │ │ │ │ │ b(If)37 b(there)h(are)g(no)f(errors)g(in)g(writing)h(the)227 │ │ │ │ │ 670 y(data,)32 b(the)e(v)-5 b(alue)31 b Fn(1)f Fo(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fn(fwrite)p Fo(,)f(zero)i(is)g(returned.)227 829 y Fj(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b Fn(etree)f │ │ │ │ │ Fo(or)i Fn(fp)e Fo(are)i Fn(NULL)p Fo(,)f(an)g(error)g(message)h(is)g │ │ │ │ │ @@ -6932,17 +6924,17 @@ │ │ │ │ │ w(writeToFile\(\))22 b Fo(metho)s(d)i(is)i(called)g(to)g(write)g(the)f │ │ │ │ │ (ob)5 b(ject)26 b(to)g(a)g(formatted)g(\014le)f(\(if)g │ │ │ │ │ Fn(outIVfile)427 5407 y Fo(is)31 b(of)f(the)h(form)f │ │ │ │ │ Fn(*.ivf)p Fo(\),)f(or)i(a)f(binary)g(\014le)g(\(if)h │ │ │ │ │ Fn(outIVfile)d Fo(is)i(of)h(the)f(form)g Fn(*.ivb)p Fo(\).)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 19 19 │ │ │ │ │ -TeXDict begin 19 18 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(19)337 399 y Fl(\210)45 b Fo(The)24 │ │ │ │ │ +TeXDict begin 19 18 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(19)337 399 y Fl(\210)45 b Fo(The)24 │ │ │ │ │ b Fn(outETreeFile)d Fo(parameter)k(is)f(the)h(output)f(\014le)g(for)g │ │ │ │ │ (the)h Fn(ETree)d Fo(ob)5 b(ject.)40 b(If)24 b Fn(outETreeFile)d │ │ │ │ │ Fo(is)427 511 y Fn(none)g Fo(then)h(the)g Fn(ETree)f │ │ │ │ │ Fo(ob)5 b(ject)22 b(is)g(not)h(written)f(to)g(a)h(\014le.)38 │ │ │ │ │ b(Otherwise,)23 b(the)g Fn(ETree)p 3253 511 29 4 v 33 │ │ │ │ │ w(writeToFile\(\))427 624 y Fo(metho)s(d)30 b(is)h(called)h(to)f(write) │ │ │ │ │ g(the)g(ob)5 b(ject)31 b(to)h(a)f(formatted)g(\014le)g(\(if)g │ │ │ │ │ @@ -7014,29 +7006,29 @@ │ │ │ │ │ b(39661)47 b(indices,)141 b(367237)46 b(|L|,)g(63215265)g(ops)275 │ │ │ │ │ 5294 y(merge2)142 b(:)g(511)47 b(fronts,)189 b(29525)47 │ │ │ │ │ b(indices,)141 b(373757)46 b(|L|,)g(63590185)g(ops)275 │ │ │ │ │ 5407 y(split)190 b(:)142 b(536)47 b(fronts,)189 b(34484)47 │ │ │ │ │ b(indices,)141 b(373757)46 b(|L|,)g(63590185)g(ops)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 20 20 │ │ │ │ │ -TeXDict begin 20 19 bop 0 100 a Fo(20)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 337 399 a Fl(\210)45 │ │ │ │ │ -b Fo(The)28 b Fn(msglvl)f Fo(parameter)i(determines)g(the)g(amoun)m(t)g │ │ │ │ │ -(of)f(output)h(|)f(taking)i Fn(msglvl)46 b(>=)h(3)28 │ │ │ │ │ -b Fo(means)427 511 y(the)j Fn(ETree)e Fo(ob)5 b(ject)31 │ │ │ │ │ -b(is)f(written)h(to)g(the)g(message)g(\014le.)337 660 │ │ │ │ │ -y Fl(\210)45 b Fo(The)33 b Fn(msgFile)e Fo(parameter)j(determines)f │ │ │ │ │ -(the)h(message)g(\014le)f(|)h(if)f Fn(msgFile)e Fo(is)i │ │ │ │ │ -Fn(stdout)p Fo(,)g(then)g(the)427 773 y(message)27 b(\014le)f(is)g │ │ │ │ │ -Fj(stdout)p Fo(,)i(otherwise)e(a)h(\014le)f(is)f(op)s(ened)g(with)h │ │ │ │ │ -Fj(app)-5 b(end)28 b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 │ │ │ │ │ -885 y(data.)337 1034 y Fl(\210)45 b Fn(n1)30 b Fo(is)g(the)h(n)m(um)m │ │ │ │ │ -(b)s(er)e(of)i(grid)f(p)s(oin)m(ts)g(in)g(the)h(\014rst)e(direction.) │ │ │ │ │ -337 1182 y Fl(\210)45 b Fn(n2)30 b Fo(is)g(the)h(n)m(um)m(b)s(er)e(of)i │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fo(20)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 337 399 a Fl(\210)45 b Fo(The)28 b │ │ │ │ │ +Fn(msglvl)f Fo(parameter)i(determines)g(the)g(amoun)m(t)g(of)f(output)h │ │ │ │ │ +(|)f(taking)i Fn(msglvl)46 b(>=)h(3)28 b Fo(means)427 │ │ │ │ │ +511 y(the)j Fn(ETree)e Fo(ob)5 b(ject)31 b(is)f(written)h(to)g(the)g │ │ │ │ │ +(message)g(\014le.)337 660 y Fl(\210)45 b Fo(The)33 b │ │ │ │ │ +Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ +(if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the)427 │ │ │ │ │ +773 y(message)27 b(\014le)f(is)g Fj(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ +(\014le)f(is)f(op)s(ened)g(with)h Fj(app)-5 b(end)28 │ │ │ │ │ +b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 885 │ │ │ │ │ +y(data.)337 1034 y Fl(\210)45 b Fn(n1)30 b Fo(is)g(the)h(n)m(um)m(b)s │ │ │ │ │ +(er)e(of)i(grid)f(p)s(oin)m(ts)g(in)g(the)h(\014rst)e(direction.)337 │ │ │ │ │ +1182 y Fl(\210)45 b Fn(n2)30 b Fo(is)g(the)h(n)m(um)m(b)s(er)e(of)i │ │ │ │ │ (grid)f(p)s(oin)m(ts)g(in)g(the)h(second)f(direction.)337 │ │ │ │ │ 1330 y Fl(\210)45 b Fn(n3)30 b Fo(is)g(the)h(n)m(um)m(b)s(er)e(of)i │ │ │ │ │ (grid)f(p)s(oin)m(ts)g(in)g(the)h(third)e(direction.)337 │ │ │ │ │ 1478 y Fl(\210)45 b Fo(The)27 b Fn(maxzeros)e Fo(parameter)j(is)f(an)g │ │ │ │ │ (upp)s(er)f(b)s(ound)f(on)i(the)h(n)m(um)m(b)s(er)e(of)h(logically)j │ │ │ │ │ (zero)e(en)m(tries)g(that)427 1591 y(will)j(b)s(e)f(allo)m(w)m(ed)i(in) │ │ │ │ │ e(a)h(new)f(fron)m(t.)337 1740 y Fl(\210)45 b Fo(The)31 │ │ │ │ │ @@ -7094,17 +7086,17 @@ │ │ │ │ │ h(n)m(um)m(b)s(er)e(of)h(v)m(ertices)i(in)e(a)h(fron)m(t)f(|)h(an)m(y) │ │ │ │ │ 427 5146 y(original)j(fron)m(t)f(that)g(con)m(tains)h(more)f(than)f │ │ │ │ │ Fn(maxsize)f Fo(v)m(ertices)j(will)f(b)s(e)f(brok)m(en)g(up)g(in)m(to)h │ │ │ │ │ (smaller)427 5259 y(fron)m(ts.)337 5407 y Fl(\210)45 │ │ │ │ │ b Fo(The)30 b Fn(nthread)f Fo(parameter)h(is)h(the)f(n)m(um)m(b)s(er)f │ │ │ │ │ (of)i(threads.)p eop end │ │ │ │ │ %%Page: 21 21 │ │ │ │ │ -TeXDict begin 21 20 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(21)337 399 y Fl(\210)45 b Fo(The)30 │ │ │ │ │ +TeXDict begin 21 20 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(21)337 399 y Fl(\210)45 b Fo(The)30 │ │ │ │ │ b Fn(maptype)f Fo(parameter)h(is)h(the)f(t)m(yp)s(e)h(of)f(map.)500 │ │ │ │ │ 540 y Fe({)45 b Fn(1)30 b Fo(|)h(wrap)e(map)500 667 y │ │ │ │ │ Fe({)45 b Fn(2)30 b Fo(|)h(balanced)f(map)500 794 y Fe({)45 │ │ │ │ │ b Fn(3)30 b Fo(|)h(subtree-subset)e(map)500 921 y Fe({)45 │ │ │ │ │ b Fn(4)30 b Fo(|)h(domain)f(decomp)s(osition)h(map)337 │ │ │ │ │ 1062 y Fl(\210)45 b Fo(The)d Fn(cutoff)e Fo(parameter)i(is)g(used)f(b)m │ │ │ │ │ (y)h(the)g(domain)g(decomp)s(osition)g(map)g(only)-8 │ │ │ │ │ @@ -7187,32 +7179,32 @@ │ │ │ │ │ b(Otherwise,)37 b(the)g Fn(IV)p 3252 5181 V 34 w(writeToFile\(\))427 │ │ │ │ │ 5294 y Fo(metho)s(d)i(is)h(called)h(to)f(write)g(the)g(ob)5 │ │ │ │ │ b(ject)40 b(to)g(a)g(formatted)h(\014le)e(\(if)h Fn(outIVFile)d │ │ │ │ │ Fo(is)j(of)g(the)f(form)427 5407 y Fn(*.ivf)p Fo(\),)30 │ │ │ │ │ b(or)g(a)h(binary)f(\014le)g(\(if)h Fn(outIVFile)d Fo(is)i(of)g(the)h │ │ │ │ │ (form)f Fn(*.ivb)p Fo(\).)p eop end │ │ │ │ │ %%Page: 22 22 │ │ │ │ │ -TeXDict begin 22 21 bop 0 100 a Fo(22)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 111 399 a Fo(6.)46 │ │ │ │ │ -b Fn(testExpand)f(msglvl)h(msgFile)g(inETreeFile)f(inEqmapFile)g │ │ │ │ │ -(outETreeFile)227 553 y Fo(This)39 b(driv)m(er)h(program)g(is)g(used)f │ │ │ │ │ -(to)i(translate)g(an)f Fn(ETree)e Fo(ob)5 b(ject)41 b(for)f(a)g │ │ │ │ │ -(compressed)g(graph)f(in)m(to)i(an)227 666 y Fn(ETree)29 │ │ │ │ │ -b Fo(ob)5 b(ject)31 b(for)g(the)f(unit)g(w)m(eigh)m(t)i(graph.)337 │ │ │ │ │ -888 y Fl(\210)45 b Fo(The)28 b Fn(msglvl)f Fo(parameter)i(determines)g │ │ │ │ │ -(the)g(amoun)m(t)g(of)f(output)h(|)f(taking)i Fn(msglvl)46 │ │ │ │ │ -b(>=)h(3)28 b Fo(means)427 1001 y(the)j Fn(ETree)e Fo(ob)5 │ │ │ │ │ -b(ject)31 b(is)f(written)h(to)g(the)g(message)g(\014le.)337 │ │ │ │ │ -1151 y Fl(\210)45 b Fo(The)33 b Fn(msgFile)e Fo(parameter)j(determines) │ │ │ │ │ -f(the)h(message)g(\014le)f(|)h(if)f Fn(msgFile)e Fo(is)i │ │ │ │ │ -Fn(stdout)p Fo(,)g(then)g(the)427 1264 y(message)27 b(\014le)f(is)g │ │ │ │ │ -Fj(stdout)p Fo(,)i(otherwise)e(a)h(\014le)f(is)f(op)s(ened)g(with)h │ │ │ │ │ -Fj(app)-5 b(end)28 b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 │ │ │ │ │ -1377 y(data.)337 1527 y Fl(\210)45 b Fo(The)36 b Fn(inETreeFile)d │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fo(22)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 111 399 a Fo(6.)46 b Fn(testExpand)f(msglvl)h │ │ │ │ │ +(msgFile)g(inETreeFile)f(inEqmapFile)g(outETreeFile)227 │ │ │ │ │ +553 y Fo(This)39 b(driv)m(er)h(program)g(is)g(used)f(to)i(translate)g │ │ │ │ │ +(an)f Fn(ETree)e Fo(ob)5 b(ject)41 b(for)f(a)g(compressed)g(graph)f(in) │ │ │ │ │ +m(to)i(an)227 666 y Fn(ETree)29 b Fo(ob)5 b(ject)31 b(for)g(the)f(unit) │ │ │ │ │ +g(w)m(eigh)m(t)i(graph.)337 888 y Fl(\210)45 b Fo(The)28 │ │ │ │ │ +b Fn(msglvl)f Fo(parameter)i(determines)g(the)g(amoun)m(t)g(of)f │ │ │ │ │ +(output)h(|)f(taking)i Fn(msglvl)46 b(>=)h(3)28 b Fo(means)427 │ │ │ │ │ +1001 y(the)j Fn(ETree)e Fo(ob)5 b(ject)31 b(is)f(written)h(to)g(the)g │ │ │ │ │ +(message)g(\014le.)337 1151 y Fl(\210)45 b Fo(The)33 │ │ │ │ │ +b Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ +(if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the)427 │ │ │ │ │ +1264 y(message)27 b(\014le)f(is)g Fj(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ +(\014le)f(is)f(op)s(ened)g(with)h Fj(app)-5 b(end)28 │ │ │ │ │ +b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 1377 │ │ │ │ │ +y(data.)337 1527 y Fl(\210)45 b Fo(The)36 b Fn(inETreeFile)d │ │ │ │ │ Fo(parameter)j(is)g(the)g(input)f(\014le)h(for)g(the)g │ │ │ │ │ Fn(ETree)f Fo(ob)5 b(ject)36 b(for)g(the)g(compressed)427 │ │ │ │ │ 1640 y(graph.)53 b(It)34 b(m)m(ust)g(b)s(e)g(of)h(the)f(form)g │ │ │ │ │ Fn(*.etreef)e Fo(or)j Fn(*.etreeb)p Fo(.)50 b(The)34 │ │ │ │ │ b Fn(ETree)f Fo(ob)5 b(ject)36 b(is)e(read)g(from)427 │ │ │ │ │ 1753 y(the)d(\014le)f(via)h(the)g Fn(ETree)p 1282 1753 │ │ │ │ │ 29 4 v 33 w(readFromFile\(\))26 b Fo(metho)s(d.)337 1903 │ │ │ │ │ @@ -7272,17 +7264,17 @@ │ │ │ │ │ h(t)m(w)m(o)g(plots.)337 5058 y Fl(\210)45 b Fo(Eac)m(h)31 │ │ │ │ │ b(no)s(de)f(will)h(ha)m(v)m(e)g(a)g(circle)h(with)e(radius)f │ │ │ │ │ Fn(radius)p Fo(.)337 5208 y Fl(\210)45 b Fo(The)34 b │ │ │ │ │ Fn(firstEPSfile)e Fo(and)i Fn(secondEPSfile)d Fo(parameters)j(is)h(the) │ │ │ │ │ g(output)f(EPS)g(\014le)g(for)h(the)g(t)m(w)m(o)427 5321 │ │ │ │ │ y(plots.)p eop end │ │ │ │ │ %%Page: 23 23 │ │ │ │ │ -TeXDict begin 23 22 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(23)0 453 y(Figure)26 b(1.1:)40 b │ │ │ │ │ +TeXDict begin 23 22 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(23)0 453 y(Figure)26 b(1.1:)40 b │ │ │ │ │ Fa(GRD7x7)p Fo(:)f(W)-8 b(orking)26 b(storage)i(for)d(the)h(forw)m(ard) │ │ │ │ │ f(sparse)g(factorization)k(of)d(the)g(nested)f(dissection)0 │ │ │ │ │ 566 y(ordering.)40 b(On)28 b(the)h(left)h(is)e(the)h(storage)i │ │ │ │ │ (required)d(to)i(factor)2159 540 y Fb(b)2137 566 y Fg(J)38 │ │ │ │ │ b Fo(and)29 b(its)g(up)s(date)f(matrix.)40 b(On)28 b(the)h(righ)m(t)h │ │ │ │ │ (is)f(the)0 679 y(storage)j(required)d(to)j(factor)f │ │ │ │ │ Fg(J)39 b Fo(and)30 b(all)h(of)g(its)g(ancestors.)41 │ │ │ │ │ @@ -7681,20 +7673,20 @@ │ │ │ │ │ 5053 y(information)d(\(see)g(the)g Fn(ETree)p 1305 5053 │ │ │ │ │ V 33 w(writeStats\(\))c Fo(metho)s(d\).)337 5294 y Fl(\210)45 │ │ │ │ │ b Fo(The)28 b Fn(msglvl)f Fo(parameter)i(determines)g(the)g(amoun)m(t)g │ │ │ │ │ (of)f(output)h(|)f(taking)i Fn(msglvl)46 b(>=)h(3)28 │ │ │ │ │ b Fo(means)427 5407 y(the)j Fn(ETree)e Fo(ob)5 b(ject)31 │ │ │ │ │ b(is)f(written)h(to)g(the)g(message)g(\014le.)p eop end │ │ │ │ │ %%Page: 24 24 │ │ │ │ │ -TeXDict begin 24 23 bop 0 100 a Fo(24)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 337 399 a Fl(\210)45 │ │ │ │ │ -b Fo(The)33 b Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g │ │ │ │ │ -(\014le)f(|)h(if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the) │ │ │ │ │ -427 511 y(message)27 b(\014le)f(is)g Fj(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ +TeXDict begin 24 23 bop 0 100 a Fo(24)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 337 399 a Fl(\210)45 b Fo(The)33 b │ │ │ │ │ +Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ +(if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the)427 │ │ │ │ │ +511 y(message)27 b(\014le)f(is)g Fj(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Fj(app)-5 b(end)28 │ │ │ │ │ b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 624 │ │ │ │ │ y(data.)337 770 y Fl(\210)45 b Fo(The)37 b Fn(inFile)f │ │ │ │ │ Fo(parameter)i(is)g(the)g(input)e(\014le)i(for)f(the)h │ │ │ │ │ Fn(ETree)e Fo(ob)5 b(ject.)64 b(It)37 b(m)m(ust)h(b)s(e)f(of)h(the)f │ │ │ │ │ (form)427 883 y Fn(*.etreef)18 b Fo(or)j Fn(*.etreeb)p │ │ │ │ │ Fo(.)35 b(The)19 b Fn(ETree)g Fo(ob)5 b(ject)21 b(is)g(read)f(from)g │ │ │ │ │ @@ -7772,17 +7764,17 @@ │ │ │ │ │ Fo(ob)5 b(ject.)40 b(It)25 b(partitions)h(the)227 5294 │ │ │ │ │ y(v)m(ertices)37 b(in)m(to)f(domains)f(and)g(a)g(m)m(ultisector,)j │ │ │ │ │ (where)d(eac)m(h)h(domain)f(is)h(a)f(subtree)g(of)g(the)h(elimination) │ │ │ │ │ 227 5407 y(tree)i(and)e(the)h(m)m(ultisector)h(is)f(the)g(rest)g(of)g │ │ │ │ │ (the)g(v)m(ertices.)61 b(The)37 b(c)m(hoice)h(of)f(the)g(subtrees)f │ │ │ │ │ (dep)s(ends)f(on)p eop end │ │ │ │ │ %%Page: 25 25 │ │ │ │ │ -TeXDict begin 25 24 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(25)227 399 y(the)h Fn(flag)e Fo(and)h │ │ │ │ │ +TeXDict begin 25 24 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(25)227 399 y(the)h Fn(flag)e Fo(and)h │ │ │ │ │ Fn(cutoff)f Fo(parameters)i(|)f(it)h(can)g(b)s(e)f(based)g(on)h(depth)f │ │ │ │ │ (of)g(a)h(subtree)f(or)h(the)g(n)m(um)m(b)s(er)e(of)227 │ │ │ │ │ 511 y(v)m(ertices,)36 b(factor)e(en)m(tries)g(or)f(factor)h(op)s │ │ │ │ │ (erations)f(asso)s(ciated)i(with)e(the)g(subtree.)48 │ │ │ │ │ b(The)33 b(comp)s(onen)m(t)g(ids)227 624 y Fn(IV)27 b │ │ │ │ │ Fo(ob)5 b(ject)28 b(is)g(optionally)h(written)e(to)h(a)g(\014le.)40 │ │ │ │ │ b(Here)28 b(is)f(some)h(sample)g(output)f(for)g Fn(BCSSTK30)e │ │ │ │ │ @@ -7846,19 +7838,19 @@ │ │ │ │ │ (\014le.)40 b(Otherwise,)30 b(the)f Fn(IV)p 2832 5181 │ │ │ │ │ V 34 w(writeToFile\(\))c Fo(metho)s(d)k(is)427 5294 y(called)35 │ │ │ │ │ b(to)f(write)g(the)f(ob)5 b(ject)35 b(to)f(a)g(formatted)g(\014le)f │ │ │ │ │ (\(if)h Fn(outIVFile)d Fo(is)i(of)h(the)g(form)f Fn(*.ivf)p │ │ │ │ │ Fo(\),)g(or)h(a)427 5407 y(binary)c(\014le)g(\(if)h Fn(outIVFile)d │ │ │ │ │ Fo(is)i(of)h(the)f(form)g Fn(*.ivb)p Fo(\).)p eop end │ │ │ │ │ %%Page: 26 26 │ │ │ │ │ -TeXDict begin 26 25 bop 0 100 a Fo(26)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 337 399 a Fl(\210)45 │ │ │ │ │ -b Fo(The)30 b Fn(flag)f Fo(parameter)i(sp)s(eci\014es)f(the)h(t)m(yp)s │ │ │ │ │ -(e)f(of)h(m)m(ultisector.)500 548 y Fe({)45 b Fn(flag)i(==)g(1)30 │ │ │ │ │ +TeXDict begin 26 25 bop 0 100 a Fo(26)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 337 399 a Fl(\210)45 b Fo(The)30 b │ │ │ │ │ +Fn(flag)f Fo(parameter)i(sp)s(eci\014es)f(the)h(t)m(yp)s(e)f(of)h(m)m │ │ │ │ │ +(ultisector.)500 548 y Fe({)45 b Fn(flag)i(==)g(1)30 │ │ │ │ │ b Fo(|)h(the)g(m)m(ultisector)h(is)f(based)f(on)g(the)h(depth)f(of)h │ │ │ │ │ (the)g(fron)m(t,)g(i.e.,)h(if)e(the)h(fron)m(t)g(is)597 │ │ │ │ │ 661 y(more)g(than)f Fn(depth)f Fo(steps)h(remo)m(v)m(ed)i(from)d(the)i │ │ │ │ │ (ro)s(ot,)g(it)g(forms)f(the)g(ro)s(ot)h(of)f(a)h(domain.)500 │ │ │ │ │ 792 y Fe({)45 b Fn(flag)i(==)g(2)32 b Fo(|)h(the)g(m)m(ultisector)h(is) │ │ │ │ │ f(based)g(on)f(the)h(n)m(um)m(b)s(er)f(of)g(v)m(ertices)j(in)d(a)h │ │ │ │ │ (subtree,)h(i.e.,)597 905 y(if)e(the)g(subtree)f(ro)s(oted)h(at)g(a)h │ │ │ │ │ @@ -7926,17 +7918,17 @@ │ │ │ │ │ (the)h(input)e(\014le)i(for)f(the)g Fn(Graph)f Fo(ob)5 │ │ │ │ │ b(ject.)39 b(It)24 b(m)m(ust)f(b)s(e)f(of)i(the)f(form)427 │ │ │ │ │ 5294 y Fn(*.graphf)18 b Fo(or)j Fn(*.graphb)p Fo(.)35 │ │ │ │ │ b(The)19 b Fn(Graph)g Fo(ob)5 b(ject)21 b(is)g(read)f(from)g(the)g │ │ │ │ │ (\014le)h(via)f(the)h Fn(Graph)p 3368 5294 V 33 w(readFromFile\(\))427 │ │ │ │ │ 5407 y Fo(metho)s(d.)p eop end │ │ │ │ │ %%Page: 27 27 │ │ │ │ │ -TeXDict begin 27 26 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(27)337 399 y Fl(\210)45 b Fo(The)30 │ │ │ │ │ +TeXDict begin 27 26 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(27)337 399 y Fl(\210)45 b Fo(The)30 │ │ │ │ │ b Fn(outEPSfile)e Fo(parameter)j(is)f(the)h(name)f(of)h(the)f(EPS)g │ │ │ │ │ (\014le)g(to)h(hold)f(the)h(tree.)337 542 y Fl(\210)45 │ │ │ │ │ b Fo(The)34 b Fn(metricType)e Fo(parameter)j(de\014nes)f(the)h(t)m(yp)s │ │ │ │ │ (e)g(of)g(metric)g(to)g(b)s(e)f(illustrated.)54 b(See)35 │ │ │ │ │ b(ab)s(o)m(v)m(e)h(for)427 655 y(v)-5 b(alues.)337 799 │ │ │ │ │ y Fl(\210)45 b Fo(F)-8 b(or)31 b(information)g(ab)s(out)f(the)h │ │ │ │ │ Fn(heightflag)c Fo(and)j Fn(coordflag)e Fo(parameters,)j(see)g(Section) │ │ │ │ │ @@ -9739,18 +9731,18 @@ │ │ │ │ │ b Fj(Mer)-5 b(ging)31 b Fo(the)h(fron)m(t)g(tree)h(means)f(com)m │ │ │ │ │ (bining)g(fron)m(ts)g(together)h(that)227 5407 y(do)26 │ │ │ │ │ b(not)g(in)m(tro)s(duce)f(more)h(than)f Fn(maxzeros)e │ │ │ │ │ Fo(zero)k(en)m(tries)f(in)f(a)h(fron)m(t.)40 b(\(See)26 │ │ │ │ │ b([)p Fe(?)p Fo(])g(and)f([)p Fe(?)q Fo(])h(for)f(a)h(description)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 28 28 │ │ │ │ │ -TeXDict begin 28 27 bop 0 100 a Fo(28)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(ETree)28 b Fk(:)41 b Fj(DRAFT)30 b Fk(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 0 731 a Fo(Figure)c(1.2:)39 │ │ │ │ │ -b Fa(GRD7x7x7)p Fo(:)h(F)-8 b(our)26 b(tree)h(plots)g(for)f(a)g(7)12 │ │ │ │ │ +TeXDict begin 28 27 bop 0 100 a Fo(28)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 0 731 a Fo(Figure)c(1.2:)39 b Fa(GRD7x7x7)p │ │ │ │ │ +Fo(:)h(F)-8 b(our)26 b(tree)h(plots)g(for)f(a)g(7)12 │ │ │ │ │ b Ff(\002)g Fo(7)g Ff(\002)g Fo(7)27 b(grid)f(matrix)g(ordered)g(using) │ │ │ │ │ g(nested)g(dissection.)0 844 y(The)j(top)h(left)h(tree)g(measure)e(n)m │ │ │ │ │ (um)m(b)s(er)g(of)h(original)h(matrix)f(en)m(tries)h(in)f(a)g(fron)m │ │ │ │ │ (t.)40 b(The)30 b(top)g(righ)m(t)g(tree)h(measure)0 957 │ │ │ │ │ y(n)m(um)m(b)s(er)20 b(of)i(factor)h(matrix)f(en)m(tries)h(in)e(a)h │ │ │ │ │ (fron)m(t.)38 b(The)22 b(b)s(ottom)g(left)g(tree)h(measure)e(n)m(um)m │ │ │ │ │ (b)s(er)g(of)h(factor)h(op)s(erations)0 1070 y(in)30 │ │ │ │ │ @@ -12020,17 +12012,17 @@ │ │ │ │ │ 60 60 480 480 rectstroke │ │ │ │ │ │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial 3879 5026 V 1965 5029 1918 4 v eop end │ │ │ │ │ %%Page: 29 29 │ │ │ │ │ -TeXDict begin 29 28 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(29)227 399 y(of)j(this)g(sup)s(erno)s(de)d │ │ │ │ │ +TeXDict begin 29 28 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(29)227 399 y(of)j(this)g(sup)s(erno)s(de)d │ │ │ │ │ (amalgamation)36 b(or)e(relaxation.\))53 b Fj(Splitting)34 │ │ │ │ │ b Fo(a)g(fron)m(t)g(means)f(breaking)h(a)g(fron)m(t)g(up)227 │ │ │ │ │ 511 y(in)m(to)39 b(a)f(c)m(hain)g(of)g(smaller)g(fron)m(ts;)j(this)d │ │ │ │ │ (allo)m(ws)h(more)e(pro)s(cessors)g(to)i(w)m(ork)f(on)f(the)h(original) │ │ │ │ │ h(fron)m(t)e(in)227 624 y(a)g(straigh)m(tforw)m(ard)f(manner.)57 │ │ │ │ │ b(The)35 b(new)h(fron)m(t)g(tree)g(is)g(optionally)i(written)e(to)g(a)h │ │ │ │ │ (\014le.)57 b(Here)37 b(is)f(some)227 737 y(output)30 │ │ │ │ │ @@ -12191,17 +12183,17 @@ │ │ │ │ │ Fo(,)d(8)1992 4950 y Fn(ETree)p 2238 4950 V 33 w(splitFronts\(\))p │ │ │ │ │ Fo(,)i(14)1992 5064 y Fn(ETree)p 2238 5064 V 33 w(subtreeSubsetMap\(\)) │ │ │ │ │ p Fo(,)e(15)1992 5178 y Fn(ETree)p 2238 5178 V 33 w(transform\(\))p │ │ │ │ │ Fo(,)i(15)1992 5293 y Fn(ETree)p 2238 5293 V 33 w(transform2\(\))p │ │ │ │ │ Fo(,)g(15)1992 5407 y Fn(ETree)p 2238 5407 V 33 w(tree\(\))p │ │ │ │ │ Fo(,)h(3)1905 5656 y(30)p eop end │ │ │ │ │ %%Page: 31 31 │ │ │ │ │ -TeXDict begin 31 30 bop 91 100 1087 4 v 1269 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(31)0 399 y Fn(ETree)p 246 399 29 │ │ │ │ │ +TeXDict begin 31 30 bop 91 100 1106 4 v 1288 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(31)0 399 y Fn(ETree)p 246 399 29 │ │ │ │ │ 4 v 33 w(vtxToFront\(\))p Fo(,)c(4)0 511 y Fn(ETree)p │ │ │ │ │ 246 511 V 33 w(vtxToFrontIV\(\))p Fo(,)g(4)0 624 y Fn(ETree)p │ │ │ │ │ 246 624 V 33 w(wrapMap\(\))p Fo(,)h(15)0 737 y Fn(ETree)p │ │ │ │ │ 246 737 V 33 w(writeForHumanEye\(\))p Fo(,)e(18)0 850 │ │ │ │ │ y Fn(ETree)p 246 850 V 33 w(writeStats\(\))p Fo(,)h(18)0 │ │ │ │ │ 963 y Fn(ETree)p 246 963 V 33 w(writeToBinaryFile\(\))p │ │ │ │ │ Fo(,)e(18)0 1076 y Fn(ETree)p 246 1076 V 33 w(writeToFile\(\))p │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -21,15 +21,15 @@ │ │ │ │ │ │ • int nfront : number of fronts in the tree │ │ │ │ │ │ • int nvtx : number of vertices in the tree │ │ │ │ │ │ • Tree *tree : pointer to a Tree structure │ │ │ │ │ │ • IV *nodwghtsIV : pointer to an IV object to hold front weights, size nfront │ │ │ │ │ │ • IV *bndwghtsIV : pointer to an IV object to hold the weights of the fronts’ boundaries, size │ │ │ │ │ │ nfront │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ • IV *vtxToFrontIV : pointer to an IV object to hold the map from vertices to fronts, size │ │ │ │ │ │ nfront │ │ │ │ │ │ A correctly initialized and nontrivial ETree object will have positive nfront and nvtx values, a │ │ │ │ │ │ valid tree field and non-NULL nodwghtsIV, bndwghtsIV and vtxToFrontIV pointers. │ │ │ │ │ │ 1.2 Prototypes and descriptions of ETree methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ ETree object. │ │ │ │ │ │ @@ -53,15 +53,15 @@ │ │ │ │ │ │ This method releases any storage by a call to ETree clearData() then free’s the storage for │ │ │ │ │ │ the structure with a call to free(). │ │ │ │ │ │ Error checking: If etree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.2 Instance methods │ │ │ │ │ │ 1. int ETree_nfront ( ETree *etree ) ; │ │ │ │ │ │ This method returns the number of fronts. │ │ │ │ │ │ Error checking: If etree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 3 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 3 │ │ │ │ │ │ 2. int ETree_nvtx ( ETree *etree ) ; │ │ │ │ │ │ This method returns the number of vertices. │ │ │ │ │ │ Error checking: If etree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. Tree * ETree_tree ( ETree *etree ) ; │ │ │ │ │ │ This method returns a pointer to the Tree object. │ │ │ │ │ │ Error checking: If etree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. int ETree_root ( ETree *etree ) ; │ │ │ │ │ │ @@ -86,15 +86,15 @@ │ │ │ │ │ │ 9. int * ETree_nodwghts ( ETree *etree ) ; │ │ │ │ │ │ This method returns a pointer to the nodwghts vector. │ │ │ │ │ │ Error checking: If etree or etree->nodwghtsIV is NULL, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 10. IV * ETree_bndwghtsIV ( ETree *etree ) ; │ │ │ │ │ │ This method returns a pointer to the bndwghtsIV object. │ │ │ │ │ │ Error checking: If etree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 4 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ 11. int * ETree_bndwghts ( ETree *etree ) ; │ │ │ │ │ │ This method returns a pointer to the bndwghts vector. │ │ │ │ │ │ Error checking: If etree or etree->bndwghtsIV is NULL, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 12. IV * ETree_vtxToFrontIV ( ETree *etree ) ; │ │ │ │ │ │ This method returns a pointer to the vtxToFrontIV object. │ │ │ │ │ │ Error checking: If etree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ @@ -121,15 +121,15 @@ │ │ │ │ │ │ Error checking: If etree is NULL, or if symflag is invalid, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 1.2.3 Initializer methods │ │ │ │ │ │ There are four initializer methods. │ │ │ │ │ │ 1. void ETree_init1 ( ETree *etree, int nfront, int nvtx ) ; │ │ │ │ │ │ This method initializes an ETree object given the number of fronts and number of vertices. │ │ │ │ │ │ Anyprevious data is cleared with a call to ETree clearData(), The Tree object is initialized │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 5 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 5 │ │ │ │ │ │ with a call to Tree init1(). The nodwghtsIV, bndwghtsIV and vtxToFrontIV objects are │ │ │ │ │ │ initialized with calls to IV init(). The entries in nodwghtsIV and bndwghtsIV are set to 0, │ │ │ │ │ │ while the entries in vtxToFrontIV are set to -1. │ │ │ │ │ │ Error checking: If etree is NULL, or if nfront is negative, or if nvtx < nfront, an error │ │ │ │ │ │ message is printed and the program exits. │ │ │ │ │ │ 2. void ETree_initFromGraph ( ETree *etree, Graph *g ) ; │ │ │ │ │ │ This method generates an elimination tree from a graph. The nodwghtsIV vector object is │ │ │ │ │ │ @@ -160,15 +160,15 @@ │ │ │ │ │ │ permutes to vertex-to-front map, and returns an IV object that contains the old-to-new │ │ │ │ │ │ permutation. │ │ │ │ │ │ Error checking: If etree is NULL or inETreeFileName is “none”, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 6. int ETree_initFromSubtree ( ETree *subtree, IV *nodeidsIV, ETree *etree, IV *vtxIV ) ; │ │ │ │ │ │ This method initializes subtree from tree using the nodes of etree that are found in │ │ │ │ │ │ nodeidsIV. The map from nodes in subtree to nodes in etree is returned in vtxIV. │ │ │ │ │ │ - 6 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ Return code: 1 for a normal return, -1 if subtree is NULL, -2 if nodeidsIV is NULL, -3 if │ │ │ │ │ │ etree is NULL, -4 if nodeidsIV is invalid, -5 if vtxIV is NULL. │ │ │ │ │ │ 1.2.4 Utility methods │ │ │ │ │ │ Theutility methods return the number of bytes taken by the object, or the number of factor indices, │ │ │ │ │ │ entries or operations required by the object. │ │ │ │ │ │ 1. int ETree_sizeOf ( ETree *etree ) ; │ │ │ │ │ │ This method returns the number of bytes taken by this object (which includes the bytes taken │ │ │ │ │ │ @@ -195,15 +195,15 @@ │ │ │ │ │ │ Error checking: If etree or tree is NULL, or if nfront < 1, or if nvtx < 1, or if type or │ │ │ │ │ │ symflag is invalid, an error message is printed and the program exits. │ │ │ │ │ │ 5. double ETree_nFactorEntriesInFront ( ETree *etree, int symflag, int J ) ; │ │ │ │ │ │ ThismethodreturnsthenumberofentriesinfrontJforanLU factorization. Thesymflagpa- │ │ │ │ │ │ rameter can be one of SPOOLES SYMMETRIC, SPOOLES HERMITIAN or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ Error checking: If etree or tree is NULL, or if nfront < 1, or if symflag is invalid, or if │ │ │ │ │ │ J < 0, or if J ≥ nfront, an error message is printed and the program exits. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 7 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 7 │ │ │ │ │ │ 6. double ETree_nInternalOpsInFront ( ETree *etree, int type, int symflag, int J ) ; │ │ │ │ │ │ ThismethodreturnsthenumberofinternaloperationsperformedbyfrontJonits(1,1), (2,1), │ │ │ │ │ │ and (1,2) blocks during a factorization. The type parameter can be one of SPOOLES REAL │ │ │ │ │ │ or SPOOLES COMPLEX. symflag must be one of SPOOLES SYMMETRIC, SPOOLES HERMITIAN or │ │ │ │ │ │ SPOOLES NONSYMMETRIC. │ │ │ │ │ │ Error checking: If etree or tree is NULL, or if nfront < 1, or if type or symflag is invalid, │ │ │ │ │ │ or if J < 0, or if J ≥ nfront, an error message is printed and the program exits. │ │ │ │ │ │ @@ -233,15 +233,15 @@ │ │ │ │ │ │ Error checking: If etree is NULL, or if type or symflag is invalid, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 11. ETree * ETree_expand ( ETree *etree, IV *eqmapIV ) ; │ │ │ │ │ │ This method creates and returns an ETree object for an uncompressed graph. The map from │ │ │ │ │ │ compressed vertices to uncompressed vertices is found in the eqmapIV object. │ │ │ │ │ │ Error checking: If etree or eqmapIV is NULL, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - 8 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ 12. ETree * ETree_spliceTwoEtrees ( ETree *etree0, Graph *graph, IV *mapIV, ETree *etree1 ) ; │ │ │ │ │ │ This method creates and returns an ETree object that is formed by splicing together two │ │ │ │ │ │ front trees, etree0 for the vertices the eliminated domains, etree1 for the vertices the Schur │ │ │ │ │ │ complement. The mapIV object maps vertices to domains or the Schur complement — if the │ │ │ │ │ │ entry is 0, the vertex is in the Schur complement, otherwise it is in a domain. │ │ │ │ │ │ Error checking: If etree0, graph, mapIV or etree1 is NULL, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ @@ -266,15 +266,15 @@ │ │ │ │ │ │ 3. DV * ETree_nopsMetric ( ETree *etree, int type, int symflag ) ; │ │ │ │ │ │ AnDVobjectofsize nfrontis created and returned. Each entry of the vector is filled with the │ │ │ │ │ │ number of factor operations associated with the corresponding front. The type parameter │ │ │ │ │ │ can be one of SPOOLES REAL or SPOOLES COMPLEX. The symflag parameter can be one of │ │ │ │ │ │ SPOOLES SYMMETRIC, SPOOLES HERMITIAN or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ Error checking: If etree is NULL, or if nfront < 1, or if nvtx < 1, or if type or symflag is │ │ │ │ │ │ invalid, an error message is printed and the program exits. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 9 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 9 │ │ │ │ │ │ 1.2.6 Compression methods │ │ │ │ │ │ Frequently an ETree object will need to be compressed in some manner. Elimination trees usually │ │ │ │ │ │ have long chains of vertices at the higher levels, where each chain of vertices corresponds to a │ │ │ │ │ │ supernode. Liu’s generalized row envelope methods partition the vertices by longest chains [?]. In │ │ │ │ │ │ both cases, we can construct a map from each node to a set of nodes to define a smaller, more │ │ │ │ │ │ compact ETree object. Given such a map, we construct the smaller etree. │ │ │ │ │ │ Afundamental chain is a set of vertices v ,...,v such that │ │ │ │ │ │ @@ -308,15 +308,15 @@ │ │ │ │ │ │ Error checking: If etree or tree is NULL, or if nfront < 1, or if nvtx < 1, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 2. IV * ETree_fundSupernodeMap ( ETree *etree ) ; │ │ │ │ │ │ An IV object of size nfront is created, filled with the map from vertices to fundamental │ │ │ │ │ │ supernodes, then returned. │ │ │ │ │ │ Error checking: If etree or tree is NULL, or if nfront < 1, or if nvtx < 1, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ - 10 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ 3. ETree * ETree_compress ( ETree *etree, IV *frontMapIV ) ; │ │ │ │ │ │ Using frontMapIV, a new ETree object is created and returned. If frontMapIV does not │ │ │ │ │ │ define each inverse map of a new node to be connected set of nodes in the old ETree object, │ │ │ │ │ │ the new ETree object will not be well defined. │ │ │ │ │ │ Error checking: If etree or frontMapIV is NULL, or if nfront < 1, or if nvtx < 1, an error │ │ │ │ │ │ message is printed and the program exits. │ │ │ │ │ │ 1.2.7 Justification methods │ │ │ │ │ │ @@ -342,15 +342,15 @@ │ │ │ │ │ │ 1. IV * ETree_newToOldFrontPerm ( ETree *etree ) ; │ │ │ │ │ │ IV * ETree_oldToNewFrontPerm ( ETree *etree ) ; │ │ │ │ │ │ An IV object is created with size nfront. A post-order traversal of the Tree object fills │ │ │ │ │ │ the new-to-old permutation. A reversal of the new-to-old permutation gives the old-to-new │ │ │ │ │ │ permutation. Both methods are simply wrappers around the respective Tree methods. │ │ │ │ │ │ Error checking: If etree is NULL, or if nfront < 1, or if nvtx < 1, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 11 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 11 │ │ │ │ │ │ 2. IV * ETree_newToOldVtxPerm ( ETree *etree ) ; │ │ │ │ │ │ IV * ETree_oldToNewVtxPerm ( ETree *etree ) ; │ │ │ │ │ │ AnIVobject is created with size nvtx. First we find a new-to-old permutation of the fronts. │ │ │ │ │ │ Then we search over the fronts in their new order to fill the vertex new-to-old permutation │ │ │ │ │ │ vector. The old-to-new vertex permutation vector is found by first finding the new-to-old │ │ │ │ │ │ vertex permutation vector, then inverting it. │ │ │ │ │ │ Error checking: If etree is NULL, or if nfront < 1, or if nvtx < 1, an error message is printed │ │ │ │ │ │ @@ -380,15 +380,15 @@ │ │ │ │ │ │ of the subtree is more than cutoff times the vertex weight, the vertex is in the multisector. │ │ │ │ │ │ Error checking: If etree is NULL, or if nfront < 1, or if nvtx < 1, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 3. IV * ETree_msByNentCutoff ( ETree *etree, double cutoff, int symflag ) ; │ │ │ │ │ │ An IV object is created to hold the multisector nodes and returned. Multisector nodes │ │ │ │ │ │ have their component id zero, domain nodes have their component id one. Inclusion in the │ │ │ │ │ │ multisector is based on the number of factor entries in the subtree that a vertex belongs, or │ │ │ │ │ │ - 12 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ strictly speaking, the number of factor entries in the subtree of the front to which a vertex │ │ │ │ │ │ belongs. If weight of the subtree is more than cutoff times the number of factor entries, │ │ │ │ │ │ the vertex is in the multisector. The symflag parameter can be one of SPOOLES SYMMETRIC, │ │ │ │ │ │ SPOOLES HERMITIAN or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ Error checking: If etree is NULL, or if nfront < 1, or if nvtx < 1, or if symflag is invalid, │ │ │ │ │ │ an error message is printed and the program exits. │ │ │ │ │ │ 4. IV * ETree_msByNopsCutoff ( ETree *etree, double cutoff, int type, int symflag ) ; │ │ │ │ │ │ @@ -423,15 +423,15 @@ │ │ │ │ │ │ ∂J,J ∂J,J J,J │ │ │ │ │ │ α = 0, we minimize active storage, when α = 1, we minimize solve operations. On return, │ │ │ │ │ │ *ptotalgain is filled with the total gain. The return value is a pointer to compidsIV, where │ │ │ │ │ │ compids[J] = 0 means that J is in the Schur complement, and compids[J] != 0 means │ │ │ │ │ │ that J is in domain compids[J]. │ │ │ │ │ │ Error checking: If etree, graph or symbfacIVL is NULL, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 13 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 13 │ │ │ │ │ │ 1.2.10 Transformation methods │ │ │ │ │ │ Often the elimination tree or front tree that we obtain from an ordering of the graph is not as │ │ │ │ │ │ appropriate for a factorization as we would like. There are two important cases. │ │ │ │ │ │ • Near the leaves of the tree the fronts are typically small in size. There is an overhead │ │ │ │ │ │ associated with each front, and though the overhead varies with regard to the factorization │ │ │ │ │ │ algorithm, it can be beneficial to group small subtrees together into one front. The expense is │ │ │ │ │ │ added storage for the logically zero entries and the factor operations on them. In this library, │ │ │ │ │ │ @@ -464,15 +464,15 @@ │ │ │ │ │ │ restriction. │ │ │ │ │ │ • The method ETree mergeFrontsAll() tries to merge a front with all of its children, if the │ │ │ │ │ │ resulting front does not contain too many zero entries. This has the effect of merging small │ │ │ │ │ │ bushy subtrees, but will not merge a top level separator with one of its children. │ │ │ │ │ │ For a serial application, ETree mergeFrontsAny()is suitable. For a parallel application, we recom- │ │ │ │ │ │ mend first using ETree mergeFrontsOne() followed by ETree mergeFrontsAll(). See the driver │ │ │ │ │ │ programs testTransform and mkNDETree for examples of how to call the methods. │ │ │ │ │ │ - 14 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 14 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ 1. ETree * ETree_mergeFrontsOne ( ETree *etree, int maxzeros, IV *nzerosIV ) ; │ │ │ │ │ │ This method only tries to merge a front with its only child. It returns an ETree object where │ │ │ │ │ │ one or more subtrees that contain multiple fronts have been merged into single fronts. The │ │ │ │ │ │ parameter that governs the merging process is maxzeros, the number of zero entries that can │ │ │ │ │ │ be introduced by merging a child and parent front together. On input, nzerosIV contains │ │ │ │ │ │ the number of zeros presently in each front. It is modified on output to correspond with the │ │ │ │ │ │ new front tree. This method only tries to merge a front with its only child. │ │ │ │ │ │ @@ -505,15 +505,15 @@ │ │ │ │ │ │ is NULL, then the vertices have unit weight. The way the vertices in a front to be split are │ │ │ │ │ │ assigned to smaller fronts is random; the seed parameter is a seed to a random number │ │ │ │ │ │ generator that permutes the vertices in a front. │ │ │ │ │ │ Error checking: If etree is NULL, or if nfront < 1, or if nvtx < 1, or if maxfrontsize ≤ 0, │ │ │ │ │ │ an error message is printed and the program exits. │ │ │ │ │ │ 5. ETree * ETree_transform ( ETree *etree, int vwghts[], int maxzeros, │ │ │ │ │ │ int maxfrontsize, int seed ) ; │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 15 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 15 │ │ │ │ │ │ ETree * ETree_transform2 ( ETree *etree, int vwghts[], int maxzeros, │ │ │ │ │ │ int maxfrontsize, int seed ) ; │ │ │ │ │ │ These methods returns an ETree object where one or more subtrees that contain multiple │ │ │ │ │ │ fronts have been merged into single fronts and where one or more large fronts have been split │ │ │ │ │ │ into smaller fronts. The two methods differ slightly. ETree transform2() is better suited │ │ │ │ │ │ for parallel computing because it tends to preserve the tree branching properties. (A front is │ │ │ │ │ │ merged with either an only child or all children. ETree transform() can merge a front with │ │ │ │ │ │ @@ -544,15 +544,15 @@ │ │ │ │ │ │ where the fronts are visited in a post-order traversal of the tree and a front is assigned │ │ │ │ │ │ to a thread or processor with the least number of accumulated operations thus far. │ │ │ │ │ │ • The subtree-subset map is the most complex, where subsets of threads or processors are │ │ │ │ │ │ assigned to subtrees via a pre-order traversal of the tree. (Each root of the tree can be │ │ │ │ │ │ assigned to all processors.) The tree is then visited in a post-order traversal, and each │ │ │ │ │ │ front is assigned to an eligible thread or processor with the least number of accumulated │ │ │ │ │ │ ops so far. │ │ │ │ │ │ - 16 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 16 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ • The domain decomposition map is also complex, where domains are mapped to threads, │ │ │ │ │ │ then the fronts in the schur complement are mapped to threads, both using independent │ │ │ │ │ │ balanced maps. The method ETree ddMapNew() is more robust than ETree ddMap(), │ │ │ │ │ │ and is more general in the sense that it takes a multisector vector as input. The msIV │ │ │ │ │ │ object is a map from the vertices to {0,1}. A vertex mapped to 0 lies in the Schur │ │ │ │ │ │ complement, a vertex mapped to 1 lies in a domain. │ │ │ │ │ │ Error checking: If etree or cumopsDV is NULL, or if type or symflag is invalid, an error │ │ │ │ │ │ @@ -580,15 +580,15 @@ │ │ │ │ │ │ can be one of SPOOLES SYMMETRIC, SPOOLES HERMITIAN or SPOOLES NONSYMMETRIC. │ │ │ │ │ │ Error checking: If etree or dvec are NULL, or if symflag is invalid, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 4. void ETree_forwSolveProfile ( ETree *etree, double dvec[] ) ; │ │ │ │ │ │ Onreturn, dvec[J] contains the amount of stack storage to solve for J using the multifrontal- │ │ │ │ │ │ based forward solve. │ │ │ │ │ │ Error checking: If etree or dvec are NULL, an error message is printed and the program exits. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 17 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 17 │ │ │ │ │ │ 5. void ETree_backSolveProfile ( ETree *etree, double dvec[] ) ; │ │ │ │ │ │ Onreturn, dvec[J] contains the amount of stack storage to solve for J using the multifrontal- │ │ │ │ │ │ based backward solve. │ │ │ │ │ │ Error checking: If etree or dvec are NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.13 IO methods │ │ │ │ │ │ There are the usual eight IO routines. The file structure of a tree object is simple: nfront, nvtx, │ │ │ │ │ │ a Tree object followed by the nodwghtsIV, bndwghtsIV and vtxToFrontIV objects. │ │ │ │ │ │ @@ -615,15 +615,15 @@ │ │ │ │ │ │ Error checking: If etree or fn are NULL, or if fn is not of the form *.etreef (for a formatted │ │ │ │ │ │ file) or *.etreeb (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ 5. int ETree_writeToFormattedFile ( ETree *etree, FILE *fp ) ; │ │ │ │ │ │ This method writes an ETree object to a formatted file. Otherwise, the data is written to │ │ │ │ │ │ the file. If there are no errors in writing the data, the value 1 is returned. If an IO error is │ │ │ │ │ │ encountered from fprintf, zero is returned. │ │ │ │ │ │ Error checking: If etree or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - 18 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 18 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ 6. int ETree_writeToBinaryFile ( ETree *etree, FILE *fp ) ; │ │ │ │ │ │ This method writes an ETree object to a binary file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fwrite, zero is returned. │ │ │ │ │ │ Error checking: If etree or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 7. int ETree_writeForHumanEye ( ETree *etree, FILE *fp ) ; │ │ │ │ │ │ This method writes an ETree object to a file in a readable format. Otherwise, the method │ │ │ │ │ │ ETree writeStats() is called to write out the header and statistics. Then the parent, first │ │ │ │ │ │ @@ -650,15 +650,15 @@ │ │ │ │ │ │ • The inPermFile parameter is the input file for the Perm object. It must be of the form │ │ │ │ │ │ *.permfor*.permb. ThePermobjectisreadfromthefileviathePerm readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The outIVfile parameter is the output file for the vertex-to-front map IV object. │ │ │ │ │ │ If outIVfile is none then the IV object is not written to a file. Otherwise, the │ │ │ │ │ │ IV writeToFile()methodis called to write the object to a formatted file (if outIVfile │ │ │ │ │ │ is of the form *.ivf), or a binary file (if outIVfile is of the form *.ivb). │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 19 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 19 │ │ │ │ │ │ • TheoutETreeFileparameter is the output file for the ETree object. If outETreeFileis │ │ │ │ │ │ nonethentheETreeobjectisnotwrittentoafile. Otherwise,theETree writeToFile() │ │ │ │ │ │ method is called to write the object to a formatted file (if outETreeFile is of the form │ │ │ │ │ │ *.etreef), or a binary file (if outETreeFile is of the form *.etreeb). │ │ │ │ │ │ 2. extractTopSep msglvl msgFile inETreeFile outIVfile │ │ │ │ │ │ ThisdriverprogramcreatesanIVobjectthatcontainsacompids[]vector, wherecompids[v] │ │ │ │ │ │ = 0 if vertex v is in the top level separator and -1 otherwise. The IV object is optionally │ │ │ │ │ │ @@ -689,15 +689,15 @@ │ │ │ │ │ │ Here is some typical output for a 15×15×15 grid matrix with maxzeros = 64 and maxsize │ │ │ │ │ │ = 32. │ │ │ │ │ │ vtx tree : 3375 fronts, 367237 indices, 367237 |L|, 63215265 ops │ │ │ │ │ │ fs tree : 1023 fronts, 39661 indices, 367237 |L|, 63215265 ops │ │ │ │ │ │ merge1 : 1023 fronts, 39661 indices, 367237 |L|, 63215265 ops │ │ │ │ │ │ merge2 : 511 fronts, 29525 indices, 373757 |L|, 63590185 ops │ │ │ │ │ │ split : 536 fronts, 34484 indices, 373757 |L|, 63590185 ops │ │ │ │ │ │ - 20 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 20 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the ETree object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • n1 is the number of grid points in the first direction. │ │ │ │ │ │ • n2 is the number of grid points in the second direction. │ │ │ │ │ │ @@ -729,15 +729,15 @@ │ │ │ │ │ │ • n3 is the number of grid points in the third direction. │ │ │ │ │ │ • The maxzeros parameter is an upper bound on the number of logically zero entries that │ │ │ │ │ │ will be allowed in a new front. │ │ │ │ │ │ • The maxsize parameter is an upper bound on the number of vertices in a front — any │ │ │ │ │ │ original front that contains more than maxsize vertices will be broken up into smaller │ │ │ │ │ │ fronts. │ │ │ │ │ │ • The nthread parameter is the number of threads. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 21 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 21 │ │ │ │ │ │ • The maptype parameter is the type of map. │ │ │ │ │ │ – 1 — wrap map │ │ │ │ │ │ – 2 — balanced map │ │ │ │ │ │ – 3 — subtree-subset map │ │ │ │ │ │ – 4 — domain decomposition map │ │ │ │ │ │ • The cutoff parameter is used by the domain decomposition map only. Try setting │ │ │ │ │ │ cutoff = 1/nthread or cutoff = 1/(2*nthread). │ │ │ │ │ │ @@ -771,15 +771,15 @@ │ │ │ │ │ │ nonethentheETreeobjectisnotwrittentoafile. Otherwise,theETree writeToFile() │ │ │ │ │ │ method is called to write the object to a formatted file (if outETreeFile is of the form │ │ │ │ │ │ *.etreef), or a binary file (if outETreeFile is of the form *.etreeb). │ │ │ │ │ │ • The outIVFile parameter is the output file for the old-to-new IV object. If outIVFile │ │ │ │ │ │ is none then the IV object is not written to a file. Otherwise, the IV writeToFile() │ │ │ │ │ │ method is called to write the object to a formatted file (if outIVFile is of the form │ │ │ │ │ │ *.ivf), or a binary file (if outIVFile is of the form *.ivb). │ │ │ │ │ │ - 22 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 22 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ 6. testExpand msglvl msgFile inETreeFile inEqmapFile outETreeFile │ │ │ │ │ │ This driver program is used to translate an ETree object for a compressed graph into an │ │ │ │ │ │ ETree object for the unit weight graph. │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the ETree object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ @@ -812,15 +812,15 @@ │ │ │ │ │ │ • TheinETreeFileparameteristheinputfilefortheETreeobject. It mustbeof theform │ │ │ │ │ │ *.etreefor*.etreeb. TheETreeobjectisreadfromthefileviatheETree readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • If labelflag = 1, the node ids are written on the nodes in the two plots. │ │ │ │ │ │ • Each node will have a circle with radius radius. │ │ │ │ │ │ • The firstEPSfile and secondEPSfile parameters is the output EPS file for the two │ │ │ │ │ │ plots. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 23 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 23 │ │ │ │ │ │ Figure 1.1: GRD7x7: Working storage for the forward sparse factorization of the nested dissection │ │ │ │ │ │ b │ │ │ │ │ │ ordering. On the left is the storage required to factor J and its update matrix. On the right is the │ │ │ │ │ │ storage required to factor J and all of its ancestors. Both plots have the same scale. │ │ │ │ │ │ 29 30 14 22 16 10 4 │ │ │ │ │ │ 23 15 11 3 │ │ │ │ │ │ 26 25 24 19 18 17 12 8 7 5 1 0 │ │ │ │ │ │ @@ -846,15 +846,15 @@ │ │ │ │ │ │ method. │ │ │ │ │ │ 9. testIO msglvl msgFile inFile outFile │ │ │ │ │ │ This driver program reads and writes ETree files, useful for converting formatted files to │ │ │ │ │ │ binary files and vice versa. One can also read in a ETree file and print out just the header │ │ │ │ │ │ information (see the ETree writeStats() method). │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the ETree object is written to the message file. │ │ │ │ │ │ - 24 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 24 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The inFile parameter is the input file for the ETree object. It must be of the form │ │ │ │ │ │ *.etreefor*.etreeb. TheETreeobjectisreadfromthefileviatheETree readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The outFile parameter is the output file for the ETree object. If outFile is none then │ │ │ │ │ │ @@ -886,15 +886,15 @@ │ │ │ │ │ │ Thecutoff defines the multisector, 0 ≤ cutoff ≤ 1. If front J has a subtree metric based │ │ │ │ │ │ on forward operations that is greater than or equalt to cutoff times the total number │ │ │ │ │ │ of operations, then front J belongs to the multisector. │ │ │ │ │ │ 11. testMS msglvl msgFile inETreeFile outIVfile flag cutoff │ │ │ │ │ │ This program is used to extract a multisector from a front tree ETree object. It partitions the │ │ │ │ │ │ vertices into domains and a multisector, where each domain is a subtree of the elimination │ │ │ │ │ │ tree and the multisector is the rest of the vertices. The choice of the subtrees depends on │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 25 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 25 │ │ │ │ │ │ the flag and cutoff parameters — it can be based on depth of a subtree or the number of │ │ │ │ │ │ vertices, factor entries or factor operations associated with the subtree. The component ids │ │ │ │ │ │ IV object is optionally written to a file. Here is some sample output for BCSSTK30 ordered by │ │ │ │ │ │ nested dissection, where the multisector is defined by subtree vertex weight (flag = 2) with │ │ │ │ │ │ cutoff = 0.125. │ │ │ │ │ │ region vertices entries operations metric/(avg domain) │ │ │ │ │ │ 0 1671 597058 255691396 0.797 2.201 3.967 │ │ │ │ │ │ @@ -927,15 +927,15 @@ │ │ │ │ │ │ • TheinETreeFileparameteristheinputfilefortheETreeobject. It mustbeof theform │ │ │ │ │ │ *.etreefor*.etreeb. TheETreeobjectisreadfromthefileviatheETree readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The outIVFile parameter is the output file for the IV object. If outIVFile is none │ │ │ │ │ │ then the IV object is not written to a file. Otherwise, the IV writeToFile() method is │ │ │ │ │ │ called to write the object to a formatted file (if outIVFile is of the form *.ivf), or a │ │ │ │ │ │ binary file (if outIVFile is of the form *.ivb). │ │ │ │ │ │ - 26 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 26 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ • The flag parameter specifies the type of multisector. │ │ │ │ │ │ – flag == 1 — the multisector is based on the depth of the front, i.e., if the front is │ │ │ │ │ │ more than depth steps removed from the root, it forms the root of a domain. │ │ │ │ │ │ – flag == 2 — the multisector is based on the number of vertices in a subtree, i.e., │ │ │ │ │ │ if the subtree rooted at a front contains more than cutoff times the total number │ │ │ │ │ │ of vertices, it is a domain. │ │ │ │ │ │ – flag == 3 — the multisector is based on the number of factor entries in a subtree, │ │ │ │ │ │ @@ -967,15 +967,15 @@ │ │ │ │ │ │ data. │ │ │ │ │ │ • TheinETreeFileparameteristheinputfilefortheETreeobject. It mustbeof theform │ │ │ │ │ │ *.etreefor*.etreeb. TheETreeobjectisreadfromthefileviatheETree readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • TheinGraphFileparameteristheinputfilefortheGraphobject. It mustbeof theform │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 27 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 27 │ │ │ │ │ │ • The outEPSfile parameter is the name of the EPS file to hold the tree. │ │ │ │ │ │ • The metricType parameter defines the type of metric to be illustrated. See above for │ │ │ │ │ │ values. │ │ │ │ │ │ • For information about the heightflag and coordflag parameters, see Section ??. │ │ │ │ │ │ • If labelflag = 1, the node ids are written on the nodes in the two plots. │ │ │ │ │ │ • The fontscale parameter is the font size when labels are drawn. │ │ │ │ │ │ 13. testStorage msglvl msgFile inETreeFile inGraphFile │ │ │ │ │ │ @@ -1007,21 +1007,21 @@ │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ 14. testTransform msglvl msgFile inETreeFile inGraphFile │ │ │ │ │ │ outETreeFile maxzeros maxsize seed │ │ │ │ │ │ This driver program is used to transform a front tree ETree object into a (possibly) merged │ │ │ │ │ │ and (possibly) split front tree. Merging the front tree means combining fronts together that │ │ │ │ │ │ do not introduce more than maxzeros zero entries in a front. (See [?] and [?] for a description │ │ │ │ │ │ - 28 ETree : DRAFT February 8, 2025 │ │ │ │ │ │ + 28 ETree : DRAFT January 7, 2024 │ │ │ │ │ │ Figure 1.2: GRD7x7x7: Four tree plots for a 7×7×7 grid matrix ordered using nested dissection. │ │ │ │ │ │ The top left tree measure number of original matrix entries in a front. The top right tree measure │ │ │ │ │ │ numberoffactormatrixentries inafront. Thebottomlefttree measurenumberoffactor operations │ │ │ │ │ │ in a front for a forward looking factorization, e.g., forward sparse. The bottom right tree measure │ │ │ │ │ │ number of factor operations in a front for a backward looking factorization, e.g., general sparse. │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 29 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 29 │ │ │ │ │ │ of this supernode amalgamation or relaxation.) Splitting a front means breaking a front up │ │ │ │ │ │ into a chain of smaller fronts; this allows more processors to work on the original front in │ │ │ │ │ │ a straightforward manner. The new front tree is optionally written to a file. Here is some │ │ │ │ │ │ output for the R3D13824 matrix using maxzeros = 1000 and maxsize = 64. │ │ │ │ │ │ CPU #fronts #indices #entries #ops │ │ │ │ │ │ original : 6001 326858 3459359 1981403337 │ │ │ │ │ │ merge one : 0.209 3477 158834 3497139 2000297117 │ │ │ │ │ │ @@ -1094,15 +1094,15 @@ │ │ │ │ │ │ ETree mergeFrontsAll(), 14 ETree spliceTwoEtrees(), 8 │ │ │ │ │ │ ETree mergeFrontsAny(), 14 ETree splitFronts(), 14 │ │ │ │ │ │ ETree mergeFrontsOne(), 14 ETree subtreeSubsetMap(), 15 │ │ │ │ │ │ ETree MFstackProfile(), 16 ETree transform(), 15 │ │ │ │ │ │ ETree msByDepth(), 11 ETree transform2(), 15 │ │ │ │ │ │ ETree msByNentCutoff(), 11 ETree tree(), 3 │ │ │ │ │ │ 30 │ │ │ │ │ │ - ETree : DRAFT February 8, 2025 31 │ │ │ │ │ │ + ETree : DRAFT January 7, 2024 31 │ │ │ │ │ │ ETree vtxToFront(), 4 │ │ │ │ │ │ ETree vtxToFrontIV(), 4 │ │ │ │ │ │ ETree wrapMap(), 15 │ │ │ │ │ │ ETree writeForHumanEye(), 18 │ │ │ │ │ │ ETree writeStats(), 18 │ │ │ │ │ │ ETree writeToBinaryFile(), 18 │ │ │ │ │ │ ETree writeToFile(), 17 │ │ │ ├── ./usr/share/doc/spooles-doc/Eigen.ps.gz │ │ │ │ ├── Eigen.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Eigen.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1595,21 +1595,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1793,88 +1792,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -6536,25 +6530,23 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 66 /B put │ │ │ │ │ dup 67 /C put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ dup 74 /J put │ │ │ │ │ dup 80 /P put │ │ │ │ │ dup 87 /W put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 102 /f put │ │ │ │ │ dup 103 /g put │ │ │ │ │ dup 104 /h put │ │ │ │ │ dup 105 /i put │ │ │ │ │ dup 107 /k put │ │ │ │ │ @@ -6745,193 +6737,180 @@ │ │ │ │ │ 82032FBD2FCB6E403D34B85ED4053A8CB619BDD4DE001F4C3007B1F317579651 │ │ │ │ │ E6D6662189CC2D95AB85D7473F65C5D7B4AC63B0FE928F3400035D5A9D443D0D │ │ │ │ │ F3532B99F3AC26CB25EA3CD64C341159061E02EFBC7C033C05CD919BBD827A6A │ │ │ │ │ BFCF3BD739E32E7FE909AEE068D50FAC33605FFF98C7D0115FB860178FD03DB9 │ │ │ │ │ 7985B78E0AC21F2EA065FA841F5928FB85163B2E2D8F850DC7EE313912C45C28 │ │ │ │ │ 2783F6762C67882EFEDDC7E7567F91C16B16FD8D5A1ABF35B5586307701B91AD │ │ │ │ │ 54984598F2AD46FEE3D68A2731BEAA754C8E730FE0E84952EF77930E4118F8D7 │ │ │ │ │ -2F3AD7547D3E54167FB0B315756753DC0DF935CC3D1CBB93A9A575EBF5BBB34F │ │ │ │ │ -2CBD38692849D484C11BB5CF75F095251A87F37EC4727933F21C3932EEE24157 │ │ │ │ │ -6C7AFD8361708C885FA63C37FCEC2057BBC47FBA727F94569921D2F4B8F0DB6A │ │ │ │ │ -2E398A672F4122E3B1E3B4EE28D0AB51662DAA00AC11C2A9FED18429ACED7465 │ │ │ │ │ -4F427E7965A7CAE7FDBE67EAAE97D91A082303BCADE1B1361D66DCB0CB8BFC7E │ │ │ │ │ -107366EB90AE246B2C8528DDBA2E621C4382FD8516E071B813A5BDE514EE30D4 │ │ │ │ │ -C647C8877BAD1BFDF9D6068AC5537C48EDC2B9D1BA2E90D4FC2D8B2B28547E0F │ │ │ │ │ -0CA3F834903BD3E34D8D041778BA8D03914A0FAD861C76BE8DADC6F2409E58ED │ │ │ │ │ -F00A13ED0D7A32B44DDD2E55068F610132BD988276F1B9FC6D87C0895E6F3F11 │ │ │ │ │ -470BCB2863BB76B4A2DEF9A4B0E84D2141C43C205C777F8AB1AD08D738B0B5DB │ │ │ │ │ -677A0E889A98A0FA33D9C380D1B5D3DEEF9B3697B1D207633BE95C3ED360929A │ │ │ │ │ -233CD0AB73CC2A8674AA86DE3E9E75781252B59E4C8A69D91A88CBCDAD3BA46E │ │ │ │ │ -F66CBE9CADB844A7A817BD4878D6B0259A579E7362101052F796A3E4572764C9 │ │ │ │ │ -EA7FFD253DAAF4365F588B5E15836E9A78C1D3F69B29F53BC5E34A57318E3627 │ │ │ │ │ -4644E0294B6CE43312A3E1C75B675B1E37EFF5802D679AB56F88C2E08549559A │ │ │ │ │ -53CE33C8895A478E514B728F9B5D5D1FC78F5CC1A5B3AB19516D296FB75CBB52 │ │ │ │ │ -51AFA76EC5EB0A550BDEBC2D16057284BF9EFB0B719C21C239AF92F3A73415D8 │ │ │ │ │ -2B1EAE87EF1575DF5E9832CD4B0652A7CB6EEDA6768BC0F9DFE72D1EE59ECF98 │ │ │ │ │ -28ADC23469EC8642C8C4410E524DB9D5CE5C0C8D43049861955872149394615C │ │ │ │ │ -C9ED7B3CD89B2DEDCAD585C6E45020D372020EC9EE51953E9C5757C36127222B │ │ │ │ │ -FBB70B06BA239A77AD997F1D951A2C823A63E33A6075168DFC362BCAE57A51B6 │ │ │ │ │ -4A1A536F1E3934D11370CFB7D85D483993169243AC59BE6FEA4360D88DB11414 │ │ │ │ │ -672BBCB55A80E1B3BD0E5075C09A702205B029E3D453AF9016ADCFE509FB66D5 │ │ │ │ │ -7CF32254BD026B70ADDFA2E79C2A59FA6F9FC28E4049DF092223A310E5872A8E │ │ │ │ │ -9A63F8614E948ACB34B27AC4CFD2BD5E25225E4F2CD76C97C117E6680B76A082 │ │ │ │ │ -708C0FD16B179130649A1FDC0781C839C7F327A698DCF7F410CCAFF160A31565 │ │ │ │ │ -DBDB40DAF16CE628941CEDB31E1BDD0190AEB798B8DE0C875D335F37ABCF77D4 │ │ │ │ │ -008F629863B253E17F1E17564EB3F502CCB68A2D84F6303429DD9B7DD4ED19B9 │ │ │ │ │ -7F6628B882675EC1F35004E39171797FC3F939EA09F6D8A5CEC65DF4AF9DA6BD │ │ │ │ │ -6D791319773EB948405BB4F6ED49B406BBC97057CD80E58A5168D107559F6CDC │ │ │ │ │ -527356F5F05C6E03EE6B5279DE1091896D81BD862A82BF0EA1BC371017DF3726 │ │ │ │ │ -B1D096E2D13585CB4C5077F9DACA212F5E07AAEA8E86F5F5B72BF68EA0C256D0 │ │ │ │ │ -B6342B7CBCC6849E5E44E713965005D62DE72A8B954F502AB23703E65E1CC91B │ │ │ │ │ -D34E5CE8EC2B2348D05D09615E22540705336E6A95FDE744D5E5F4A519D8757C │ │ │ │ │ -5BC7F88A86A6943AF3C8B2E357E6B3A4A1FEBC963D07178F538A1AD1025DD9F1 │ │ │ │ │ -5BB8AB214EB33B9C42F7BFDEC8A1D8184EBB11752A7BDA247E0ACD14D95BA95F │ │ │ │ │ -56BB985359EA31F91ED81B503DD0B40FF544EBC09CCE5E4BFDB0C0CCF4208DBA │ │ │ │ │ -5AB4CF4E424ABE471D5EB65CA987EEAEB0F2685AA0E746EEEA33DD9050A28350 │ │ │ │ │ -AFE3009F4B5B5B5ECCEC57C8CC7CB77DD4231F5D1507D00891E1805BD5895184 │ │ │ │ │ -044C0B811D1976DB1BD502752FE1EFAEE3BE5BCF258FEDDD549FDF1424FB6672 │ │ │ │ │ -CE72F42F1889B7330BB131BEB67E3AD0FED57B706218782F36233F0BCF2B342C │ │ │ │ │ -CE35152599DEC1F20CB084C718A4EA2325808A92780A641D84D816274C9F9A7D │ │ │ │ │ -676EFB7F52903DA62807533D3B1EFACC741550397679ECC913387F02C6E4A668 │ │ │ │ │ -145E838A1B9391BA0E5BC9BA4F06655D678C12E29DAD4B056424FB1C167A49A9 │ │ │ │ │ -C0B6F2651EE23226A9CDD1A1DF233E7655D9E047B2B97F76127C93B167FA8A70 │ │ │ │ │ -70EC2077BA2B30A84F29C8C01C56E5F7B1F4B539650A72EE8CE95E84FD38147F │ │ │ │ │ -BFAAEF52B33960EE216F1D73B34351EB5191095F80F2954F455A4F9830C02AD7 │ │ │ │ │ -AEE1C30C36274D8D6D7D932FB1F6FF9D34986A31A28617C32EBCA9E50EB56E29 │ │ │ │ │ -C78CBA4D979B2B9A831A485AB77E57FB3678DB05DCEF95A73A203D624100CB6D │ │ │ │ │ -101DCD50A71FBF5F3B5AD1F04508E4061CE78314BB982AEB934380EEB14F60EB │ │ │ │ │ -615C40416453D3DA4A409B40CA97E676438E363D10018389E543A07985142213 │ │ │ │ │ -15494BD703AA4F1B42BC85E1EF3E7284FA6D34D9CEE363DD9EC5205D3053750E │ │ │ │ │ -147B0BE35A810478163F0EFA68D2E0EB9256410A727E47F1F1DAD1CDEDCF2BD7 │ │ │ │ │ -38117EE88C030ABAFAC15CCCA8E1C07BBD1E9CCB2415C474C1C9E3B206E045AE │ │ │ │ │ -B1A119AB20F3F90001CBC69CE205576CBA2350D542751ACE5050E728A6BFBAA5 │ │ │ │ │ -00FD8B2835D1EAE135EB5A32BAA113D7C63D142DA51CFA06A16D11D7419E6015 │ │ │ │ │ -19A0B14368012FCB1AD39D06F10D21A911C626FD76091220D09940D7BAB243A0 │ │ │ │ │ -9CDA1ABBDBF73643F762EEE07C256C23823CE39775FB481638A5767140232293 │ │ │ │ │ -DD9D5899BF953DF87D4658310FCE9A231D1CDAB14BBD515F27BA8745440CC73B │ │ │ │ │ -636101CD3DC75847EFA606385BFD36F2107EB49434171E1469AE7F200BCD0CAB │ │ │ │ │ -953F8644D6A795E93920ADB7F73EDBA94173E79694947142C094788CC2391D25 │ │ │ │ │ -D7B946E031C7FA55ED24E387E929FB825CEE2EBCFF995694A417DF55282FE4C6 │ │ │ │ │ -0334719F2E515B97CD47DB04CD564A5F4B009DF220A34FE5E69B465C8BE8D3A8 │ │ │ │ │ -349C939C919274D29EB3EEB9B1D29B1C367B9E1E421678FC58376C94867A8D9B │ │ │ │ │ -3DC4CC9FD31524C1C285478F4F496F328DA948EB169BF0BF988C8102D3F38D85 │ │ │ │ │ -7AF448F2CDAAFF7CD07EE6782897F0EB677360B2A8EA6C24BC04CC40245E87BD │ │ │ │ │ -C1582DFF3413DDFE44176A53A6AB67C4C1F7BE9EC136E3674404232449BCCD0E │ │ │ │ │ -CF2A8EE04EB25186BC71350A65502FD5A336CFB0DC109B02A80626158F8F177A │ │ │ │ │ -D99C81B8E8F88FB70D19226011DF61BE532D77AA2FB499C252F9F3F57F4BB931 │ │ │ │ │ -B1228318E583D4CE3227D12D80F6C71FF2C6A454EB502CCB30F8E59BEDCFE0F1 │ │ │ │ │ -6EE319009F6B5D03DBA7EB8F869FAAC94B33E857144EABFCECCB935B84D517BF │ │ │ │ │ -BF7CE0CD28D41ADFD8AC13F380F8764E327DC505D04C7B75F8BCA9FF071102F2 │ │ │ │ │ -5DECDC911F7753E15DE9CF45D75CD34B0678D4484FA44B973529E93B69C3300E │ │ │ │ │ -ED18E423405497D6AA7578A988C8B9A0E720E3AF0A47B971B3E73EF086847211 │ │ │ │ │ -6B431E071335393E8AFE549FFAAD191FA60CCF84723FEDF10EAF02A0ADC6688E │ │ │ │ │ -4AEDD3E33F7FBDDA238693A27440FA6D0EC0C6FA15A2CBA2CC3E7336A2CA4E83 │ │ │ │ │ -CD3EE200B025AA57225145D74503348DD9E3A31CEC54B55127D3EC9512F5B1BF │ │ │ │ │ -5A870EA785F33B8DB6E5650A2988189449E837CC9CC1F72D0050E6489C495751 │ │ │ │ │ -FF928507D3548E3D59EB1EC6FB2A68FF1F30BB80022BD67C681EDBF27D7DEA8F │ │ │ │ │ -661AC66DB27A3D040ACF1B74AD36B5A49F3BDCD0224976AE82DCDA9E74D65688 │ │ │ │ │ -4C5D2C5609A45E894C90FA8AEEE496A3D955A6F79C885480EE57BFBD7EACB069 │ │ │ │ │ -E436FACAF03CEE84F2976EBEE82E13410F2D1CF97F63CB4B29ED6BC20BA4090C │ │ │ │ │ -F26300DB9D4CF55D4CD620AA193F02AB4785D611CC56425D3AD20D0FCDC5D550 │ │ │ │ │ -8D7F06F82432C10EDBB5F29C4316F8044EDD06766E00C98D6DAABCA8EEE72931 │ │ │ │ │ -0FA453BAF55CF21C51EA2A754755DE0C1F86291D1316E0BCA2092D0E0634698B │ │ │ │ │ -8EB3CDD6CED88D9D7118A4884C45525C6717DBBDD088087D333F15AA64000703 │ │ │ │ │ -45E2354093B5FC12AF67072CEAAFAF67F0BC8A26D3C042AC84177526A6565112 │ │ │ │ │ -417AC6686E0DF59510C8F709565DDB65D174F4FECAA04F65FF84780F43776161 │ │ │ │ │ -58189EEE425D4BEE3C3FE2ADECCEE3CEF0ACAF68E92718EBCE8F27D8A0E6538E │ │ │ │ │ -3D9642D70FD5E1985353349A48743D69BD1E0BCCC8DE2D64836312140C5029EC │ │ │ │ │ -CB3A25BCAD02502559E284B4A17EE6BCBB2DF24612162CCEE8F3A9DE34303AC6 │ │ │ │ │ -0DFCD691357F497EC4E4EFE4EAE91AACBCA460F63EAA4A9649EBB3571A6E560D │ │ │ │ │ -C399321BEDD6B3EB5AB7077D2E55D80603B933C381859DCC0968F60C928B13C5 │ │ │ │ │ -E7D81841558A05DEEC3DC0046F4F55EE20C48CA06C24FC0F4D0DC36A68EDC09C │ │ │ │ │ -BDAC95B29C7E82A8905A11C6FCE28643D8A830A36A91547D06621F0A974BDC11 │ │ │ │ │ -59AC65A49D956311C2F27F135064844BF801BE421755F1A890C83732A51BD43B │ │ │ │ │ -EADD35B86CA0F2E066EE1869488C12C6DA89AEE4CF4476A83183E22D9AC439C5 │ │ │ │ │ -2AF543DAFAF5DA053CB8EE223F8E928F31855BCFA809E070D25640D3C88226F4 │ │ │ │ │ -3FBAD6A26240D5AB83073A71CB41F333C1E6220F14D48A265B8ACBB55DA1F89D │ │ │ │ │ -B1F8D1F17EF6299D97504B840F00D791E8BAEA7DEBA28F6D60ADD0E0642C4907 │ │ │ │ │ -E9720FB628EC981CDE4EEF2EAF8FE460626B416A8B99BE8561F1952BCC1EB362 │ │ │ │ │ -77389877B8E1222B13F24FE4D49FC4D5985F621024B9D030816C4D92B28DA9E3 │ │ │ │ │ -BBA820087B283F26D4F9EF267B7C0EDA420FD2A6B57221BDA4ECC7F32D8EE9ED │ │ │ │ │ -960AD0146D26FC2DC66F354D76AB660E41332F4313A332A1B442989BAA49AB3A │ │ │ │ │ -3EF58118D89256AC1B691AA3B66DFE3C83C5D04C2149563CB0E053AAF5ABB2BB │ │ │ │ │ -2C342E604C9D61DA8B6067CCC4B65C747291F72BFDB0F777BA55C8F73FED0589 │ │ │ │ │ -990905A6D0194B1A43CF107CD24C0DBC3AD612DAD9059A3D7F9CB3AE081A50C5 │ │ │ │ │ -2F76040D1B8D9191DDAB973DB86520F5338A923A45F70D9BD33F8AB05EE5ADB9 │ │ │ │ │ -685A8016938D79391D1AC11CB9079AC75CE8CC2E5A37080167BC2BDC001D2ECB │ │ │ │ │ -D508E0262C8260E1380F690699133C63821A343C5F1D65D95AC537351A8C7375 │ │ │ │ │ -434558CF0748B1E77FCC39E41F463E7382346F98AF29DF1A5B9880764E1ACBF2 │ │ │ │ │ -A59249A441579CDB3CFD86433DD268111D20EEF68F3AFCCCB9FF4BD652D43539 │ │ │ │ │ -B1B436B2601A59782F0E0AD7BE4163050FAF9A9BFE5AF1905FB9A6C846E0DE8A │ │ │ │ │ -1B360941D8E8EA568BCA8CB189CA09AB1A29B926D09496EA195F314AC9FD7FFC │ │ │ │ │ -886D58EE569134A84D61D377421D9E2046EC202D1127AF8E083A87BE5F8C06C8 │ │ │ │ │ -BBD27796B0BA8F139986013B238AE11D3A0A8183A9BB57888EB9E66E2255879D │ │ │ │ │ -CDA27EC60C0455118E94260F7C2F00C59A0D541E939B7B0AD92D8EF678B2A4F2 │ │ │ │ │ -C040AD7FA90136EB98A3A4448667F66D3AE01F8BDB0B00A139C382C72A7581C1 │ │ │ │ │ -10DA9E764D6E11E208002CF429B492F87EA25C15F087C0468D05AF54E9B68F91 │ │ │ │ │ -E4012115925E59F23A990217589B3843BB4143FBB248AA643C786607847AFB32 │ │ │ │ │ -007CBCCE913B8BDC0A00447552CE3164522AA9387AB590A82D60B80A3997335F │ │ │ │ │ -3F7E5CDD976379A28F65F3BB29DD27A5521FDC8356C95A84115641C0C2C7E0EC │ │ │ │ │ -5FD9907DCDB9E6B460F144837268C21C07A7FBCBECC5D1D42FC24B60D004277F │ │ │ │ │ -AC6ABF3636ED20B0AE01203233F5DC829C4940DFEC3DC72D74742C669CDFB2AD │ │ │ │ │ -1A68B484591B63E7BD20D88FC2BD9C4D183681FF83FF01BD8445243AF16C8C8D │ │ │ │ │ -ACA5ABF75942862C40C7BC502B1EBEBEA562BE75DA0B385C06E9BD74DF109F5F │ │ │ │ │ -07D1751F74A77682CF21A9EDDDD9A39F8BB3C40D1D138AB315B16FCDB0487B47 │ │ │ │ │ -233E0E7ED108632D9A677DEC36AE34BCFA4CE63BEF9E0AF42D6AA66ED3C4ED45 │ │ │ │ │ -59B8BA7E72057020E7A4F81A3E0E74CB5CF9643A3BBBBC943BAC01A0D1115346 │ │ │ │ │ -3343E42EF34EFEA72C5D6F2A5619EC3503DE766CAF27D584A5F4E2E340F964B6 │ │ │ │ │ -15750EA5ECAAB5C423EE8BF57EAA22B8BD1371DEC2EA33DC85D4814BB221BF4A │ │ │ │ │ -0EE383F819E95789FE6B310ACE49FD45B10D3B38790648FCAE73AB4BF53B9B20 │ │ │ │ │ -617F52A633AE3A8F8A4A19717382DDD59A13FF6AC2C483CDC83CEA8FF27FDABD │ │ │ │ │ -D101416800C1C2B6380A24F315A7D20631873FD1312C042A5FFC58FF23011BA7 │ │ │ │ │ -8CDDF49F921BE0F648BB3C8BF83A0CDCC83C0BBD9B57AE33D82F2AE3CEAA36C1 │ │ │ │ │ -436EE695D7D35B53CFC27941641570C32DA12E4C8E8E823A63BD77AFE4CB50BA │ │ │ │ │ -817AB504931F99C1D8D52B6EB3B8FCB2EF1190417DD0A3FB6930DA63261BDF54 │ │ │ │ │ -22A47F023836A4CF55515033184244117781F131E810BA33082C2CB14E13C034 │ │ │ │ │ -0C29D36AC32E1C3154B6CBE5853BEEAFBB99790E36F16A27694CFAFE0BF1050B │ │ │ │ │ -DA26C71CFF710802C59D3ABEE28BFA1EE0812374EE2ABA6E9725D873298C1AF2 │ │ │ │ │ -71F4EAAB7FA7D7AD1DD2F6419AA409F11915DA3B552EB67A1032289E16371A8B │ │ │ │ │ -38446E336A83136019AEB13C968B9A74CC66F8A05C74235BF051451E85D37241 │ │ │ │ │ -2D6CF69B9DE1E3C4469BDDD3139A71CDA3598EC40BFBA3601DAC4671487B8CED │ │ │ │ │ -6E57152729E5478CBF565194C2439C51EE17F8FC39653B5EC0E4C4BB904262F8 │ │ │ │ │ -515CEEAA2944E6AC2AAA1D7C8B2906F9F2C42B31415EFBE852BC59E0D31EFECE │ │ │ │ │ -A0E6BC6E48C8B21D1D370C895A3EE0451F934F1492C39C78BF6865F044E0843C │ │ │ │ │ -AE8379659B3EE59F2D0680AD070D98ABAF66CD01EC1138E0CD0FF17184171A41 │ │ │ │ │ -BDC4ED24B632CFD43A92F1394A3A1007042C7396AABDB4EC656681D2328B7FE9 │ │ │ │ │ -10BEBC22BB9E8DBC8BFB91C1B8DA871D13659F9FF9D1B29CA0D89FBCC76E50BD │ │ │ │ │ -BA6E2BD133D3C75BA030048C38C6C0C978EC279B827803C6E070074003AC2BF7 │ │ │ │ │ -C90FEAF0200223E2097CA5FF41C0AAB76EBD8DC9BF66F85AC5807C9BC8B7EBE9 │ │ │ │ │ -70BE6A65DC5349773849F37ADBA21D6906B51D83D3B37836AF6D4E58FFE74DBA │ │ │ │ │ -FB422EC2A83B59F1757BBD27CEB2168BDA0015F18BDD563C34618AEDFA270FD5 │ │ │ │ │ -96252FF7DFBE19519D32C9DD218EDFF354CA3542CE4612E603E47B92A699F7C0 │ │ │ │ │ -19AC4446744D35B1B1312869754CD91292A1674CD5F58D1B51332A21C036B303 │ │ │ │ │ -11821EAC567FC09BD36FA58AE1E9F5CFB51BE3600D8E37C72DB952EB729C549F │ │ │ │ │ -5A852B6096523173CCD228B3F9260FFA114587A6B7CDD339088ECD49EA9DAC72 │ │ │ │ │ -EC17259747269938A209B9A3651B3BD367EA164BCE3914916EF0BF591364C62A │ │ │ │ │ -AA870BF6C2A3C6E0901F595D2480EC676E958D920932517C04CE1C3B89E51CF7 │ │ │ │ │ -6E321A89E096841454459BE9AB108D5B3D59BD38028AC6DBABB8BBF0AE3E4C5C │ │ │ │ │ -86039FE3A3E612387B50F42FCC2CE379BCCDB371753CE62D15855B5C306F35DB │ │ │ │ │ -B4AB0146D552422BAE81F5CDB481152653B2582DC15636897637D50F10B14A92 │ │ │ │ │ -1413F4D2BF5379B7F80216D27F45F53ECA5BCC399287560902252E5D600E9B67 │ │ │ │ │ -091869CC2C93D720A314BB30C43034457778D3FC7D89C0E710959806780384E8 │ │ │ │ │ -DE49DC8170C5B526B5162468CA661DE2913FC07FD1398D48E944C2881271A5EA │ │ │ │ │ -8EB6615897D52E5800F3F252054BF1CC17333C77694D80843EA3EACE92C363D2 │ │ │ │ │ -6FE8B5A31049BBDCF2F3CDD7EE06D1C6C0F07A25E0D92BC3B416206A37608763 │ │ │ │ │ -02865AF8DD463BDE4A0CA01856B5F29234577D8F25CD09C183E32641129AFA0A │ │ │ │ │ -481DAB58A472E353A033B5C3478692CB7AC11368FE10925D3FB736D21627CCBD │ │ │ │ │ -54AB79C0FA913868E6139ECF7C3E1DB31774D71D1E79295BDFAB92FACCC7EC04 │ │ │ │ │ -92327B776CA5D058AE4CE36BC0AD8EC59BF0620C1F13F2C51498A4D3BBC3565A │ │ │ │ │ -74966F56AC87C3F38B4BBEFD03815B33139D44C005768C23A134AAA8C28823E2 │ │ │ │ │ -6E2F9B073E9346B8BF44F5C36DEE474CB591F7F05ECC05463BC9615C98A9849D │ │ │ │ │ -931793215A6E73F86CF20120CDD4D7C09377AAC4F919F8107C965D92BB80A8D3 │ │ │ │ │ -3AECBDED9B68D849A0C7FB22A3881DB48A267599EBA52209C81C221E463B2837 │ │ │ │ │ -8B0941C35020380C1F6D8C44FCE89E0B4FA8BF1965BE7BF72D2711440A7567F6 │ │ │ │ │ -03B3B851F9F1815E1406B1A78A872E75C2410D94FACAD784F3C8739E0FE7BE4F │ │ │ │ │ -4C8FAFC8DF7C862F7D7DB1CD8FDC309D97D651FA774EEA73F4E711868CD4999C │ │ │ │ │ -21D413C613B00A717C2E83B4223D │ │ │ │ │ +2F3AD7547F9B0793E20128D03B122C74288283D9B583378FBA48950DCBDF887D │ │ │ │ │ +0A4C231FE009050F8A0C02473587E1D076F0BDC5458931FB26937C4EF7A7AB76 │ │ │ │ │ +DF14BDA8C5E27BDD9EC959C6F3FCF0C55E52847705744EE3D80EF426B9760775 │ │ │ │ │ +F4BD72DF213B715BE0AB9CEF5A9038E3EED7AF454E08ACBBD037E6307A04F331 │ │ │ │ │ +224C39B55908AC9FA0B8E560F8E78D5027B8266331C62EDF750CC08C0E2EB573 │ │ │ │ │ +082BB774BD853932B7C0C88BBE5F6E5E9D985792FA21B3180EE9911F823439DE │ │ │ │ │ +C430774263982682D4B1B76C287D1856702887A9A99B2B5A466FE6CC5B0851DF │ │ │ │ │ +EFBE62D59C80A0B97E81D0EEF577494C78F03924465B9042C7C6C1FD732CA57D │ │ │ │ │ +099755095F57ED2389501E3BF0969584ECE08D55FD8D7E95F92B4A0D405E5D61 │ │ │ │ │ +D10A7CF6B540B64594532EF90FA00CF28271462CB7F96D210E554AE29E510839 │ │ │ │ │ +53542C950DDB38150538212B66EB9D856C091C29F0ED5D450E3DF25F545CD977 │ │ │ │ │ +7A16FB983586A7485BAF18771087FD20117C3C79BD432F7275F6239D932484CA │ │ │ │ │ +C0D26D17C88E3B04FBF1D8381A24CBE5CBBDD3151147C92BBFA2F2306BA43A1D │ │ │ │ │ +07AA1A1481F74144F18F23F7A58B661F2E8646D6EFADE6F7EC39528B26AB15D2 │ │ │ │ │ +FEF17BFE1CB341B1460488AA896615225068E132694CF4F5D065CF5DF7846EDC │ │ │ │ │ +EE855FF20217F33287987F3B430D3B3AF43EB395477E59EEBB7A8B0F4592DAD4 │ │ │ │ │ +019E07E410E4A63681CE0AB5463BFF3A835C413683DAD77A9108E42379050128 │ │ │ │ │ +EAB57F7D6CBEE4C7BCD3AFD820EA0A256E945579B4434B0D4914EC13E3B73451 │ │ │ │ │ +929556467A733189B36F9178D0427D47474A9CE9F7F8682A667710D372A73D46 │ │ │ │ │ +F2AC3316AEC977F1B5AD90CEC4AF9C4D843B330F1AAA69E59FF3F15193A526CF │ │ │ │ │ +E230BB523164DDE3AEA0F933D98886092DC826EAFDFC823D673462C6CA799E69 │ │ │ │ │ +A65EB5EB85C8197553DAAC827E44DDE902737ECC9C587F6285A8181A4A91DBF8 │ │ │ │ │ +1278029BF62F90D985365D7E596BE6BE004526FEB277FF6CB89293E508A25D01 │ │ │ │ │ +F72DC43B2613CD296ABC2B3A53DC5B728267DD83A981D6E376BAB15B9271379B │ │ │ │ │ +2D3C5B28989263D183F65FB27C9707E54141D3C6D683F2262900C306473C0FAE │ │ │ │ │ +6BE58C8345839714B7F4DAA722EDC7DE41A356DB84760079C79096C18DC95B3C │ │ │ │ │ +811D59B5BF81CAF821C8A7757599BB691FBF093813D87517BA43CFA7FB0435BA │ │ │ │ │ +E0A4A9C641C3DAFDB34F0BD00FA334CEE80884420DC4BC7B3D654580D4652286 │ │ │ │ │ +4AF865E9FE13C3324817E98AC4B9AEFEB181E387800CB09180B13BCAA9D4BB0D │ │ │ │ │ +468DF2FD14BD3260CA8F41056AD693CAAA9EA1462A0B88CE042D0C09897111F6 │ │ │ │ │ +A0B609037E464AB8BE75B73746A943E5C1E1D1230C34A8C6BEAE9946C8650C65 │ │ │ │ │ +1DF35DC7DA75CC320EAF407B77894E2EB1D332944C84DF9E03336BBC5E441795 │ │ │ │ │ +25DE64A6962324DEFE9198545694A8E8436B61D4BE9262212CF36094EF28185B │ │ │ │ │ +718AA535A48F42BD62A063E7718AF28889122D3DE2A68E2FC78E906CCCA1E4DD │ │ │ │ │ +A30B29863F4F6DF2B9E1DAAF77898189A55F82E0C2A5F5E525C03402B8AFB5B3 │ │ │ │ │ +A744D0F900AE8864338D06B76F041250C450C993504DD364A20D1E0CF7FFB79B │ │ │ │ │ +0B4AC031B4A1873FA24C9388F365B18E5EFF110DD3501ADEE85BB2CF4A2EB34C │ │ │ │ │ +02EAD580BA5D7F2130F5AF72E64F67A9D809A8C393DDFBDE87D4FCFDC55FC6F3 │ │ │ │ │ +502EADE209DD34C5E0BB94C905017D83BEEF803F736D81655A62244AEDB74EC3 │ │ │ │ │ +74CE8BB3F5C603A95B3A733E367EE5E0792C94BB5CBF5C242E2C11EC9D14561F │ │ │ │ │ +8BE708551334719EE6CFD778F92097F91F0B919F1360A500EC7F54C5450FD824 │ │ │ │ │ +903B1EED009A35BB84CE667E2FCC1AB66BC862679EF1A3A819F79F7D42C6CE81 │ │ │ │ │ +C516AA5E1A5636CE92A98440AA4EDB5969EF6829209F42F6B9060990B629A237 │ │ │ │ │ +667BEC99F89654D99BAD855D53122DC438C66241C7AB9EA63A821D6687E740D8 │ │ │ │ │ +095E63F7B2421518F8E413D86F4E6F1AEC539F3F8AE61B0F7B93AF966749300C │ │ │ │ │ +05F39FC5C097AF0868DA3FD94372C16B73976731BF297AAAD52897AFCB523313 │ │ │ │ │ +AE657DF6D94B6A1D8B00F7FB52D6E4F26B64F08DE4E7A8D59E43BB6443AB738F │ │ │ │ │ +B77280BF89F3F276337B630C74B1990F350C60A27E2B2017675167F5AE8F94D7 │ │ │ │ │ +F9C930E85454634D07FC6858BBD94A3B59B06B9395703216AAECCB3260A363DB │ │ │ │ │ +756B9CCB3D67BB2275D8AA11B3C157F1CE9D852E83C591636887F2D2FB4EDC7A │ │ │ │ │ +57160FA0A5BCE44609E25C988B9024F489BEE366A22DEE54A3E442B8EEEC43D2 │ │ │ │ │ +B61A99DE72FF5C05AC8B15E1707673B957392714E2CAE41F9DB4BF9F3040B34E │ │ │ │ │ +CCD9D5D41586A4DD1FD9981841F6E02C4EF01D77E44210C5CFAEC99DC54E6DEC │ │ │ │ │ +794A1FD0320889B80844762BC6154E8B845782C1504270AFBFA7016441BD51E3 │ │ │ │ │ +BFAE5DE380E4426AFA6E2BCD2AC9E8EAA4EDD2516B8A0DFBDFB48BBFC11219F2 │ │ │ │ │ +C4FD0585E883716F431597AE9A806DBEE15CD7C47797A653BE73039AC31B9EAA │ │ │ │ │ +C82C6FFC58F73C005E06392C7710FD91628264ECB762B9FA99CF79357E67F867 │ │ │ │ │ +D2E052F1DC21C066441DF3C138C5E6B9740C7D69FF0BDF595010E8C37107F0D7 │ │ │ │ │ +55BBA3AADF55A8C46B84296B5A4A99304F6C511FCD98DFE23C3AFC93301D6196 │ │ │ │ │ +6FBEE8989D3AD6F17284C922C5CEA0FA5DAB77C101E37B69F14778BD328F9DBC │ │ │ │ │ +2D64ECB218EA081159B67D19558B9D6BD33F91B061E1F2197A9BA34015A0C066 │ │ │ │ │ +DC6D83992EDCE264C18758B32B4EC733045B2AFE7C5B693873727D467FEB71A5 │ │ │ │ │ +3A007A0AB1E69C71FF7AB859551A268FD78E3E89553C9BCE5D9CF6FFE0CF5540 │ │ │ │ │ +BEEACE2D97688BEAD49B1799A62CEB97827958EB3480AB4241E5B01ACB3D55A9 │ │ │ │ │ +8D49D2A2A509DB0B66964356241E35FDA9067DECAA28943039863DDD380E8D83 │ │ │ │ │ +5033C984BE6E766305788E66C60714E2DCDC10E562014A41FF6B1DF9D4045BFD │ │ │ │ │ +5FE77F051F42CB91F33DA1E1A20B6755FB4A6A411A2DAF0504FE2361FC8303E3 │ │ │ │ │ +2E8B68120788541E32AA88DBA0C6CF0E585F2C99BBD4E632B167FAA5F1F76ABF │ │ │ │ │ +EDA03ABBE1F79A502460A22B5F496E54A4BE33C5BDE106EEB3C65CC0385D01A6 │ │ │ │ │ +3ABE01F849F9055149778E1C190D8CFA79F32DF8A4C7D8651C89438BDA4742DC │ │ │ │ │ +A1E44699C0129CE9297906566CC03FD3F5F0C870082CEAD524A9C3AD7BEF75A2 │ │ │ │ │ +00216C469E9FF8D4B516E53AF46E1D2BB2C1EBDD07B1EF704F89FD48603FD733 │ │ │ │ │ +DF88DB6424EED2684CBE71AC6D66BA097133816F6D04852DD74EA05E5406FCB5 │ │ │ │ │ +CCB9C109CA4EC33A06DE8A163BB878978A64B68CB331CC3A99CA153BB46CA6DB │ │ │ │ │ +1FCA9B6F58BDA7CB8DC8C001050022B664B99929156461142356AAEE93A63C96 │ │ │ │ │ +086437228462EA7E8EA04330A44F37871C75427F77C91E8B05EA5B5FD3776E87 │ │ │ │ │ +60463DAEEA71155BA2529B6A5EB52D0E3E5FA0CC8CDC0A1DBD3C56EF089DF2B4 │ │ │ │ │ +B3AC5DD3A1240AB86CF29DA2B1DEB7B264D3CAA5E0F1B44EC9D790E8C6557AC0 │ │ │ │ │ +6C583BD553DC64D9CFD15B1AF2B5F9673ADAC2E11DEC0AA31467272D2239FA2C │ │ │ │ │ +1662A4743A64DDBACE9A4684E96B42A18BE933F6C39EC1AADFCD00518DE5C716 │ │ │ │ │ +661DC01B29CFEEBA00260994B21331C57AB16890EEDA8F8E7A343BECFC050AB2 │ │ │ │ │ +307B9FB802FCB4ADF4D27CF5C304C9D35684C95D5BE9202A27BA2D3FA4E38569 │ │ │ │ │ +E9BFED3153B3E56DBA6547C321C34D314A9E5C628808C31617FCB3FC0C608648 │ │ │ │ │ +1E08972D956975035633EDD8E8E4C78DCA9A83C708F399BD5912C154327A63A6 │ │ │ │ │ +7353C1B5124AB5A61464370BD4FE437837DCBE365676F5656DAA688170DB7725 │ │ │ │ │ +A2EA844720ABDC83EED9FD51604B4E55BDC54FB37B6DE9E2BA9091BFFC49C4D9 │ │ │ │ │ +CDFC9D43952B1FD69F70264E521D5C54C1F1B82EB9C9D5EEE9963846D7C3F286 │ │ │ │ │ +19B1D16B3E4084D2B259837DE9B9DA54897648FD1C909913C64865E0020D9DEE │ │ │ │ │ +895F2AB7BF10E5C0ED006C36BB4D044378A89354AD6012DBB7E6D5AB6049935F │ │ │ │ │ +E7F4BA07C62848EA9ADF0F32DFCB34637B807557EDF0683043B07FEF17E5E111 │ │ │ │ │ +DA42AA582008FC98724F0B11FF8297A3FF4A9427B70F7CA151F922CDF71758A1 │ │ │ │ │ +56F038B196C8CC979FBC2C2325559A9B4E429743BDB536F2BAEC0A04CDDDD5F4 │ │ │ │ │ +36FF2FA09F7A7A211600A7A08C8E246E9409EFA421CBABD8EDEF0F4BD2F88E78 │ │ │ │ │ +9119582F941E725EB5F1A1B135B5E5AEF7575091DEB6B39E4D6E517CFEC8B9C1 │ │ │ │ │ +EC71F57476D99419CA2679B7C07246F12FC7E2DF65C411BA31F96B3D956FF165 │ │ │ │ │ +8E2201056AF030490B7F3F37D597723975B0A29814B3BACD5C2A7C60685AEECD │ │ │ │ │ +60A7D3AB23874718A1C16371775A5A1D46224B8ABB216DF4189474A17BEEDE29 │ │ │ │ │ +52B69037C3C9CA4343516CDF03F8C53E47FF5578A4F104E712421397A5C53D1F │ │ │ │ │ +33D224A1BEAFBE8E548F7BD6D1F4B55742443DE69D20B3741DD2DFCB18E0FD4D │ │ │ │ │ +AF99538A6FF77D55528381B464F0EB98F7F8D5254E7E6F42CF2E7C55E0A97230 │ │ │ │ │ +CBB61BB41159362BDEFF595515B1846705C33CFA3479B815B786E681E921AE0D │ │ │ │ │ +70367015489AEC1FE2DD8296D55C6B0351D1CDD121EB9A105ED64CF43ED57C98 │ │ │ │ │ +C4E3FC80A780DAB933EAA5A350BD76A5E07BB52E4A5D4E784484023ACC429AB0 │ │ │ │ │ +A691F4F79A82A047EDD6336CB9265393351C71DCB91A1ADC90D0DB2349D9A5F1 │ │ │ │ │ +DC1B1192F9FD7C2F0EBB1B7B01D44FC56DC4AB4504FB868E133E19CF28877562 │ │ │ │ │ +C66E04E9D72EBA593ED70D349DA4B1835C780DEDF1C04C60CF687B873D03514A │ │ │ │ │ +DB52AD1BC656A062CAE32178EEE7ED73ED1CAF6E67EAA0A5DD902E7F51BA08D2 │ │ │ │ │ +CC4B22E0148217B8EA5BB8FCB8C59CB978B7C45855A2B1CFF87D61FF38362F09 │ │ │ │ │ +C0C85CB9D8C0F524542B6FF960DCB8ABC4C9418F639E772BCBB3C81C9BA25F03 │ │ │ │ │ +7EC64DA4C312524C5869E1349399ACEBC1E764F6CF6A7C7E77FBFB92189A3B53 │ │ │ │ │ +7C9635C3DD98E2BA1A03303025FFD250B12A1281E0C593CEF7E28D45A17F8E9A │ │ │ │ │ +DE63EE0E696747472B8101212BCF2C486C47E426D94EA0CC04BCFF04020E9C65 │ │ │ │ │ +D5FF3AD7431D67AC311CCC05E92B02325216285D6AA0AF92780CBF6E049BA1BC │ │ │ │ │ +8CC51E78B87630A156793392E60CFD3B81C1EDB9AC93B3F38A0BD0C30ED1E189 │ │ │ │ │ +3F7BFEA29F51F13A4FB62D48B35826F840B370B1B3EB40EEB3009CDE1FAC559F │ │ │ │ │ +D2904D7D3A79B523E0B1B1C06C1724AB69E3C00B80FDD42EA6EAA5D03E38648D │ │ │ │ │ +AF1450AFBF87134C930455228C0EA5C2E20D352A2BC2B30EBDDE3AD1194B090D │ │ │ │ │ +19F4536341518EB57E294F98775BA92388F501DEA4FD4DD3A22E0323D1D44B50 │ │ │ │ │ +B742406AEF22034B2500055DB1298BDE86193019B27DCFBE9EA992E4A219C9C9 │ │ │ │ │ +4A9EC7B3693CED415C96FBE9F655600B28D018DC9CC5AB393231DFDD6B6D65BF │ │ │ │ │ +EF1CCCCD61821E1BA19487D81F162BC2D0AEDB8A677FC94AD05BFE646A23F8E2 │ │ │ │ │ +4604E7B7BEF5653126171CA9CDA5BFA4AA30F2FE3E2BE48ABC4A13D6801B5407 │ │ │ │ │ +D4C345B2D0A2863310EBA3B2E664AC0ECE5A4B0679C49AFC5C606507D81E3F8E │ │ │ │ │ +473146E2F71D5F404A5FC824041736EDB11E6EF4F3D30E3ADEA4CE5CDF84C5BD │ │ │ │ │ +DC7EFBCE955093EAD4F9772D3187FB1A85F5AF838F6A3261B35949BA3AB0450A │ │ │ │ │ +9A741D284263946535CD06F9241205C139C450114C879C4CFDBD355299B417BB │ │ │ │ │ +9124A9E47F4F5A8AB7908F19CB585635706E3168870286BB2B7E9F0579E295EC │ │ │ │ │ +DA627DAA37668D0A1671C61E31940E0C74E2794456470800469A1DF9EA6523E4 │ │ │ │ │ +5C2F92939EA6932CBB4C10D8B48953E2D244B570A47DD9CF5B830C1F362868B2 │ │ │ │ │ +1D828709255BFB49CBEC14748882465125D7718FCDB56C16268DB2E9AD9CFBA8 │ │ │ │ │ +6D020E4D5EA5C611A52AE12A46F4A949B555D3D17E50A85655A2CC54DB3F086A │ │ │ │ │ +0DC2B156389ADFF4D273DE41B9808AA762F0EA77276944DB97C282463FD8029C │ │ │ │ │ +356A48E8A074657A55432E1F8439F9B1CA8B40C62416D22E8FBBACFACCD36A47 │ │ │ │ │ +9BC4F6FA85B989F509E8EE697742A797E2198446823DB9AF64CDDFED7D04D9AB │ │ │ │ │ +FAE184B05FBDA7EA4283480A7B4FFEFA621DE0F78168174E77E997BE0026BB92 │ │ │ │ │ +0DEAD592A91CC81FFFB12C70FFED1806B6E324093C68BFAA3C1D5EEF826569D2 │ │ │ │ │ +A6D5C5428A0BE3F7DED38AE93B4A041C3533B87604D2E8255251438AE1A28B83 │ │ │ │ │ +4B532C287B6AA86E440593D2F287B2866431321FAAC1368433651F1BED582325 │ │ │ │ │ +230325D82121BFEEBABDD28D07B413AAA23D53607A9FD5B79417B5103F850293 │ │ │ │ │ +12A0AAF16EED98FCA4AED02CAA4BF67D1086A596E2B5555A765DF28C0045E75E │ │ │ │ │ +823FAD561ECD0E7AC58FD89EEC1AB1FF57E0BF6EC945D1588A0989C57FA3509E │ │ │ │ │ +16C18D219CC078A3CFF4EA30A4F1877F591761E2778C6A907AF195C31A7F1624 │ │ │ │ │ +6414185054BE1FEA76F91EB9937A32A4720C008892FD46659F9D4B793941DD52 │ │ │ │ │ +1D66620583F8925D5570FC7BF3D684B5D0305EFDB7CAF51AB0E02D4E1F0B39EE │ │ │ │ │ +13DA69734627D6557334FF1E776624D788CC0EFC00589EDDD9003379E2524F13 │ │ │ │ │ +46CBA949EEA9BD8119C937BD2A46440FA740D4BD8406C0CB93413AC4CEA748E7 │ │ │ │ │ +12259FF35CCF61B97831C4724C2DCBBA2DBEA9DA5F62715229618B27E7796365 │ │ │ │ │ +A23B439495E3EA4B5A01348AFA5E5DEE6142466A437F0A4CBE378535CA823B78 │ │ │ │ │ +B1BE3857E3FAB56EC5FC02A2118BFB91C1B8DF8F92BD643BBEB6A99725AFB059 │ │ │ │ │ +A7A8B3145968D402D4D23A01AFA7BEFEA69286A6D2192AEE97395DCC012C3D9E │ │ │ │ │ +A80267E575FA62394DE3757C9EDA10980F457B07DC086740E8B772F8E4D1BBB4 │ │ │ │ │ +D947AE8B2E3FC0A9738A6DFDE74C15A4A959FA310297AD7BC4CFAD226CE15DDF │ │ │ │ │ +A2547E16BB6FEBA6A443EBEFD7C0D7EA64E84745962551B4368E68C1776A809F │ │ │ │ │ +5D5A0EFDC179CC5A1843B8D107F1E37D79E9EBD754E19453F6FB2928CEBF0597 │ │ │ │ │ +40C907028D68A6131D11164BBC89422C407410F5E414CA5C80E35C639785B6B1 │ │ │ │ │ +5E865573C3D6A9EF2F6717F34437829EF2552D63E1AE3BE64BA08B5C779A12C3 │ │ │ │ │ +EC1FAFD59989E31CC962F59DAD912E93F4022372F51D5F4C9ACADAF3225058F4 │ │ │ │ │ +B658E43662C85D68C77505EF5EB3EAF35FEF7C663DDDE39B2C8DD6305EAEAB15 │ │ │ │ │ +09FD59BF081486D9CFAA152AB172FD631097FF011AABC74108BB8EE25AA7F30E │ │ │ │ │ +46D6DB8A2793E6C42A577FD29065B0FC44425723EC66FCDF1DFDE8D97DE46159 │ │ │ │ │ +44B209BE83B0BD7C2E94595C971FE88A8D00616F400947772C74D8A76BB3350B │ │ │ │ │ +D6C3B95AAAFD12F08A24D10B98A17404BF8E62BC8CBA6187A31174AE21145CC4 │ │ │ │ │ +0821B3C84A1A1BC2D033F0EF2FA8F79E4619F887E303D6DEF123323A078357BE │ │ │ │ │ +F3DC9FD681EB4AC8DB6A7454896732EF4174B940559FF04B61C0CB77A5D256D7 │ │ │ │ │ +7B88241079A249EDFC0AC5AAA5C9E6A3F8A22A6FACBB088FB241484CC152CC85 │ │ │ │ │ +899C290B │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -7356,16 +7335,16 @@ │ │ │ │ │ 12[106 106 2[106 2[106 3[106 26[106 46[{}14 206.559 /CMTT12 │ │ │ │ │ rf /Fb 137[38 45 28 1[35 2[42 47 1[21 4[38 1[38 1[38 │ │ │ │ │ 38 42 14[61 23[25 58[{}14 83.022 /CMTI10 rf /Fc 139[62 │ │ │ │ │ 62 62 5[62 2[62 1[62 1[62 62 2[62 12[62 62 2[62 2[62 │ │ │ │ │ 3[62 6[62 66[{}15 119.552 /CMTT12 rf /Fd 134[71 2[71 │ │ │ │ │ 75 52 53 55 1[75 67 75 112 3[37 75 67 41 61 75 60 1[65 │ │ │ │ │ 12[94 75 2[92 11[103 15[67 67 67 67 2[37 46[{}27 119.552 │ │ │ │ │ -/CMBX12 rf /Fe 134[44 3[46 2[33 12[37 2[46 42 26[54 11[23 │ │ │ │ │ -1[42 2[42 2[42 1[42 3[23 44[{}13 83.022 /CMSL10 rf /Ff │ │ │ │ │ +/CMBX12 rf /Fe 134[44 3[46 2[33 3[46 12[42 22[43 15[23 │ │ │ │ │ +2[42 2[42 1[42 1[42 3[23 44[{}12 83.022 /CMSL10 rf /Ff │ │ │ │ │ 171[39 84[{}1 58.1154 /CMMI7 rf /Fg 157[46 98[{}1 83.022 │ │ │ │ │ /CMEX10 rf /Fh 222[83 29[42 2[65{}3 83.022 /CMSY10 rf │ │ │ │ │ %DVIPSBitmapFont: Fi tcrm1000 10 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ @@ -7423,42 +7402,42 @@ │ │ │ │ │ 39 39 2[39 39 39 39 39 39 39 39 39 32[39 17[39 46[{}21 │ │ │ │ │ 74.7198 /CMTT9 rf /Fq 133[34 41 41 55 41 43 30 30 30 │ │ │ │ │ 1[43 38 43 64 21 2[21 43 38 23 34 43 34 43 38 9[79 2[55 │ │ │ │ │ 43 57 1[52 60 1[70 48 2[28 58 3[59 55 54 58 7[38 38 38 │ │ │ │ │ 38 38 38 38 38 38 38 1[21 26 21 44[{}50 74.7198 /CMR9 │ │ │ │ │ rf /Fr 205[30 30 49[{}2 49.8132 /CMR6 rf /Fs 205[35 35 │ │ │ │ │ 49[{}2 66.4176 /CMR8 rf /Ft 134[51 2[51 54 38 38 38 2[49 │ │ │ │ │ -54 81 27 51 1[27 54 49 30 43 1[43 54 49 9[100 6[66 5[50 │ │ │ │ │ -3[64 2[70 69 73 8[49 2[49 2[49 1[49 3[27 44[{}31 99.6264 │ │ │ │ │ -/CMR12 rf /Fu 165[99 6[90 2[110 121 126 1[97 6[106 1[117 │ │ │ │ │ -1[122 65[{}9 143.462 /CMBX12 rf /Fv 133[58 70 2[70 1[51 │ │ │ │ │ -52 51 1[73 66 73 1[36 70 1[36 73 66 40 58 73 58 73 66 │ │ │ │ │ -13[73 6[83 2[47 3[90 2[94 99 14[66 3[36 43 45[{}29 143.462 │ │ │ │ │ +54 81 27 51 1[27 54 49 30 43 1[43 1[49 9[100 6[66 5[50 │ │ │ │ │ +6[70 69 73 9[49 2[49 1[49 1[49 3[27 44[{}29 99.6264 /CMR12 │ │ │ │ │ +rf /Fu 165[99 6[90 2[110 121 126 1[97 6[106 1[117 1[122 │ │ │ │ │ +65[{}9 143.462 /CMBX12 rf /Fv 133[58 70 2[70 1[51 52 │ │ │ │ │ +51 1[73 66 73 1[36 70 1[36 73 66 40 58 73 58 73 66 13[73 │ │ │ │ │ +6[83 2[47 3[90 2[94 99 14[66 3[36 43 45[{}29 143.462 │ │ │ │ │ /CMR17 rf end │ │ │ │ │ %%EndProlog │ │ │ │ │ %%BeginSetup │ │ │ │ │ %%Feature: *Resolution 600dpi │ │ │ │ │ TeXDict begin │ │ │ │ │ %%BeginPaperSize: Letter │ │ │ │ │ /setpagedevice where │ │ │ │ │ { pop << /PageSize [612 792] >> setpagedevice } │ │ │ │ │ { /letter where { pop letter } if } │ │ │ │ │ ifelse │ │ │ │ │ %%EndPaperSize │ │ │ │ │ end │ │ │ │ │ %%EndSetup │ │ │ │ │ %%Page: 1 1 │ │ │ │ │ -TeXDict begin 1 0 bop 109 1940 a Fv(In)l(tegrating)43 │ │ │ │ │ +TeXDict begin 1 0 bop 109 1941 a Fv(In)l(tegrating)43 │ │ │ │ │ b(the)g Fu(SPOOLES)h Fv(2.2)e(Sparse)i(Linear)f(Algebra)g(Library)326 │ │ │ │ │ 2123 y(in)l(to)g(the)h Fu(LANCZOS)e Fv(Blo)t(c)l(k-shifted)h(Lanczos)g │ │ │ │ │ (Eigensolv)l(er)950 2513 y Ft(Clev)m(e)35 b(Ashcraft)737 │ │ │ │ │ -2629 y(Bo)s(eing)d(Phan)m(tom)i(W)-8 b(orks)1753 2593 │ │ │ │ │ -y Fs(1)2334 2513 y Ft(Jim)33 b(P)m(atterson)2107 2629 │ │ │ │ │ -y(Bo)s(eing)f(Phan)m(tom)i(W)-8 b(orks)3123 2593 y Fs(2)1590 │ │ │ │ │ -2891 y Ft(F)g(ebruary)33 b(8,)g(2025)104 4919 y Fr(1)138 │ │ │ │ │ +2630 y(Bo)s(eing)d(Phan)m(tom)i(W)-8 b(orks)1753 2593 │ │ │ │ │ +y Fs(1)2334 2513 y Ft(Jim)33 b(P)m(atterson)2107 2630 │ │ │ │ │ +y(Bo)s(eing)f(Phan)m(tom)i(W)-8 b(orks)3123 2593 y Fs(2)1611 │ │ │ │ │ +2890 y Ft(Jan)m(uary)33 b(7,)f(2024)104 4919 y Fr(1)138 │ │ │ │ │ 4951 y Fq(P)-6 b(.)36 b(O.)g(Bo)n(x)g(24346,)41 b(Mail)c(Stop)e(7L-22,) │ │ │ │ │ 40 b(Seattle,)f(W)-6 b(ashington)36 b(98124,)k Fp │ │ │ │ │ (cleve.ashcraft@boeing.com)p Fq(.)71 b(This)36 b(researc)n(h)0 │ │ │ │ │ 5042 y(w)n(as)f(supp)r(orted)e(in)h(part)g(b)n(y)f(the)h(D)n(ARP)-6 │ │ │ │ │ b(A)32 b(Con)n(tract)i(D)n(ABT63-95-C-0122)i(and)e(the)g(DoD)f(High)h │ │ │ │ │ (P)n(erformance)i(Computing)0 5133 y(Mo)r(dernization)27 │ │ │ │ │ b(Program)g(Common)g(HPC)f(Soft)n(w)n(are)g(Supp)r(ort)f(Initiativ)n │ │ │ │ │ @@ -7589,17 +7568,17 @@ │ │ │ │ │ b(data)g(structures)g(m)n(ust)h(b)r(e)g(initialized.)38 │ │ │ │ │ b(In)28 b(a)g(parallel)e(en)n(vironmen)n(t,)h(there)h(is)g(ev)n(en)f │ │ │ │ │ (more)g(setup)h(w)n(ork)f(to)g(do,)0 5396 y(analyzing)20 │ │ │ │ │ b(the)h(factorization)f(and)h(solv)n(es)f(and)h(sp)r(ecifying)g(whic)n │ │ │ │ │ (h)g(threads)g(or)f(pro)r(cessors)f(p)r(erform)h(what)i(computations) │ │ │ │ │ 1929 5656 y(2)p eop end │ │ │ │ │ %%Page: 3 4 │ │ │ │ │ -TeXDict begin 3 3 bop 83 100 785 4 v 950 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fm(3)0 │ │ │ │ │ +TeXDict begin 3 3 bop 83 100 802 4 v 968 100 a Fn(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fm(3)0 │ │ │ │ │ 390 y(and)h(store)f(what)h(data.)37 b(In)28 b(a)g(distributed)g(en)n │ │ │ │ │ (vironmen)n(t,)g(the)g(en)n(tries)f(of)h Fj(A)g Fm(and)g │ │ │ │ │ Fj(B)k Fm(m)n(ust)c(also)f(b)r(e)i(distributed)f(among)0 │ │ │ │ │ 490 y(the)g(pro)r(cessors)d(in)j(preparation)e(for)h(the)h(factors)e │ │ │ │ │ (and)i(m)n(ultiplies.)125 614 y(F)-7 b(or)37 b(eac)n(h)h(of)h(the)f │ │ │ │ │ (three)h(en)n(vironmen)n(ts)e(|)i(serial,)h(m)n(ultithreaded)e(and)h │ │ │ │ │ (MPI)f(|)g(the)h Fn(SPOOLES)g Fm(solv)n(er)e(has)0 714 │ │ │ │ │ @@ -7664,17 +7643,17 @@ │ │ │ │ │ (utation)i(v)n(ector.)125 5243 y Fi(\210)42 b Fl(DenseMtx)e(*X)27 │ │ │ │ │ b Fm(:)g(dense)h(matrix)f(ob)5 b(ject)27 b(that)h(is)g(used)f(during)g │ │ │ │ │ (the)h(matrix)f(m)n(ultiples)h(and)g(solv)n(es.)125 5407 │ │ │ │ │ y Fi(\210)42 b Fl(DenseMtx)e(*Y)27 b Fm(:)g(dense)h(matrix)f(ob)5 │ │ │ │ │ b(ject)27 b(that)h(is)g(used)f(during)g(the)h(matrix)f(m)n(ultiples)h │ │ │ │ │ (and)g(solv)n(es.)1929 5656 y(4)p eop end │ │ │ │ │ %%Page: 5 6 │ │ │ │ │ -TeXDict begin 5 5 bop 83 100 785 4 v 950 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fm(5)125 │ │ │ │ │ +TeXDict begin 5 5 bop 83 100 802 4 v 968 100 a Fn(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fm(5)125 │ │ │ │ │ 390 y Fi(\210)42 b Fl(int)g(msglvl)30 b Fm(:)48 b(message)31 │ │ │ │ │ b(lev)n(el)h(for)h(output.)53 b(When)33 b(0,)h(no)e(output,)j(When)e │ │ │ │ │ (1,)h(just)g(statistics)e(and)h(cpu)g(times.)208 490 │ │ │ │ │ y(When)28 b(greater)e(than)h(1,)g(more)g(and)h(more)e(output.)125 │ │ │ │ │ 654 y Fi(\210)42 b Fl(FILE)f(*msgFile)25 b Fm(:)37 b(message)26 │ │ │ │ │ b(\014le)i(for)f(output.)37 b(When)28 b Fl(msglvl)e Fj(>)h │ │ │ │ │ Fm(0,)g Fl(msgFile)e Fm(m)n(ust)j(not)f(b)r(e)h Fl(NULL)p │ │ │ │ │ @@ -7748,17 +7727,17 @@ │ │ │ │ │ (in)n(to)f(the)i(upp)r(er)e(triangle,)i(and)e(the)i(storage)c(mo)r(des) │ │ │ │ │ j(of)g Fl(A)f Fm(and)h Fl(B)f Fm(are)390 5276 y(c)n(hanged)27 │ │ │ │ │ b(to)g(c)n(hevrons)f(and)i(v)n(ectors,)e(in)i(preparation)d(for)j(the)g │ │ │ │ │ (\014rst)f(factorization.)307 5407 y Fi(\210)42 b Fm(The)28 │ │ │ │ │ b(sym)n(b)r(olic)f(factorization)f(is)i(then)g(computed)g(and)f(loaded) │ │ │ │ │ g(in)h(the)g Fl(Bridge)d Fm(ob)5 b(ject.)p eop end │ │ │ │ │ %%Page: 6 7 │ │ │ │ │ -TeXDict begin 6 6 bop 83 100 785 4 v 950 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fm(6)307 │ │ │ │ │ +TeXDict begin 6 6 bop 83 100 802 4 v 968 100 a Fn(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fm(6)307 │ │ │ │ │ 390 y Fi(\210)42 b Fm(A)28 b Fl(FrontMtx)d Fm(ob)5 b(ject)27 │ │ │ │ │ b(is)g(created)g(to)h(hold)f(the)h(factorization)e(and)i(loaded)f(in)n │ │ │ │ │ (to)g(the)h Fl(Bridge)d Fm(ob)5 b(ject.)307 523 y Fi(\210)42 │ │ │ │ │ b Fm(A)30 b Fl(SubMtxManager)24 b Fm(ob)5 b(ject)29 b(is)g(created)f │ │ │ │ │ (to)h(hold)g(the)h(factor's)e(submatrices)g(and)h(loaded)g(in)n(to)g │ │ │ │ │ (the)g Fl(Bridge)390 622 y Fm(ob)5 b(ject.)307 755 y │ │ │ │ │ Fi(\210)42 b Fm(Tw)n(o)27 b Fl(DenseMtx)d Fm(ob)5 b(jects)27 │ │ │ │ │ @@ -7841,17 +7820,17 @@ │ │ │ │ │ Fj(B)i Fm(is)d(required.)456 5159 y Fn({)41 b Fl(2)28 │ │ │ │ │ b Fm(|)f(buc)n(kling,)h(a)f(m)n(ultiply)h(with)g Fj(A)g │ │ │ │ │ Fm(is)f(required.)456 5275 y Fn({)41 b Fl(3)28 b Fm(|)f(simple,)h(no)g │ │ │ │ │ (m)n(ultiply)g(is)f(required.)307 5407 y Fi(\210)42 b │ │ │ │ │ Fl(void)g(*data)26 b Fm(|)h(a)h(p)r(oin)n(ter)f(to)g(the)h │ │ │ │ │ Fl(Bridge)d Fm(ob)5 b(ject.)p eop end │ │ │ │ │ %%Page: 7 8 │ │ │ │ │ -TeXDict begin 7 7 bop 83 100 785 4 v 950 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fm(7)101 │ │ │ │ │ +TeXDict begin 7 7 bop 83 100 802 4 v 968 100 a Fn(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fm(7)101 │ │ │ │ │ 390 y(4.)42 b Fl(void)f(Solve)h(\()h(int)g(*pnrows,)d(int)i(*pncols,)e │ │ │ │ │ (double)i(X[],)f(double)h(Y[],)774 490 y(void)g(*data,)f(int)i(*perror) │ │ │ │ │ d(\))j(;)208 623 y Fm(This)22 b(metho)r(d)i(solv)n(es)d(\()p │ │ │ │ │ Fj(A)9 b Fh(\000)g Fj(\033)s(B)t Fm(\))p Fj(X)30 b Fm(=)23 │ │ │ │ │ b Fj(Y)c Fm(,)24 b(where)e(\()p Fj(A)9 b Fh(\000)g Fj(\033)s(B)t │ │ │ │ │ Fm(\))24 b(has)e(b)r(een)h(factored)f(b)n(y)h(a)f(previous)g(call)h(to) │ │ │ │ │ f Fl(Factor\(\))p Fm(.)208 722 y(All)28 b(calling)f(sequence)g │ │ │ │ │ @@ -7913,17 +7892,17 @@ │ │ │ │ │ (\014le)i(for)f Fj(A)h Fm(is)f(read.)36 b(This)28 b(yields)f(the)h(n)n │ │ │ │ │ (um)n(b)r(er)g(of)f(equations.)101 5177 y(3.)42 b(The)27 │ │ │ │ │ b(parameters)f(that)i(de\014ne)g(the)g(eigensystem)f(to)g(b)r(e)h(solv) │ │ │ │ │ n(ed)f(are)f(read)h(in)h(from)f(the)h Fl(parmFile)c Fm(\014le.)101 │ │ │ │ │ 5343 y(4.)42 b(The)27 b(Lanczos)f(eigensolv)n(er)g(w)n(orkspace)f(is)j │ │ │ │ │ (initialized.)p eop end │ │ │ │ │ %%Page: 8 9 │ │ │ │ │ -TeXDict begin 8 8 bop 83 100 785 4 v 950 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fm(8)101 │ │ │ │ │ +TeXDict begin 8 8 bop 83 100 802 4 v 968 100 a Fn(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fm(8)101 │ │ │ │ │ 390 y(5.)42 b(The)27 b(Lanczos)f(comm)n(unication)h(structure)g(is)h │ │ │ │ │ (\014lled)g(with)g(some)f(parameters.)101 556 y(6.)42 │ │ │ │ │ b(The)30 b Fj(A)h Fm(and)g(p)r(ossibly)f Fj(B)k Fm(matrices)c(are)g │ │ │ │ │ (read)g(in)g(from)h(the)g(Harw)n(ell-Bo)r(eing)d(\014les)j(and)f(con)n │ │ │ │ │ (v)n(erted)f(in)n(to)h Fl(InpMtx)208 656 y Fm(ob)5 b(jects)27 │ │ │ │ │ b(from)g(the)h Fn(SPOOLES)g Fm(library)-7 b(.)101 822 │ │ │ │ │ y(7.)42 b(The)27 b(linear)g(solv)n(er)f(en)n(vironmen)n(t)h(is)g(then)h │ │ │ │ │ @@ -7984,17 +7963,17 @@ │ │ │ │ │ y Fi(\210)42 b Fl(FrontMtx)e(*frontmtx)24 b Fm(:)37 b(ob)5 │ │ │ │ │ b(ject)27 b(that)h(stores)e(the)i Fj(L)p Fm(,)g Fj(D)h │ │ │ │ │ Fm(and)f Fj(U)36 b Fm(factor)27 b(matrices.)125 5354 │ │ │ │ │ y Fi(\210)42 b Fl(IV)g(*oldToNewIV)23 b Fm(:)28 b(ob)5 │ │ │ │ │ b(ject)28 b(that)f(stores)g(old-to-new)f(p)r(erm)n(utation)i(v)n │ │ │ │ │ (ector.)1929 5656 y(9)p eop end │ │ │ │ │ %%Page: 10 11 │ │ │ │ │ -TeXDict begin 10 10 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(10)125 │ │ │ │ │ +TeXDict begin 10 10 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(10)125 │ │ │ │ │ 390 y Fi(\210)42 b Fl(IV)g(*newToOldIV)23 b Fm(:)28 b(ob)5 │ │ │ │ │ b(ject)28 b(that)f(stores)g(new-to-old)f(p)r(erm)n(utation)i(v)n │ │ │ │ │ (ector.)125 556 y Fi(\210)42 b Fl(DenseMtx)e(*X)27 b │ │ │ │ │ Fm(:)g(dense)h(matrix)f(ob)5 b(ject)27 b(that)h(is)g(used)f(during)g │ │ │ │ │ (the)h(matrix)f(m)n(ultiples)h(and)g(solv)n(es.)125 721 │ │ │ │ │ y Fi(\210)42 b Fl(DenseMtx)e(*Y)27 b Fm(:)g(dense)h(matrix)f(ob)5 │ │ │ │ │ b(ject)27 b(that)h(is)g(used)f(during)g(the)h(matrix)f(m)n(ultiples)h │ │ │ │ │ @@ -8059,17 +8038,17 @@ │ │ │ │ │ (sequence)h(of)f(action.)307 5175 y Fi(\210)42 b Fm(The)e(metho)r(d)h │ │ │ │ │ (b)r(egins)f(b)n(y)g(c)n(hec)n(king)f(all)h(the)g(input)h(data,)i(and)d │ │ │ │ │ (setting)g(the)h(appropriate)d(\014elds)j(of)f(the)390 │ │ │ │ │ 5275 y Fl(BridgeMT)25 b Fm(ob)5 b(ject.)307 5407 y Fi(\210)42 │ │ │ │ │ b Fm(The)28 b Fl(pencil)d Fm(ob)5 b(ject)27 b(is)h(initialized)g(with)g │ │ │ │ │ Fl(A)f Fm(and)h Fl(B)p Fm(.)p eop end │ │ │ │ │ %%Page: 11 12 │ │ │ │ │ -TeXDict begin 11 11 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(11)307 │ │ │ │ │ +TeXDict begin 11 11 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(11)307 │ │ │ │ │ 390 y Fi(\210)42 b Fl(A)27 b Fm(and)h Fl(B)f Fm(are)g(con)n(v)n(erted)f │ │ │ │ │ (to)h(storage)f(b)n(y)h(ro)n(ws)f(and)i(v)n(ector)e(mo)r(de.)307 │ │ │ │ │ 516 y Fi(\210)42 b Fm(A)28 b Fl(Graph)e Fm(ob)5 b(ject)27 │ │ │ │ │ b(is)h(created)e(that)i(con)n(tains)f(the)h(sparsit)n(y)e(pattern)i(of) │ │ │ │ │ f(the)h(union)g(of)f Fl(A)g Fm(and)h Fl(B)p Fm(.)307 │ │ │ │ │ 642 y Fi(\210)42 b Fm(The)37 b(graph)e(is)i(ordered)e(b)n(y)h(\014rst)g │ │ │ │ │ (\014nding)h(a)f(recursiv)n(e)f(dissection)h(partition,)i(and)f(then)g │ │ │ │ │ @@ -8158,17 +8137,17 @@ │ │ │ │ │ 1174 5220 y(1)99 b(error)26 b(in)i(the)g(factorization)1174 │ │ │ │ │ 5319 y(0)99 b(normal)27 b(return)1147 5419 y(-1)98 b │ │ │ │ │ Fl(psigma)26 b Fm(is)h Fl(NULL)2341 5220 y Fm(-2)98 b │ │ │ │ │ Fl(ppvttol)25 b Fm(is)j Fl(NULL)2341 5319 y Fm(-3)98 │ │ │ │ │ b Fl(data)26 b Fm(is)i Fl(NULL)2341 5419 y Fm(-4)98 b │ │ │ │ │ Fl(pinertia)25 b Fm(is)i Fl(NULL)p eop end │ │ │ │ │ %%Page: 12 13 │ │ │ │ │ -TeXDict begin 12 12 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(12)101 │ │ │ │ │ +TeXDict begin 12 12 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(12)101 │ │ │ │ │ 390 y(3.)42 b Fl(void)f(MatMulMT)g(\()i(int)f(*pnrows,)f(int)h │ │ │ │ │ (*pncols,)e(double)h(X[],)h(double)f(Y[],)905 490 y(int)h(*pprbtype,)e │ │ │ │ │ (void)i(*data)f(\))i(;)208 623 y Fm(This)31 b(metho)r(d)i(computes)e(a) │ │ │ │ │ h(m)n(ultiply)g(of)g(the)g(form)f Fj(Y)49 b Fm(=)30 b │ │ │ │ │ Fj(I)7 b(X)g Fm(,)32 b Fj(Y)49 b Fm(=)29 b Fj(AX)39 b │ │ │ │ │ Fm(or)31 b Fj(Y)49 b Fm(=)29 b Fj(B)t(X)7 b Fm(.)49 b(All)32 │ │ │ │ │ b(calling)g(sequence)208 722 y(parameters)25 b(are)i(p)r(oin)n(ters)g │ │ │ │ │ @@ -8236,17 +8215,17 @@ │ │ │ │ │ 5011 y Fm(where)125 5201 y Fi(\210)i Fl(msglvl)25 b Fm(is)i(the)h │ │ │ │ │ (message)e(lev)n(el)h(for)h(the)g Fl(BridgeMT)c Fm(metho)r(ds)k(and)f │ │ │ │ │ (the)h Fn(SPOOLES)g Fm(soft)n(w)n(are.)125 5368 y Fi(\210)42 │ │ │ │ │ b Fl(msgFile)24 b Fm(is)k(the)g(message)e(\014le)i(for)f(the)h │ │ │ │ │ Fl(BridgeMT)c Fm(metho)r(ds)k(and)f(the)h Fn(SPOOLES)g │ │ │ │ │ Fm(soft)n(w)n(are.)p eop end │ │ │ │ │ %%Page: 13 14 │ │ │ │ │ -TeXDict begin 13 13 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(13)125 │ │ │ │ │ +TeXDict begin 13 13 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(13)125 │ │ │ │ │ 390 y Fi(\210)42 b Fl(parmFile)24 b Fm(is)j(the)h(input)h(\014le)f(for) │ │ │ │ │ f(the)h(parameters)d(of)j(the)g(eigensystem)f(to)g(b)r(e)h(solv)n(ed.) │ │ │ │ │ 125 556 y Fi(\210)42 b Fl(seed)26 b Fm(is)h(a)g(random)g(n)n(um)n(b)r │ │ │ │ │ (er)g(seed)h(used)f(b)n(y)g(the)h Fn(SPOOLES)g Fm(soft)n(w)n(are.)125 │ │ │ │ │ 722 y Fi(\210)42 b Fl(nthread)24 b Fm(is)k(the)g(n)n(um)n(b)r(er)f(of)h │ │ │ │ │ (threads)f(to)g(use)g(in)h(the)g(factors,)f(solv)n(es)f(and)h(matrix-m) │ │ │ │ │ n(ultiplies.)125 888 y Fi(\210)42 b Fl(inFileA)24 b Fm(is)k(the)g(Harw) │ │ │ │ │ @@ -8332,17 +8311,17 @@ │ │ │ │ │ b(that)h(con)n(tains)f(the)h(sym)n(b)r(olic)f(factorization)f(of)h(the) │ │ │ │ │ h(matrix.)125 5304 y Fi(\210)42 b Fl(SubMtxManager)c(*mtxmanager)25 │ │ │ │ │ b Fm(:)41 b(ob)5 b(ject)30 b(that)g(manages)e(the)i Fl(SubMtx)e │ │ │ │ │ Fm(ob)5 b(jects)29 b(that)h(store)f(the)h(factor)f(en)n(tries)208 │ │ │ │ │ 5404 y(and)e(are)g(used)g(in)h(the)g(solv)n(es.)1908 │ │ │ │ │ 5656 y(14)p eop end │ │ │ │ │ %%Page: 15 16 │ │ │ │ │ -TeXDict begin 15 15 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(15)125 │ │ │ │ │ +TeXDict begin 15 15 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(15)125 │ │ │ │ │ 390 y Fi(\210)42 b Fl(FrontMtx)e(*frontmtx)24 b Fm(:)37 │ │ │ │ │ b(ob)5 b(ject)27 b(that)h(stores)e(the)i Fj(L)p Fm(,)g │ │ │ │ │ Fj(D)h Fm(and)f Fj(U)36 b Fm(factor)27 b(matrices.)125 │ │ │ │ │ 556 y Fi(\210)42 b Fl(IV)g(*oldToNewIV)23 b Fm(:)28 b(ob)5 │ │ │ │ │ b(ject)28 b(that)f(stores)g(old-to-new)f(p)r(erm)n(utation)i(v)n │ │ │ │ │ (ector.)125 722 y Fi(\210)42 b Fl(IV)g(*newToOldIV)23 │ │ │ │ │ b Fm(:)28 b(ob)5 b(ject)28 b(that)f(stores)g(new-to-old)f(p)r(erm)n │ │ │ │ │ @@ -8425,17 +8404,17 @@ │ │ │ │ │ (gathers)f(them)h(on)g(all)g(the)g(pro)r(cessors)e(in)n(to)i(eac)n(h)f │ │ │ │ │ (of)h(their)h(global)e(output)0 5197 y(blo)r(c)n(ks.)36 │ │ │ │ │ b(These)27 b(op)r(erations)f(add)i(a)f(considerable)f(cost)h(to)g(the)h │ │ │ │ │ (solv)n(e)e(and)h(matrix-m)n(ultiplies,)g(but)i(the)e(next)h(release)e │ │ │ │ │ (of)0 5297 y(the)i Fn(LANCZOS)g Fm(soft)n(w)n(are)e(will)i(remo)n(v)n │ │ │ │ │ (e)e(these)h(steps.)p eop end │ │ │ │ │ %%Page: 16 17 │ │ │ │ │ -TeXDict begin 16 16 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(16)101 │ │ │ │ │ +TeXDict begin 16 16 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(16)101 │ │ │ │ │ 390 y(1.)42 b Fl(int)g(SetupMPI)e(\()j(void)f(*data,)f(int)i │ │ │ │ │ (*pprbtype,)c(int)k(*pneqns,)818 490 y(int)f(*pmxbsz,)e(InpMtx)h(*A,)i │ │ │ │ │ (InpMtx)e(*B,)h(int)h(*pseed,)818 589 y(int)f(*pmsglvl,)e(FILE)i │ │ │ │ │ (*msgFile,)e(MPI_Comm)g(comm)i(\))h(;)208 722 y Fm(All)28 │ │ │ │ │ b(calling)f(sequence)g(parameters)e(are)i(p)r(oin)n(ters)g(to)g(more)g │ │ │ │ │ (easily)g(allo)n(w)g(an)g(in)n(terface)g(with)h(F)-7 │ │ │ │ │ b(ortran.)307 888 y Fi(\210)42 b Fl(void)g(*data)26 b │ │ │ │ │ @@ -8514,17 +8493,17 @@ │ │ │ │ │ (cessors)d(that)j(o)n(wn)f(them.)307 5272 y Fi(\210)42 │ │ │ │ │ b Fm(The)28 b(sym)n(b)r(olic)f(factorization)f(is)i(then)g(computed)g │ │ │ │ │ (and)f(loaded)g(in)h(the)g Fl(BridgeMPI)c Fm(ob)5 b(ject.)307 │ │ │ │ │ 5405 y Fi(\210)42 b Fm(A)28 b Fl(FrontMtx)d Fm(ob)5 b(ject)27 │ │ │ │ │ b(is)g(created)g(to)h(hold)f(the)h(factorization)e(and)i(loaded)f(in)n │ │ │ │ │ (to)g(the)h Fl(BridgeMPI)c Fm(ob)5 b(ject.)p eop end │ │ │ │ │ %%Page: 17 18 │ │ │ │ │ -TeXDict begin 17 17 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(17)307 │ │ │ │ │ +TeXDict begin 17 17 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(17)307 │ │ │ │ │ 390 y Fi(\210)42 b Fm(A)20 b Fl(SubMtxManager)15 b Fm(ob)5 │ │ │ │ │ b(ject)20 b(is)f(created)g(to)h(hold)g(the)g(factor's)f(submatrices)g │ │ │ │ │ (and)h(loaded)f(in)n(to)g(the)i Fl(BridgeMPI)390 490 │ │ │ │ │ y Fm(ob)5 b(ject.)307 620 y Fi(\210)42 b Fm(The)22 b(map)g(from)g │ │ │ │ │ (factor)f(submatrices)h(to)g(their)g(o)n(wning)f(threads)g(is)h │ │ │ │ │ (computed)g(and)g(stored)g(in)g(the)g Fl(solvemap)390 │ │ │ │ │ 720 y Fm(ob)5 b(ject.)307 850 y Fi(\210)42 b Fm(The)28 │ │ │ │ │ @@ -8607,17 +8586,17 @@ │ │ │ │ │ Fl(*pnrows)p Fm(.)307 5162 y Fi(\210)42 b Fl(int)h(*pprbtype)23 │ │ │ │ │ b Fm(|)28 b Fl(*pprbtype)c Fm(holds)j(the)h(problem)f(t)n(yp)r(e.)456 │ │ │ │ │ 5292 y Fn({)41 b Fl(1)28 b Fm(|)f(vibration,)g(a)g(m)n(ultiply)h(with)h │ │ │ │ │ Fj(B)i Fm(is)d(required.)456 5407 y Fn({)41 b Fl(2)28 │ │ │ │ │ b Fm(|)f(buc)n(kling,)h(a)f(m)n(ultiply)h(with)g Fj(A)g │ │ │ │ │ Fm(is)f(required.)p eop end │ │ │ │ │ %%Page: 18 19 │ │ │ │ │ -TeXDict begin 18 18 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(18)456 │ │ │ │ │ +TeXDict begin 18 18 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(18)456 │ │ │ │ │ 390 y Fn({)41 b Fl(3)28 b Fm(|)f(simple,)h(no)g(m)n(ultiply)g(is)f │ │ │ │ │ (required.)307 518 y Fi(\210)42 b Fl(void)g(*data)26 │ │ │ │ │ b Fm(|)h(a)h(p)r(oin)n(ter)f(to)g(the)h Fl(BridgeMPI)c │ │ │ │ │ Fm(ob)5 b(ject.)101 678 y(4.)42 b Fl(void)f(MatMulMPI)f(\()k(int)e │ │ │ │ │ (*pnrows,)e(int)i(*pncols,)f(double)g(X[],)h(double)f(Y[],)905 │ │ │ │ │ 778 y(int)h(*pprbtype,)e(void)i(*data)f(\))i(;)208 908 │ │ │ │ │ y Fm(This)31 b(metho)r(d)i(computes)e(a)h(m)n(ultiply)g(of)g(the)g │ │ │ │ │ @@ -8705,17 +8684,17 @@ │ │ │ │ │ y(1)99 b(normal)27 b(return)1409 5319 y(-1)99 b Fl(pnrows)25 │ │ │ │ │ b Fm(is)j Fl(NULL)1409 5419 y Fm(-2)99 b Fl(pncols)25 │ │ │ │ │ b Fm(is)j Fl(NULL)2252 5220 y Fm(-3)99 b Fl(X)27 b Fm(is)h │ │ │ │ │ Fl(NULL)2252 5319 y Fm(-4)99 b Fl(Y)27 b Fm(is)h Fl(NULL)2252 │ │ │ │ │ 5419 y Fm(-5)99 b Fl(data)26 b Fm(is)i Fl(NULL)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 19 20 │ │ │ │ │ -TeXDict begin 19 19 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(19)101 │ │ │ │ │ +TeXDict begin 19 19 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(19)101 │ │ │ │ │ 390 y(7.)42 b Fl(int)g(CleanupMPI)d(\()44 b(void)d(*data)h(\))h(;)208 │ │ │ │ │ 520 y Fm(This)27 b(metho)r(d)h(releases)e(all)h(the)h(storage)e(used)i │ │ │ │ │ (b)n(y)f(the)h Fn(SPOOLES)g Fm(library)e(functions.)208 │ │ │ │ │ 649 y Fb(R)l(eturn)i(value:)38 b Fm(1)27 b(for)g(a)g(normal)g(return,)g │ │ │ │ │ (-1)g(if)h(a)f Fl(data)f Fm(is)h Fl(NULL)p Fm(.)0 943 │ │ │ │ │ y Fd(4.3)135 b(The)45 b Fc(testMPI)c Fd(Driv)l(er)46 │ │ │ │ │ b(Program)0 1146 y Fm(A)31 b(complete)f(listing)h(of)f(the)h(m)n │ │ │ │ │ @@ -8810,17 +8789,17 @@ │ │ │ │ │ b(*evec;)0 5073 y(int)304 b(error,)41 b(fstevl,)g(lfinit,)f(lstevl,)h │ │ │ │ │ (mxbksz,)g(msglvl,)f(ncol,)i(ndiscd,)436 5172 y(neig,)f(neigvl,)g │ │ │ │ │ (nfound,)g(nnonzeros,)e(nrhs,)j(nrow,)f(prbtyp,)g(rc,)436 │ │ │ │ │ 5272 y(retc,)g(rfinit,)g(seed,)h(warnng)f(;)0 5372 y(int)304 │ │ │ │ │ b(c__5)42 b(=)h(5,)g(output)e(=)i(6)g(;)1908 5656 y Fm(20)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 21 22 │ │ │ │ │ -TeXDict begin 21 21 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(21)0 │ │ │ │ │ +TeXDict begin 21 21 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(21)0 │ │ │ │ │ 390 y Fl(int)304 b(*lanczos_wksp;)0 490 y(InpMtx)172 │ │ │ │ │ b(*inpmtxA,)40 b(*inpmtxB)g(;)0 589 y(FILE)260 b(*msgFile,)40 │ │ │ │ │ b(*parmFile;)0 789 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---) │ │ │ │ │ o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(-*/)0 988 y(if)j(\()g(argc)f(!=)h(7)g(\))g({)131 │ │ │ │ │ 1088 y(fprintf\(stdout,)87 1187 y("\\n\\n)f(usage)f(:)i(\045s)g(msglvl) │ │ │ │ │ e(msgFile)g(parmFile)f(seed)i(inFileA)f(inFileB")87 1287 │ │ │ │ │ @@ -8856,17 +8835,17 @@ │ │ │ │ │ b(in)g(the)h(Harwell-Boeing)38 b(matrix)j(information)131 │ │ │ │ │ 5073 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)0 5172 y(*/)0 5272 y(if)i(\()g(strcmp\(inFileNam)o │ │ │ │ │ (e_)o(A,)37 b("none"\))k(==)i(0)g(\))g({)131 5372 y(fprintf\(msgFile,) │ │ │ │ │ 37 b("\\n)42 b(no)h(file)f(to)h(read)e(from"\))h(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 22 23 │ │ │ │ │ -TeXDict begin 22 22 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(22)131 │ │ │ │ │ +TeXDict begin 22 22 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(22)131 │ │ │ │ │ 390 y Fl(exit\(0\))40 b(;)0 490 y(})0 589 y(MARKTIME\(t1\))f(;)0 │ │ │ │ │ 689 y(readHB_info)g(\(inFileName_A,)f(&nrow,)j(&ncol,)g(&nnonzeros,)e │ │ │ │ │ (&type,)i(&nrhs\))g(;)0 789 y(MARKTIME\(t2\))e(;)0 888 │ │ │ │ │ y(fprintf\(msgFile,)e("\\n)42 b(CPU)h(\0458.3f)e(:)i(read)f(in)h │ │ │ │ │ (header)e(information)e(for)k(A",)349 988 y(t2)f(-)i(t1\))e(;)0 │ │ │ │ │ 1088 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ @@ -8910,17 +8889,17 @@ │ │ │ │ │ 4774 y(fprintf\(msgFile,)e("\\n)42 b(CPU)h(\0458.3f)e(:)i(read)f(in)h │ │ │ │ │ (eigenvalue)c(problem)i(data",)349 4873 y(t2)h(-)i(t1\))e(;)0 │ │ │ │ │ 4973 y(/*)131 5073 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(---)131 5172 y(check)f(and)i(set)f(the)g(problem)f │ │ │ │ │ (type)h(parameter)131 5272 y(----------------)o(--)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(--)o(---)0 5372 y(*/)p eop end │ │ │ │ │ %%Page: 23 24 │ │ │ │ │ -TeXDict begin 23 23 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(23)0 │ │ │ │ │ +TeXDict begin 23 23 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(23)0 │ │ │ │ │ 390 y Fl(switch)41 b(\()i(pbtype[1])d(\))j({)0 490 y(case)f('v')g(:)h │ │ │ │ │ (case)f('V')h(:)g(prbtyp)e(=)i(1)g(;)h(break)d(;)0 589 │ │ │ │ │ y(case)h('b')g(:)h(case)f('B')h(:)g(prbtyp)e(=)i(2)g(;)h(break)d(;)0 │ │ │ │ │ 689 y(case)h('o')g(:)h(case)f('O')h(:)g(prbtyp)e(=)i(3)g(;)h(break)d(;) │ │ │ │ │ 0 789 y(default)g(:)131 888 y(fprintf\(stderr,)c("\\n)42 │ │ │ │ │ b(invalid)f(problem)g(type)h(\045s",)g(pbtype\))e(;)131 │ │ │ │ │ 988 y(exit\(-1\))g(;)0 1088 y(})0 1187 y(/*)131 1287 │ │ │ │ │ @@ -8960,17 +8939,17 @@ │ │ │ │ │ b(CPU)h(\0458.3f)e(:)i(read)f(in)h(A",)f(t2)h(-)g(t1\))g(;)0 │ │ │ │ │ 5073 y(if)g(\()g(msglvl)e(>)i(2)g(\))h({)131 5172 y(fprintf\(msgFile,) │ │ │ │ │ 37 b("\\n\\n)k(InpMtx)g(A)j(object)d(after)g(loading"\))f(;)131 │ │ │ │ │ 5272 y(InpMtx_writeForH)o(um)o(an)o(Eye)o(\(i)o(npm)o(tx)o(A,)d │ │ │ │ │ (msgFile\))j(;)131 5372 y(fflush\(msgFile\))d(;)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 24 25 │ │ │ │ │ -TeXDict begin 24 24 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(24)0 │ │ │ │ │ +TeXDict begin 24 24 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(24)0 │ │ │ │ │ 390 y Fl(})0 490 y(MARKTIME\(t1\))39 b(;)0 589 y(lanczos_set_parm)o(\() │ │ │ │ │ f(&lanczos_wksp,)f("matrix-type",)h(&c__1,)j(&retc)h(\);)0 │ │ │ │ │ 689 y(MARKTIME\(t2\))d(;)0 789 y(fprintf\(msgFile,)e("\\n)42 │ │ │ │ │ b(CPU)h(\0458.3f)e(:)i(set)g(A's)f(parameters",)d(t2)j(-)i(t1\))e(;)0 │ │ │ │ │ 888 y(if)h(\()g(prbtyp)e(!=)i(3)g(\))g({)131 988 y(if)g(\()g │ │ │ │ │ (strcmp\(inFileNa)o(me_)o(B,)37 b("none"\))k(==)h(0)i(\))f({)262 │ │ │ │ │ 1088 y(fprintf\(msgFile)o(,)37 b("\\n)43 b(no)g(file)f(to)g(read)g │ │ │ │ │ @@ -9007,17 +8986,17 @@ │ │ │ │ │ 4873 y(nfound)g(--)i(#)g(of)g(eigenvalues)c(found)i(and)h(kept)131 │ │ │ │ │ 4973 y(ndisc)85 b(--)43 b(#)g(of)g(additional)c(eigenvalues)g │ │ │ │ │ (discarded)131 5073 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--) │ │ │ │ │ o(---)o(--)o(--)o(---)o(--)o(---)o(--)0 5172 y(*/)0 5272 │ │ │ │ │ y(MARKTIME\(t1\))g(;)0 5372 y(lanczos_run\(&nei)o(gvl)o(,)e(&which[1])j │ │ │ │ │ (,)j(&pbtype[1],)c(&lfinit,)i(&lftend,)p eop end │ │ │ │ │ %%Page: 25 26 │ │ │ │ │ -TeXDict begin 25 25 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(25)174 │ │ │ │ │ +TeXDict begin 25 25 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(25)174 │ │ │ │ │ 390 y Fl(&rfinit,)41 b(&rhtend,)f(¢er,)g(&lanczos_wksp,)e(&bridge,) │ │ │ │ │ i(&nfound,)174 490 y(&ndiscd,)h(&warnng,)f(&error,)h(Factor,)f(MatMul,) │ │ │ │ │ h(Solve)g(\))j(;)0 589 y(MARKTIME\(t2\))39 b(;)0 689 │ │ │ │ │ y(fprintf\(msgFile,)e("\\n)42 b(CPU)h(\0458.3f)e(:)i(time)f(for)h │ │ │ │ │ (lanczos)d(run",)i(t2)h(-)g(t1\))f(;)0 789 y(/*)131 888 │ │ │ │ │ y(----------------)o(--)o(--)o(---)o(--)131 988 y(get)g(eigenvalues)d │ │ │ │ │ (and)j(print)131 1088 y(----------------)o(--)o(--)o(---)o(--)0 │ │ │ │ │ @@ -9049,17 +9028,17 @@ │ │ │ │ │ 4674 y(*/)0 4774 y(MARKTIME\(t1\))e(;)0 4873 y(lanczos_free\()f │ │ │ │ │ (&lanczos_wksp)g(\))44 b(;)0 4973 y(MARKTIME\(t2\))39 │ │ │ │ │ b(;)0 5073 y(fprintf\(msgFile,)e("\\n)42 b(CPU)h(\0458.3f)e(:)i(free)f │ │ │ │ │ (lanczos)f(workspace)f(",)j(t2)f(-)i(t1\))e(;)0 5172 │ │ │ │ │ y(MARKTIME\(t1\))d(;)0 5272 y(rc)k(=)g(Cleanup\(&bridge\))37 │ │ │ │ │ b(;)0 5372 y(MARKTIME\(t2\))i(;)p eop end │ │ │ │ │ %%Page: 26 27 │ │ │ │ │ -TeXDict begin 26 26 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(26)0 │ │ │ │ │ +TeXDict begin 26 26 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(26)0 │ │ │ │ │ 390 y Fl(fprintf\(msgFile,)37 b("\\n)42 b(CPU)h(\0458.3f)e(:)i(free)f │ │ │ │ │ (solver)f(workspace)f(",)j(t2)g(-)g(t1\))f(;)0 490 y(if)h(\()g(rc)g(!=) │ │ │ │ │ f(1)i(\))f({)131 589 y(fprintf\(stderr,)37 b("\\n)42 │ │ │ │ │ b(error)g(return)f(\045d)i(from)f(Cleanup\(\)",)d(rc\))j(;)131 │ │ │ │ │ 689 y(exit\(-1\))e(;)0 789 y(})0 888 y(fprintf\(msgFile,)d("\\n"\))k(;) │ │ │ │ │ 0 988 y(fclose\(msgFile\))c(;)0 1187 y(return)k(;)i(})p │ │ │ │ │ eop end │ │ │ │ │ @@ -9092,17 +9071,17 @@ │ │ │ │ │ 4973 y(int)304 b(error,)41 b(fstevl,)g(lfinit,)f(lstevl,)h(msglvl,)g │ │ │ │ │ (mxbksz,)f(ncol,)i(ndiscd,)436 5073 y(neig,)f(neigvl,)g(nfound,)g │ │ │ │ │ (nnonzeros,)e(nrhs,)j(nrow,)f(nthreads,)436 5172 y(prbtyp,)g(rc,)h │ │ │ │ │ (retc,)f(rfinit,)g(seed,)h(warnng)f(;)0 5272 y(int)304 │ │ │ │ │ b(c__5)42 b(=)h(5,)g(output)e(=)i(6)g(;)0 5372 y(int)304 │ │ │ │ │ b(*lanczos_wksp;)1908 5656 y Fm(27)p eop end │ │ │ │ │ %%Page: 28 29 │ │ │ │ │ -TeXDict begin 28 28 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(28)0 │ │ │ │ │ +TeXDict begin 28 28 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(28)0 │ │ │ │ │ 390 y Fl(InpMtx)172 b(*inpmtxA,)40 b(*inpmtxB)g(;)0 490 │ │ │ │ │ y(FILE)260 b(*msgFile,)40 b(*parmFile)g(;)0 589 y(/*--------------)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ 689 y(if)j(\()g(argc)f(!=)h(8)g(\))g({)131 789 y(fprintf\(stdout,)0 │ │ │ │ │ 888 y("\\n\\n)f(usage)f(:)i(\045s)g(msglvl)e(msgFile)g(parmFile)f(seed) │ │ │ │ │ i(nthread)f(inFileA)f(inFileB")0 988 y("\\n)173 b(msglvl)128 │ │ │ │ │ @@ -9142,17 +9121,17 @@ │ │ │ │ │ (Harwell-Boeing)38 b(matrix)j(information)131 4973 y(----------------)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)0 │ │ │ │ │ 5073 y(*/)0 5172 y(if)i(\()g(strcmp\(inFileNam)o(e_)o(A,)37 │ │ │ │ │ b("none"\))k(==)i(0)g(\))g({)131 5272 y(fprintf\(msgFile,)37 │ │ │ │ │ b("\\n)42 b(no)h(file)f(to)h(read)e(from"\))h(;)131 5372 │ │ │ │ │ y(exit\(0\))e(;)p eop end │ │ │ │ │ %%Page: 29 30 │ │ │ │ │ -TeXDict begin 29 29 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(29)0 │ │ │ │ │ +TeXDict begin 29 29 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(29)0 │ │ │ │ │ 390 y Fl(})0 490 y(MARKTIME\(t1\))39 b(;)0 589 y(readHB_info)g │ │ │ │ │ (\(inFileName_A,)f(&nrow,)j(&ncol,)g(&nnonzeros,)e(&type,)i(&nrhs\))g │ │ │ │ │ (;)0 689 y(MARKTIME\(t2\))e(;)0 789 y(fprintf\(msgFile,)e("\\n)42 │ │ │ │ │ b(CPU)h(\0458.3f)e(:)i(read)f(in)h(harwell-boeing)38 │ │ │ │ │ b(header)j(info",)349 888 y(t2)h(-)i(t1\))e(;)0 988 y │ │ │ │ │ (fflush\(msgFile\))37 b(;)0 1088 y(/*--------------)o(---)o(--)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o │ │ │ │ │ @@ -9198,17 +9177,17 @@ │ │ │ │ │ (eigenvalue)c(problem)i(data",)349 4873 y(t2)h(-)i(t1\))e(;)0 │ │ │ │ │ 4973 y(fflush\(msgFile\))37 b(;)0 5073 y(/*)131 5172 │ │ │ │ │ y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ (---)131 5272 y(check)k(and)i(set)f(the)g(problem)f(type)h(parameter) │ │ │ │ │ 131 5372 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--) │ │ │ │ │ o(--)o(---)p eop end │ │ │ │ │ %%Page: 30 31 │ │ │ │ │ -TeXDict begin 30 30 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(30)0 │ │ │ │ │ +TeXDict begin 30 30 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(30)0 │ │ │ │ │ 390 y Fl(*/)0 490 y(switch)41 b(\()i(pbtype[1])d(\))j({)0 │ │ │ │ │ 589 y(case)f('v')g(:)0 689 y(case)g('V')g(:)131 789 y(prbtyp)f(=)i(1)g │ │ │ │ │ (;)131 888 y(break)e(;)0 988 y(case)h('b')g(:)0 1088 │ │ │ │ │ y(case)g('B')g(:)131 1187 y(prbtyp)f(=)i(2)g(;)131 1287 │ │ │ │ │ y(break)e(;)0 1386 y(case)h('o')g(:)0 1486 y(case)g('O')g(:)131 │ │ │ │ │ 1586 y(prbtyp)f(=)i(3)g(;)131 1685 y(break)e(;)0 1785 │ │ │ │ │ y(default)g(:)131 1885 y(fprintf\(stderr,)c("\\n)42 b(invalid)f │ │ │ │ │ @@ -9241,17 +9220,17 @@ │ │ │ │ │ (--)o(-*/)0 4873 y(/*)131 4973 y(----------------)o(--)o(--)o(---)o(--) │ │ │ │ │ o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)131 5073 │ │ │ │ │ y(create)f(the)h(InpMtx)f(objects)g(for)h(matrix)f(A)j(and)e(B)131 │ │ │ │ │ 5172 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)0 5272 y(*/)0 5372 y(if)h(\()g(strcmp\(inFileNam)o │ │ │ │ │ (e_)o(A,)37 b("none"\))k(==)i(0)g(\))g({)p eop end │ │ │ │ │ %%Page: 31 32 │ │ │ │ │ -TeXDict begin 31 31 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(31)131 │ │ │ │ │ +TeXDict begin 31 31 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(31)131 │ │ │ │ │ 390 y Fl(fprintf\(msgFile,)37 b("\\n)42 b(no)h(file)f(to)h(read)e(A)j │ │ │ │ │ (from"\))d(;)131 490 y(exit\(-1\))f(;)0 589 y(})0 689 │ │ │ │ │ y(MARKTIME\(t1\))f(;)0 789 y(inpmtxA)i(=)i(InpMtx_new\(\))38 │ │ │ │ │ b(;)0 888 y(InpMtx_readFromH)o(Bfi)o(le)f(\()43 b(inpmtxA,)d │ │ │ │ │ (inFileName_A)f(\))k(;)0 988 y(MARKTIME\(t2\))c(;)0 1088 │ │ │ │ │ y(fprintf\(msgFile,)e("\\n)42 b(CPU)h(\0458.3f)e(:)i(read)f(in)h(A",)f │ │ │ │ │ (t2)h(-)g(t1\))g(;)0 1187 y(fflush\(msgFile\))37 b(;)0 │ │ │ │ │ @@ -9287,17 +9266,17 @@ │ │ │ │ │ b(CPU)h(\0458.3f)e(:)i(set)g(up)f(the)h(solver)e(environment",)349 │ │ │ │ │ 4873 y(t2)h(-)i(t1\))e(;)0 4973 y(fflush\(msgFile\))37 │ │ │ │ │ b(;)0 5073 y(if)43 b(\()g(rc)g(!=)f(1)i(\))f({)131 5172 │ │ │ │ │ y(fprintf\(stderr,)37 b("\\n)42 b(error)g(return)f(\045d)i(from)f │ │ │ │ │ (SetupMT\(\)",)d(rc\))j(;)131 5272 y(exit\(-1\))e(;)0 │ │ │ │ │ 5372 y(})p eop end │ │ │ │ │ %%Page: 32 33 │ │ │ │ │ -TeXDict begin 32 32 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(32)0 │ │ │ │ │ +TeXDict begin 32 32 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(32)0 │ │ │ │ │ 390 y Fl(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(-*/)0 490 y(/*)131 589 y(----------------)o(--)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)131 689 │ │ │ │ │ y(invoke)41 b(eigensolver)131 789 y(nfound)g(--)i(#)g(of)g(eigenvalues) │ │ │ │ │ c(found)i(and)h(kept)131 888 y(ndisc)85 b(--)43 b(#)g(of)g(additional)c │ │ │ │ │ (eigenvalues)g(discarded)131 988 y(----------------)o(--)o(--)o(---)o │ │ │ │ │ @@ -9333,17 +9312,17 @@ │ │ │ │ │ 131 4774 y(hdslp5_)d(\()k("computed)39 b(eigenvector)h(returned)g(by)j │ │ │ │ │ (hdserc",)567 4873 y(&neig,)e(evec,)g(&output,)g(39L)h(\))h(;)0 │ │ │ │ │ 4973 y(})0 5073 y(MARKTIME\(t2\))c(;)0 5172 y(fprintf\(msgFile,)e("\\n) │ │ │ │ │ 42 b(CPU)h(\0458.3f)e(:)i(get)g(and)f(print)g(eigenvectors",)37 │ │ │ │ │ b(t2)43 b(-)g(t1\))g(;)0 5272 y(fflush\(msgFile\))37 │ │ │ │ │ b(;)0 5372 y(*/)p eop end │ │ │ │ │ %%Page: 33 34 │ │ │ │ │ -TeXDict begin 33 33 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(33)0 │ │ │ │ │ +TeXDict begin 33 33 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(33)0 │ │ │ │ │ 390 y Fl(/*)131 490 y(----------------)o(--)o(--)o(---)o(-)131 │ │ │ │ │ 589 y(free)42 b(the)g(working)f(storage)131 689 y(----------------)o │ │ │ │ │ (--)o(--)o(---)o(-)0 789 y(*/)0 888 y(MARKTIME\(t1\))e(;)0 │ │ │ │ │ 988 y(lanczos_free\()f(&lanczos_wksp)g(\))44 b(;)0 1088 │ │ │ │ │ y(MARKTIME\(t2\))39 b(;)0 1187 y(fprintf\(msgFile,)e("\\n)42 │ │ │ │ │ b(CPU)h(\0458.3f)e(:)i(free)f(lanczos)f(workspace",)e(t2)k(-)g(t1\))f │ │ │ │ │ (;)0 1287 y(fflush\(msgFile\))37 b(;)0 1386 y(MARKTIME\(t1\))i(;)0 │ │ │ │ │ @@ -9383,17 +9362,17 @@ │ │ │ │ │ b(*inpmtxA,)40 b(*inpmtxB)g(;)0 5009 y(FILE)260 b(*msgFile,)40 │ │ │ │ │ b(*parmFile)g(;)0 5108 y(double)172 b(lftend,)41 b(rhtend,)f(center,)h │ │ │ │ │ (shfscl,)g(t1,)h(t2)h(;)0 5208 y(double)172 b(c__1)42 │ │ │ │ │ b(=)h(1.0,)f(c__4)g(=)h(4.0,)f(tolact)f(=)i(2.309970868130169)o(e-)o │ │ │ │ │ (11)37 b(;)0 5308 y(double)172 b(eigval[1000],)38 b(sigma[2])i(;)0 │ │ │ │ │ 5407 y(double)172 b(*evec;)1908 5656 y Fm(34)p eop end │ │ │ │ │ %%Page: 35 36 │ │ │ │ │ -TeXDict begin 35 35 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(35)0 │ │ │ │ │ +TeXDict begin 35 35 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(35)0 │ │ │ │ │ 390 y Fl(/*)131 490 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--) │ │ │ │ │ o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---) │ │ │ │ │ o(-)131 589 y(find)42 b(out)g(the)g(identity)f(of)h(this)g(process)f │ │ │ │ │ (and)h(the)h(number)e(of)i(process)131 689 y(----------------)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(---)o(-)0 789 y(*/)0 888 y(MPI_Init\(&argc,)37 │ │ │ │ │ b(&argv\))k(;)0 988 y(MPI_Comm_dup\(MPI)o(_CO)o(MM)o(_W)o(ORL)o(D,)c │ │ │ │ │ @@ -9431,17 +9410,17 @@ │ │ │ │ │ 4375 y(argv[0],)e(buffer\))h(;)262 4475 y(return)g(;)131 │ │ │ │ │ 4575 y(})131 4674 y(CVfree\(buffer\))d(;)0 4774 y(})0 │ │ │ │ │ 4873 y(parmFileName)h(=)k(argv[3])d(;)0 4973 y(seed)391 │ │ │ │ │ b(=)43 b(atoi\(argv[4]\))38 b(;)0 5073 y(inFileName_A)h(=)k(argv[5])d │ │ │ │ │ (;)0 5172 y(inFileName_B)f(=)k(argv[6])d(;)0 5272 y(fprintf\(msgFile,) │ │ │ │ │ 349 5372 y("\\n)i(\045s)h(")p eop end │ │ │ │ │ %%Page: 36 37 │ │ │ │ │ -TeXDict begin 36 36 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(36)349 │ │ │ │ │ +TeXDict begin 36 36 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(36)349 │ │ │ │ │ 390 y Fl("\\n)42 b(msglvl)695 b(--)43 b(\045d")349 490 │ │ │ │ │ y("\\n)f(message)f(file)434 b(--)43 b(\045s")349 589 │ │ │ │ │ y("\\n)f(parameter)e(file)347 b(--)43 b(\045s")349 689 │ │ │ │ │ y("\\n)f(stiffness)e(matrix)h(file)h(--)h(\045s")349 │ │ │ │ │ 789 y("\\n)f(mass)g(matrix)f(file)260 b(--)43 b(\045s")349 │ │ │ │ │ 888 y("\\n)f(random)f(number)g(seed)173 b(--)43 b(\045d")349 │ │ │ │ │ 988 y("\\n",)349 1088 y(argv[0],)d(msglvl,)h(argv[2],)f(parmFileName,)e │ │ │ │ │ @@ -9484,17 +9463,17 @@ │ │ │ │ │ 4973 y('o')i(or)h('O')f(ordinary)f(symmetric)f(eigenproblem)131 │ │ │ │ │ 5073 y(lfinit)h(--)i(if)f(true,)g(lftend)f(is)i(restriction)c(on)k │ │ │ │ │ (lower)e(bound)h(of)567 5172 y(eigenvalues.)c(if)43 b(false,)e(no)i │ │ │ │ │ (restriction)c(on)k(lower)e(bound)131 5272 y(lftend)g(--)i(left)f │ │ │ │ │ (endpoint)e(of)j(interval)131 5372 y(rfinit)e(--)i(if)f(true,)g(rhtend) │ │ │ │ │ f(is)i(restriction)c(on)k(upper)e(bound)h(of)p eop end │ │ │ │ │ %%Page: 37 38 │ │ │ │ │ -TeXDict begin 37 37 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(37)567 │ │ │ │ │ +TeXDict begin 37 37 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(37)567 │ │ │ │ │ 390 y Fl(eigenvalues.)82 b(if)43 b(false,)e(no)h(restriction)d(on)k │ │ │ │ │ (upper)f(bound)131 490 y(rhtend)f(--)i(right)e(endpoint)f(of)j │ │ │ │ │ (interval)131 589 y(center)e(--)i(center)e(of)h(interval)131 │ │ │ │ │ 689 y(mxbksz)f(--)i(upper)e(bound)h(on)g(block)g(size)g(for)g(Lanczos)f │ │ │ │ │ (recurrence)131 789 y(shfscl)g(--)i(shift)e(scaling)g(parameter,)e(an)k │ │ │ │ │ (estimate)d(on)j(the)f(magnitude)567 888 y(of)g(the)h(smallest)d │ │ │ │ │ (nonzero)h(eigenvalues)131 988 y(----------------)o(--)o(--)o(---)o(--) │ │ │ │ │ @@ -9532,17 +9511,17 @@ │ │ │ │ │ 4973 y(*/)0 5073 y(MARKTIME\(t1\))h(;)0 5172 y(lanczos_set_parm)o(\()f │ │ │ │ │ (&lanczos_wksp,)f("order-of-problem)o(",)g(&nrow,)k(&retc)h(\);)0 │ │ │ │ │ 5272 y(lanczos_set_parm)o(\()c(&lanczos_wksp,)f("accuracy-toleran)o(ce) │ │ │ │ │ o(",)g(&tolact,)k(&retc)g(\);)0 5372 y(lanczos_set_parm)o(\()d │ │ │ │ │ (&lanczos_wksp,)f("max-block-size",)g(&mxbksz,)j(&retc)i(\);)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 38 39 │ │ │ │ │ -TeXDict begin 38 38 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(38)0 │ │ │ │ │ +TeXDict begin 38 38 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(38)0 │ │ │ │ │ 390 y Fl(lanczos_set_parm)o(\()38 b(&lanczos_wksp,)f("shift-scale",)h │ │ │ │ │ (&shfscl,)i(&retc)i(\);)0 490 y(lanczos_set_parm)o(\()c(&lanczos_wksp,) │ │ │ │ │ f("message_level",)g(&msglvl,)k(&retc)g(\);)0 589 y(lanczos_set_parm)o │ │ │ │ │ (\()d(&lanczos_wksp,)f("mpi-communicator)o(",)g(&comm,)k(&retc)h(\);)0 │ │ │ │ │ 689 y(lanczos_set_parm)o(\()c(&lanczos_wksp,)f("qfile-pathname",)g │ │ │ │ │ ("lqfil",)j(&retc)i(\);)0 789 y(lanczos_set_parm)o(\()c(&lanczos_wksp,) │ │ │ │ │ f("mqfil-pathname",)g("lmqfil",)j(&retc)h(\);)0 888 y(lanczos_set_parm) │ │ │ │ │ @@ -9583,17 +9562,17 @@ │ │ │ │ │ y(InpMtx_writeForHu)o(ma)o(nEy)o(e\()o(inp)o(mt)o(xB)o(,)e(msgFile\))i │ │ │ │ │ (;)392 4774 y(fflush\(msgFile\))e(;)262 4873 y(})131 │ │ │ │ │ 4973 y(})43 b(else)f({)262 5073 y(inpmtxB)e(=)j(NULL)f(;)262 │ │ │ │ │ 5172 y(lanczos_set_par)o(m\()37 b(&lanczos_wksp,)h("matrix-type",)g │ │ │ │ │ (&c__4,)j(&retc)g(\);)131 5272 y(})0 5372 y(})i(else)f({)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 39 40 │ │ │ │ │ -TeXDict begin 39 39 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(39)0 │ │ │ │ │ +TeXDict begin 39 39 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(39)0 │ │ │ │ │ 390 y Fl(/*)131 490 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--) │ │ │ │ │ o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(-)131 589 y(other)41 │ │ │ │ │ b(processors)f(initialize)f(their)j(local)f(matrices)131 │ │ │ │ │ 689 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--) │ │ │ │ │ o(---)o(--)o(---)o(--)o(-)0 789 y(*/)131 888 y(inpmtxA)f(=)k │ │ │ │ │ (InpMtx_new\(\))38 b(;)131 988 y(InpMtx_init\(inpm)o(tx)o(A,)f │ │ │ │ │ (INPMTX_BY_CHEVRO)o(NS,)g(SPOOLES_REAL,)h(0,)43 b(0\))g(;)131 │ │ │ │ │ @@ -9632,17 +9611,17 @@ │ │ │ │ │ 4774 y(JimSolveMPI)f(\))k(;)0 4873 y(MARKTIME\(t2\))c(;)0 │ │ │ │ │ 4973 y(fprintf\(msgFile,)e("\\n)42 b(CPU)h(\0458.3f)e(:)i(time)f(for)h │ │ │ │ │ (lanczos)d(run",)i(t2)h(-)g(t1\))f(;)0 5073 y(fflush\(msgFile\))37 │ │ │ │ │ b(;)0 5172 y(if)43 b(\()g(myid)f(==)h(0)g(\))g({)0 5272 │ │ │ │ │ y(/*)131 5372 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---) │ │ │ │ │ o(--)o(--)o(---)o(--)o(---)o(-)p eop end │ │ │ │ │ %%Page: 40 41 │ │ │ │ │ -TeXDict begin 40 40 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(40)131 │ │ │ │ │ +TeXDict begin 40 40 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(40)131 │ │ │ │ │ 390 y Fl(processor)40 b(0)j(deals)e(with)h(eigenvalues)d(and)k(vectors) │ │ │ │ │ 131 490 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(-)0 589 y(*/)131 689 y(MARKTIME\(t1\))38 │ │ │ │ │ b(;)131 789 y(neig)129 b(=)43 b(nfound)e(+)i(ndiscd)e(;)131 │ │ │ │ │ 888 y(lstevl)g(=)i(nfound)e(;)131 988 y(lanczos_eigenval)o(ue)o(s)c │ │ │ │ │ (\(&lanczos_wksp,)h(eigval,)j(&neig,)g(&retc\);)131 1088 │ │ │ │ │ y(fstevl)g(=)i(1)g(;)131 1187 y(if)g(\()g(nfound)e(==)i(0)g(\))g │ │ │ │ │ @@ -9672,17 +9651,17 @@ │ │ │ │ │ (ksp)o(\))e(;)0 4774 y(MARKTIME\(t2\))i(;)0 4873 y(fprintf\(msgFile,)e │ │ │ │ │ ("\\n)42 b(CPU)h(\0458.3f)e(:)i(free)f(lanczos)f(workspace",)e(t2)k(-)g │ │ │ │ │ (t1\))f(;)0 4973 y(fflush\(msgFile\))37 b(;)0 5073 y(MARKTIME\(t1\))i │ │ │ │ │ (;)0 5172 y(CleanupMPI\(&brid)o(ge\))e(;)0 5272 y(MARKTIME\(t2\))i(;)0 │ │ │ │ │ 5372 y(fprintf\(msgFile,)e("\\n)42 b(CPU)h(\0458.3f)e(:)i(free)f │ │ │ │ │ (solver)f(workspace",)e(t2)k(-)g(t1\))g(;)p eop end │ │ │ │ │ %%Page: 41 42 │ │ │ │ │ -TeXDict begin 41 41 bop 83 100 764 4 v 929 100 a Fn(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fm(41)0 │ │ │ │ │ +TeXDict begin 41 41 bop 83 100 781 4 v 947 100 a Fn(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fe(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fm(41)0 │ │ │ │ │ 390 y Fl(fflush\(msgFile\))37 b(;)0 589 y(MPI_Finalize\(\))h(;)0 │ │ │ │ │ 789 y(fprintf\(msgFile,)f("\\n"\))k(;)0 888 y(fclose\(msgFile\))c(;)0 │ │ │ │ │ 1088 y(return)k(;)i(})p eop end │ │ │ │ │ %%Page: 42 43 │ │ │ │ │ TeXDict begin 42 42 bop 0 866 a Fo(Index)0 1281 y Fl(Cleanup\(\))p │ │ │ │ │ Fm(,)24 b(7)0 1380 y Fl(CleanupMPI\(\))p Fm(,)f(19)0 │ │ │ │ │ 1480 y Fl(CleanupMT\(\))p Fm(,)g(12)0 1663 y Fl(Factor\(\))p │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -1,12 +1,12 @@ │ │ │ │ │ │ Integrating the SPOOLES 2.2 Sparse Linear Algebra Library │ │ │ │ │ │ into the LANCZOS Block-shifted Lanczos Eigensolver │ │ │ │ │ │ Cleve Ashcraft Jim Patterson │ │ │ │ │ │ Boeing Phantom Works1 Boeing Phantom Works2 │ │ │ │ │ │ - February 8, 2025 │ │ │ │ │ │ + January 7, 2024 │ │ │ │ │ │ 1P. O. Box 24346, Mail Stop 7L-22, Seattle, Washington 98124, cleve.ashcraft@boeing.com. This research │ │ │ │ │ │ was supported in part by the DARPA Contract DABT63-95-C-0122 and the DoD High Performance Computing │ │ │ │ │ │ Modernization Program Common HPC Software Support Initiative. │ │ │ │ │ │ 2P. O. Box 24346, Mail Stop 7L-22, Seattle, Washington 98124, pattersn@redwood.rt.cs.boeing.com. This re- │ │ │ │ │ │ search was supportedin part bytheDARPAContractDABT63-95-C-0122 andtheDoDHighPerformanceComputing │ │ │ │ │ │ Modernization Program Common HPC Software Support Initiative. │ │ │ │ │ │ Contents │ │ │ │ │ │ @@ -55,18 +55,18 @@ │ │ │ │ │ │ b b │ │ │ │ │ │ izations and solves involving A and B. This permutation matrix P is typically found by ordering the graph │ │ │ │ │ │ of A +B using a variant of minimum degree or nested dissection. The ordering is performed prior to any │ │ │ │ │ │ action by the eigensolver. This “setup phase” includes more than just finding the permutation matrix, e.g., │ │ │ │ │ │ various data structures must be initialized. In a parallel environment, there is even more setup work to do, │ │ │ │ │ │ analyzing the factorization and solves and specifying which threads or processors perform what computations │ │ │ │ │ │ 2 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 3 │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 3 │ │ │ │ │ │ and store what data. In a distributed environment, the entries of A and B must also be distributed among │ │ │ │ │ │ the processors in preparation for the factors and multiplies. │ │ │ │ │ │ - For each of the three environments — serial, multithreaded and MPI — the SPOOLES solver has │ │ │ │ │ │ + For each of the three environments — serial, multithreaded and MPI — the SPOOLES solver has │ │ │ │ │ │ constructed a “bridge” object to span the interface between the linear system solver and the eigensolver. │ │ │ │ │ │ Each of the Bridge, BridgeMT and BridgeMPI objects have five methods: set-up, factor, solve, matrix- │ │ │ │ │ │ multiply and cleanup. The factor, solve and matrix-multiply methods follow the calling sequence convention │ │ │ │ │ │ imposed by the eigensolver, and are passed to the eigensolver at the beginning of the Lanczos run. The │ │ │ │ │ │ set-up method is called prior to the eigensolver, and the cleanup method is called after the eigenvalues and │ │ │ │ │ │ eigenvectors have been determined. │ │ │ │ │ │ Chapter 2 │ │ │ │ │ │ @@ -91,55 +91,55 @@ │ │ │ │ │ │ and are used in the solves. │ │ │ │ │ │ • FrontMtx *frontmtx : object that stores the L, D and U factor matrices. │ │ │ │ │ │ • IV *oldToNewIV : object that stores old-to-new permutation vector. │ │ │ │ │ │ • IV *newToOldIV : object that stores new-to-old permutation vector. │ │ │ │ │ │ • DenseMtx *X : dense matrix object that is used during the matrix multiples and solves. │ │ │ │ │ │ • DenseMtx *Y : dense matrix object that is used during the matrix multiples and solves. │ │ │ │ │ │ 4 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 5 │ │ │ │ │ │ - • int msglvl : message level for output. When 0, no output, When 1, just statistics and cpu times. │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 5 │ │ │ │ │ │ + • int msglvl : message level for output. When 0, no output, When 1, just statistics and cpu times. │ │ │ │ │ │ When greater than 1, more and more output. │ │ │ │ │ │ - • FILE *msgFile : message file for output. When msglvl > 0, msgFile must not be NULL. │ │ │ │ │ │ - 2.2 Prototypes and descriptions of Bridge methods │ │ │ │ │ │ + • FILE *msgFile : message file for output. When msglvl > 0, msgFile must not be NULL. │ │ │ │ │ │ + 2.2 Prototypes and descriptions of Bridge methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the Bridge object. │ │ │ │ │ │ 1. int Setup ( void *data, int *pprbtype, int *pneqns, int *pmxbsz, │ │ │ │ │ │ - InpMtx *A, InpMtx *B, int *pseed, int *pmsglvl, FILE *msgFile ) ; │ │ │ │ │ │ + InpMtx *A, InpMtx *B, int *pseed, int *pmsglvl, FILE *msgFile ) ; │ │ │ │ │ │ All calling sequence parameters are pointers to more easily allow an interface with Fortran. │ │ │ │ │ │ - • void *data — a pointer to the Bridge object. │ │ │ │ │ │ - • int *pprbtype — *pprbtype holds the problem type. │ │ │ │ │ │ - – 1 — vibration, a multiply with B is required. │ │ │ │ │ │ - – 2 — buckling, a multiply with A is required. │ │ │ │ │ │ - – 3 — simple, no multiply is required. │ │ │ │ │ │ - • int *pneqns — *pneqns is the number of equations. │ │ │ │ │ │ - • int *pmxbsz — *pmxbsz is an upper bound on the block size. │ │ │ │ │ │ - • InpMtx *A — A is a SPOOLES object that holds the matrix A. │ │ │ │ │ │ - • InpMtx *B — B is a SPOOLES object that holds the matrix B. For an ordinary eigenproblem, │ │ │ │ │ │ - B is the identity and B is NULL. │ │ │ │ │ │ - • int *pseed — *pseed is a random number seed. │ │ │ │ │ │ - • int *pmsglvl—*pmsglvlisamessagelevelforthebridgemethodsandtheSPOOLESmethods │ │ │ │ │ │ - they call. │ │ │ │ │ │ - • FILE *pmsglvl— msgFileis the message file for the bridge methods and the SPOOLES meth- │ │ │ │ │ │ - ods they call. │ │ │ │ │ │ + • void *data — a pointer to the Bridge object. │ │ │ │ │ │ + • int *pprbtype — *pprbtype holds the problem type. │ │ │ │ │ │ + – 1 — vibration, a multiply with B is required. │ │ │ │ │ │ + – 2 — buckling, a multiply with A is required. │ │ │ │ │ │ + – 3 — simple, no multiply is required. │ │ │ │ │ │ + • int *pneqns — *pneqns is the number of equations. │ │ │ │ │ │ + • int *pmxbsz — *pmxbsz is an upper bound on the block size. │ │ │ │ │ │ + • InpMtx *A — A is a SPOOLES object that holds the matrix A. │ │ │ │ │ │ + • InpMtx *B — B is a SPOOLES object that holds the matrix B. For an ordinary eigenproblem, │ │ │ │ │ │ + B is the identity and B is NULL. │ │ │ │ │ │ + • int *pseed — *pseed is a random number seed. │ │ │ │ │ │ + • int *pmsglvl—*pmsglvlisamessagelevelforthebridgemethodsandtheSPOOLESmethods │ │ │ │ │ │ + they call. │ │ │ │ │ │ + • FILE *pmsglvl— msgFileis the message file for the bridge methods and the SPOOLES meth- │ │ │ │ │ │ + ods they call. │ │ │ │ │ │ This method must be called in the driver program prior to invoking the eigensolver via a call to │ │ │ │ │ │ lanczos run(). It then follows this sequence of action. │ │ │ │ │ │ - • Themethodbeginsbycheckingalltheinput data, andsetting the appropriatefields of the Bridge │ │ │ │ │ │ - object. │ │ │ │ │ │ - • The pencil object is initialized with A and B. │ │ │ │ │ │ - • A and B are converted to storage by rows and vector mode. │ │ │ │ │ │ - • A Graph object is created that contains the sparsity pattern of the union of A and B. │ │ │ │ │ │ - • The graph is ordered by first finding a recursive dissection partition, and then evaluating the │ │ │ │ │ │ - orderings produced by nested dissection and multisection, and choosing the better of the two. │ │ │ │ │ │ - The frontETree object is produced and placed into the bridge object. │ │ │ │ │ │ - • Old-to-new and new-to-old permutations are extracted from the front tree and loaded into the │ │ │ │ │ │ - Bridge object. │ │ │ │ │ │ - • The vertices in the front tree are permuted, as well as the entries in A and B. Entries in the lower │ │ │ │ │ │ - triangle of A and B are mapped into the upper triangle, and the storage modes of A and B are │ │ │ │ │ │ - changed to chevrons and vectors, in preparation for the first factorization. │ │ │ │ │ │ - • The symbolic factorization is then computed and loaded in the Bridge object. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 6 │ │ │ │ │ │ + • Themethodbeginsbycheckingalltheinput data, andsetting the appropriatefields of the Bridge │ │ │ │ │ │ + object. │ │ │ │ │ │ + • The pencil object is initialized with A and B. │ │ │ │ │ │ + • A and B are converted to storage by rows and vector mode. │ │ │ │ │ │ + • A Graph object is created that contains the sparsity pattern of the union of A and B. │ │ │ │ │ │ + • The graph is ordered by first finding a recursive dissection partition, and then evaluating the │ │ │ │ │ │ + orderings produced by nested dissection and multisection, and choosing the better of the two. │ │ │ │ │ │ + The frontETree object is produced and placed into the bridge object. │ │ │ │ │ │ + • Old-to-new and new-to-old permutations are extracted from the front tree and loaded into the │ │ │ │ │ │ + Bridge object. │ │ │ │ │ │ + • The vertices in the front tree are permuted, as well as the entries in A and B. Entries in the lower │ │ │ │ │ │ + triangle of A and B are mapped into the upper triangle, and the storage modes of A and B are │ │ │ │ │ │ + changed to chevrons and vectors, in preparation for the first factorization. │ │ │ │ │ │ + • The symbolic factorization is then computed and loaded in the Bridge object. │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 6 │ │ │ │ │ │ • A FrontMtx object is created to hold the factorization and loaded into the Bridge object. │ │ │ │ │ │ • A SubMtxManager object is created to hold the factor’s submatrices and loaded into the Bridge │ │ │ │ │ │ object. │ │ │ │ │ │ • Two DenseMtx objects are created to be used during the matrix multiplies and solves. │ │ │ │ │ │ The A and B matrices are now in their permuted ordering, i.e., PAPT and PBPT, and all data struc- │ │ │ │ │ │ tures are with respect to this ordering. After the Lanczos run completes, any generated eigenvectors │ │ │ │ │ │ must be permuted back into their original ordering using the oldToNewIV and newToOldIV objects. │ │ │ │ │ │ @@ -173,15 +173,15 @@ │ │ │ │ │ │ • double X[] — this is the X matrix, stored column major with leading dimension *pnrows. │ │ │ │ │ │ • double Y[] — this is the Y matrix, stored column major with leading dimension *pnrows. │ │ │ │ │ │ • int *pprbtype — *pprbtype holds the problem type. │ │ │ │ │ │ – 1 — vibration, a multiply with B is required. │ │ │ │ │ │ – 2 — buckling, a multiply with A is required. │ │ │ │ │ │ – 3 — simple, no multiply is required. │ │ │ │ │ │ • void *data — a pointer to the Bridge object. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 7 │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 7 │ │ │ │ │ │ 4. void Solve ( int *pnrows, int *pncols, double X[], double Y[], │ │ │ │ │ │ void *data, int *perror ) ; │ │ │ │ │ │ This method solves (A−σB)X = Y, where (A−σB) has been factored by a previous call to Factor(). │ │ │ │ │ │ All calling sequence parameters are pointers to more easily allow an interface with Fortran. │ │ │ │ │ │ • int *pnrows — *pnrows contains the number of rows in X and Y. │ │ │ │ │ │ • int *pncols — *pncols contains the number of columns in X and Y. │ │ │ │ │ │ • double X[] — this is the X matrix, stored column major with leading dimension *pnrows. │ │ │ │ │ │ @@ -207,15 +207,15 @@ │ │ │ │ │ │ • inFileB is the Harwell-Boeing file for the matrix B. │ │ │ │ │ │ This program is executed for some sample matrices by the do ST * shell scripts in the drivers directory. │ │ │ │ │ │ Here is a short description of the steps in the driver program. See Chapter A for the listing. │ │ │ │ │ │ 1. The command line inputs are decoded. │ │ │ │ │ │ 2. The header of the Harwell-Boeing file for A is read. This yields the number of equations. │ │ │ │ │ │ 3. The parameters that define the eigensystem to be solved are read in from the parmFile file. │ │ │ │ │ │ 4. The Lanczos eigensolver workspace is initialized. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 8 │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 8 │ │ │ │ │ │ 5. The Lanczos communication structure is filled with some parameters. │ │ │ │ │ │ 6. The A and possibly B matrices are read in from the Harwell-Boeing files and converted into InpMtx │ │ │ │ │ │ objects from the SPOOLES library. │ │ │ │ │ │ 7. The linear solver environment is then initialized via a call to Setup(). │ │ │ │ │ │ 8. The eigensolver is invoked via a call to lanczos run(). The FactorMT(), SolveMT() and MatMulMT() │ │ │ │ │ │ methods are passed to this routine. │ │ │ │ │ │ 9. The eigenvalues are extracted and printed via a call to lanczos eigenvalues(). │ │ │ │ │ │ @@ -243,15 +243,15 @@ │ │ │ │ │ │ where it is contained. │ │ │ │ │ │ • IVL *symbfacIVL : object that contains the symbolic factorization of the matrix. │ │ │ │ │ │ • SubMtxManager *mtxmanager : object that manages the SubMtx objects that store the factor entries │ │ │ │ │ │ and are used in the solves. │ │ │ │ │ │ • FrontMtx *frontmtx : object that stores the L, D and U factor matrices. │ │ │ │ │ │ • IV *oldToNewIV : object that stores old-to-new permutation vector. │ │ │ │ │ │ 9 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 10 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 10 │ │ │ │ │ │ • IV *newToOldIV : object that stores new-to-old permutation vector. │ │ │ │ │ │ • DenseMtx *X : dense matrix object that is used during the matrix multiples and solves. │ │ │ │ │ │ • DenseMtx *Y : dense matrix object that is used during the matrix multiples and solves. │ │ │ │ │ │ • IV *ownersIV : object that maps fronts to owning threads for the factorization and matrix-multiplies. │ │ │ │ │ │ • SolveMap *solvemap : object that maps factor submatrices to owning threads for the solve. │ │ │ │ │ │ • int msglvl : message level for output. When 0, no output, When 1, just statistics and cpu times. │ │ │ │ │ │ When greater than 1, more and more output. │ │ │ │ │ │ @@ -281,15 +281,15 @@ │ │ │ │ │ │ • FILE *pmsglvl— msgFileis the message file for the bridge methods and the SPOOLES meth- │ │ │ │ │ │ ods they call. │ │ │ │ │ │ This method must be called in the driver program prior to invoking the eigensolver via a call to │ │ │ │ │ │ lanczos run(). It then follows this sequence of action. │ │ │ │ │ │ • The method begins by checking all the input data, and setting the appropriate fields of the │ │ │ │ │ │ BridgeMT object. │ │ │ │ │ │ • The pencil object is initialized with A and B. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 11 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 11 │ │ │ │ │ │ • A and B are converted to storage by rows and vector mode. │ │ │ │ │ │ • A Graph object is created that contains the sparsity pattern of the union of A and B. │ │ │ │ │ │ • The graph is ordered by first finding a recursive dissection partition, and then evaluating the │ │ │ │ │ │ orderings produced by nested dissection and multisection, and choosing the better of the two. │ │ │ │ │ │ The frontETree object is produced and placed into the bridge object. │ │ │ │ │ │ • Old-to-new and new-to-old permutations are extracted from the front tree and loaded into the │ │ │ │ │ │ BridgeMT object. │ │ │ │ │ │ @@ -326,15 +326,15 @@ │ │ │ │ │ │ by 1/(∗ppvttol). │ │ │ │ │ │ • void *data — a pointer to the BridgeMT object. │ │ │ │ │ │ • int *pinertia — on return, *pinertia holds the number of negative eigenvalues. │ │ │ │ │ │ • int *perror — on return, *perror holds an error code. │ │ │ │ │ │ 1 error in the factorization -2 ppvttol is NULL │ │ │ │ │ │ 0 normal return -3 data is NULL │ │ │ │ │ │ -1 psigma is NULL -4 pinertia is NULL │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 12 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 12 │ │ │ │ │ │ 3. void MatMulMT ( int *pnrows, int *pncols, double X[], double Y[], │ │ │ │ │ │ int *pprbtype, void *data ) ; │ │ │ │ │ │ This method computes a multiply of the form Y = IX, Y = AX or Y = BX. All calling sequence │ │ │ │ │ │ parameters are pointers to more easily allow an interface with Fortran. │ │ │ │ │ │ • int *pnrows — *pnrows contains the number of rows in X and Y. │ │ │ │ │ │ • int *pncols — *pncols contains the number of columns in X and Y. │ │ │ │ │ │ • double X[] — this is the X matrix, stored column major with leading dimension *pnrows. │ │ │ │ │ │ @@ -363,15 +363,15 @@ │ │ │ │ │ │ 3.3 The testMT Driver Program │ │ │ │ │ │ A complete listing of the multithreaded driver program is found in chapter B. The program is invoked by │ │ │ │ │ │ this command sequence. │ │ │ │ │ │ testMT msglvl msgFile parmFile seed nthread inFileA inFileB │ │ │ │ │ │ where │ │ │ │ │ │ • msglvl is the message level for the BridgeMT methods and the SPOOLES software. │ │ │ │ │ │ • msgFile is the message file for the BridgeMT methods and the SPOOLES software. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 13 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 13 │ │ │ │ │ │ • parmFile is the input file for the parameters of the eigensystem to be solved. │ │ │ │ │ │ • seed is a random number seed used by the SPOOLES software. │ │ │ │ │ │ • nthread is the number of threads to use in the factors, solves and matrix-multiplies. │ │ │ │ │ │ • inFileA is the Harwell-Boeing file for the matrix A. │ │ │ │ │ │ • inFileB is the Harwell-Boeing file for the matrix B. │ │ │ │ │ │ This program is executed for some sample matrices by the do ST * shell scripts in the drivers directory. │ │ │ │ │ │ Here is a short description of the steps in the driver program. See Chapter A for the listing. │ │ │ │ │ │ @@ -411,15 +411,15 @@ │ │ │ │ │ │ • ETree *frontETree : object that defines the factorizations, e.g., the number of fronts, the tree they │ │ │ │ │ │ form, the number of internal and external rows for each front, and the map from vertices to the front │ │ │ │ │ │ where it is contained. │ │ │ │ │ │ • IVL *symbfacIVL : object that contains the symbolic factorization of the matrix. │ │ │ │ │ │ • SubMtxManager *mtxmanager : object that manages the SubMtx objects that store the factor entries │ │ │ │ │ │ and are used in the solves. │ │ │ │ │ │ 14 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 15 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 15 │ │ │ │ │ │ • FrontMtx *frontmtx : object that stores the L, D and U factor matrices. │ │ │ │ │ │ • IV *oldToNewIV : object that stores old-to-new permutation vector. │ │ │ │ │ │ • IV *newToOldIV : object that stores new-to-old permutation vector. │ │ │ │ │ │ • DenseMtx *Xloc : dense local matrix object that is used during the matrix multiples and solves. │ │ │ │ │ │ • DenseMtx *Yloc : dense local matrix object that is used during the matrix multiples and solves. │ │ │ │ │ │ • IV *vtxmapIV : object that maps vertices to owning processors for the factorization and matrix- │ │ │ │ │ │ multiplies. │ │ │ │ │ │ @@ -450,15 +450,15 @@ │ │ │ │ │ │ inside the LANCZOS software a global Krylov block is assembled on each processor prior to calling the │ │ │ │ │ │ solve or matrix-multiply methods. To “translate” between the global blocks to local blocks, and then back │ │ │ │ │ │ to global blocks, we have written two wrapper methods, JimMatMulMPI() and JimSolveMPI(). Each takes │ │ │ │ │ │ the global input block, compresses it into a local block, call the bridge matrix-multiply or solve method, │ │ │ │ │ │ then takes the local output blocks and gathers them on all the processors into each of their global output │ │ │ │ │ │ blocks. These operations add a considerable cost to the solve and matrix-multiplies, but the next release of │ │ │ │ │ │ the LANCZOS software will remove these steps. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 16 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 16 │ │ │ │ │ │ 1. int SetupMPI ( void *data, int *pprbtype, int *pneqns, │ │ │ │ │ │ int *pmxbsz, InpMtx *A, InpMtx *B, int *pseed, │ │ │ │ │ │ int *pmsglvl, FILE *msgFile, MPI_Comm comm ) ; │ │ │ │ │ │ All calling sequence parameters are pointers to more easily allow an interface with Fortran. │ │ │ │ │ │ • void *data — a pointer to the BridgeMPI object. │ │ │ │ │ │ • int *pprbtype — *pprbtype holds the problem type. │ │ │ │ │ │ – 1 — vibration, a multiply with B is required. │ │ │ │ │ │ @@ -493,15 +493,15 @@ │ │ │ │ │ │ • The ownersIV, vtxmapIV and myownedIV objects are created, that map fronts and vertices to │ │ │ │ │ │ processors. │ │ │ │ │ │ • The entries in A and B are permuted. Entries in the permuted lower triangle are mapped into │ │ │ │ │ │ the upper triangle. The storage modes of A and B are changed to chevrons and vectors, and the │ │ │ │ │ │ entries of A and B are redistributed to the processors that own them. │ │ │ │ │ │ • The symbolic factorization is then computed and loaded in the BridgeMPI object. │ │ │ │ │ │ • A FrontMtx object is created to hold the factorization and loaded into the BridgeMPI object. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 17 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 17 │ │ │ │ │ │ • ASubMtxManagerobjectiscreatedtoholdthefactor’ssubmatricesandloadedintotheBridgeMPI │ │ │ │ │ │ object. │ │ │ │ │ │ • Themapfromfactorsubmatricestotheir owningthreadsis computed and stored in the solvemap │ │ │ │ │ │ object. │ │ │ │ │ │ • The distributed matrix-multiplies are set up. │ │ │ │ │ │ The A and B matrices are now in their permuted ordering, i.e., PAPT and PBPT, and all data struc- │ │ │ │ │ │ tures are with respect to this ordering. After the Lanczos run completes, any generated eigenvectors │ │ │ │ │ │ @@ -536,15 +536,15 @@ │ │ │ │ │ │ • int *pnrows — *pnrows contains the number of global rows in X and Y. │ │ │ │ │ │ • int *pncols — *pncols contains the number of global columns in X and Y. │ │ │ │ │ │ • double X[] — this is the global X matrix, stored column major with leading dimension *pnrows. │ │ │ │ │ │ • double Y[] — this is the global Y matrix, stored column major with leading dimension *pnrows. │ │ │ │ │ │ • int *pprbtype — *pprbtype holds the problem type. │ │ │ │ │ │ – 1 — vibration, a multiply with B is required. │ │ │ │ │ │ – 2 — buckling, a multiply with A is required. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 18 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 18 │ │ │ │ │ │ – 3 — simple, no multiply is required. │ │ │ │ │ │ • void *data — a pointer to the BridgeMPI object. │ │ │ │ │ │ 4. void MatMulMPI ( int *pnrows, int *pncols, double X[], double Y[], │ │ │ │ │ │ int *pprbtype, void *data ) ; │ │ │ │ │ │ This method computes a multiply of the form Y = IX, Y = AX or Y = BX. All calling sequence │ │ │ │ │ │ parameters are pointers to more easily allow an interface with Fortran. │ │ │ │ │ │ • int *pnrows — *pnrows contains the number of local rows in X and Y. │ │ │ │ │ │ @@ -578,15 +578,15 @@ │ │ │ │ │ │ • double X[] — this is the local X matrix, stored column major with leading dimension *pnrows. │ │ │ │ │ │ • double Y[] — this is the local Y matrix, stored column major with leading dimension *pnrows. │ │ │ │ │ │ • void *data — a pointer to the BridgeMPI object. │ │ │ │ │ │ • int *perror — on return, *perror holds an error code. │ │ │ │ │ │ 1 normal return -3 X is NULL │ │ │ │ │ │ -1 pnrows is NULL -4 Y is NULL │ │ │ │ │ │ -2 pncols is NULL -5 data is NULL │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 19 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 19 │ │ │ │ │ │ 7. int CleanupMPI ( void *data ) ; │ │ │ │ │ │ This method releases all the storage used by the SPOOLES library functions. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if a data is NULL. │ │ │ │ │ │ 4.3 The testMPI Driver Program │ │ │ │ │ │ A complete listing of the multithreaded driver program is found in chapter C. The program is invoked by │ │ │ │ │ │ this command sequence. │ │ │ │ │ │ testMPI msglvl msgFile parmFile seed inFileA inFileB │ │ │ │ │ │ @@ -644,15 +644,15 @@ │ │ │ │ │ │ double eigval[1000], sigma[2]; │ │ │ │ │ │ double *evec; │ │ │ │ │ │ int error, fstevl, lfinit, lstevl, mxbksz, msglvl, ncol, ndiscd, │ │ │ │ │ │ neig, neigvl, nfound, nnonzeros, nrhs, nrow, prbtyp, rc, │ │ │ │ │ │ retc, rfinit, seed, warnng ; │ │ │ │ │ │ int c__5 = 5, output = 6 ; │ │ │ │ │ │ 20 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 21 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 21 │ │ │ │ │ │ int *lanczos_wksp; │ │ │ │ │ │ InpMtx *inpmtxA, *inpmtxB ; │ │ │ │ │ │ FILE *msgFile, *parmFile; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ if ( argc != 7 ) { │ │ │ │ │ │ fprintf(stdout, │ │ │ │ │ │ "\n\n usage : %s msglvl msgFile parmFile seed inFileA inFileB" │ │ │ │ │ │ @@ -694,15 +694,15 @@ │ │ │ │ │ │ /* │ │ │ │ │ │ --------------------------------------------- │ │ │ │ │ │ read in the Harwell-Boeing matrix information │ │ │ │ │ │ --------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ if ( strcmp(inFileName_A, "none") == 0 ) { │ │ │ │ │ │ fprintf(msgFile, "\n no file to read from") ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 22 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 22 │ │ │ │ │ │ exit(0) ; │ │ │ │ │ │ } │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ readHB_info (inFileName_A, &nrow, &ncol, &nnonzeros, &type, &nrhs) ; │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : read in header information for A", │ │ │ │ │ │ t2 - t1) ; │ │ │ │ │ │ @@ -746,15 +746,15 @@ │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : read in eigenvalue problem data", │ │ │ │ │ │ t2 - t1) ; │ │ │ │ │ │ /* │ │ │ │ │ │ ---------------------------------------- │ │ │ │ │ │ check and set the problem type parameter │ │ │ │ │ │ ---------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 23 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 23 │ │ │ │ │ │ switch ( pbtype[1] ) { │ │ │ │ │ │ case ’v’ : case ’V’ : prbtyp = 1 ; break ; │ │ │ │ │ │ case ’b’ : case ’B’ : prbtyp = 2 ; break ; │ │ │ │ │ │ case ’o’ : case ’O’ : prbtyp = 3 ; break ; │ │ │ │ │ │ default : │ │ │ │ │ │ fprintf(stderr, "\n invalid problem type %s", pbtype) ; │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ @@ -798,15 +798,15 @@ │ │ │ │ │ │ InpMtx_readFromHBfile ( inpmtxA, inFileName_A ) ; │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : read in A", t2 - t1) ; │ │ │ │ │ │ if ( msglvl > 2 ) { │ │ │ │ │ │ fprintf(msgFile, "\n\n InpMtx A object after loading") ; │ │ │ │ │ │ InpMtx_writeForHumanEye(inpmtxA, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 24 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 24 │ │ │ │ │ │ } │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "matrix-type", &c__1, &retc ); │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : set A’s parameters", t2 - t1) ; │ │ │ │ │ │ if ( prbtyp != 3 ) { │ │ │ │ │ │ if ( strcmp(inFileName_B, "none") == 0 ) { │ │ │ │ │ │ @@ -850,15 +850,15 @@ │ │ │ │ │ │ invoke eigensolver │ │ │ │ │ │ nfound -- # of eigenvalues found and kept │ │ │ │ │ │ ndisc -- # of additional eigenvalues discarded │ │ │ │ │ │ ----------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ lanczos_run(&neigvl, &which[1] , &pbtype[1], &lfinit, &lftend, │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 25 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 25 │ │ │ │ │ │ &rfinit, &rhtend, ¢er, &lanczos_wksp, &bridge, &nfound, │ │ │ │ │ │ &ndiscd, &warnng, &error, Factor, MatMul, Solve ) ; │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : time for lanczos run", t2 - t1) ; │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------- │ │ │ │ │ │ get eigenvalues and print │ │ │ │ │ │ @@ -901,15 +901,15 @@ │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ lanczos_free( &lanczos_wksp ) ; │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : free lanczos workspace ", t2 - t1) ; │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ rc = Cleanup(&bridge) ; │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 26 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 26 │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : free solver workspace ", t2 - t1) ; │ │ │ │ │ │ if ( rc != 1 ) { │ │ │ │ │ │ fprintf(stderr, "\n error return %d from Cleanup()", rc) ; │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ fprintf(msgFile, "\n") ; │ │ │ │ │ │ fclose(msgFile) ; │ │ │ │ │ │ @@ -942,15 +942,15 @@ │ │ │ │ │ │ double *evec; │ │ │ │ │ │ int error, fstevl, lfinit, lstevl, msglvl, mxbksz, ncol, ndiscd, │ │ │ │ │ │ neig, neigvl, nfound, nnonzeros, nrhs, nrow, nthreads, │ │ │ │ │ │ prbtyp, rc, retc, rfinit, seed, warnng ; │ │ │ │ │ │ int c__5 = 5, output = 6 ; │ │ │ │ │ │ int *lanczos_wksp; │ │ │ │ │ │ 27 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 28 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 28 │ │ │ │ │ │ InpMtx *inpmtxA, *inpmtxB ; │ │ │ │ │ │ FILE *msgFile, *parmFile ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ if ( argc != 8 ) { │ │ │ │ │ │ fprintf(stdout, │ │ │ │ │ │ "\n\n usage : %s msglvl msgFile parmFile seed nthread inFileA inFileB" │ │ │ │ │ │ "\n msglvl -- message level" │ │ │ │ │ │ @@ -994,15 +994,15 @@ │ │ │ │ │ │ --------------------------------------------- │ │ │ │ │ │ read in the Harwell-Boeing matrix information │ │ │ │ │ │ --------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ if ( strcmp(inFileName_A, "none") == 0 ) { │ │ │ │ │ │ fprintf(msgFile, "\n no file to read from") ; │ │ │ │ │ │ exit(0) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 29 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 29 │ │ │ │ │ │ } │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ readHB_info (inFileName_A, &nrow, &ncol, &nnonzeros, &type, &nrhs) ; │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : read in harwell-boeing header info", │ │ │ │ │ │ t2 - t1) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ @@ -1046,15 +1046,15 @@ │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : read in eigenvalue problem data", │ │ │ │ │ │ t2 - t1) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ /* │ │ │ │ │ │ ---------------------------------------- │ │ │ │ │ │ check and set the problem type parameter │ │ │ │ │ │ ---------------------------------------- │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 30 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 30 │ │ │ │ │ │ */ │ │ │ │ │ │ switch ( pbtype[1] ) { │ │ │ │ │ │ case ’v’ : │ │ │ │ │ │ case ’V’ : │ │ │ │ │ │ prbtyp = 1 ; │ │ │ │ │ │ break ; │ │ │ │ │ │ case ’b’ : │ │ │ │ │ │ @@ -1098,15 +1098,15 @@ │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ --------------------------------------------- │ │ │ │ │ │ create the InpMtx objects for matrix A and B │ │ │ │ │ │ --------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ if ( strcmp(inFileName_A, "none") == 0 ) { │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 31 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 31 │ │ │ │ │ │ fprintf(msgFile, "\n no file to read A from") ; │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ inpmtxA = InpMtx_new() ; │ │ │ │ │ │ InpMtx_readFromHBfile ( inpmtxA, inFileName_A ) ; │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ @@ -1150,15 +1150,15 @@ │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : set up the solver environment", │ │ │ │ │ │ t2 - t1) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ if ( rc != 1 ) { │ │ │ │ │ │ fprintf(stderr, "\n error return %d from SetupMT()", rc) ; │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 32 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 32 │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ----------------------------------------------- │ │ │ │ │ │ invoke eigensolver │ │ │ │ │ │ nfound -- # of eigenvalues found and kept │ │ │ │ │ │ ndisc -- # of additional eigenvalues discarded │ │ │ │ │ │ ----------------------------------------------- │ │ │ │ │ │ @@ -1202,15 +1202,15 @@ │ │ │ │ │ │ hdslp5_ ( "computed eigenvector returned by hdserc", │ │ │ │ │ │ &neig, evec, &output, 39L ) ; │ │ │ │ │ │ } │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : get and print eigenvectors", t2 - t1) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ */ │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 33 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 33 │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------ │ │ │ │ │ │ free the working storage │ │ │ │ │ │ ------------------------ │ │ │ │ │ │ */ │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ lanczos_free( &lanczos_wksp ) ; │ │ │ │ │ │ @@ -1254,15 +1254,15 @@ │ │ │ │ │ │ InpMtx *inpmtxA, *inpmtxB ; │ │ │ │ │ │ FILE *msgFile, *parmFile ; │ │ │ │ │ │ double lftend, rhtend, center, shfscl, t1, t2 ; │ │ │ │ │ │ double c__1 = 1.0, c__4 = 4.0, tolact = 2.309970868130169e-11 ; │ │ │ │ │ │ double eigval[1000], sigma[2] ; │ │ │ │ │ │ double *evec; │ │ │ │ │ │ 34 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 35 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 35 │ │ │ │ │ │ /* │ │ │ │ │ │ --------------------------------------------------------------- │ │ │ │ │ │ find out the identity of this process and the number of process │ │ │ │ │ │ --------------------------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ MPI_Init(&argc, &argv) ; │ │ │ │ │ │ MPI_Comm_dup(MPI_COMM_WORLD, &comm) ; │ │ │ │ │ │ @@ -1306,15 +1306,15 @@ │ │ │ │ │ │ } │ │ │ │ │ │ parmFileName = argv[3] ; │ │ │ │ │ │ seed = atoi(argv[4]) ; │ │ │ │ │ │ inFileName_A = argv[5] ; │ │ │ │ │ │ inFileName_B = argv[6] ; │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ "\n %s " │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 36 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 36 │ │ │ │ │ │ "\n msglvl -- %d" │ │ │ │ │ │ "\n message file -- %s" │ │ │ │ │ │ "\n parameter file -- %s" │ │ │ │ │ │ "\n stiffness matrix file -- %s" │ │ │ │ │ │ "\n mass matrix file -- %s" │ │ │ │ │ │ "\n random number seed -- %d" │ │ │ │ │ │ "\n", │ │ │ │ │ │ @@ -1358,15 +1358,15 @@ │ │ │ │ │ │ with K positive semidefinite │ │ │ │ │ │ with K_s posibly indefinite (buckling problem) │ │ │ │ │ │ ’o’ or ’O’ ordinary symmetric eigenproblem │ │ │ │ │ │ lfinit -- if true, lftend is restriction on lower bound of │ │ │ │ │ │ eigenvalues. if false, no restriction on lower bound │ │ │ │ │ │ lftend -- left endpoint of interval │ │ │ │ │ │ rfinit -- if true, rhtend is restriction on upper bound of │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 37 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 37 │ │ │ │ │ │ eigenvalues. if false, no restriction on upper bound │ │ │ │ │ │ rhtend -- right endpoint of interval │ │ │ │ │ │ center -- center of interval │ │ │ │ │ │ mxbksz -- upper bound on block size for Lanczos recurrence │ │ │ │ │ │ shfscl -- shift scaling parameter, an estimate on the magnitude │ │ │ │ │ │ of the smallest nonzero eigenvalues │ │ │ │ │ │ --------------------------------------------------------------- │ │ │ │ │ │ @@ -1410,15 +1410,15 @@ │ │ │ │ │ │ initialize communication structure │ │ │ │ │ │ ---------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "order-of-problem", &nrow, &retc ); │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "accuracy-tolerance", &tolact, &retc ); │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "max-block-size", &mxbksz, &retc ); │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 38 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 38 │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "shift-scale", &shfscl, &retc ); │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "message_level", &msglvl, &retc ); │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "mpi-communicator", &comm, &retc ); │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "qfile-pathname", "lqfil", &retc ); │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "mqfil-pathname", "lmqfil", &retc ); │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "evfil-pathname", "evcfil", &retc ); │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ @@ -1462,15 +1462,15 @@ │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ } else { │ │ │ │ │ │ inpmtxB = NULL ; │ │ │ │ │ │ lanczos_set_parm( &lanczos_wksp, "matrix-type", &c__4, &retc ); │ │ │ │ │ │ } │ │ │ │ │ │ } else { │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 39 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 39 │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------------------------------ │ │ │ │ │ │ other processors initialize their local matrices │ │ │ │ │ │ ------------------------------------------------ │ │ │ │ │ │ */ │ │ │ │ │ │ inpmtxA = InpMtx_new() ; │ │ │ │ │ │ InpMtx_init(inpmtxA, INPMTX_BY_CHEVRONS, SPOOLES_REAL, 0, 0) ; │ │ │ │ │ │ @@ -1514,15 +1514,15 @@ │ │ │ │ │ │ JimSolveMPI ) ; │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : time for lanczos run", t2 - t1) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ if ( myid == 0 ) { │ │ │ │ │ │ /* │ │ │ │ │ │ ---------------------------------------------- │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 40 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 40 │ │ │ │ │ │ processor 0 deals with eigenvalues and vectors │ │ │ │ │ │ ---------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ neig = nfound + ndiscd ; │ │ │ │ │ │ lstevl = nfound ; │ │ │ │ │ │ lanczos_eigenvalues (&lanczos_wksp, eigval, &neig, &retc); │ │ │ │ │ │ @@ -1566,15 +1566,15 @@ │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : free lanczos workspace", t2 - t1) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ MARKTIME(t1) ; │ │ │ │ │ │ CleanupMPI(&bridge) ; │ │ │ │ │ │ MARKTIME(t2) ; │ │ │ │ │ │ fprintf(msgFile, "\n CPU %8.3f : free solver workspace", t2 - t1) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 41 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 41 │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ MPI_Finalize() ; │ │ │ │ │ │ fprintf(msgFile, "\n") ; │ │ │ │ │ │ fclose(msgFile) ; │ │ │ │ │ │ return ; } │ │ │ │ │ │ Index │ │ │ │ │ │ Cleanup(), 7 │ │ │ ├── ./usr/share/doc/spooles-doc/FrontMtx.ps.gz │ │ │ │ ├── FrontMtx.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o FrontMtx.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1759,21 +1759,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1957,88 +1956,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5005,18 +4999,18 @@ │ │ │ │ │ 62 50 1[54 11[86 1[62 84 84 77 84 5[42 2[70 3[80 8[56 │ │ │ │ │ 56 56 56 56 56 56 56 56 56 1[31 46[{}40 99.6264 /CMBX12 │ │ │ │ │ rf /Fc 135[62 3[62 1[62 2[62 62 32[62 6[62 1[62 68[{}8 │ │ │ │ │ 119.552 /CMTT12 rf /Fd 134[71 2[71 75 52 53 55 1[75 67 │ │ │ │ │ 75 112 2[41 37 75 67 41 61 75 60 75 65 13[75 2[92 11[103 │ │ │ │ │ 16[67 67 67 2[37 46[{}27 119.552 /CMBX12 rf /Fe 132[52 │ │ │ │ │ 39[58 2[71 79 2[63 6[69 69[{}6 90.9091 /CMBX10 rf /Ff │ │ │ │ │ -134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 │ │ │ │ │ -2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf /Fg 148[45 │ │ │ │ │ -3[45 45 9[61 61 31[45 4[0 51[71 1[71{}9 90.9091 /CMSY10 │ │ │ │ │ -rf /Fh 135[42 1[42 49 30 37 38 1[46 46 51 74 23 42 1[28 │ │ │ │ │ +134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 1[45 │ │ │ │ │ +1[45 3[25 44[{}12 90.9091 /CMSL10 rf /Fg 148[45 3[45 │ │ │ │ │ +45 9[61 61 31[45 4[0 51[71 1[71{}9 90.9091 /CMSY10 rf │ │ │ │ │ +/Fh 135[42 1[42 49 30 37 38 1[46 46 51 74 23 42 1[28 │ │ │ │ │ 46 42 28 42 46 42 1[46 12[65 1[66 11[59 62 69 2[68 6[28 │ │ │ │ │ 58[{}27 90.9091 /CMTI10 rf │ │ │ │ │ %DVIPSBitmapFont: Fi tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ @@ -5150,23 +5144,23 @@ │ │ │ │ │ Fk(P)43 b Fm(and)30 b Fk(Q)g Fm(are)h(the)f(iden)m(tit)m(y)-8 │ │ │ │ │ b(.)111 5294 y(3.)46 b Fk(A)k Fm(=)e Fk(QR)e Fm(for)e(square)g(or)h │ │ │ │ │ (rectangular)h Fk(A)p Fm(.)84 b Fk(Q)44 b Fm(is)h(an)f(orthogonal)i │ │ │ │ │ (matrix)f(that)h(is)e(not)h(explicitly)227 5407 y(computed)30 │ │ │ │ │ b(or)h(stored.)41 b Fk(R)31 b Fm(is)f(upp)s(er)e(triangular.)1927 │ │ │ │ │ 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fm(2)p 136 100 1038 4 v │ │ │ │ │ -1220 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2862 100 V 141 399 a Fm(The)44 │ │ │ │ │ -b(factorization)j(is)d(p)s(erformed)f(using)h(a)g(one)h(dimensional)f │ │ │ │ │ -(decomp)s(osition)h(of)f(the)h(global)g(sparse)0 511 │ │ │ │ │ -y(matrix.)c(A)31 b(t)m(ypical)h Fh(fr)-5 b(ont)31 b Fm(of)g(the)f │ │ │ │ │ -(matrix)h(is)f(found)f(the)i(shaded)f(p)s(ortion)g(of)g(the)h(\014gure) │ │ │ │ │ -e(b)s(elo)m(w.)1650 1237 y @beginspecial 0 @llx 0 @lly │ │ │ │ │ -100 @urx 100 @ury 720 @rwi 720 @rhi @setspecial │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 136 100 1057 4 v │ │ │ │ │ +1239 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2843 100 V 141 399 a Fm(The)44 b(factorization)j(is)d(p)s │ │ │ │ │ +(erformed)f(using)h(a)g(one)h(dimensional)f(decomp)s(osition)h(of)f │ │ │ │ │ +(the)h(global)g(sparse)0 511 y(matrix.)c(A)31 b(t)m(ypical)h │ │ │ │ │ +Fh(fr)-5 b(ont)31 b Fm(of)g(the)f(matrix)h(is)f(found)f(the)i(shaded)f │ │ │ │ │ +(p)s(ortion)g(of)g(the)h(\014gure)e(b)s(elo)m(w.)1650 │ │ │ │ │ +1237 y @beginspecial 0 @llx 0 @lly 100 @urx 100 @ury │ │ │ │ │ +720 @rwi 720 @rhi @setspecial │ │ │ │ │ %%BeginDocument: ../../FrontMtx/doc/simple.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0.0 0.0 100.0 100.0 │ │ │ │ │ %%%EndComments │ │ │ │ │ │ │ │ │ │ 0.5 setgray │ │ │ │ │ 25 0 75 75 rectfill │ │ │ │ │ @@ -5244,17 +5238,17 @@ │ │ │ │ │ b(ject,)36 b(but)d(it)i(do)s(es)f(not)g(mo)s(dify)f(the)h(ob)5 │ │ │ │ │ b(ject,)37 b(nor)c(do)s(es)h(it)g(o)m(wn)g(the)h(storage)g(for)f(the)g │ │ │ │ │ Fl(ETree)227 5407 y Fm(ob)5 b(ject.)42 b(Th)m(us)29 b(m)m(ultiple)i │ │ │ │ │ (fron)m(t)g(matrices)g(can)g(all)g(p)s(oin)m(t)f(to)i(the)e(same)h │ │ │ │ │ Fl(ETree)e Fm(ob)5 b(ject)31 b(sim)m(ultaneously)-8 b(.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1038 4 v 1220 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2815 100 V 1038 w Fm(3)137 399 y Fi(\210)45 b Fm(An)35 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1057 4 v 1239 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2796 100 V 1057 w Fm(3)137 399 y Fi(\210)45 b Fm(An)35 │ │ │ │ │ b Fl(IVL)g Fm(ob)5 b(ject)36 b(\()p Fl(I)p Fm(n)m(teger)g │ │ │ │ │ Fl(V)p Fm(ector)h Fl(L)p Fm(ist\),)g(con)m(tains)f(the)g(sym)m(b)s │ │ │ │ │ (olic)g(factorization.)58 b(F)-8 b(or)36 b(eac)m(h)g(fron)m(t,)h(it)227 │ │ │ │ │ 511 y(giv)m(es)31 b(the)g(list)f(of)g(in)m(ternal)h(and)e(external)i │ │ │ │ │ (ro)m(ws)f(and)f(columns,)h(used)f(to)h(initialize)j(a)d(fron)m(t)g │ │ │ │ │ (prior)f(to)i(its)227 624 y(factorization.)55 b(F)-8 │ │ │ │ │ b(or)35 b(a)f(factorization)j(without)d(piv)m(oting,)j(this)d(ob)5 │ │ │ │ │ @@ -5338,21 +5332,21 @@ │ │ │ │ │ b(After)26 b(the)f(factorization)227 5181 y(is)45 b(complete,)50 │ │ │ │ │ b(the)45 b(data)h(structures)e(are)i(p)s(ostpro)s(cessed)e(to)h(yield)g │ │ │ │ │ (submatrices)g(that)h(con)m(tain)g(the)227 5294 y(coupling)34 │ │ │ │ │ b(b)s(et)m(w)m(een)g(fron)m(ts.)50 b(The)33 b(w)m(orking)h(storage)h │ │ │ │ │ (during)d(the)i(solv)m(es)g(is)g(also)g(managed)g(b)m(y)g │ │ │ │ │ Fl(SubMtx)227 5407 y Fm(ob)5 b(jects.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fm(4)p 136 100 1038 4 v │ │ │ │ │ -1220 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2862 100 V 137 399 a Fi(\210)45 │ │ │ │ │ -b Fm(Eac)m(h)25 b(submatrix)f(represen)m(ts)h(the)f(coupling)h(b)s(et)m │ │ │ │ │ -(w)m(een)g(t)m(w)m(o)h(fron)m(ts,)g Fk(I)31 b Fm(and)24 │ │ │ │ │ -b Fk(J)9 b Fm(.)39 b(T)-8 b(o)25 b(enable)g(rapid)f(random)227 │ │ │ │ │ -511 y(access)30 b(to)f(these)f(submatrices,)h(w)m(e)f(use)g(a)h │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 136 100 1057 4 v │ │ │ │ │ +1239 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2843 100 V 137 399 a Fi(\210)45 b Fm(Eac)m(h)25 │ │ │ │ │ +b(submatrix)f(represen)m(ts)h(the)f(coupling)h(b)s(et)m(w)m(een)g(t)m │ │ │ │ │ +(w)m(o)h(fron)m(ts,)g Fk(I)31 b Fm(and)24 b Fk(J)9 b │ │ │ │ │ +Fm(.)39 b(T)-8 b(o)25 b(enable)g(rapid)f(random)227 511 │ │ │ │ │ +y(access)30 b(to)f(these)f(submatrices,)h(w)m(e)f(use)g(a)h │ │ │ │ │ Fl(I2Ohash)d Fm(ob)5 b(ject)29 b(that)f(is)h(a)f(hash)f(table)i(whose)f │ │ │ │ │ (k)m(eys)h(are)g(t)m(w)m(o)227 624 y(in)m(tegers)j(and)e(whose)g(data)h │ │ │ │ │ (is)f(a)h Fl(void)47 b(*)30 b Fm(p)s(oin)m(ter.)137 808 │ │ │ │ │ y Fi(\210)45 b Fm(The)39 b(set)h(of)g(nonzero)f(submatrices,)j(i.e.,)h │ │ │ │ │ (the)d(nonzero)g(couplings)f(b)s(et)m(w)m(een)h(t)m(w)m(o)h(fron)m(ts,) │ │ │ │ │ h(is)d(k)m(ept)h(in)227 920 y(one)33 b(or)f(t)m(w)m(o)h │ │ │ │ │ Fl(IVL)e Fm(ob)5 b(jects.)47 b(This)31 b(information)i(is)f(necessary)h │ │ │ │ │ @@ -5410,17 +5404,17 @@ │ │ │ │ │ (sparsityflag)27 b Fm(:)41 b(\015ag)31 b(to)g(sp)s(ecify)f(storage)i │ │ │ │ │ (of)e(factors.)330 5153 y Fe({)45 b Fl(0)30 b Fm(|)h(eac)m(h)g(fron)m │ │ │ │ │ (t)g(is)f(dense)330 5294 y Fe({)45 b Fl(1)g Fm(|)h(a)g(fron)m(t)f(ma)m │ │ │ │ │ (y)h(b)s(e)f(sparse)g(due)g(to)h(en)m(tries)h(dropp)s(ed)c(b)s(ecause)j │ │ │ │ │ (they)f(are)h(b)s(elo)m(w)g(a)g(drop)427 5407 y(tolerance.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1038 4 v 1220 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2815 100 V 1038 w Fm(5)137 399 y Fi(\210)45 b Fl(int)i(dataMode)28 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1057 4 v 1239 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2796 100 V 1057 w Fm(5)137 399 y Fi(\210)45 b Fl(int)i(dataMode)28 │ │ │ │ │ b Fm(:)41 b(\015ag)31 b(to)g(sp)s(ecify)f(data)h(storage.)330 │ │ │ │ │ 583 y Fe({)45 b Fl(1)30 b Fm(|)h(one-dimensional,)g(used)f(during)f │ │ │ │ │ (the)h(factorization.)330 727 y Fe({)45 b Fl(2)30 b Fm(|)h(t)m(w)m │ │ │ │ │ (o-dimensional,)h(used)e(during)f(the)h(solv)m(es.)137 │ │ │ │ │ 911 y Fi(\210)45 b Fl(int)i(nentD)29 b Fm(:)i(n)m(um)m(b)s(er)e(of)h │ │ │ │ │ (en)m(tries)h(in)f Fk(D)137 1096 y Fi(\210)45 b Fl(int)i(nentL)29 │ │ │ │ │ b Fm(:)i(n)m(um)m(b)s(er)e(of)h(en)m(tries)h(in)f Fk(L)137 │ │ │ │ │ @@ -5477,21 +5471,21 @@ │ │ │ │ │ (submatrices)g(in)g Fk(L)p Fm(,)i(used)d(during)227 5110 │ │ │ │ │ y(the)c(solv)m(es.)137 5294 y Fi(\210)45 b Fl(I2Ohash)h(*upperhash)33 │ │ │ │ │ b Fm(:)51 b(p)s(oin)m(ter)35 b(to)i(a)f Fl(I2Ohash)d │ │ │ │ │ Fm(hash)i(table)h(for)g(submatrices)f(in)g Fk(U)10 b │ │ │ │ │ Fm(,)37 b(used)e(during)227 5407 y(the)c(solv)m(es.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fm(6)p 136 100 1038 4 v │ │ │ │ │ -1220 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2862 100 V 137 399 a Fi(\210)45 │ │ │ │ │ -b Fl(SubMtxManager)f(*manager)30 b Fm(:)43 b(p)s(oin)m(ter)31 │ │ │ │ │ -b(to)h(an)g(ob)5 b(ject)32 b(that)g(manages)h(the)e(instances)h(of)g │ │ │ │ │ -(submatrices)227 511 y(during)d(the)i(factors)g(and)f(solv)m(es.)137 │ │ │ │ │ -719 y Fi(\210)45 b Fl(Lock)i(*lock)27 b Fm(:)40 b(p)s(oin)m(ter)30 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fm(6)p 136 100 1057 4 v │ │ │ │ │ +1239 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2843 100 V 137 399 a Fi(\210)45 b Fl(SubMtxManager)f(*manager) │ │ │ │ │ +30 b Fm(:)43 b(p)s(oin)m(ter)31 b(to)h(an)g(ob)5 b(ject)32 │ │ │ │ │ +b(that)g(manages)h(the)e(instances)h(of)g(submatrices)227 │ │ │ │ │ +511 y(during)d(the)i(factors)g(and)f(solv)m(es.)137 719 │ │ │ │ │ +y Fi(\210)45 b Fl(Lock)i(*lock)27 b Fm(:)40 b(p)s(oin)m(ter)30 │ │ │ │ │ b(to)f(a)h Fl(Lock)e Fm(lo)s(c)m(k)i(used)e(in)h(a)g(m)m(ultithreaded)g │ │ │ │ │ (en)m(vironmen)m(t)h(to)g(ensure)e(exlusiv)m(e)227 832 │ │ │ │ │ y(access)i(while)f(allo)s(cating)i(storage)g(in)d(the)h │ │ │ │ │ Fl(IV)g Fm(and)f Fl(IVL)g Fm(ob)5 b(jects.)41 b(This)28 │ │ │ │ │ b(is)h(not)g(used)f(in)g(a)i(serial)f(or)g(MPI)227 945 │ │ │ │ │ y(en)m(vironmen)m(t.)137 1153 y Fi(\210)45 b Fl(int)i(nlocks)29 │ │ │ │ │ b Fm(:)41 b(n)m(um)m(b)s(er)29 b(of)h(times)h(the)g(lo)s(c)m(k)g(has)f │ │ │ │ │ @@ -5547,17 +5541,17 @@ │ │ │ │ │ (ost-pro)s(cessed\),)i(and)f Fl(0)g Fm(otherwise.)0 5057 │ │ │ │ │ y Fd(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g │ │ │ │ │ Fc(FrontMtx)c Fd(metho)t(ds)0 5294 y Fm(This)g(section)j(con)m(tains)f │ │ │ │ │ (brief)f(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h │ │ │ │ │ (metho)s(ds)f(that)h(b)s(elong)f(to)h(the)0 5407 y Fl(FrontMtx)28 │ │ │ │ │ b Fm(ob)5 b(ject.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1038 4 v 1220 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2815 100 V 1038 w Fm(7)0 399 y Fb(1.2.1)112 b(Basic)38 │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1057 4 v 1239 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2796 100 V 1057 w Fm(7)0 399 y Fb(1.2.1)112 b(Basic)38 │ │ │ │ │ b(metho)s(ds)0 593 y Fm(As)d(usual,)h(there)f(are)g(four)f(basic)h │ │ │ │ │ (metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e │ │ │ │ │ (default)f(\014elds,)h(clearing)0 706 y(an)m(y)31 b(allo)s(cated)h │ │ │ │ │ (data,)f(and)f(free'ing)h(the)g(ob)5 b(ject.)111 930 │ │ │ │ │ y(1.)46 b Fl(FrontMtx)g(*)h(FrontMtx_new)e(\()i(void)g(\))g(;)227 │ │ │ │ │ 1078 y Fm(This)35 b(metho)s(d)g(simply)g(allo)s(cates)j(storage)f(for)e │ │ │ │ │ (the)h Fl(FrontMtx)d Fm(structure)i(and)g(then)g(sets)h(the)g(default) │ │ │ │ │ @@ -5616,76 +5610,75 @@ │ │ │ │ │ (exits.)111 5111 y(2.)46 b Fl(int)h(FrontMtx_neqns)d(\()k(FrontMtx)d │ │ │ │ │ (*frontmtx)g(\))j(;)227 5259 y Fm(This)30 b(metho)s(d)g(returns)f(the)h │ │ │ │ │ (n)m(um)m(b)s(er)f(of)i(equations)g(in)f(the)h(matrix.)227 │ │ │ │ │ 5407 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fm(If)30 │ │ │ │ │ b Fl(frontmtx)e Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f(message)h(is)g │ │ │ │ │ (prin)m(ted)e(and)h(the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fm(8)p 136 100 1038 4 v │ │ │ │ │ -1220 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2862 100 V 111 399 a Fm(3.)46 │ │ │ │ │ -b Fl(Tree)h(*)g(FrontMtx_frontTree)c(\()48 b(FrontMtx)d(*frontmtx)g(\)) │ │ │ │ │ -j(;)227 552 y Fm(This)30 b(metho)s(d)g(returns)f(the)h │ │ │ │ │ -Fl(Tree)g Fm(ob)5 b(ject)31 b(for)f(the)h(fron)m(ts.)227 │ │ │ │ │ -706 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fm(If)30 │ │ │ │ │ -b Fl(frontmtx)e Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f(message)h(is)g │ │ │ │ │ -(prin)m(ted)e(and)h(the)h(program)f(exits.)111 900 y(4.)46 │ │ │ │ │ -b Fl(void)h(FrontMtx_initialFrontDim)o(ensi)o(ons)41 │ │ │ │ │ -b(\()48 b(FrontMtx)d(*frontmtx,)g(int)i(J,)1468 1013 │ │ │ │ │ -y(int)g(*pnD,)f(int)h(*pnL,)g(int)g(*pnU,)f(int)h(*pnbytes)e(\))j(;)227 │ │ │ │ │ -1166 y Fm(This)29 b(metho)s(d)h(\014lls)g(the)g(four)f(p)s(oin)m(ter)h │ │ │ │ │ -(argumen)m(ts)g(with)g(the)g(n)m(um)m(b)s(er)f(of)h(in)m(ternal)h(ro)m │ │ │ │ │ -(ws)f(and)f(columns,)227 1279 y(n)m(um)m(b)s(er)36 b(of)h(ro)m(ws)f(in) │ │ │ │ │ -h(the)g(lo)m(w)m(er)g(blo)s(c)m(k,)j(n)m(um)m(b)s(er)35 │ │ │ │ │ -b(of)i(columns)f(in)h(the)g(upp)s(er)d(blo)s(c)m(k,)39 │ │ │ │ │ -b(and)d(n)m(um)m(b)s(er)g(of)227 1392 y(b)m(ytes)31 b(for)f(a)h │ │ │ │ │ -Fl(Chv)f Fm(ob)5 b(ject)31 b(to)g(hold)f(the)g(fron)m(t.)41 │ │ │ │ │ -b(in)30 b(fron)m(t)h Fl(J)p Fm(.)227 1546 y Fh(Err)-5 │ │ │ │ │ -b(or)30 b(che)-5 b(cking:)38 b Fm(If)26 b Fl(frontmtx)d │ │ │ │ │ -Fm(is)j Fl(NULL)p Fm(,)f(or)h(if)g Fl(J)g Fm(is)f(not)i(in)e │ │ │ │ │ -Fl([0,nfront\))p Fm(,)g(or)g(if)h(an)m(y)h(of)f(the)g(four)f(p)s(oin)m │ │ │ │ │ -(ter)227 1659 y(argumen)m(ts)31 b(are)g(NULL,)f(an)h(error)f(message)h │ │ │ │ │ -(is)f(prin)m(ted)g(and)g(the)h(program)f(exits.)111 1853 │ │ │ │ │ -y(5.)46 b Fl(int)h(FrontMtx_frontSize)c(\()k(FrontMtx)f(*frontmtx,)f │ │ │ │ │ -(int)i(J)g(\))h(;)227 2006 y Fm(This)30 b(metho)s(d)g(returns)f(the)h │ │ │ │ │ -(n)m(um)m(b)s(er)f(of)i(in)m(ternal)g(ro)m(ws)f(and)g(columns)g(in)g │ │ │ │ │ -(fron)m(t)h Fl(J)p Fm(.)227 2160 y Fh(Err)-5 b(or)33 │ │ │ │ │ -b(che)-5 b(cking:)40 b Fm(If)29 b Fl(frontmtx)e Fm(or)i │ │ │ │ │ -Fl(frontsizesIV)d Fm(is)k Fl(NULL)p Fm(,)e(or)i(if)f │ │ │ │ │ -Fl(J)g Fm(is)g(not)h(in)f Fl([0,nfront\))p Fm(,)e(an)i(error)227 │ │ │ │ │ -2273 y(message)j(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)111 │ │ │ │ │ -2467 y(6.)46 b Fl(void)h(FrontMtx_setFrontSize)42 b(\()47 │ │ │ │ │ -b(FrontMtx)f(*frontmtx,)f(int)i(J,)g(int)g(size)g(\))g(;)227 │ │ │ │ │ -2621 y Fm(This)23 b(metho)s(d)f(sets)i(the)f(n)m(um)m(b)s(er)f(of)h(in) │ │ │ │ │ -m(ternal)h(ro)m(ws)f(and)g(columns)g(in)g(fron)m(t)g │ │ │ │ │ -Fl(J)g Fm(to)g(b)s(e)g Fl(size)p Fm(.)37 b(This)22 b(metho)s(d)227 │ │ │ │ │ -2733 y(is)37 b(used)e(during)g(factorizations)k(with)d(piv)m(oting)i │ │ │ │ │ -(enabled)e(since)h(w)m(e)g(cannot)g(tell)h(ahead)e(of)h(time)g(ho)m(w) │ │ │ │ │ -227 2846 y(man)m(y)31 b(ro)m(ws)f(and)g(columns)g(in)g(a)h(fron)m(t)f │ │ │ │ │ -(will)h(b)s(e)f(eliminated.)227 3000 y Fh(Err)-5 b(or)42 │ │ │ │ │ -b(che)-5 b(cking:)56 b Fm(If)38 b Fl(frontmtx)e Fm(or)j │ │ │ │ │ -Fl(frontsizesIV)c Fm(is)k Fl(NULL)p Fm(,)e(or)i(if)f │ │ │ │ │ -Fl(J)g Fm(is)h(not)f(in)h Fl([0,nfront\))p Fm(,)e(or)i(if)227 │ │ │ │ │ -3113 y Fl(size)24 b Fk(<)h Fm(0,)31 b(an)g(error)f(message)h(is)g(prin) │ │ │ │ │ -m(ted)e(and)h(the)h(program)f(exits.)111 3307 y(7.)46 │ │ │ │ │ -b Fl(void)h(FrontMtx_columnIndices)42 b(\()47 b(FrontMtx)f(*frontmtx,)f │ │ │ │ │ -(int)i(J,)1659 3420 y(int)g(*pncol,)f(int)h(**pindices)e(\))i(;)227 │ │ │ │ │ -3574 y Fm(This)32 b(metho)s(d)f(\014lls)h Fl(*pncol)f │ │ │ │ │ -Fm(with)h(the)g(n)m(um)m(b)s(er)f(of)i(columns)f(and)f │ │ │ │ │ -Fl(*pindices)f Fm(with)i(a)h(p)s(oin)m(ter)f(to)h(the)227 │ │ │ │ │ -3686 y(column)d(indices)h(for)f(fron)m(t)h Fl(J)p Fm(.)227 │ │ │ │ │ -3840 y Fh(Err)-5 b(or)40 b(che)-5 b(cking:)52 b Fm(If)36 │ │ │ │ │ -b Fl(frontmtx)p Fm(,)g Fl(pncol)f Fm(or)h Fl(pindices)e │ │ │ │ │ -Fm(is)j Fl(NULL)p Fm(,)e(or)h(if)h Fl(J)f Fm(is)g(not)h(in)f │ │ │ │ │ -Fl([0,nfront\))p Fm(,)f(an)227 3953 y(error)30 b(message)i(is)e(prin)m │ │ │ │ │ -(ted)g(and)g(the)g(program)h(exits.)111 4147 y(8.)46 │ │ │ │ │ -b Fl(void)h(FrontMtx_rowIndices)42 b(\()48 b(FrontMtx)d(*frontmtx,)g │ │ │ │ │ -(int)i(J,)1516 4260 y(int)g(*pnrow,)f(int)h(**pindices)e(\))i(;)227 │ │ │ │ │ -4414 y Fm(This)30 b(metho)s(d)f(\014lls)h Fl(*pnrow)f │ │ │ │ │ -Fm(with)h(the)g(n)m(um)m(b)s(er)f(of)h(ro)m(ws)h(and)e │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fm(8)p 136 100 1057 4 v │ │ │ │ │ +1239 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2843 100 V 111 399 a Fm(3.)46 b Fl(Tree)h(*)g │ │ │ │ │ +(FrontMtx_frontTree)c(\()48 b(FrontMtx)d(*frontmtx)g(\))j(;)227 │ │ │ │ │ +552 y Fm(This)30 b(metho)s(d)g(returns)f(the)h Fl(Tree)g │ │ │ │ │ +Fm(ob)5 b(ject)31 b(for)f(the)h(fron)m(ts.)227 706 y │ │ │ │ │ +Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fm(If)30 b Fl(frontmtx)e │ │ │ │ │ +Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f(message)h(is)g(prin)m(ted)e(and)h │ │ │ │ │ +(the)h(program)f(exits.)111 900 y(4.)46 b Fl(void)h │ │ │ │ │ +(FrontMtx_initialFrontDim)o(ensi)o(ons)41 b(\()48 b(FrontMtx)d │ │ │ │ │ +(*frontmtx,)g(int)i(J,)1468 1013 y(int)g(*pnD,)f(int)h(*pnL,)g(int)g │ │ │ │ │ +(*pnU,)f(int)h(*pnbytes)e(\))j(;)227 1166 y Fm(This)29 │ │ │ │ │ +b(metho)s(d)h(\014lls)g(the)g(four)f(p)s(oin)m(ter)h(argumen)m(ts)g │ │ │ │ │ +(with)g(the)g(n)m(um)m(b)s(er)f(of)h(in)m(ternal)h(ro)m(ws)f(and)f │ │ │ │ │ +(columns,)227 1279 y(n)m(um)m(b)s(er)36 b(of)h(ro)m(ws)f(in)h(the)g(lo) │ │ │ │ │ +m(w)m(er)g(blo)s(c)m(k,)j(n)m(um)m(b)s(er)35 b(of)i(columns)f(in)h(the) │ │ │ │ │ +g(upp)s(er)d(blo)s(c)m(k,)39 b(and)d(n)m(um)m(b)s(er)g(of)227 │ │ │ │ │ +1392 y(b)m(ytes)31 b(for)f(a)h Fl(Chv)f Fm(ob)5 b(ject)31 │ │ │ │ │ +b(to)g(hold)f(the)g(fron)m(t.)41 b(in)30 b(fron)m(t)h │ │ │ │ │ +Fl(J)p Fm(.)227 1546 y Fh(Err)-5 b(or)30 b(che)-5 b(cking:)38 │ │ │ │ │ +b Fm(If)26 b Fl(frontmtx)d Fm(is)j Fl(NULL)p Fm(,)f(or)h(if)g │ │ │ │ │ +Fl(J)g Fm(is)f(not)i(in)e Fl([0,nfront\))p Fm(,)g(or)g(if)h(an)m(y)h │ │ │ │ │ +(of)f(the)g(four)f(p)s(oin)m(ter)227 1659 y(argumen)m(ts)31 │ │ │ │ │ +b(are)g(NULL,)f(an)h(error)f(message)h(is)f(prin)m(ted)g(and)g(the)h │ │ │ │ │ +(program)f(exits.)111 1853 y(5.)46 b Fl(int)h(FrontMtx_frontSize)c(\()k │ │ │ │ │ +(FrontMtx)f(*frontmtx,)f(int)i(J)g(\))h(;)227 2006 y │ │ │ │ │ +Fm(This)30 b(metho)s(d)g(returns)f(the)h(n)m(um)m(b)s(er)f(of)i(in)m │ │ │ │ │ +(ternal)g(ro)m(ws)f(and)g(columns)g(in)g(fron)m(t)h Fl(J)p │ │ │ │ │ +Fm(.)227 2160 y Fh(Err)-5 b(or)33 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fm(If)29 b Fl(frontmtx)e Fm(or)i Fl(frontsizesIV)d │ │ │ │ │ +Fm(is)k Fl(NULL)p Fm(,)e(or)i(if)f Fl(J)g Fm(is)g(not)h(in)f │ │ │ │ │ +Fl([0,nfront\))p Fm(,)e(an)i(error)227 2273 y(message)j(is)e(prin)m │ │ │ │ │ +(ted)g(and)g(the)g(program)h(exits.)111 2467 y(6.)46 │ │ │ │ │ +b Fl(void)h(FrontMtx_setFrontSize)42 b(\()47 b(FrontMtx)f(*frontmtx,)f │ │ │ │ │ +(int)i(J,)g(int)g(size)g(\))g(;)227 2621 y Fm(This)23 │ │ │ │ │ +b(metho)s(d)f(sets)i(the)f(n)m(um)m(b)s(er)f(of)h(in)m(ternal)h(ro)m │ │ │ │ │ +(ws)f(and)g(columns)g(in)g(fron)m(t)g Fl(J)g Fm(to)g(b)s(e)g │ │ │ │ │ +Fl(size)p Fm(.)37 b(This)22 b(metho)s(d)227 2733 y(is)37 │ │ │ │ │ +b(used)e(during)g(factorizations)k(with)d(piv)m(oting)i(enabled)e │ │ │ │ │ +(since)h(w)m(e)g(cannot)g(tell)h(ahead)e(of)h(time)g(ho)m(w)227 │ │ │ │ │ +2846 y(man)m(y)31 b(ro)m(ws)f(and)g(columns)g(in)g(a)h(fron)m(t)f(will) │ │ │ │ │ +h(b)s(e)f(eliminated.)227 3000 y Fh(Err)-5 b(or)42 b(che)-5 │ │ │ │ │ +b(cking:)56 b Fm(If)38 b Fl(frontmtx)e Fm(or)j Fl(frontsizesIV)c │ │ │ │ │ +Fm(is)k Fl(NULL)p Fm(,)e(or)i(if)f Fl(J)g Fm(is)h(not)f(in)h │ │ │ │ │ +Fl([0,nfront\))p Fm(,)e(or)i(if)227 3113 y Fl(size)24 │ │ │ │ │ +b Fk(<)h Fm(0,)31 b(an)g(error)f(message)h(is)g(prin)m(ted)e(and)h(the) │ │ │ │ │ +h(program)f(exits.)111 3307 y(7.)46 b Fl(void)h(FrontMtx_columnIndices) │ │ │ │ │ +42 b(\()47 b(FrontMtx)f(*frontmtx,)f(int)i(J,)1659 3420 │ │ │ │ │ +y(int)g(*pncol,)f(int)h(**pindices)e(\))i(;)227 3574 │ │ │ │ │ +y Fm(This)32 b(metho)s(d)f(\014lls)h Fl(*pncol)f Fm(with)h(the)g(n)m │ │ │ │ │ +(um)m(b)s(er)f(of)i(columns)f(and)f Fl(*pindices)f Fm(with)i(a)h(p)s │ │ │ │ │ +(oin)m(ter)f(to)h(the)227 3686 y(column)d(indices)h(for)f(fron)m(t)h │ │ │ │ │ +Fl(J)p Fm(.)227 3840 y Fh(Err)-5 b(or)40 b(che)-5 b(cking:)52 │ │ │ │ │ +b Fm(If)36 b Fl(frontmtx)p Fm(,)g Fl(pncol)f Fm(or)h │ │ │ │ │ +Fl(pindices)e Fm(is)j Fl(NULL)p Fm(,)e(or)h(if)h Fl(J)f │ │ │ │ │ +Fm(is)g(not)h(in)f Fl([0,nfront\))p Fm(,)f(an)227 3953 │ │ │ │ │ +y(error)30 b(message)i(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.) │ │ │ │ │ +111 4147 y(8.)46 b Fl(void)h(FrontMtx_rowIndices)42 b(\()48 │ │ │ │ │ +b(FrontMtx)d(*frontmtx,)g(int)i(J,)1516 4260 y(int)g(*pnrow,)f(int)h │ │ │ │ │ +(**pindices)e(\))i(;)227 4414 y Fm(This)30 b(metho)s(d)f(\014lls)h │ │ │ │ │ +Fl(*pnrow)f Fm(with)h(the)g(n)m(um)m(b)s(er)f(of)h(ro)m(ws)h(and)e │ │ │ │ │ Fl(*pindices)f Fm(with)i(a)g(p)s(oin)m(ter)g(to)h(the)g(ro)m(w)227 │ │ │ │ │ 4526 y(indices)g(for)f(fron)m(t)g Fl(J)p Fm(.)227 4680 │ │ │ │ │ y Fh(Err)-5 b(or)40 b(che)-5 b(cking:)52 b Fm(If)36 b │ │ │ │ │ Fl(frontmtx)p Fm(,)g Fl(pnrow)f Fm(or)h Fl(pindices)e │ │ │ │ │ Fm(is)j Fl(NULL)p Fm(,)e(or)h(if)h Fl(J)f Fm(is)g(not)h(in)f │ │ │ │ │ Fl([0,nfront\))p Fm(,)f(an)227 4793 y(error)30 b(message)i(is)e(prin)m │ │ │ │ │ (ted)g(and)g(the)g(program)h(exits.)111 4987 y(9.)46 │ │ │ │ │ @@ -5695,17 +5688,17 @@ │ │ │ │ │ (submatrix)f Fk(D)3073 5155 y Fj(J)n(;J)3179 5141 y Fm(.)227 │ │ │ │ │ 5294 y Fh(Err)-5 b(or)31 b(che)-5 b(cking:)38 b Fm(If)27 │ │ │ │ │ b Fl(frontmtx)d Fm(is)j Fl(NULL)p Fm(,)f(or)h(if)g Fl(J)f │ │ │ │ │ Fm(is)h(not)g(in)g Fl([0,nfront\))p Fm(,)d(an)j(error)g(message)h(is)e │ │ │ │ │ (prin)m(ted)227 5407 y(and)k(the)h(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1038 4 v 1220 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2815 100 V 1038 w Fm(9)66 399 y(10.)46 b Fl(SubMtx)g(*)i │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1057 4 v 1239 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2796 100 V 1057 w Fm(9)66 399 y(10.)46 b Fl(SubMtx)g(*)i │ │ │ │ │ (FrontMtx_upperMtx)43 b(\()k(FrontMtx)f(*frontmtx,)f(int)i(J,)g(int)g │ │ │ │ │ (K)g(\))h(;)227 554 y Fm(This)32 b(metho)s(d)h(returns)e(a)i(p)s(oin)m │ │ │ │ │ (ter)g(to)h(the)f(ob)5 b(ject)33 b(that)h(con)m(tains)g(submatrix)e │ │ │ │ │ Fk(U)3087 568 y Fj(J)n(;K)3212 554 y Fm(.)48 b(If)32 │ │ │ │ │ b Fk(K)k Fm(=)29 b Fk(nf)10 b(r)s(ont)p Fm(,)227 667 │ │ │ │ │ y(then)30 b(the)h(ob)5 b(ject)31 b(con)m(taining)h Fk(U)1370 │ │ │ │ │ 682 y Fj(J)n(;@)t(J)1547 667 y Fm(is)e(returned.)227 │ │ │ │ │ @@ -5777,40 +5770,39 @@ │ │ │ │ │ b(metho)s(d)g(returns)f(a)i(p)s(oin)m(ter)f(to)h(the)g │ │ │ │ │ Fl(IVL)e Fm(ob)5 b(ject)31 b(that)g(holds)f(the)h(lo)m(w)m(er)g(blo)s │ │ │ │ │ (c)m(ks.)227 5407 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fm(If)30 b Fl(frontmtx)e Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f │ │ │ │ │ (message)h(is)g(prin)m(ted)e(and)h(the)h(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fm(10)p 182 100 1016 4 │ │ │ │ │ -v 1198 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2885 100 V 0 399 a Fb(1.2.3)112 │ │ │ │ │ -b(Initialization)39 b(metho)s(ds)111 604 y Fm(1.)46 b │ │ │ │ │ -Fl(void)h(FrontMtx_init)d(\()k(FrontMtx)d(*frontmtx,)g(ETree)h │ │ │ │ │ -(*frontETree,)705 716 y(IVL)g(*symbfacIVL,)f(int)i(type,)f(int)h │ │ │ │ │ -(symmetryflag,)d(int)j(sparsityflag,)705 829 y(int)f(pivotingflag,)f │ │ │ │ │ -(int)i(lockflag,)e(int)i(myid,)f(IV)h(*ownersIV,)705 │ │ │ │ │ -942 y(SubMtxManager)d(*manager,)h(int)i(msglvl,)f(FILE)g(*msgFile)g(\)) │ │ │ │ │ -h(;)227 1101 y Fm(This)23 b(metho)s(d)h(initializes)i(the)e(ob)5 │ │ │ │ │ -b(ject,)26 b(allo)s(cating)h(and)c(initializing)j(the)e(in)m(ternal)h │ │ │ │ │ -(ob)5 b(jects)25 b(as)f(necessary)-8 b(.)227 1214 y(See)41 │ │ │ │ │ -b(the)f(previous)g(section)h(on)f(data)h(structures)f(for)g(the)g │ │ │ │ │ -(meanings)h(of)f(the)g Fl(type)p Fm(,)i Fl(symmetryflag)p │ │ │ │ │ -Fm(,)227 1327 y Fl(sparsityflag)34 b Fm(and)j Fl(pivotingflag)d │ │ │ │ │ -Fm(parameters.)63 b(The)37 b Fl(lockflag)e Fm(parameter)j(has)f(the)g │ │ │ │ │ -(follo)m(wing)227 1440 y(meaning.)337 1645 y Fi(\210)45 │ │ │ │ │ -b Fl(0)30 b Fm(|)h(the)f Fl(Lock)f Fm(ob)5 b(ject)32 │ │ │ │ │ -b(is)e(not)h(allo)s(cated)h(or)e(initialized.)337 1800 │ │ │ │ │ -y Fi(\210)45 b Fl(1)d Fm(|)h(the)f Fl(Lock)f Fm(ob)5 │ │ │ │ │ -b(ject)44 b(is)e(allo)s(cated)j(and)c(initialized)k(to)e(sync)m │ │ │ │ │ -(hronize)f(only)h(threads)f(in)g(this)427 1913 y(pro)s(cess.)337 │ │ │ │ │ -2068 y Fi(\210)j Fl(2)27 b Fm(|)g(the)h Fl(Lock)e Fm(ob)5 │ │ │ │ │ -b(ject)28 b(is)f(allo)s(cated)j(and)c(initialized)j(to)f(sync)m │ │ │ │ │ -(hronize)g(threads)f(in)g(this)g(and)g(other)427 2181 │ │ │ │ │ -y(pro)s(cesses.)227 2386 y(If)j Fl(lockflag)e Fm(is)j(not)f │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fm(10)p 182 100 1035 4 │ │ │ │ │ +v 1217 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2866 100 V 0 399 a Fb(1.2.3)112 b(Initialization)39 │ │ │ │ │ +b(metho)s(ds)111 604 y Fm(1.)46 b Fl(void)h(FrontMtx_init)d(\()k │ │ │ │ │ +(FrontMtx)d(*frontmtx,)g(ETree)h(*frontETree,)705 716 │ │ │ │ │ +y(IVL)g(*symbfacIVL,)f(int)i(type,)f(int)h(symmetryflag,)d(int)j │ │ │ │ │ +(sparsityflag,)705 829 y(int)f(pivotingflag,)f(int)i(lockflag,)e(int)i │ │ │ │ │ +(myid,)f(IV)h(*ownersIV,)705 942 y(SubMtxManager)d(*manager,)h(int)i │ │ │ │ │ +(msglvl,)f(FILE)g(*msgFile)g(\))h(;)227 1101 y Fm(This)23 │ │ │ │ │ +b(metho)s(d)h(initializes)i(the)e(ob)5 b(ject,)26 b(allo)s(cating)h │ │ │ │ │ +(and)c(initializing)j(the)e(in)m(ternal)h(ob)5 b(jects)25 │ │ │ │ │ +b(as)f(necessary)-8 b(.)227 1214 y(See)41 b(the)f(previous)g(section)h │ │ │ │ │ +(on)f(data)h(structures)f(for)g(the)g(meanings)h(of)f(the)g │ │ │ │ │ +Fl(type)p Fm(,)i Fl(symmetryflag)p Fm(,)227 1327 y Fl(sparsityflag)34 │ │ │ │ │ +b Fm(and)j Fl(pivotingflag)d Fm(parameters.)63 b(The)37 │ │ │ │ │ +b Fl(lockflag)e Fm(parameter)j(has)f(the)g(follo)m(wing)227 │ │ │ │ │ +1440 y(meaning.)337 1645 y Fi(\210)45 b Fl(0)30 b Fm(|)h(the)f │ │ │ │ │ +Fl(Lock)f Fm(ob)5 b(ject)32 b(is)e(not)h(allo)s(cated)h(or)e │ │ │ │ │ +(initialized.)337 1800 y Fi(\210)45 b Fl(1)d Fm(|)h(the)f │ │ │ │ │ +Fl(Lock)f Fm(ob)5 b(ject)44 b(is)e(allo)s(cated)j(and)c(initialized)k │ │ │ │ │ +(to)e(sync)m(hronize)f(only)h(threads)f(in)g(this)427 │ │ │ │ │ +1913 y(pro)s(cess.)337 2068 y Fi(\210)j Fl(2)27 b Fm(|)g(the)h │ │ │ │ │ +Fl(Lock)e Fm(ob)5 b(ject)28 b(is)f(allo)s(cated)j(and)c(initialized)j │ │ │ │ │ +(to)f(sync)m(hronize)g(threads)f(in)g(this)g(and)g(other)427 │ │ │ │ │ +2181 y(pro)s(cesses.)227 2386 y(If)j Fl(lockflag)e Fm(is)j(not)f │ │ │ │ │ Fl(0)p Fm(,)h(the)f(lo)s(c)m(k)i(is)e(allo)s(cated)i(and)e │ │ │ │ │ (initialized.)227 2545 y(This)g(metho)s(d)g(allo)s(cates)k(as)d(m)m(uc) │ │ │ │ │ m(h)f(storage)j(as)e(p)s(ossible.)41 b(When)31 b(piv)m(oting)h(is)e │ │ │ │ │ (not)h(enabled)g(and)f(dense)227 2658 y(fron)m(ts)40 │ │ │ │ │ b(are)g(stored)g(the)g(structure)f(of)h(the)g(factor)h(matrix)f(is)g │ │ │ │ │ (\014xed)f(and)g(giv)m(en)i(b)m(y)f(the)g Fl(frontETree)227 │ │ │ │ │ 2771 y Fm(ob)5 b(ject.)58 b(The)35 b(diagonal)i Fk(D)1190 │ │ │ │ │ @@ -5856,17 +5848,17 @@ │ │ │ │ │ (indices)g(\(when)f(nonsymem)m(tric\))h(are)g(copied.)48 │ │ │ │ │ b(Finally)34 b(the)e(fron)m(t's)h(en)m(tries)227 5248 │ │ │ │ │ y(are)e(zero)s(ed)g(via)g(a)f(call)i(to)f Fl(Chv)p 1317 │ │ │ │ │ 5248 V 34 w(zero\(\))p Fm(.)227 5407 y Fh(Err)-5 b(or)34 │ │ │ │ │ b(che)-5 b(cking:)40 b Fm(None)31 b(presen)m(tly)-8 b(.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1016 4 v 1197 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2792 100 V 1016 w Fm(11)111 399 y(2.)46 b Fl(char)h │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1035 4 v 1216 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2773 100 V 1035 w Fm(11)111 399 y(2.)46 b Fl(char)h │ │ │ │ │ (FrontMtx_factorVisit)42 b(\()48 b(FrontMtx)d(*frontmtx,)g(Pencil)h │ │ │ │ │ (*pencil,)g(int)h(J,)370 511 y(int)g(myid,)g(int)g(owners[],)e(Chv)i │ │ │ │ │ (*fronts[],)e(int)i(lookahead,)e(double)h(tau,)370 624 │ │ │ │ │ y(double)h(droptol,)e(char)i(status[],)e(IP)i(*heads[],)e(IV)j │ │ │ │ │ (*pivotsizesIV,)c(DV)j(*workDV,)370 737 y(int)g(parent[],)f(ChvList)f │ │ │ │ │ (*aggList,)h(ChvList)g(*postList,)f(ChvManager)g(*chvmanager,)370 │ │ │ │ │ 850 y(int)i(stats[],)f(double)g(cpus[],)g(int)h(msglvl,)f(FILE)g │ │ │ │ │ @@ -5929,19 +5921,19 @@ │ │ │ │ │ (ultithreaded)g(and)f(MPI)h(factor)h(and)e(solv)m(e)i(metho)s(ds)f(to)g │ │ │ │ │ (load)h(the)227 5262 y(dequeue)30 b(with)g(the)h(activ)m(e)i(lea)m(v)m │ │ │ │ │ (es)f(in)e(the)h(fron)m(t)f(tree)h(with)f(resp)s(ect)h(to)g(the)f │ │ │ │ │ (thread)h(or)f(pro)s(cessor.)227 5407 y Fh(Err)-5 b(or)34 │ │ │ │ │ b(che)-5 b(cking:)40 b Fm(None)31 b(presen)m(tly)-8 b(.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fm(12)p 182 100 1016 │ │ │ │ │ -4 v 1198 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2885 100 V 111 399 a Fm(8.)46 │ │ │ │ │ -b Fl(ChvList)g(*)i(FrontMtx_postList)43 b(\()k(FrontMtx)f(*frontmtx,)f │ │ │ │ │ -(IV)i(*frontOwnersIV,)1659 511 y(int)g(lockflag)f(\))h(;)227 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fm(12)p 182 100 1035 │ │ │ │ │ +4 v 1217 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,) │ │ │ │ │ +h(2024)p 2866 100 V 111 399 a Fm(8.)46 b Fl(ChvList)g(*)i │ │ │ │ │ +(FrontMtx_postList)43 b(\()k(FrontMtx)f(*frontmtx,)f(IV)i │ │ │ │ │ +(*frontOwnersIV,)1659 511 y(int)g(lockflag)f(\))h(;)227 │ │ │ │ │ 666 y Fm(This)31 b(metho)s(d)h(is)g(called)h(b)m(y)e(the)h(m)m │ │ │ │ │ (ultithreaded)g(and)g(MPI)g(factor)g(metho)s(ds)g(to)g(create)i(and)d │ │ │ │ │ (return)g(a)227 779 y(list)g(ob)5 b(ject)32 b(to)f(hold)f(p)s(ostp)s │ │ │ │ │ (oned)f(c)m(hevrons)h(and)g(help)g(sync)m(hronize)g(the)h │ │ │ │ │ (factorization.)227 933 y Fh(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fm(None)31 b(presen)m(tly)-8 b(.)111 1129 │ │ │ │ │ y(9.)46 b Fl(ChvList)g(*)i(FrontMtx_aggregateList)41 │ │ │ │ │ @@ -6007,17 +5999,17 @@ │ │ │ │ │ b(.)227 5098 y Fh(Err)j(or)34 b(che)-5 b(cking:)40 b │ │ │ │ │ Fm(None)31 b(presen)m(tly)-8 b(.)66 5294 y(13.)46 b Fl │ │ │ │ │ (FrontMtx_storePostponedDa)o(ta)c(\()47 b(FrontMtx)f(*frontmtx,)f(Chv)i │ │ │ │ │ (*frontJ,)418 5407 y(int)g(npost,)f(int)h(K,)g(ChvList)f │ │ │ │ │ (*postponedlist,)e(ChvManager)h(*chvmanager)f(\))k(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 91 100 1016 4 v 1197 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2792 100 V 1016 w Fm(13)227 399 y(This)c(metho)s(d)f(is)h(used)g(to)h │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1035 4 v 1216 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2773 100 V 1035 w Fm(13)227 399 y(This)c(metho)s(d)f(is)h(used)g(to)h │ │ │ │ │ (store)g(an)m(y)f(p)s(ostp)s(oned)f(ro)m(ws)h(and)f(columns)h(from)g │ │ │ │ │ (the)g(curren)m(t)g(fron)m(t)h Fl(frontJ)227 511 y Fm(in)m(to)f(a)g │ │ │ │ │ Fl(Chv)e Fm(ob)5 b(ject)27 b(obtained)f(from)f(the)i │ │ │ │ │ Fl(chvmanager)c Fm(ob)5 b(ject)27 b(and)e(place)i(it)f(in)m(to)h(the)g │ │ │ │ │ (list)f(of)g(p)s(ostp)s(oned)227 624 y(ob)5 b(jects)25 │ │ │ │ │ b(for)e Fl(K)p Fm(,)g(its)h(paren)m(t,)i(found)c(in)h(the)h │ │ │ │ │ Fl(postponedlist)c Fm(ob)5 b(ject.)39 b(The)23 b Fl(frontJ)f │ │ │ │ │ @@ -6085,43 +6077,42 @@ │ │ │ │ │ (ulating)i(up)s(dates)d(from)h(descenden)m(ts.)337 5107 │ │ │ │ │ y Fi(\210)45 b Fl(cpus[3])29 b Fm(|)h(time)h(sp)s(en)m(t)f(assem)m │ │ │ │ │ (bling)h(p)s(ostp)s(oned)e(data.)337 5257 y Fi(\210)45 │ │ │ │ │ b Fl(cpus[4])29 b Fm(|)h(time)h(sp)s(en)m(t)f(to)h(factor)g(the)g(fron) │ │ │ │ │ m(ts.)337 5407 y Fi(\210)45 b Fl(cpus[5])29 b Fm(|)h(time)h(sp)s(en)m │ │ │ │ │ (t)f(to)h(extract)h(p)s(ostp)s(oned)d(data.)p eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ -TeXDict begin 14 13 bop 0 100 a Fm(14)p 182 100 1016 │ │ │ │ │ -4 v 1198 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2885 100 V 337 399 a Fi(\210)45 │ │ │ │ │ -b Fl(cpus[6])29 b Fm(|)h(time)h(sp)s(en)m(t)f(to)h(store)g(the)g │ │ │ │ │ -(factor)g(en)m(tries.)337 550 y Fi(\210)45 b Fl(cpus[7])29 │ │ │ │ │ -b Fm(|)h(miscellaneous)i(time.)337 701 y Fi(\210)45 b │ │ │ │ │ -Fl(cpus[8])29 b Fm(|)h(total)i(time)f(in)f(the)h(metho)s(d.)227 │ │ │ │ │ -900 y(On)f(return,)f(the)i Fl(stats[])d Fm(v)m(ector)k(is)f(\014lled)f │ │ │ │ │ -(with)g(the)h(follo)m(wing)g(information.)337 1098 y │ │ │ │ │ -Fi(\210)45 b Fl(stats[0])28 b Fm(|)j(n)m(um)m(b)s(er)e(of)h(piv)m(ots.) │ │ │ │ │ -337 1249 y Fi(\210)45 b Fl(stats[1])28 b Fm(|)j(n)m(um)m(b)s(er)e(of)h │ │ │ │ │ -(piv)m(ot)i(tests.)337 1401 y Fi(\210)45 b Fl(stats[2])28 │ │ │ │ │ -b Fm(|)j(n)m(um)m(b)s(er)e(of)h(dela)m(y)m(ed)i(ro)m(ws)e(and)g │ │ │ │ │ -(columns.)337 1552 y Fi(\210)45 b Fl(stats[3])28 b Fm(|)j(n)m(um)m(b)s │ │ │ │ │ -(er)e(of)h(en)m(tries)h(in)f Fk(D)s Fm(.)337 1704 y Fi(\210)45 │ │ │ │ │ -b Fl(stats[4])28 b Fm(|)j(n)m(um)m(b)s(er)e(of)h(en)m(tries)h(in)f │ │ │ │ │ -Fk(L)p Fm(.)337 1855 y Fi(\210)45 b Fl(stats[5])28 b │ │ │ │ │ -Fm(|)j(n)m(um)m(b)s(er)e(of)h(en)m(tries)h(in)f Fk(U)10 │ │ │ │ │ -b Fm(.)227 2054 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)41 │ │ │ │ │ -b Fm(If)30 b Fl(frontmtx)p Fm(,)e Fl(pencil)p Fm(,)h │ │ │ │ │ -Fl(cpus)g Fm(or)i Fl(stats)e Fm(is)h Fl(NULL)p Fm(,)g(or)g(if)g │ │ │ │ │ -Fl(msglvl)47 b(>)g(0)30 b Fm(and)g Fl(msgFile)227 2167 │ │ │ │ │ -y Fm(is)h Fl(NULL)p Fm(,)e(an)h(error)g(message)i(is)e(prin)m(ted)g │ │ │ │ │ -(and)g(the)h(program)f(exits.)0 2450 y Fb(1.2.6)112 b(QR)38 │ │ │ │ │ -b(factorization)f(utilit)m(y)h(metho)s(ds)111 2652 y │ │ │ │ │ -Fm(1.)46 b Fl(void)h(FrontMtx_QR_setup)c(\()k(FrontMtx)f(*frontmtx,)f │ │ │ │ │ -(InpMtx)h(*mtxA,)g(IVL)h(**prowsIVL,)1420 2765 y(int)g(**pfirstnz,)e │ │ │ │ │ -(int)i(msglvl,)f(FILE)g(*msgFile)g(\))h(;)227 2920 y │ │ │ │ │ -Fm(This)27 b(metho)s(d)g(sets)g(up)f(the)i Fl(rowsIVL)d │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fm(14)p 182 100 1035 │ │ │ │ │ +4 v 1217 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,) │ │ │ │ │ +h(2024)p 2866 100 V 337 399 a Fi(\210)45 b Fl(cpus[6])29 │ │ │ │ │ +b Fm(|)h(time)h(sp)s(en)m(t)f(to)h(store)g(the)g(factor)g(en)m(tries.) │ │ │ │ │ +337 550 y Fi(\210)45 b Fl(cpus[7])29 b Fm(|)h(miscellaneous)i(time.)337 │ │ │ │ │ +701 y Fi(\210)45 b Fl(cpus[8])29 b Fm(|)h(total)i(time)f(in)f(the)h │ │ │ │ │ +(metho)s(d.)227 900 y(On)f(return,)f(the)i Fl(stats[])d │ │ │ │ │ +Fm(v)m(ector)k(is)f(\014lled)f(with)g(the)h(follo)m(wing)g │ │ │ │ │ +(information.)337 1098 y Fi(\210)45 b Fl(stats[0])28 │ │ │ │ │ +b Fm(|)j(n)m(um)m(b)s(er)e(of)h(piv)m(ots.)337 1249 y │ │ │ │ │ +Fi(\210)45 b Fl(stats[1])28 b Fm(|)j(n)m(um)m(b)s(er)e(of)h(piv)m(ot)i │ │ │ │ │ +(tests.)337 1401 y Fi(\210)45 b Fl(stats[2])28 b Fm(|)j(n)m(um)m(b)s │ │ │ │ │ +(er)e(of)h(dela)m(y)m(ed)i(ro)m(ws)e(and)g(columns.)337 │ │ │ │ │ +1552 y Fi(\210)45 b Fl(stats[3])28 b Fm(|)j(n)m(um)m(b)s(er)e(of)h(en)m │ │ │ │ │ +(tries)h(in)f Fk(D)s Fm(.)337 1704 y Fi(\210)45 b Fl(stats[4])28 │ │ │ │ │ +b Fm(|)j(n)m(um)m(b)s(er)e(of)h(en)m(tries)h(in)f Fk(L)p │ │ │ │ │ +Fm(.)337 1855 y Fi(\210)45 b Fl(stats[5])28 b Fm(|)j(n)m(um)m(b)s(er)e │ │ │ │ │ +(of)h(en)m(tries)h(in)f Fk(U)10 b Fm(.)227 2054 y Fh(Err)-5 │ │ │ │ │ +b(or)34 b(che)-5 b(cking:)41 b Fm(If)30 b Fl(frontmtx)p │ │ │ │ │ +Fm(,)e Fl(pencil)p Fm(,)h Fl(cpus)g Fm(or)i Fl(stats)e │ │ │ │ │ +Fm(is)h Fl(NULL)p Fm(,)g(or)g(if)g Fl(msglvl)47 b(>)g(0)30 │ │ │ │ │ +b Fm(and)g Fl(msgFile)227 2167 y Fm(is)h Fl(NULL)p Fm(,)e(an)h(error)g │ │ │ │ │ +(message)i(is)e(prin)m(ted)g(and)g(the)h(program)f(exits.)0 │ │ │ │ │ +2450 y Fb(1.2.6)112 b(QR)38 b(factorization)f(utilit)m(y)h(metho)s(ds) │ │ │ │ │ +111 2652 y Fm(1.)46 b Fl(void)h(FrontMtx_QR_setup)c(\()k(FrontMtx)f │ │ │ │ │ +(*frontmtx,)f(InpMtx)h(*mtxA,)g(IVL)h(**prowsIVL,)1420 │ │ │ │ │ +2765 y(int)g(**pfirstnz,)e(int)i(msglvl,)f(FILE)g(*msgFile)g(\))h(;)227 │ │ │ │ │ +2920 y Fm(This)27 b(metho)s(d)g(sets)g(up)f(the)i Fl(rowsIVL)d │ │ │ │ │ Fm(and)i Fl(firstnz[])e Fm(data)j(structures.)39 b(The)27 │ │ │ │ │ b(address)f(of)i Fl(rowsIVL)d Fm(is)227 3033 y(placed)32 │ │ │ │ │ b(in)g Fl(*prowsIVL)d Fm(and)i(the)h(address)f(of)h Fl(firstnz)e │ │ │ │ │ Fm(is)i(placed)g(in)f Fl(*pfirstnz)p Fm(.)43 b(List)32 │ │ │ │ │ b Fl(J)f Fm(of)h Fl(rowsIVL)227 3146 y Fm(con)m(tains)26 │ │ │ │ │ b(the)g(ro)m(ws)e(of)i Fk(A)f Fm(that)g(will)g(b)s(e)g(assem)m(bled)g │ │ │ │ │ (in)m(to)h(fron)m(t)f Fl(J)p Fm(.)g(The)f(leading)i(column)f(with)f(a)i │ │ │ │ │ @@ -6158,17 +6149,17 @@ │ │ │ │ │ (*msgFile)e(\))j(;)227 5294 y Fm(This)37 b(metho)s(d)g(creates)h(an)g │ │ │ │ │ Fl(A2)e Fm(ob)5 b(ject)39 b(to)f(hold)f(the)g(fron)m(t,)j(assem)m(bles) │ │ │ │ │ e(an)m(y)g(original)g(ro)m(ws)g(of)f Fk(A)h Fm(and)227 │ │ │ │ │ 5407 y(an)m(y)c(up)s(date)e(matrices)i(from)e(the)i(c)m(hildren)e(in)m │ │ │ │ │ (to)i(the)g(fron)m(t,)g(and)e(then)h(returns)f(the)h(fron)m(t.)48 │ │ │ │ │ b(The)33 b(ro)m(ws)p eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 91 100 1016 4 v 1197 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2792 100 V 1016 w Fm(15)227 399 y(and)c(up)s(date)g(matrices)h(are)g │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1035 4 v 1216 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2773 100 V 1035 w Fm(15)227 399 y(and)c(up)s(date)g(matrices)h(are)g │ │ │ │ │ (assem)m(bled)g(in)m(to)g(staircase)h(form,)f(so)g(no)f(subsequen)m(t)g │ │ │ │ │ (p)s(erm)m(utations)g(of)h(the)227 511 y(ro)m(ws)j(is)f(necessary)-8 │ │ │ │ │ b(.)227 660 y Fh(Err)j(or)28 b(che)-5 b(cking:)36 b Fm(If)23 │ │ │ │ │ b Fl(frontmtx)p Fm(,)f Fl(mtxA)p Fm(,)h Fl(rowsIVL)p │ │ │ │ │ Fm(,)e Fl(firstnz)p Fm(,)i Fl(colmap)e Fm(or)j Fl(workDV)d │ │ │ │ │ Fm(is)i Fl(NULL)p Fm(,)f(or)i(if)f Fl(msglvl)227 773 │ │ │ │ │ y(>)48 b(0)30 b Fm(and)g Fl(msgFile)e Fm(is)i Fl(NULL)p │ │ │ │ │ @@ -6240,36 +6231,36 @@ │ │ │ │ │ h(the)g(factoriza-)227 5146 y(tion.)227 5294 y Fh(Err)-5 │ │ │ │ │ b(or)35 b(che)-5 b(cking:)41 b Fm(If)31 b Fl(frontmtx)p │ │ │ │ │ Fm(,)e Fl(frontJ)g Fm(or)i Fl(chvmanager)d Fm(is)j Fl(NULL)p │ │ │ │ │ Fm(,)f(or)h(if)g Fl(msglvl)46 b(>)i(0)31 b Fm(and)f Fl(msgFile)227 │ │ │ │ │ 5407 y Fm(is)h Fl(NULL)p Fm(,)e(an)h(error)g(message)i(is)e(prin)m(ted) │ │ │ │ │ g(and)g(the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 16 16 │ │ │ │ │ -TeXDict begin 16 15 bop 0 100 a Fm(16)p 182 100 1016 │ │ │ │ │ -4 v 1198 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2885 100 V 0 399 a Fb(1.2.8)112 │ │ │ │ │ -b(P)m(ostpro)s(cessing)38 b(metho)s(ds)111 594 y Fm(1.)46 │ │ │ │ │ -b Fl(void)h(FrontMtx_postProcess)42 b(\()48 b(FrontMtx)d(*frontmtx,)g │ │ │ │ │ -(int)i(msglvl,)f(FILE)h(*msgFile)e(\))j(;)227 743 y Fm(This)31 │ │ │ │ │ -b(metho)s(d)g(do)s(es)g(p)s(ost-pro)s(cessing)g(c)m(hores)i(after)f │ │ │ │ │ -(the)f(factorization)k(is)c(complete.)46 b(If)31 b(piv)m(oting)i(w)m │ │ │ │ │ -(as)227 856 y(enabled,)25 b(the)f(metho)s(d)f(p)s(erm)m(utes)g(the)h │ │ │ │ │ -(ro)m(w)g(and)f(column)g(adjacency)i(ob)5 b(jects,)26 │ │ │ │ │ -b(p)s(erm)m(utes)d(the)h(lo)m(w)m(er)h(and)227 969 y(upp)s(er)36 │ │ │ │ │ -b(matrices,)41 b(and)c(up)s(dates)g(the)h(blo)s(c)m(k)h(adjacency)f(ob) │ │ │ │ │ -5 b(jects.)64 b(The)38 b(c)m(hevron)g(submatrices)g Fk(L)3746 │ │ │ │ │ -984 y Fj(@)t(J)5 b(;J)227 1082 y Fm(and)30 b Fk(U)466 │ │ │ │ │ -1097 y Fj(J)n(;@)t(J)643 1082 y Fm(are)h(split)f(in)m(to)i │ │ │ │ │ -Fk(L)1244 1096 y Fj(K)q(;J)1403 1082 y Fm(and)d Fk(U)1641 │ │ │ │ │ -1096 y Fj(J)n(;K)1797 1082 y Fm(where)h Fk(K)c Fg(\\)20 │ │ │ │ │ -b Fk(@)5 b(J)35 b Fg(6)p Fm(=)25 b Fg(;)p Fm(.)227 1231 │ │ │ │ │ -y Fh(Err)-5 b(or)33 b(che)-5 b(cking:)39 b Fm(If)29 b │ │ │ │ │ -Fl(frontmtx)d Fm(is)j Fl(NULL)p Fm(,)f(or)h(if)g Fl(msglvl)e │ │ │ │ │ -Fm(>)i(0)g(and)f Fl(msgFile)f Fm(is)i Fl(NULL)p Fm(,)f(an)g(error)h │ │ │ │ │ -(message)227 1344 y(is)i(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fm(16)p 182 100 1035 │ │ │ │ │ +4 v 1217 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,) │ │ │ │ │ +h(2024)p 2866 100 V 0 399 a Fb(1.2.8)112 b(P)m(ostpro)s(cessing)38 │ │ │ │ │ +b(metho)s(ds)111 594 y Fm(1.)46 b Fl(void)h(FrontMtx_postProcess)42 │ │ │ │ │ +b(\()48 b(FrontMtx)d(*frontmtx,)g(int)i(msglvl,)f(FILE)h(*msgFile)e(\)) │ │ │ │ │ +j(;)227 743 y Fm(This)31 b(metho)s(d)g(do)s(es)g(p)s(ost-pro)s(cessing) │ │ │ │ │ +g(c)m(hores)i(after)f(the)f(factorization)k(is)c(complete.)46 │ │ │ │ │ +b(If)31 b(piv)m(oting)i(w)m(as)227 856 y(enabled,)25 │ │ │ │ │ +b(the)f(metho)s(d)f(p)s(erm)m(utes)g(the)h(ro)m(w)g(and)f(column)g │ │ │ │ │ +(adjacency)i(ob)5 b(jects,)26 b(p)s(erm)m(utes)d(the)h(lo)m(w)m(er)h │ │ │ │ │ +(and)227 969 y(upp)s(er)36 b(matrices,)41 b(and)c(up)s(dates)g(the)h │ │ │ │ │ +(blo)s(c)m(k)h(adjacency)f(ob)5 b(jects.)64 b(The)38 │ │ │ │ │ +b(c)m(hevron)g(submatrices)g Fk(L)3746 984 y Fj(@)t(J)5 │ │ │ │ │ +b(;J)227 1082 y Fm(and)30 b Fk(U)466 1097 y Fj(J)n(;@)t(J)643 │ │ │ │ │ +1082 y Fm(are)h(split)f(in)m(to)i Fk(L)1244 1096 y Fj(K)q(;J)1403 │ │ │ │ │ +1082 y Fm(and)d Fk(U)1641 1096 y Fj(J)n(;K)1797 1082 │ │ │ │ │ +y Fm(where)h Fk(K)c Fg(\\)20 b Fk(@)5 b(J)35 b Fg(6)p │ │ │ │ │ +Fm(=)25 b Fg(;)p Fm(.)227 1231 y Fh(Err)-5 b(or)33 b(che)-5 │ │ │ │ │ +b(cking:)39 b Fm(If)29 b Fl(frontmtx)d Fm(is)j Fl(NULL)p │ │ │ │ │ +Fm(,)f(or)h(if)g Fl(msglvl)e Fm(>)i(0)g(and)f Fl(msgFile)f │ │ │ │ │ +Fm(is)i Fl(NULL)p Fm(,)f(an)g(error)h(message)227 1344 │ │ │ │ │ +y(is)i(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ 1530 y(2.)46 b Fl(void)h(FrontMtx_permuteUpperAdj)41 │ │ │ │ │ b(\()48 b(FrontMtx)d(*frontmtx,)1755 1642 y(int)h(msglvl,)g(FILE)h │ │ │ │ │ (*msgFile)e(\))j(;)227 1755 y(void)f(FrontMtx_permuteLowerAdj)41 │ │ │ │ │ b(\()48 b(FrontMtx)d(*frontmtx,)1755 1868 y(int)h(msglvl,)g(FILE)h │ │ │ │ │ (*msgFile)e(\))j(;)227 2018 y Fm(These)28 b(metho)s(ds)g(are)h(called)g │ │ │ │ │ (during)e(the)i(p)s(ostpro)s(cessing)f(step,)h(where)e(they)i(p)s(erm)m │ │ │ │ │ (ute)f(the)g(upp)s(er)f(and)227 2130 y(lo)m(w)m(er)34 │ │ │ │ │ @@ -6320,17 +6311,17 @@ │ │ │ │ │ (all)h(the)g(solv)m(e)h(metho)s(ds)d(|)h(serial,)i(m)m(ultithreaded)e │ │ │ │ │ (and)g(MPI.)111 5181 y(1.)46 b Fl(SubMtx)g(**)i │ │ │ │ │ (FrontMtx_loadRightHandS)o(ide)41 b(\()48 b(FrontMtx)d(*frontmtx,)g │ │ │ │ │ (DenseMtx)h(*mtxB,)1277 5294 y(int)h(owners[],)e(int)i(myid,)g │ │ │ │ │ (SubMtxManager)d(*mtxmanager,)1277 5407 y(int)j(msglvl,)f(FILE)h │ │ │ │ │ (*msgFile)e(\))j(;)p eop end │ │ │ │ │ %%Page: 17 17 │ │ │ │ │ -TeXDict begin 17 16 bop 91 100 1016 4 v 1197 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2792 100 V 1016 w Fm(17)227 399 y(This)d(metho)s(d)g(creates)h(and)f │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1035 4 v 1216 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2773 100 V 1035 w Fm(17)227 399 y(This)d(metho)s(d)g(creates)h(and)f │ │ │ │ │ (returns)f(a)i(v)m(ector)h(of)f(p)s(oin)m(ters)f(to)h │ │ │ │ │ Fl(SubMtx)e Fm(ob)5 b(jects)29 b(that)g(hold)f(p)s(oin)m(ters)g(to)227 │ │ │ │ │ 511 y(the)j(righ)m(t)g(hand)e(side)h(submatrices)h(o)m(wned)f(b)m(y)g │ │ │ │ │ (the)h(thread)f(or)g(pro)s(cessor.)227 671 y Fh(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fm(None)31 b(presen)m(tly)-8 │ │ │ │ │ b(.)111 878 y(2.)46 b Fl(void)h(FrontMtx_forwardVisit)42 │ │ │ │ │ b(\()47 b(FrontMtx)f(*frontmtx,)f(int)i(J,)g(int)g(nrhs,)370 │ │ │ │ │ @@ -6398,51 +6389,50 @@ │ │ │ │ │ 5261 y Fj(J)578 5247 y Fm(:=)c Fk(Z)762 5261 y Fj(J)831 │ │ │ │ │ 5247 y Fg(\000)20 b Fk(U)984 5261 y Fj(J)n(;K)1109 5247 │ │ │ │ │ y Fk(X)1184 5261 y Fj(K)1283 5247 y Fm(that)31 b(will)f(b)s(e)g(p)s │ │ │ │ │ (erformed)f(b)m(y)h(this)g(thread)h(or)f(pro)s(cessor.)227 │ │ │ │ │ 5407 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fm(None)31 │ │ │ │ │ b(presen)m(tly)-8 b(.)p eop end │ │ │ │ │ %%Page: 18 18 │ │ │ │ │ -TeXDict begin 18 17 bop 0 100 a Fm(18)p 182 100 1016 │ │ │ │ │ -4 v 1198 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2885 100 V 111 399 a Fm(8.)46 │ │ │ │ │ -b Fl(void)h(FrontMtx_loadActiveRoots)41 b(\()48 b(FrontMtx)d │ │ │ │ │ -(*frontmtx,)g(char)i(status[],)1755 511 y(char)f(activeFlag,)f(Ideq)i │ │ │ │ │ -(*dequeue)e(\))j(;)227 660 y Fm(This)43 b(metho)s(d)f(loads)i(the)g │ │ │ │ │ -(activ)m(e)h(ro)s(ots)f(for)f(a)g(thread)g(or)h(a)f(pro)s(cessor)g(in)m │ │ │ │ │ -(to)h(the)g(dequeue)f(for)g(the)227 773 y(bac)m(kw)m(ard)31 │ │ │ │ │ -b(solv)m(e.)227 921 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ -b Fm(None)31 b(presen)m(tly)-8 b(.)0 1186 y Fb(1.2.10)113 │ │ │ │ │ -b(Serial)38 b(Solv)m(e)g(metho)s(d)111 1380 y Fm(1.)46 │ │ │ │ │ -b Fl(void)h(FrontMtx_solve)d(\()j(FrontMtx)f(*frontmtx,)f(DenseMtx)g │ │ │ │ │ -(*mtxX,)h(DenseMtx)g(*mtxB,)657 1493 y(SubMtxManager)e(*mtxmanager,)g │ │ │ │ │ -(double)j(cpus[],)e(int)i(msglvl,)f(FILE)h(*msgFile)e(\))j(;)227 │ │ │ │ │ -1642 y Fm(This)24 b(metho)s(d)f(is)h(used)g(to)h(solv)m(e)g(one)g(of)f │ │ │ │ │ -(three)h(linear)f(systems)g(of)h(equations)g(|)f(\()p │ │ │ │ │ -Fk(U)3144 1609 y Fj(T)3207 1642 y Fm(+)8 b Fk(I)f Fm(\))p │ │ │ │ │ -Fk(D)s Fm(\()p Fk(I)15 b Fm(+)8 b Fk(U)i Fm(\))p Fk(X)32 │ │ │ │ │ -b Fm(=)227 1755 y Fk(B)5 b Fm(,)28 b(\()p Fk(U)461 1722 │ │ │ │ │ -y Fj(H)542 1755 y Fm(+)14 b Fk(I)7 b Fm(\))p Fk(D)s Fm(\()p │ │ │ │ │ -Fk(I)21 b Fm(+)14 b Fk(U)c Fm(\))p Fk(X)33 b Fm(=)25 │ │ │ │ │ -b Fk(B)32 b Fm(or)27 b(\()p Fk(L)14 b Fm(+)g Fk(I)7 b │ │ │ │ │ -Fm(\))p Fk(D)s Fm(\()p Fk(I)21 b Fm(+)14 b Fk(U)c Fm(\))p │ │ │ │ │ -Fk(X)33 b Fm(=)25 b Fk(B)5 b Fm(.)39 b(En)m(tries)27 │ │ │ │ │ -b(of)h Fk(B)j Fm(are)d Fh(r)-5 b(e)g(ad)29 b Fm(from)d │ │ │ │ │ -Fl(mtxB)h Fm(and)227 1867 y(en)m(tries)34 b(of)f Fk(X)40 │ │ │ │ │ -b Fm(are)33 b(written)g(to)h Fl(mtxX)p Fm(.)e(Therefore,)h │ │ │ │ │ -Fl(mtxX)f Fm(and)g Fl(mtxB)g Fm(can)h(b)s(e)g(the)g(same)g(ob)5 │ │ │ │ │ -b(ject.)49 b(\(Note,)227 1980 y(this)41 b(do)s(es)g(not)h(hold)e(true)h │ │ │ │ │ -(for)g(an)g(MPI)h(factorization)h(with)e(piv)m(oting.\))75 │ │ │ │ │ -b(The)41 b Fl(mtxmanager)d Fm(ob)5 b(ject)227 2093 y(manages)32 │ │ │ │ │ -b(the)g(w)m(orking)f(storage)i(using)e(the)g(solv)m(e.)44 │ │ │ │ │ -b(On)31 b(return)f(the)h Fl(cpus[])f Fm(v)m(ector)j(is)e(\014lled)g │ │ │ │ │ -(with)g(the)227 2206 y(follo)m(wing.)337 2390 y Fi(\210)45 │ │ │ │ │ -b Fl(cpus[0])29 b Fm(|)h(set)h(up)e(the)i(solv)m(es)337 │ │ │ │ │ -2532 y Fi(\210)45 b Fl(cpus[1])29 b Fm(|)h(fetc)m(h)h(righ)m(t)g(hand)e │ │ │ │ │ -(side)i(and)e(store)i(solution)337 2675 y Fi(\210)45 │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fm(18)p 182 100 1035 │ │ │ │ │ +4 v 1217 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,) │ │ │ │ │ +h(2024)p 2866 100 V 111 399 a Fm(8.)46 b Fl(void)h │ │ │ │ │ +(FrontMtx_loadActiveRoots)41 b(\()48 b(FrontMtx)d(*frontmtx,)g(char)i │ │ │ │ │ +(status[],)1755 511 y(char)f(activeFlag,)f(Ideq)i(*dequeue)e(\))j(;)227 │ │ │ │ │ +660 y Fm(This)43 b(metho)s(d)f(loads)i(the)g(activ)m(e)h(ro)s(ots)f │ │ │ │ │ +(for)f(a)g(thread)g(or)h(a)f(pro)s(cessor)g(in)m(to)h(the)g(dequeue)f │ │ │ │ │ +(for)g(the)227 773 y(bac)m(kw)m(ard)31 b(solv)m(e.)227 │ │ │ │ │ +921 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fm(None)31 │ │ │ │ │ +b(presen)m(tly)-8 b(.)0 1186 y Fb(1.2.10)113 b(Serial)38 │ │ │ │ │ +b(Solv)m(e)g(metho)s(d)111 1380 y Fm(1.)46 b Fl(void)h(FrontMtx_solve)d │ │ │ │ │ +(\()j(FrontMtx)f(*frontmtx,)f(DenseMtx)g(*mtxX,)h(DenseMtx)g(*mtxB,)657 │ │ │ │ │ +1493 y(SubMtxManager)e(*mtxmanager,)g(double)j(cpus[],)e(int)i(msglvl,) │ │ │ │ │ +f(FILE)h(*msgFile)e(\))j(;)227 1642 y Fm(This)24 b(metho)s(d)f(is)h │ │ │ │ │ +(used)g(to)h(solv)m(e)g(one)g(of)f(three)h(linear)f(systems)g(of)h │ │ │ │ │ +(equations)g(|)f(\()p Fk(U)3144 1609 y Fj(T)3207 1642 │ │ │ │ │ +y Fm(+)8 b Fk(I)f Fm(\))p Fk(D)s Fm(\()p Fk(I)15 b Fm(+)8 │ │ │ │ │ +b Fk(U)i Fm(\))p Fk(X)32 b Fm(=)227 1755 y Fk(B)5 b Fm(,)28 │ │ │ │ │ +b(\()p Fk(U)461 1722 y Fj(H)542 1755 y Fm(+)14 b Fk(I)7 │ │ │ │ │ +b Fm(\))p Fk(D)s Fm(\()p Fk(I)21 b Fm(+)14 b Fk(U)c Fm(\))p │ │ │ │ │ +Fk(X)33 b Fm(=)25 b Fk(B)32 b Fm(or)27 b(\()p Fk(L)14 │ │ │ │ │ +b Fm(+)g Fk(I)7 b Fm(\))p Fk(D)s Fm(\()p Fk(I)21 b Fm(+)14 │ │ │ │ │ +b Fk(U)c Fm(\))p Fk(X)33 b Fm(=)25 b Fk(B)5 b Fm(.)39 │ │ │ │ │ +b(En)m(tries)27 b(of)h Fk(B)j Fm(are)d Fh(r)-5 b(e)g(ad)29 │ │ │ │ │ +b Fm(from)d Fl(mtxB)h Fm(and)227 1867 y(en)m(tries)34 │ │ │ │ │ +b(of)f Fk(X)40 b Fm(are)33 b(written)g(to)h Fl(mtxX)p │ │ │ │ │ +Fm(.)e(Therefore,)h Fl(mtxX)f Fm(and)g Fl(mtxB)g Fm(can)h(b)s(e)g(the)g │ │ │ │ │ +(same)g(ob)5 b(ject.)49 b(\(Note,)227 1980 y(this)41 │ │ │ │ │ +b(do)s(es)g(not)h(hold)e(true)h(for)g(an)g(MPI)h(factorization)h(with)e │ │ │ │ │ +(piv)m(oting.\))75 b(The)41 b Fl(mtxmanager)d Fm(ob)5 │ │ │ │ │ +b(ject)227 2093 y(manages)32 b(the)g(w)m(orking)f(storage)i(using)e │ │ │ │ │ +(the)g(solv)m(e.)44 b(On)31 b(return)f(the)h Fl(cpus[])f │ │ │ │ │ +Fm(v)m(ector)j(is)e(\014lled)g(with)g(the)227 2206 y(follo)m(wing.)337 │ │ │ │ │ +2390 y Fi(\210)45 b Fl(cpus[0])29 b Fm(|)h(set)h(up)e(the)i(solv)m(es) │ │ │ │ │ +337 2532 y Fi(\210)45 b Fl(cpus[1])29 b Fm(|)h(fetc)m(h)h(righ)m(t)g │ │ │ │ │ +(hand)e(side)i(and)e(store)i(solution)337 2675 y Fi(\210)45 │ │ │ │ │ b Fl(cpus[2])29 b Fm(|)h(forw)m(ard)g(solv)m(e)337 2817 │ │ │ │ │ y Fi(\210)45 b Fl(cpus[3])29 b Fm(|)h(diagonal)i(solv)m(e)337 │ │ │ │ │ 2959 y Fi(\210)45 b Fl(cpus[4])29 b Fm(|)h(bac)m(kw)m(ard)h(solv)m(e) │ │ │ │ │ 337 3102 y Fi(\210)45 b Fl(cpus[5])29 b Fm(|)h(total)i(time)f(in)f(the) │ │ │ │ │ h(metho)s(d.)227 3285 y Fh(Err)-5 b(or)33 b(che)-5 b(cking:)39 │ │ │ │ │ b Fm(If)28 b Fl(frontmtx)p Fm(,)f Fl(mtxB)g Fm(or)i Fl(cpus)e │ │ │ │ │ Fm(is)i Fl(NULL)p Fm(,)e(or)i(if)f Fl(msglvl)f Fm(>)h(0)h(and)f │ │ │ │ │ @@ -6482,17 +6472,17 @@ │ │ │ │ │ b Fl(cpus[0])29 b Fm(|)h(set)h(up)e(the)i(solv)m(es)337 │ │ │ │ │ 5123 y Fi(\210)45 b Fl(cpus[1])29 b Fm(|)h(fetc)m(h)h(righ)m(t)g(hand)e │ │ │ │ │ (side)i(and)e(store)i(solution)337 5265 y Fi(\210)45 │ │ │ │ │ b Fl(cpus[2])29 b Fm(|)h(forw)m(ard)g(solv)m(e)337 5407 │ │ │ │ │ y Fi(\210)45 b Fl(cpus[3])29 b Fm(|)h(diagonal)i(solv)m(e)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 19 19 │ │ │ │ │ -TeXDict begin 19 18 bop 91 100 1016 4 v 1197 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2792 100 V 1016 w Fm(19)337 399 y Fi(\210)45 b Fl(cpus[4])29 │ │ │ │ │ +TeXDict begin 19 18 bop 91 100 1035 4 v 1216 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2773 100 V 1035 w Fm(19)337 399 y Fi(\210)45 b Fl(cpus[4])29 │ │ │ │ │ b Fm(|)h(bac)m(kw)m(ard)h(solv)m(e)337 551 y Fi(\210)45 │ │ │ │ │ b Fl(cpus[5])29 b Fm(|)h(total)i(time)f(in)f(the)h(solv)m(e)g(metho)s │ │ │ │ │ (d.)337 704 y Fi(\210)45 b Fl(cpus[6])29 b Fm(|)h(time)h(to)g(compute)g │ │ │ │ │ Fk(A)1668 671 y Fj(T)1723 704 y Fk(B)k Fm(or)30 b Fk(A)2006 │ │ │ │ │ 671 y Fj(H)2074 704 y Fk(B)5 b Fm(.)337 856 y Fi(\210)45 │ │ │ │ │ b Fl(cpus[7])29 b Fm(|)h(total)i(time.)227 1056 y Fh(Err)-5 │ │ │ │ │ b(or)31 b(che)-5 b(cking:)38 b Fm(If)26 b Fl(frontmtx)p │ │ │ │ │ @@ -6554,28 +6544,27 @@ │ │ │ │ │ b Fl(frontmtx)p Fm(,)g Fl(pnneg)p Fm(,)g Fl(pnzero)f │ │ │ │ │ Fm(or)h Fl(pnpos)f Fm(is)h Fl(NULL)p Fm(,)g(or)g(if)h │ │ │ │ │ Fl(symmetryflag)31 b Fg(6)p Fm(=)k(0)i(an)227 5207 y(error)30 │ │ │ │ │ b(message)i(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)111 │ │ │ │ │ 5407 y(5.)46 b Fl(int)h(FrontMtx_nSolveOps)c(\()k(FrontMtx)f(*frontmtx) │ │ │ │ │ f(\))j(;)p eop end │ │ │ │ │ %%Page: 20 20 │ │ │ │ │ -TeXDict begin 20 19 bop 0 100 a Fm(20)p 182 100 1016 │ │ │ │ │ -4 v 1198 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2885 100 V 227 399 a Fm(This)e(metho)s(d)g │ │ │ │ │ -(computes)g(and)g(return)f(the)i(n)m(um)m(b)s(er)e(of)h(\015oating)i(p) │ │ │ │ │ -s(oin)m(t)e(op)s(erations)h(for)f(a)h(solv)m(e)g(with)g(a)227 │ │ │ │ │ -511 y(single)h(righ)m(t)g(hand)f(side.)227 664 y Fh(Err)-5 │ │ │ │ │ -b(or)29 b(che)-5 b(cking:)37 b Fm(If)24 b Fl(frontmtx)e │ │ │ │ │ -Fm(is)i Fl(NULL)p Fm(,)g(or)g(if)g Fl(type)f Fm(or)i │ │ │ │ │ -Fl(symmetryflag)c Fm(are)j(in)m(v)-5 b(alid,)27 b(an)d(error)g(message) │ │ │ │ │ -227 777 y(is)31 b(prin)m(ted)f(and)f(the)i(program)f(exits.)0 │ │ │ │ │ -1053 y Fb(1.2.13)113 b(IO)37 b(metho)s(ds)111 1252 y │ │ │ │ │ -Fm(1.)46 b Fl(int)h(FrontMtx_readFromFile)42 b(\()48 │ │ │ │ │ -b(FrontMtx)d(*frontmtx,)g(char)i(*fn)g(\))g(;)227 1405 │ │ │ │ │ -y Fm(This)25 b(metho)s(d)g(reads)g(a)h Fl(FrontMtx)45 │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fm(20)p 182 100 1035 │ │ │ │ │ +4 v 1217 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,) │ │ │ │ │ +h(2024)p 2866 100 V 227 399 a Fm(This)e(metho)s(d)g(computes)g(and)g │ │ │ │ │ +(return)f(the)i(n)m(um)m(b)s(er)e(of)h(\015oating)i(p)s(oin)m(t)e(op)s │ │ │ │ │ +(erations)h(for)f(a)h(solv)m(e)g(with)g(a)227 511 y(single)h(righ)m(t)g │ │ │ │ │ +(hand)f(side.)227 664 y Fh(Err)-5 b(or)29 b(che)-5 b(cking:)37 │ │ │ │ │ +b Fm(If)24 b Fl(frontmtx)e Fm(is)i Fl(NULL)p Fm(,)g(or)g(if)g │ │ │ │ │ +Fl(type)f Fm(or)i Fl(symmetryflag)c Fm(are)j(in)m(v)-5 │ │ │ │ │ +b(alid,)27 b(an)d(error)g(message)227 777 y(is)31 b(prin)m(ted)f(and)f │ │ │ │ │ +(the)i(program)f(exits.)0 1053 y Fb(1.2.13)113 b(IO)37 │ │ │ │ │ +b(metho)s(ds)111 1252 y Fm(1.)46 b Fl(int)h(FrontMtx_readFromFile)42 │ │ │ │ │ +b(\()48 b(FrontMtx)d(*frontmtx,)g(char)i(*fn)g(\))g(;)227 │ │ │ │ │ +1405 y Fm(This)25 b(metho)s(d)g(reads)g(a)h Fl(FrontMtx)45 │ │ │ │ │ b(object)24 b Fm(from)h(a)h(\014le.)39 b(It)26 b(tries)g(to)g(op)s(en)e │ │ │ │ │ (the)i(\014le)g(and)f(if)g(it)h(is)f(success-)227 1518 │ │ │ │ │ y(ful,)g(it)f(then)g(calls)h Fl(FrontMtx)p 1252 1518 │ │ │ │ │ 29 4 v 32 w(readFromFormattedFile\(\))17 b Fm(or)24 b │ │ │ │ │ Fl(FrontMtx)p 2894 1518 V 32 w(readFromBinaryFile\(\))p │ │ │ │ │ Fm(,)227 1631 y(closes)32 b(the)e(\014le)h(and)f(returns)f(the)h(v)-5 │ │ │ │ │ b(alue)31 b(returned)e(from)h(the)h(called)g(routine.)227 │ │ │ │ │ @@ -6641,17 +6630,17 @@ │ │ │ │ │ b Fl(1)f Fm(is)g(returned.)40 b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m │ │ │ │ │ (tered)h(from)f Fl(fwrite)p Fm(,)f(zero)i(is)g(returned.)227 │ │ │ │ │ 5407 y Fh(Err)-5 b(or)33 b(che)-5 b(cking:)40 b Fm(If)28 │ │ │ │ │ b Fl(frontmtx)f Fm(or)i Fl(fp)g Fm(are)g Fl(NULL)f Fm(an)h(error)g │ │ │ │ │ (message)h(is)f(prin)m(ted)f(and)h(zero)h(is)f(returned.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 21 21 │ │ │ │ │ -TeXDict begin 21 20 bop 91 100 1016 4 v 1197 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2792 100 V 1016 w Fm(21)111 399 y(7.)46 b Fl(int)h │ │ │ │ │ +TeXDict begin 21 20 bop 91 100 1035 4 v 1216 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2773 100 V 1035 w Fm(21)111 399 y(7.)46 b Fl(int)h │ │ │ │ │ (FrontMtx_writeForHumanEye)41 b(\()48 b(FrontMtx)d(*frontmtx,)g(FILE)i │ │ │ │ │ (*fp)g(\))g(;)227 547 y Fm(This)36 b(metho)s(d)g(writes)h(a)g │ │ │ │ │ Fl(FrontMtx)d Fm(ob)5 b(ject)37 b(to)g(a)g(\014le)g(in)f(a)h(h)m(uman)f │ │ │ │ │ (readable)h(format.)59 b(The)36 b(metho)s(d)227 660 y │ │ │ │ │ Fl(FrontMtx)p 617 660 29 4 v 32 w(writeStats\(\))41 b │ │ │ │ │ Fm(is)i(called)i(to)f(write)g(out)f(the)h(header)f(and)g(statistics.)82 │ │ │ │ │ b(The)43 b(v)-5 b(alue)44 b Fl(1)f Fm(is)227 773 y(returned.)227 │ │ │ │ │ @@ -6714,23 +6703,23 @@ │ │ │ │ │ 4980 y Fm(metho)s(d.)337 5122 y Fi(\210)45 b Fm(The)30 │ │ │ │ │ b Fl(seed)f Fm(parameter)i(is)g(a)f(random)g(n)m(um)m(b)s(er)f(seed.) │ │ │ │ │ 337 5265 y Fi(\210)45 b Fm(The)30 b Fl(type)f Fm(parameter)i(sp)s │ │ │ │ │ (eci\014es)f(a)h(real)g(or)f(complex)h(linear)g(system.)500 │ │ │ │ │ 5407 y Fe({)45 b Fl(type)i(=)g(1)h(\(SPOOLES)p 1417 5407 │ │ │ │ │ V 32 w(REAL\))29 b Fm(for)h(real,)p eop end │ │ │ │ │ %%Page: 22 22 │ │ │ │ │ -TeXDict begin 22 21 bop 0 100 a Fm(22)p 182 100 1016 │ │ │ │ │ -4 v 1198 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2885 100 V 500 399 a Fe({)45 │ │ │ │ │ -b Fl(type)i(=)g(2)h(\(SPOOLES)p 1417 399 29 4 v 32 w(COMPLEX\))28 │ │ │ │ │ -b Fm(for)i(complex.)337 544 y Fi(\210)45 b Fm(The)30 │ │ │ │ │ -b Fl(symmetryflag)d Fm(parameter)k(sp)s(eci\014es)f(the)h(symmetry)f │ │ │ │ │ -(of)g(the)h(matrix.)500 690 y Fe({)45 b Fl(type)i(=)g(0)h(\(SPOOLES)p │ │ │ │ │ -1417 690 V 32 w(SYMMETRIC\))28 b Fm(for)i Fk(A)g Fm(real)h(or)g │ │ │ │ │ -(complex)g(symmetric,)500 820 y Fe({)45 b Fl(type)i(=)g(1)h(\(SPOOLES)p │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fm(22)p 182 100 1035 │ │ │ │ │ +4 v 1217 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Jan)m(uary)g(7,) │ │ │ │ │ +h(2024)p 2866 100 V 500 399 a Fe({)45 b Fl(type)i(=)g(2)h(\(SPOOLES)p │ │ │ │ │ +1417 399 29 4 v 32 w(COMPLEX\))28 b Fm(for)i(complex.)337 │ │ │ │ │ +544 y Fi(\210)45 b Fm(The)30 b Fl(symmetryflag)d Fm(parameter)k(sp)s │ │ │ │ │ +(eci\014es)f(the)h(symmetry)f(of)g(the)h(matrix.)500 │ │ │ │ │ +690 y Fe({)45 b Fl(type)i(=)g(0)h(\(SPOOLES)p 1417 690 │ │ │ │ │ +V 32 w(SYMMETRIC\))28 b Fm(for)i Fk(A)g Fm(real)h(or)g(complex)g │ │ │ │ │ +(symmetric,)500 820 y Fe({)45 b Fl(type)i(=)g(1)h(\(SPOOLES)p │ │ │ │ │ 1417 820 V 32 w(HERMITIAN\))28 b Fm(for)i Fk(A)g Fm(complex)h │ │ │ │ │ (Hermitian,)500 949 y Fe({)45 b Fl(type)i(=)g(2)h(\(SPOOLES)p │ │ │ │ │ 1417 949 V 32 w(NONSYMMETRIC\))427 1095 y Fm(for)30 b │ │ │ │ │ Fk(A)h Fm(real)g(or)f(complex)h(nonsymmetric.)337 1241 │ │ │ │ │ y Fi(\210)45 b Fm(The)30 b Fl(sparsityflag)d Fm(parameter)k(signals)g │ │ │ │ │ (a)g(direct)g(or)f(appro)m(ximate)h(factorization.)500 │ │ │ │ │ 1387 y Fe({)45 b Fl(sparsityflag)g(=)i(0)h(\(FRONTMTX)p │ │ │ │ │ @@ -6794,17 +6783,17 @@ │ │ │ │ │ 5115 y Fi(\210)45 b Fl(n2)30 b Fm(is)g(the)h(n)m(um)m(b)s(er)e(of)i(p)s │ │ │ │ │ (oin)m(ts)f(in)g(the)g(second)h(grid)f(direction.)337 │ │ │ │ │ 5261 y Fi(\210)45 b Fl(n3)30 b Fm(is)g(the)h(n)m(um)m(b)s(er)e(of)i(p)s │ │ │ │ │ (oin)m(ts)f(in)g(the)g(third)g(grid)g(direction.)337 │ │ │ │ │ 5407 y Fi(\210)45 b Fm(The)30 b Fl(seed)f Fm(parameter)i(is)g(a)f │ │ │ │ │ (random)g(n)m(um)m(b)s(er)f(seed.)p eop end │ │ │ │ │ %%Page: 23 23 │ │ │ │ │ -TeXDict begin 23 22 bop 91 100 1016 4 v 1197 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2792 100 V 1016 w Fm(23)337 399 y Fi(\210)45 b Fm(The)30 │ │ │ │ │ +TeXDict begin 23 22 bop 91 100 1035 4 v 1216 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2773 100 V 1035 w Fm(23)337 399 y Fi(\210)45 b Fm(The)30 │ │ │ │ │ b Fl(nrhs)f Fm(parameter)i(is)g(the)f(n)m(um)m(b)s(er)f(of)i(righ)m(t)g │ │ │ │ │ (hand)e(sides)h(to)h(solv)m(e)h(as)f(one)f(blo)s(c)m(k.)337 │ │ │ │ │ 545 y Fi(\210)45 b Fm(The)30 b Fl(type)f Fm(parameter)i(sp)s(eci\014es) │ │ │ │ │ f(a)h(real)g(or)f(complex)h(linear)g(system.)500 691 │ │ │ │ │ y Fe({)45 b Fl(type)i(=)g(1)h(\(SPOOLES)p 1417 691 29 │ │ │ │ │ 4 v 32 w(REAL\))29 b Fm(for)h(real,)500 820 y Fe({)45 │ │ │ │ │ b Fl(type)i(=)g(2)h(\(SPOOLES)p 1417 820 V 32 w(COMPLEX\))28 │ │ │ │ │ @@ -6894,16 +6883,16 @@ │ │ │ │ │ Fm(,)i(9)1992 5064 y Fl(FrontMtx)p 2382 5064 V 32 w │ │ │ │ │ (writeForHumanEye\(\))p Fm(,)d(20)1992 5178 y Fl(FrontMtx)p │ │ │ │ │ 2382 5178 V 32 w(writeStats\(\))p Fm(,)i(21)1992 5293 │ │ │ │ │ y Fl(FrontMtx)p 2382 5293 V 32 w(writeToBinaryFile\(\))p │ │ │ │ │ Fm(,)e(20)1992 5407 y Fl(FrontMtx)p 2382 5407 V 32 w(writeToFile\(\))p │ │ │ │ │ Fm(,)i(20)1905 5656 y(24)p eop end │ │ │ │ │ %%Page: 25 25 │ │ │ │ │ -TeXDict begin 25 24 bop 91 100 1016 4 v 1197 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2792 100 V 1016 w Fm(25)0 399 y Fl(FrontMtx)p 390 399 │ │ │ │ │ +TeXDict begin 25 24 bop 91 100 1035 4 v 1216 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2773 100 V 1035 w Fm(25)0 399 y Fl(FrontMtx)p 390 399 │ │ │ │ │ 29 4 v 32 w(writeToFormattedFile\(\))p Fm(,)25 b(20)p │ │ │ │ │ eop end │ │ │ │ │ %%Trailer │ │ │ │ │ │ │ │ │ │ userdict /end-hook known{end-hook}if │ │ │ │ │ %%EOF │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -23,15 +23,15 @@ │ │ │ │ │ │ are disjoint. P is a permutation matrix. If pivoting is not used, P is the identity. │ │ │ │ │ │ 2. (A + σB) = P(L + I)D(I + U)QT for a square nonsymmetric matrix A with symmetric │ │ │ │ │ │ structure. D is a diagonal matrix. U is strictly upper triangular. L is strictly lower triangular. │ │ │ │ │ │ P and Q are permutation matrices. If pivoting is not used, P and Q are the identity. │ │ │ │ │ │ 3. A = QR for square or rectangular A. Q is an orthogonal matrix that is not explicitly │ │ │ │ │ │ computed or stored. R is upper triangular. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ The factorization is performed using a one dimensional decomposition of the global sparse │ │ │ │ │ │ matrix. A typical front of the matrix is found the shaded portion of the figure below. │ │ │ │ │ │ Afront is indivisible, it is found on one processor, and one processor or one thread is responsible │ │ │ │ │ │ for its internal computations. This is extremely important if we want to support pivoting for │ │ │ │ │ │ stability, for deciding how to choose the pivot elements in the front requires continuous up-to- │ │ │ │ │ │ date information about all the entries in the front. If a front were partitioned among threads or │ │ │ │ │ │ processors, the cost of the communication to select pivot elements would be intolerable. │ │ │ │ │ │ @@ -56,15 +56,15 @@ │ │ │ │ │ │ • The linear combination A+σB is found in a Pencil object. │ │ │ │ │ │ • The ETree object contains the front tree that governs the factorization and solve. Inside │ │ │ │ │ │ this object are the dimensions of each front (the number of internal and external rows and │ │ │ │ │ │ columns), the tree connectivity of the fronts, and a map from each vertex to the front that │ │ │ │ │ │ contains it as an internal row and column. The FrontMtx object contains a pointer to an │ │ │ │ │ │ ETree object, but it does not modify the object, nor does it own the storage for the ETree │ │ │ │ │ │ object. Thus multiple front matrices can all point to the same ETree object simultaneously. │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 3 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 3 │ │ │ │ │ │ • An IVL object (Integer Vector List), contains the symbolic factorization. For each front, it │ │ │ │ │ │ gives the list of internal and external rows and columns, used to initialize a front prior to its │ │ │ │ │ │ factorization. For a factorization without pivoting, this object stores the index information │ │ │ │ │ │ for the factors, and so is used during the forward and backsolves. For a factorization with │ │ │ │ │ │ pivoting, the index information for a front may change, so this object is not used during the │ │ │ │ │ │ solves. As for the ETree object, the symbolic factorization is neither modified or owned by │ │ │ │ │ │ the front matrix object. │ │ │ │ │ │ @@ -96,15 +96,15 @@ │ │ │ │ │ │ postponed data (when pivoting is enabled) or aggregate data (in a parallel factorization), and │ │ │ │ │ │ the factorization of the fully assembled front, take place within the context of this object. │ │ │ │ │ │ • The SubMtx object is used to store a submatrix of the factor matrices D, L and U. Once a │ │ │ │ │ │ front is factored it is split into one or more of these submatrix objects. After the factorization │ │ │ │ │ │ is complete, the data structures are postprocessed to yield submatrices that contain the │ │ │ │ │ │ coupling between fronts. The working storage during the solves is also managed by SubMtx │ │ │ │ │ │ objects. │ │ │ │ │ │ - 4 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ • Each submatrix represents the coupling between two fronts, I and J. To enable rapid random │ │ │ │ │ │ access to these submatrices, we use a I2Ohash object that is a hash table whose keys are two │ │ │ │ │ │ integers and whose data is a void * pointer. │ │ │ │ │ │ • The set of nonzero submatrices, i.e., the nonzero couplings between two fronts, is kept in │ │ │ │ │ │ one or two IVL objects. This information is necessary for the factorization and forward and │ │ │ │ │ │ backsolves. │ │ │ │ │ │ • The factorization and solves require lists of fronts and submatrices to manage assembly of │ │ │ │ │ │ @@ -131,15 +131,15 @@ │ │ │ │ │ │ • int pivotingflag : flag to specify pivoting for stability, │ │ │ │ │ │ – SPOOLES NO PIVOTING — pivoting not used │ │ │ │ │ │ – SPOOLES PIVOTING — pivoting used │ │ │ │ │ │ • int sparsityflag : flag to specify storage of factors. │ │ │ │ │ │ – 0 — each front is dense │ │ │ │ │ │ – 1 — a front may be sparse due to entries dropped because they are below a drop │ │ │ │ │ │ tolerance. │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 5 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 5 │ │ │ │ │ │ • int dataMode : flag to specify data storage. │ │ │ │ │ │ – 1 — one-dimensional, used during the factorization. │ │ │ │ │ │ – 2 — two-dimensional, used during the solves. │ │ │ │ │ │ • int nentD : number of entries in D │ │ │ │ │ │ • int nentL : number of entries in L │ │ │ │ │ │ • int nentU : number of entries in U │ │ │ │ │ │ • Tree *tree: Treeobjectthatholdsthetreeoffronts. Note, normallythisisfrontETree->tree, │ │ │ │ │ │ @@ -165,15 +165,15 @@ │ │ │ │ │ │ used only during a nonsymmetric factorization. │ │ │ │ │ │ • SubMtx **p mtxLNJ : a vector of pointers to submatrices in L that are off the block diagonal, │ │ │ │ │ │ used only during a nonsymmetric factorization. │ │ │ │ │ │ • I2Ohash *lowerhash : pointer to a I2Ohash hash table for submatrices in L, used during │ │ │ │ │ │ the solves. │ │ │ │ │ │ • I2Ohash *upperhash : pointer to a I2Ohash hash table for submatrices in U, used during │ │ │ │ │ │ the solves. │ │ │ │ │ │ - 6 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ • SubMtxManager *manager : pointer to an object that manages the instances of submatrices │ │ │ │ │ │ during the factors and solves. │ │ │ │ │ │ • Lock *lock : pointer to a Lock lock used in a multithreaded environment to ensure exlusive │ │ │ │ │ │ access while allocating storage in the IV and IVL objects. This is not used in a serial or MPI │ │ │ │ │ │ environment. │ │ │ │ │ │ • int nlocks : number of times the lock has been locked. │ │ │ │ │ │ • PatchAndGo *info : this is a pointer to an object that is used by the Chv object during the │ │ │ │ │ │ @@ -196,15 +196,15 @@ │ │ │ │ │ │ • FRONTMTX IS 1D MODE(frontmtx) is 1 if the factor are still stored as a one-dimensional data │ │ │ │ │ │ decomposition (i.e., the matrix has not yet been post-processed), and 0 otherwise. │ │ │ │ │ │ • FRONTMTX IS 2D MODE(frontmtx) is 1 if the factor are stored as a two-dimensional data │ │ │ │ │ │ decomposition (i.e., the matrix has been post-processed), and 0 otherwise. │ │ │ │ │ │ 1.2 Prototypes and descriptions of FrontMtx methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ FrontMtx object. │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 7 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 7 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. FrontMtx * FrontMtx_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the FrontMtx structure and then sets the default │ │ │ │ │ │ fields by a call to FrontMtx setDefaultFields(). │ │ │ │ │ │ 2. void FrontMtx_setDefaultFields ( FrontMtx *frontmtx ) ; │ │ │ │ │ │ @@ -231,15 +231,15 @@ │ │ │ │ │ │ 1.2.2 Instance methods │ │ │ │ │ │ 1. int FrontMtx_nfront ( FrontMtx *frontmtx ) ; │ │ │ │ │ │ This method returns the number of fronts in the matrix. │ │ │ │ │ │ Error checking: If frontmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. int FrontMtx_neqns ( FrontMtx *frontmtx ) ; │ │ │ │ │ │ This method returns the number of equations in the matrix. │ │ │ │ │ │ Error checking: If frontmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 8 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 3. Tree * FrontMtx_frontTree ( FrontMtx *frontmtx ) ; │ │ │ │ │ │ This method returns the Tree object for the fronts. │ │ │ │ │ │ Error checking: If frontmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void FrontMtx_initialFrontDimensions ( FrontMtx *frontmtx, int J, │ │ │ │ │ │ int *pnD, int *pnL, int *pnU, int *pnbytes ) ; │ │ │ │ │ │ This method fills the four pointer arguments with the number of internal rows and columns, │ │ │ │ │ │ number of rows in the lower block, number of columns in the upper block, and number of │ │ │ │ │ │ @@ -269,15 +269,15 @@ │ │ │ │ │ │ Error checking: If frontmtx, pnrow or pindices is NULL, or if J is not in [0,nfront), an │ │ │ │ │ │ error message is printed and the program exits. │ │ │ │ │ │ 9. SubMtx * FrontMtx_diagMtx ( FrontMtx *frontmtx, int J ) ; │ │ │ │ │ │ This method returns a pointer to the object that contains submatrix D . │ │ │ │ │ │ J,J │ │ │ │ │ │ Error checking: If frontmtx is NULL, or if J is not in [0,nfront), an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 9 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 9 │ │ │ │ │ │ 10. SubMtx * FrontMtx_upperMtx ( FrontMtx *frontmtx, int J, int K ) ; │ │ │ │ │ │ This method returns a pointer to the object that contains submatrix UJ,K. If K = nfront, │ │ │ │ │ │ then the object containing UJ,∂J is returned. │ │ │ │ │ │ Error checking: If frontmtx is NULL, or if J is not in [0,nfront), or if K is not in [0,nfront], │ │ │ │ │ │ an error message is printed and the program exits. │ │ │ │ │ │ 11. SubMtx * FrontMtx_lowerMtx ( FrontMtx *frontmtx, int K, int J ) ; │ │ │ │ │ │ This method returns a pointer to the object that contains submatrix LK,J. If K = nfront, │ │ │ │ │ │ @@ -304,15 +304,15 @@ │ │ │ │ │ │ Error checking: If frontmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 16. IVL * FrontMtx_upperBlockIVL ( FrontMtx *frontmtx ) ; │ │ │ │ │ │ This method returns a pointer to the IVL object that holds the upper blocks. │ │ │ │ │ │ Error checking: If frontmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 17. IVL * FrontMtx_lowerBlockIVL ( FrontMtx *frontmtx ) ; │ │ │ │ │ │ This method returns a pointer to the IVL object that holds the lower blocks. │ │ │ │ │ │ Error checking: If frontmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 10 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.3 Initialization methods │ │ │ │ │ │ 1. void FrontMtx_init ( FrontMtx *frontmtx, ETree *frontETree, │ │ │ │ │ │ IVL *symbfacIVL, int type, int symmetryflag, int sparsityflag, │ │ │ │ │ │ int pivotingflag, int lockflag, int myid, IV *ownersIV, │ │ │ │ │ │ SubMtxManager *manager, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method initializes the object, allocating and initializing the internal objects as necessary. │ │ │ │ │ │ See the previous section on data structures for the meanings of the type, symmetryflag, │ │ │ │ │ │ @@ -342,15 +342,15 @@ │ │ │ │ │ │ 1. void FrontMtx_initializeFront ( FrontMtx *frontmtx, Chv *frontJ, int J ) ; │ │ │ │ │ │ This method is called to initialize a front. The number of internal rows and columns is found │ │ │ │ │ │ from the front ETree object and the row and column indices are obtained from the symbolic │ │ │ │ │ │ factorization IVL object. The front Chv object is initialized via a call to Chv init(), and the │ │ │ │ │ │ column indices and row indices (when nonsymemtric) are copied. Finally the front’s entries │ │ │ │ │ │ are zeroed via a call to Chv zero(). │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 11 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 11 │ │ │ │ │ │ 2. char FrontMtx_factorVisit ( FrontMtx *frontmtx, Pencil *pencil, int J, │ │ │ │ │ │ int myid, int owners[], Chv *fronts[], int lookahead, double tau, │ │ │ │ │ │ double droptol, char status[], IP *heads[], IV *pivotsizesIV, DV *workDV, │ │ │ │ │ │ int parent[], ChvList *aggList, ChvList *postList, ChvManager *chvmanager, │ │ │ │ │ │ int stats[], double cpus[], int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method is called during the serial, multithreaded and MPI factorizations when front J │ │ │ │ │ │ is visited during the bottom-up traversal of the tree. │ │ │ │ │ │ @@ -382,15 +382,15 @@ │ │ │ │ │ │ Error checking: If frontmtx, owners or status is NULL, or if myid < 0, an error message is │ │ │ │ │ │ printed and the program exits. │ │ │ │ │ │ 7. void FrontMtx_loadActiveLeaves ( FrontMtx *frontmtx, char status[], │ │ │ │ │ │ char activeFlag, Ideq *dequeue ) ; │ │ │ │ │ │ This method is called by the multithreaded and MPI factor and solve methods to load the │ │ │ │ │ │ dequeue with the active leaves in the front tree with respect to the thread or processor. │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ - 12 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 8. ChvList * FrontMtx_postList ( FrontMtx *frontmtx, IV *frontOwnersIV, │ │ │ │ │ │ int lockflag ) ; │ │ │ │ │ │ This method is called by the multithreaded and MPI factor methods to create and return a │ │ │ │ │ │ list object to hold postponed chevrons and help synchronize the factorization. │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ 9. ChvList * FrontMtx_aggregateList ( FrontMtx *frontmtx, │ │ │ │ │ │ IV *frontOwnersIV, int lockflag ) ; │ │ │ │ │ │ @@ -421,15 +421,15 @@ │ │ │ │ │ │ the list in postponedlist. If this list is empty, a new front is created to hold the aggregate │ │ │ │ │ │ updates and the postponed data, and the chvmanager object receives the aggregate and │ │ │ │ │ │ postponed Chv objects. The number of delayed rows and columns is returned in *pndelay — │ │ │ │ │ │ this is used during the factorization of the front that follows immediately. │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ 13. FrontMtx_storePostponedData ( FrontMtx *frontmtx, Chv *frontJ, │ │ │ │ │ │ int npost, int K, ChvList *postponedlist, ChvManager *chvmanager ) ; │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 13 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 13 │ │ │ │ │ │ This method is used to store any postponed rows and columns from the current front frontJ │ │ │ │ │ │ into a Chv object obtained from the chvmanager object and place it into the list of postponed │ │ │ │ │ │ objects for K, its parent, found in the postponedlist object. The frontJ object is unchanged │ │ │ │ │ │ by this method. │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ 14. FrontMtx_storeFront ( FrontMtx *frontmtx, Chv *frontJ, IV *pivotsizesIV, │ │ │ │ │ │ double droptol, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ @@ -459,15 +459,15 @@ │ │ │ │ │ │ following information. │ │ │ │ │ │ • cpus[0] — time spent initializing the fronts. │ │ │ │ │ │ • cpus[1] — time spent loading the original entries. │ │ │ │ │ │ • cpus[2] — time spent accumulating updates from descendents. │ │ │ │ │ │ • cpus[3] — time spent assembling postponed data. │ │ │ │ │ │ • cpus[4] — time spent to factor the fronts. │ │ │ │ │ │ • cpus[5] — time spent to extract postponed data. │ │ │ │ │ │ - 14 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 14 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ • cpus[6] — time spent to store the factor entries. │ │ │ │ │ │ • cpus[7] — miscellaneous time. │ │ │ │ │ │ • cpus[8] — total time in the method. │ │ │ │ │ │ Onreturn, the stats[] vector is filled with the following information. │ │ │ │ │ │ • stats[0] — number of pivots. │ │ │ │ │ │ • stats[1] — number of pivot tests. │ │ │ │ │ │ • stats[2] — number of delayed rows and columns. │ │ │ │ │ │ @@ -495,15 +495,15 @@ │ │ │ │ │ │ workDV, cpus or pfacops is NULL, or if msglvl > 0 and msgFile is NULL, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 3. A2 * FrontMtx_QR_assembleFront ( FrontMtx *frontmtx, int J, InpMtx *mtxA, │ │ │ │ │ │ IVL *rowsIVL, int firstnz[], int colmap[], Chv *firstchild, │ │ │ │ │ │ DV *workDV, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method creates an A2 object to hold the front, assembles any original rows of A and │ │ │ │ │ │ any update matrices from the children into the front, and then returns the front. The rows │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 15 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 15 │ │ │ │ │ │ and update matrices are assembled into staircase form, so no subsequent permutations of the │ │ │ │ │ │ rows is necessary. │ │ │ │ │ │ Error checking: If frontmtx, mtxA, rowsIVL, firstnz, colmap or workDV is NULL, or if msglvl │ │ │ │ │ │ > 0 and msgFile is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void FrontMtx_QR_storeFront ( FrontMtx *frontmtx, int J, A2 *frontJ, │ │ │ │ │ │ int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method takes as input frontJ, the front in trapezoidal or triangular form. It scales the │ │ │ │ │ │ @@ -533,15 +533,15 @@ │ │ │ │ │ │ • cpus[4] – time to store the update entries │ │ │ │ │ │ • cpus[5] – miscellaneous time │ │ │ │ │ │ • cpus[6] – total time │ │ │ │ │ │ Onreturn, *pfacops contains the number of floating point operations done by the factoriza- │ │ │ │ │ │ tion. │ │ │ │ │ │ Error checking: If frontmtx, frontJ or chvmanager is NULL, or if msglvl > 0 and msgFile │ │ │ │ │ │ is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 16 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 16 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.8 Postprocessing methods │ │ │ │ │ │ 1. void FrontMtx_postProcess ( FrontMtx *frontmtx, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method does post-processing chores after the factorization is complete. If pivoting was │ │ │ │ │ │ enabled, the method permutes the row and column adjacency objects, permutes the lower and │ │ │ │ │ │ upper matrices, and updates the block adjacency objects. The chevron submatrices L∂J,J │ │ │ │ │ │ and UJ,∂J are split into LK,J and UJ,K where K ∩∂J 6= ∅. │ │ │ │ │ │ Error checking: If frontmtx is NULL, or if msglvl ¿ 0 and msgFile is NULL, an error message │ │ │ │ │ │ @@ -572,15 +572,15 @@ │ │ │ │ │ │ Error checking: If frontmtx is NULL, or if msglvl ¿ 0 and msgFile is NULL, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 1.2.9 Utility Solve methods │ │ │ │ │ │ The following methods are called by all the solve methods — serial, multithreaded and MPI. │ │ │ │ │ │ 1. SubMtx ** FrontMtx_loadRightHandSide ( FrontMtx *frontmtx, DenseMtx *mtxB, │ │ │ │ │ │ int owners[], int myid, SubMtxManager *mtxmanager, │ │ │ │ │ │ int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 17 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 17 │ │ │ │ │ │ This method creates and returns a vector of pointers to SubMtx objects that hold pointers to │ │ │ │ │ │ the right hand side submatrices owned by the thread or processor. │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ 2. void FrontMtx_forwardVisit ( FrontMtx *frontmtx, int J, int nrhs, │ │ │ │ │ │ int *owners, int myid, SubMtxManager *mtxmanager, SubMtxList *aggList, │ │ │ │ │ │ SubMtx *p_mtx[], char frontIsDone[], IP *heads[], SubMtx *p_agg[], │ │ │ │ │ │ char status[], int msglvl, FILE *msgFile) ; │ │ │ │ │ │ @@ -610,15 +610,15 @@ │ │ │ │ │ │ this thread or processor. │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ 7. IP ** FrontMtx_backwardSetup ( FrontMtx *frontmtx, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method is used to set up a data structure of IP objects that hold the updates of the │ │ │ │ │ │ form Z := Z −U X that will be performed by this thread or processor. │ │ │ │ │ │ J J J,K K │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ - 18 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 18 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 8. void FrontMtx_loadActiveRoots ( FrontMtx *frontmtx, char status[], │ │ │ │ │ │ char activeFlag, Ideq *dequeue ) ; │ │ │ │ │ │ This method loads the active roots for a thread or a processor into the dequeue for the │ │ │ │ │ │ backward solve. │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ 1.2.10 Serial Solve method │ │ │ │ │ │ 1. void FrontMtx_solve ( FrontMtx *frontmtx, DenseMtx *mtxX, DenseMtx *mtxB, │ │ │ │ │ │ @@ -648,15 +648,15 @@ │ │ │ │ │ │ the seminormal equations (U +I)D(I +U)X = A B or (U +I)D(I +U)X = A B for │ │ │ │ │ │ X. The mtxmanager object manages the working storage used in the solves. On return the │ │ │ │ │ │ cpus[] vector is filled with the following. │ │ │ │ │ │ • cpus[0] — set up the solves │ │ │ │ │ │ • cpus[1] — fetch right hand side and store solution │ │ │ │ │ │ • cpus[2] — forward solve │ │ │ │ │ │ • cpus[3] — diagonal solve │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 19 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 19 │ │ │ │ │ │ • cpus[4] — backward solve │ │ │ │ │ │ • cpus[5] — total time in the solve method. │ │ │ │ │ │ T H │ │ │ │ │ │ • cpus[6] — time to compute A B or A B. │ │ │ │ │ │ • cpus[7] — total time. │ │ │ │ │ │ Error checking: If frontmtx, mtxA, mtxX, mtxB or cpus is NULL, or if msglvl ¿ 0 and msgFile │ │ │ │ │ │ is NULL, an error message is printed and the program exits. │ │ │ │ │ │ @@ -685,15 +685,15 @@ │ │ │ │ │ │ This method determines the inertia of a symmetric matrix based on the (UT + I)D(I + U) │ │ │ │ │ │ factorization. The number of negative eigenvalues is returned in *pnneg, the number of zero │ │ │ │ │ │ eigenvalues is returned in *pnzero, and the number of positive eigenvalues is returned in │ │ │ │ │ │ *pnpos. │ │ │ │ │ │ Error checking: If frontmtx, pnneg, pnzero or pnpos is NULL, or if symmetryflag 6= 0 an │ │ │ │ │ │ error message is printed and the program exits. │ │ │ │ │ │ 5. int FrontMtx_nSolveOps ( FrontMtx *frontmtx ) ; │ │ │ │ │ │ - 20 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 20 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ This method computes and return the number of floating point operations for a solve with a │ │ │ │ │ │ single right hand side. │ │ │ │ │ │ Error checking: If frontmtx is NULL, or if type or symmetryflag are invalid, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 1.2.13 IO methods │ │ │ │ │ │ 1. int FrontMtx_readFromFile ( FrontMtx *frontmtx, char *fn ) ; │ │ │ │ │ │ This method reads a FrontMtx object from a file. It tries to open the file and if it is success- │ │ │ │ │ │ @@ -721,15 +721,15 @@ │ │ │ │ │ │ This method writes a FrontMtx object to a formatted file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fprintf, zero is returned. │ │ │ │ │ │ Error checking: If frontmtx or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 6. int FrontMtx_writeToBinaryFile ( FrontMtx *frontmtx, FILE *fp ) ; │ │ │ │ │ │ This method writes a FrontMtx object to a binary file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fwrite, zero is returned. │ │ │ │ │ │ Error checking: If frontmtx or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 21 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 21 │ │ │ │ │ │ 7. int FrontMtx_writeForHumanEye ( FrontMtx *frontmtx, FILE *fp ) ; │ │ │ │ │ │ This method writes a FrontMtx object to a file in a human readable format. The method │ │ │ │ │ │ FrontMtx writeStats() is called to write out the header and statistics. The value 1 is │ │ │ │ │ │ returned. │ │ │ │ │ │ Error checking: If frontmtx or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 8. int FrontMtx_writeStats ( FrontMtx *frontmtx, FILE *fp ) ; │ │ │ │ │ │ The header and statistics are written to a file. The value 1 is returned. │ │ │ │ │ │ @@ -758,15 +758,15 @@ │ │ │ │ │ │ • maxzeros is used to merge small fronts together into larger fronts. Look at the ETree │ │ │ │ │ │ object for the ETree mergeFronts{One,All,Any}() methods. │ │ │ │ │ │ • maxsize is used to split large fronts into smaller fronts. See the ETree splitFronts() │ │ │ │ │ │ method. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ • The type parameter specifies a real or complex linear system. │ │ │ │ │ │ – type = 1 (SPOOLES REAL) for real, │ │ │ │ │ │ - 22 FrontMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 22 FrontMtx : DRAFT January 7, 2024 │ │ │ │ │ │ – type = 2 (SPOOLES COMPLEX) for complex. │ │ │ │ │ │ • The symmetryflag parameter specifies the symmetry of the matrix. │ │ │ │ │ │ – type = 0 (SPOOLES SYMMETRIC) for A real or complex symmetric, │ │ │ │ │ │ – type = 1 (SPOOLES HERMITIAN) for A complex Hermitian, │ │ │ │ │ │ – type = 2 (SPOOLES NONSYMMETRIC) │ │ │ │ │ │ for A real or complex nonsymmetric. │ │ │ │ │ │ • The sparsityflag parameter signals a direct or approximate factorization. │ │ │ │ │ │ @@ -798,15 +798,15 @@ │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • n1 is the number of points in the first grid direction. │ │ │ │ │ │ • n2 is the number of points in the second grid direction. │ │ │ │ │ │ • n3 is the number of points in the third grid direction. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 23 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 23 │ │ │ │ │ │ • The nrhs parameter is the number of right hand sides to solve as one block. │ │ │ │ │ │ • The type parameter specifies a real or complex linear system. │ │ │ │ │ │ – type = 1 (SPOOLES REAL) for real, │ │ │ │ │ │ – type = 2 (SPOOLES COMPLEX) for complex. │ │ │ │ │ │ Index │ │ │ │ │ │ FrontMtx aggregateList(), 12 FrontMtx ownedColumns(), 19 │ │ │ │ │ │ FrontMtx assemblePostponedData(), 12 FrontMtx ownedRows(), 19 │ │ │ │ │ │ @@ -842,9 +842,9 @@ │ │ │ │ │ │ FrontMtx nactiveChild(), 11 FrontMtx upperBlockIVL(), 9 │ │ │ │ │ │ FrontMtx neqns(), 7 FrontMtx upperMtx(), 9 │ │ │ │ │ │ FrontMtx new(), 7 FrontMtx writeForHumanEye(), 20 │ │ │ │ │ │ FrontMtx nfront(), 7 FrontMtx writeStats(), 21 │ │ │ │ │ │ FrontMtx nLowerBlocks(), 9 FrontMtx writeToBinaryFile(), 20 │ │ │ │ │ │ FrontMtx nUpperBlocks(), 9 FrontMtx writeToFile(), 20 │ │ │ │ │ │ 24 │ │ │ │ │ │ - FrontMtx : DRAFT February 8, 2025 25 │ │ │ │ │ │ + FrontMtx : DRAFT January 7, 2024 25 │ │ │ │ │ │ FrontMtx writeToFormattedFile(), 20 │ │ │ ├── ./usr/share/doc/spooles-doc/FrontTrees.ps.gz │ │ │ │ ├── FrontTrees.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o FrontTrees.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0424 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -3345,21 +3345,21 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 79 /O put │ │ │ │ │ dup 84 /T put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ dup 100 /d put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 103 /g put │ │ │ │ │ dup 105 /i put │ │ │ │ │ dup 110 /n put │ │ │ │ │ dup 111 /o put │ │ │ │ │ dup 114 /r put │ │ │ │ │ @@ -3560,124 +3560,121 @@ │ │ │ │ │ 74EC2A7E24F94C1B867EA193FADA6F132370A02A7F704404421DBBEEF4D377B0 │ │ │ │ │ 6FD3B44C4B53DF870E932BA700422DD125FC00D210197A2B78C149C9C3BF04A4 │ │ │ │ │ E3EF6A6176E23204BCFB04D985B1196C831374A8CD31383AFB3C9C2FDF8C83E8 │ │ │ │ │ CE84F332FB505DB3A3EBE03860F8E885D659DCF532B026E8A2AE9D9584A5073E │ │ │ │ │ 3DC9E54BAF8DB26AE708C4B7353490B531096051727ADD35B17A54E519432D87 │ │ │ │ │ 48863163EABCE4311F2E95EC8C1061B3B3772A751B41E6E8D10AA9C9FAD95161 │ │ │ │ │ 4C69AA33848D17D5D3B550B8BF69108E3A2521948A4574BCA0E31922B1B10F51 │ │ │ │ │ -BB7DCAE275B7C18116580B2D8E26F40A45F84DAF1E0A155F5CA882363952FEBB │ │ │ │ │ -C6BCC4A21081304809DF523E23F3B0D26A30F42FB0529B8174226AD8CF8ABB16 │ │ │ │ │ -ECA802A1177D344B66A159FE24369B73B39A45D44BED52DC15C07BB4DC7A03CC │ │ │ │ │ -D19038490EA929F04BD8832E59A5CB4E64EB05965806F107C5500F7E20BEBE29 │ │ │ │ │ -DE82D35C835CD8436632CB88A5B42D9216900EE75C7E0B61B21B7107D2F4167C │ │ │ │ │ -88018BEC30888C93C1DCEE0AF14676DEDA90C8D2589116D37BF0FC5366E0094A │ │ │ │ │ -215220C8E58FCA78867CEA37469A38C5A2435AC4EE415279ABC93CFCA40CB0F3 │ │ │ │ │ -2FFD0B2CDF80CA25C775EF24DC35B82615E22335DFB5E118B668DD305B0080B9 │ │ │ │ │ -F865D19D3977420AFC3EA76774DF721D57B47D3C70A0BC7457EA22171C398A79 │ │ │ │ │ -AC8C28023B81B9FED51749133C0453D277CD1F6EB2ACCD67459E70418F4EEFA7 │ │ │ │ │ -1F6A11952C65654884F8F7157850BF24EF034BC9E45989D2356FBDB65FBCC2F2 │ │ │ │ │ -E13408D07E18569C5829262E6FCC563779BC23F2E5FF716089C9D7D09EE6B4E1 │ │ │ │ │ -B85797CD4B6D5C614F9E09E422B6FB0AA30234F3E783A17ED3C99230819CF292 │ │ │ │ │ -12B1E0577FCE0A3630FC48E2B2AE43AAFBBF4DD8D04A8A90821405B3C150CA9E │ │ │ │ │ -24183DEF667CE1C945B105A6F9303850F826CC4BCF15E76E79DA2F26ABE1E551 │ │ │ │ │ -201E73C6EABFFEFF6B90678C559B8870BE31814C0ADA294B84F962AC5ED67A74 │ │ │ │ │ -15F1AF15F8B5615F9077276E5B24E7B50A5CC94AF215DF324479B98CA4AE5424 │ │ │ │ │ -2BF4C13333C0E423BF02EF0CA850C9ED331595F0FE5A47508FE2E4A0C35D40AF │ │ │ │ │ -D653A9AC6B9E080626319FEF15F3FA893B8DB4D3BF05D83B1449925B63E1A1FE │ │ │ │ │ -9EDE04C0536451F67D869452575ACD9B5E63FB10D733A4A8A1BE6742EB8C430E │ │ │ │ │ -1EDC9D09B3BA5C0633636D147A16C9CB1ED11FBAA2DC68BD1EA4DAFFC4A26920 │ │ │ │ │ -9DE546A07B398DFAE23DA6BD4CB17109C36A6AB3C90B5FD6227219B69EC2655F │ │ │ │ │ -EF219092F5972F9A06C4B374A0600CC8D72C60694BC641C156B1406024F7FAF3 │ │ │ │ │ -3D0E5817EB60AA7911A96B272DE16DA3A978B8D9750904CAFE02C68ADE564D5E │ │ │ │ │ -EF3CAA81783FADAA1367AB502462DDA1241A9AE8E2B25A01B55489C76CB2C817 │ │ │ │ │ -87BB0F6BA32154656EAAC0D4DDB20248D6E6022E5C5377A3BF981475618D3B3F │ │ │ │ │ -37FFAC4ED550BF827C0A92207CD6DA7235731311D534E9BA38F15978AEF243E2 │ │ │ │ │ -31920B1223F0BB511B5FD2A79982F0B02D063E2BDFB4A24FA5C433EFA2CD8F79 │ │ │ │ │ -6B493FCF460B479A22747E8CA6CB0DCC93E84F7DCF8F85C5D6B099480B414BC3 │ │ │ │ │ -0F084407FA45219EA6EF374AC2BC49EE8E3EC1F57840808F6D67D207C206B880 │ │ │ │ │ -C65EBAE1FB0B28994586D670FD40759A1498AA942A45A8B3C4B35F98A5F66B93 │ │ │ │ │ -FC6E253E98450B5F94559A3D7E317089B6A5B93BA19E6AB57EA20FD2CE0ED5BC │ │ │ │ │ -CAE52E8C96F67645C8362E98D758F2645DFE165D624FC558664C3377F0EB83C4 │ │ │ │ │ -53D9840D3E91661513FC56E0DA5567637D6546A4A69C9BCD2AC66547AB24FEC4 │ │ │ │ │ -5215C473D5B7A0906CD9265800B5D59C1C92A0440C6EA2C497A059881766CD8A │ │ │ │ │ -13BDBE6AECCEB47C25B648C0C6AE7927D46B734835F6B2EFC9DCB4CA62CB584D │ │ │ │ │ -ECFE1F122CA90BE97514DBB161E3568F5A9A176EB04D7C1565ABC7FC4EEEAE58 │ │ │ │ │ -887C327994FB422D219BD9B3335FB00B2F7396C5F213B8219AECBF26FC5D5D7F │ │ │ │ │ -4490B4F7F0CA9E381156A7FC34E9D2A47CE4A22661B4081832535507228698C0 │ │ │ │ │ -0577105B79E4D361051D88B57B64033816D6BB0CB3B1701AF51B47CC3E0FA196 │ │ │ │ │ -61B912047DCD86CB0A63A779E5C0C5C017CD929416F5E3C3D2B7DFE4F50AB501 │ │ │ │ │ -03A5565B9EFDABE36B97379201571B5FEB2C7A74B2FF9DEC6EE2185FDA4C40D2 │ │ │ │ │ -65058000BF89B99D64F2F4B3523A52AD3B8CF52F23C82209BFD7259CE0E5791E │ │ │ │ │ -A4AEEC7D4082CCA89D83B6D93B33A85871DE81C1466FEA95DA6174436AD6AF29 │ │ │ │ │ -8BD9D47ADB3C206371977CC65FEB7FFA5E97FDE034392DBCC65A2FE712F8F07C │ │ │ │ │ -35D7E1D874739FA3116124B3B4737AD52783C573BFF1AE2DD190146CF1CBDF09 │ │ │ │ │ -885B7ECABA7EBB53CBBF5C7C347F5D77B22B48EC6F6EC46A1DC2BCFEEC0595D4 │ │ │ │ │ -0A2ACC8327497233CEB7BB679FCD0CEFAF666CE42FBEDA0106E66BC04F1B2E6B │ │ │ │ │ -B5369E932E1D67CDA12ACF1B7B0E8C87EE123D3915B1006049CB8E7E6215B3AA │ │ │ │ │ -AA2E818EEE9A4D5E659717B4CDF1F72874D68636B52BFE256D03315521822091 │ │ │ │ │ -8E8C476DFC12F58ABA45BCF52C57798DA12FE786AF7BE617CC82D4160FD9C811 │ │ │ │ │ -11715E76084F07906028342EC4DFF271F776F64CF2B189E54F464D7D4D147B56 │ │ │ │ │ -BD6AD71FED66131C3925C92F2B4F166D1CF6513A2EB48371B18B5B9C459B32CF │ │ │ │ │ -EFB28CA52A79CECCA07D9664E8CAC63243A2E9E2C90797D04EA214185A9B9B92 │ │ │ │ │ -6FDFC4B9BB6BC1E6BB7BE23D56FE8DF17A86A264E701ACD18BF07AE07F240105 │ │ │ │ │ -47481D0FE05826ED676CB45D46D2746CB5E473F0879681773AE205FC821492D9 │ │ │ │ │ -B9CCE326D4BDAA4BD36014D51508C538234B8B27473DFDC25584D24A775BFB2D │ │ │ │ │ -DBFC3A5E4320C3A5EB4E95F84A885AC59F53850ADDC8BA3CFACB79C1B0F76C8B │ │ │ │ │ -2DBEC3B5693EF1B99F8F9A2FCF96A2FEE35B64AB85F6A3F8C6103013840DD301 │ │ │ │ │ -1FB7B21441BE705EE7FD0BD9B68718889205582902E3DB6B45FE5D72B7DE589A │ │ │ │ │ -734076AE59305F7CBF7E6DC49625453412CAE16C17E6F1C77F48CF7691EF6148 │ │ │ │ │ -47938F8AD91A6B31EA42C136C8832D25F56409EB9F695EDD06B5A23F824AB79B │ │ │ │ │ -44DF183D32D572D79073CA78BBDBED76A88B03E4E893BFC23B4E2412CFAE6D2B │ │ │ │ │ -F7EF59188AF411E75CDA3D97824BA262101CE1A5CA9213C18644942E93B1C5BE │ │ │ │ │ -9E2968E21AF8C0AD375EC1E27F67BF741570398C8BFB5F0FCED67B83C9E3E432 │ │ │ │ │ -7BC7D7B11F353D6D54D677EC3D8C3226E7257ACD09CDA5606C73C1F9E6DC53E6 │ │ │ │ │ -32918A5093C83EFEB26BF75DF7BDEAE4D23BB88661A2594A466752C63EA7F8EF │ │ │ │ │ -831AF3C272ECB8D881273934ED2DC7FE56498FDACCECB6AE0168A072129DBF65 │ │ │ │ │ -A389032AF74D99E8A4395801A74C2B50003161B40965FFE8A2335CEA2ED0C397 │ │ │ │ │ -B9DEC130965CAD1641D69AF3505026517B38C030FBDEF3E43CFFFA89E1FCE9DC │ │ │ │ │ -A35F928549ED1E890CF6EF2B7C7C0C4B31646F37F4DF5561C424F54328DBC4C2 │ │ │ │ │ -CECECCF77C8388D8EBC49B975E21A820E0D3EE3D442CD7D0A5EC5E4858C56F0E │ │ │ │ │ -BC1EF56BB1A0E289C7A9550CADB703590544CB9ECA6BAF8C703953E02417AB16 │ │ │ │ │ -3FF91DEB1ADC0CBEF39B6631772C2CE12C0AB2AF06BA7574631DABF0ED288EB8 │ │ │ │ │ -D90F4C07A863B7F86E4E9BF5B93341536D1C93EF516EE7D6E9190C49524C4348 │ │ │ │ │ -A330D9A93B85A0FE7A23E637C8317B8B25B20D3AA8A0DBFC63345E9D6866AC87 │ │ │ │ │ -F7EF4F0BD11C824E7BBE112A7F80BED4D4A8FDA42C1817154D2248D58C27B173 │ │ │ │ │ -1B91D3451C274DD26E2104F8E467A7CC7A97ABF5959C32A7702D11158E0BA9E8 │ │ │ │ │ -2B4A37C37988EB4297DA6EF84280A792D60D5E838A0FAE0FBDFCB83DCD6E22C9 │ │ │ │ │ -0FBD3BF1F16A19B9BBDE52E07F43108A5550DFD993EABDCA3C148CF2A11552F4 │ │ │ │ │ -A21C5C8E88D849FCAC299DD76C2747FDA54E0A387C1233732A212FD7B3CD06FD │ │ │ │ │ -A87006D2D2B38DE5CA3EC6B39D45FC0668852AC966B4CB3F7E29CCB4BFC1F28D │ │ │ │ │ -2011FC1FFEC0582D186D7EF3F6F711869571A22E31490FBC1ECEE24BB1A69770 │ │ │ │ │ -F621A60AB5416CECAA7953EF303486F329E08E3BC29E3268EE687ABA31167026 │ │ │ │ │ -2140D0D8E4259ABD5AB3CC572F0C798667514CC5860D0826145A150B0DDBA783 │ │ │ │ │ -C93A2FAFE7E61758557A11D797684149D5DEED2E1C76AF68A93AFD22EF203BA8 │ │ │ │ │ -189A29182A7FBFE5BD352DED10D21A027F60207DFC7E2C253B4243E0F509320B │ │ │ │ │ -AF2C8A1B4E03B17054CCCAC42C4DAA9C4451D7F0911E3F98B314390999CBB534 │ │ │ │ │ -F040F56D339DA790ABC7F4A047A66266A837C090EDA15522D611ACDAFCEB48AC │ │ │ │ │ -809BE050BA3982BAF6BDF430E3B046947FEF55BB6354A876525DB8D62805D5DE │ │ │ │ │ -04E6161999B4221C7312F84B2204C5BEEE0351271A5F2B5541C55CA8B15D76FB │ │ │ │ │ -D2CB543C020936900C6ED7EBFD82E12557E9E237F21EBE3437D021368E34BBDB │ │ │ │ │ -32D127BDA424963E69150A6C3A16DAEDCCA96C80708CA8FC3A60614F2F56F8D2 │ │ │ │ │ -A04E5C5434D732318A02C0FAC69166470520B415D3B414336D7BEB3376429AC7 │ │ │ │ │ -00AB35A76EAFB5051442B483A564008FF59C4515B16E6327D9187A839BDCE4A0 │ │ │ │ │ -8891F0EE090AE2DFDBE961DCFC06485F0ED61CE02641E7D7C15AE29A08DFC49A │ │ │ │ │ -165AF386C35E1E1FE36A686D68EC8D90116C191E8ED647D75FB45B270F1D21C4 │ │ │ │ │ -9459E4EAE83633133E8FB1080186B98BFBF4F4C4D6174CEF3DFDD34642CA1B8F │ │ │ │ │ -3DBCAD6A450DE88641D0AAD1BA9E24F3DC51DE002DE3A22DD33E5ED5B05C4017 │ │ │ │ │ -D615ED576CC026E2124C28D1A8C9DEAF2B17EA51CA233C864E2FC8A0F323A079 │ │ │ │ │ -AE5F173C10E8A8702C23E7D8E88D982E8D67F9CF7D026D8345B329EF0174C9E3 │ │ │ │ │ -09D0E79193D2981A5C558887768BC3FF91E33309F4C495278A1AB82132537A23 │ │ │ │ │ -34FFAEACAAF18FA9290318AE6D6F8A273D5583E66BD07EADC6A3183D60CC67CC │ │ │ │ │ -C4F421045B05DD48E1BA2079F48E2E147147D0B169BAD5E5739DAA7AD59370B8 │ │ │ │ │ -F0F2451674A019D3D421194ADC37B7C11B17FA7C1B848BC17FC24AFB5C0356C4 │ │ │ │ │ -C883D9A41B980CC0F240FE0013524EB705BAEA5FB0A40BC6E963ACCE70959E36 │ │ │ │ │ -C8C86F16B75CF07FE3272922FCFF557315D27B8D1538F5628248420112DF9957 │ │ │ │ │ -02646E438F553DDAA4841117617F1E8AC303C72C12ADD6CB75FFBA2413DFF3C8 │ │ │ │ │ -B8C224627660BBE7AAA53F8E0D88F4763A388A5FCCABB74C9F65BE57D03B3A8A │ │ │ │ │ -BE251CF0A045454ABB4C0BE022 │ │ │ │ │ +BB7DCAE275B7C18116580B2D8E26F40A45F84DAF1E0A155F5CA88236395451E1 │ │ │ │ │ +8BECE73222A7F459CF47F6F664107A1CB538547134CF8BE12B379976D6D1E349 │ │ │ │ │ +FA050837B0D6FC3C15946120841D18093C107AA487B2157308DE5D05C74AA177 │ │ │ │ │ +96EE4CD0AAAEA93474BEFBF609AF88907D7E41E53B8AFEB8705F2F4B1A7BD50F │ │ │ │ │ +419904A55622427205948BAF3DB3FB0A2AC0F286DEAF327BD653B11C4EA789B0 │ │ │ │ │ +A52F8C3AC1C1748E48B39AC00B21CAB44512544AE9EB262FE09F990C372917CD │ │ │ │ │ +E0CA4CEA02343C05FDDF44AE1267865F67798D5D8C62C7B2F0C58613E5CF7729 │ │ │ │ │ +009495AF32958EDCE516050D453DDA7772461C98CF2942BE19905E008192603D │ │ │ │ │ +E7B6B8CCBB6249F517FA52567300AAC956DEB5D628B75470052EC305C2F294DD │ │ │ │ │ +0271994055F5D06FAE9E79BC75D96391B0AA8997B23B898813B4C320478D74ED │ │ │ │ │ +F66991F0EDA2AD7F6A7E58E0B3D86C1C10008D993C9E9899FB205A9E4CC1BC27 │ │ │ │ │ +7FE4513D65A1B70E2D6C13B00E42BD08E72F017EED17D1AA6817D21EF0360996 │ │ │ │ │ +C5A03B53F0E4AAC9069E71C513D56F5ADC4EEE12176D81E6411839C788B8086B │ │ │ │ │ +C8AAA845B11DC85BD4DE9CBC304D7172D0A85CAC8DCAA334361412C79AE46788 │ │ │ │ │ +A69D82E3E5AEA7E60ED0A3179E3FA814A2DB4959D829AFC076F619D0E22FDE8C │ │ │ │ │ +7571CD78E73EE106D893DE95A9FF07BA79EFAB9C7E4F0F4C846EBA3F6A02180D │ │ │ │ │ +39AA5A08DC4495489F1F77A4640231A30243C3BD615C13917D318F2A0F3E9F09 │ │ │ │ │ +77F87A79E9AD892FBFEFBD7A02113AC741575763B0302112B7C99432FEBC2B05 │ │ │ │ │ +FC2E1D11D07E143FD940FA5A9E109013E7DDA76BC42214E7F73CD7826971D599 │ │ │ │ │ +DC640650EC6BCB276AAD65C61A2CAEA8F4C27BA83B647356D6B78A1CB461C341 │ │ │ │ │ +D6CA000027EF04D008A414335C1EA77B3B9445FC33FF6515A72D1BC8FF8390EC │ │ │ │ │ +38DC5EEA65697ED67532F8D1B54330F033AE0891EE7BBDBBE1A9A22CBE1F1F10 │ │ │ │ │ +21E035ABD9D31EB6A1D7A32ECE1D08AD8AE596C4516337A7F04432455062FA1D │ │ │ │ │ +25E77905413D4197DBD26C4E6C98768A0A8149720277C40E59EB0F0C9369A518 │ │ │ │ │ +47E0A945A47A2DD7B4A9C6E2896F642A5F0A7759A55F6C3E43951557BCA4BCED │ │ │ │ │ +8E6AA219CE9AB66A6AB232AF2919ADC8EB84BE6822E22070BCD099D8F0C1062C │ │ │ │ │ +E1745846E50CC85B9B1CE3F14A4639B118CAFDA952F3B21D426DD7808BD0CFBA │ │ │ │ │ +AE03CA6BD92E71196F51D1E683BDF18255C756D3DCC7DED1594EA4E1C5FE9705 │ │ │ │ │ +B8862FCF2A116032C2C8ED7B5DDA3AEDB20C7301D0E6C536F3419DF34E43E785 │ │ │ │ │ +0AD20CEACE127526826A618D9C4B44D3D3F6CC88648B594601556D5EB3E24F51 │ │ │ │ │ +F3B7FC5C877DCFE9D4CE9344E496B8CEB1943836676A39923337A9FE0BD490B9 │ │ │ │ │ +0D787108CE74ABBFE7DF54C82610088784AD8BCFE6524A9BC8C2CDAE99B4B0A2 │ │ │ │ │ +A1846489D38B853523A6B7EC712B3D782EFAAA4CF6C33133D079618E99A8D8C8 │ │ │ │ │ +156BD00CFAA25130D1BDA909A7F5D3AF1DAD4C70858F142ECD13D33CE1C5F6B5 │ │ │ │ │ +C8C7B028ED8F7E4202179CFC017558B12CA9DF16121086EA5863926B2533A8FD │ │ │ │ │ +D4ED1BCBF5616DC7196E7AFBB0E7EC5070375B99D85B928C3E975ED1A0B9E5F8 │ │ │ │ │ +E54E7B2A19E67DB8F4877EAE2E091DD7659A4DE41B9CA7E2C0173041BCC9CAD4 │ │ │ │ │ +BD4B78F49F652515C07BBDBB246E9534FCE28470BFF52667F229CFCF20117BDF │ │ │ │ │ +83ED0613DA910275A033440FAD21496DC907C58777B7CFDFAB39F94D970F210E │ │ │ │ │ +5734BC322CD92AF825210077C92835E8991A37C432288DFF4DDF03FD3E20DB80 │ │ │ │ │ +89DA909CBEEBE85807E5223F8DDFD0366EF5C6EFEE02021B1B5FE276D6675723 │ │ │ │ │ +82DF5DB42B6FF210BFF7EB4CFC11B8E0D8A21AD88DA150897C3F1A650E2A7E9A │ │ │ │ │ +8C0AD0F0A038DFDB55423EC5DA4EABBFEBE2FC6BCC7CF8746192F159A5D6F30D │ │ │ │ │ +3FB19FC7BF033554C1FCA438F2E0AACFCFAC9B1B20BF69FBAA460CA48B3010E7 │ │ │ │ │ +C8C6C432F908AD5CE4E5B98F685E0AE2186919127DFB7E66D523972E53F2E10F │ │ │ │ │ +70BEE17E386C9ACBA27103B4211952754922CCEE3AA238B8DA526A3C1D748F48 │ │ │ │ │ +1F9EE2F2724B5AB6BE35FA92736481535BF4E484131D765F70ED803F3E57F890 │ │ │ │ │ +B9553518958E5D975A484B67F512C04D3E75AA347E334BD0D40C3BE8E98B09EA │ │ │ │ │ +12386297319633095133DC680F58169EC30BA6688941714FAFA899C5ABAE83B8 │ │ │ │ │ +C4066A1A37903B4A2CB32606631D9280FF4274661774ECAC100BC13A7D0299DD │ │ │ │ │ +BA4AB27CF8F833470BE83E47A2CB777035AB9F30549CB6C65F2E70029DAA984C │ │ │ │ │ +1AC5A2B9F1B44CE8F15474D76B056C1FF8B06AD927BDF136386E47CDE16169C7 │ │ │ │ │ +7AB5963F2A200B92EE65358D9EB4FC8F6E8FEF6A0C2A76172491EAB785D76663 │ │ │ │ │ +9DB6B70FD40408608E86FF6BDE773597E681A1A9CFC7D3D087BF8F81B77990C6 │ │ │ │ │ +64FFE0BB4A5CF86A9B7CC9F0324DD72C826323078FFF438DA744061D3EE0661D │ │ │ │ │ +52E708807B31ADBFCF366596F5E37BAEEE2A2A424B7F2E49B7B315386B5AB955 │ │ │ │ │ +5F977588213BF6F359F3E6B9841A36EAF27CA2538CA7547B786B420010277DF3 │ │ │ │ │ +1CE4B92EAE09DE43FCB2299D7A2E3A31DF9A07EF4D15EABE035415C0EC70F217 │ │ │ │ │ +119D651E454A162247357272F26E1D81BBFA8CBE63D8C2AA0367994F3632BA8E │ │ │ │ │ +557CBF62D95FCC9B7DE13EC9A371C04CC34F4E4C8746B07ABF880C0DE3DFE479 │ │ │ │ │ +0420A22607CE955BE0CCB08DEC88D4556BA2E0B24BC557746508623BCE179DA7 │ │ │ │ │ +1B5CFC08C97454299D2A102D419479E20BF48BBA36992E095A2DA922C702A46D │ │ │ │ │ +F8D9E6ECA77CA813759B573F9F0000785D601DEB5129C9D4A1F818AB1E109FBE │ │ │ │ │ +23AA7F2F9570D8A49156BE015BF0B5F77A9BCDA5563C041717D69AFB46110469 │ │ │ │ │ +FAC39CA28C774CF986690AE4E56DF6EC0E144A307979B177466A0ED15E4E426B │ │ │ │ │ +CC2115B77CF463369626C5686100F864D576DF92D7A77924ECBCC50F43169361 │ │ │ │ │ +354E0160677F2987B791B2DC4CF96565B805A0CBA6AE2DE07A6770F62C6B32B9 │ │ │ │ │ +6AC80A5FC02F0BCE7EAF461452643FB7814CCD94E31F9EAEE88489B0CD2E32AF │ │ │ │ │ +522C80C468C3B32D8801083E3FFC9B425699C550D32D28F19299A9131F930B5D │ │ │ │ │ +34DE6A025ED6B0D24664B3B76FCE643F6D0DE48A4BA17C71B682F9D70397E42C │ │ │ │ │ +DE6F3B180140834315789872C251F6546E187B0DEFA5A11CC873C2CB7CA1C0AA │ │ │ │ │ +2C837F3BE6F7A2578D9B30199CBCD3294A1611007B91EEE59A585862EDEB489E │ │ │ │ │ +E77F60F2E6DB691289898EC8409574EA801FEF1CC84531BDA321ED3690C808D5 │ │ │ │ │ +0EE357E44F7C5F5701D796C58932BD1A66D8B8BA886A60AD40DFE0AA7A643FDC │ │ │ │ │ +FD8718AA91CFAD2BB4C03E827877C6DA186CD94882AC59CC10582EFCCAFC6E70 │ │ │ │ │ +A98C36A3E530D04700AC97A74C0B19B95D5506F7F51F85F1104D8425A4103E6B │ │ │ │ │ +76DC1142E6FAD7A68D4D55C2FA0283AB624C53EF1212887D3CF7C03BF763AECC │ │ │ │ │ +1A9E07C309BCF150F1F19D9A227C6844FAFF477515CEB6E80F5D95FEE88FECE0 │ │ │ │ │ +8AC51F64A9A140611AA1F8D2F3580F23E4DB593D6026753505B83A0A0D5FD35B │ │ │ │ │ +09EDC1C1085FCCC5106A58F96B71F1161C4D954D6B42D8B42BD41CB1CC0E58C3 │ │ │ │ │ +C9E960D4D85E93130C9FAE82BAD7EB8096CCF3C7748CE57910EB632B8076439E │ │ │ │ │ +59692D53A6EA5B8602E1BC32AFD3C49F18269668F485BC73515CBB59911B3D68 │ │ │ │ │ +5DCFB560692EEA0BE7549DFDB48943EC47598C5CF5562598220901295D590E7C │ │ │ │ │ +81775AC7E89A183D089E01F2C108F2CEF8C036BF37A6BD5A3BE914D2893BF8BA │ │ │ │ │ +75F85921C2EE88A546788779FF56347E6BD90BAD796FAC642060A518B7BBA700 │ │ │ │ │ +9518FA73EC831AE41181C487FFA28F8B9B7AC247E7D6B4B622FA71072B05B4A5 │ │ │ │ │ +CD9F0D090C7E7A035BFC3448E1035E9AADEEF2B4DD15AAAA4E494E4D00A8560E │ │ │ │ │ +F3DFB9601BFFBC01610B2FB9C8701D3FDE5F68FC49B6629B1868DD242F4AF52F │ │ │ │ │ +8099A44C563DDE5125988C791A5E0D218480F54E889E21BC939B58E07DA734B5 │ │ │ │ │ +95B50DF45F798556CEEC3C480A50C1EC668B2C138019612C1194DA57990D56F5 │ │ │ │ │ +A6771D14EDB3218C876484CE464A0AC86D05CB4F431AB13AF33008589CC6B535 │ │ │ │ │ +8AEE32CDAC207195B806B3303C1DD440A6C98EDB87577FF849FDA3A6059C56E0 │ │ │ │ │ +15022A0A570A682FFE2515E2EA9D8A6CB2DD835FCA28EEA56C135618690CD431 │ │ │ │ │ +1C85B1AEA1FD4634264550FF14EB1379884D97A7960089FA4B3906F5075BC410 │ │ │ │ │ +7DC260E3C4604F418223B9C987114AFF14D64C37F5EBDA035CF6B18C8E852F30 │ │ │ │ │ +F8DDADA7F57190FD4A9A33782E9FF14178EEB88D7253E1086200217A497163D6 │ │ │ │ │ +598F16FA4EAD553BBE89B0FE8328E4B0832BF91C6116D4DFDB8780624E80F3D0 │ │ │ │ │ +45256D2F07AE205FCAF9C6027DD3E2D21CA054A97E42969E5B5A082A209FB69A │ │ │ │ │ +A05BC793F3F0E0561DA798AE8A916669C7BC3CDF25223812FA03F37249150EFF │ │ │ │ │ +7D46B8EEEF731B828D3745850C954D6DE12E0E416BA9A98FFBDE25E5EC84D829 │ │ │ │ │ +3347717AB66B228431E59826FE05DB11481AC357BC3398D0BB45E93C3AC1F65D │ │ │ │ │ +63337F7FB745FCC90413108135D11724BEC3530B6095C6756C2F74ED392A48E9 │ │ │ │ │ +C320DA6CAD0CE00AFD7449D21EE8321FCD2B7EDC655665119CAA4F73E23F20FF │ │ │ │ │ +6960F124202E090312A038C30B7723CD899AA5C0870D28521F33D5F61021928C │ │ │ │ │ +927777A78B7F9C97AF5C8E65FDD0B34820C26E9B9A9DB0A7FFA96F87CCC1F09D │ │ │ │ │ +F3C7CD5A0BD1AC65B657A68964328F62F9DCA235BACE0FF041504EDE64D00249 │ │ │ │ │ +C7114B0BEE57CABC7B1BC4 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -6750,24 +6747,23 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 66 /B put │ │ │ │ │ dup 67 /C put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ dup 71 /G put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 83 /S put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 100 /d put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 102 /f put │ │ │ │ │ dup 103 /g put │ │ │ │ │ dup 104 /h put │ │ │ │ │ dup 105 /i put │ │ │ │ │ @@ -6958,179 +6954,171 @@ │ │ │ │ │ 82032FBD2FCB6E403D34B85ED4053A8CB619BDD4DE001F4C3007B1F317579651 │ │ │ │ │ E6D6662189CC2D95AB85D7473F65C5D7B4AC63B0FE928F3400035D5A9D443D0D │ │ │ │ │ F3532B99F3AC26CB25EA3CD64C341159061E02EFBC7C033C05CD919BBD827A6A │ │ │ │ │ BFCF3BD739E32E7FE909AEE068D50FAC33605FFF98C7D0115FB860178FD03DB9 │ │ │ │ │ 7985B78E0AC21F2EA065FA841F5928FB85163B2E2D8F850DC7EE313912C45C28 │ │ │ │ │ 2783F6762C67882EFEDDC7E7567F91C16B16FD8D5A1ABF35B5586307701B91AD │ │ │ │ │ 54984598F2AD46FEE3D68A2731BEAA754C8E730FE0E84952EF77930E4118F8D7 │ │ │ │ │ -2F3AD7547ECD7EB31108291A22BBC656F4D968DF891E4F87EF8FFE711A48FFD9 │ │ │ │ │ -94762E9918C42251D75772AC97BC15A4FF63D911D96AADA1CFAACE8D7001935C │ │ │ │ │ -9D7A0E6B35E1522780C2629D74057738FCE1BD41CD81D97BFD99D19FE03B2EFF │ │ │ │ │ -7B80B18DA5538D06A810DD315F31DE1331EDB82DAC760E6D8A855FCA3C8DD9E3 │ │ │ │ │ -61164D1386FCA2A0E7735AD69D7D9C6335F02064419B2296ADA17DC51A1E2195 │ │ │ │ │ -45FA3A158E075213ACD6607B07385F0D9F5F3C5C385624B43B10016D497FA569 │ │ │ │ │ -103C0A7CC701BF1558C587B15A8094D8E4524D74DC263BE9C5D1C96970A7324F │ │ │ │ │ -5514ED0576D79D5A7C8CC2859C832B0C5869166DA1DB8CAC589AC9EB48379CBB │ │ │ │ │ -33B840FDDADDDA5FFFC54678E901A33854A703C01C16945C99655BF1BEA74EDA │ │ │ │ │ -723B5FC176D9693ACA831C563CDB35C96C69575A510E33D5BB62701CC6CF52B6 │ │ │ │ │ -0DC2562927C51CEE40731A968C796BBD399BFD4CF070FCA8E806F693E20AF9BF │ │ │ │ │ -64FECE20D4E0C6CA2A65F219F242989DAF5EF91F938A2DEEA46C955E8CA1B9C5 │ │ │ │ │ -8009E9BD1BFF6AF50E0EA9BAA0869F4377633A88B45E0213ECC54844CCEA9D84 │ │ │ │ │ -1F6977C49C4A8B7534547FD77218695D18B20D2DE3AB9E395FF3CFAF16B68567 │ │ │ │ │ -1CDD1815897177510547D05A6DBECB4043CF614D08EE08FF4FB95130181253E9 │ │ │ │ │ -B9CC2511A4C356839E7FCDB340CA4B0F41D40045C8200FBB53F2432776057381 │ │ │ │ │ -8DDB50284E25720965F2C64AC7C1AA354F32CB5F27FE35B607E2B0E6887D2BC0 │ │ │ │ │ -35D7DAE239F77513D5D5A4346D0A8451EA97085A32B1AA49F3B90C719937CE3A │ │ │ │ │ -D5CA5C64D87FC079F29677332F9A52B0DED7BAC119F6DD494E29E349FCC219B8 │ │ │ │ │ -03260C5020104E6F95254079532E34174C898765B4E18AA8B06EA0B1C3F4B871 │ │ │ │ │ -4DB0621D3F6557A781788733AE4348FA2C7AFAF2EE0FEB921C71A43EE757ED2A │ │ │ │ │ -61E6008C2A13972E5943AD9C4B82B51F8E8451802D489EBBD32218D19BDBE14B │ │ │ │ │ -40FB9803C48C9C174C4B420D7C9DBA2F7F5F278DE0EBFB2D85A914B81FAD7C78 │ │ │ │ │ -54E5EC3960E09B4513A3C019BF304D7FC464C4B2651F3F5FF11BE269D2556B83 │ │ │ │ │ -C56F4FF4A318EEC552519DFBA70279756EBF7C15542F57B0F22FFE52F2A3CAA3 │ │ │ │ │ -AAF7CD0C94F91FFEC92D71F84B6514AD34A7F840A015F39ABC78659747E4ADF9 │ │ │ │ │ -C27F5FC03AF5A3E76FAF08E6B5CE36A10E727FCB7214CF7AD888D6B0156B4D7A │ │ │ │ │ -36AF66C9998449E2D2CCADD049A90E34A5C5C076C2CDF1D4E57104312A7B738D │ │ │ │ │ -A5371A6FAF80D1F725E003AEC9629D2178E46FB1BEEDC99202E39F9D8D3DDD52 │ │ │ │ │ -DE4C6A15B570E1E4E340F957BFE9CDDF8745261A170F840483542EEC5FDD4035 │ │ │ │ │ -09912AD116E1736A36B843A6019C6396E260126CCBC6A3ABB9F49C1B67691AE4 │ │ │ │ │ -A672E603821D892F2A0FD08E56CEECCF8478E8B1CAAFFC003D9219FC40113156 │ │ │ │ │ -499C0CA4CEC9EB54179F38525E121A29678D002AE8F9C2F0C8AA9085F409CA5C │ │ │ │ │ -67C8C31D0B2706C81C19BB4E4E2C321FD8E44B3CB294414799E8F68BFF299E12 │ │ │ │ │ -C2C490AC8DD87D4262C30C52E8E635784D478F0A68DB2B88DFF58824EC7A13C0 │ │ │ │ │ -4708856A771D6A4BF8884D60FC800AD1340C987BE015B225D5F0A54CE68CD55C │ │ │ │ │ -5B368751E69242AD6D6F2D9550D43F1A63FE4B16BA137C15D42735D014FCA8B9 │ │ │ │ │ -93288A1D8A6F614AF8423481BCBB3C489AA05EAF81E6EDAB046E602ED1270AE6 │ │ │ │ │ -EC50B444E7BE8F4459647E6B9EF0D3AB61ACC3BCE94F5210C9432787BDE32E29 │ │ │ │ │ -6959D019A7D4DC560CB776248D17D39C1F1F8161636350062ADD19FEDE641EB4 │ │ │ │ │ -3E95E862D8E3E29A0D50487BBF24BED816B2AB6CC4789C80E1DA6A6C3014F8B0 │ │ │ │ │ -2784388F9DF6AFEC109457BDA53E454A0AA464FBAABDC34D55EF3BCAE4B23360 │ │ │ │ │ -7EFE102A212E401DD536646949B8CF7D920874B55A2F398033E581E877326DEC │ │ │ │ │ -7A53DB522A4AF5CF39910B71F4FC73BA0EF18A3235CCEC40106F49086BB9290F │ │ │ │ │ -73595894802404D20BD9D055A53E4981EE918724D5FF769BD80561F8E7B8C190 │ │ │ │ │ -DFE85C5D458DEE0C72E14DDF559EBF6BD81B9B85E4B1ABC38B9816EBF7EF890D │ │ │ │ │ -77BE54E9710720CD5366EBC800ED80DB5FD4F6009E3827A2CEDE05D9BD8DB7A5 │ │ │ │ │ -DA680455F0D9DDA244F90465DE5D5CF6FFDAAE45E183A1CC5A99FD884DD681F7 │ │ │ │ │ -1BF289E6F9AB717D1316F4B069D4C6AB4B22F0D49FB2566C38159250849C7EE8 │ │ │ │ │ -73E39C32B201ADA9670AD4DCC52A7D484AEE5656F7AFA6424C5C29A79B2D9245 │ │ │ │ │ -B35D9C6764F15B4CFF64F3C5A476C885A36F747268FA6D2EC12B57FEFC9A4DE4 │ │ │ │ │ -A5A32B7F9E5E79823DA4170900873FC1B974AD99987CAD5179843281A617C6CC │ │ │ │ │ -1BD466F673E8EE878FFA2836A924628C5718BF30EECA613BD34F1AF173A4A1E9 │ │ │ │ │ -66189BB75C2AD3CF5FEE5F36AFD2EAFE611E29A50DA30FBD76D81FCBEE713412 │ │ │ │ │ -0A355DC71DD3CF30AB2696FE6E363C52A76AD22BF805C07535B775561F7E39D6 │ │ │ │ │ -024FE36FC0492131C8FD675E6E32D6907AC47ECA162B7E52D726C29B0D21A3C1 │ │ │ │ │ -1C55D7040672F58BECE96B2624945F94A9C3B96CE439AB39E48B62CA26CF6B98 │ │ │ │ │ -302906FFAA986F906636BFA31A132DF6B464D83E291BCF652F23B766A8253B5D │ │ │ │ │ -22C6DE9F0EE764A9C3F5A591076256E76F0E154BB4031FF44D29458AADDB246C │ │ │ │ │ -D61604E9A7FE3AF4C775F925C558846300ACFB92D6F92089F45DE0D88023400B │ │ │ │ │ -91C346CAD4F0ABCE4AD42DD83F0EE02A6B3DC39FF7D29DBD0DB3646E71D8F01A │ │ │ │ │ -7122C93FF14F1AE47E5D8CDF584FDB107A387638C8FA3D036024C3E246D23529 │ │ │ │ │ -D36E2A4E4D2D1AB884EFFE1DD1B556E5DE60C279C13BF13F0C9A3B1F49768D11 │ │ │ │ │ -45F9094CC9602F9097A31814D2BB6BCD8EA7BCBE006EFE60A2910F72E25A953D │ │ │ │ │ -F73CBD8EA509F844EE121C7BBE435A9C16FDC9E8736025E633B3A92185799FED │ │ │ │ │ -5BCA8181BEAEEAD448253B7A1B91BC0F477D8EB0E3AB5D326E39CFC42A735A3D │ │ │ │ │ -EA01F33B0761CE0064338B87B71C6192A39FAA05268E0B7CA284D2D531C5385F │ │ │ │ │ -D906892A21BD826A7D8A7F50609C098DDBC1B64F021630705B13759AE4541FF6 │ │ │ │ │ -87564910663F32D4921827A22A449FCECD22421EC309B11ADDC8709CFF4E54C0 │ │ │ │ │ -E7519706FCEAF10C9EA87CADAE22E7D0DBDCB32F841ED13607E5833CC9D39122 │ │ │ │ │ -CA866C10513C0742F3F0067BA014F1811EA07704735AA02E50395B8E867B2E75 │ │ │ │ │ -43E6A61508396EF14594CDA0CD72D2269D74A40E64FBF2858903CEC404BBF36E │ │ │ │ │ -40A6CD34154B7DD621B81FCEAD5AD0B348F11D33E52E0D26568273F1B9DBD2BD │ │ │ │ │ -0D1C8E022708A3141A20AFE99D574E8F7E51D709AB044E0940D5ADAE87A4BDA9 │ │ │ │ │ -FAC9D785C10ED008A2016CF23EF3577E8DE3B7DF86B1EF844A936E51E3F9629D │ │ │ │ │ -335E8561C5BBD7EC40363C27DE6DF4AACBBDFEE1D693327D155A4C38D33E5575 │ │ │ │ │ -A3F5FD06825DCB36488CFE1692A723C196B5D74FCE9F0B5A3D7603D67D51EB4D │ │ │ │ │ -D49B578C1DA4E00D19E2D0E08B3BDF843A28BF781CC4A31F04CD25D208CD21C9 │ │ │ │ │ -F259C889F3CEDA094CF6CE1B5381B5CD45782E9B7C3BBED54437FB7632C0B0A5 │ │ │ │ │ -4840FA9D1CBD128F180DF830EC8390B56F8548EBC6DCFCCA2F17FCD43BCB6AC7 │ │ │ │ │ -F885F3D313DC74EBF9846F5E4F95C5A3085DC9AF6CDF0F3B7401AE2662E06446 │ │ │ │ │ -AC4FFF86B9AD14B5AEBDBDC563F6C224789D3BB4D526D9CBAD095EE725473DD9 │ │ │ │ │ -6C46A0C4103EC78D807A767196AA3A7CC37168C2691C8A42DF330DC89CA8E87A │ │ │ │ │ -8033451731995194337491C555F3B02D70FB5BFE5BE53431C8C2C2A3DC7657FA │ │ │ │ │ -5C7CC5A17D5E2DBC4D5CBA447AAAAB1B49033B338273E4B8061A65331F429349 │ │ │ │ │ -4CCFCD94168A84ECDC12ED7E791BAC2BD20B9C5FDF02ABDF368DC3D6EA361945 │ │ │ │ │ -BEA64846028839A3DA689E6026003F8C6D9BBCCCD5A6E8F7F05859035AB0101D │ │ │ │ │ -0F30D6CDBAC092A9EEA0B64A3B002CED4E8CFAB6EBE12B7F2D6F30509F858FD6 │ │ │ │ │ -0A46DC7FEAA3769A9285A9D6526F676F8B86585714C9B60FD3F928FA5E98CC77 │ │ │ │ │ -8C9AD8C607BEE6FE0C124147FFAABFA9652CE7021A184CA1297EDA639DECB28D │ │ │ │ │ -D5DB9745334E0E4DB4D06DB5A5B3B02F75E4F3FBBEA25284BD21BC2C43A5532B │ │ │ │ │ -6FA5C974FD4FB2065A99AEF41B9745BC614B181899D55E42C94586F6647E3A96 │ │ │ │ │ -271C987C9437771F4E355676A86BD25AFC64B5832BB5FCE4A6055920B28E14A9 │ │ │ │ │ -D537C347C174C09220349CFF5C2FE81425DAD9EF445409B66EE780BF93CE1CF4 │ │ │ │ │ -847DC2F4EC51AAE70938E30E5FC34351D23685E0336932B4C9040AE919746768 │ │ │ │ │ -5B9EF5D6DE7BA47B66480C236FE33C41C84F884B0E93AD56DF60A15F7A415D67 │ │ │ │ │ -43177FBAEB518507BDF59C3BF5691823321D37427CFE4FA739F50B7C025F60C6 │ │ │ │ │ -FF7993006D85DD81B7064C00210E8F65C959780C12E5E896A15AC9CB8751EFC4 │ │ │ │ │ -77E25F35F7EB0263EF3231CCC6DF4181A1BEC544C8346150077D2563915915BA │ │ │ │ │ -2DCCA2D942FB192E3FAAD0F775013CC5FD5DC46897A4DD95711E0A49FC28F4DA │ │ │ │ │ -C2B9F97074770CBA6C5B64AF85F0537840631B798A26ECA7A4A61D7E9158F5B3 │ │ │ │ │ -9C40706975BB3B9EFC4CEABA3EFAAC1F383F7F8BC8302A2FE55532BD89B08CD2 │ │ │ │ │ -232693E4224A3DC20500C988342FF84CE93B247F2150E1B52E9AED79BB7A924F │ │ │ │ │ -377125A144A3B435A513783FE8BD4A6941C8E3317E0F09AB31F9F1F727F1EF25 │ │ │ │ │ -46CD399A649E424DB2AE83914330282A50CD79A340EC3C922B3797F33839C51F │ │ │ │ │ -D442CC584FD6EA91E843276F28D6F5F37D257E87A369E519A7CE594264AA3A8A │ │ │ │ │ -ECEEFDF867F78FE15DF8F76E8C3E87CC4386E4281C62E08ECB1474926291AF6A │ │ │ │ │ -974201CB475981C27C366E1B3825E572172C329E27779C775F278584DCC3BD27 │ │ │ │ │ -DB48102C3DFD549F843910FE9B6ABD13950174BA247347CDC8D3DFF5CD436BB6 │ │ │ │ │ -DB1065366D8DA41E685179D18F5FC90B50FF972B7FCEEDBD158C37F23055E5B1 │ │ │ │ │ -3CD60DBC48BFA7F35F91163CB242A451027DF5994B8E40308FBF491587A1B9CC │ │ │ │ │ -8406A7D31A11D728560444FF7566C5BBE07AA0E2FA72AFCD9EBD4C0C35E311F1 │ │ │ │ │ -EE08E7CF631F9E281AA4D803F09E60A875A03F3C068CFF3C924460D9FB6C2AC2 │ │ │ │ │ -2C8926B99456B334D57FD24A168335DA94529737A4B779EB72C5205A9B1051E7 │ │ │ │ │ -31B568EDD92F71C8F070B382720EEEB9357E6986E806F625301B285CD81F367E │ │ │ │ │ -92874D9A3CBFC8464F42226EB81FA25FA67A5DD2C7AB4C3309BF226B62B10458 │ │ │ │ │ -E75C9A20E421AA14D260524034F2ACE96313E658DBB520FEB9D33BF543E4D17B │ │ │ │ │ -E6899AD7337B3F9478A41944D31E133CB26FB7A2FB405E3C7274C23E14D43243 │ │ │ │ │ -D350719EE13BC53FE778B18DD5B93F79F97419503D13B470B238BE06C5509D77 │ │ │ │ │ -8052D3AD570E4AA8D0828B1459E0BCCAA54AC5EA84386CFDBAFB8D3F4517F01A │ │ │ │ │ -ADA08C49F7BF6816B6E7DF13411A00DC3E3F2AE358E11BCACE9025068D6632C9 │ │ │ │ │ -375C34E8C71CC57B526D820FFF9223F3FB2CA4F291DCDC82E3B7D3FF247AE5F9 │ │ │ │ │ -C55FA73A63DBEA4A9B6B74BD494AD27EC10643E3FE114184777889CE678BF824 │ │ │ │ │ -EECF2CF9C600A9E895633F81594189D8D5AD484DC2028D0F35B01F08102818C3 │ │ │ │ │ -DD13D21B6A0E6516F7B3B997F74FC14ECB755CA50ED5A6A41A96FE9FCA1DCE7A │ │ │ │ │ -C670DA37A47340EDEECAA071CA1B7610622AA4F7433EC3881F8FFBB3C1FB6D07 │ │ │ │ │ -114BC7C4DF659093B8514375F68A86DCF171FD778ABBDF48851A4D0F8C818352 │ │ │ │ │ -561FE2154236C9B0706A9162327F65195AC6B5772A70AB60A3571858EC94F1F7 │ │ │ │ │ -6D4B949622408E7D96A47FE9491A6E53ABC03C597E7B116AA316F8D2066562F7 │ │ │ │ │ -F4C0512661C7ED03D9DA67EACB38ED7015FBA1D36C14571E9C7A0811E8EC4075 │ │ │ │ │ -D2E236294D3EB3D30911753A01C952F85416183D3B251CCB97C71F6F581863DB │ │ │ │ │ -E7692064E451F2C34C2EFA48212FD3B96D4EAB9F95862EA07CA5E717F223FB04 │ │ │ │ │ -9208ED8BE60779AAFF6D8105EC671E879E265698203B1096BAB20C4B1D97C218 │ │ │ │ │ -2C840327BC343BABC09DFD7247BF2EF7669356AEAB1AC115C0C73933AE86B7A9 │ │ │ │ │ -D715B67E50D7DEF5926F817ABFC055D483F47EB429B7B9F39CBEEB230128312E │ │ │ │ │ -E44F70791C629952E8BB44DA569DD97C37DC2CD24223238A8D02FD04F4FA64BE │ │ │ │ │ -053AE8095481034145469C2B4CEBC92487AD338A6D967F82FABF11D06DD93E8B │ │ │ │ │ -65ABFCD1CDE8B3D55BB2E6FC8D8E389979E78EC5D8DC267304FABCE5E65EF857 │ │ │ │ │ -66E9CF14367CC8A7AF15FFE7451134BD196E8BE5DC1B470DB070CD9A4D868784 │ │ │ │ │ -9D560B9080379424F1CBEBA1986A9F5E21E7AA1C9CD1165361EDDFF901221AA7 │ │ │ │ │ -0545888C15F53D2132BE33338560FB5E01AE8904ABDCDF8047CD5F054BFCA412 │ │ │ │ │ -B3FE3FB37C633AE4AAA3E71F9F41CB8BC1EAFA308C19D39EFD7008E536360D9D │ │ │ │ │ -1F665D9ED834B4A5222D1EDF78868BC3593773637682C80103657702DD5B8624 │ │ │ │ │ -BA573D7FECDAC78649DEF218C59A0E0DAD05606EB34E9EC890B3A5A0587E13A8 │ │ │ │ │ -CC887096A39EE7C3C09DADB530179C33D99DC44948178FF12C7638C7865FDDE2 │ │ │ │ │ -1A0864B9212D6CD6CB0E95BDE17A12719588573163583B680C054A33CC5F965F │ │ │ │ │ -B857FFD495D6B66E9D1A83A849AA358F094AE1480CBF69427ED2CAC9E7BA4AA7 │ │ │ │ │ -D5EA958F280A6F0F5A2DBBABA1D0A2083DE0903DCC0AEBA149460347B82CFCC1 │ │ │ │ │ -E61268495CEA15D022CA36AF9CC951A3385396DFF6A7E12A14789D86BD042214 │ │ │ │ │ -F0768544FBC5B242F6E15B3E0126E623559408C1130BA97F9115F290EEF0B8B2 │ │ │ │ │ -0FCC2A2609FFD6E6037E7C501F339C280ACE7914303C4744BD31B59876AC8A36 │ │ │ │ │ -432F4772425BA5A4BFC7DBCFDA17661CEA5FFF52C3C5BC7B8F21AC167A4E4D2C │ │ │ │ │ -18FA787D2EFB073695CDE85414431EEE1331A929B7894E8C7F5AAAE20E89BC1A │ │ │ │ │ -43BEE7AC14CC546E33BA7962A05FD45E9B148C4D1D61F8FA838AB3D8FD305059 │ │ │ │ │ -BF0EA67E86DC447C0281C0B527B4EE3CE9552984AD4231141A70530E56A109FB │ │ │ │ │ -71848E8E2787DE63403821465E1A84BDCE7BDD16FFF05440A44BAC0BD16C0662 │ │ │ │ │ -8D9A6C1C9ADDBFE6120B1B36BDDA328717CB6B90525CE31F7DCF6E6782692DF2 │ │ │ │ │ -EAA1086004A0FABB96361FB39967FE11940DC89649CD7385FB5770773014E983 │ │ │ │ │ -C36E7AFB1BDCFA1BD9878CA513211F7A8E9A9EFBDF446A88AC8EEF2E0EFC37E5 │ │ │ │ │ -9ACC5F3B63CEFC0D8A03417ADC5F8F58F32183F06BF095F35318A5BD3653B1AD │ │ │ │ │ -D884DC0CA7CC8E97D0F66A0D32F41BAC7FBBD36BD0097BF35A01B449C1FFD6EC │ │ │ │ │ -D39232432ADE942F75F0DFE550581805D276F5DAE18A6BD87F806766A66F6293 │ │ │ │ │ -C094E992F3097478180DD001C07072F2E26CE209EA9B0E6787B4AA41E916B7F6 │ │ │ │ │ -620615C18B5F83DA1FD760319D48951983A29D9D4D37E19FF42F61CCCDD7C2EA │ │ │ │ │ -FDD0B7AAE4907D7D7078B4B4F89EAF3B65B54CB91A6473C4 │ │ │ │ │ +2F3AD7547F9B0793E20128D03B122C74288283D9B583378FBA48950DCBDF887D │ │ │ │ │ +0A4C231FE009050F8A0C02473587E1D076F0BDC5458931FB26937C4EF7A7AB76 │ │ │ │ │ +DF14BDA8C5E27BDD9EC959C6F3FCF0C55E52847705744EE3D80EF426B9760775 │ │ │ │ │ +F4BD72DF213B715BE0AB9CEF5A9038E3EED7AF454E08ACBBD037E6307A04F331 │ │ │ │ │ +224C39B55908AC9FA0B8E560F8E78D5027B8266331C62EDF750CC08C0E2EB573 │ │ │ │ │ +082BB774BD853932B7C0C88BBE5F6E5E9D985792FA21B3180EE9911F823439DE │ │ │ │ │ +C430774263982682D4B1B76C287D1856702887A9A99B2B5A466FE6CC5B0851DF │ │ │ │ │ +EFBE62D59C80A0B97E81D0EEF577494C78F03924465B9042C7C6C1FD732CA57D │ │ │ │ │ +099755095F57ED2389501E3BF0969584ECE08D55FD8D7E95F92B4A0D405E5D61 │ │ │ │ │ +D10A7CF6B540B64594532EF90FA00CF28271462CB7F96D210E554AE29E510839 │ │ │ │ │ +53542C950DDB38150538212B66EB9D856C091C29F0ED5D450E3DF25F545CD977 │ │ │ │ │ +7A16FB983586A7485BAF18771087FD20117C3C79BD432F7275F6239D932484CA │ │ │ │ │ +C0D26D17C88E3B04FBF1D8381A24CBE5CBBDD3151147C92BBFA2F2306BA43A1D │ │ │ │ │ +07AA1A1481F74144F18F23F7A58B661F2E8646D6EFADE6F7EC39528B26AB15D2 │ │ │ │ │ +FEF17BFE1CB341B1460488AA896615225068E132694CF4F5D065CF5DF7846EDC │ │ │ │ │ +EE855FF20217F33287987F3B430D3B3AF43EB395477E59EEBB7A8B0F4592DAD4 │ │ │ │ │ +019E07E410E4A63681CE0AB5463BFF3A835C413683DAD77A9108E42379050128 │ │ │ │ │ +EAB57F7D6CBEE4C7BCD3AFD820EA0A256E945579B4434B0D4914EC13E3B73451 │ │ │ │ │ +929556467A733189B36F9178D0427D47474A9CE9F7F8682A667710D372A73D46 │ │ │ │ │ +F2AC3316AEC977F1B5AD90CEC4AF9C4D843B330F1AAA69E59FF3F15193A526CF │ │ │ │ │ +E230BB523164DDE3AEA0F933D98886092DC826EAFDFC823D673462C6CA799E69 │ │ │ │ │ +A65EB5EB85C8197553DAAC827E44DDE902737ECC9C587F6285A8181A4A91DBF8 │ │ │ │ │ +1278029BF62F90D985365D7E596BE6BE004526FEB277FF6CB89293E508A25D01 │ │ │ │ │ +F72DC43B2613CD296ABC2B3A53DC5B728267DD83A981D6E376BAB15B9271379B │ │ │ │ │ +2D3C5B28989263D183F65FB27C9707E54141D3C6D683F2262900C306473C0FAE │ │ │ │ │ +6BE58C8345839714B7F4DAA722EDC7DE41A356DB84760079C79096C18DC95B3C │ │ │ │ │ +811D59B5BF81CAF821C8A7757599BB691FBF093813D87517BA43CFA7FB0435BA │ │ │ │ │ +E0A4A9C641C3DAFDB34F0BD00FA334CEE80884420DC4BC7B3D654580D4652286 │ │ │ │ │ +4AF865E9FE13C3324817E98AC4B9AEFEB181E387800CB09180B13BCAA9D4BB0D │ │ │ │ │ +468DF2FD14BD3260CA8F41056AD693CAAA9EA1462A0B88CE042D0C09897111F6 │ │ │ │ │ +A0B609037E464AB8BE75B73746A943E5C1E1D1230C34A8C6BEAE9946C8650C65 │ │ │ │ │ +1DF35DC7DA75CC320EAF407B77894E2EB1D332944C84DF9E03336BBC5E441795 │ │ │ │ │ +25DE64A6962324DEFE9198545694A8E8436B61D4BE9262212CF36094EF28185B │ │ │ │ │ +718AA535A48F42BD62A063E7718AF28889122D3DE2A68E2FC78E906CCCA1E4DD │ │ │ │ │ +A30B29863F4F6DF2B9E1DAAF77898189A55F82E0C2A5F5E525C03402B8AFB5B3 │ │ │ │ │ +A744D0F900AE8864338D06B76F041250C450C993504DD364A20D1E0CF7FFB79B │ │ │ │ │ +0B4AC031B4A1873FA24C9388F365B18E5EFF110DD3501ADEE85BB2CF4A2EB34C │ │ │ │ │ +02EAD580BA5D7F2130F5AF72E64F67A9D809A8C393DDFBDE87D4FCFDC55FC6F3 │ │ │ │ │ +502EADE209DD34C5E0BB94C905017D83BEEF803F736D81655A62244AEDB74EC3 │ │ │ │ │ +74C3EDD4DB91B5F0EB05D67213912C6AFA13ABAC7F57B660AC19B7D66C5CA1FA │ │ │ │ │ +E10A8E92C0C8826ABFE8AF21AEA27ED46D072C0024F02436342D5368FD4CC04F │ │ │ │ │ +C0E122D14F81B7B99F9B518E6439BB65662FD3676A57324082801D3B4714E67B │ │ │ │ │ +F5B3004531BB9F556C9F09D0992B37A9586C01291510E35AE5C123502703D6C0 │ │ │ │ │ +4257C739FFC56031E910C142F67C79F575B93CE2DF4286E74B1E1114F25C560C │ │ │ │ │ +91EECDE3B49CDD4F0A02FDA860465BD3A9087C9676885AA49E47DCA274227AE5 │ │ │ │ │ +71FCF6DE34A03B733B5B07F0B867A26745F69C3C9D3185F136E65F4010FC280E │ │ │ │ │ +AB2918BDA2C8CC94F5EED3536057C23352AC93613C2B6E8A95A8674CC29D04CD │ │ │ │ │ +5DC6D7E4D4F744B62A297B794BB1A5504EA497C4FB1BED302844ECC142DEA152 │ │ │ │ │ +D0793F7BEA7EA26379B267F50D062F888751D242E98E3CCA863FB93FFE066057 │ │ │ │ │ +10F02D1B0354B5AF4BFAA3981AEAB4806E4FE146110B384570699B02491690B0 │ │ │ │ │ +E96213E0172DB8C92CD111E1E5391835D0A1E7162E501AEFFD89B99F3B0378B2 │ │ │ │ │ +5FBD8D80215F9430F1738267A5391D1594A011B22BE5553DAFF715FD7C22F0EC │ │ │ │ │ +5269060985392322AC2AFAD4DC639B0DD0DA4CC70F9671F19EEABF8BC19A101A │ │ │ │ │ +09DF245CDBD783AE474EB83CBE8C8B7C3553711A45BE836F65C86E0101924A27 │ │ │ │ │ +E0D5B981E866EE7469121BA486578A2DBCFA52F5628EBE7DF8B28345B7B079CF │ │ │ │ │ +CC7D5A46C41EC2E1E1B0CD08B9D0E5C2BCD0EF97CB154EB1E0AF9D471C006E10 │ │ │ │ │ +B4090820CE96DCE9ACE9394428C562E0D6ED27892BE472BAE3D9AFB58972A035 │ │ │ │ │ +72CDFF03289B56068449BCFD7E7E0A23C7E55134DBB6B5AA88477E0809F98B0D │ │ │ │ │ +8ECCE09DABE9E118234237A997664083951931B772C8A3F64DE26665851FC3DE │ │ │ │ │ +81814F48DA8CCC5549E0D5FC2DF3A53C3BF73F4D05F01DF5D0A5F1623371417D │ │ │ │ │ +422DB482A4C4681D435AA13F7D508E34DB1B3B611DFFC7DB816DB738AB768F39 │ │ │ │ │ +14FDAFB26C70976311BDEB4B55C3F55F050544C2279F095F824F7C455095DBE3 │ │ │ │ │ +BBC7032626D3883DA2CC72DE974C4AAB75D25FC1EA3D76ED2BC4F1E12B16DA2A │ │ │ │ │ +235618692B2B6D276D4844B2518219630F7D2AD889702D59FF966F438871FE63 │ │ │ │ │ +770A3A4FA57E9760C34A2D400DA892599C4CC2CC0E559116C94153DE1F5FE4A6 │ │ │ │ │ +504B69B18B9D4436DE526F4644DD10A8D98548E5957AEAE66DC69F358FA63793 │ │ │ │ │ +03F43B39D8CE06BA249DE0EF286712173345F1A1BB14B5D93B49BB3082FA85B8 │ │ │ │ │ +3689F44B84B7693CF1826BF8EDCFE28C5BFF66652DBF12D75959AE6B8F0BD52A │ │ │ │ │ +F73A5F79ED8DDE0BFB75C729A35D86F0859C08CC6B9482B2EB5F1391D0C39A3E │ │ │ │ │ +51C398F56A2FF39730FD46F9A4B566BAB4642BD5AF114D36C621468BE230866B │ │ │ │ │ +3516F15FE475464C6FB272AA3981BFC7C703C675DE2615785618F66ECBA438C9 │ │ │ │ │ +E895BB7379ADF7DBE1C1A98B1C4E939A3DD85939EC795AE74469F15A39813A57 │ │ │ │ │ +EF18767C21CE6751F13A7AAA606B142AAD810C86BC9801A445CE7DCA13753D90 │ │ │ │ │ +DDE464649D95844D0103A7863F2A60EECF6BEDC92ABF2646B99B76FF09E660CF │ │ │ │ │ +8BD53D2630DA8B51083A6C26C2358B3A1F7C027B98B2F67FF54C3905EAC112C4 │ │ │ │ │ +1A67553090DBB080EB95F6750B1DF9F4914F8627CD9E507C91278B341C2B291A │ │ │ │ │ +571C38E8E09BB780E763A39148C4A3A7676F592063A821A40DAB5B17306ED14A │ │ │ │ │ +FCB59587AF57E2C899E79216348895AF088C65543AE23BAEF8E4F062AFF32AE5 │ │ │ │ │ +00C72FF6B5E8D1F4E29034ADAEEA8AEBF7FB2467FBF53179E55D843FB141BF71 │ │ │ │ │ +247F47E29AFCB13FBC43B953001D475194775E9757F04B8A0DAC08DDEE1DE013 │ │ │ │ │ +6F5D78BD07CD15205944D01CCC01BE604CCF51E26020CC4024628056A672808E │ │ │ │ │ +4E2648D1088683A7F999555B65D2504FE96627E2B40DD319F85178CB1DB098F4 │ │ │ │ │ +9687A547F676D317890482732284E0F00CB1E811A438ADB32B29AE4FC6B0A729 │ │ │ │ │ +E03B6D857CE2F506D7ADF2D4D13BDC491D220B214775AEC6965CB8F2F9E34EB2 │ │ │ │ │ +AD05DA5A9CDF721C221C0C8712E5D2C72AB5DA54E17860F7AF5AE664A9E4D05E │ │ │ │ │ +AC5495F91538ED0542F9039A9EC8D4926FCC4B0A1EA511CD6A54B9EB9C8C433F │ │ │ │ │ +33C948A53227BFE6D9741D2C380CF6B5A593C41030EE2495DC5CD19E2AED0EC0 │ │ │ │ │ +C86E6B70839CF22E626747C35A8DE85567878980F5CF2AB47638B2E1651A1E14 │ │ │ │ │ +72B7D11BFF7523B5B9ADFB4AF11DD2FEAB05080EFC6470683E411CA8817A388D │ │ │ │ │ +AF19054CC504CDC7171DA9316C504AA1B0981AFE60C32AB64EC4ACA26AD12ED3 │ │ │ │ │ +C56BEC23734FFF9FB13009121EBAC83EE3B754F346FAB890865B9EBC4B003780 │ │ │ │ │ +5A4767EF7A53F83648C7B81DB97FFC40AE430FD74140DDFD659F95E21A40AF75 │ │ │ │ │ +E4505D48034EFA896DD4FB37D783A4B29D11D3FE830D0905502C5D84A3DEFEFD │ │ │ │ │ +15D070733A0364F8DB24A124C3E465FB2C13B34C73C8B9873E0EA05BF5E0B3A0 │ │ │ │ │ +E877FD6B7D5E7B05CED3C019D434A6B50BECB9C243FE202644F385EA28F0B947 │ │ │ │ │ +9E4C5F533AD8AFD03436C54CE958D95C5ABB10E37D957333B9D7145FBA7B3363 │ │ │ │ │ +4B732DC6E00F9A368FBA880641CC2097EFFB9F6DB38FC89173F99133E63B4A2B │ │ │ │ │ +FD3E4A7C757360AED6100CD7766F5480F30EF00BA4D8618462E65D0A075F482A │ │ │ │ │ +CBBAB4D2AEA288558E6FBDBBAC5FF1253237E9E94AE4AF5AC5169F875961B152 │ │ │ │ │ +640DC17355053C0DDA65B9494CF26F5D36DC26B557C4B129FA58D12D3E5E59E7 │ │ │ │ │ +4D69BDB6E4C8FB8FF90E66FCDF8B608C62FB41FFAC5BCF048E713C0C6A1ABEA8 │ │ │ │ │ +5E8670F6BD5E005948107075B6566BAFA622311038C43F860773BC5509E19047 │ │ │ │ │ +131EBADF5A47F5B05178FB0DB581072D37826ED3E95AD23DF2F66A55660CD217 │ │ │ │ │ +2A47F6E6D6443F3EBA50C3BDC5A69DD6A61A42A7FC3FEF3DC3F7FD2AC6F72010 │ │ │ │ │ +D5C3274E2714BBF952A4EF77B349C1629C5C09A1468AC07AECC81107F2851241 │ │ │ │ │ +AF0499C528F1B992ACD5121E1DBEA4DF70C48BEE3BC362BCABEAFF7F1E48D857 │ │ │ │ │ +A4F3C29D04DDE8B07E7A3439007761AB2C474BCE66967F5B216C4601CFBEE2D6 │ │ │ │ │ +824C7E03D3B97CF3EFC226BC89AF72D01AC6360B46B7A8E5231F3C80A8073271 │ │ │ │ │ +D87BF67E051974B40A87061315A7DBB1CA1BDF2C81E39A19441DEA3A70A3D097 │ │ │ │ │ +506FE45862E07725A1F3BDB0BD782D4DC9BE5CE29AD48983F81D54C920CFE517 │ │ │ │ │ +2918A8AF79DA58094D85E6A26797866D8E83B22E660BFAE1E6B27A0EF8B449C9 │ │ │ │ │ +2FE90B705A27E46AD030B9FE41093E8E40CE9432FF29F76503BB4F2DD001E941 │ │ │ │ │ +A5088CA474254A3818E34DEE67CF713565AC1F1C24EB4F1164320FF51E9D8E82 │ │ │ │ │ +4372C7364F9E55BEFDA682D575837B1EBD5F8C77074B9A6194F6F4BAC3612824 │ │ │ │ │ +E37D959992A8ABFEAF3A0FCB43A77F6F0EED86EAD0D9DECB187FDC9A8FFDCFB7 │ │ │ │ │ +AB2C84245C7A4020674EF294D57BC49FF57774CAA14F730281BAFC514F1D43CD │ │ │ │ │ +B5DD4613D6C03A5EB6915A8BF7E1676B26E104F6222ADE32146788B28A1B0E6F │ │ │ │ │ +91EB5AA47D4735CB95FA0E2317C7A03EDEDDB8DBB48CF159C1741A481F2E3E9E │ │ │ │ │ +1C6A1D3DB6ED194B74CA50263794F194912CB6EA723E483A4FDFF20B8788E3DD │ │ │ │ │ +E993EC0C862DA9326C4188EF5E0C0214B22F6FB8CC3F987769FE60D3307D12D9 │ │ │ │ │ +F8632A23B3102E5D9FAB0FE63BBC69DF113FC2532F809A64E2354F4ACEC13A76 │ │ │ │ │ +2A065DF4C206A8F09FE0D3E9ABB5A18C54421C9E11DCE00F35C473E3C929C169 │ │ │ │ │ +4E35F874CBE9AB2BEA459E92532122D9CDD591A7CD1CC340E327D549114F5846 │ │ │ │ │ +2DDDE50F30859FE9EA5B1E4471832298DAA6D154C2019E5E4A5B5DF7B94C04AF │ │ │ │ │ +CA68C6D984ECAE4E541E8370A3679FC31BA3AE9ECCA27914CCB51815E9276593 │ │ │ │ │ +3B0657C569BFB5918FB504A23CA305A461FBE5D95A68891897759EE94E542750 │ │ │ │ │ +DEF176E479D35AAA092A9C03E35F1173C46FABD7835B7DB9D5D7829D4A6B1044 │ │ │ │ │ +18D7886BCAD7869D4E689C397FB07B4A5A8612CD1F25EC1922E75C2DA1A65A47 │ │ │ │ │ +5CA2DBBFF618FCD63F1E315204DC5A36A02D68E5D5F7AD9636BDCB399D9A907F │ │ │ │ │ +C8A322286DE5EAFCEC1CCF68059598FADCF0D049A06D1DEA23A6F94ADBAE209D │ │ │ │ │ +D400CD889B709CDE5D6AF969299F291DDDF09463E75C355B1598F1CDD06F1382 │ │ │ │ │ +43A5846959DDC099AE96F6F25D681E39D1D59E3F754C5DF873E004C7FDC443C3 │ │ │ │ │ +F0087430BCDBDD51AB3BB7212D585E057DAE1628630A360D54FB3283AD67CF89 │ │ │ │ │ +B2B99AE933765B41F1A1F474F6A01799E42E156F143B794AEE007F559FBFA959 │ │ │ │ │ +CBD4E94D1ECC3C4B763DD83F69D31520A3E706A0F53E5DB35BB8A189A4031954 │ │ │ │ │ +68FDB0FDC7589740E324511B5F8C63181B37DB5731FBB99FC8521FB2851588C3 │ │ │ │ │ +67EB915D26B13F1E78568D17B66ADF629585D9D3908493B92C196EC9068A09BF │ │ │ │ │ +B1B1C4B053E5E2A7460B8401B05AD70438D8DE95D399B2B2392599FA9D28D162 │ │ │ │ │ +CDD3610EC8A5A29101DC4985462FA606005FF3C8741C19BDBA45840193D0209D │ │ │ │ │ +F9F9638A40918DD9A69771EE8D2C37AC1B2A3FB4523710B849B07F5777B063B2 │ │ │ │ │ +05518DB190747403E5E68E133A7521C9847FF4D9ED9EC71872FD82BCA1AD2F6D │ │ │ │ │ +74045E88DE4B6F0905BFFC79CBCFB6A5CF42EAC9016AE993640E929E017A080D │ │ │ │ │ +8A6DEA1597024375B5EB3CB1C6F10A4DA7730CB0FCCFFED652106588E4987F70 │ │ │ │ │ +A339E2B425E9EB8E376ADC57D4A779C0CBFB654472C4365557C8367AB68C8409 │ │ │ │ │ +9DB13509A991794956B5C3D0CE65A1E8701D27FA926B4B35B6FB5AD35C5F634E │ │ │ │ │ +FFC1BE9F28D7063FCBA1A0C81801838FC9D80C745B6E4047A89278AB664D510D │ │ │ │ │ +41AB024B3868C0DD77379D0CE5F8EFA8B1147B262FB3B20E7C08784045D4A208 │ │ │ │ │ +AD8AF3A6E2FA183F98E8FAF1F824C59A443DACE43316CE02211ADFC0C01E4208 │ │ │ │ │ +AD0B5F49B1F50B29FAE8601444C0B40B4D9CED06242E807479382B3EAD36FCCC │ │ │ │ │ +5988963A756977FB7536B83B5838282EEBA0E5975B697EE938FDBEEEB4D8FD8B │ │ │ │ │ +68B56C35077987EDFEBDD4627BB44AF71201A7ED3D843701599932C660CB6C0C │ │ │ │ │ +5607EF729849C3A1CA55F3A214D0CAC57BDD43A269DC3A4CCE7C3DBC074DEB27 │ │ │ │ │ +C73125E1C9C54B7FA02E1BD5FFB1F2537FE0E17AB6FDFBE7AE4F0CF25A6B21BC │ │ │ │ │ +4EE6838C8EA01560DB323B7F7D67AF470FC02BF88D0DE7FB0E3EA1E5F0162156 │ │ │ │ │ +55A59CAA0D46F3AC4C901EB7FFF476E99BB67E1AD5F033336FD324467E699A8D │ │ │ │ │ +5D837B9AA9A84592E201B7D1DDB1210A0E4F0A7F0967ACCC7A86E8487654541C │ │ │ │ │ +BC645D64 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -7543,16 +7531,16 @@ │ │ │ │ │ 44 44 44 44 44 1[44 44 44 44 44 2[44 44 44 44 44 44 1[44 │ │ │ │ │ 44 2[44 44 1[44 44 44 44 44 44 44 44 44 44 44 44 44 44 │ │ │ │ │ 44 44 1[44 44 44 2[44 37[{}70 83.022 /CMTT10 rf /Fh 141[51 │ │ │ │ │ 1[51 7[51 6[51 25[51 71[{}5 99.6264 /CMTT12 rf /Fi 135[59 │ │ │ │ │ 2[62 44 44 46 1[62 56 62 93 31 1[34 31 62 56 34 51 62 │ │ │ │ │ 50 62 54 10[85 1[78 62 84 11[70 2[81 1[85 11[56 56 56 │ │ │ │ │ 56 56 2[31 46[{}33 99.6264 /CMBX12 rf /Fj 134[44 3[46 │ │ │ │ │ -32 33 33 2[42 46 4[23 1[42 1[37 46 1[46 42 12[60 4[65 │ │ │ │ │ -8[54 13[42 2[42 2[42 1[42 3[23 44[{}21 83.022 /CMSL10 │ │ │ │ │ +32 33 33 2[42 46 4[23 1[42 1[37 46 2[42 12[60 4[65 4[43 │ │ │ │ │ +3[54 14[42 2[42 1[42 1[42 3[23 44[{}21 83.022 /CMSL10 │ │ │ │ │ rf /Fk 133[31 37 37 51 37 39 27 28 28 1[39 35 39 59 20 │ │ │ │ │ 2[20 39 35 22 31 39 31 39 35 9[72 53 1[51 39 52 1[48 │ │ │ │ │ 55 1[65 44 2[25 53 3[54 51 50 53 3[55 3[35 35 35 35 35 │ │ │ │ │ 35 35 35 35 35 1[20 24 20 31[39 12[{}53 66.4176 /CMR8 │ │ │ │ │ rf │ │ │ │ │ %DVIPSBitmapFont: Fl tcrm0600 6 1 │ │ │ │ │ /EN0 load IEn S/IEn X FBB FMat/FMat[0.02 0 0 -0.02 0 │ │ │ │ │ @@ -7585,16 +7573,16 @@ │ │ │ │ │ 0780FC0C0FC07F0C3F803F8C7F0007CCF80001FFE000007F8000001E0000007F800001FF │ │ │ │ │ E00007CCF8003F8C7F007F0C3F80FC0C0FC0781E0780601E0180001E0000001E0000001E │ │ │ │ │ 0000001E0000001E0000000C00001A1D7C9E23>42 D E │ │ │ │ │ /Ft load 0 Ft currentfont 66.6667 scalefont put/FMat │ │ │ │ │ X/FBB X/IEn X │ │ │ │ │ %EndDVIPSBitmapFont │ │ │ │ │ /Fu 134[51 2[51 54 38 38 38 1[54 49 54 1[27 2[27 54 49 │ │ │ │ │ -30 43 54 43 54 49 13[54 11[77 64 2[70 69 73 8[49 2[49 │ │ │ │ │ -2[49 1[49 3[27 44[{}30 99.6264 /CMR12 rf /Fv 139[51 52 │ │ │ │ │ +30 43 54 43 1[49 13[54 8[50 2[77 3[70 69 73 9[49 2[49 │ │ │ │ │ +1[49 1[49 3[27 44[{}29 99.6264 /CMR12 rf /Fv 139[51 52 │ │ │ │ │ 51 1[73 66 73 111 3[36 1[66 40 58 73 58 1[66 12[96 73 │ │ │ │ │ 3[103 1[122 6[86 70[{}19 143.462 /CMR17 rf end │ │ │ │ │ %%EndProlog │ │ │ │ │ %%BeginSetup │ │ │ │ │ %%Feature: *Resolution 600dpi │ │ │ │ │ TeXDict begin │ │ │ │ │ %%BeginPaperSize: Letter │ │ │ │ │ @@ -7605,88 +7593,88 @@ │ │ │ │ │ %%EndPaperSize │ │ │ │ │ end │ │ │ │ │ %%EndSetup │ │ │ │ │ %%Page: 1 1 │ │ │ │ │ TeXDict begin 1 0 bop 333 739 a Fv(Ordering)44 b(Sparse)f(Matrices)g │ │ │ │ │ (and)h(T)-11 b(ransforming)41 b(F)-11 b(ron)l(t)43 b(T)-11 │ │ │ │ │ b(rees)958 1023 y Fu(Clev)m(e)35 b(Ashcraft,)e(Bo)s(eing)f(Shared)i │ │ │ │ │ -(Services)g(Group)2942 987 y Ft(*)1590 1262 y Fu(F)-8 │ │ │ │ │ -b(ebruary)33 b(8,)g(2025)0 1924 y Fs(1)135 b(In)l(tro)t(duction)0 │ │ │ │ │ -2165 y Fr(If)38 b(the)g(ultimate)g(goal)f(is)g(to)h(solv)n(e)e(linear)h │ │ │ │ │ +(Services)g(Group)2942 987 y Ft(*)1611 1261 y Fu(Jan)m(uary)f(7,)f │ │ │ │ │ +(2024)0 1923 y Fs(1)135 b(In)l(tro)t(duction)0 2165 y │ │ │ │ │ +Fr(If)38 b(the)g(ultimate)g(goal)f(is)g(to)h(solv)n(e)e(linear)h │ │ │ │ │ (systems)g(of)h(the)g(form)f Fq(AX)46 b Fr(=)40 b Fq(B)t │ │ │ │ │ Fr(,)g(one)d(m)n(ust)h(compute)g(an)f Fq(A)j Fr(=)g Fq(LD)r(U)9 │ │ │ │ │ -b Fr(,)0 2265 y Fq(A)25 b Fr(=)e Fq(U)241 2234 y Fp(T)294 │ │ │ │ │ -2265 y Fq(D)r(U)37 b Fr(or)27 b Fq(A)e Fr(=)f Fq(U)803 │ │ │ │ │ -2234 y Fp(H)865 2265 y Fq(D)r(U)38 b Fr(factorization,)27 │ │ │ │ │ +b Fr(,)0 2264 y Fq(A)25 b Fr(=)e Fq(U)241 2234 y Fp(T)294 │ │ │ │ │ +2264 y Fq(D)r(U)37 b Fr(or)27 b Fq(A)e Fr(=)f Fq(U)803 │ │ │ │ │ +2234 y Fp(H)865 2264 y Fq(D)r(U)38 b Fr(factorization,)27 │ │ │ │ │ b(dep)r(ending)i(on)f(whether)g(the)h(matrix)e Fq(A)i │ │ │ │ │ Fr(is)f(nonsymmetric,)g(symmetric)0 2364 y(or)34 b(Hermitian.)57 │ │ │ │ │ b Fq(D)37 b Fr(is)d(a)g(diagonal)f(or)g(blo)r(c)n(k)h(diagonal)f │ │ │ │ │ (matrix,)j Fq(L)e Fr(is)g(unit)i(lo)n(w)n(er)c(triangular,)j(and)f │ │ │ │ │ -Fq(U)43 b Fr(is)35 b(unit)g(upp)r(er)0 2464 y(triangular.)54 │ │ │ │ │ +Fq(U)43 b Fr(is)35 b(unit)g(upp)r(er)0 2463 y(triangular.)54 │ │ │ │ │ b Fq(A)34 b Fr(is)g(sparse,)g(but)g(the)g(sparsit)n(y)f(structure)g(of) │ │ │ │ │ h Fq(L)f Fr(and)h Fq(U)43 b Fr(will)34 b(lik)n(ely)f(b)r(e)h(m)n(uc)n │ │ │ │ │ (h)g(larger)e(than)i(that)g(of)g Fq(A)p Fr(,)0 2563 y(i.e.,)27 │ │ │ │ │ b(they)h(will)f(su\013er)g(\014ll-in.)37 b(It)27 b(is)g(crucial)f(to)h │ │ │ │ │ (\014nd)h(a)f(p)r(erm)n(utation)f(matrix)h(suc)n(h)g(that)g(the)g │ │ │ │ │ (factors)f(of)h Fq(P)12 b(AP)3555 2533 y Fp(T)3635 2563 │ │ │ │ │ y Fr(ha)n(v)n(e)26 b(as)0 2663 y(mo)r(derate)h(\014ll-in)h(as)f(can)g │ │ │ │ │ (b)r(e)h(reasonably)d(exp)r(ected.)125 2806 y(T)-7 b(o)32 │ │ │ │ │ b(illustrate,)h(consider)f(a)g(27-p)r(oin)n(t)g(\014nite)h │ │ │ │ │ (di\013erence)f(op)r(erator)f(de\014ned)i(on)g(an)f Fq(n)22 │ │ │ │ │ b Fo(\002)f Fq(n)h Fo(\002)f Fq(n)32 b Fr(grid.)52 b(The)32 │ │ │ │ │ -b(n)n(um)n(b)r(er)0 2906 y(of)e(ro)n(ws)f(and)i(columns)f(in)h │ │ │ │ │ -Fq(A)f Fr(is)h Fq(n)1112 2876 y Fn(3)1149 2906 y Fr(,)g(as)f(is)g(the)h │ │ │ │ │ +b(n)n(um)n(b)r(er)0 2905 y(of)e(ro)n(ws)f(and)i(columns)f(in)h │ │ │ │ │ +Fq(A)f Fr(is)h Fq(n)1112 2875 y Fn(3)1149 2905 y Fr(,)g(as)f(is)g(the)h │ │ │ │ │ (n)n(um)n(b)r(er)f(of)h(nonzero)e(en)n(tries)h(in)g Fq(A)p │ │ │ │ │ Fr(.)46 b(Using)31 b(the)f(natural)g(ordering,)g(the)0 │ │ │ │ │ -3006 y(n)n(um)n(b)r(ers)e(of)g(en)n(tries)g(in)h Fq(L)f │ │ │ │ │ +3005 y(n)n(um)n(b)r(ers)e(of)g(en)n(tries)g(in)h Fq(L)f │ │ │ │ │ Fr(and)g Fq(U)37 b Fr(are)28 b Fq(O)r Fr(\()p Fq(n)1424 │ │ │ │ │ -2975 y Fn(5)1462 3006 y Fr(\),)h(and)f(it)h(tak)n(es)e │ │ │ │ │ -Fq(O)r Fr(\()p Fq(n)2152 2975 y Fn(7)2190 3006 y Fr(\))i(op)r(erations) │ │ │ │ │ +2975 y Fn(5)1462 3005 y Fr(\),)h(and)f(it)h(tak)n(es)e │ │ │ │ │ +Fq(O)r Fr(\()p Fq(n)2152 2975 y Fn(7)2190 3005 y Fr(\))i(op)r(erations) │ │ │ │ │ e(to)i(compute)f(the)h(factorization.)38 b(The)0 3105 │ │ │ │ │ y(banded)28 b(and)f(pro\014le)g(orderings)f([11)o(])h(ha)n(v)n(e)g(the) │ │ │ │ │ h(same)f(complexit)n(y)-7 b(.)125 3248 y(Using)30 b(the)h(nested)g │ │ │ │ │ (dissection)f(ordering,)g([10)o(],)i(the)f(factor)f(storage)e(is)j │ │ │ │ │ (reduced)f(to)h Fq(O)r Fr(\()p Fq(n)3017 3218 y Fn(4)3055 │ │ │ │ │ 3248 y Fr(\))g(and)g(factor)e(op)r(erations)0 3348 y(to)38 │ │ │ │ │ -b Fq(O)r Fr(\()p Fq(n)259 3318 y Fn(6)297 3348 y Fr(\).)67 │ │ │ │ │ +b Fq(O)r Fr(\()p Fq(n)259 3317 y Fn(6)297 3348 y Fr(\).)67 │ │ │ │ │ b(In)38 b(practice,)h(the)f(minim)n(um)g(degree)f(ordering)f(has)h │ │ │ │ │ (this)h(same)f(lo)n(w-\014ll)g(nature,)j(although)d(top)r(ological)0 │ │ │ │ │ -3448 y(coun)n(terexamples)28 b(exist)i([7].)44 b(A)31 │ │ │ │ │ +3447 y(coun)n(terexamples)28 b(exist)i([7].)44 b(A)31 │ │ │ │ │ b(unit)f(cub)r(e)h(is)f(the)g(w)n(orst)f(case)g(comparison)g(b)r(et)n │ │ │ │ │ (w)n(een)h(banded)g(and)g(pro\014le)f(orderings)0 3547 │ │ │ │ │ y(and)35 b(the)g(minim)n(um)h(degree)e(and)h(nested)g(dissection)g │ │ │ │ │ (orderings.)57 b(But,)38 b(there)d(is)g(still)g(a)g(lot)g(to)g(b)r(e)g │ │ │ │ │ -(gained)g(b)n(y)f(using)0 3647 y(a)e(go)r(o)r(d)g(p)r(erm)n(utation)g │ │ │ │ │ +(gained)g(b)n(y)f(using)0 3646 y(a)e(go)r(o)r(d)g(p)r(erm)n(utation)g │ │ │ │ │ (when)g(solving)g(most)g(sparse)f(linear)g(systems,)j(and)e(the)h │ │ │ │ │ (relativ)n(e)e(gain)g(b)r(ecomes)h(larger)f(as)h(the)0 │ │ │ │ │ -3746 y(problem)27 b(size)g(increases.)125 3890 y(This)37 │ │ │ │ │ +3746 y(problem)27 b(size)g(increases.)125 3889 y(This)37 │ │ │ │ │ b(short)g(pap)r(er)h(is)f(a)h(gen)n(tle)f(in)n(tro)r(duction)h(to)f │ │ │ │ │ (the)i(ordering)d(metho)r(ds)i(|)g(the)g(bac)n(kground)e(as)h(w)n(ell)h │ │ │ │ │ (as)f(the)0 3989 y(sp)r(eci\014c)29 b(function)g(calls.)40 │ │ │ │ │ b(But)29 b(\014nding)g(a)f(go)r(o)r(d)g(ordering)f(is)i(not)g(enough.) │ │ │ │ │ 39 b(The)29 b(\\c)n(horeograph)n(y")c(of)j(the)h(factorization)0 │ │ │ │ │ 4089 y(and)h(solv)n(es,)g(i.e.,)h(what)f(data)g(structures)f(and)h │ │ │ │ │ (computations)g(exist,)h(and)f(in)g(a)g(parallel)f(en)n(vironmen)n(t,)h │ │ │ │ │ (whic)n(h)h(thread)0 4188 y(or)24 b(pro)r(cessor)f(do)r(es)h(what)h │ │ │ │ │ (and)g(when,)h(is)e(as)h(crucial.)35 b(The)25 b(structure)f(of)h(the)g │ │ │ │ │ (factor)f(matrices,)h(as)f(w)n(ell)h(as)f(the)i(structure)0 │ │ │ │ │ 4288 y(of)k(the)g(computations)f(is)h(con)n(trolled)e(b)n(y)i(a)f │ │ │ │ │ (\\fron)n(t)g(tree".)43 b(This)29 b(ob)5 b(ject)30 b(is)g(constructed)f │ │ │ │ │ -(directly)g(b)n(y)h(the)g Fm(SPOOLES)0 4388 y Fr(ordering)k(soft)n(w)n │ │ │ │ │ +(directly)g(b)n(y)h(the)g Fm(SPOOLES)0 4387 y Fr(ordering)k(soft)n(w)n │ │ │ │ │ (are,)h(or)f(can)h(b)r(e)h(created)e(from)h(the)h(graph)e(of)h(the)h │ │ │ │ │ (matrix)f(and)g(an)g(outside)g(p)r(erm)n(utation.)59 │ │ │ │ │ b(V)-7 b(arious)0 4487 y(transformations)25 b(on)i(the)h(fron)n(t)e │ │ │ │ │ (tree)h(can)g(mak)n(e)f(a)h(large)e(di\013erence)j(in)f(p)r │ │ │ │ │ (erformance.)36 b(Some)26 b(kno)n(wledge)g(of)h(the)h(linear)0 │ │ │ │ │ 4587 y(system,)f(\(e.g.,)g(do)r(es)g(it)h(come)f(from)g(a)g(2-D)g(or)f │ │ │ │ │ (3-D)h(problem?)36 b(is)27 b(it)h(small)f(or)f(large?\),)h(coupled)g │ │ │ │ │ -(with)h(some)e(kno)n(wledge)0 4687 y(of)i(ho)n(w)f(to)g(tailor)g(a)g │ │ │ │ │ +(with)h(some)e(kno)n(wledge)0 4686 y(of)i(ho)n(w)f(to)g(tailor)g(a)g │ │ │ │ │ (fron)n(t)g(tree,)g(can)h(b)r(e)g(imp)r(ortan)n(t)f(to)g(getting)h(the) │ │ │ │ │ g(b)r(est)g(p)r(erformance)e(from)h(the)h(library)-7 │ │ │ │ │ -b(.)125 4830 y(Section)38 b(2)g(in)n(tro)r(duces)f(some)h(bac)n │ │ │ │ │ +b(.)125 4829 y(Section)38 b(2)g(in)n(tro)r(duces)f(some)h(bac)n │ │ │ │ │ (kground)e(on)i(sparse)f(matrix)h(orderings)e(and)j(describ)r(es)e(the) │ │ │ │ │ i Fm(SPOOLES)f Fr(or-)0 4929 y(dering)f(soft)n(w)n(are.)64 │ │ │ │ │ b(Section)38 b(3)e(presen)n(ts)h(the)h(fron)n(t)f(tree)g(ob)5 │ │ │ │ │ b(ject)37 b(that)h(con)n(trols)d(the)j(factorization,)h(and)e(its)g(v) │ │ │ │ │ -5 b(arious)0 5029 y(transformations)26 b(to)h(impro)n(v)n(e)f(p)r │ │ │ │ │ (erformance.)p 0 5173 1560 4 v 92 5226 a Fl(*)127 5249 │ │ │ │ │ y Fk(P)-6 b(.)33 b(O.)g(Bo)n(x)h(24346,)j(Mail)32 b(Stop)i(7L-21,)i │ │ │ │ │ @@ -7694,16 +7682,16 @@ │ │ │ │ │ b(researc)n(h)i(w)n(as)g(supp)r(orted)g(in)f(part)h(b)n(y)g(the)g(D)n │ │ │ │ │ (ARP)-6 b(A)0 5328 y(Con)n(tract)33 b(D)n(ABT63-95-C-0122)f(and)g(the)g │ │ │ │ │ (DoD)g(High)f(P)n(erformance)h(Computing)g(Mo)r(dernization)g(Program)f │ │ │ │ │ (Common)h(HPC)f(Soft)n(w)n(are)0 5407 y(Supp)r(ort)25 │ │ │ │ │ b(Initiativ)n(e.)1929 5656 y Fr(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ TeXDict begin 2 1 bop 0 100 a Fr(2)327 b Fj(Orderings)26 │ │ │ │ │ -b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1762 │ │ │ │ │ -4 v 1955 w(F)g(ebruary)27 b(8,)g(2025)0 390 y Fs(2)135 │ │ │ │ │ +b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1797 │ │ │ │ │ +4 v 1990 w(Jan)n(uary)26 b(7,)h(2024)0 390 y Fs(2)135 │ │ │ │ │ b(Sparse)45 b(matrix)h(orderings)0 605 y Fr(The)22 b(past)h(few)f(y)n │ │ │ │ │ (ears)f(ha)n(v)n(e)g(seen)h(a)g(resurgence)f(of)i(in)n(terest)f(and)g │ │ │ │ │ (accompan)n(ying)e(impro)n(v)n(emen)n(t)h(in)i(algorithms)e(and)h │ │ │ │ │ (soft-)0 705 y(w)n(are)27 b(to)i(order)e(sparse)g(matrices.)39 │ │ │ │ │ b(The)29 b(minim)n(um)g(degree)f(algorithm,)f(sp)r(eci\014cally)h(the)h │ │ │ │ │ (m)n(ultiple)h(external)d(minim)n(um)0 804 y(degree)c(algorithm)g([19)o │ │ │ │ │ (],)h(w)n(as)f(the)i(preferred)d(algorithm)h(of)h(c)n(hoice)f(for)g │ │ │ │ │ @@ -7806,16 +7794,16 @@ │ │ │ │ │ y(matrices\),)27 b(there)h(is)f(an)g(easier)g(w)n(a)n(y)-7 │ │ │ │ │ b(.)35 b(One)28 b(can)f(create)g(an)g Fg(IVL)f Fr(ob)5 │ │ │ │ │ b(ject)28 b(from)f(the)h Fg(InpMtx)d Fr(ob)5 b(ject,)27 │ │ │ │ │ b(as)g(follo)n(ws.)0 5108 y Fg(InpMtx)128 b(*A)43 b(;)0 │ │ │ │ │ 5208 y(IVL)260 b(*adjIVL)41 b(;)0 5407 y(adjIVL)g(=)i │ │ │ │ │ (InpMtx_fullAdjace)o(nc)o(y\(A)o(\))37 b(;)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 0 100 a Fj(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -696 100 1790 4 v 1953 w(Orderings)e(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 3 2 bop 0 100 a Fj(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1825 4 v 1988 w(Orderings)f(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ b(T)-7 b(rees)326 b Fr(3)881 448 y(Figure)27 b(1:)36 │ │ │ │ │ b(A)28 b(3)18 b Fo(\002)g Fr(4)27 b(9-p)r(oin)n(t)g(grid)g(with)h(its)g │ │ │ │ │ (adjacency)f(structure)p 481 1707 119 4 v 670 1707 V │ │ │ │ │ 481 1519 V 670 1519 V 481 1330 V 670 1330 V 481 1141 │ │ │ │ │ V 670 1141 V 446 1659 4 95 v 635 1659 V 824 1659 V 446 │ │ │ │ │ 1470 V 635 1470 V 824 1470 V 446 1281 V 635 1281 V 824 │ │ │ │ │ 1281 V 427 1733 a(0)147 b(1)g(2)427 1544 y(3)g(4)g(5)427 │ │ │ │ │ @@ -7868,16 +7856,16 @@ │ │ │ │ │ b(w)n(e)g(ha)n(v)n(e)g(a)g Fg(Graph)f Fr(ob)5 b(ject,)27 │ │ │ │ │ b(w)n(e)g(can)g(construct)h(an)f(ordering.)35 b(There)27 │ │ │ │ │ b(are)g(four)g(c)n(hoices:)125 5407 y Ff(\210)42 b Fr(minim)n(um)28 │ │ │ │ │ b(degree,)e(\(actually)i(m)n(ultiple)g(external)f(minim)n(um)h(degree,) │ │ │ │ │ e(from)i([19)o(]\),)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ TeXDict begin 4 3 bop 0 100 a Fr(4)327 b Fj(Orderings)26 │ │ │ │ │ -b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1762 │ │ │ │ │ -4 v 1955 w(F)g(ebruary)27 b(8,)g(2025)125 390 y Ff(\210)42 │ │ │ │ │ +b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1797 │ │ │ │ │ +4 v 1990 w(Jan)n(uary)26 b(7,)h(2024)125 390 y Ff(\210)42 │ │ │ │ │ b Fr(generalized)26 b(nested)h(dissection,)125 571 y │ │ │ │ │ Ff(\210)42 b Fr(m)n(ultisection,)27 b(and)125 752 y Ff(\210)42 │ │ │ │ │ b Fr(the)28 b(b)r(etter)g(of)f(generalized)f(nested)i(dissection)f(and) │ │ │ │ │ h(m)n(ultisection.)0 954 y(Minim)n(um)g(degree)f(tak)n(es)f(the)i │ │ │ │ │ (least)f(amoun)n(t)h(of)f(CPU)h(time.)37 b(Generalized)27 │ │ │ │ │ b(nested)g(dissection)h(and)f(m)n(ultisection)h(b)r(oth)0 │ │ │ │ │ 1054 y(require)c(the)i(a)e(partition)h(of)g(the)h(graph,)e(whic)n(h)i │ │ │ │ │ @@ -7948,16 +7936,16 @@ │ │ │ │ │ (great)g(deal)h(of)g(monitoring)g(and)g(debug)g(co)r(de)g(in)g(the)h │ │ │ │ │ (soft)n(w)n(are.)37 b(Large)26 b(v)-5 b(alues)28 b(of)g │ │ │ │ │ Fg(msglvl)208 5407 y Fr(ma)n(y)d(result)h(in)g(large)f(message)f │ │ │ │ │ (\014les.)37 b(T)-7 b(o)25 b(see)h(the)h(statistics)e(generated)g │ │ │ │ │ (during)h(the)g(ordering,)f(use)h Fg(msglvl)41 b(=)i(1)p │ │ │ │ │ Fr(.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 0 100 a Fj(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -696 100 1790 4 v 1953 w(Orderings)e(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 5 4 bop 0 100 a Fj(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1825 4 v 1988 w(Orderings)f(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ b(T)-7 b(rees)326 b Fr(5)125 390 y Ff(\210)42 b Fr(The)19 │ │ │ │ │ b Fg(seed)g Fr(parameter)f(is)i(used)f(as)h(a)f(random)g(n)n(um)n(b)r │ │ │ │ │ (er)g(seed.)34 b(\(There)20 b(are)f(man)n(y)g(places)g(in)h(the)g │ │ │ │ │ (graph)f(partitioning)208 490 y(and)k(minim)n(um)i(degree)d(algorithms) │ │ │ │ │ h(where)g(randomness)f(pla)n(ys)h(a)g(part.)35 b(Using)24 │ │ │ │ │ b(a)f(random)g(n)n(um)n(b)r(er)g(seed)h(ensures)208 589 │ │ │ │ │ y(rep)r(eatabilit)n(y)-7 b(.\))125 767 y Ff(\210)42 b │ │ │ │ │ @@ -8028,16 +8016,16 @@ │ │ │ │ │ b(=)44 b(100)p Fr(.)d(W)-7 b(e)30 b(see)f(that)h(there)f(is)0 │ │ │ │ │ 5308 y(really)c(little)i(di\013erence)f(in)h(ordering)d(qualit)n(y)-7 │ │ │ │ │ b(,)27 b(while)f(the)h(minim)n(um)g(degree)e(ordering)f(tak)n(es)i(m)n │ │ │ │ │ (uc)n(h)g(less)g(time)g(than)h(the)0 5407 y(other)g(orderings.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ TeXDict begin 6 5 bop 0 100 a Fr(6)327 b Fj(Orderings)26 │ │ │ │ │ -b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1762 │ │ │ │ │ -4 v 1955 w(F)g(ebruary)27 b(8,)g(2025)125 390 y Fr(Let)33 │ │ │ │ │ +b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1797 │ │ │ │ │ +4 v 1990 w(Jan)n(uary)26 b(7,)h(2024)125 390 y Fr(Let)33 │ │ │ │ │ b(us)g(no)n(w)f(lo)r(ok)h(at)g(a)g(random)f(triangulation)g(of)h(a)g │ │ │ │ │ (unit)g(cub)r(e.)54 b(This)34 b(matrix)e(has)h(13824)e(ro)n(ws)g(and)i │ │ │ │ │ (columns.)0 490 y(Eac)n(h)28 b(face)h(of)g(the)h(cub)r(e)g(has)f(a)g │ │ │ │ │ (22)18 b Fo(\002)h Fr(22)29 b(regular)e(grid)i(of)g(p)r(oin)n(ts.)42 │ │ │ │ │ b(The)29 b(remainder)g(of)g(the)h(v)n(ertices)e(are)g(placed)h(in)h │ │ │ │ │ (the)0 589 y(in)n(terior)c(using)i(quasi-random)d(p)r(oin)n(ts,)j(and)f │ │ │ │ │ (the)h(Delauney)g(triangulation)e(is)i(computed.)1189 │ │ │ │ │ @@ -8105,16 +8093,16 @@ │ │ │ │ │ (;)0 5113 y(ETree_initFromGr)o(aph)o(Wi)o(th)o(Per)o(ms)o(\(ve)o(tr)o │ │ │ │ │ (ee,)e(graph,)k(newToOld,)f(oldToNew\))g(;)0 5308 y Fr(The)21 │ │ │ │ │ b Fg(vetree)e Fr(ob)5 b(ject)21 b(in)g(the)h(co)r(de)f(fragmen)n(t)f │ │ │ │ │ (ab)r(o)n(v)n(e)g(is)h(a)g Fe(vertex)j(elimination)h(tr)l(e)l(e)c │ │ │ │ │ Fr([20)o(],)h([26],)g(where)f(eac)n(h)f(fron)n(t)h(con)n(tains)0 │ │ │ │ │ 5407 y(one)27 b(v)n(ertex.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 0 100 a Fj(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -696 100 1790 4 v 1953 w(Orderings)e(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 7 6 bop 0 100 a Fj(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1825 4 v 1988 w(Orderings)f(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ b(T)-7 b(rees)326 b Fr(7)888 448 y(Figure)27 b(2:)36 │ │ │ │ │ b(R2D100:)g(randomly)26 b(triangulated,)h(100)f(grid)h(p)r(oin)n(ts)109 │ │ │ │ │ 2355 y @beginspecial 0 @llx 0 @lly 300 @urx 300 @ury │ │ │ │ │ 2160 @rwi 2160 @rhi @setspecial │ │ │ │ │ %%BeginDocument: R2D100.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0.0 0.0 300.0 300.0 │ │ │ │ │ @@ -8990,16 +8978,16 @@ │ │ │ │ │ n(k)g(partition)p 0 5330 1560 4 v 92 5384 a Fd(1)127 │ │ │ │ │ 5407 y Fk(V)-6 b(ertex)24 b Fc(j)j Fk(is)c(the)i(paren)n(t)f(of)g │ │ │ │ │ Fc(i)f Fk(if)g Fc(j)k Fk(is)c(the)h(\014rst)g(v)n(ertex)h(greater)f │ │ │ │ │ (than)h Fc(i)e Fk(suc)n(h)h(that)h Fc(L)2434 5417 y Fb(j;i)2524 │ │ │ │ │ 5407 y Fa(6)p Fk(=)20 b(0.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ TeXDict begin 8 7 bop 0 100 a Fr(8)327 b Fj(Orderings)26 │ │ │ │ │ -b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1762 │ │ │ │ │ -4 v 1955 w(F)g(ebruary)27 b(8,)g(2025)701 1332 y Fr(Figure)g(3:)36 │ │ │ │ │ +b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1797 │ │ │ │ │ +4 v 1990 w(Jan)n(uary)26 b(7,)h(2024)701 1332 y Fr(Figure)g(3:)36 │ │ │ │ │ b(V)-7 b(ertex)28 b(elimination)f(tree)g(for)h(R2D100,)e(100)g(ro)n(ws) │ │ │ │ │ g(and)i(columns)450 4440 y @beginspecial 0 @llx 0 @lly │ │ │ │ │ 600 @urx 600 @ury 3600 @rwi 3600 @rhi @setspecial │ │ │ │ │ %%BeginDocument: vtree.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0 0 600 600 │ │ │ │ │ /CSH { │ │ │ │ │ @@ -9449,16 +9437,16 @@ │ │ │ │ │ grestore │ │ │ │ │ │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 0 100 a Fj(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -696 100 1790 4 v 1953 w(Orderings)e(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 9 8 bop 0 100 a Fj(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1825 4 v 1988 w(Orderings)f(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ b(T)-7 b(rees)326 b Fr(9)0 390 y(sup)r(erimp)r(osed)27 │ │ │ │ │ b(on)g(the)h(structure)f(of)g(the)g(factor)g Fq(L)p Fr(.)36 │ │ │ │ │ b(Note)28 b(this)f(one)g(imp)r(ortan)n(t)g(prop)r(ert)n(y:)36 │ │ │ │ │ b(within)28 b(an)n(y)e(blo)r(c)n(k)h(column)0 490 y(and)g(b)r(elo)n(w)h │ │ │ │ │ (the)g(diagonal)e(blo)r(c)n(k,)h(a)g(ro)n(w)f(is)i(either)f(zero)g(or)g │ │ │ │ │ (dense.)125 615 y(The)g(co)r(de)h(fragmen)n(t)e(to)i(con)n(v)n(ert)e(a) │ │ │ │ │ h(tree)g(in)n(to)h(a)f(fundamen)n(tal)h(sup)r(erno)r(de)f(tree)g(is)h │ │ │ │ │ @@ -9537,16 +9525,16 @@ │ │ │ │ │ Fq(k)22 b Fo(\002)e Fq(k)i Fo(\002)e Fq(k)32 b Fr(grid)d(with)h(a)f(27) │ │ │ │ │ g(p)r(oin)n(t)0 5407 y(\014nite)22 b(di\013erence)f(op)r(erator,)g │ │ │ │ │ (when)g(ordered)f(b)n(y)h(nested)g(dissection,)h(has)f(a)g(ro)r(ot)f │ │ │ │ │ (sup)r(erno)r(de)h(with)h Fq(k)3182 5377 y Fn(2)3240 │ │ │ │ │ 5407 y Fr(ro)n(ws)e(and)h(columns.)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ TeXDict begin 10 9 bop 0 100 a Fr(10)327 b Fj(Orderings)25 │ │ │ │ │ -b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1721 │ │ │ │ │ -4 v 1913 w(F)g(ebruary)27 b(8,)g(2025)0 489 y Fr(Figure)22 │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1756 │ │ │ │ │ +4 v 1948 w(Jan)n(uary)26 b(7,)h(2024)0 489 y Fr(Figure)22 │ │ │ │ │ b(4:)35 b(T)-7 b(op:)34 b(v)n(ertex)22 b(elimination)h(tree)g(with)g │ │ │ │ │ (the)h(v)n(ertices)e(mapp)r(ed)h(to)g(the)h(fundamen)n(tal)f(sup)r │ │ │ │ │ (erno)r(de)g(that)g(con)n(tains)0 589 y(them.)37 b(Bottom:)g(fundamen)n │ │ │ │ │ (tal)28 b(sup)r(erno)r(de)f(tree.)450 3696 y @beginspecial │ │ │ │ │ 0 @llx 0 @lly 600 @urx 600 @ury 3600 @rwi 3600 @rhi @setspecial │ │ │ │ │ %%BeginDocument: fsvtree.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ @@ -10340,21 +10328,20 @@ │ │ │ │ │ grestore │ │ │ │ │ │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 0 100 a Fj(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1749 4 v 1912 w(Orderings)e(and)h(F)-7 │ │ │ │ │ -b(ron)n(t)27 b(T)-7 b(rees)327 b Fr(11)610 1332 y(Figure)27 │ │ │ │ │ -b(5:)36 b(Blo)r(c)n(k)27 b(structure)g(of)h Fq(L)f Fr(with)h(the)g │ │ │ │ │ -(fundamen)n(tal)f(sup)r(erno)r(de)h(partition.)450 4440 │ │ │ │ │ -y @beginspecial 0 @llx 0 @lly 550 @urx 550 @ury 3600 │ │ │ │ │ -@rwi 3600 @rhi @setspecial │ │ │ │ │ +TeXDict begin 11 10 bop 0 100 a Fj(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1783 4 v 1947 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +b(T)-7 b(rees)327 b Fr(11)610 1332 y(Figure)27 b(5:)36 │ │ │ │ │ +b(Blo)r(c)n(k)27 b(structure)g(of)h Fq(L)f Fr(with)h(the)g(fundamen)n │ │ │ │ │ +(tal)f(sup)r(erno)r(de)h(partition.)450 4440 y @beginspecial │ │ │ │ │ +0 @llx 0 @lly 550 @urx 550 @ury 3600 @rwi 3600 @rhi @setspecial │ │ │ │ │ %%BeginDocument: fsmtx.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0.000 0.000 550.000 550.000 │ │ │ │ │ %%EndComments │ │ │ │ │ │ │ │ │ │ /MainFont /Helvetica findfont 8 scalefont def │ │ │ │ │ MainFont setfont │ │ │ │ │ @@ -10694,16 +10681,16 @@ │ │ │ │ │ xnw ynw dx dy adjncyL draw_matrix │ │ │ │ │ xnw ynw dx dy nrow ncol sn_info draw_sn_overlay │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ TeXDict begin 12 11 bop 0 100 a Fr(12)327 b Fj(Orderings)25 │ │ │ │ │ -b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1721 │ │ │ │ │ -4 v 1913 w(F)g(ebruary)27 b(8,)g(2025)0 864 y Fr(Figure)33 │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1756 │ │ │ │ │ +4 v 1948 w(Jan)n(uary)26 b(7,)h(2024)0 864 y Fr(Figure)33 │ │ │ │ │ b(6:)48 b(T)-7 b(op:)49 b(fundamen)n(tal)33 b(sup)r(erno)r(de)g(tree)h │ │ │ │ │ (with)g(the)f(sup)r(erno)r(des)g(mapp)r(ed)h(to)g(the)f(amalgamated)f │ │ │ │ │ (sup)r(erno)r(de)0 964 y(that)c(con)n(tains)f(them.)37 │ │ │ │ │ b(Bottom:)g(amalgamated)25 b(sup)r(erno)r(de)j(tree.)450 │ │ │ │ │ 4071 y @beginspecial 0 @llx 0 @lly 600 @urx 600 @ury │ │ │ │ │ 3600 @rwi 3600 @rhi @setspecial │ │ │ │ │ %%BeginDocument: amvtree.eps │ │ │ │ │ @@ -11310,21 +11297,20 @@ │ │ │ │ │ grestore │ │ │ │ │ │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 0 100 a Fj(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1749 4 v 1912 w(Orderings)e(and)h(F)-7 │ │ │ │ │ -b(ron)n(t)27 b(T)-7 b(rees)327 b Fr(13)594 1332 y(Figure)26 │ │ │ │ │ -b(7:)37 b(Blo)r(c)n(k)27 b(structure)g(of)g Fq(L)h Fr(with)g(the)g │ │ │ │ │ -(amalgamated)e(sup)r(erno)r(de)h(partition.)450 4440 │ │ │ │ │ -y @beginspecial 0 @llx 0 @lly 550 @urx 550 @ury 3600 │ │ │ │ │ -@rwi 3600 @rhi @setspecial │ │ │ │ │ +TeXDict begin 13 12 bop 0 100 a Fj(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1783 4 v 1947 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +b(T)-7 b(rees)327 b Fr(13)594 1332 y(Figure)26 b(7:)37 │ │ │ │ │ +b(Blo)r(c)n(k)27 b(structure)g(of)g Fq(L)h Fr(with)g(the)g(amalgamated) │ │ │ │ │ +e(sup)r(erno)r(de)h(partition.)450 4440 y @beginspecial │ │ │ │ │ +0 @llx 0 @lly 550 @urx 550 @ury 3600 @rwi 3600 @rhi @setspecial │ │ │ │ │ %%BeginDocument: ammtx.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0.000 0.000 550.000 550.000 │ │ │ │ │ %%EndComments │ │ │ │ │ │ │ │ │ │ /MainFont /Helvetica findfont 8 scalefont def │ │ │ │ │ MainFont setfont │ │ │ │ │ @@ -11618,18 +11604,18 @@ │ │ │ │ │ xnw ynw dx dy adjncyL draw_matrix │ │ │ │ │ xnw ynw dx dy nrow ncol sn_info draw_sn_overlay │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ TeXDict begin 14 13 bop 0 100 a Fr(14)327 b Fj(Orderings)25 │ │ │ │ │ -b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1721 │ │ │ │ │ -4 v 1913 w(F)g(ebruary)27 b(8,)g(2025)0 390 y Fr(The)k(data)f │ │ │ │ │ -(structure)g(for)g(a)h(top)f(lev)n(el)g(sup)r(erno)r(de)h(can)f(b)r(e)h │ │ │ │ │ -(v)n(ery)f(large,)g(to)r(o)g(large)g(to)g(\014t)h(in)n(to)g(memory)-7 │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1756 │ │ │ │ │ +4 v 1948 w(Jan)n(uary)26 b(7,)h(2024)0 390 y Fr(The)k(data)f(structure) │ │ │ │ │ +g(for)g(a)h(top)f(lev)n(el)g(sup)r(erno)r(de)h(can)f(b)r(e)h(v)n(ery)f │ │ │ │ │ +(large,)g(to)r(o)g(large)g(to)g(\014t)h(in)n(to)g(memory)-7 │ │ │ │ │ b(.)45 b(In)31 b(a)f(parallel)0 490 y(en)n(vironmen)n(t,)d(w)n(e)h │ │ │ │ │ (follo)n(w)g(the)g(con)n(v)n(en)n(tion)f(that)h(eac)n(h)g(no)r(de)g(in) │ │ │ │ │ g(the)h(tree)f(is)g(handled)g(b)n(y)g(one)g(pro)r(cess.)37 │ │ │ │ │ b(Ha)n(ving)27 b(a)h(v)n(ery)0 589 y(large)e(no)r(de)i(at)f(the)h(top)g │ │ │ │ │ (lev)n(els)f(of)g(the)h(tree)g(will)f(sev)n(erely)f(decrease)h(the)h │ │ │ │ │ (parallelism)e(a)n(v)-5 b(ailable)26 b(to)i(the)g(computations.)125 │ │ │ │ │ 718 y(The)d(solution)g(to)h(b)r(oth)g(problems,)f(large)g(data)g │ │ │ │ │ @@ -11717,22 +11703,22 @@ │ │ │ │ │ (an)i(fundamen)n(tal)f(sup)r(erno)r(de)h(tree)f(with)h(a)f(call)h(to)f │ │ │ │ │ Fg(ETree)p 2994 5208 27 4 v 29 w(mergeFrontsOne\(\))17 │ │ │ │ │ b Fr(with)208 5308 y Fg(maxzeros)40 b(=)j(0)p Fr(.)36 │ │ │ │ │ b(W)-7 b(e)26 b(see)g(that)g(the)h(n)n(um)n(b)r(er)e(of)h(fron)n(ts)g │ │ │ │ │ (decreases)e(b)n(y)i(one)f(and)h(the)g(n)n(um)n(b)r(er)g(of)g(en)n │ │ │ │ │ (tries)f(do)r(es)h(not)208 5407 y(c)n(hange.)p eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 0 100 a Fj(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1749 4 v 1912 w(Orderings)e(and)h(F)-7 │ │ │ │ │ -b(ron)n(t)27 b(T)-7 b(rees)327 b Fr(15)0 615 y(Figure)24 │ │ │ │ │ -b(8:)35 b(Left:)h(tree)24 b(after)h(the)g(large)e(sup)r(erno)r(des)h │ │ │ │ │ -(ha)n(v)n(e)g(b)r(een)h(split.)36 b(Righ)n(t:)g(tree)24 │ │ │ │ │ -b(with)h(no)r(des)g(mapp)r(ed)g(bac)n(k)f(to)g(their)0 │ │ │ │ │ -715 y(amalgamated)i(sup)r(erno)r(de.)450 3822 y @beginspecial │ │ │ │ │ -0 @llx 0 @lly 600 @urx 600 @ury 3600 @rwi 3600 @rhi @setspecial │ │ │ │ │ +TeXDict begin 15 14 bop 0 100 a Fj(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1783 4 v 1947 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +b(T)-7 b(rees)327 b Fr(15)0 615 y(Figure)24 b(8:)35 b(Left:)h(tree)24 │ │ │ │ │ +b(after)h(the)g(large)e(sup)r(erno)r(des)h(ha)n(v)n(e)g(b)r(een)h │ │ │ │ │ +(split.)36 b(Righ)n(t:)g(tree)24 b(with)h(no)r(des)g(mapp)r(ed)g(bac)n │ │ │ │ │ +(k)f(to)g(their)0 715 y(amalgamated)i(sup)r(erno)r(de.)450 │ │ │ │ │ +3822 y @beginspecial 0 @llx 0 @lly 600 @urx 600 @ury │ │ │ │ │ +3600 @rwi 3600 @rhi @setspecial │ │ │ │ │ %%BeginDocument: spvtree.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0 0 600 600 │ │ │ │ │ /CSH { │ │ │ │ │ % │ │ │ │ │ % center show a string │ │ │ │ │ % │ │ │ │ │ @@ -12358,16 +12344,16 @@ │ │ │ │ │ │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 16 16 │ │ │ │ │ TeXDict begin 16 15 bop 0 100 a Fr(16)327 b Fj(Orderings)25 │ │ │ │ │ -b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1721 │ │ │ │ │ -4 v 1913 w(F)g(ebruary)27 b(8,)g(2025)420 595 y Fr(Figure)g(9:)37 │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1756 │ │ │ │ │ +4 v 1948 w(Jan)n(uary)26 b(7,)h(2024)420 595 y Fr(Figure)g(9:)37 │ │ │ │ │ b(Blo)r(c)n(k)27 b(structure)g(of)g Fq(L)g Fr(with)h(the)g(amalgamated) │ │ │ │ │ e(and)i(split)g(sup)r(erno)r(de)f(partition.)450 3702 │ │ │ │ │ y @beginspecial 0 @llx 0 @lly 550 @urx 550 @ury 3600 │ │ │ │ │ @rwi 3600 @rhi @setspecial │ │ │ │ │ %%BeginDocument: spmtx.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0.000 0.000 550.000 550.000 │ │ │ │ │ @@ -12687,45 +12673,44 @@ │ │ │ │ │ b(2021347776)692 4948 y(merge)26 b(an)n(y)p 1114 4978 │ │ │ │ │ V 99 w(0.012)279 b(597)232 b(85366)142 b(3753241)154 │ │ │ │ │ b(2035158539)692 5048 y(split)p 1114 5078 V 316 w(0.043)279 │ │ │ │ │ b(643)190 b(115139)142 b(3753241)154 b(2035158539)692 │ │ │ │ │ 5148 y(\014nal)p 1114 5177 V 316 w(0.423)279 b(643)190 │ │ │ │ │ b(115128)142 b(3752694)154 b(2034396840)p eop end │ │ │ │ │ %%Page: 17 17 │ │ │ │ │ -TeXDict begin 17 16 bop 0 100 a Fj(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1749 4 v 1912 w(Orderings)e(and)h(F)-7 │ │ │ │ │ -b(ron)n(t)27 b(T)-7 b(rees)327 b Fr(17)125 390 y Ff(\210)42 │ │ │ │ │ -b Fr(The)33 b(second)f(step)i(is)f(also)f(a)h(call)f(to)i │ │ │ │ │ -Fg(ETree)p 1665 390 27 4 v 29 w(mergeFrontsOne\(\))o │ │ │ │ │ -Fr(,)29 b(this)k(time)h(with)g Fg(maxzeros)40 b(=)j(1000)p │ │ │ │ │ -Fr(.)52 b(Here)208 490 y(w)n(e)30 b(merge)h(fron)n(ts)f(with)i(only)f │ │ │ │ │ -(one)f(c)n(hild)i(with)f(that)h(c)n(hild,)g(in)f(other)g(w)n(ords,)g │ │ │ │ │ -(only)g(c)n(hains)f(of)h(no)r(des)g(can)g(merge)208 589 │ │ │ │ │ -y(together.)50 b(Note)32 b(ho)n(w)g(the)h(n)n(um)n(b)r(er)f(of)g(fron)n │ │ │ │ │ -(ts)g(is)g(decreased)f(b)n(y)h(almost)g(one)g(half,)i(and)e(the)g(n)n │ │ │ │ │ -(um)n(b)r(er)h(of)f(factor)208 689 y(en)n(tries)26 b(and)i(op)r │ │ │ │ │ -(erations)e(increase)g(b)n(y)i(1\045.)125 868 y Ff(\210)42 │ │ │ │ │ -b Fr(The)26 b(third)g(step)g(is)g(a)g(call)g(to)g Fg(ETree)p │ │ │ │ │ -1383 868 V 29 w(mergeFrontsAll\(\))19 b Fr(with)27 b │ │ │ │ │ -Fg(maxzeros)40 b(=)j(1000)p Fr(,)25 b(where)h(w)n(e)g(try)f(to)h(merge) │ │ │ │ │ -f(a)208 967 y(no)r(de)h(with)g(all)g(of)g(its)h(c)n(hildren)e(if)i(p)r │ │ │ │ │ -(ossible.)36 b(The)26 b(n)n(um)n(b)r(er)g(of)g(fron)n(ts)g(decreases)e │ │ │ │ │ -(again)h(b)n(y)h(a)f(factor)h(of)g(\014v)n(e,)g(while)208 │ │ │ │ │ -1067 y(the)d(n)n(um)n(b)r(er)g(of)g(factor)f(en)n(tries)h(and)f(op)r │ │ │ │ │ -(erations)g(increases)g(b)n(y)h(7\045)f(and)h(2\045,)h(resp)r(ectiv)n │ │ │ │ │ -(ely)-7 b(,)23 b(when)h(compared)e(with)208 1167 y(the)28 │ │ │ │ │ -b(original)e(factor)g(matrices.)125 1345 y Ff(\210)42 │ │ │ │ │ -b Fr(The)27 b(fourth)h(step)g(is)g(a)f(call)h(to)f Fg(ETree)p │ │ │ │ │ -1438 1345 V 30 w(mergeFrontsAny\()o(\))22 b Fr(with)28 │ │ │ │ │ -b Fg(maxzeros)41 b(=)i(1000)p Fr(,)26 b(where)h(w)n(e)h(try)f(to)h │ │ │ │ │ -(merge)208 1445 y(a)f(fron)n(t)h(with)h(an)n(y)f(subset)g(of)g(its)h(c) │ │ │ │ │ -n(hildren.)38 b(The)29 b(n)n(um)n(b)r(er)f(of)g(fron)n(ts)f(decreases)g │ │ │ │ │ -(further,)i(and)f(the)g(factor)g(en)n(tries)208 1545 │ │ │ │ │ -y(and)f(op)r(erations)f(increase)h(b)n(y)g(8\045)g(and)h(3\045,)f(resp) │ │ │ │ │ -r(ectiv)n(ely)-7 b(.)125 1723 y Ff(\210)42 b Fr(In)32 │ │ │ │ │ +TeXDict begin 17 16 bop 0 100 a Fj(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1783 4 v 1947 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +b(T)-7 b(rees)327 b Fr(17)125 390 y Ff(\210)42 b Fr(The)33 │ │ │ │ │ +b(second)f(step)i(is)f(also)f(a)h(call)f(to)i Fg(ETree)p │ │ │ │ │ +1665 390 27 4 v 29 w(mergeFrontsOne\(\))o Fr(,)29 b(this)k(time)h(with) │ │ │ │ │ +g Fg(maxzeros)40 b(=)j(1000)p Fr(.)52 b(Here)208 490 │ │ │ │ │ +y(w)n(e)30 b(merge)h(fron)n(ts)f(with)i(only)f(one)f(c)n(hild)i(with)f │ │ │ │ │ +(that)h(c)n(hild,)g(in)f(other)g(w)n(ords,)g(only)g(c)n(hains)f(of)h │ │ │ │ │ +(no)r(des)g(can)g(merge)208 589 y(together.)50 b(Note)32 │ │ │ │ │ +b(ho)n(w)g(the)h(n)n(um)n(b)r(er)f(of)g(fron)n(ts)g(is)g(decreased)f(b) │ │ │ │ │ +n(y)h(almost)g(one)g(half,)i(and)e(the)g(n)n(um)n(b)r(er)h(of)f(factor) │ │ │ │ │ +208 689 y(en)n(tries)26 b(and)i(op)r(erations)e(increase)g(b)n(y)i │ │ │ │ │ +(1\045.)125 868 y Ff(\210)42 b Fr(The)26 b(third)g(step)g(is)g(a)g │ │ │ │ │ +(call)g(to)g Fg(ETree)p 1383 868 V 29 w(mergeFrontsAll\(\))19 │ │ │ │ │ +b Fr(with)27 b Fg(maxzeros)40 b(=)j(1000)p Fr(,)25 b(where)h(w)n(e)g │ │ │ │ │ +(try)f(to)h(merge)f(a)208 967 y(no)r(de)h(with)g(all)g(of)g(its)h(c)n │ │ │ │ │ +(hildren)e(if)i(p)r(ossible.)36 b(The)26 b(n)n(um)n(b)r(er)g(of)g(fron) │ │ │ │ │ +n(ts)g(decreases)e(again)h(b)n(y)h(a)f(factor)h(of)g(\014v)n(e,)g │ │ │ │ │ +(while)208 1067 y(the)d(n)n(um)n(b)r(er)g(of)g(factor)f(en)n(tries)h │ │ │ │ │ +(and)f(op)r(erations)g(increases)g(b)n(y)h(7\045)f(and)h(2\045,)h(resp) │ │ │ │ │ +r(ectiv)n(ely)-7 b(,)23 b(when)h(compared)e(with)208 │ │ │ │ │ +1167 y(the)28 b(original)e(factor)g(matrices.)125 1345 │ │ │ │ │ +y Ff(\210)42 b Fr(The)27 b(fourth)h(step)g(is)g(a)f(call)h(to)f │ │ │ │ │ +Fg(ETree)p 1438 1345 V 30 w(mergeFrontsAny\()o(\))22 │ │ │ │ │ +b Fr(with)28 b Fg(maxzeros)41 b(=)i(1000)p Fr(,)26 b(where)h(w)n(e)h │ │ │ │ │ +(try)f(to)h(merge)208 1445 y(a)f(fron)n(t)h(with)h(an)n(y)f(subset)g │ │ │ │ │ +(of)g(its)h(c)n(hildren.)38 b(The)29 b(n)n(um)n(b)r(er)f(of)g(fron)n │ │ │ │ │ +(ts)f(decreases)g(further,)i(and)f(the)g(factor)g(en)n(tries)208 │ │ │ │ │ +1545 y(and)f(op)r(erations)f(increase)h(b)n(y)g(8\045)g(and)h(3\045,)f │ │ │ │ │ +(resp)r(ectiv)n(ely)-7 b(.)125 1723 y Ff(\210)42 b Fr(In)32 │ │ │ │ │ b(the)h(\014fth)g(step)g(is)f(a)g(call)g(to)g Fg(ETree)p │ │ │ │ │ 1477 1723 V 29 w(splitFronts\(\))c Fr(with)k Fg(maxsize)41 │ │ │ │ │ b(=)i(64)p Fr(,)33 b(where)f(w)n(e)g(try)g(split)h(the)g(large)208 │ │ │ │ │ 1823 y(fron)n(ts)38 b(in)n(to)g(smaller)g(fron)n(ts.)71 │ │ │ │ │ b(Note)38 b(that)i(the)f(n)n(um)n(b)r(er)g(of)f(factor)g(en)n(tries)h │ │ │ │ │ (and)f(op)r(erations)g(do)h(not)f(seem)h(to)208 1923 │ │ │ │ │ y(increase,)29 b(while)h(the)g(n)n(um)n(b)r(er)g(of)g(fron)n(ts)f │ │ │ │ │ @@ -12806,16 +12791,16 @@ │ │ │ │ │ Fq(X)32 b Fr(and)26 b Fq(Y)45 b Fr(ha)n(v)n(e)25 b(a)h(single)g │ │ │ │ │ (column\))g(or)f(BLAS3)0 5407 y(k)n(ernel)f(\(when)g │ │ │ │ │ Fq(X)31 b Fr(and)25 b Fq(Y)43 b Fr(are)23 b(matrices\).)36 │ │ │ │ │ b(When)25 b(fron)n(ts)e(are)h(small,)h(particularly)e(with)i(one)f(in)n │ │ │ │ │ (ternal)g(ro)n(w)f(and)h(column,)p eop end │ │ │ │ │ %%Page: 18 18 │ │ │ │ │ TeXDict begin 18 17 bop 0 100 a Fr(18)327 b Fj(Orderings)25 │ │ │ │ │ -b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1721 │ │ │ │ │ -4 v 1913 w(F)g(ebruary)27 b(8,)g(2025)0 390 y Fr(the)g(submatrices)e │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1756 │ │ │ │ │ +4 v 1948 w(Jan)n(uary)26 b(7,)h(2024)0 390 y Fr(the)g(submatrices)e │ │ │ │ │ (that)i(tak)n(e)f(part)g(are)f(v)n(ery)g(small.)36 b(The)27 │ │ │ │ │ b(o)n(v)n(erhead)d(for)i(the)g(computations)g(tak)n(es)g(far)g(more)f │ │ │ │ │ (time)i(than)0 490 y(the)h(computations)f(themselv)n(es.)125 │ │ │ │ │ 612 y(This)35 b(m)n(ultistep)h(pro)r(cess)e(of)h(merging,)i(merging)d │ │ │ │ │ (again,)i(etc,)h(and)f(\014nally)f(splitting)g(the)h(fron)n(t)f(trees)g │ │ │ │ │ (is)g(tedious.)0 712 y(There)27 b(are)g(simple)g(metho)r(ds)h(that)g │ │ │ │ │ (do)f(the)h(pro)r(cess)f(in)h(one)f(step.)0 894 y Fg(ETree)129 │ │ │ │ │ @@ -12910,30 +12895,30 @@ │ │ │ │ │ b(of)f Fg(64)g Fr(is)h(what)f(w)n(e)g(customarily)g(use.)0 │ │ │ │ │ 5103 y Fs(References)42 5308 y Fr([1])41 b(P)-7 b(.)35 │ │ │ │ │ b(Amesto)n(y)-7 b(,)37 b(T.)f(Da)n(vis,)h(and)e(I.)h(Du\013.)62 │ │ │ │ │ b(An)36 b(appro)n(ximate)e(minim)n(um)i(degree)f(ordering)f(algorithm.) │ │ │ │ │ 59 b Fe(SIAM)37 b(J.)171 5407 y(Matrix)30 b(A)n(nal.)g(Appl.)p │ │ │ │ │ Fr(,)f(17:886{905,)23 b(1996.)p eop end │ │ │ │ │ %%Page: 19 19 │ │ │ │ │ -TeXDict begin 19 18 bop 0 100 a Fj(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 696 100 1749 4 v 1912 w(Orderings)e(and)h(F)-7 │ │ │ │ │ -b(ron)n(t)27 b(T)-7 b(rees)327 b Fr(19)844 448 y(T)-7 │ │ │ │ │ -b(able)27 b(3:)36 b(R3D13824:)f(the)28 b(in\015uence)g(of)f │ │ │ │ │ -Fg(maxzeros)e Fr(and)i Fg(maxsize)p Fr(.)p 1241 639 4 │ │ │ │ │ -100 v 1674 609 a(factor)942 b(solv)n(e)276 b(total)440 │ │ │ │ │ -709 y Fg(maxzeros)96 b(maxsize)p 1241 738 V 97 w Fr(init)105 │ │ │ │ │ -b(CPU)g(m\015ops)99 b(p)r(ostpro)r(cess)f(CPU)i(m\015ops)k(CPU)p │ │ │ │ │ -390 742 3121 4 v 663 811 a(0)294 b Fo(1)p 1241 841 4 │ │ │ │ │ -100 v 220 w Fr(3.3)108 b(129.8)142 b(15.3)297 b(5.3)291 │ │ │ │ │ -b(7.8)213 b(7.1)150 b(146.2)628 911 y(10)287 b Fo(1)p │ │ │ │ │ -1241 941 V 220 w Fr(3.5)108 b(129.2)142 b(15.3)297 b(3.3)291 │ │ │ │ │ -b(5.3)179 b(10.5)142 b(141.3)593 1011 y(100)280 b Fo(1)p │ │ │ │ │ -1241 1041 V 220 w Fr(3.0)108 b(119.3)142 b(16.7)297 b(2.0)291 │ │ │ │ │ -b(3.9)179 b(14.4)142 b(128.2)559 1110 y(1000)272 b Fo(1)p │ │ │ │ │ -1241 1140 V 220 w Fr(3.0)108 b(121.8)142 b(16.7)297 b(1.4)291 │ │ │ │ │ +TeXDict begin 19 18 bop 0 100 a Fj(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +661 100 1783 4 v 1947 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +b(T)-7 b(rees)327 b Fr(19)844 448 y(T)-7 b(able)27 b(3:)36 │ │ │ │ │ +b(R3D13824:)f(the)28 b(in\015uence)g(of)f Fg(maxzeros)e │ │ │ │ │ +Fr(and)i Fg(maxsize)p Fr(.)p 1241 639 4 100 v 1674 609 │ │ │ │ │ +a(factor)942 b(solv)n(e)276 b(total)440 709 y Fg(maxzeros)96 │ │ │ │ │ +b(maxsize)p 1241 738 V 97 w Fr(init)105 b(CPU)g(m\015ops)99 │ │ │ │ │ +b(p)r(ostpro)r(cess)f(CPU)i(m\015ops)k(CPU)p 390 742 │ │ │ │ │ +3121 4 v 663 811 a(0)294 b Fo(1)p 1241 841 4 100 v 220 │ │ │ │ │ +w Fr(3.3)108 b(129.8)142 b(15.3)297 b(5.3)291 b(7.8)213 │ │ │ │ │ +b(7.1)150 b(146.2)628 911 y(10)287 b Fo(1)p 1241 941 │ │ │ │ │ +V 220 w Fr(3.5)108 b(129.2)142 b(15.3)297 b(3.3)291 b(5.3)179 │ │ │ │ │ +b(10.5)142 b(141.3)593 1011 y(100)280 b Fo(1)p 1241 1041 │ │ │ │ │ +V 220 w Fr(3.0)108 b(119.3)142 b(16.7)297 b(2.0)291 b(3.9)179 │ │ │ │ │ +b(14.4)142 b(128.2)559 1110 y(1000)272 b Fo(1)p 1241 │ │ │ │ │ +1140 V 220 w Fr(3.0)108 b(121.8)142 b(16.7)297 b(1.4)291 │ │ │ │ │ b(3.5)179 b(17.0)142 b(129.7)524 1210 y(10000)265 b Fo(1)p │ │ │ │ │ 1241 1240 V 220 w Fr(3.5)108 b(138.1)142 b(16.8)297 b(1.5)291 │ │ │ │ │ b(4.0)179 b(17.8)142 b(147.1)559 1310 y(1000)272 b(32)p │ │ │ │ │ 1241 1340 V 219 w(3.3)143 b(89.8)149 b(22.7)297 b(2.6)291 │ │ │ │ │ b(4.1)179 b(14.7)e(99.8)559 1409 y(1000)272 b(48)p 1241 │ │ │ │ │ 1439 V 219 w(3.1)143 b(85.8)149 b(23.7)297 b(2.1)291 │ │ │ │ │ b(3.6)179 b(16.5)e(94.6)559 1509 y(1000)272 b(64)p 1241 │ │ │ │ │ @@ -12999,16 +12984,16 @@ │ │ │ │ │ 5308 y([12])41 b(A.)27 b(Gupta.)37 b(W)n(GPP:)27 b(Watson)g(Graph)g │ │ │ │ │ (Partitioning)f(and)h(sparse)f(matrix)h(ordering)e(Pac)n(k)-5 │ │ │ │ │ b(age.)34 b(T)-7 b(ec)n(hnical)27 b(Rep)r(ort)171 5407 │ │ │ │ │ y(Users)g(Man)n(ual,)f(IBM)i(T.J.)f(W)-7 b(atson)28 b(Researc)n(h)e │ │ │ │ │ (Cen)n(ter,)h(New)h(Y)-7 b(ork,)27 b(1996.)p eop end │ │ │ │ │ %%Page: 20 20 │ │ │ │ │ TeXDict begin 20 19 bop 0 100 a Fr(20)327 b Fj(Orderings)25 │ │ │ │ │ -b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1721 │ │ │ │ │ -4 v 1913 w(F)g(ebruary)27 b(8,)g(2025)0 390 y Fr([13])41 │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1756 │ │ │ │ │ +4 v 1948 w(Jan)n(uary)26 b(7,)h(2024)0 390 y Fr([13])41 │ │ │ │ │ b(B.)24 b(Hendric)n(kson)e(and)i(R.)g(Leland.)31 b(An)24 │ │ │ │ │ b(impro)n(v)n(ed)f(sp)r(ectral)g(graph)g(partitioning)g(algorithm)g │ │ │ │ │ (for)h(mapping)f(parallel)171 490 y(computations.)28 │ │ │ │ │ b(T)-7 b(ec)n(hnical)23 b(Rep)r(ort)f(SAND92-1460,)g(Sandia)h(National) │ │ │ │ │ f(Lab)r(oratories,)g(Albuquerque,)h(NM,)h(1992.)0 656 │ │ │ │ │ y([14])41 b(B.)f(Hendric)n(kson)f(and)h(R.)g(Leland.)74 │ │ │ │ │ b(The)40 b(Chaco)f(user's)g(guide.)74 b(T)-7 b(ec)n(hnical)39 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -1,11 +1,11 @@ │ │ │ │ │ │ Ordering Sparse Matrices and Transforming Front Trees │ │ │ │ │ │ ∗ │ │ │ │ │ │ Cleve Ashcraft, Boeing Shared Services Group │ │ │ │ │ │ - February 8, 2025 │ │ │ │ │ │ + January 7, 2024 │ │ │ │ │ │ 1 Introduction │ │ │ │ │ │ If the ultimate goal is to solve linear systems of the form AX = B, one must compute an A = LDU, │ │ │ │ │ │ A=UTDU orA=UHDU factorization, depending on whether the matrix A is nonsymmetric, symmetric │ │ │ │ │ │ or Hermitian. D is a diagonal or block diagonal matrix, L is unit lower triangular, and U is unit upper │ │ │ │ │ │ triangular. A is sparse, but the sparsity structure of L and U will likely be much larger than that of A, │ │ │ │ │ │ i.e., they will suffer fill-in. It is crucial to find a permutation matrix such that the factors of PAPT have as │ │ │ │ │ │ moderate fill-in as can be reasonably expected. │ │ │ │ │ │ @@ -35,15 +35,15 @@ │ │ │ │ │ │ Section 2 introduces some background on sparse matrix orderings and describes the SPOOLES or- │ │ │ │ │ │ dering software. Section 3 presents the front tree object that controls the factorization, and its various │ │ │ │ │ │ transformations to improve performance. │ │ │ │ │ │ ∗P. O. Box 24346, Mail Stop 7L-21, Seattle, Washington 98124. This research was supported in part by the DARPA │ │ │ │ │ │ Contract DABT63-95-C-0122 and the DoD High Performance Computing Modernization Program Common HPC Software │ │ │ │ │ │ Support Initiative. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 2 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ 2 Sparse matrix orderings │ │ │ │ │ │ Thepast few years have seen a resurgence of interest and accompanying improvement in algorithms and soft- │ │ │ │ │ │ ware to order sparse matrices. The minimum degree algorithm, specifically the multiple external minimum │ │ │ │ │ │ degree algorithm [19], was the preferred algorithm of choice for the better part of a decade. Alternative min- │ │ │ │ │ │ imum priority codes have recently pushed multiple minimum degree aside, including approximate minimum │ │ │ │ │ │ degree [1] and approximate deficiency [21], [25]. They offer improved quality or improved run time, and on │ │ │ │ │ │ occasion, both. │ │ │ │ │ │ @@ -81,15 +81,15 @@ │ │ │ │ │ │ One can construct the IVL object directly. There are methods to set the number of lists, to set the size │ │ │ │ │ │ of a list, to copy entries in a list into the object. It resizes itself as necessary. However, if one already has │ │ │ │ │ │ the matrix entries of A stored in an InpMtx object (which is the way that SPOOLES deals with sparse │ │ │ │ │ │ matrices), there is an easier way. One can create an IVL object from the InpMtx object, as follows. │ │ │ │ │ │ InpMtx *A ; │ │ │ │ │ │ IVL *adjIVL ; │ │ │ │ │ │ adjIVL = InpMtx_fullAdjacency(A) ; │ │ │ │ │ │ - February 8, 2025 Orderings and Front Trees 3 │ │ │ │ │ │ + January 7, 2024 Orderings and Front Trees 3 │ │ │ │ │ │ Figure 1: A 3×4 9-point grid with its adjacency structure │ │ │ │ │ │ IVL : integer vector list object : │ │ │ │ │ │ type 1, chunked storage │ │ │ │ │ │ 12 lists, 12 maximum lists, 70 tsize, 4240 total bytes │ │ │ │ │ │ 1 chunks, 70 active entries, 1024 allocated, 6.84 % used │ │ │ │ │ │ 0 : 0 1 3 4 │ │ │ │ │ │ 9 10 11 1 : 0 1 2 3 4 5 │ │ │ │ │ │ @@ -121,15 +121,15 @@ │ │ │ │ │ │ This is an initializer for the Graph object, one that takes as input a complete IVL adjacency object. The │ │ │ │ │ │ 0 and NULL fields are not applicable here. (The Graph object is sophisticated — it can have weighted or │ │ │ │ │ │ unweighted vertices, weighted or unweighted edges, or both, and it can have boundary vertices. Neither is │ │ │ │ │ │ relevant now.) │ │ │ │ │ │ 2.2 Constructing an ordering │ │ │ │ │ │ Once we have a Graph object, we can construct an ordering. There are four choices: │ │ │ │ │ │ • minimum degree, (actually multiple external minimum degree, from [19]), │ │ │ │ │ │ - 4 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 4 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ • generalized nested dissection, │ │ │ │ │ │ • multisection, and │ │ │ │ │ │ • the better of generalized nested dissection and multisection. │ │ │ │ │ │ Minimum degree takes the least amount of CPU time. Generalized nested dissection and multisection both │ │ │ │ │ │ require the a partition of the graph, which can be much more expensive to compute than a minimum degree │ │ │ │ │ │ ordering. By and large, for larger graphs nested dissection generates better orderings than minimum degree, │ │ │ │ │ │ and the difference in quality increases as the graph size increases. Multisection is an ordering which almost │ │ │ │ │ │ @@ -161,15 +161,15 @@ │ │ │ │ │ │ etree = orderViaBestOfNDandMS(graph, maxdomainsize, maxzeros, │ │ │ │ │ │ maxsize, seed, msglvl, msgFile) ; │ │ │ │ │ │ Now let us describe the different parameters. │ │ │ │ │ │ • The msglvl and msgFile parameters are used to control output. When msglvl = 0, there is no │ │ │ │ │ │ output. When msglvl > 0, output goes to the msgFile file. The SPOOLES library is a research │ │ │ │ │ │ code, we have left a great deal of monitoring and debug code in the software. Large values of msglvl │ │ │ │ │ │ mayresult in large message files. To see the statistics generated during the ordering, use msglvl = 1. │ │ │ │ │ │ - February 8, 2025 Orderings and Front Trees 5 │ │ │ │ │ │ + January 7, 2024 Orderings and Front Trees 5 │ │ │ │ │ │ • Theseedparameterisusedasarandomnumberseed. (Therearemanyplacesinthegraphpartitioning │ │ │ │ │ │ and minimum degree algorithms where randomness plays a part. Using a random number seed ensures │ │ │ │ │ │ repeatability.) │ │ │ │ │ │ • maxdomainsize is used for the nested dissection and multisection orderings. This parameter is used │ │ │ │ │ │ during the graph partition. Any subgraph that is larger than maxdomainsize is split. We recommend │ │ │ │ │ │ using a value of neqns/16 or neqns/32. Note: maxdomainsize must be greater than zero. │ │ │ │ │ │ • maxzeros and maxsize are used to transform the front tree. In effect, we have placed the ordering │ │ │ │ │ │ @@ -203,15 +203,15 @@ │ │ │ │ │ │ 10102 4.6 210364 10651916 6.2 211089 10722231 │ │ │ │ │ │ 10103 4.6 215795 11760095 6.4 217141 11606103 │ │ │ │ │ │ 10104 4.6 210989 10842091 6.1 212828 11168728 │ │ │ │ │ │ 10105 4.8 209201 10335761 6.1 210468 10582750 │ │ │ │ │ │ For the nested dissection and multisection orderings, we used maxdomainsize = 100. We see that there is │ │ │ │ │ │ really little difference in ordering quality, while the minimum degree ordering takes much less time than the │ │ │ │ │ │ other orderings. │ │ │ │ │ │ - 6 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 6 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ Let us now look at a random triangulation of a unit cube. This matrix has 13824 rows and columns. │ │ │ │ │ │ Each face of the cube has a 22×22 regular grid of points. The remainder of the vertices are placed in the │ │ │ │ │ │ interior using quasi-random points, and the Delauney triangulation is computed. │ │ │ │ │ │ minimum degree nested dissection │ │ │ │ │ │ seed CPU #entries #ops CPU #entries #ops │ │ │ │ │ │ 10101 9.2 5783892 6119141542 27.8 3410222 1921402246 │ │ │ │ │ │ 10102 8.8 5651678 5959584620 31.4 3470063 1998795621 │ │ │ │ │ │ @@ -245,15 +245,15 @@ │ │ │ │ │ │ ETree *vetree ; │ │ │ │ │ │ int *newToOld, *oldToNew ; │ │ │ │ │ │ Graph *graph ; │ │ │ │ │ │ vetree = ETree_new() ; │ │ │ │ │ │ ETree_initFromGraphWithPerms(vetree, graph, newToOld, oldToNew) ; │ │ │ │ │ │ Thevetreeobjectinthecodefragmentaboveisavertex elimination tree [20], [26], where each front contains │ │ │ │ │ │ one vertex. │ │ │ │ │ │ - February 8, 2025 Orderings and Front Trees 7 │ │ │ │ │ │ + January 7, 2024 Orderings and Front Trees 7 │ │ │ │ │ │ Figure 2: R2D100: randomly triangulated, 100 grid points │ │ │ │ │ │ 48 49 51 50 55 91 8 11 10 9 │ │ │ │ │ │ 52 │ │ │ │ │ │ 53 69 54 17 18 │ │ │ │ │ │ 67 95 │ │ │ │ │ │ 70 19 │ │ │ │ │ │ 66 68 5 3 │ │ │ │ │ │ @@ -300,15 +300,15 @@ │ │ │ │ │ │ tree [2] has these property: any node in the tree is │ │ │ │ │ │ • either a leaf, │ │ │ │ │ │ • or has two or more children, │ │ │ │ │ │ • or its nonzero structure is not contained in that of its one child. │ │ │ │ │ │ The top tree in Figure 4 shows the vertex elimination tree with the “front” number of each vertex superim- │ │ │ │ │ │ posed on the vertex. The bottom tree is the fundamental supernode tree. Figure 5 shows the block partition │ │ │ │ │ │ 1Vertex j is the parent of i if j is the first vertex greater than i such that Lj,i 6= 0. │ │ │ │ │ │ - 8 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 8 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ Figure 3: Vertex elimination tree for R2D100, 100 rows and columns │ │ │ │ │ │ 99 │ │ │ │ │ │ 98 │ │ │ │ │ │ 97 │ │ │ │ │ │ 96 │ │ │ │ │ │ 95 │ │ │ │ │ │ 94 │ │ │ │ │ │ @@ -327,15 +327,15 @@ │ │ │ │ │ │ 7 17 31 39 55 65 71 78 81 │ │ │ │ │ │ 6 11 16 27 30 38 53 54 64 75 77 80 │ │ │ │ │ │ 2 5 8 10 13 15 22 26 29 37 52 59 63 76 79 │ │ │ │ │ │ 1 4 9 12 14 25 28 36 51 58 62 │ │ │ │ │ │ 0 3 24 35 49 50 57 60 61 │ │ │ │ │ │ 23 34 48 56 │ │ │ │ │ │ 33 │ │ │ │ │ │ - February 8, 2025 Orderings and Front Trees 9 │ │ │ │ │ │ + January 7, 2024 Orderings and Front Trees 9 │ │ │ │ │ │ superimposed on the structure of the factor L. Note this one important property: within any block column │ │ │ │ │ │ and below the diagonal block, a row is either zero or dense. │ │ │ │ │ │ The code fragment to convert a tree into a fundamental supernode tree is given below. │ │ │ │ │ │ ETree *fsetree, *vetree ; │ │ │ │ │ │ int maxzeros ; │ │ │ │ │ │ IV *nzerosIV ; │ │ │ │ │ │ nzerosIV = IV_new() ; │ │ │ │ │ │ @@ -368,15 +368,15 @@ │ │ │ │ │ │ This method will merge a node with all of its children if it will not result in more than maxzeros zeros inside │ │ │ │ │ │ the new block. On input, nzerosIV object keeps count of the number of zeroes already in the blocks of │ │ │ │ │ │ fsetree, and on return it will contain the number of zeros in the blocks of ametree. │ │ │ │ │ │ 3.4 Splitting large fronts │ │ │ │ │ │ There is one final step to constructing the tree that governs the factorization and solve. Large matrices will │ │ │ │ │ │ generate large supernodes at the topmost levels of the tree. For example, a k × k × k grid with a 27 point │ │ │ │ │ │ finite difference operator, when ordered by nested dissection, has a root supernode with k2 rows and columns. │ │ │ │ │ │ - 10 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 10 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ Figure 4: Top: vertex elimination tree with the vertices mapped to the fundamental supernode that contains │ │ │ │ │ │ them. Bottom: fundamental supernode tree. │ │ │ │ │ │ 71 │ │ │ │ │ │ 71 │ │ │ │ │ │ 71 │ │ │ │ │ │ 71 │ │ │ │ │ │ 71 │ │ │ │ │ │ @@ -407,17 +407,17 @@ │ │ │ │ │ │ 2 5 10 15 23 26 34 43 44 49 53 57 58 67 │ │ │ │ │ │ 1 4 7 9 12 14 18 22 25 33 42 48 52 56 63 66 │ │ │ │ │ │ 0 3 8 11 13 21 24 32 41 47 50 51 60 62 65 │ │ │ │ │ │ 20 31 39 40 46 61 64 │ │ │ │ │ │ 19 30 38 │ │ │ │ │ │ 29 │ │ │ │ │ │ 28 │ │ │ │ │ │ - February 8, 2025 Orderings and Front Trees 11 │ │ │ │ │ │ + January 7, 2024 Orderings and Front Trees 11 │ │ │ │ │ │ Figure 5: Block structure of L with the fundamental supernode partition. │ │ │ │ │ │ - 12 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 12 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ Figure 6: Top: fundamental supernode tree with the supernodes mapped to the amalgamated supernode │ │ │ │ │ │ that contains them. Bottom: amalgamated supernode tree. │ │ │ │ │ │ 24 │ │ │ │ │ │ 24 │ │ │ │ │ │ 24 │ │ │ │ │ │ 24 │ │ │ │ │ │ 24 │ │ │ │ │ │ @@ -442,17 +442,17 @@ │ │ │ │ │ │ 6 10 13 15 │ │ │ │ │ │ 10 │ │ │ │ │ │ 24 │ │ │ │ │ │ 4 12 18 23 │ │ │ │ │ │ 0 1 2 3 9 11 14 17 19 22 │ │ │ │ │ │ 7 8 10 13 15 16 20 21 │ │ │ │ │ │ 5 6 │ │ │ │ │ │ - February 8, 2025 Orderings and Front Trees 13 │ │ │ │ │ │ + January 7, 2024 Orderings and Front Trees 13 │ │ │ │ │ │ Figure 7: Block structure of L with the amalgamated supernode partition. │ │ │ │ │ │ - 14 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 14 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ The data structure for a top level supernode can be very large, too large to fit into memory. In a parallel │ │ │ │ │ │ environment, we follow the convention that each node in the tree is handled by one process. Having a very │ │ │ │ │ │ large node at the top levels of the tree will severely decrease the parallelism available to the computations. │ │ │ │ │ │ The solution to both problems, large data structures and limited parallelism, is to split large supernodes │ │ │ │ │ │ into pieces. We can specify a maximum size for the nodes in the tree, and split the large supernode into pieces │ │ │ │ │ │ no larger than this maximum size. This will keep the data structures to a manageable size and increase the │ │ │ │ │ │ available parallelism. We call the resulting tree the front tree because it represents the final computational │ │ │ │ │ │ @@ -488,15 +488,15 @@ │ │ │ │ │ │ of front trees. The original front tree came from our nested dissection ordering. │ │ │ │ │ │ There are 13824 rows and columns in the matrix, and 6001 fronts in the nested dissection tree. While │ │ │ │ │ │ there is an average of two rows and columns per front, most of the fronts are singleton fronts at the lower │ │ │ │ │ │ levels of the tree. The top level front has 750 internal rows and columns. │ │ │ │ │ │ • In the first step we create an fundamental supernode tree with a call to ETree mergeFrontsOne()with │ │ │ │ │ │ maxzeros = 0. We see that the number of fronts decreases by one and the number of entries does not │ │ │ │ │ │ change. │ │ │ │ │ │ - February 8, 2025 Orderings and Front Trees 15 │ │ │ │ │ │ + January 7, 2024 Orderings and Front Trees 15 │ │ │ │ │ │ Figure 8: Left: tree after the large supernodes have been split. Right: tree with nodes mapped back to their │ │ │ │ │ │ amalgamated supernode. │ │ │ │ │ │ 26 │ │ │ │ │ │ 26 │ │ │ │ │ │ 26 │ │ │ │ │ │ 26 │ │ │ │ │ │ 27 │ │ │ │ │ │ @@ -525,26 +525,26 @@ │ │ │ │ │ │ 28 │ │ │ │ │ │ 27 │ │ │ │ │ │ 26 │ │ │ │ │ │ 5 13 20 25 │ │ │ │ │ │ 4 10 12 19 21 24 │ │ │ │ │ │ 0 1 2 3 8 9 11 15 18 22 23 │ │ │ │ │ │ 6 7 14 16 17 │ │ │ │ │ │ - 16 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 16 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ Figure 9: Block structure of L with the amalgamated and split supernode partition. │ │ │ │ │ │ Table 1: R3D13824: front tree transformations │ │ │ │ │ │ CPU #fronts #indices # entries #operations │ │ │ │ │ │ original 6001 326858 3459359 1981403337 │ │ │ │ │ │ fs tree 0.040 6000 326103 3459359 1981403337 │ │ │ │ │ │ merge one 0.032 3477 158834 3497139 2000297117 │ │ │ │ │ │ merge all 0.020 748 95306 3690546 2021347776 │ │ │ │ │ │ merge any 0.012 597 85366 3753241 2035158539 │ │ │ │ │ │ split 0.043 643 115139 3753241 2035158539 │ │ │ │ │ │ final 0.423 643 115128 3752694 2034396840 │ │ │ │ │ │ - February 8, 2025 Orderings and Front Trees 17 │ │ │ │ │ │ + January 7, 2024 Orderings and Front Trees 17 │ │ │ │ │ │ • The second step is also a call to ETree mergeFrontsOne(), this time with maxzeros = 1000. Here │ │ │ │ │ │ we merge fronts with only one child with that child, in other words, only chains of nodes can merge │ │ │ │ │ │ together. Note how the number of fronts is decreased by almost one half, and the number of factor │ │ │ │ │ │ entries and operations increase by 1%. │ │ │ │ │ │ • The third step is a call to ETree mergeFrontsAll()with maxzeros = 1000, where we try to merge a │ │ │ │ │ │ node with all of its children if possible. The number of fronts decreases again by a factor of five, while │ │ │ │ │ │ the number of factor entries and operations increases by 7% and 2%, respectively, when compared with │ │ │ │ │ │ @@ -582,15 +582,15 @@ │ │ │ │ │ │ the final front tree, for the intra-front computations are a small fraction of the total number of operations. │ │ │ │ │ │ The solve time improves dramatically when small fronts are merged together into larger fronts. Our │ │ │ │ │ │ solves are submatrix algorithms, where the fundamental kernel is an operation Y := B −L X and │ │ │ │ │ │ J J J,I I │ │ │ │ │ │ X :=Y −U Y ,andisdesigned to be a BLAS2 kernel (when X and Y have a single column) or BLAS3 │ │ │ │ │ │ J J I,J J │ │ │ │ │ │ kernel (when X and Y are matrices). When fronts are small, particularly with one internal row and column, │ │ │ │ │ │ - 18 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 18 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ the submatrices that take part are very small. The overhead for the computations takes far more time than │ │ │ │ │ │ the computations themselves. │ │ │ │ │ │ This multistep process of merging, merging again, etc, and finally splitting the front trees is tedious. │ │ │ │ │ │ There are simple methods that do the process in one step. │ │ │ │ │ │ ETree *etree, *etree2, *etree3 ; │ │ │ │ │ │ int maxfrontsize, maxzeros, seed ; │ │ │ │ │ │ etree2 = ETree_transform(etree, NULL, maxzeros, maxfrontsize, seed) ; │ │ │ │ │ │ @@ -624,15 +624,15 @@ │ │ │ │ │ │ computations in the factorization and solve. If maxsize is too large, then too much of the computations in │ │ │ │ │ │ the factorization is done inside a front, which uses a slow kernel. If maxsize is too small, then the fronts are │ │ │ │ │ │ too small to get much computational efficiency. We recommend using a value between 32 and 96. Luckily, │ │ │ │ │ │ the factor and solve times are fairly flat within this range. A value of 64 is what we customarily use. │ │ │ │ │ │ References │ │ │ │ │ │ [1] P. Amestoy, T. Davis, and I. Duff. An approximate minimum degree ordering algorithm. SIAM J. │ │ │ │ │ │ Matrix Anal. Appl., 17:886–905, 1996. │ │ │ │ │ │ - February 8, 2025 Orderings and Front Trees 19 │ │ │ │ │ │ + January 7, 2024 Orderings and Front Trees 19 │ │ │ │ │ │ Table 3: R3D13824: the influence of maxzeros and maxsize. │ │ │ │ │ │ factor solve total │ │ │ │ │ │ maxzeros maxsize init CPU mflops postprocess CPU mflops CPU │ │ │ │ │ │ 0 ∞ 3.3 129.8 15.3 5.3 7.8 7.1 146.2 │ │ │ │ │ │ 10 ∞ 3.5 129.2 15.3 3.3 5.3 10.5 141.3 │ │ │ │ │ │ 100 ∞ 3.0 119.3 16.7 2.0 3.9 14.4 128.2 │ │ │ │ │ │ 1000 ∞ 3.0 121.8 16.7 1.4 3.5 17.0 129.7 │ │ │ │ │ │ @@ -665,15 +665,15 @@ │ │ │ │ │ │ Trans. Math. Software, 6:302–325, 1983. │ │ │ │ │ │ [10] J. A. George. Nested dissection of a regular finite element mesh. SIAM J. Numer. Anal., 10:345–363, │ │ │ │ │ │ 1973. │ │ │ │ │ │ [11] J. A. George and J. W. H. Liu. Computer Solution of Large Sparse Positive Definite Systems. Prentice- │ │ │ │ │ │ Hall, Englewood Cliffs, NJ, 1981. │ │ │ │ │ │ [12] A. Gupta. WGPP: Watson Graph Partitioning and sparse matrix ordering Package. Technical Report │ │ │ │ │ │ Users Manual, IBM T.J. Watson Research Center, New York, 1996. │ │ │ │ │ │ - 20 Orderings and Front Trees February 8, 2025 │ │ │ │ │ │ + 20 Orderings and Front Trees January 7, 2024 │ │ │ │ │ │ [13] B. Hendrickson and R. Leland. An improved spectral graph partitioning algorithm for mapping parallel │ │ │ │ │ │ computations. Technical Report SAND92-1460, Sandia National Laboratories, Albuquerque, NM, 1992. │ │ │ │ │ │ [14] B. Hendrickson and R. Leland. The Chaco user’s guide. Technical Report SAND93-2339, Sandia │ │ │ │ │ │ National Laboratories, Albuquerque, NM, 1993. │ │ │ │ │ │ [15] B. Hendrickson and E. Rothberg. Improving the runtime and quality of nested dissection ordering. │ │ │ │ │ │ SIAM J. Sci. Comput., 20:468–489, 1998. │ │ │ │ │ │ [16] G. Karypis and V. Kumar. A fast and high quality multilevel scheme for partitioning irregular graphs. │ │ │ ├── ./usr/share/doc/spooles-doc/GPart.ps.gz │ │ │ │ ├── GPart.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o GPart.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1789,21 +1789,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1987,88 +1986,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5505,26 +5499,26 @@ │ │ │ │ │ 56 62 93 31 2[31 62 56 1[51 62 50 1[54 11[86 2[84 4[106 │ │ │ │ │ 3[42 4[86 1[80 9[56 56 56 56 56 56 56 56 2[31 37 45[{}35 │ │ │ │ │ 99.6264 /CMBX12 rf /Fc 139[62 1[62 16[62 16[62 8[62 71[{}5 │ │ │ │ │ 119.552 /CMTT12 rf /Fd 255[55{}1 66.4176 /CMSY8 rf /Fe │ │ │ │ │ 134[71 2[71 75 52 53 55 1[75 67 75 112 2[41 37 75 67 │ │ │ │ │ 41 61 75 60 75 65 13[75 2[92 11[103 16[67 67 67 2[37 │ │ │ │ │ 46[{}27 119.552 /CMBX12 rf /Ff 132[52 6[41 4[52 58 46[49 │ │ │ │ │ -63[{}5 90.9091 /CMBX10 rf /Fg 134[48 3[51 2[36 12[40 │ │ │ │ │ -2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 │ │ │ │ │ -90.9091 /CMSL10 rf /Fh 156[83 46 78[61 61 18[{}4 83.022 │ │ │ │ │ -/CMEX10 rf /Fi 145[45 3[25 35 35 45 45 9[61 61 31[45 │ │ │ │ │ -4[0 3[61 28[71 71 1[71 17[71{}15 90.9091 /CMSY10 rf /Fj │ │ │ │ │ -146[62 1[37 1[24 17[67 20[53 66[{}5 66.4176 /CMMI8 rf │ │ │ │ │ -/Fk 204[35 35 35 35 4[55 43[{}5 66.4176 /CMR8 rf /Fl │ │ │ │ │ -134[45 14[37 5[47 10[53 1[86 53 2[56 16[69 68 2[71 45 │ │ │ │ │ -71 25 25 46[58 11[{}15 90.9091 /CMMI10 rf /Fm 136[60 │ │ │ │ │ -1[49 30 37 38 1[46 46 51 74 23 42 1[28 46 42 1[42 46 │ │ │ │ │ -42 42 46 12[65 1[66 11[59 62 69 2[68 6[28 7[46 4[33 32[51 │ │ │ │ │ -12[{}29 90.9091 /CMTI10 rf │ │ │ │ │ +63[{}5 90.9091 /CMBX10 rf /Fg 134[48 3[51 2[36 3[51 12[45 │ │ │ │ │ +22[47 15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 │ │ │ │ │ +/CMSL10 rf /Fh 156[83 46 78[61 61 18[{}4 83.022 /CMEX10 │ │ │ │ │ +rf /Fi 145[45 3[25 35 35 45 45 9[61 61 31[45 4[0 3[61 │ │ │ │ │ +28[71 71 1[71 17[71{}15 90.9091 /CMSY10 rf /Fj 146[62 │ │ │ │ │ +1[37 1[24 17[67 20[53 66[{}5 66.4176 /CMMI8 rf /Fk 204[35 │ │ │ │ │ +35 35 35 4[55 43[{}5 66.4176 /CMR8 rf /Fl 134[45 14[37 │ │ │ │ │ +5[47 10[53 1[86 53 2[56 16[69 68 2[71 45 71 25 25 46[58 │ │ │ │ │ +11[{}15 90.9091 /CMMI10 rf /Fm 136[60 1[49 30 37 38 1[46 │ │ │ │ │ +46 51 74 23 42 1[28 46 42 1[42 46 42 42 46 12[65 1[66 │ │ │ │ │ +11[59 62 69 2[68 6[28 7[46 4[33 32[51 12[{}29 90.9091 │ │ │ │ │ +/CMTI10 rf │ │ │ │ │ %DVIPSBitmapFont: Fn tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -5665,27 +5659,27 @@ │ │ │ │ │ b Fl(Y)55 b Fp(that)35 b(has)g(minimal)g(w)m(eigh)m(t.)56 │ │ │ │ │ b(W)-8 b(e)36 b(examine)g(t)m(w)m(o)227 5294 y(\(p)s(ossibly\))j │ │ │ │ │ (di\013eren)m(t)h(min-cuts)g(and)e(ev)-5 b(aluate)41 │ │ │ │ │ b(the)f(partitions)g(induced)e(via)i(their)g(minimal)f(w)m(eigh)m(t)227 │ │ │ │ │ 5407 y(separators,)31 b(and)f(accept)i(a)f(b)s(etter)f(partition)h(if)g │ │ │ │ │ (presen)m(t.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fp(2)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 0 399 a Fp(This)e(pro)s(cess)h(w) │ │ │ │ │ -m(e)g(call)i Fo(DDSEP)p Fp(,)d(whic)m(h)h(is)g(short)f(for)h │ │ │ │ │ -Fo(D)p Fm(omain)k Fo(D)p Fm(e)-5 b(c)g(omp)g(osition)35 │ │ │ │ │ -b Fo(SEP)p Fm(ar)-5 b(ator)p Fp(,)32 b(explained)e(in)g(more)0 │ │ │ │ │ -511 y(detail)i(in)e([)p Ff(?)p Fp(])h(and)f([)p Ff(?)p │ │ │ │ │ -Fp(].)0 827 y Fe(1.1)135 b(Data)46 b(Structures)0 1056 │ │ │ │ │ -y Fp(The)40 b Fo(GPart)e Fp(structure)i(has)f(a)i(p)s(oin)m(ter)f(to)h │ │ │ │ │ -(a)f Fo(Graph)f Fp(ob)5 b(ject)40 b(and)g(other)g(\014elds)g(that)g │ │ │ │ │ -(con)m(tain)i(information)0 1169 y(ab)s(out)30 b(the)h(partition)g(of)f │ │ │ │ │ -(the)h(graph.)141 1307 y(The)f(follo)m(wing)i(\014elds)e(are)g(alw)m(a) │ │ │ │ │ -m(ys)i(activ)m(e.)137 1523 y Fn(\210)45 b Fo(Graph)i(*graph)28 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fp(2)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 0 399 a Fp(This)e(pro)s(cess)h(w)m(e)g(call)i │ │ │ │ │ +Fo(DDSEP)p Fp(,)d(whic)m(h)h(is)g(short)f(for)h Fo(D)p │ │ │ │ │ +Fm(omain)k Fo(D)p Fm(e)-5 b(c)g(omp)g(osition)35 b Fo(SEP)p │ │ │ │ │ +Fm(ar)-5 b(ator)p Fp(,)32 b(explained)e(in)g(more)0 511 │ │ │ │ │ +y(detail)i(in)e([)p Ff(?)p Fp(])h(and)f([)p Ff(?)p Fp(].)0 │ │ │ │ │ +827 y Fe(1.1)135 b(Data)46 b(Structures)0 1056 y Fp(The)40 │ │ │ │ │ +b Fo(GPart)e Fp(structure)i(has)f(a)i(p)s(oin)m(ter)f(to)h(a)f │ │ │ │ │ +Fo(Graph)f Fp(ob)5 b(ject)40 b(and)g(other)g(\014elds)g(that)g(con)m │ │ │ │ │ +(tain)i(information)0 1169 y(ab)s(out)30 b(the)h(partition)g(of)f(the)h │ │ │ │ │ +(graph.)141 1307 y(The)f(follo)m(wing)i(\014elds)e(are)g(alw)m(a)m(ys)i │ │ │ │ │ +(activ)m(e.)137 1523 y Fn(\210)45 b Fo(Graph)i(*graph)28 │ │ │ │ │ b Fp(:)41 b(p)s(oin)m(ter)30 b(to)h(the)g Fo(Graph)e │ │ │ │ │ Fp(ob)5 b(ject)137 1713 y Fn(\210)45 b Fo(int)i(nvtx)29 │ │ │ │ │ b Fp(:)41 b(n)m(um)m(b)s(er)29 b(of)i(in)m(ternal)g(v)m(ertices)h(of)e │ │ │ │ │ (the)h(graph)137 1903 y Fn(\210)45 b Fo(int)i(nvbnd)29 │ │ │ │ │ b Fp(:)41 b(n)m(um)m(b)s(er)29 b(of)h(b)s(oundary)f(v)m(ertices)j(of)e │ │ │ │ │ (the)h(graph)137 2094 y Fn(\210)45 b Fo(int)i(ncomp)29 │ │ │ │ │ b Fp(:)41 b(n)m(um)m(b)s(er)29 b(of)h(comp)s(onen)m(ts)h(in)f(the)h │ │ │ │ │ @@ -5730,17 +5724,17 @@ │ │ │ │ │ b(It)32 b(con)m(tains)0 5053 y(input)g(parameters)h(for)f(the)h │ │ │ │ │ (di\013eren)m(t)g(stages)h(of)f(the)g Fo(DDSEP)e Fp(algorithm,)k(and)d │ │ │ │ │ (collects)j(statistics)f(ab)s(out)f(the)0 5166 y(CPU)d(time)h(sp)s(en)m │ │ │ │ │ (t)f(in)g(eac)m(h)i(stage.)137 5407 y Fn(\210)45 b Fp(These)30 │ │ │ │ │ b(parameters)h(are)g(used)e(to)j(generate)f(the)g(domain)f(decomp)s │ │ │ │ │ (osition.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1110 4 v 1291 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)41 b Fm(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fp(3)330 399 y Ff({)45 b Fo(int)i(minweight)p │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1129 4 v 1310 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)41 b Fm(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fp(3)330 399 y Ff({)45 b Fo(int)i(minweight)p │ │ │ │ │ Fp(:)38 b(minim)m(um)30 b(target)i(w)m(eigh)m(t)g(for)e(a)h(domain)330 │ │ │ │ │ 541 y Ff({)45 b Fo(int)i(maxweight)p Fp(:)38 b(maxim)m(um)31 │ │ │ │ │ b(target)h(w)m(eigh)m(t)f(for)g(a)f(domain)330 683 y │ │ │ │ │ Ff({)45 b Fo(double)h(freeze)p Fp(:)51 b(m)m(ultiplier)37 │ │ │ │ │ b(used)e(to)i(freeze)g(v)m(ertices)h(of)e(high)g(degree)h(in)m(to)g │ │ │ │ │ (the)f(m)m(ultisector.)427 796 y(If)h(the)h(degree)g(of)g │ │ │ │ │ Fo(v)f Fp(is)h(more)g(than)f Fo(freeze)f Fp(times)i(the)g(median)f │ │ │ │ │ @@ -5804,34 +5798,34 @@ │ │ │ │ │ (ter)0 5068 y Fe(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g │ │ │ │ │ (of)g Fc(GPart)e Fe(metho)t(ds)0 5294 y Fp(This)e(section)j(con)m │ │ │ │ │ (tains)f(brief)f(descriptions)g(including)f(protot)m(yp)s(es)i(of)f │ │ │ │ │ (all)h(metho)s(ds)f(that)h(b)s(elong)f(to)h(the)0 5407 │ │ │ │ │ y Fo(GPart)29 b Fp(ob)5 b(ject.)42 b(There)29 b(are)i(no)f(IO)g(metho)s │ │ │ │ │ (ds.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fp(4)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 0 399 a Fb(1.2.1)112 │ │ │ │ │ -b(Basic)38 b(metho)s(ds)0 599 y Fp(As)d(usual,)h(there)f(are)g(four)f │ │ │ │ │ -(basic)h(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 │ │ │ │ │ -b(creation,)i(setting)e(default)f(\014elds,)h(clearing)0 │ │ │ │ │ -712 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h(the)g(ob)5 │ │ │ │ │ -b(ject.)111 959 y(1.)46 b Fo(GPart)h(*)g(GPart_new)e(\()j(void)e(\))i │ │ │ │ │ -(;)227 1113 y Fp(This)28 b(metho)s(d)g(simply)h(allo)s(cates)i(storage) │ │ │ │ │ -f(for)e(the)h Fo(GPart)f Fp(structure)g(and)g(then)g(sets)i(the)f │ │ │ │ │ -(default)f(\014elds)227 1226 y(b)m(y)j(a)f(call)i(to)f │ │ │ │ │ -Fo(GPart)p 953 1226 29 4 v 33 w(setDefaultFields\(\))p │ │ │ │ │ -Fp(.)111 1422 y(2.)46 b Fo(void)h(GPart_setDefaultFields)42 │ │ │ │ │ -b(\()47 b(GPart)f(*gpart)h(\))g(;)227 1576 y Fp(This)34 │ │ │ │ │ -b(metho)s(d)g(sets)i(the)f(structure's)f(\014elds)g(to)i(default)f(v)-5 │ │ │ │ │ -b(alues:)49 b Fo(id)f(=)f(-1)p Fp(,)35 b Fo(nvtx)47 b(=)h(nvbnd)e(=)h │ │ │ │ │ -(ncomp)227 1689 y(=)h(0)p Fp(,)35 b Fo(g)g Fp(=)f Fo(par)g │ │ │ │ │ -Fp(=)g Fo(fch)g Fp(=)h Fo(sib)e Fp(=)i Fo(NULL)p Fp(,)f(and)g(the)h │ │ │ │ │ -(default)g(\014elds)f(for)g Fo(compidsIV)p Fp(,)f Fo(cweightsIV)f │ │ │ │ │ -Fp(and)227 1802 y Fo(vtxMapIV)c Fp(are)j(set)g(via)g(calls)h(to)f │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fp(4)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 0 399 a Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +599 y Fp(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ +(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ +(\014elds,)h(clearing)0 712 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ +(free'ing)h(the)g(ob)5 b(ject.)111 959 y(1.)46 b Fo(GPart)h(*)g │ │ │ │ │ +(GPart_new)e(\()j(void)e(\))i(;)227 1113 y Fp(This)28 │ │ │ │ │ +b(metho)s(d)g(simply)h(allo)s(cates)i(storage)f(for)e(the)h │ │ │ │ │ +Fo(GPart)f Fp(structure)g(and)g(then)g(sets)i(the)f(default)f(\014elds) │ │ │ │ │ +227 1226 y(b)m(y)j(a)f(call)i(to)f Fo(GPart)p 953 1226 │ │ │ │ │ +29 4 v 33 w(setDefaultFields\(\))p Fp(.)111 1422 y(2.)46 │ │ │ │ │ +b Fo(void)h(GPart_setDefaultFields)42 b(\()47 b(GPart)f(*gpart)h(\))g │ │ │ │ │ +(;)227 1576 y Fp(This)34 b(metho)s(d)g(sets)i(the)f(structure's)f │ │ │ │ │ +(\014elds)g(to)i(default)f(v)-5 b(alues:)49 b Fo(id)f(=)f(-1)p │ │ │ │ │ +Fp(,)35 b Fo(nvtx)47 b(=)h(nvbnd)e(=)h(ncomp)227 1689 │ │ │ │ │ +y(=)h(0)p Fp(,)35 b Fo(g)g Fp(=)f Fo(par)g Fp(=)g Fo(fch)g │ │ │ │ │ +Fp(=)h Fo(sib)e Fp(=)i Fo(NULL)p Fp(,)f(and)g(the)h(default)g(\014elds) │ │ │ │ │ +f(for)g Fo(compidsIV)p Fp(,)f Fo(cweightsIV)f Fp(and)227 │ │ │ │ │ +1802 y Fo(vtxMapIV)c Fp(are)j(set)g(via)g(calls)h(to)f │ │ │ │ │ Fo(IV)p 1498 1802 V 34 w(setDefaultFields\(\))p Fp(.)227 │ │ │ │ │ 1956 y Fm(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fp(If)30 │ │ │ │ │ b Fo(gpart)f Fp(is)i Fo(NULL)p Fp(,)e(an)h(error)g(message)i(is)e(prin) │ │ │ │ │ m(ted)g(and)g(the)h(program)f(exits.)111 2152 y(3.)46 │ │ │ │ │ b Fo(void)h(GPart_clearData)d(\()j(GPart)f(*gpart)g(\))i(;)227 │ │ │ │ │ 2306 y Fp(The)24 b Fo(IV)p 510 2306 V 34 w(clearData\(\))e │ │ │ │ │ Fp(metho)s(d)i(is)h(called)h(for)e(the)h Fo(compidsIV)p │ │ │ │ │ @@ -5874,17 +5868,17 @@ │ │ │ │ │ b(GPart)e(*gpart,)g(int)h(msglvl,)f(FILE)g(*msgFile)g(\))h(;)227 │ │ │ │ │ 5253 y Fp(This)30 b(metho)s(d)g(sets)g(the)h Fo(msglvl)e │ │ │ │ │ Fp(and)g Fo(msgFile)g Fp(\014elds.)227 5407 y Fm(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fp(If)30 b Fo(gpart)f │ │ │ │ │ Fp(is)i Fo(NULL)p Fp(,)e(an)h(error)g(message)i(is)e(prin)m(ted)g(and)g │ │ │ │ │ (the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1110 4 v 1291 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)41 b Fm(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fp(5)0 399 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1129 4 v 1310 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)41 b Fm(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fp(5)0 399 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ b(metho)s(ds)111 599 y Fp(1.)46 b Fo(void)h(GPart_setCweights)c(\()k │ │ │ │ │ (GPart)g(*gpart)f(\))h(;)227 753 y Fp(This)26 b(metho)s(d)g(sets)g(the) │ │ │ │ │ h(comp)s(onen)m(t)g(w)m(eigh)m(ts)g(v)m(ector)h Fo(cweightsIV)p │ │ │ │ │ Fp(.)c(W)-8 b(e)28 b(assume)e(that)h(the)f Fo(compidsIV)227 │ │ │ │ │ 866 y Fp(v)m(ector)33 b(has)f(b)s(een)e(set)i(prior)f(to)i(en)m(tering) │ │ │ │ │ f(this)f(metho)s(d.)44 b(The)31 b(w)m(eigh)m(t)i(of)e(a)h(comp)s(onen)m │ │ │ │ │ (t)g(is)g(not)f(simply)227 979 y(the)g(sum)f(of)g(the)h(w)m(eigh)m(ts)h │ │ │ │ │ @@ -5964,25 +5958,24 @@ │ │ │ │ │ g(domain.)227 5294 y Fm(Err)-5 b(or)33 b(che)-5 b(cking:)40 │ │ │ │ │ b Fp(If)29 b Fo(gpart)p Fp(,)f Fo(g)h Fp(or)h Fo(domid)e │ │ │ │ │ Fp(is)h Fo(NULL)p Fp(,)f(or)i(if)f Fo(v)g Fp(is)g(out)h(of)g(range)f │ │ │ │ │ (\(i.e.,)j Fo(v)25 b Fl(<)f Fp(0)30 b(or)g Fo(nvtx)24 │ │ │ │ │ b Fi(\024)h Fo(v)p Fp(\),)227 5407 y(an)31 b(error)f(message)h(is)f │ │ │ │ │ (prin)m(ted)g(and)g(the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fp(6)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 111 399 a Fp(6.)46 │ │ │ │ │ -b Fo(IV)h(*)h(GPart_bndWeightsIV)43 b(\()k(GPart)g(*gpart)f(\))h(;)227 │ │ │ │ │ -549 y Fp(This)27 b(metho)s(d)g(returns)f(an)h Fo(IV)g │ │ │ │ │ -Fp(ob)5 b(ject)28 b(that)g(con)m(tains)g(the)g(w)m(eigh)m(ts)h(of)e │ │ │ │ │ -(the)h(v)m(ertices)h(on)e(the)g(b)s(oundaries)227 661 │ │ │ │ │ -y(of)k(the)f(comp)s(onen)m(ts.)227 811 y Fm(Err)-5 b(or)34 │ │ │ │ │ -b(che)-5 b(cking:)40 b Fp(If)30 b Fo(gpart)f Fp(or)i │ │ │ │ │ -Fo(g)f Fp(is)g Fo(NULL)p Fp(,)g(an)g(error)g(message)h(is)g(prin)m(ted) │ │ │ │ │ -f(and)f(the)i(program)f(exits.)0 1079 y Fb(1.2.4)112 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fp(6)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 111 399 a Fp(6.)46 b Fo(IV)h(*)h(GPart_bndWeightsIV)43 │ │ │ │ │ +b(\()k(GPart)g(*gpart)f(\))h(;)227 549 y Fp(This)27 b(metho)s(d)g │ │ │ │ │ +(returns)f(an)h Fo(IV)g Fp(ob)5 b(ject)28 b(that)g(con)m(tains)g(the)g │ │ │ │ │ +(w)m(eigh)m(ts)h(of)e(the)h(v)m(ertices)h(on)e(the)g(b)s(oundaries)227 │ │ │ │ │ +661 y(of)k(the)f(comp)s(onen)m(ts.)227 811 y Fm(Err)-5 │ │ │ │ │ +b(or)34 b(che)-5 b(cking:)40 b Fp(If)30 b Fo(gpart)f │ │ │ │ │ +Fp(or)i Fo(g)f Fp(is)g Fo(NULL)p Fp(,)g(an)g(error)g(message)h(is)g │ │ │ │ │ +(prin)m(ted)f(and)f(the)i(program)f(exits.)0 1079 y Fb(1.2.4)112 │ │ │ │ │ b(Domain)39 b(decomp)s(osition)g(metho)s(ds)0 1276 y │ │ │ │ │ Fp(There)30 b(are)h(presen)m(tly)f(t)m(w)m(o)i(metho)s(ds)e(that)h │ │ │ │ │ (create)h(a)e(domain)h(decomp)s(osition)g(of)f(a)h(graph)f(or)g(a)h │ │ │ │ │ (subgraph.)111 1512 y(1.)46 b Fo(void)h(GPart_DDviaFishnet)c(\()k │ │ │ │ │ (GPart)g(*gpart,)e(double)h(frac,)h(int)g(minweight,)1468 │ │ │ │ │ 1624 y(int)g(maxweight,)e(int)i(seed)g(\))g(;)227 1775 │ │ │ │ │ y Fp(This)34 b(metho)s(d)f(generates)j(a)f(domain)f(decomp)s(osition)h │ │ │ │ │ @@ -6046,17 +6039,17 @@ │ │ │ │ │ b(W)-8 b(e)27 b(then)g(construct)g(the)227 5294 y(bipartite)j(graph)e │ │ │ │ │ (that)h(represen)m(ts)f(the)h(connectivit)m(y)i(of)e(the)g(domains)f │ │ │ │ │ (and)g(segmen)m(ts.)41 b(Eac)m(h)30 b(segmen)m(t)227 │ │ │ │ │ 5407 y(is)36 b(an)f(\\edge")i(that)g(connects)f(t)m(w)m(o)h(\\adjacen)m │ │ │ │ │ (t")h(domains.)56 b(This)34 b(allo)m(ws)j(us)e(to)h(use)g(a)g(v)-5 │ │ │ │ │ b(arian)m(t)36 b(of)g(the)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1110 4 v 1291 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)41 b Fm(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fp(7)227 399 y(Kernighan-Lin)k(algorithm)h(to)g │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1129 4 v 1310 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)41 b Fm(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fp(7)227 399 y(Kernighan-Lin)k(algorithm)h(to)g │ │ │ │ │ (\014nd)e(an)h(\\edge")i(separator)e(formed)g(of)g(segmen)m(ts,)j(whic) │ │ │ │ │ m(h)d(is)g(really)i(a)227 511 y(v)m(ertex)30 b(separator,)h(a)e(subset) │ │ │ │ │ f(of)h(\010.)40 b(The)29 b Fo(alpha)e Fp(parameter)j(is)f(used)f(in)h │ │ │ │ │ (the)g(cost)h(function)e(ev)-5 b(aluation)227 670 y(for)33 │ │ │ │ │ b(the)f(partition,)i(cost)q(\([)p Fl(S;)15 b(B)5 b(;)15 │ │ │ │ │ b(W)e Fp(]\))30 b(=)f Fi(j)p Fl(S)5 b Fi(j)1776 551 y │ │ │ │ │ Fh(\022)1838 670 y Fp(1)20 b(+)g Fl(\013)2062 608 y Fp(max)q │ │ │ │ │ @@ -6155,44 +6148,43 @@ │ │ │ │ │ Fp(\))p Fi(g)969 5407 y Fl(Y)1022 5421 y Fk(3)1144 5407 │ │ │ │ │ y Fp(=)83 b Fi(f)p Fl(y)28 b Fi(2)d Fl(Y)50 b Fi(j)31 │ │ │ │ │ b Fl(y)d Fi(2)d Fl(Ad)-10 b(j)5 b Fp(\()p Fl(B)26 b Fi(n)21 │ │ │ │ │ b Fl(Y)f Fp(\))30 b(and)g Fl(y)e Fi(2)d Fl(Ad)-10 b(j)5 │ │ │ │ │ b Fp(\()p Fl(W)34 b Fi(n)21 b Fl(Y)f Fp(\))p Fi(g)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fp(8)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 227 399 a Fp(The)e │ │ │ │ │ -Fo(YVmapIV)e Fp(ob)5 b(ject)30 b(con)m(tains)g(the)g(list)f(of)h(v)m │ │ │ │ │ -(ertices)g(in)f(the)g(wide)g(separator)h Fl(Y)20 b Fp(.)40 │ │ │ │ │ -b(The)29 b Fo(IV)f Fp(ob)5 b(ject)30 b(that)227 511 y(is)i(returned,)g │ │ │ │ │ -(\(called)h Fo(YCmapIV)d Fp(in)i(the)g(calling)i(metho)s(d\))e(con)m │ │ │ │ │ -(tains)h(the)f(subscripts)f(of)h(the)g Fl(Y)3561 525 │ │ │ │ │ -y Fk(0)3600 511 y Fp(,)h Fl(Y)3711 525 y Fk(1)3750 511 │ │ │ │ │ -y Fp(,)g Fl(Y)3861 525 y Fk(2)227 624 y Fp(or)e Fl(Y)392 │ │ │ │ │ -638 y Fk(3)461 624 y Fp(sets)g(that)g(con)m(tains)g(eac)m(h)h(v)m │ │ │ │ │ -(ertex.)227 784 y Fm(Err)-5 b(or)38 b(che)-5 b(cking:)49 │ │ │ │ │ -b Fp(If)35 b Fo(gpart)p Fp(,)f Fo(g)h Fp(or)g Fo(YVmapIV)d │ │ │ │ │ -Fp(is)j Fo(NULL)p Fp(,)f(or)h(if)g Fo(nvtx)c Fi(\024)h │ │ │ │ │ -Fp(0,)37 b(or)e(if)f Fo(YVmapIV)f Fp(is)i(empt)m(y)-8 │ │ │ │ │ -b(,)37 b(an)227 897 y(error)30 b(message)i(is)e(prin)m(ted)g(and)g(the) │ │ │ │ │ -g(program)h(exits.)111 1103 y(3.)46 b Fo(void)h(*)g │ │ │ │ │ -(GPart_smoothBy2layers)42 b(\()48 b(GPart)e(*gpart,)g(int)h(bipartite,) │ │ │ │ │ -e(float)h(alpha)h(\))g(;)227 1262 y Fp(This)22 b(metho)s(d)h(forms)f │ │ │ │ │ -(the)h(wide)g(separator)h Fl(Y)43 b Fp(from)22 b(t)m(w)m(o)i(la)m(y)m │ │ │ │ │ -(ers)h(of)e(v)m(ertices,)j(either)e Fl(Y)3205 1276 y │ │ │ │ │ -Fj(B)3291 1262 y Fp(=)g Fl(S)11 b Fi([)5 b Fp(\()p Fl(Ad)-10 │ │ │ │ │ -b(j)5 b Fp(\()p Fl(S)g Fp(\))g Fi(\\)227 1375 y Fl(B)g │ │ │ │ │ -Fp(\))36 b(or)g Fl(Y)542 1389 y Fj(W)657 1375 y Fp(=)e │ │ │ │ │ -Fl(S)29 b Fi([)24 b Fp(\()p Fl(Ad)-10 b(j)5 b Fp(\()p │ │ │ │ │ -Fl(S)g Fp(\))26 b Fi(\\)e Fl(W)13 b Fp(\).)57 b(\(If)36 │ │ │ │ │ -b Fi(j)p Fl(B)5 b Fi(j)35 b(\025)f(j)p Fl(W)13 b Fi(j)p │ │ │ │ │ -Fp(,)38 b(w)m(e)e(\014rst)f(lo)s(ok)i(at)g Fl(Y)2885 │ │ │ │ │ -1389 y Fj(B)2981 1375 y Fp(and)f(if)g(no)g(impro)m(v)m(emen)m(t)227 │ │ │ │ │ -1488 y(can)43 b(b)s(e)f(made)h(w)m(e)g(lo)s(ok)h(at)f │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fp(8)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 227 399 a Fp(The)e Fo(YVmapIV)e Fp(ob)5 │ │ │ │ │ +b(ject)30 b(con)m(tains)g(the)g(list)f(of)h(v)m(ertices)g(in)f(the)g │ │ │ │ │ +(wide)g(separator)h Fl(Y)20 b Fp(.)40 b(The)29 b Fo(IV)f │ │ │ │ │ +Fp(ob)5 b(ject)30 b(that)227 511 y(is)i(returned,)g(\(called)h │ │ │ │ │ +Fo(YCmapIV)d Fp(in)i(the)g(calling)i(metho)s(d\))e(con)m(tains)h(the)f │ │ │ │ │ +(subscripts)f(of)h(the)g Fl(Y)3561 525 y Fk(0)3600 511 │ │ │ │ │ +y Fp(,)h Fl(Y)3711 525 y Fk(1)3750 511 y Fp(,)g Fl(Y)3861 │ │ │ │ │ +525 y Fk(2)227 624 y Fp(or)e Fl(Y)392 638 y Fk(3)461 │ │ │ │ │ +624 y Fp(sets)g(that)g(con)m(tains)g(eac)m(h)h(v)m(ertex.)227 │ │ │ │ │ +784 y Fm(Err)-5 b(or)38 b(che)-5 b(cking:)49 b Fp(If)35 │ │ │ │ │ +b Fo(gpart)p Fp(,)f Fo(g)h Fp(or)g Fo(YVmapIV)d Fp(is)j │ │ │ │ │ +Fo(NULL)p Fp(,)f(or)h(if)g Fo(nvtx)c Fi(\024)h Fp(0,)37 │ │ │ │ │ +b(or)e(if)f Fo(YVmapIV)f Fp(is)i(empt)m(y)-8 b(,)37 b(an)227 │ │ │ │ │ +897 y(error)30 b(message)i(is)e(prin)m(ted)g(and)g(the)g(program)h │ │ │ │ │ +(exits.)111 1103 y(3.)46 b Fo(void)h(*)g(GPart_smoothBy2layers)42 │ │ │ │ │ +b(\()48 b(GPart)e(*gpart,)g(int)h(bipartite,)e(float)h(alpha)h(\))g(;) │ │ │ │ │ +227 1262 y Fp(This)22 b(metho)s(d)h(forms)f(the)h(wide)g(separator)h │ │ │ │ │ +Fl(Y)43 b Fp(from)22 b(t)m(w)m(o)i(la)m(y)m(ers)h(of)e(v)m(ertices,)j │ │ │ │ │ +(either)e Fl(Y)3205 1276 y Fj(B)3291 1262 y Fp(=)g Fl(S)11 │ │ │ │ │ +b Fi([)5 b Fp(\()p Fl(Ad)-10 b(j)5 b Fp(\()p Fl(S)g Fp(\))g │ │ │ │ │ +Fi(\\)227 1375 y Fl(B)g Fp(\))36 b(or)g Fl(Y)542 1389 │ │ │ │ │ +y Fj(W)657 1375 y Fp(=)e Fl(S)29 b Fi([)24 b Fp(\()p │ │ │ │ │ +Fl(Ad)-10 b(j)5 b Fp(\()p Fl(S)g Fp(\))26 b Fi(\\)e Fl(W)13 │ │ │ │ │ +b Fp(\).)57 b(\(If)36 b Fi(j)p Fl(B)5 b Fi(j)35 b(\025)f(j)p │ │ │ │ │ +Fl(W)13 b Fi(j)p Fp(,)38 b(w)m(e)e(\014rst)f(lo)s(ok)i(at)g │ │ │ │ │ +Fl(Y)2885 1389 y Fj(B)2981 1375 y Fp(and)f(if)g(no)g(impro)m(v)m(emen)m │ │ │ │ │ +(t)227 1488 y(can)43 b(b)s(e)f(made)h(w)m(e)g(lo)s(ok)h(at)f │ │ │ │ │ Fl(Y)1329 1502 y Fj(W)1409 1488 y Fp(,)j(and)d(the)f(rev)m(erse)i(if)f │ │ │ │ │ Fi(j)p Fl(W)13 b Fi(j)45 b Fl(>)h Fi(j)p Fl(B)5 b Fi(j)p │ │ │ │ │ Fp(.\))78 b(The)42 b Fo(bipartite)e Fp(parameter)227 │ │ │ │ │ 1601 y(de\014nes)28 b(the)h(t)m(yp)s(e)g(of)g(net)m(w)m(ork)h(problem)e │ │ │ │ │ (w)m(e)i(solv)m(e.)41 b(The)29 b(net)m(w)m(ork)g(induced)f(b)m(y)h(the) │ │ │ │ │ g(wide)g(separator)g Fl(Y)227 1714 y Fp(need)34 b(not)f(b)s(e)g │ │ │ │ │ (bipartite,)j(and)d(will)h(not)g(b)s(e)e(bipartite)j(if)e │ │ │ │ │ @@ -6277,17 +6269,17 @@ │ │ │ │ │ 5135 29 4 v 33 w(smoothYSep\(\))p Fp(.)227 5294 y Fm(Err)-5 │ │ │ │ │ b(or)40 b(che)-5 b(cking:)52 b Fp(If)36 b Fo(gpart)e │ │ │ │ │ Fp(is)j Fo(NULL)p Fp(,)e(or)h(if)h Fo(nlevel)c Fl(<)i │ │ │ │ │ Fp(0,)j(or)f(if)f Fo(alpha)e Fl(<)g Fp(0)p Fl(:)p Fp(0,)39 │ │ │ │ │ b(an)e(error)e(message)j(is)227 5407 y(prin)m(ted)30 │ │ │ │ │ b(and)g(the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1110 4 v 1291 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)41 b Fm(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fp(9)0 399 y Fb(1.2.7)112 b(Recursiv)m(e)38 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1129 4 v 1310 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)41 b Fm(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fp(9)0 399 y Fb(1.2.7)112 b(Recursiv)m(e)38 │ │ │ │ │ b(Bisection)f(metho)s(d)0 589 y Fp(There)30 b(is)g(presen)m(tly)h(one)g │ │ │ │ │ (metho)s(d)e(to)j(construct)e(the)h(domain/separator)g(tree.)111 │ │ │ │ │ 787 y(1.)46 b Fo(DSTree)g(*)i(GPart_RBviaDDsep)43 b(\()48 │ │ │ │ │ b(GPart)e(*gpart,)g(DDsepInfo)f(*info)h(\))i(;)227 932 │ │ │ │ │ y Fp(This)c(metho)s(d)f(p)s(erforms)f(a)j(recursiv)m(e)f(bisection)h │ │ │ │ │ (of)f(the)h(graph)e(using)h(the)g Fo(DDSEP)e Fp(algorithm)k(and)227 │ │ │ │ │ 1045 y(returns)25 b(a)h Fo(DSTree)e Fp(ob)5 b(ject)27 │ │ │ │ │ @@ -6350,62 +6342,61 @@ │ │ │ │ │ (whether)e Fo(info)f Fp(is)i Fo(NULL)p Fp(.)f Fo(DDsepInfo)p │ │ │ │ │ 2663 5150 V 32 w(setDefaultFields\(\))c Fp(is)32 b(called)227 │ │ │ │ │ 5263 y(to)f(set)g(the)g(default)f(v)-5 b(alues.)227 5407 │ │ │ │ │ y Fm(Err)g(or)34 b(che)-5 b(cking:)40 b Fp(If)30 b Fo(info)g │ │ │ │ │ Fp(is)g Fo(NULL)p Fp(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f │ │ │ │ │ (the)i(program)f(exits.)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fp(10)p 182 100 1087 4 │ │ │ │ │ -v 1270 w Fo(GPart)28 b Fg(:)41 b Fm(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 111 399 a Fp(4.)46 │ │ │ │ │ -b Fo(void)h(DDsepInfo_free)d(\()j(DDsepInfo)f(*info)g(\))h(;)227 │ │ │ │ │ -545 y Fp(This)33 b(metho)s(d)g(c)m(hec)m(ks)h(to)g(see)g(whether)f │ │ │ │ │ -Fo(info)f Fp(is)h Fo(NULL)p Fp(.)g(If)g(so,)h(an)f(error)g(message)i │ │ │ │ │ -(is)e(prin)m(ted)g(and)g(the)227 658 y(program)f(exits.)46 │ │ │ │ │ -b(Otherwise,)32 b(it)g(releases)h(an)m(y)g(storage)g(b)m(y)f(a)g(call)h │ │ │ │ │ -(to)g Fo(DDsepInfo)p 3141 658 29 4 v 31 w(clearData\(\))c │ │ │ │ │ -Fp(then)227 771 y(free's)i(the)f(storage)i(for)e(the)h(structure)f │ │ │ │ │ -(with)g(a)h(call)g(to)h Fo(free\(\))p Fp(.)227 917 y │ │ │ │ │ -Fm(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fp(If)30 b Fo(info)g │ │ │ │ │ -Fp(is)g Fo(NULL)p Fp(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f │ │ │ │ │ -(the)i(program)f(exits.)111 1097 y(5.)46 b Fo(void)h │ │ │ │ │ -(DDsepInfo_writeCpuTimes)41 b(\()48 b(DDsepInfo)d(*info,)h(FILE)h │ │ │ │ │ -(*msgFile)e(\))j(;)227 1244 y Fp(This)32 b(metho)s(d)h(writes)f(a)i │ │ │ │ │ -(breakdo)m(wn)e(of)h(the)g(CPU)f(times)i(in)e(a)i(meaningful)e(format.) │ │ │ │ │ -49 b(Here)33 b(is)g(sample)227 1357 y(output.)275 1559 │ │ │ │ │ -y Fo(CPU)47 b(breakdown)e(for)i(graph)f(partition)943 │ │ │ │ │ -1671 y(raw)h(CPU)142 b(per)47 b(cent)275 1784 y(misc)333 │ │ │ │ │ -b(:)286 b(1.61)190 b(1.2\045)275 1897 y(Split)285 b(:)238 │ │ │ │ │ -b(24.68)142 b(17.7\045)275 2010 y(find)47 b(DD)190 b(:)238 │ │ │ │ │ -b(12.13)190 b(8.7\045)275 2123 y(DomSeg)46 b(Map)h(:)238 │ │ │ │ │ -b(13.09)190 b(9.4\045)275 2236 y(DomSeg)46 b(BPG)h(:)286 │ │ │ │ │ -b(4.66)190 b(3.3\045)275 2349 y(BKL)381 b(:)286 b(5.68)190 │ │ │ │ │ -b(4.1\045)275 2462 y(Smooth)237 b(:)h(77.83)142 b(55.7\045)275 │ │ │ │ │ -2575 y(Total)285 b(:)191 b(139.67)93 b(100.0\045)227 │ │ │ │ │ -2777 y Fm(Err)-5 b(or)41 b(che)-5 b(cking:)56 b Fp(If)38 │ │ │ │ │ -b Fo(info)f Fp(or)h Fo(msgFile)e Fp(is)j Fo(NULL)p Fp(,)e(an)h(error)g │ │ │ │ │ -(message)h(is)f(prin)m(ted)g(and)g(the)g(program)227 │ │ │ │ │ -2890 y(exits.)0 3194 y Fe(1.3)135 b(Driv)l(er)46 b(programs)g(for)f │ │ │ │ │ -(the)g Fc(GPart)d Fe(ob)7 b(ject)0 3418 y Fp(This)30 │ │ │ │ │ -b(section)h(con)m(tains)h(brief)e(descriptions)g(of)g(four)g(driv)m(er) │ │ │ │ │ -g(programs.)111 3628 y(1.)46 b Fo(testDDviaFishnet)e(msglvl)i(msgFile)g │ │ │ │ │ -(inGraphFile)e(freeze)i(minweight)g(maxweight)1039 3741 │ │ │ │ │ -y(seed)g(outIVfile)227 3887 y Fp(This)24 b(driv)m(er)g(program)g │ │ │ │ │ -(constructs)g(a)h(domain)f(decomp)s(osition)h(via)g(the)f │ │ │ │ │ -Fm(\014shnet)h Fp(algorithm)g([)p Ff(?)q Fp(].)39 b(It)24 │ │ │ │ │ -b(reads)227 4000 y(in)f(a)h Fo(Graph)e Fp(ob)5 b(ject)24 │ │ │ │ │ -b(from)f(a)h(\014le,)h(\014nds)c(the)j(domain)f(decomp)s(osition)h │ │ │ │ │ -(using)f(the)g(four)g(input)f(parameters,)227 4113 y(then)30 │ │ │ │ │ -b(optionally)i(writes)f(out)f(the)h(map)f(from)g(v)m(ertices)i(to)f │ │ │ │ │ -(comp)s(onen)m(ts)f(to)h(a)g(\014le.)337 4314 y Fn(\210)45 │ │ │ │ │ -b Fp(The)30 b Fo(msglvl)f Fp(parameter)i(determines)f(the)h(amoun)m(t)f │ │ │ │ │ -(of)h(output.)337 4453 y Fn(\210)45 b Fp(The)37 b Fo(msgFile)e │ │ │ │ │ -Fp(parameter)j(determines)f(the)g(output)g(\014le)g(|)g(if)g │ │ │ │ │ -Fo(msgFile)e Fp(is)j Fo(stdout)p Fp(,)f(then)g(the)427 │ │ │ │ │ -4566 y(output)29 b(\014le)h(is)f Fm(stdout)p Fp(,)i(otherwise)f(a)f │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fp(10)p 182 100 1106 4 │ │ │ │ │ +v 1289 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)30 b Fg(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 111 399 a Fp(4.)46 b Fo(void)h(DDsepInfo_free)d(\()j │ │ │ │ │ +(DDsepInfo)f(*info)g(\))h(;)227 545 y Fp(This)33 b(metho)s(d)g(c)m(hec) │ │ │ │ │ +m(ks)h(to)g(see)g(whether)f Fo(info)f Fp(is)h Fo(NULL)p │ │ │ │ │ +Fp(.)g(If)g(so,)h(an)f(error)g(message)i(is)e(prin)m(ted)g(and)g(the) │ │ │ │ │ +227 658 y(program)f(exits.)46 b(Otherwise,)32 b(it)g(releases)h(an)m(y) │ │ │ │ │ +g(storage)g(b)m(y)f(a)g(call)h(to)g Fo(DDsepInfo)p 3141 │ │ │ │ │ +658 29 4 v 31 w(clearData\(\))c Fp(then)227 771 y(free's)i(the)f │ │ │ │ │ +(storage)i(for)e(the)h(structure)f(with)g(a)h(call)g(to)h │ │ │ │ │ +Fo(free\(\))p Fp(.)227 917 y Fm(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +b(cking:)40 b Fp(If)30 b Fo(info)g Fp(is)g Fo(NULL)p │ │ │ │ │ +Fp(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ +(exits.)111 1097 y(5.)46 b Fo(void)h(DDsepInfo_writeCpuTimes)41 │ │ │ │ │ +b(\()48 b(DDsepInfo)d(*info,)h(FILE)h(*msgFile)e(\))j(;)227 │ │ │ │ │ +1244 y Fp(This)32 b(metho)s(d)h(writes)f(a)i(breakdo)m(wn)e(of)h(the)g │ │ │ │ │ +(CPU)f(times)i(in)e(a)i(meaningful)e(format.)49 b(Here)33 │ │ │ │ │ +b(is)g(sample)227 1357 y(output.)275 1559 y Fo(CPU)47 │ │ │ │ │ +b(breakdown)e(for)i(graph)f(partition)943 1671 y(raw)h(CPU)142 │ │ │ │ │ +b(per)47 b(cent)275 1784 y(misc)333 b(:)286 b(1.61)190 │ │ │ │ │ +b(1.2\045)275 1897 y(Split)285 b(:)238 b(24.68)142 b(17.7\045)275 │ │ │ │ │ +2010 y(find)47 b(DD)190 b(:)238 b(12.13)190 b(8.7\045)275 │ │ │ │ │ +2123 y(DomSeg)46 b(Map)h(:)238 b(13.09)190 b(9.4\045)275 │ │ │ │ │ +2236 y(DomSeg)46 b(BPG)h(:)286 b(4.66)190 b(3.3\045)275 │ │ │ │ │ +2349 y(BKL)381 b(:)286 b(5.68)190 b(4.1\045)275 2462 │ │ │ │ │ +y(Smooth)237 b(:)h(77.83)142 b(55.7\045)275 2575 y(Total)285 │ │ │ │ │ +b(:)191 b(139.67)93 b(100.0\045)227 2777 y Fm(Err)-5 │ │ │ │ │ +b(or)41 b(che)-5 b(cking:)56 b Fp(If)38 b Fo(info)f Fp(or)h │ │ │ │ │ +Fo(msgFile)e Fp(is)j Fo(NULL)p Fp(,)e(an)h(error)g(message)h(is)f(prin) │ │ │ │ │ +m(ted)g(and)g(the)g(program)227 2890 y(exits.)0 3194 │ │ │ │ │ +y Fe(1.3)135 b(Driv)l(er)46 b(programs)g(for)f(the)g │ │ │ │ │ +Fc(GPart)d Fe(ob)7 b(ject)0 3418 y Fp(This)30 b(section)h(con)m(tains)h │ │ │ │ │ +(brief)e(descriptions)g(of)g(four)g(driv)m(er)g(programs.)111 │ │ │ │ │ +3628 y(1.)46 b Fo(testDDviaFishnet)e(msglvl)i(msgFile)g(inGraphFile)e │ │ │ │ │ +(freeze)i(minweight)g(maxweight)1039 3741 y(seed)g(outIVfile)227 │ │ │ │ │ +3887 y Fp(This)24 b(driv)m(er)g(program)g(constructs)g(a)h(domain)f │ │ │ │ │ +(decomp)s(osition)h(via)g(the)f Fm(\014shnet)h Fp(algorithm)g([)p │ │ │ │ │ +Ff(?)q Fp(].)39 b(It)24 b(reads)227 4000 y(in)f(a)h Fo(Graph)e │ │ │ │ │ +Fp(ob)5 b(ject)24 b(from)f(a)h(\014le,)h(\014nds)c(the)j(domain)f │ │ │ │ │ +(decomp)s(osition)h(using)f(the)g(four)g(input)f(parameters,)227 │ │ │ │ │ +4113 y(then)30 b(optionally)i(writes)f(out)f(the)h(map)f(from)g(v)m │ │ │ │ │ +(ertices)i(to)f(comp)s(onen)m(ts)f(to)h(a)g(\014le.)337 │ │ │ │ │ +4314 y Fn(\210)45 b Fp(The)30 b Fo(msglvl)f Fp(parameter)i(determines)f │ │ │ │ │ +(the)h(amoun)m(t)f(of)h(output.)337 4453 y Fn(\210)45 │ │ │ │ │ +b Fp(The)37 b Fo(msgFile)e Fp(parameter)j(determines)f(the)g(output)g │ │ │ │ │ +(\014le)g(|)g(if)g Fo(msgFile)e Fp(is)j Fo(stdout)p Fp(,)f(then)g(the) │ │ │ │ │ +427 4566 y(output)29 b(\014le)h(is)f Fm(stdout)p Fp(,)i(otherwise)f(a)f │ │ │ │ │ (\014le)h(is)f(op)s(ened)g(with)g Fm(app)-5 b(end)31 │ │ │ │ │ b Fp(status)e(to)i(receiv)m(e)g(an)m(y)e(output)427 4679 │ │ │ │ │ y(data.)337 4817 y Fn(\210)45 b Fp(The)23 b Fo(inGraphFile)d │ │ │ │ │ Fp(parameter)k(is)f(the)h(input)e(\014le)i(for)f(the)g │ │ │ │ │ Fo(Graph)f Fp(ob)5 b(ject.)39 b(It)24 b(m)m(ust)f(b)s(e)f(of)i(the)f │ │ │ │ │ (form)427 4930 y Fo(*.graphf)18 b Fp(or)j Fo(*.graphb)p │ │ │ │ │ Fp(.)35 b(The)19 b Fo(Graph)g Fp(ob)5 b(ject)21 b(is)g(read)f(from)g │ │ │ │ │ @@ -6414,17 +6405,17 @@ │ │ │ │ │ y Fn(\210)45 b Fp(The)29 b Fo(freeze)e Fp(parameter)j(is)f(used)f(to)i │ │ │ │ │ (place)g(no)s(des)e(of)h(high)g(degree)h(in)m(to)g(the)f(m)m │ │ │ │ │ (ultisector.)42 b(If)29 b(the)427 5294 y(external)34 │ │ │ │ │ b(degree)f(of)g(a)g(v)m(ertex)h(is)f Fo(freeze)d Fp(times)k(the)f(a)m │ │ │ │ │ (v)m(erage)i(degree,)f(then)e(it)i(is)e(placed)h(in)g(the)427 │ │ │ │ │ 5407 y(m)m(ultisector.)p eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1087 4 v 1269 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)40 b Fm(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fp(11)337 399 y Fn(\210)45 b Fp(The)30 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1106 4 v 1288 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)40 b Fm(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fp(11)337 399 y Fn(\210)45 b Fp(The)30 │ │ │ │ │ b Fm(tar)-5 b(get)32 b Fp(minim)m(um)d(w)m(eigh)m(t)j(for)e(a)h(domain) │ │ │ │ │ f(is)h Fo(minweight)p Fp(.)337 551 y Fn(\210)45 b Fp(The)30 │ │ │ │ │ b Fm(tar)-5 b(get)32 b Fp(maxim)m(um)e(w)m(eigh)m(t)i(for)e(a)h(domain) │ │ │ │ │ f(is)g Fo(maxweight)p Fp(.)337 703 y Fn(\210)45 b Fp(The)30 │ │ │ │ │ b Fo(seed)f Fp(parameter)i(is)g(a)f(random)g(n)m(um)m(b)s(er)f(seed.) │ │ │ │ │ 337 856 y Fn(\210)45 b Fp(The)39 b Fo(outIVfile)d Fp(parameter)k(is)f │ │ │ │ │ (the)g(output)f(\014le)h(for)g(the)g Fo(IV)g Fp(ob)5 │ │ │ │ │ @@ -6493,32 +6484,32 @@ │ │ │ │ │ 5181 y Fn(\210)45 b Fp(The)37 b Fo(msgFile)e Fp(parameter)j(determines) │ │ │ │ │ f(the)g(output)g(\014le)g(|)g(if)g Fo(msgFile)e Fp(is)j │ │ │ │ │ Fo(stdout)p Fp(,)f(then)g(the)427 5294 y(output)29 b(\014le)h(is)f │ │ │ │ │ Fm(stdout)p Fp(,)i(otherwise)f(a)f(\014le)h(is)f(op)s(ened)g(with)g │ │ │ │ │ Fm(app)-5 b(end)31 b Fp(status)e(to)i(receiv)m(e)g(an)m(y)e(output)427 │ │ │ │ │ 5407 y(data.)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fp(12)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fo(GPart)28 b Fg(:)41 b Fm(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 337 399 a Fn(\210)45 │ │ │ │ │ -b Fp(The)23 b Fo(inGraphFile)d Fp(parameter)k(is)f(the)h(input)e │ │ │ │ │ -(\014le)i(for)f(the)g Fo(Graph)f Fp(ob)5 b(ject.)39 b(It)24 │ │ │ │ │ -b(m)m(ust)f(b)s(e)f(of)i(the)f(form)427 511 y Fo(*.graphf)18 │ │ │ │ │ -b Fp(or)j Fo(*.graphb)p Fp(.)35 b(The)19 b Fo(Graph)g │ │ │ │ │ -Fp(ob)5 b(ject)21 b(is)g(read)f(from)g(the)g(\014le)h(via)f(the)h │ │ │ │ │ -Fo(Graph)p 3368 511 29 4 v 33 w(readFromFile\(\))427 │ │ │ │ │ -624 y Fp(metho)s(d.)337 770 y Fn(\210)45 b Fp(The)31 │ │ │ │ │ -b Fo(inIVfile)d Fp(parameter)k(is)f(the)g(input)f(\014le)h(for)g(the)g │ │ │ │ │ -Fo(IV)f Fp(ob)5 b(ject)32 b(that)g(con)m(tains)g(the)f(map)f(from)427 │ │ │ │ │ -882 y(v)m(ertices)i(to)f(domains)g(and)e(m)m(ultisector.)43 │ │ │ │ │ -b(It)30 b Fo(inIVfile)e Fp(m)m(ust)i(b)s(e)g(of)h(the)f(form)g │ │ │ │ │ -Fo(*.ivf)f Fp(or)i Fo(*.ivb)p Fp(.)337 1028 y Fn(\210)45 │ │ │ │ │ -b Fp(The)32 b Fo(option)f Fp(parameter)i(sp)s(eci\014es)f(the)h(t)m(yp) │ │ │ │ │ -s(e)f(of)h(net)m(w)m(ork)g(optimization)i(problem)d(that)h(will)g(b)s │ │ │ │ │ -(e)427 1141 y(solv)m(ed.)500 1286 y Ff({)45 b Fo(option)h(=)i(1)30 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fp(12)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)30 b Fg(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 337 399 a Fn(\210)45 b Fp(The)23 b │ │ │ │ │ +Fo(inGraphFile)d Fp(parameter)k(is)f(the)h(input)e(\014le)i(for)f(the)g │ │ │ │ │ +Fo(Graph)f Fp(ob)5 b(ject.)39 b(It)24 b(m)m(ust)f(b)s(e)f(of)i(the)f │ │ │ │ │ +(form)427 511 y Fo(*.graphf)18 b Fp(or)j Fo(*.graphb)p │ │ │ │ │ +Fp(.)35 b(The)19 b Fo(Graph)g Fp(ob)5 b(ject)21 b(is)g(read)f(from)g │ │ │ │ │ +(the)g(\014le)h(via)f(the)h Fo(Graph)p 3368 511 29 4 │ │ │ │ │ +v 33 w(readFromFile\(\))427 624 y Fp(metho)s(d.)337 770 │ │ │ │ │ +y Fn(\210)45 b Fp(The)31 b Fo(inIVfile)d Fp(parameter)k(is)f(the)g │ │ │ │ │ +(input)f(\014le)h(for)g(the)g Fo(IV)f Fp(ob)5 b(ject)32 │ │ │ │ │ +b(that)g(con)m(tains)g(the)f(map)f(from)427 882 y(v)m(ertices)i(to)f │ │ │ │ │ +(domains)g(and)e(m)m(ultisector.)43 b(It)30 b Fo(inIVfile)e │ │ │ │ │ +Fp(m)m(ust)i(b)s(e)g(of)h(the)f(form)g Fo(*.ivf)f Fp(or)i │ │ │ │ │ +Fo(*.ivb)p Fp(.)337 1028 y Fn(\210)45 b Fp(The)32 b Fo(option)f │ │ │ │ │ +Fp(parameter)i(sp)s(eci\014es)f(the)h(t)m(yp)s(e)f(of)h(net)m(w)m(ork)g │ │ │ │ │ +(optimization)i(problem)d(that)h(will)g(b)s(e)427 1141 │ │ │ │ │ +y(solv)m(ed.)500 1286 y Ff({)45 b Fo(option)h(=)i(1)30 │ │ │ │ │ b Fp(|)g(eac)m(h)i(net)m(w)m(ork)f(has)f(t)m(w)m(o)i(la)m(y)m(ers)f │ │ │ │ │ (and)f(is)h(bipartite.)500 1415 y Ff({)45 b Fo(option)h(=)i(2)30 │ │ │ │ │ b Fp(|)g(eac)m(h)i(net)m(w)m(ork)f(has)f(t)m(w)m(o)i(la)m(y)m(ers)f │ │ │ │ │ (but)f(need)g(not)h(b)s(e)f(bipartite.)500 1544 y Ff({)45 │ │ │ │ │ b Fo(option)h(=)i(2)30 b Fp(|)g(eac)m(h)i(net)m(w)m(ork)f(has)f │ │ │ │ │ Fo(option/2)e Fp(la)m(y)m(ers)k(on)e(eac)m(h)i(side)e(of)h(the)f │ │ │ │ │ (separator.)337 1689 y Fn(\210)45 b Fp(The)30 b Fo(alpha)f │ │ │ │ │ @@ -6574,17 +6565,17 @@ │ │ │ │ │ y Fn(\210)45 b Fp(The)30 b Fo(alpha)f Fp(parameter)i(con)m(trols)h(the) │ │ │ │ │ e(partition)h(ev)-5 b(aluation)32 b(function.)337 5294 │ │ │ │ │ y Fn(\210)45 b Fp(The)i Fo(maxdomweight)e Fp(parameter)j(con)m(trols)g │ │ │ │ │ (the)g(recursiv)m(e)g(bisection)h(|)e(no)g(subgraph)f(with)427 │ │ │ │ │ 5407 y(w)m(eigh)m(t)32 b(less)f(than)f Fo(maxdomweight)d │ │ │ │ │ Fp(is)j(further)f(split.)p eop end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 91 100 1087 4 v 1269 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)40 b Fm(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fp(13)337 399 y Fn(\210)45 b Fp(The)c │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1106 4 v 1288 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)40 b Fm(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fp(13)337 399 y Fn(\210)45 b Fp(The)c │ │ │ │ │ Fo(DDoption)e Fp(parameter)j(con)m(trols)h(the)f(initial)h │ │ │ │ │ (domain/segmen)m(t)g(partition)f(on)f(eac)m(h)i(sub-)427 │ │ │ │ │ 511 y(graph.)60 b(When)37 b Fo(DDDoption)45 b(=)j(1)37 │ │ │ │ │ b Fp(w)m(e)g(use)g(the)g(\014shnet)f(algorithm)i(for)f(eac)m(h)h │ │ │ │ │ (subgraph.)59 b(When)427 624 y Fo(DDDoption)46 b(=)h(1)32 │ │ │ │ │ b Fp(w)m(e)h(use)f(the)h(\014shnet)e(algorithm)j(once)f(for)f(the)g(en) │ │ │ │ │ m(tire)i(graph)e(and)f(this)i(is)f(then)427 737 y(pro)5 │ │ │ │ │ @@ -6654,26 +6645,25 @@ │ │ │ │ │ 5275 y Ff({)45 b Fo(nlayer)h(=)i(2)30 b Fp(|)g(eac)m(h)i(net)m(w)m(ork) │ │ │ │ │ f(has)f(t)m(w)m(o)i(la)m(y)m(ers)f(but)f(need)g(not)h(b)s(e)f │ │ │ │ │ (bipartite.)500 5407 y Ff({)45 b Fo(nlayer)h(>)i(2)30 │ │ │ │ │ b Fp(|)g(eac)m(h)i(net)m(w)m(ork)f(has)f Fo(option/2)e │ │ │ │ │ Fp(la)m(y)m(ers)k(on)e(eac)m(h)i(side)e(of)h(the)f(separator.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ -TeXDict begin 14 13 bop 0 100 a Fp(14)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fo(GPart)28 b Fg(:)41 b Fm(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 337 399 a Fn(\210)45 │ │ │ │ │ -b Fp(The)34 b Fo(outDSTreeFile)d Fp(parameter)k(is)f(the)h(output)f │ │ │ │ │ -(\014le)g(for)g(the)h Fo(DSTree)e Fp(ob)5 b(ject.)53 │ │ │ │ │ -b(It)35 b(m)m(ust)f(b)s(e)g(of)427 511 y(the)29 b(form)f │ │ │ │ │ -Fo(*.dstreef)e Fp(or)j Fo(*.dstreeb)p Fp(.)37 b(If)29 │ │ │ │ │ -b Fo(outDSTreeFile)24 b Fp(is)29 b(not)g Fo("none")p │ │ │ │ │ -Fp(,)e(the)i Fo(DSTree)e Fp(ob)5 b(ject)427 624 y(is)31 │ │ │ │ │ -b(written)f(to)h(the)g(\014le)f(via)h(the)g Fo(DSTree)p │ │ │ │ │ -1851 624 29 4 v 33 w(writeToFile\(\))26 b Fp(metho)s(d.)p │ │ │ │ │ -eop end │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fp(14)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)30 b Fg(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 337 399 a Fn(\210)45 b Fp(The)34 b │ │ │ │ │ +Fo(outDSTreeFile)d Fp(parameter)k(is)f(the)h(output)f(\014le)g(for)g │ │ │ │ │ +(the)h Fo(DSTree)e Fp(ob)5 b(ject.)53 b(It)35 b(m)m(ust)f(b)s(e)g(of) │ │ │ │ │ +427 511 y(the)29 b(form)f Fo(*.dstreef)e Fp(or)j Fo(*.dstreeb)p │ │ │ │ │ +Fp(.)37 b(If)29 b Fo(outDSTreeFile)24 b Fp(is)29 b(not)g │ │ │ │ │ +Fo("none")p Fp(,)e(the)i Fo(DSTree)e Fp(ob)5 b(ject)427 │ │ │ │ │ +624 y(is)31 b(written)f(to)h(the)g(\014le)f(via)h(the)g │ │ │ │ │ +Fo(DSTree)p 1851 624 29 4 v 33 w(writeToFile\(\))26 b │ │ │ │ │ +Fp(metho)s(d.)p eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ TeXDict begin 15 14 bop 0 866 a Fq(Index)0 1289 y Fo(DDsepInfo)p │ │ │ │ │ 438 1289 29 4 v 32 w(clearData\(\))p Fp(,)27 b(9)0 1402 │ │ │ │ │ y Fo(DDsepInfo)p 438 1402 V 32 w(free\(\))p Fp(,)i(10)0 │ │ │ │ │ 1515 y Fo(DDsepInfo)p 438 1515 V 32 w(new\(\))p Fp(,)g(9)0 │ │ │ │ │ 1628 y Fo(DDsepInfo)p 438 1628 V 32 w(setDefaultFields\(\))p │ │ │ │ │ Fp(,)d(9)0 1824 y Fo(GPart)p 246 1824 V 33 w(bndWeightsIV\(\))p │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -30,15 +30,15 @@ │ │ │ │ │ │ condensed into the source while the nodes in W \Y are condensed into the sink. The rest of │ │ │ │ │ │ the network is formed using the structure of the subgraph induced by Y. Given a min-cut of │ │ │ │ │ │ b │ │ │ │ │ │ the network we can identify a separator S ⊆ Y that has minimal weight. We examine two │ │ │ │ │ │ (possibly) different min-cuts and evaluate the partitions induced via their minimal weight │ │ │ │ │ │ separators, and accept a better partition if present. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 GPart : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 GPart : DRAFT January 7, 2024 │ │ │ │ │ │ This process we call DDSEP, which is short for Domain Decomposition SEParator, explained in more │ │ │ │ │ │ detail in [?] and [?]. │ │ │ │ │ │ 1.1 Data Structures │ │ │ │ │ │ The GPart structure has a pointer to a Graph object and other fields that contain information │ │ │ │ │ │ about the partition of the graph. │ │ │ │ │ │ The following fields are always active. │ │ │ │ │ │ • Graph *graph : pointer to the Graph object │ │ │ │ │ │ @@ -61,15 +61,15 @@ │ │ │ │ │ │ • GPart *sib : pointer to a sibling GPart object │ │ │ │ │ │ • IV vtxMapIV : an IV object of size nvtx + nvbnd, contains a map from the vertices of the │ │ │ │ │ │ graph to either the vertices of its parent or to the vertices of the root graph │ │ │ │ │ │ The DDsepInfo helper-object is used during the DDSEP recursive bisection process. It contains │ │ │ │ │ │ input parameters for the different stages of the DDSEP algorithm, and collects statistics about the │ │ │ │ │ │ CPUtime spent in each stage. │ │ │ │ │ │ • These parameters are used to generate the domain decomposition. │ │ │ │ │ │ - GPart : DRAFT February 8, 2025 3 │ │ │ │ │ │ + GPart : DRAFT January 7, 2024 3 │ │ │ │ │ │ – int minweight: minimum target weight for a domain │ │ │ │ │ │ – int maxweight: maximum target weight for a domain │ │ │ │ │ │ – double freeze: multiplier used to freeze vertices of high degree into the multisector. │ │ │ │ │ │ If the degree of v is more than freeze times the median degree, v is placed into the │ │ │ │ │ │ multisector. │ │ │ │ │ │ – int seed: random number seed │ │ │ │ │ │ – int DDoption: If 1, a new domain decomposition is constructed for each subgraph. If │ │ │ │ │ │ @@ -98,15 +98,15 @@ │ │ │ │ │ │ – int ntreeobj: number of tree objects in the tree, used to set gpart->id and used to │ │ │ │ │ │ initialize the DSTree object. │ │ │ │ │ │ – int msglvl : message level │ │ │ │ │ │ – FILE *msgFile : message file pointer │ │ │ │ │ │ 1.2 Prototypes and descriptions of GPart methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ GPart object. There are no IO methods. │ │ │ │ │ │ - 4 GPart : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 GPart : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. GPart * GPart_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the GPart structure and then sets the default fields │ │ │ │ │ │ by a call to GPart setDefaultFields(). │ │ │ │ │ │ 2. void GPart_setDefaultFields ( GPart *gpart ) ; │ │ │ │ │ │ @@ -132,15 +132,15 @@ │ │ │ │ │ │ compidsIV and cweightsIV IV objects are initialized. The remaining fields are not changed │ │ │ │ │ │ from their default values. │ │ │ │ │ │ Error checking: If gpart or g is NULL, or if g->nvtx ≤ 0, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 2. void GPart_setMessageInfo ( GPart *gpart, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method sets the msglvl and msgFile fields. │ │ │ │ │ │ Error checking: If gpart is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - GPart : DRAFT February 8, 2025 5 │ │ │ │ │ │ + GPart : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.2.3 Utility methods │ │ │ │ │ │ 1. void GPart_setCweights ( GPart *gpart ) ; │ │ │ │ │ │ This method sets the component weights vector cweightsIV. We assume that the compidsIV │ │ │ │ │ │ vector has been set prior to entering this method. The weight of a component is not simply │ │ │ │ │ │ the sum of the weights of the vertices with that component’s id. We accept the separator or │ │ │ │ │ │ multisector vertices (those v with compids[v] == 0) but then find the connected components │ │ │ │ │ │ of the remaining vertices, renumbering the compidsIV vector where necessary. Thus, ncomp │ │ │ │ │ │ @@ -171,15 +171,15 @@ │ │ │ │ │ │ This method determines whether the vertex v is adjacent to just one domain or not. We use │ │ │ │ │ │ this method to make a separator or multisector minimal. If the vertex is adjacent to only one │ │ │ │ │ │ domain, the return value is 1 and *pdomid is set to the domain’s id. If a vertex is adjacent │ │ │ │ │ │ to zero or two or more domains, the return value is zero. If a vertex belongs to a domain, it │ │ │ │ │ │ is considered adjacent to that domain. │ │ │ │ │ │ Error checking: If gpart, g or domid is NULL, or if v is out of range (i.e., v < 0 or nvtx ≤ v), │ │ │ │ │ │ an error message is printed and the program exits. │ │ │ │ │ │ - 6 GPart : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 GPart : DRAFT January 7, 2024 │ │ │ │ │ │ 6. IV * GPart_bndWeightsIV ( GPart *gpart ) ; │ │ │ │ │ │ This method returns an IV object that contains the weights of the vertices on the boundaries │ │ │ │ │ │ of the components. │ │ │ │ │ │ Error checking: If gpart or g is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.4 Domain decomposition methods │ │ │ │ │ │ There are presently two methods that create a domain decomposition of a graph or a subgraph. │ │ │ │ │ │ 1. void GPart_DDviaFishnet ( GPart *gpart, double frac, int minweight, │ │ │ │ │ │ @@ -209,15 +209,15 @@ │ │ │ │ │ │ double cpus[] ) ; │ │ │ │ │ │ This method takes a domain decomposition {Φ,Ω ,...,Ω } defined by the compidsIV vector │ │ │ │ │ │ 1 m │ │ │ │ │ │ and generates a two set partition [S,B,W]. We first compute the map from vertices to │ │ │ │ │ │ domains and segments (the segments partition the interface nodes Φ). We then construct the │ │ │ │ │ │ bipartite graph that represents the connectivity of the domains and segments. Each segment │ │ │ │ │ │ is an “edge” that connects two “adjacent” domains. This allows us to use a variant of the │ │ │ │ │ │ - GPart : DRAFT February 8, 2025 7 │ │ │ │ │ │ + GPart : DRAFT January 7, 2024 7 │ │ │ │ │ │ Kernighan-Lin algorithm to find an “edge” separator formed of segments, which is really a │ │ │ │ │ │ vertex separator, a subset of Φ. The alpha parameter is used in the cost function evaluation │ │ │ │ │ │ for the partition, cost([S,B,W]) = |S|1+αmax{|B|,|W|}. The seed parameter is used │ │ │ │ │ │ min{|B|,|W|} │ │ │ │ │ │ to randomize the algorithm. One can make several runswith different seeds and chose the best │ │ │ │ │ │ partition. The cpus[] array is used to store execution times for segments of the algorithm: │ │ │ │ │ │ cpus[0] stores the time to compute the domain/segment map; cpus[2] stores the time to │ │ │ │ │ │ @@ -253,15 +253,15 @@ │ │ │ │ │ │ 0 │ │ │ │ │ │ Y = {y∈Y | y∈Adj(B\Y) and y ∈/ Adj(W \Y)} │ │ │ │ │ │ 1 │ │ │ │ │ │ Y = {y∈Y | y∈/ Adj(B \Y) and y ∈ Adj(W \Y)} │ │ │ │ │ │ 2 │ │ │ │ │ │ Y = {y∈Y | y∈Adj(B\Y) and y ∈Adj(W \Y)} │ │ │ │ │ │ 3 │ │ │ │ │ │ - 8 GPart : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 GPart : DRAFT January 7, 2024 │ │ │ │ │ │ The YVmapIV object contains the list of vertices in the wide separator Y . The IV object that │ │ │ │ │ │ is returned, (called YCmapIV in the calling method) contains the subscripts of the Y , Y , Y │ │ │ │ │ │ 0 1 2 │ │ │ │ │ │ or Y sets that contains each vertex. │ │ │ │ │ │ 3 │ │ │ │ │ │ Error checking: If gpart, g or YVmapIV is NULL, or if nvtx ≤ 0, or if YVmapIV is empty, an │ │ │ │ │ │ error message is printed and the program exits. │ │ │ │ │ │ @@ -303,15 +303,15 @@ │ │ │ │ │ │ improves it (if possible). The methods returns the cost of a (possibly) new two-set partition │ │ │ │ │ │ b b c │ │ │ │ │ │ [S,B,W] defined by the compidsIV vector. The wide separator Y that is constructed is │ │ │ │ │ │ centered around S, i.e., Y includes all nodes in B and W that are nlayer distance or less │ │ │ │ │ │ from S. This method calls GPart smoothYSep(). │ │ │ │ │ │ Error checking: If gpart is NULL, or if nlevel < 0, or if alpha < 0.0, an error message is │ │ │ │ │ │ printed and the program exits. │ │ │ │ │ │ - GPart : DRAFT February 8, 2025 9 │ │ │ │ │ │ + GPart : DRAFT January 7, 2024 9 │ │ │ │ │ │ 1.2.7 Recursive Bisection method │ │ │ │ │ │ There is presently one method to construct the domain/separator tree. │ │ │ │ │ │ 1. DSTree * GPart_RBviaDDsep ( GPart *gpart, DDsepInfo *info ) ; │ │ │ │ │ │ This method performs a recursive bisection of the graph using the DDSEP algorithm and │ │ │ │ │ │ returns a DSTree object that represents the domain/separator tree and the map from vertices │ │ │ │ │ │ to domains and separators. The DDsepInfo structure contains all the parameters to the │ │ │ │ │ │ different steps of the DDSEP algorithm (the fishnet method to find the domain decomposition, │ │ │ │ │ │ @@ -341,15 +341,15 @@ │ │ │ │ │ │ info->DDoption = 1 ; info->msglvl = 0 ; │ │ │ │ │ │ info->nlayer = 3 ; info->msgFile = stdout ; │ │ │ │ │ │ Error checking: If info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. void DDsepInfo_clearData ( DDsepInfo *info ) ; │ │ │ │ │ │ This method checks to see whether info is NULL. DDsepInfo setDefaultFields() is called │ │ │ │ │ │ to set the default values. │ │ │ │ │ │ Error checking: If info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 10 GPart : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 GPart : DRAFT January 7, 2024 │ │ │ │ │ │ 4. void DDsepInfo_free ( DDsepInfo *info ) ; │ │ │ │ │ │ This method checks to see whether info is NULL. If so, an error message is printed and the │ │ │ │ │ │ program exits. Otherwise, it releases any storage by a call to DDsepInfo clearData() then │ │ │ │ │ │ free’s the storage for the structure with a call to free(). │ │ │ │ │ │ Error checking: If info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 5. void DDsepInfo_writeCpuTimes ( DDsepInfo *info, FILE *msgFile ) ; │ │ │ │ │ │ This method writes a breakdown of the CPU times in a meaningful format. Here is sample │ │ │ │ │ │ @@ -379,15 +379,15 @@ │ │ │ │ │ │ data. │ │ │ │ │ │ • TheinGraphFileparameteristheinputfilefortheGraphobject. It mustbeof theform │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The freeze parameter is used to place nodes of high degree into the multisector. If the │ │ │ │ │ │ external degree of a vertex is freeze times the average degree, then it is placed in the │ │ │ │ │ │ multisector. │ │ │ │ │ │ - GPart : DRAFT February 8, 2025 11 │ │ │ │ │ │ + GPart : DRAFT January 7, 2024 11 │ │ │ │ │ │ • The target minimum weight for a domain is minweight. │ │ │ │ │ │ • The target maximum weight for a domain is maxweight. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ • The outIVfile parameter is the output file for the IV object that contains the map │ │ │ │ │ │ from vertices to components. If outIVfile is "none", then there is no output, otherwise │ │ │ │ │ │ outIVfile must be of the form *.ivf or *.ivb. │ │ │ │ │ │ 2. testTwoSetViaBKL msglvl msgFile inGraphFile inIVfile │ │ │ │ │ │ @@ -417,15 +417,15 @@ │ │ │ │ │ │ problems. It reads in a Graph object and an IV object that holds the map from vertices to │ │ │ │ │ │ components (e.g., the output from the driver program testTwoSetViaBKL) from two files, │ │ │ │ │ │ smooths the separator and then optionally writes out the new component ids map to a file. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. │ │ │ │ │ │ • The msgFile parameter determines the output file — if msgFile is stdout, then the │ │ │ │ │ │ output file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ - 12 GPart : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 GPart : DRAFT January 7, 2024 │ │ │ │ │ │ • TheinGraphFileparameteristheinputfilefortheGraphobject. It mustbeof theform │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The inIVfile parameter is the input file for the IV object that contains the map from │ │ │ │ │ │ vertices to domains and multisector. It inIVfile must be of the form *.ivf or *.ivb. │ │ │ │ │ │ • The option parameter specifies the type of network optimization problem that will be │ │ │ │ │ │ solved. │ │ │ │ │ │ @@ -457,15 +457,15 @@ │ │ │ │ │ │ • The target maximum weight for a domain is maxweight. │ │ │ │ │ │ • The freeze parameter is used to place nodes of high degree into the multisector. If the │ │ │ │ │ │ external degree of a vertex is freeze times the average degree, then it is placed in the │ │ │ │ │ │ multisector. │ │ │ │ │ │ • The alpha parameter controls the partition evaluation function. │ │ │ │ │ │ • The maxdomweight parameter controls the recursive bisection — no subgraph with │ │ │ │ │ │ weight less than maxdomweight is further split. │ │ │ │ │ │ - GPart : DRAFT February 8, 2025 13 │ │ │ │ │ │ + GPart : DRAFT January 7, 2024 13 │ │ │ │ │ │ • The DDoption parameter controls the initial domain/segment partition on each sub- │ │ │ │ │ │ graph. When DDDoption = 1 we use the fishnet algorithm for each subgraph. When │ │ │ │ │ │ DDDoption = 1 we use the fishnet algorithm once for the entire graph and this is then │ │ │ │ │ │ projected down onto each subgraph. │ │ │ │ │ │ • The nlayer parameter governs the smoothing process by specifying the type of network │ │ │ │ │ │ optimization problem that will be solved. │ │ │ │ │ │ – nlayer = 1 — each network has two layers and is bipartite. │ │ │ │ │ │ @@ -496,15 +496,15 @@ │ │ │ │ │ │ DDDoption = 1 we use the fishnet algorithm once for the entire graph and this is then │ │ │ │ │ │ projected down onto each subgraph. │ │ │ │ │ │ • The nlayer parameter governs the smoothing process by specifying the type of network │ │ │ │ │ │ optimization problem that will be solved. │ │ │ │ │ │ – nlayer = 1 — each network has two layers and is bipartite. │ │ │ │ │ │ – nlayer = 2 — each network has two layers but need not be bipartite. │ │ │ │ │ │ – nlayer > 2 — each network has option/2 layers on each side of the separator. │ │ │ │ │ │ - 14 GPart : DRAFT February 8, 2025 │ │ │ │ │ │ + 14 GPart : DRAFT January 7, 2024 │ │ │ │ │ │ • The outDSTreeFile parameter is the output file for the DSTree object. It must be of │ │ │ │ │ │ the form *.dstreef or *.dstreeb. If outDSTreeFile is not "none", the DSTree object │ │ │ │ │ │ is written to the file via the DSTree writeToFile() method. │ │ │ │ │ │ Index │ │ │ │ │ │ DDsepInfo clearData(), 9 │ │ │ │ │ │ DDsepInfo free(), 10 │ │ │ │ │ │ DDsepInfo new(), 9 │ │ │ ├── ./usr/share/doc/spooles-doc/Graph.ps.gz │ │ │ │ ├── Graph.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Graph.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1203,21 +1203,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1401,88 +1400,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5636,20 +5630,20 @@ │ │ │ │ │ FFFE000FFFFFFC0007FFFFF80003FFFFF00000FFFFC000003FFF0000000FFC000022227B │ │ │ │ │ A72D>136 D E │ │ │ │ │ /Fc load 0 Fc currentfont 91.25 scalefont put/FMat X/FBB │ │ │ │ │ X/IEn X │ │ │ │ │ %EndDVIPSBitmapFont │ │ │ │ │ /Fd 134[71 2[71 75 52 53 55 1[75 67 75 112 2[41 37 75 │ │ │ │ │ 67 41 61 75 60 75 65 13[75 2[92 11[103 16[67 67 67 2[37 │ │ │ │ │ -46[{}27 119.552 /CMBX12 rf /Fe 134[48 3[51 2[36 12[40 │ │ │ │ │ -2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 │ │ │ │ │ -90.9091 /CMSL10 rf /Ff 141[39 1[39 7[39 6[39 10[39 9[39 │ │ │ │ │ -2[39 1[39 1[39 69[{}9 74.7198 /CMTT9 rf /Fg 135[41 1[41 │ │ │ │ │ -43 30 30 30 41 43 38 43 64 21 1[23 21 43 38 23 34 1[34 │ │ │ │ │ -43 38 12[55 37[21 1[21 44[{}24 74.7198 /CMR9 rf /Fh 206[30 │ │ │ │ │ +46[{}27 119.552 /CMBX12 rf /Fe 134[48 3[51 2[36 3[51 │ │ │ │ │ +12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 │ │ │ │ │ +/CMSL10 rf /Ff 141[39 1[39 7[39 6[39 10[39 9[39 2[39 │ │ │ │ │ +1[39 1[39 69[{}9 74.7198 /CMTT9 rf /Fg 135[41 1[41 43 │ │ │ │ │ +30 30 30 41 43 38 43 64 21 1[23 21 43 38 23 34 1[34 43 │ │ │ │ │ +38 12[55 37[21 1[21 44[{}24 74.7198 /CMR9 rf /Fh 206[30 │ │ │ │ │ 49[{}1 49.8132 /CMR6 rf /Fi 145[45 3[25 50[0 4[61 16[91 │ │ │ │ │ 6[71 4[71 71 17[71 25 1[{}10 90.9091 /CMSY10 rf /Fj 136[65 │ │ │ │ │ 44 52 30[53 2[56 3[69 7[71 1[67 6[71 1[71 25 28[54 30[{}12 │ │ │ │ │ 90.9091 /CMMI10 rf /Fk 137[55 58 41 4[52 58 23[79 1[73 │ │ │ │ │ 58 3[79 1[99 3[40 82 82 1[69 1[76 1[79 1[49 63[{}17 90.9091 │ │ │ │ │ /CMBX10 rf /Fl 134[44 3[49 30 37 38 1[46 46 51 74 23 │ │ │ │ │ 42 28 28 46 42 28 42 46 42 42 46 12[65 1[66 4[82 6[59 │ │ │ │ │ @@ -5765,34 +5759,34 @@ │ │ │ │ │ b(=)d Fj(w)r Fo(\()p Fk(u)p Fo(\))c Fi(\001)g Fj(w)r │ │ │ │ │ Fo(\()p Fk(v)q Fo(\))p 0 5322 1560 4 v 104 5375 a Fh(1)138 │ │ │ │ │ 5407 y Fg(The)26 b Ff(EGraph)h Fg(ob)t(ject)g(represen)n(ts)e(a)h │ │ │ │ │ (graph)g(of)h(the)e(matrix,)h(but)f(stores)h(a)g(list)h(of)f(co)n(v)n │ │ │ │ │ (ering)g(cliques)g(in)g(an)g Ff(IVL)g Fg(ob)t(ject.)1927 │ │ │ │ │ 5656 y Fo(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 0 399 a Fo(and)36 │ │ │ │ │ -b(it)i(is)f(the)g(smallest)h(graph)e(with)h(this)g(prop)s(ert)m(y)-8 │ │ │ │ │ -b(.)60 b(The)36 b(compression)h(is)g Fl(loss-less)p Fo(,)j(for)d(giv)m │ │ │ │ │ -(en)h Fk(G)p Fo(\()p Fk(V)q Fj(;)15 b Fk(E)p Fo(\))0 │ │ │ │ │ -511 y(and)30 b Fj(\036)p Fo(,)i(w)m(e)f(can)g(reconstruct)h(the)f(unit) │ │ │ │ │ -f(w)m(eigh)m(t)j(graph)d Fj(G)p Fo(\()p Fj(V)5 b(;)15 │ │ │ │ │ -b(E)5 b Fo(\).)44 b(In)31 b(e\013ect,)h(w)m(e)g(can)f(w)m(ork)g(with)g │ │ │ │ │ -(the)g(natural)0 624 y(compressed)j(graph)g(to)i(\014nd)d(separators)i │ │ │ │ │ -(and)f(orderings)g(and)g(map)h(bac)m(k)g(to)g(the)g(unit)f(w)m(eigh)m │ │ │ │ │ -(t)i(graph.)53 b(The)0 737 y(sa)m(vings)31 b(in)f(time)h(and)f(space)h │ │ │ │ │ -(can)g(b)s(e)e(considerable.)141 884 y(The)e Fn(Graph)e │ │ │ │ │ -Fo(ob)5 b(ject)28 b(has)e(a)i(metho)s(d)e(to)i(\014nd)d(the)i │ │ │ │ │ -Fj(\036)g Fo(map)g(for)f(the)i(natural)f(compressed)f(graph;)i(it)f │ │ │ │ │ -(requires)0 997 y Fj(O)s Fo(\()p Fi(j)p Fj(V)21 b Fi(j)p │ │ │ │ │ -Fo(\))37 b(space)g(and)f Fj(O)s Fo(\()p Fi(j)p Fj(E)5 │ │ │ │ │ -b Fi(j)p Fo(\))38 b(time.)61 b(There)36 b(is)h(a)g(metho)s(d)f(to)h │ │ │ │ │ -(compress)g(a)g(graph)f(\(i.e.,)k(giv)m(en)e Fj(G)p Fo(\()p │ │ │ │ │ -Fj(V)5 b(;)15 b(E)5 b Fo(\))39 b(and)0 1110 y(an)32 b(arbitrary)h │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 0 399 a Fo(and)36 b(it)i(is)f(the)g(smallest)h(graph)e │ │ │ │ │ +(with)h(this)g(prop)s(ert)m(y)-8 b(.)60 b(The)36 b(compression)h(is)g │ │ │ │ │ +Fl(loss-less)p Fo(,)j(for)d(giv)m(en)h Fk(G)p Fo(\()p │ │ │ │ │ +Fk(V)q Fj(;)15 b Fk(E)p Fo(\))0 511 y(and)30 b Fj(\036)p │ │ │ │ │ +Fo(,)i(w)m(e)f(can)g(reconstruct)h(the)f(unit)f(w)m(eigh)m(t)j(graph)d │ │ │ │ │ +Fj(G)p Fo(\()p Fj(V)5 b(;)15 b(E)5 b Fo(\).)44 b(In)31 │ │ │ │ │ +b(e\013ect,)h(w)m(e)g(can)f(w)m(ork)g(with)g(the)g(natural)0 │ │ │ │ │ +624 y(compressed)j(graph)g(to)i(\014nd)d(separators)i(and)f(orderings)g │ │ │ │ │ +(and)g(map)h(bac)m(k)g(to)g(the)g(unit)f(w)m(eigh)m(t)i(graph.)53 │ │ │ │ │ +b(The)0 737 y(sa)m(vings)31 b(in)f(time)h(and)f(space)h(can)g(b)s(e)e │ │ │ │ │ +(considerable.)141 884 y(The)e Fn(Graph)e Fo(ob)5 b(ject)28 │ │ │ │ │ +b(has)e(a)i(metho)s(d)e(to)i(\014nd)d(the)i Fj(\036)g │ │ │ │ │ +Fo(map)g(for)f(the)i(natural)f(compressed)f(graph;)i(it)f(requires)0 │ │ │ │ │ +997 y Fj(O)s Fo(\()p Fi(j)p Fj(V)21 b Fi(j)p Fo(\))37 │ │ │ │ │ +b(space)g(and)f Fj(O)s Fo(\()p Fi(j)p Fj(E)5 b Fi(j)p │ │ │ │ │ +Fo(\))38 b(time.)61 b(There)36 b(is)h(a)g(metho)s(d)f(to)h(compress)g │ │ │ │ │ +(a)g(graph)f(\(i.e.,)k(giv)m(en)e Fj(G)p Fo(\()p Fj(V)5 │ │ │ │ │ +b(;)15 b(E)5 b Fo(\))39 b(and)0 1110 y(an)32 b(arbitrary)h │ │ │ │ │ Fj(\036)p Fo(,)g(construct)g Fk(G)p Fo(\()p Fk(V)q Fj(;)15 │ │ │ │ │ b Fk(E)p Fo(\)\))34 b(and)e(a)h(metho)s(d)f(to)h(expand)f(a)h(graph)f │ │ │ │ │ (\(i.e.,)j(giv)m(en)e Fk(G)p Fo(\()p Fk(V)q Fj(;)15 b │ │ │ │ │ Fk(E)p Fo(\))34 b(and)e(an)0 1223 y(arbitrary)e Fj(\036)p │ │ │ │ │ Fo(,)h(construct)g Fj(G)p Fo(\()p Fj(V)5 b(;)15 b(E)5 │ │ │ │ │ b Fo(\)\).)141 1369 y(There)28 b(are)h(sev)m(eral)h(utilit)m(y)g(metho) │ │ │ │ │ s(ds)d(to)j(return)d(information)i(ab)s(out)f(the)h(memory)f(in)g(use)g │ │ │ │ │ @@ -5831,17 +5825,17 @@ │ │ │ │ │ (non-)p Fn(NULL)e Fo(if)h Fn(type)46 b(/)i(2)f(==)g(1)0 │ │ │ │ │ 5049 y Fd(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g │ │ │ │ │ Fb(Graph)e Fd(metho)t(ds)0 5294 y Fo(This)e(section)j(con)m(tains)f │ │ │ │ │ (brief)f(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h │ │ │ │ │ (metho)s(ds)f(that)h(b)s(elong)f(to)h(the)0 5407 y Fn(Graph)29 │ │ │ │ │ b Fo(ob)5 b(ject.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1110 4 v 1291 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)41 b Fl(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fo(3)0 399 y Fa(1.2.1)112 b(Basic)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1129 4 v 1310 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)41 b Fl(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fo(3)0 399 y Fa(1.2.1)112 b(Basic)38 │ │ │ │ │ b(metho)s(ds)0 605 y Fo(As)d(usual,)h(there)f(are)g(four)f(basic)h │ │ │ │ │ (metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e │ │ │ │ │ (default)f(\014elds,)h(clearing)0 718 y(an)m(y)31 b(allo)s(cated)h │ │ │ │ │ (data,)f(and)f(free'ing)h(the)g(ob)5 b(ject.)111 982 │ │ │ │ │ y(1.)46 b Fn(Graph)h(*)g(Graph_new)e(\()j(void)e(\))i(;)227 │ │ │ │ │ 1143 y Fo(This)28 b(metho)s(d)g(simply)h(allo)s(cates)i(storage)f(for)e │ │ │ │ │ (the)h Fn(Graph)f Fo(structure)g(and)g(then)g(sets)i(the)f(default)f │ │ │ │ │ @@ -5908,27 +5902,26 @@ │ │ │ │ │ b(or)c Fn(adjType)d Fo(of)i Fn(ewghtType)e Fo(is)i(in)m(v)-5 │ │ │ │ │ b(alid)42 b(\(they)f(m)m(ust)h(b)s(e)227 5407 y Fn(IVL)p │ │ │ │ │ 377 5407 V 34 w(CHUNKED)p Fo(,)27 b Fn(IVL)p 943 5407 │ │ │ │ │ V 33 w(SOLO)h Fo(or)g Fn(IVL)p 1449 5407 V 34 w(UNKNOWN)p │ │ │ │ │ Fo(\).)f(an)i(error)f(message)i(is)e(prin)m(ted)h(and)f(the)g(program)h │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 111 399 a Fo(2.)46 │ │ │ │ │ -b Fn(void)h(Graph_init2)e(\()i(Graph)f(*graph,)g(int)h(type,)g(int)f │ │ │ │ │ -(nvtx,)h(int)g(nvbnd,)f(int)h(nedges,)466 511 y(int)g(totvwght,)e(int)i │ │ │ │ │ -(totewght,)e(IVL)i(*adjIVL,)f(int)h(*vwghts,)e(IVL)i(*ewghtIVL\))227 │ │ │ │ │ -665 y Fo(This)41 b(metho)s(d)f(is)h(used)f(b)m(y)h(the)h(IO)e(read)h │ │ │ │ │ -(metho)s(ds.)72 b(When)41 b(a)h Fn(Graph)d Fo(ob)5 b(ject)42 │ │ │ │ │ -b(is)g(read)f(from)f(a)i(\014le,)227 778 y(the)35 b Fn(IVL)e │ │ │ │ │ -Fo(ob)5 b(ject\(s\))35 b(m)m(ust)f(b)s(e)g(initialized)i(and)d(then)h │ │ │ │ │ -(read)g(in)g(from)f(the)i(\014le.)52 b(Therefore,)35 │ │ │ │ │ -b(w)m(e)f(need)g(an)227 891 y(initialization)d(metho)s(d)26 │ │ │ │ │ -b(that)i(allo)m(ws)h(us)e(to)h(set)g(p)s(oin)m(ters)f(to)h(the)g │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 111 399 a Fo(2.)46 b Fn(void)h(Graph_init2)e(\()i(Graph)f │ │ │ │ │ +(*graph,)g(int)h(type,)g(int)f(nvtx,)h(int)g(nvbnd,)f(int)h(nedges,)466 │ │ │ │ │ +511 y(int)g(totvwght,)e(int)i(totewght,)e(IVL)i(*adjIVL,)f(int)h │ │ │ │ │ +(*vwghts,)e(IVL)i(*ewghtIVL\))227 665 y Fo(This)41 b(metho)s(d)f(is)h │ │ │ │ │ +(used)f(b)m(y)h(the)h(IO)e(read)h(metho)s(ds.)72 b(When)41 │ │ │ │ │ +b(a)h Fn(Graph)d Fo(ob)5 b(ject)42 b(is)g(read)f(from)f(a)i(\014le,)227 │ │ │ │ │ +778 y(the)35 b Fn(IVL)e Fo(ob)5 b(ject\(s\))35 b(m)m(ust)f(b)s(e)g │ │ │ │ │ +(initialized)i(and)d(then)h(read)g(in)g(from)f(the)i(\014le.)52 │ │ │ │ │ +b(Therefore,)35 b(w)m(e)f(need)g(an)227 891 y(initialization)d(metho)s │ │ │ │ │ +(d)26 b(that)i(allo)m(ws)h(us)e(to)h(set)g(p)s(oin)m(ters)f(to)h(the)g │ │ │ │ │ Fn(IVL)e Fo(ob)5 b(jects)28 b(and)f(the)g Fn(vwghts)f │ │ │ │ │ Fo(v)m(ector.)227 1004 y(Note,)32 b Fn(adjIVL)p Fo(,)c │ │ │ │ │ Fn(vwghts)g Fo(and)h Fn(ewghtIVL)f Fo(are)i(o)m(wned)g(b)m(y)g(the)g │ │ │ │ │ Fn(Graph)e Fo(ob)5 b(ject)31 b(and)e(will)h(b)s(e)f(free'd)h(when)227 │ │ │ │ │ 1117 y(the)h Fn(Graph)e Fo(ob)5 b(ject)31 b(is)f(free'd.)227 │ │ │ │ │ 1270 y Fl(Err)-5 b(or)38 b(che)-5 b(cking:)47 b Fo(If)33 │ │ │ │ │ b Fn(graph)g Fo(or)g Fn(adjIVL)g Fo(is)h Fn(NULL)p Fo(,)e │ │ │ │ │ @@ -5999,17 +5992,17 @@ │ │ │ │ │ b(alence)27 b(map)e(from)h(the)g(graph)f(to)i(its)f(natural)g │ │ │ │ │ (compressed)f(graph.)227 5294 y(The)33 b(map)f Fj(\036)e │ │ │ │ │ Fo(:)g Fj(V)49 b Fi(7!)30 b Fk(V)k Fo(is)f(then)g(constructed)g(\(see)h │ │ │ │ │ (the)f(In)m(tro)s(duction)g(in)f(this)h(section\))h(and)f(put)f(in)m │ │ │ │ │ (to)227 5407 y(an)f Fn(IV)e Fo(ob)5 b(ject)32 b(that)f(is)f(then)g │ │ │ │ │ (returned.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1110 4 v 1291 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)41 b Fl(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fo(5)227 399 y Fl(Err)-5 b(or)33 b(che)-5 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1129 4 v 1310 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)41 b Fl(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fo(5)227 399 y Fl(Err)-5 b(or)33 b(che)-5 │ │ │ │ │ b(cking:)40 b Fo(If)28 b Fn(graph)g Fo(is)h Fn(NULL)f │ │ │ │ │ Fo(or)h Fn(nvtx)47 b(<=)g(0)p Fo(,)29 b(an)g(error)g(message)h(is)f │ │ │ │ │ (prin)m(ted)f(and)h(the)g(program)227 511 y(exits.)111 │ │ │ │ │ 726 y(2.)46 b Fn(Graph)h(*)g(Graph_compress)92 b(\()47 │ │ │ │ │ b(Graph)g(*graph,)e(int)i(map[],)f(int)h(coarseType)e(\))j(;)227 │ │ │ │ │ 839 y(Graph)f(*)g(Graph_compress2)d(\()j(Graph)g(*graph,)e(IV)j │ │ │ │ │ (*mapIV,)d(int)i(coarseType)e(\))j(;)227 1003 y Fo(This)c │ │ │ │ │ @@ -6069,31 +6062,31 @@ │ │ │ │ │ 5130 y Fo(This)30 b(metho)s(d)g(returns)f(the)h(w)m(eigh)m(t)i(of)f │ │ │ │ │ (adj\()p Fn(v)p Fo(\).)227 5294 y Fl(Err)-5 b(or)39 b(che)-5 │ │ │ │ │ b(cking:)50 b Fo(If)35 b Fn(graph)f Fo(is)i Fn(NULL)p │ │ │ │ │ Fo(,)e(or)i Fn(v)f Fo(is)h(out)f(of)h(range,)h(an)f(error)f(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)g(the)227 5407 y(program)30 b(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 111 399 a Fo(3.)46 │ │ │ │ │ -b Fn(int)h(Graph_adjAndSize)d(\()j(Graph)f(*graph,)g(int)h(u,)g(int)g │ │ │ │ │ -(*pusize,)f(int)h(**puadj\))e(;)227 545 y Fo(This)31 │ │ │ │ │ -b(metho)s(d)f(\014lls)h Fn(*pusize)f Fo(with)h(the)g(size)h(of)f(the)h │ │ │ │ │ -(adjacency)g(list)g(for)f Fn(u)g Fo(and)f Fn(*puadj)g │ │ │ │ │ -Fo(p)s(oin)m(ts)h(to)h(the)227 658 y(start)f(of)g(the)f(list)h(v)m │ │ │ │ │ -(ector.)227 804 y Fl(Err)-5 b(or)32 b(che)-5 b(cking:)40 │ │ │ │ │ -b Fo(If)28 b Fn(graph)f Fo(is)h Fn(NULL)p Fo(,)f(or)i(if)f │ │ │ │ │ -Fn(u)48 b(<)f(0)28 b Fo(or)h Fn(u)47 b(>=)g(nvtx)27 b │ │ │ │ │ -Fo(or)i(if)f Fn(pusize)f Fo(or)h Fn(puadj)f Fo(is)i Fn(NULL)p │ │ │ │ │ -Fo(,)e(an)227 917 y(error)j(message)i(is)e(prin)m(ted)g(and)g(the)g │ │ │ │ │ -(program)h(exits.)111 1098 y(4.)46 b Fn(int)h(Graph_adjAndEweights)42 │ │ │ │ │ -b(\()48 b(Graph)e(*graph,)g(int)h(u,)g(int)g(*pusize,)1516 │ │ │ │ │ -1210 y(int)g(**puadj,)e(int)i(**puewghts\))e(;)227 1357 │ │ │ │ │ -y Fo(This)27 b(metho)s(d)g(\014lls)g Fn(*psize)f Fo(with)i(the)f(size)i │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 111 399 a Fo(3.)46 b Fn(int)h(Graph_adjAndSize)d(\()j │ │ │ │ │ +(Graph)f(*graph,)g(int)h(u,)g(int)g(*pusize,)f(int)h(**puadj\))e(;)227 │ │ │ │ │ +545 y Fo(This)31 b(metho)s(d)f(\014lls)h Fn(*pusize)f │ │ │ │ │ +Fo(with)h(the)g(size)h(of)f(the)h(adjacency)g(list)g(for)f │ │ │ │ │ +Fn(u)g Fo(and)f Fn(*puadj)g Fo(p)s(oin)m(ts)h(to)h(the)227 │ │ │ │ │ +658 y(start)f(of)g(the)f(list)h(v)m(ector.)227 804 y │ │ │ │ │ +Fl(Err)-5 b(or)32 b(che)-5 b(cking:)40 b Fo(If)28 b Fn(graph)f │ │ │ │ │ +Fo(is)h Fn(NULL)p Fo(,)f(or)i(if)f Fn(u)48 b(<)f(0)28 │ │ │ │ │ +b Fo(or)h Fn(u)47 b(>=)g(nvtx)27 b Fo(or)i(if)f Fn(pusize)f │ │ │ │ │ +Fo(or)h Fn(puadj)f Fo(is)i Fn(NULL)p Fo(,)e(an)227 917 │ │ │ │ │ +y(error)j(message)i(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)111 │ │ │ │ │ +1098 y(4.)46 b Fn(int)h(Graph_adjAndEweights)42 b(\()48 │ │ │ │ │ +b(Graph)e(*graph,)g(int)h(u,)g(int)g(*pusize,)1516 1210 │ │ │ │ │ +y(int)g(**puadj,)e(int)i(**puewghts\))e(;)227 1357 y │ │ │ │ │ +Fo(This)27 b(metho)s(d)g(\014lls)g Fn(*psize)f Fo(with)i(the)f(size)i │ │ │ │ │ (of)e(the)h(adjacency)h(list,)g Fn(*puadj)c Fo(p)s(oin)m(ts)j(to)g(the) │ │ │ │ │ g(start)g(of)g(the)227 1470 y(list)j(v)m(ector)h(and)e │ │ │ │ │ Fn(*puewghts)e Fo(p)s(oin)m(ts)i(to)h(the)g(start)g(of)f(the)h(edge)g │ │ │ │ │ (w)m(eigh)m(ts)h(v)m(ector.)227 1616 y Fl(Err)-5 b(or)34 │ │ │ │ │ b(che)-5 b(cking:)40 b Fo(If)29 b Fn(graph)g Fo(is)g │ │ │ │ │ Fn(NULL)p Fo(,)g(or)h(if)g Fn(u)48 b(<)f(0)30 b Fo(or)f │ │ │ │ │ Fn(u)48 b(>=)f(nvtx)29 b Fo(or)h(if)f Fn(pusize)p Fo(,)g │ │ │ │ │ @@ -6165,17 +6158,17 @@ │ │ │ │ │ Fn(map[])f Fo(v)m(ector.)42 b(This)28 b(renders)g(the)i(graph)e(ob)5 │ │ │ │ │ b(ject)30 b(in)m(v)-5 b(alid.)227 5294 y(The)38 b(graph)g(partitioning) │ │ │ │ │ h(metho)s(ds)e(map)h(the)h(v)m(ertices)g(bac)m(k)g(to)g(their)g │ │ │ │ │ (original)g(v)-5 b(alues.)65 b(Presen)m(tly)-8 b(,)227 │ │ │ │ │ 5407 y(only)31 b(graphs)e(with)i(unit)e(edge)j(w)m(eigh)m(ts)f(are)g │ │ │ │ │ (allo)m(w)m(ed)h(as)f(input.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1110 4 v 1291 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)41 b Fl(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fo(7)227 399 y Fl(Err)-5 b(or)32 b(che)-5 │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1129 4 v 1310 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)41 b Fl(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fo(7)227 399 y Fl(Err)-5 b(or)32 b(che)-5 │ │ │ │ │ b(cking:)39 b Fo(If)28 b Fn(graph)f Fo(is)h Fn(NULL)f │ │ │ │ │ Fo(or)h Fn(icomp)46 b(<)i(0)27 b Fo(or)i Fn(compids)d │ │ │ │ │ Fo(or)i Fn(pmap)f Fo(is)h Fn(NULL)p Fo(,)f(an)h(error)g(message)227 │ │ │ │ │ 511 y(is)j(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ 691 y(8.)46 b Fn(int)h(Graph_isSymmetric)c(\()48 b(Graph)e(*graph)g(\)) │ │ │ │ │ i(;)227 837 y Fo(This)36 b(metho)s(d)g(returns)f Fn(1)i │ │ │ │ │ Fo(if)f(the)h(graph)f(is)h(symmetric)f(\(i.e.,)k(edge)d │ │ │ │ │ @@ -6257,34 +6250,33 @@ │ │ │ │ │ b Fn(1)f Fo(is)g(returned.)40 b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m │ │ │ │ │ (tered)h(from)f Fn(fprintf)p Fo(,)f(zero)i(is)f(returned.)227 │ │ │ │ │ 5407 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ b Fn(graph)f Fo(or)i Fn(fp)e Fo(are)i Fn(NULL)e Fo(an)i(error)f │ │ │ │ │ (message)h(is)g(prin)m(ted)e(and)h(zero)h(is)g(returned.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1110 4 v │ │ │ │ │ -1292 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2790 100 V 111 399 a Fo(6.)46 │ │ │ │ │ -b Fn(int)h(Graph_writeToBinaryFile)42 b(\()47 b(Graph)f(*graph,)g(FILE) │ │ │ │ │ -h(*fp)g(\))g(;)227 554 y Fo(This)27 b(metho)s(d)g(writes)h(a)g │ │ │ │ │ -Fn(Graph)e Fo(ob)5 b(ject)29 b(to)f(a)g(binary)f(\014le.)40 │ │ │ │ │ -b(If)27 b(there)h(are)g(no)g(errors)f(in)g(writing)h(the)g(data,)227 │ │ │ │ │ -667 y(the)j(v)-5 b(alue)31 b Fn(1)f Fo(is)g(returned.)40 │ │ │ │ │ -b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ -Fn(fwrite)p Fo(,)f(zero)i(is)f(returned.)227 822 y Fl(Err)-5 │ │ │ │ │ -b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b Fn(graph)f │ │ │ │ │ -Fo(or)i Fn(fp)e Fo(are)i Fn(NULL)e Fo(an)i(error)f(message)h(is)g(prin) │ │ │ │ │ -m(ted)e(and)h(zero)h(is)g(returned.)111 1020 y(7.)46 │ │ │ │ │ -b Fn(int)h(Graph_writeForHumanEye)42 b(\()47 b(Graph)g(*graph,)f(FILE)g │ │ │ │ │ -(*fp)h(\))h(;)227 1175 y Fo(This)c(metho)s(d)h(writes)g(a)g │ │ │ │ │ -Fn(Graph)f Fo(ob)5 b(ject)46 b(to)f(a)h(\014le)f(in)f(a)i(h)m(uman)e │ │ │ │ │ -(readable)h(format.)85 b(The)44 b(metho)s(d)227 1288 │ │ │ │ │ -y Fn(Graph)p 473 1288 29 4 v 33 w(writeStats\(\))23 b │ │ │ │ │ -Fo(is)j(called)i(to)f(write)f(out)h(the)f(header)g(and)g(statistics.)41 │ │ │ │ │ -b(The)26 b(v)-5 b(alue)27 b Fn(1)f Fo(is)g(returned.)227 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1129 4 v │ │ │ │ │ +1311 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(Jan)m(uary)f(7,)h(2024) │ │ │ │ │ +p 2771 100 V 111 399 a Fo(6.)46 b Fn(int)h(Graph_writeToBinaryFile)42 │ │ │ │ │ +b(\()47 b(Graph)f(*graph,)g(FILE)h(*fp)g(\))g(;)227 554 │ │ │ │ │ +y Fo(This)27 b(metho)s(d)g(writes)h(a)g Fn(Graph)e Fo(ob)5 │ │ │ │ │ +b(ject)29 b(to)f(a)g(binary)f(\014le.)40 b(If)27 b(there)h(are)g(no)g │ │ │ │ │ +(errors)f(in)g(writing)h(the)g(data,)227 667 y(the)j(v)-5 │ │ │ │ │ +b(alue)31 b Fn(1)f Fo(is)g(returned.)40 b(If)30 b(an)g(IO)g(error)g(is) │ │ │ │ │ +g(encoun)m(tered)h(from)f Fn(fwrite)p Fo(,)f(zero)i(is)f(returned.)227 │ │ │ │ │ +822 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ +b Fn(graph)f Fo(or)i Fn(fp)e Fo(are)i Fn(NULL)e Fo(an)i(error)f │ │ │ │ │ +(message)h(is)g(prin)m(ted)e(and)h(zero)h(is)g(returned.)111 │ │ │ │ │ +1020 y(7.)46 b Fn(int)h(Graph_writeForHumanEye)42 b(\()47 │ │ │ │ │ +b(Graph)g(*graph,)f(FILE)g(*fp)h(\))h(;)227 1175 y Fo(This)c(metho)s(d) │ │ │ │ │ +h(writes)g(a)g Fn(Graph)f Fo(ob)5 b(ject)46 b(to)f(a)h(\014le)f(in)f(a) │ │ │ │ │ +i(h)m(uman)e(readable)h(format.)85 b(The)44 b(metho)s(d)227 │ │ │ │ │ +1288 y Fn(Graph)p 473 1288 29 4 v 33 w(writeStats\(\))23 │ │ │ │ │ +b Fo(is)j(called)i(to)f(write)f(out)h(the)f(header)g(and)g(statistics.) │ │ │ │ │ +41 b(The)26 b(v)-5 b(alue)27 b Fn(1)f Fo(is)g(returned.)227 │ │ │ │ │ 1444 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ b Fn(graph)f Fo(or)i Fn(fp)e Fo(are)i Fn(NULL)e Fo(an)i(error)f │ │ │ │ │ (message)h(is)g(prin)m(ted)e(and)h(zero)h(is)g(returned.)111 │ │ │ │ │ 1641 y(8.)46 b Fn(int)h(Graph_writeStats)d(\()j(Graph)f(*graph,)g(FILE) │ │ │ │ │ h(*fp)g(\))g(;)227 1797 y Fo(The)30 b(header)g(and)g(statistics)i(are)f │ │ │ │ │ (written)g(to)g(a)f(\014le.)41 b(The)30 b(v)-5 b(alue)31 │ │ │ │ │ b Fn(1)f Fo(is)g(returned.)227 1952 y Fl(Err)-5 b(or)34 │ │ │ │ │ @@ -6331,17 +6323,17 @@ │ │ │ │ │ b(alence)37 b(map)f(to)227 5181 y(its)g(natural)g(compressed)f(graph)g │ │ │ │ │ (\(the)i(\014rst)d(graph)h(need)h(not)g(b)s(e)f(unit)g(w)m(eigh)m(t\),) │ │ │ │ │ k(and)c(constructs)h(the)227 5294 y(natural)24 b(compressed)f(graph.)38 │ │ │ │ │ b(The)23 b(equiv)-5 b(alence)25 b(map)e(and)g(compressed)g(graph)g(are) │ │ │ │ │ h(optionally)h(written)227 5407 y(out)31 b(to)g(\014les.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1110 4 v 1291 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)41 b Fl(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2743 100 V 1110 w Fo(9)337 399 y Fc(\210)45 b Fo(The)28 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1129 4 v 1310 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)41 b Fl(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2724 100 V 1129 w Fo(9)337 399 y Fc(\210)45 b Fo(The)28 │ │ │ │ │ b Fn(msglvl)f Fo(parameter)i(determines)g(the)g(amoun)m(t)g(of)f │ │ │ │ │ (output)h(|)f(taking)i Fn(msglvl)46 b(>=)h(3)28 b Fo(means)427 │ │ │ │ │ 511 y(that)j(all)h(ob)5 b(jects)31 b(are)f(written)h(to)g(the)f │ │ │ │ │ (message)i(\014le.)337 660 y Fc(\210)45 b Fo(The)33 b │ │ │ │ │ Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ (if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the)427 │ │ │ │ │ 773 y(message)27 b(\014le)f(is)g Fl(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ @@ -6424,51 +6416,50 @@ │ │ │ │ │ g(graph)f(to)i(a)f(formatted)h(\014le)f(\(if)427 5101 │ │ │ │ │ y Fn(outGraphFile)24 b Fo(is)j(of)h(the)f(form)g Fn(*.graphf)p │ │ │ │ │ Fo(\),)f(or)h(a)h(binary)f(\014le)g(\(if)g Fn(outGraphFile)d │ │ │ │ │ Fo(is)k(of)f(the)g(form)427 5214 y Fn(*.graphb)p Fo(\).)111 │ │ │ │ │ 5407 y(4.)46 b Fn(mkGridGraph)f(msglvl)h(msgFile)g(stencil)g(n1)h(n2)g │ │ │ │ │ (n3)g(outFile)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1087 4 │ │ │ │ │ -v 1270 w Fn(Graph)28 b Fe(:)41 b Fl(DRAFT)30 b Fe(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 227 399 a Fo(This)d(driv)m(er)h │ │ │ │ │ -(program)g(creates)h(a)f(Graph)g(ob)5 b(ject)29 b(for)g(a)g(\014nite)g │ │ │ │ │ -(di\013erence)h(op)s(erator)f(on)g(a)g Fn(n1)17 b Fi(\002)g │ │ │ │ │ -Fn(n2)g Fi(\002)g Fn(n3)227 511 y Fo(regular)31 b(grid.)337 │ │ │ │ │ -707 y Fc(\210)45 b Fo(The)28 b Fn(msglvl)f Fo(parameter)i(determines)g │ │ │ │ │ -(the)g(amoun)m(t)g(of)f(output)h(|)f(taking)i Fn(msglvl)46 │ │ │ │ │ -b(>=)h(3)28 b Fo(means)427 820 y(that)j(all)h(ob)5 b(jects)31 │ │ │ │ │ -b(are)f(written)h(to)g(the)f(message)i(\014le.)337 969 │ │ │ │ │ -y Fc(\210)45 b Fo(The)33 b Fn(msgFile)e Fo(parameter)j(determines)f │ │ │ │ │ -(the)h(message)g(\014le)f(|)h(if)f Fn(msgFile)e Fo(is)i │ │ │ │ │ -Fn(stdout)p Fo(,)g(then)g(the)427 1082 y(message)27 b(\014le)f(is)g │ │ │ │ │ -Fl(stdout)p Fo(,)i(otherwise)e(a)h(\014le)f(is)f(op)s(ened)g(with)h │ │ │ │ │ -Fl(app)-5 b(end)28 b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 │ │ │ │ │ -1195 y(data.)337 1345 y Fc(\210)45 b Fo(V)-8 b(alid)35 │ │ │ │ │ -b Fn(stencil)d Fo(v)-5 b(alues)34 b(are)g Fn(5)f Fo(for)g(a)h(2-D)h │ │ │ │ │ -(5-p)s(oin)m(t)f(op)s(erator,)h Fn(7)f Fo(for)f(a)h(3-D)h(7-p)s(oin)m │ │ │ │ │ -(t)f(op)s(erator,)h Fn(9)427 1458 y Fo(for)i(a)h(2-D)h(9-p)s(oin)m(t)f │ │ │ │ │ -(op)s(erator,)i Fn(13)d Fo(for)g(a)h(2-D)g(13-p)s(oin)m(t)h(op)s │ │ │ │ │ -(erator)f(and)e Fn(27)h Fo(for)g(a)h(3-D)h(27-p)s(oin)m(t)427 │ │ │ │ │ -1571 y(op)s(erator.)337 1721 y Fc(\210)45 b Fn(n1)30 │ │ │ │ │ -b Fo(is)g(the)h(n)m(um)m(b)s(er)e(of)i(p)s(oin)m(ts)f(in)g(the)g │ │ │ │ │ -(\014rst)g(direction.)337 1871 y Fc(\210)45 b Fn(n2)30 │ │ │ │ │ -b Fo(is)g(the)h(n)m(um)m(b)s(er)e(of)i(p)s(oin)m(ts)f(in)g(the)g │ │ │ │ │ -(second)h(direction.)337 2021 y Fc(\210)45 b Fn(n3)30 │ │ │ │ │ -b Fo(is)g(the)h(n)m(um)m(b)s(er)e(of)i(p)s(oin)m(ts)f(in)g(the)g(third) │ │ │ │ │ -g(direction,)h(ignored)g(for)f Fn(stencil)e Fo(=)i Fn(5)p │ │ │ │ │ -Fo(,)h Fn(9)f Fo(and)f Fn(13)p Fo(.)337 2171 y Fc(\210)45 │ │ │ │ │ -b Fo(The)g Fn(Graph)g Fo(ob)5 b(ject)46 b(is)g(written)f(to)i(\014le)e │ │ │ │ │ -Fn(outFile)p Fo(.)85 b(It)45 b(m)m(ust)h(b)s(e)f(of)h(the)f(form)h │ │ │ │ │ -Fn(*.graphf)d Fo(or)427 2283 y Fn(*.graphb)p Fo(.)36 │ │ │ │ │ -b(The)23 b Fn(Graph)e Fo(ob)5 b(ject)24 b(is)f(written)g(to)g(the)g │ │ │ │ │ -(\014le)g(via)h(the)f Fn(Graph)p 2904 2283 29 4 v 33 │ │ │ │ │ -w(writeToFile\(\))c Fo(metho)s(d.)111 2479 y(5.)46 b │ │ │ │ │ -Fn(testIO)g(msglvl)g(msgFile)g(inFile)g(outFile)227 2633 │ │ │ │ │ -y Fo(This)21 b(driv)m(er)g(program)h(reads)f(in)g(a)h │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1106 4 │ │ │ │ │ +v 1289 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)30 b Fe(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 227 399 a Fo(This)d(driv)m(er)h(program)g(creates)h │ │ │ │ │ +(a)f(Graph)g(ob)5 b(ject)29 b(for)g(a)g(\014nite)g(di\013erence)h(op)s │ │ │ │ │ +(erator)f(on)g(a)g Fn(n1)17 b Fi(\002)g Fn(n2)g Fi(\002)g │ │ │ │ │ +Fn(n3)227 511 y Fo(regular)31 b(grid.)337 707 y Fc(\210)45 │ │ │ │ │ +b Fo(The)28 b Fn(msglvl)f Fo(parameter)i(determines)g(the)g(amoun)m(t)g │ │ │ │ │ +(of)f(output)h(|)f(taking)i Fn(msglvl)46 b(>=)h(3)28 │ │ │ │ │ +b Fo(means)427 820 y(that)j(all)h(ob)5 b(jects)31 b(are)f(written)h(to) │ │ │ │ │ +g(the)f(message)i(\014le.)337 969 y Fc(\210)45 b Fo(The)33 │ │ │ │ │ +b Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ +(if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the)427 │ │ │ │ │ +1082 y(message)27 b(\014le)f(is)g Fl(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ +(\014le)f(is)f(op)s(ened)g(with)h Fl(app)-5 b(end)28 │ │ │ │ │ +b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 1195 │ │ │ │ │ +y(data.)337 1345 y Fc(\210)45 b Fo(V)-8 b(alid)35 b Fn(stencil)d │ │ │ │ │ +Fo(v)-5 b(alues)34 b(are)g Fn(5)f Fo(for)g(a)h(2-D)h(5-p)s(oin)m(t)f │ │ │ │ │ +(op)s(erator,)h Fn(7)f Fo(for)f(a)h(3-D)h(7-p)s(oin)m(t)f(op)s(erator,) │ │ │ │ │ +h Fn(9)427 1458 y Fo(for)i(a)h(2-D)h(9-p)s(oin)m(t)f(op)s(erator,)i │ │ │ │ │ +Fn(13)d Fo(for)g(a)h(2-D)g(13-p)s(oin)m(t)h(op)s(erator)f(and)e │ │ │ │ │ +Fn(27)h Fo(for)g(a)h(3-D)h(27-p)s(oin)m(t)427 1571 y(op)s(erator.)337 │ │ │ │ │ +1721 y Fc(\210)45 b Fn(n1)30 b Fo(is)g(the)h(n)m(um)m(b)s(er)e(of)i(p)s │ │ │ │ │ +(oin)m(ts)f(in)g(the)g(\014rst)g(direction.)337 1871 │ │ │ │ │ +y Fc(\210)45 b Fn(n2)30 b Fo(is)g(the)h(n)m(um)m(b)s(er)e(of)i(p)s(oin) │ │ │ │ │ +m(ts)f(in)g(the)g(second)h(direction.)337 2021 y Fc(\210)45 │ │ │ │ │ +b Fn(n3)30 b Fo(is)g(the)h(n)m(um)m(b)s(er)e(of)i(p)s(oin)m(ts)f(in)g │ │ │ │ │ +(the)g(third)g(direction,)h(ignored)g(for)f Fn(stencil)e │ │ │ │ │ +Fo(=)i Fn(5)p Fo(,)h Fn(9)f Fo(and)f Fn(13)p Fo(.)337 │ │ │ │ │ +2171 y Fc(\210)45 b Fo(The)g Fn(Graph)g Fo(ob)5 b(ject)46 │ │ │ │ │ +b(is)g(written)f(to)i(\014le)e Fn(outFile)p Fo(.)85 b(It)45 │ │ │ │ │ +b(m)m(ust)h(b)s(e)f(of)h(the)f(form)h Fn(*.graphf)d Fo(or)427 │ │ │ │ │ +2283 y Fn(*.graphb)p Fo(.)36 b(The)23 b Fn(Graph)e Fo(ob)5 │ │ │ │ │ +b(ject)24 b(is)f(written)g(to)g(the)g(\014le)g(via)h(the)f │ │ │ │ │ +Fn(Graph)p 2904 2283 29 4 v 33 w(writeToFile\(\))c Fo(metho)s(d.)111 │ │ │ │ │ +2479 y(5.)46 b Fn(testIO)g(msglvl)g(msgFile)g(inFile)g(outFile)227 │ │ │ │ │ +2633 y Fo(This)21 b(driv)m(er)g(program)h(reads)f(in)g(a)h │ │ │ │ │ Fn(Graph)e Fo(ob)5 b(ject)22 b(from)f Fn(inFile)f Fo(and)h(writes)h │ │ │ │ │ (out)g(the)f(ob)5 b(ject)23 b(to)f Fn(outFile)337 2855 │ │ │ │ │ y Fc(\210)45 b Fo(The)28 b Fn(msglvl)f Fo(parameter)i(determines)g(the) │ │ │ │ │ g(amoun)m(t)g(of)f(output)h(|)f(taking)i Fn(msglvl)46 │ │ │ │ │ b(>=)h(3)28 b Fo(means)427 2968 y(the)j Fn(Graph)e Fo(ob)5 │ │ │ │ │ b(ject)31 b(is)f(written)h(to)g(the)g(message)g(\014le.)337 │ │ │ │ │ 3117 y Fc(\210)45 b Fo(The)33 b Fn(msgFile)e Fo(parameter)j(determines) │ │ │ │ │ @@ -6504,17 +6495,17 @@ │ │ │ │ │ Fo(parameter)j(determines)f(the)h(message)g(\014le)f(|)h(if)f │ │ │ │ │ Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the)427 │ │ │ │ │ 5294 y(message)27 b(\014le)f(is)g Fl(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Fl(app)-5 b(end)28 │ │ │ │ │ b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 5407 │ │ │ │ │ y(data.)p eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1087 4 v 1269 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)40 b Fl(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2720 100 V 1087 w Fo(11)337 399 y Fc(\210)45 b Fo(The)37 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1106 4 v 1288 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)40 b Fl(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2701 100 V 1106 w Fo(11)337 399 y Fc(\210)45 b Fo(The)37 │ │ │ │ │ b Fn(inFile)f Fo(parameter)i(is)g(the)g(input)e(\014le)i(for)f(the)h │ │ │ │ │ Fn(Graph)e Fo(ob)5 b(ject.)64 b(It)37 b(m)m(ust)h(b)s(e)f(of)h(the)f │ │ │ │ │ (form)427 511 y Fn(*.graphf)18 b Fo(or)j Fn(*.graphb)p │ │ │ │ │ Fo(.)35 b(The)19 b Fn(Graph)g Fo(ob)5 b(ject)21 b(is)g(read)f(from)g │ │ │ │ │ (the)g(\014le)h(via)f(the)h Fn(Graph)p 3368 511 29 4 │ │ │ │ │ v 33 w(readFromFile\(\))427 624 y Fo(metho)s(d.)111 1065 │ │ │ │ │ y(7.)46 b Fn(testWirebasket)e(msglvl)i(msgFile)g(inGraphFile)f │ │ │ │ │ @@ -6571,18 +6562,18 @@ │ │ │ │ │ Fo(15)29 b(grid.)40 b(They)27 b(sho)m(w)h(the)h(stages)227 │ │ │ │ │ 5294 y(for)36 b Fn(radius)46 b(=)i(1)36 b Fo(on)g(the)g(left)h(and)f │ │ │ │ │ Fn(radius)46 b(=)i(2)35 b Fo(on)i(the)f(righ)m(t.)59 │ │ │ │ │ b(The)36 b(domains)g(are)g(3)25 b Fi(\002)f Fo(3)36 b(subgrids)227 │ │ │ │ │ 5407 y(whose)30 b(v)m(ertices)i(ha)m(v)m(e)g(lab)s(els)f(equal)g(to)g │ │ │ │ │ (zero.)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1087 │ │ │ │ │ -4 v 1270 w Fn(Graph)28 b Fe(:)41 b Fl(DRAFT)30 b Fe(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2813 100 V 429 1927 a @beginspecial │ │ │ │ │ -0 @llx 0 @lly 600 @urx 600 @ury 1943 @rwi 1943 @rhi @setspecial │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1106 │ │ │ │ │ +4 v 1289 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)30 b Fe(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2794 100 V 429 1927 a @beginspecial 0 @llx 0 │ │ │ │ │ +@lly 600 @urx 600 @ury 1943 @rwi 1943 @rhi @setspecial │ │ │ │ │ %%BeginDocument: ../../Graph/doc/rad1.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0.0 0.0 600.0 600.0 │ │ │ │ │ /radius 15 def │ │ │ │ │ /Helvetica findfont 18.75 scalefont setfont │ │ │ │ │ /M {moveto} def │ │ │ │ │ /L {lineto} def │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -27,15 +27,15 @@ │ │ │ │ │ │ weight vertices in the weighted vertex. The weight of an edge is w(u,v), the number of (u,v) edges │ │ │ │ │ │ in the unit weight graph where u ∈ u and v ∈ v. │ │ │ │ │ │ Thenaturalcompressedgraph[?],[?]isveryimportantformanymatricesfromstructralanalysis │ │ │ │ │ │ and computational fluid mechanics. This type of graph has one special property: │ │ │ │ │ │ w(u,v) = w(u)·w(v) │ │ │ │ │ │ 1The EGraph object represents a graph of the matrix, but stores a list of covering cliques in an IVL object. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Graph : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Graph : DRAFT January 7, 2024 │ │ │ │ │ │ and it is the smallest graph with this property. The compression is loss-less, for given G(V,E) │ │ │ │ │ │ and φ, we can reconstruct the unit weight graph G(V,E). In effect, we can work with the natural │ │ │ │ │ │ compressed graph to find separators and orderings and map back to the unit weight graph. The │ │ │ │ │ │ savings in time and space can be considerable. │ │ │ │ │ │ The Graph object has a method to find the φ map for the natural compressed graph; it requires │ │ │ │ │ │ O(|V|) space and O(|E|) time. There is a method to compress a graph (i.e., given G(V,E) and │ │ │ │ │ │ an arbitrary φ, construct G(V,E)) and a method to expand a graph (i.e., given G(V,E) and an │ │ │ │ │ │ @@ -57,15 +57,15 @@ │ │ │ │ │ │ • int totewght : total edge weight │ │ │ │ │ │ • IVL *adjIVL : pointer to IVL object to hold adjacency lists │ │ │ │ │ │ • int *vwghts : pointer to a vertex to hold vertex weights non-NULL if type % 2 == 1 │ │ │ │ │ │ • IVL *ewghtIVL : pointer to IVL object to hold edge weight lists, non-NULL if type / 2 == 1 │ │ │ │ │ │ 1.2 Prototypes and descriptions of Graph methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ Graph object. │ │ │ │ │ │ - Graph : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Graph : DRAFT January 7, 2024 3 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. Graph * Graph_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the Graph structure and then sets the default fields │ │ │ │ │ │ by a call to Graph setDefaultFields(). │ │ │ │ │ │ 2. void Graph_setDefaultFields ( Graph *graph ) ; │ │ │ │ │ │ @@ -91,15 +91,15 @@ │ │ │ │ │ │ int adjType, int ewghtType ) ; │ │ │ │ │ │ Thisisthebasicinitializer method. Anypreviousdataisclearedwithacall toGraph clearData(). │ │ │ │ │ │ Thenthescalar fields are set and the adjIVL object is initialized. If type is 1 or 3, the vwghts │ │ │ │ │ │ vector is initialized to zeros. If type is 2 or 3, the ewghtIVL object is initialized. │ │ │ │ │ │ Error checking: If graph is NULL, type is invalid (type must be in [0,3]), nvtx is non- │ │ │ │ │ │ positive, nvbnd or nedges is negative, or adjType of ewghtType is invalid (they must be │ │ │ │ │ │ IVL CHUNKED, IVL SOLO or IVL UNKNOWN). an error message is printed and the program exits. │ │ │ │ │ │ - 4 Graph : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Graph : DRAFT January 7, 2024 │ │ │ │ │ │ 2. void Graph_init2 ( Graph *graph, int type, int nvtx, int nvbnd, int nedges, │ │ │ │ │ │ int totvwght, int totewght, IVL *adjIVL, int *vwghts, IVL *ewghtIVL) │ │ │ │ │ │ This method is used by the IO read methods. When a Graph object is read from a file, │ │ │ │ │ │ the IVL object(s) must be initialized and then read in from the file. Therefore, we need an │ │ │ │ │ │ initialization method that allows us to set pointers to the IVL objects and the vwghts vector. │ │ │ │ │ │ Note, adjIVL, vwghts and ewghtIVL are owned by the Graph object and will be free’d when │ │ │ │ │ │ the Graph object is free’d. │ │ │ │ │ │ @@ -130,15 +130,15 @@ │ │ │ │ │ │ 1.2.3 Compress and Expand methods │ │ │ │ │ │ These three methods find an equivalence map for the natural compressed graph, compress a graph, │ │ │ │ │ │ and expand a graph. │ │ │ │ │ │ 1. IV * Graph_equivMap ( Graph *graph ) ; │ │ │ │ │ │ This method constructs the equivalence map from the graph to its natural compressed graph. │ │ │ │ │ │ The map φ : V 7→ V is then constructed (see the Introduction in this section) and put into │ │ │ │ │ │ an IV object that is then returned. │ │ │ │ │ │ - Graph : DRAFT February 8, 2025 5 │ │ │ │ │ │ + Graph : DRAFT January 7, 2024 5 │ │ │ │ │ │ Error checking: If graph is NULL or nvtx <= 0, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 2. Graph * Graph_compress ( Graph *graph, int map[], int coarseType ) ; │ │ │ │ │ │ Graph * Graph_compress2 ( Graph *graph, IV *mapIV, int coarseType ) ; │ │ │ │ │ │ This Graph and map objects (map[] or mapIV) are checked and if any errors are found, │ │ │ │ │ │ the appropriate message is printed and the program exits. The compressed graph object │ │ │ │ │ │ is constructed and returned. Note, the compressed graph does not have a boundary, even │ │ │ │ │ │ @@ -164,15 +164,15 @@ │ │ │ │ │ │ 1. int Graph_sizeOf ( Graph *graph ) ; │ │ │ │ │ │ This method returns the number of bytes taken by this object. │ │ │ │ │ │ Error checking: If graph is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. Graph_externalDegree ( Graph *graph, int v ) ; │ │ │ │ │ │ This method returns the weight of adj(v). │ │ │ │ │ │ Error checking: If graph is NULL, or v is out of range, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ - 6 Graph : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 Graph : DRAFT January 7, 2024 │ │ │ │ │ │ 3. int Graph_adjAndSize ( Graph *graph, int u, int *pusize, int **puadj) ; │ │ │ │ │ │ This method fills *pusize with the size of the adjacency list for u and *puadj points to the │ │ │ │ │ │ start of the list vector. │ │ │ │ │ │ Error checking: If graph is NULL, or if u < 0 or u >= nvtx or if pusize or puadj is NULL, an │ │ │ │ │ │ error message is printed and the program exits. │ │ │ │ │ │ 4. int Graph_adjAndEweights ( Graph *graph, int u, int *pusize, │ │ │ │ │ │ int **puadj, int **puewghts) ; │ │ │ │ │ │ @@ -205,15 +205,15 @@ │ │ │ │ │ │ list for the vertex in the parent graph. Each adjacency list for a boundary vertex of the │ │ │ │ │ │ subgraph is new storage, and only these lists are free’d when the subgraph is free’d. A map │ │ │ │ │ │ vector is created that maps the subgraphs’s vertices (both internal and boundary) into the │ │ │ │ │ │ parent graph’s vertices; the address of the map vector is put into *pmap. The adjacency lists │ │ │ │ │ │ for the subgraph are overwritten by the map[] vector. This renders the graph object invalid. │ │ │ │ │ │ The graph partitioning methods map the vertices back to their original values. Presently, │ │ │ │ │ │ only graphs with unit edge weights are allowed as input. │ │ │ │ │ │ - Graph : DRAFT February 8, 2025 7 │ │ │ │ │ │ + Graph : DRAFT January 7, 2024 7 │ │ │ │ │ │ Error checking: If graph is NULL or icomp < 0 or compids or pmap is NULL, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 8. int Graph_isSymmetric ( Graph *graph ) ; │ │ │ │ │ │ This method returns 1 if the graph is symmetric (i.e., edge (i,j) is present if and only if │ │ │ │ │ │ edge (j,i) is present) and 0 otherwise. │ │ │ │ │ │ Error checking: If graph is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.6 IO methods │ │ │ │ │ │ @@ -242,15 +242,15 @@ │ │ │ │ │ │ file and returns the value returned from the called routine. │ │ │ │ │ │ Error checking: If graph or fn are NULL, or if fn is not of the form *.graphf (for a formatted │ │ │ │ │ │ file) or *.graphb (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ 5. int Graph_writeToFormattedFile ( Graph *graph, FILE *fp ) ; │ │ │ │ │ │ This method writes a Graph object to a formatted file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fprintf, zero is returned. │ │ │ │ │ │ Error checking: If graph or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ - 8 Graph : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 Graph : DRAFT January 7, 2024 │ │ │ │ │ │ 6. int Graph_writeToBinaryFile ( Graph *graph, FILE *fp ) ; │ │ │ │ │ │ This method writes a Graph object to a binary file. If there are no errors in writing the data, │ │ │ │ │ │ the value 1 is returned. If an IO error is encountered from fwrite, zero is returned. │ │ │ │ │ │ Error checking: If graph or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 7. int Graph_writeForHumanEye ( Graph *graph, FILE *fp ) ; │ │ │ │ │ │ This method writes a Graph object to a file in a human readable format. The method │ │ │ │ │ │ Graph writeStats()is called to write out the header and statistics. The value 1 is returned. │ │ │ │ │ │ @@ -276,15 +276,15 @@ │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ 2. compressGraph msglvl msgFile inGraphFile coarseType outMapFile outGraphFile │ │ │ │ │ │ This driver program reads in a Graph object from a file, computes the equivalence map to │ │ │ │ │ │ its natural compressed graph (the first graph need not be unit weight), and constructs the │ │ │ │ │ │ natural compressed graph. The equivalence map and compressed graph are optionally written │ │ │ │ │ │ out to files. │ │ │ │ │ │ - Graph : DRAFT February 8, 2025 9 │ │ │ │ │ │ + Graph : DRAFT January 7, 2024 9 │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ that all objects are written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • TheinGraphFileparameteristheinputfilefortheGraphobject. It mustbeof theform │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ @@ -317,15 +317,15 @@ │ │ │ │ │ │ (if inMapFile is of the form *.ivf), or a binary file (if inMapFile is of the form *.ivb). │ │ │ │ │ │ • The outGraphFile parameter is the output file for the compressed Graph object. If │ │ │ │ │ │ outGraphFile is none then the Graph object is not written to a file. Otherwise, │ │ │ │ │ │ the Graph writeToFile() method is called to write the graph to a formatted file (if │ │ │ │ │ │ outGraphFile is of the form *.graphf), or a binary file (if outGraphFile is of the form │ │ │ │ │ │ *.graphb). │ │ │ │ │ │ 4. mkGridGraph msglvl msgFile stencil n1 n2 n3 outFile │ │ │ │ │ │ - 10 Graph : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 Graph : DRAFT January 7, 2024 │ │ │ │ │ │ This driver program creates a Graph object for a finite difference operator on a n1×n2×n3 │ │ │ │ │ │ regular grid. │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ that all objects are written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ @@ -355,15 +355,15 @@ │ │ │ │ │ │ Graph isSymmetric() method. This was useful in one application where the Graph object │ │ │ │ │ │ was constructed improperly. │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the Graph object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ - Graph : DRAFT February 8, 2025 11 │ │ │ │ │ │ + Graph : DRAFT January 7, 2024 11 │ │ │ │ │ │ • The inFile parameter is the input file for the Graph object. It must be of the form │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ 7. testWirebasket msglvl msgFile inGraphFile inStagesFile │ │ │ │ │ │ outStagesFile radius │ │ │ │ │ │ This driver program reads in a Graph object and and a file that contains the stages ids of the │ │ │ │ │ │ vertices, (stage equal to zero means the vertex is in the Schur complement), and overwrites the │ │ │ │ │ │ @@ -386,15 +386,15 @@ │ │ │ │ │ │ the form *.ivf or *.ivb. The IV object is written to the file via the IV writeToFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The radius parameter is used to define the stage of a Schur complement vertex, namely │ │ │ │ │ │ the stage is the number of domains that are found within radius edges of the vertex. │ │ │ │ │ │ The two plots below illustrate the wirebasket stages for a 15×15 grid. They show the stages │ │ │ │ │ │ for radius = 1 on the left and radius = 2 on the right. The domains are 3 × 3 subgrids │ │ │ │ │ │ whose vertices have labels equal to zero. │ │ │ │ │ │ - 12 Graph : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 Graph : DRAFT January 7, 2024 │ │ │ │ │ │ 0 0 0 2 0 0 0 2 0 0 0 2 0 0 0 0 0 0 2 0 0 0 2 0 0 0 2 0 0 0 │ │ │ │ │ │ 0 0 0 2 0 0 0 2 0 0 0 2 0 0 0 0 0 0 2 0 0 0 2 0 0 0 2 0 0 0 │ │ │ │ │ │ 0 0 0 2 0 0 0 2 0 0 0 2 0 0 0 0 0 0 4 0 0 0 4 0 0 0 4 0 0 0 │ │ │ │ │ │ 2 2 2 4 2 2 2 4 2 2 2 4 2 2 2 2 2 4 4 4 2 4 4 4 2 4 4 4 2 2 │ │ │ │ │ │ 0 0 0 2 0 0 0 2 0 0 0 2 0 0 0 0 0 0 4 0 0 0 4 0 0 0 4 0 0 0 │ │ │ │ │ │ 0 0 0 2 0 0 0 2 0 0 0 2 0 0 0 0 0 0 2 0 0 0 2 0 0 0 2 0 0 0 │ │ │ │ │ │ 0 0 0 2 0 0 0 2 0 0 0 2 0 0 0 0 0 0 4 0 0 0 4 0 0 0 4 0 0 0 │ │ │ ├── ./usr/share/doc/spooles-doc/I2Ohash.ps.gz │ │ │ │ ├── I2Ohash.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o I2Ohash.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2424,21 +2424,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2622,88 +2621,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4348,16 +4342,16 @@ │ │ │ │ │ 205[35 50[{}1 66.4176 /CMR8 rf /Fc 150[24 105[{}1 66.4176 │ │ │ │ │ /CMMI8 rf /Fd 142[83 32[88 80[{}2 83.022 /CMEX10 rf /Fe │ │ │ │ │ 143[76 91[71 20[{}2 90.9091 /CMSY10 rf /Ff 133[50 59 │ │ │ │ │ 4[44 44 46 2[56 62 93 31 2[31 62 2[51 62 50 1[54 11[86 │ │ │ │ │ 5[84 5[42 6[80 13[56 56 56 56 2[31 46[{}24 99.6264 /CMBX12 │ │ │ │ │ rf /Fg 139[62 62 3[62 4[62 1[62 2[62 1[62 62 62 17[62 │ │ │ │ │ 5[62 22[62 50[{}12 119.552 /CMTT12 rf /Fh 134[48 3[51 │ │ │ │ │ -2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 │ │ │ │ │ -44[{}13 90.9091 /CMSL10 rf /Fi 134[44 3[49 30 37 38 1[46 │ │ │ │ │ +2[36 3[51 12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 │ │ │ │ │ +44[{}12 90.9091 /CMSL10 rf /Fi 134[44 3[49 30 37 38 1[46 │ │ │ │ │ 46 51 2[42 1[28 46 42 1[42 46 42 1[46 12[65 1[66 11[59 │ │ │ │ │ 62 69 2[68 6[28 58[{}23 90.9091 /CMTI10 rf /Fj 134[71 │ │ │ │ │ 2[71 75 52 53 55 1[75 67 75 112 3[37 75 67 41 61 75 60 │ │ │ │ │ 1[65 13[75 2[92 11[103 16[67 67 67 2[37 46[{}25 119.552 │ │ │ │ │ /CMBX12 rf │ │ │ │ │ %DVIPSBitmapFont: Fk tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ @@ -4470,20 +4464,20 @@ │ │ │ │ │ b(n)m(um)m(b)s(er)29 b(of)h(items)h(in)f(the)h(hash)f(table.)137 │ │ │ │ │ 5294 y Fk(\210)45 b Fl(I2OP)i(*baseI2OP)35 b Fm(:)j(p)s(oin)m(ter)g(to) │ │ │ │ │ h(an)f Fl(I2OP)f Fm(ob)5 b(ject)39 b(that)f(k)m(eeps)h(trac)m(k)g(of)f │ │ │ │ │ (all)h(the)f Fl(I2OP)f Fm(ob)5 b(jects)38 b(that)227 │ │ │ │ │ 5407 y(ha)m(v)m(e)32 b(b)s(een)e(allo)s(cated)i(b)m(y)e(the)h(hash)e │ │ │ │ │ (table.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fm(2)p 136 100 1062 4 v │ │ │ │ │ -1244 w Fl(I2Ohash)28 b Fh(:)41 b Fi(DRAFT)30 b Fh(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2838 100 V 137 399 a Fk(\210)45 │ │ │ │ │ -b Fl(I2OP)i(*freeI2OP)28 b Fm(:)i(p)s(oin)m(ter)h(to)g(the)f(\014rst)g │ │ │ │ │ -Fl(I2OP)f Fm(ob)5 b(ject)31 b(on)g(the)f(free)h(list.)137 │ │ │ │ │ -604 y Fk(\210)45 b Fl(I2OP)i(**heads)26 b Fm(:)39 b(p)s(oin)m(ter)29 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 136 100 1081 4 v │ │ │ │ │ +1263 w Fl(I2Ohash)29 b Fh(:)40 b Fi(DRAFT)30 b Fh(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2819 100 V 137 399 a Fk(\210)45 b Fl(I2OP)i(*freeI2OP)28 │ │ │ │ │ +b Fm(:)i(p)s(oin)m(ter)h(to)g(the)f(\014rst)g Fl(I2OP)f │ │ │ │ │ +Fm(ob)5 b(ject)31 b(on)g(the)f(free)h(list.)137 604 y │ │ │ │ │ +Fk(\210)45 b Fl(I2OP)i(**heads)26 b Fm(:)39 b(p)s(oin)m(ter)29 │ │ │ │ │ b(to)f(a)h(v)m(ector)g(of)g(p)s(oin)m(ters)f(to)g Fl(I2OP)f │ │ │ │ │ Fm(ob)5 b(jects,)30 b(used)d(to)i(hold)e(a)i(p)s(oin)m(ter)f(to)h(the) │ │ │ │ │ 227 717 y(\014rst)h Fl(I2OP)f Fm(ob)5 b(ject)31 b(in)f(eac)m(h)i(list.) │ │ │ │ │ 141 947 y(A)g(correctly)g(initialized)h(and)e(non)m(trivial)h │ │ │ │ │ Fl(I2Ohash)e Fm(ob)5 b(ject)32 b(will)g(ha)m(v)m(e)g │ │ │ │ │ Fl(nlist)46 b(>)i(0)p Fm(.)43 b(If)31 b Fl(grow)f Fm(is)h(zero)i(and)0 │ │ │ │ │ 1059 y(a)e(new)f Fl()25 b Fm(triple)31 │ │ │ │ │ @@ -4530,17 +4524,17 @@ │ │ │ │ │ Fl(free\(\))p Fm(.)227 4909 y Fi(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fm(If)30 b Fl(hashtable)e Fm(is)j Fl(NULL)p │ │ │ │ │ Fm(,)e(an)h(error)g(message)i(is)e(prin)m(ted)g(and)g(the)g(program)h │ │ │ │ │ (exits.)0 5202 y Ff(1.2.2)112 b(Initializer)38 b(metho)s(ds)0 │ │ │ │ │ 5407 y Fm(There)30 b(is)g(one)h(initializer)h(metho)s(d.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1062 4 v 1244 100 a Fl(I2Ohash)28 │ │ │ │ │ -b Fh(:)41 b Fi(DRAFT)121 b Fh(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2791 100 V 1062 w Fm(3)111 399 y(1.)46 b Fl(void)h(I2Ohash_init)d(\()k │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1081 4 v 1263 100 a Fl(I2Ohash)28 │ │ │ │ │ +b Fh(:)41 b Fi(DRAFT)121 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2772 100 V 1081 w Fm(3)111 399 y(1.)46 b Fl(void)h(I2Ohash_init)d(\()k │ │ │ │ │ (I2Ohash)e(*hashtable,)e(int)j(nlist,)f(int)h(nobj,)g(int)g(grow)f(\))i │ │ │ │ │ (;)227 542 y Fm(This)d(metho)s(d)h(is)g(the)g(basic)g(initializer)i │ │ │ │ │ (metho)s(d.)87 b(It)46 b(clears)h(an)m(y)g(previous)e(data)i(with)f(a)g │ │ │ │ │ (call)h(to)227 655 y Fl(I2Ohash)p 569 655 29 4 v 33 w(clearData\(\))p │ │ │ │ │ Fm(.)36 b(It)27 b(allo)s(cates)i(storage)f(for)e Fl(nlist)f │ │ │ │ │ Fm(lists)i(and)f(if)g Fl(nobj)g Fm(is)g(p)s(ositiv)m(e,)j(it)e(loads)g │ │ │ │ │ (the)227 768 y(free)k(list)g(with)f Fl(nobj)f(I2OP)g │ │ │ │ │ @@ -4616,27 +4610,27 @@ │ │ │ │ │ (*hashtable,)g(FILE)i(*fp)g(\))g(;)227 5151 y Fm(This)30 │ │ │ │ │ b(metho)s(d)g(prin)m(ts)g(the)g(hash)g(table)h(in)f(a)h(h)m │ │ │ │ │ (uman-readable)f(format.)227 5294 y Fi(Err)-5 b(or)41 │ │ │ │ │ b(che)-5 b(cking:)56 b Fm(If)38 b Fl(hashtable)e Fm(or)i │ │ │ │ │ Fl(fp)f Fm(is)i Fl(NULL)p Fm(,)e(an)h(error)g(message)h(is)f(prin)m │ │ │ │ │ (ted)g(and)g(the)g(program)227 5407 y(exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fm(4)p 136 100 1062 4 v │ │ │ │ │ -1244 w Fl(I2Ohash)28 b Fh(:)41 b Fi(DRAFT)30 b Fh(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2838 100 V 0 399 a Fj(1.3)135 │ │ │ │ │ -b(Driv)l(er)46 b(programs)g(for)f(the)g Fg(I2Ohash)58 │ │ │ │ │ -b(object)111 626 y Fm(1.)46 b Fl(test_hash)g(msglvl)g(msgFile)f(size)i │ │ │ │ │ -(grow)g(maxkey)f(nent)g(seed)227 777 y Fm(This)34 b(driv)m(er)h │ │ │ │ │ -(program)g(tests)h(the)f Fl(I2Ohash)e Fm(insert)i(metho)s(d.)54 │ │ │ │ │ -b(It)35 b(inserts)f(a)i(n)m(um)m(b)s(er)d(of)i(triples)h(in)m(to)g(a) │ │ │ │ │ -227 890 y(hash)d(table)h(and)e(prin)m(ts)h(out)g(the)h(\\measure")g(of) │ │ │ │ │ -f(ho)m(w)g(w)m(ell)h(distributed)f(the)g(en)m(tries)h(are)f(in)g(the)h │ │ │ │ │ -(hash)227 1002 y(table.)337 1215 y Fk(\210)45 b Fm(The)f │ │ │ │ │ -Fl(msglvl)e Fm(parameter)j(determines)f(the)g(amoun)m(t)h(of)f(output.) │ │ │ │ │ -82 b(Use)44 b Fl(msglvl)i(=)i(1)c Fm(for)g(just)427 1328 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 136 100 1081 4 v │ │ │ │ │ +1263 w Fl(I2Ohash)29 b Fh(:)40 b Fi(DRAFT)30 b Fh(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2819 100 V 0 399 a Fj(1.3)135 b(Driv)l(er)46 │ │ │ │ │ +b(programs)g(for)f(the)g Fg(I2Ohash)58 b(object)111 626 │ │ │ │ │ +y Fm(1.)46 b Fl(test_hash)g(msglvl)g(msgFile)f(size)i(grow)g(maxkey)f │ │ │ │ │ +(nent)g(seed)227 777 y Fm(This)34 b(driv)m(er)h(program)g(tests)h(the)f │ │ │ │ │ +Fl(I2Ohash)e Fm(insert)i(metho)s(d.)54 b(It)35 b(inserts)f(a)i(n)m(um)m │ │ │ │ │ +(b)s(er)d(of)i(triples)h(in)m(to)g(a)227 890 y(hash)d(table)h(and)e │ │ │ │ │ +(prin)m(ts)h(out)g(the)h(\\measure")g(of)f(ho)m(w)g(w)m(ell)h │ │ │ │ │ +(distributed)f(the)g(en)m(tries)h(are)f(in)g(the)h(hash)227 │ │ │ │ │ +1002 y(table.)337 1215 y Fk(\210)45 b Fm(The)f Fl(msglvl)e │ │ │ │ │ +Fm(parameter)j(determines)f(the)g(amoun)m(t)h(of)f(output.)82 │ │ │ │ │ +b(Use)44 b Fl(msglvl)i(=)i(1)c Fm(for)g(just)427 1328 │ │ │ │ │ y(timing)31 b(output.)337 1474 y Fk(\210)45 b Fm(The)33 │ │ │ │ │ b Fl(msgFile)e Fm(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ (if)f Fl(msgFile)e Fm(is)i Fl(stdout)p Fm(,)g(then)g(the)427 │ │ │ │ │ 1587 y(message)27 b(\014le)f(is)g Fi(stdout)p Fm(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Fi(app)-5 b(end)28 │ │ │ │ │ b Fm(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 1700 │ │ │ │ │ y(data.)337 1846 y Fk(\210)45 b Fm(The)30 b Fl(size)f │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -21,15 +21,15 @@ │ │ │ │ │ │ • int nlist : number of lists in the hash table │ │ │ │ │ │ • int grow : when no I2OP objects are available to insert a new triple, │ │ │ │ │ │ the object can allocate grow more I2OP objects and put them on the free list. │ │ │ │ │ │ • nitem : number of items in the hash table. │ │ │ │ │ │ • I2OP *baseI2OP : pointer to an I2OP object that keeps track of all the I2OP objects that │ │ │ │ │ │ have been allocated by the hash table. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 I2Ohash : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 I2Ohash : DRAFT January 7, 2024 │ │ │ │ │ │ • I2OP *freeI2OP : pointer to the first I2OP object on the free list. │ │ │ │ │ │ • I2OP **heads : pointer to a vector of pointers to I2OP objects, used to hold a pointer to the │ │ │ │ │ │ first I2OP object in each list. │ │ │ │ │ │ Acorrectly initialized and nontrivial I2Ohash object will have nlist > 0. If grow is zero and │ │ │ │ │ │ a new triple is given to the hash table to be inserted, a fatal error occurs. │ │ │ │ │ │ 1.2 Prototypes and descriptions of I2Ohash methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ @@ -51,15 +51,15 @@ │ │ │ │ │ │ Error checking: If hashtable is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void I2Ohash_free ( I2Ohash *hashtable ) ; │ │ │ │ │ │ This method releases any storage by a call to I2Ohash clearData() then free’s the storage │ │ │ │ │ │ for the structure with a call to free(). │ │ │ │ │ │ Error checking: If hashtable is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.2 Initializer methods │ │ │ │ │ │ There is one initializer method. │ │ │ │ │ │ - I2Ohash : DRAFT February 8, 2025 3 │ │ │ │ │ │ + I2Ohash : DRAFT January 7, 2024 3 │ │ │ │ │ │ 1. void I2Ohash_init ( I2Ohash *hashtable, int nlist, int nobj, int grow ) ; │ │ │ │ │ │ This method is the basic initializer method. It clears any previous data with a call to │ │ │ │ │ │ I2Ohash clearData(). It allocates storage for nlist lists and if nobj is positive, it loads the │ │ │ │ │ │ free list with nobj I2OP objects. │ │ │ │ │ │ Error checking: If hashtable is NULL, or if nlist ≤ 0, or if nobj and grow are both zero, an │ │ │ │ │ │ error message is printed and the program exits. │ │ │ │ │ │ 1.2.3 Utility methods │ │ │ │ │ │ @@ -92,15 +92,15 @@ │ │ │ │ │ │ the triples are evenly distributed among nlist/k lists, the value is √k. │ │ │ │ │ │ Error checking: If hashtable is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.4 IO methods │ │ │ │ │ │ 1. void I2Ohash_writeForHumanEye ( I2Ohash *hashtable, FILE *fp ) ; │ │ │ │ │ │ This method prints the hash table in a human-readable format. │ │ │ │ │ │ Error checking: If hashtable or fp is NULL, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - 4 I2Ohash : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 I2Ohash : DRAFT January 7, 2024 │ │ │ │ │ │ 1.3 Driver programs for the I2Ohash object │ │ │ │ │ │ 1. test_hash msglvl msgFile size grow maxkey nent seed │ │ │ │ │ │ This driver program tests the I2Ohash insert method. It inserts a number of triples into a │ │ │ │ │ │ hash table and prints out the “measure” of how well distributed the entries are in the hash │ │ │ │ │ │ table. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ timing output. │ │ │ ├── ./usr/share/doc/spooles-doc/IIheap.ps.gz │ │ │ │ ├── IIheap.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o IIheap.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1277,21 +1277,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1475,88 +1474,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3726,16 +3720,16 @@ │ │ │ │ │ cleartomark │ │ │ │ │ {restore}if │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 235[71 20[{}1 90.9091 /CMSY10 rf /Fb 133[50 │ │ │ │ │ 59 4[44 44 46 2[56 62 93 31 2[31 62 2[51 62 50 1[54 11[86 │ │ │ │ │ 11[42 6[80 14[56 56 56 2[31 46[{}22 99.6264 /CMBX12 rf │ │ │ │ │ -/Fc 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 │ │ │ │ │ -2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf /Fd 143[62 │ │ │ │ │ +/Fc 134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 │ │ │ │ │ +1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf /Fd 143[62 │ │ │ │ │ 7[62 2[62 3[62 23[62 73[{}5 119.552 /CMTT12 rf │ │ │ │ │ %DVIPSBitmapFont: Fe tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ @@ -3842,30 +3836,30 @@ │ │ │ │ │ 4724 y(maxsize)p Fk(.)0 5059 y Ff(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ b(and)f(descriptions)g(of)g Fd(IIheap)d Ff(metho)t(ds)0 │ │ │ │ │ 5294 y Fk(This)f(section)j(con)m(tains)f(brief)f(descriptions)g │ │ │ │ │ (including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f(that)h(b)s │ │ │ │ │ (elong)f(to)h(the)0 5407 y Fj(IIheap)29 b Fk(ob)5 b(ject.)1927 │ │ │ │ │ 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fj(IIheap)29 b Fc(:)40 b Fi(DRAFT)30 b Fc(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 0 399 a Fb(1.2.1)112 │ │ │ │ │ -b(Basic)38 b(metho)s(ds)0 601 y Fk(As)d(usual,)h(there)f(are)g(four)f │ │ │ │ │ -(basic)h(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 │ │ │ │ │ -b(creation,)i(setting)e(default)f(\014elds,)h(clearing)0 │ │ │ │ │ -714 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h(the)g(ob)5 │ │ │ │ │ -b(ject.)111 965 y(1.)46 b Fj(IIheap)g(*)i(IIheap_new)d(\()i(void)g(\))g │ │ │ │ │ -(;)227 1121 y Fk(This)25 b(metho)s(d)g(simply)f(allo)s(cates)k(storage) │ │ │ │ │ -f(for)e(the)h Fj(IIheap)d Fk(structure)i(and)g(then)g(sets)g(the)h │ │ │ │ │ -(default)f(\014elds)227 1234 y(b)m(y)31 b(a)f(call)i(to)f │ │ │ │ │ -Fj(IIheap)p 1001 1234 29 4 v 33 w(setDefaultFields\(\))p │ │ │ │ │ -Fk(.)111 1433 y(2.)46 b Fj(void)h(IIheap_setDefaultFields)41 │ │ │ │ │ -b(\()48 b(IIheap)e(*heap)g(\))i(;)227 1589 y Fk(This)23 │ │ │ │ │ -b(metho)s(d)f(sets)h(the)h(structure's)e(\014elds)h(to)h(default)f(v)-5 │ │ │ │ │ -b(alues:)37 b Fj(size)22 b Fk(and)h Fj(maxsize)e Fk(are)i(zero,)j │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fj(IIheap)29 b Fc(:)40 b Fi(DRAFT)31 b Fc(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 0 399 a Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +601 y Fk(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ +(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ +(\014elds,)h(clearing)0 714 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ +(free'ing)h(the)g(ob)5 b(ject.)111 965 y(1.)46 b Fj(IIheap)g(*)i │ │ │ │ │ +(IIheap_new)d(\()i(void)g(\))g(;)227 1121 y Fk(This)25 │ │ │ │ │ +b(metho)s(d)g(simply)f(allo)s(cates)k(storage)f(for)e(the)h │ │ │ │ │ +Fj(IIheap)d Fk(structure)i(and)g(then)g(sets)g(the)h(default)f │ │ │ │ │ +(\014elds)227 1234 y(b)m(y)31 b(a)f(call)i(to)f Fj(IIheap)p │ │ │ │ │ +1001 1234 29 4 v 33 w(setDefaultFields\(\))p Fk(.)111 │ │ │ │ │ +1433 y(2.)46 b Fj(void)h(IIheap_setDefaultFields)41 b(\()48 │ │ │ │ │ +b(IIheap)e(*heap)g(\))i(;)227 1589 y Fk(This)23 b(metho)s(d)f(sets)h │ │ │ │ │ +(the)h(structure's)e(\014elds)h(to)h(default)f(v)-5 b(alues:)37 │ │ │ │ │ +b Fj(size)22 b Fk(and)h Fj(maxsize)e Fk(are)i(zero,)j │ │ │ │ │ Fj(heapLoc)p Fk(,)227 1702 y Fj(keys)j Fk(and)h Fj(values)f │ │ │ │ │ Fk(are)i Fj(NULL)p Fk(.)227 1858 y Fi(Err)-5 b(or)34 │ │ │ │ │ b(che)-5 b(cking:)40 b Fk(If)30 b Fj(heap)g Fk(is)g Fj(NULL)p │ │ │ │ │ Fk(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ (exits.)111 2057 y(3.)46 b Fj(void)h(IIheap_clearData)c(\()48 │ │ │ │ │ b(IIheap)e(*heap)g(\))i(;)227 2213 y Fk(This)d(metho)s(d)h(clears)h(an) │ │ │ │ │ m(y)f(data)h(o)m(wned)f(b)m(y)g(the)g(ob)5 b(ject.)88 │ │ │ │ │ @@ -3902,17 +3896,17 @@ │ │ │ │ │ 5095 y Fk(1.)46 b Fj(int)h(IIheap_sizeOf)d(\()k(IIheap)e(*heap)g(\))i │ │ │ │ │ (;)227 5251 y Fk(This)30 b(metho)s(d)g(returns)f(the)h(n)m(um)m(b)s(er) │ │ │ │ │ f(of)i(b)m(ytes)g(tak)m(en)g(b)m(y)g(this)f(ob)5 b(ject.)227 │ │ │ │ │ 5407 y Fi(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 │ │ │ │ │ b Fj(heap)g Fk(is)g Fj(NULL)p Fk(,)f(an)i(error)f(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)f(the)i(program)f(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1086 4 v 1267 100 a Fj(IIheap)29 │ │ │ │ │ -b Fc(:)41 b Fi(DRAFT)121 b Fc(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2767 100 V 1086 w Fk(3)111 399 y(2.)46 b Fj(void)h(IIheap_root)e(\()i │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1105 4 v 1287 100 a Fj(IIheap)28 │ │ │ │ │ +b Fc(:)41 b Fi(DRAFT)121 b Fc(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2748 100 V 1105 w Fk(3)111 399 y(2.)46 b Fj(void)h(IIheap_root)e(\()i │ │ │ │ │ (IIheap)f(*heap,)g(int)h(*pkey,)f(int)h(*pvalue)f(\))h(;)227 │ │ │ │ │ 549 y Fk(This)32 b(metho)s(d)g(\014lls)h Fj(*pid)e Fk(and)i │ │ │ │ │ Fj(*pkey)e Fk(with)h(the)h(k)m(ey)h(and)e(v)-5 b(alue,)34 │ │ │ │ │ b(resp)s(ectiv)m(ely)-8 b(,)35 b(of)e(the)g(ro)s(ot)g(elemen)m(t,)227 │ │ │ │ │ 662 y(an)e(elemen)m(t)g(with)f(minim)m(um)g(v)-5 b(alue.)41 │ │ │ │ │ b(If)30 b Fj(size)47 b(==)g(0)30 b Fk(then)g Fj(-1)g │ │ │ │ │ Fk(is)g(returned.)227 812 y Fi(Err)-5 b(or)30 b(che)-5 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -17,15 +17,15 @@ │ │ │ │ │ │ location loc │ │ │ │ │ │ A correctly initialized and nontrivial IIheap object will have maxsize > 0 and 0 <= size < │ │ │ │ │ │ maxsize. │ │ │ │ │ │ 1.2 Prototypes and descriptions of IIheap methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ IIheap object. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 IIheap : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 IIheap : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. IIheap * IIheap_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the IIheap structure and then sets the default fields │ │ │ │ │ │ by a call to IIheap setDefaultFields(). │ │ │ │ │ │ 2. void IIheap_setDefaultFields ( IIheap *heap ) ; │ │ │ │ │ │ @@ -49,15 +49,15 @@ │ │ │ │ │ │ IVinit(). The entries in the three vectors are set to -1. │ │ │ │ │ │ Error checking: If heap is NULL, or if maxsize ≤ 0, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 1.2.3 Utility methods │ │ │ │ │ │ 1. int IIheap_sizeOf ( IIheap *heap ) ; │ │ │ │ │ │ This method returns the number of bytes taken by this object. │ │ │ │ │ │ Error checking: If heap is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - IIheap : DRAFT February 8, 2025 3 │ │ │ │ │ │ + IIheap : DRAFT January 7, 2024 3 │ │ │ │ │ │ 2. void IIheap_root ( IIheap *heap, int *pkey, int *pvalue ) ; │ │ │ │ │ │ This method fills *pid and *pkey with the key and value, respectively, of the root element, │ │ │ │ │ │ an element with minimum value. If size == 0 then -1 is returned. │ │ │ │ │ │ Error checking: If heap, pkey or pvalue is NULL, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 3. void IIheap_insert ( IIheap *heap, int key, int value ) ; │ │ │ │ │ │ This method inserts the pair (key,value) into the heap. │ │ │ ├── ./usr/share/doc/spooles-doc/IV.ps.gz │ │ │ │ ├── IV.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o IV.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1609,21 +1609,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1807,88 +1806,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3762,16 +3756,16 @@ │ │ │ │ │ 2[31 46[{}25 99.6264 /CMBX12 rf /Fb 139[62 4[62 4[62 │ │ │ │ │ 4[62 1[62 62 11[62 12[62 73[{}8 119.552 /CMTT12 rf /Fc │ │ │ │ │ 134[71 2[71 75 52 53 55 1[75 67 75 112 3[37 75 67 41 │ │ │ │ │ 61 75 60 1[65 13[75 2[92 11[103 16[67 67 67 2[37 46[{}25 │ │ │ │ │ 119.552 /CMBX12 rf /Fd 138[49 30 37 38 1[46 46 51 74 │ │ │ │ │ 1[42 1[28 46 42 1[42 46 42 1[46 12[65 1[66 11[59 62 69 │ │ │ │ │ 2[68 6[28 58[{}23 90.9091 /CMTI10 rf /Fe 134[48 3[51 │ │ │ │ │ -2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 │ │ │ │ │ -44[{}13 90.9091 /CMSL10 rf /Ff 152[45 45 102[{}2 90.9091 │ │ │ │ │ +2[36 3[51 12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 │ │ │ │ │ +44[{}12 90.9091 /CMSL10 rf /Ff 152[45 45 102[{}2 90.9091 │ │ │ │ │ /CMSY10 rf │ │ │ │ │ %DVIPSBitmapFont: Fg tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ @@ -3898,28 +3892,28 @@ │ │ │ │ │ (v)m(enience)0 5294 y(mak)m(es)i(it)g(a)g(widely)f(used)g(ob)5 │ │ │ │ │ b(ject.)44 b(Originally)32 b(its)g(use)f(w)m(as)g(restricted)h(to)h │ │ │ │ │ (reading)e(and)g(writing)g Fi(*.iv)p Ff(f)p Fi(f,b)p │ │ │ │ │ Ff(g)0 5407 y Fj(\014les,)g(but)e(no)m(w)i Fi(IV)e Fj(ob)5 │ │ │ │ │ b(jects)32 b(app)s(ear)d(m)m(uc)m(h)i(more)f(frequen)m(tly)h(in)f(new)g │ │ │ │ │ (dev)m(elopmen)m(t.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fi(IV)30 b Fe(:)h Fd(DRAFT)f Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 0 399 a Fc(1.1)135 b(Data)46 │ │ │ │ │ -b(Structure)0 620 y Fj(The)30 b Fi(IV)g Fj(structure)g(has)g(four)f │ │ │ │ │ -(\014elds.)137 791 y Fg(\210)45 b Fi(int)i(size)29 b │ │ │ │ │ -Fj(:)41 b(presen)m(t)30 b(size)i(of)e(the)h(v)m(ector.)137 │ │ │ │ │ -965 y Fg(\210)45 b Fi(int)i(maxsize)29 b Fj(:)40 b(maxim)m(um)30 │ │ │ │ │ -b(size)i(of)e(the)h(v)m(ector.)137 1139 y Fg(\210)45 │ │ │ │ │ -b Fi(int)i(owned)30 b Fj(:)44 b(o)m(wner)32 b(\015ag)g(for)f(the)h │ │ │ │ │ -(data.)46 b(When)31 b Fi(owned)46 b(=)i(1)p Fj(,)32 b(storage)h(for)f │ │ │ │ │ -Fi(maxsize)d(int)p Fj('s)i(has)h(b)s(een)227 1252 y(allo)s(cated)i(b)m │ │ │ │ │ -(y)e(this)g(ob)5 b(ject)33 b(and)f(can)g(b)s(e)g(free'd)g(b)m(y)g(the)g │ │ │ │ │ -(ob)5 b(ject.)47 b(When)32 b Fi(nowned)46 b(=)h(0)32 │ │ │ │ │ -b Fj(but)f Fi(maxsize)46 b(>)227 1365 y(0)p Fj(,)31 b(this)f(ob)5 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 0 399 a Fc(1.1)135 b(Data)46 b(Structure)0 │ │ │ │ │ +620 y Fj(The)30 b Fi(IV)g Fj(structure)g(has)g(four)f(\014elds.)137 │ │ │ │ │ +791 y Fg(\210)45 b Fi(int)i(size)29 b Fj(:)41 b(presen)m(t)30 │ │ │ │ │ +b(size)i(of)e(the)h(v)m(ector.)137 965 y Fg(\210)45 b │ │ │ │ │ +Fi(int)i(maxsize)29 b Fj(:)40 b(maxim)m(um)30 b(size)i(of)e(the)h(v)m │ │ │ │ │ +(ector.)137 1139 y Fg(\210)45 b Fi(int)i(owned)30 b Fj(:)44 │ │ │ │ │ +b(o)m(wner)32 b(\015ag)g(for)f(the)h(data.)46 b(When)31 │ │ │ │ │ +b Fi(owned)46 b(=)i(1)p Fj(,)32 b(storage)h(for)f Fi(maxsize)d(int)p │ │ │ │ │ +Fj('s)i(has)h(b)s(een)227 1252 y(allo)s(cated)i(b)m(y)e(this)g(ob)5 │ │ │ │ │ +b(ject)33 b(and)f(can)g(b)s(e)g(free'd)g(b)m(y)g(the)g(ob)5 │ │ │ │ │ +b(ject.)47 b(When)32 b Fi(nowned)46 b(=)h(0)32 b Fj(but)f │ │ │ │ │ +Fi(maxsize)46 b(>)227 1365 y(0)p Fj(,)31 b(this)f(ob)5 │ │ │ │ │ b(ject)31 b(p)s(oin)m(ts)f(to)h(en)m(tries)h(that)f(ha)m(v)m(e)g(b)s │ │ │ │ │ (een)f(allo)s(cated)i(elsewhere,)f(and)f(these)h(en)m(tries)g(will)g │ │ │ │ │ (not)227 1478 y(b)s(e)f(free'd)g(b)m(y)h(this)f(ob)5 │ │ │ │ │ b(ject.)137 1652 y Fg(\210)45 b Fi(int)i(*vec)29 b Fj(:)41 │ │ │ │ │ b(p)s(oin)m(ter)30 b(to)i(the)e(base)h(address)e(of)i(the)f │ │ │ │ │ Fd(int)h Fj(v)m(ector)0 1824 y(The)36 b Fi(size)p Fj(,)g │ │ │ │ │ Fi(maxsize)p Fj(,)g Fi(owned)f Fj(and)g Fi(vec)h Fj(\014elds)f(need)h │ │ │ │ │ @@ -3966,17 +3960,17 @@ │ │ │ │ │ (call)g(to)f Fi(IV)p 2148 5151 V 34 w(clearData\(\))d │ │ │ │ │ Fj(then)i(free's)h(the)g(storage)h(for)f(the)227 5264 │ │ │ │ │ y(structure)h(with)g(a)h(call)h(to)f Fi(free\(\))p Fj(.)227 │ │ │ │ │ 5407 y Fd(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 │ │ │ │ │ b Fi(iv)g Fj(is)h Fi(NULL)p Fj(,)e(an)h(error)g(message)i(is)e(prin)m │ │ │ │ │ (ted)g(and)g(the)g(program)h(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1187 4 v 1368 100 a Fi(IV)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fj(3)0 399 y Fa(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1206 4 v 1387 100 a Fi(IV)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fj(3)0 399 y Fa(1.2.2)112 b(Instance)38 │ │ │ │ │ b(metho)s(ds)0 606 y Fj(These)33 b(metho)s(d)f(allo)m(w)j(access)g(to)e │ │ │ │ │ (information)h(in)f(the)g(data)h(\014elds)e(without)i(explicitly)g │ │ │ │ │ (follo)m(wing)h(p)s(oin)m(ters.)0 719 y(There)g(is)h(o)m(v)m(erhead)h │ │ │ │ │ (in)m(v)m(olv)m(ed)h(with)d(these)h(metho)s(d)g(due)f(to)h(the)g │ │ │ │ │ (function)g(call)h(and)e(error)h(c)m(hec)m(king)h(inside)0 │ │ │ │ │ 832 y(the)31 b(metho)s(ds.)111 1097 y(1.)46 b Fi(int)h(IV_owned)f(\()h │ │ │ │ │ (IV)g(*iv)g(\))h(;)227 1258 y Fj(This)24 b(metho)s(d)g(returns)g(the)g │ │ │ │ │ @@ -4032,30 +4026,30 @@ │ │ │ │ │ Fi(loc)p Fj('th)f(en)m(try)g(of)h(the)f(v)m(ector)i(to)f │ │ │ │ │ Fi(value)p Fj(.)227 5294 y Fd(Err)-5 b(or)32 b(che)-5 │ │ │ │ │ b(cking:)40 b Fj(If)27 b Fi(iv)p Fj(,)i Fi(loc)47 b(<)g(0)28 │ │ │ │ │ b Fj(or)g Fi(loc)47 b(>=)g(size)p Fj(,)28 b(or)g(if)h │ │ │ │ │ Fi(vec)e Fj(is)h Fi(NULL)g Fj(an)g(error)g(message)h(is)f(prin)m(ted) │ │ │ │ │ 227 5407 y(and)i(the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fi(IV)30 b Fe(:)h Fd(DRAFT)f Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 0 399 a Fa(1.2.3)112 b(Initializer)38 │ │ │ │ │ -b(metho)s(ds)111 596 y Fj(1.)46 b Fi(void)h(IV_init)f(\()h(IV)g(*iv,)g │ │ │ │ │ -(int)g(size,)f(int)h(*entries)f(\))h(;)227 747 y Fj(This)36 │ │ │ │ │ -b(metho)s(d)g(initializes)j(the)d(ob)5 b(ject)38 b(giv)m(en)f(a)g(size) │ │ │ │ │ -h(for)e(the)h(v)m(ector)h(and)e(a)h(p)s(ossible)f(p)s(oin)m(ter)g(to)i │ │ │ │ │ -(the)227 860 y(v)m(ectors)28 b(storage.)41 b(An)m(y)26 │ │ │ │ │ -b(previous)g(data)h(with)f(a)h(call)g(to)g Fi(IV)p 2277 │ │ │ │ │ -860 29 4 v 34 w(clearData\(\))p Fj(.)36 b(If)26 b Fi(entries)46 │ │ │ │ │ -b(!=)h(NULL)25 b Fj(then)227 973 y(the)35 b Fi(vec)e │ │ │ │ │ -Fj(\014eld)g(is)h(set)h(to)g Fi(entries)p Fj(,)e(the)h │ │ │ │ │ -Fi(size)f Fj(and)g Fi(maxsize)g Fj(\014elds)g(are)h(set)h(to)g │ │ │ │ │ -Fi(size)e Fj(,)i(and)e Fi(owned)g Fj(is)227 1086 y(set)f(to)f(zero)h(b) │ │ │ │ │ -s(ecause)f(the)g(ob)5 b(ject)32 b(do)s(es)f(not)g(o)m(wn)g(the)g(en)m │ │ │ │ │ -(tries.)43 b(If)30 b Fi(entries)f Fj(is)i Fi(NULL)f Fj(and)g(if)h │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 0 399 a Fa(1.2.3)112 b(Initializer)38 b(metho)s(ds)111 │ │ │ │ │ +596 y Fj(1.)46 b Fi(void)h(IV_init)f(\()h(IV)g(*iv,)g(int)g(size,)f │ │ │ │ │ +(int)h(*entries)f(\))h(;)227 747 y Fj(This)36 b(metho)s(d)g │ │ │ │ │ +(initializes)j(the)d(ob)5 b(ject)38 b(giv)m(en)f(a)g(size)h(for)e(the)h │ │ │ │ │ +(v)m(ector)h(and)e(a)h(p)s(ossible)f(p)s(oin)m(ter)g(to)i(the)227 │ │ │ │ │ +860 y(v)m(ectors)28 b(storage.)41 b(An)m(y)26 b(previous)g(data)h(with) │ │ │ │ │ +f(a)h(call)g(to)g Fi(IV)p 2277 860 29 4 v 34 w(clearData\(\))p │ │ │ │ │ +Fj(.)36 b(If)26 b Fi(entries)46 b(!=)h(NULL)25 b Fj(then)227 │ │ │ │ │ +973 y(the)35 b Fi(vec)e Fj(\014eld)g(is)h(set)h(to)g │ │ │ │ │ +Fi(entries)p Fj(,)e(the)h Fi(size)f Fj(and)g Fi(maxsize)g │ │ │ │ │ +Fj(\014elds)g(are)h(set)h(to)g Fi(size)e Fj(,)i(and)e │ │ │ │ │ +Fi(owned)g Fj(is)227 1086 y(set)f(to)f(zero)h(b)s(ecause)f(the)g(ob)5 │ │ │ │ │ +b(ject)32 b(do)s(es)f(not)g(o)m(wn)g(the)g(en)m(tries.)43 │ │ │ │ │ +b(If)30 b Fi(entries)f Fj(is)i Fi(NULL)f Fj(and)g(if)h │ │ │ │ │ Fi(size)47 b(>)g(0)227 1199 y Fj(then)30 b(a)h(v)m(ector)h(is)e(allo)s │ │ │ │ │ (cated)j(b)m(y)d(the)h(ob)5 b(ject,)31 b(and)f(the)h(ob)5 │ │ │ │ │ b(ject)31 b(o)m(wns)f(this)g(storage.)227 1350 y Fd(Err)-5 │ │ │ │ │ b(or)30 b(che)-5 b(cking:)38 b Fj(If)26 b Fi(iv)f Fj(is)h │ │ │ │ │ Fi(NULL)e Fj(or)i Fi(size)47 b(<)g(0)p Fj(,)27 b(an)f(error)f(message)i │ │ │ │ │ (is)f(prin)m(ted)g(and)f(the)h(program)g(exits.)111 1540 │ │ │ │ │ y(2.)46 b Fi(void)h(IV_init1)e(\()j(IV)f(*iv,)g(int)g(size)f(\))i(;)227 │ │ │ │ │ @@ -4121,17 +4115,17 @@ │ │ │ │ │ (v)m(ector)j(b)m(y)d Fi(offset)p Fj(.)46 b(This)31 b(is)i(a)g │ │ │ │ │ (dangerous)f(metho)s(d)g(to)h(use)g(b)s(ecause)f(the)h(state)h(of)227 │ │ │ │ │ 5407 y(the)j(v)m(ector)h(is)e(lost,)j(namely)e Fi(vec)p │ │ │ │ │ Fj(,)g(the)g(base)f(of)h(the)f(en)m(tries,)j(is)e(corrupted.)58 │ │ │ │ │ b(If)35 b(the)i(ob)5 b(ject)37 b(o)m(wns)g(its)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1187 4 v 1368 100 a Fi(IV)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fj(5)227 399 y(en)m(tries)e(and)e Fi(IV)p │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1206 4 v 1387 100 a Fi(IV)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fj(5)227 399 y(en)m(tries)e(and)e Fi(IV)p │ │ │ │ │ 792 399 29 4 v 34 w(free\(\))p Fj(,)g Fi(IV)p 1262 399 │ │ │ │ │ V 34 w(setSize\(\))e Fj(or)j Fi(IV)p 1958 399 V 34 w(setMaxsize\(\))d │ │ │ │ │ Fj(is)j(called)h(b)s(efore)f(the)g(base)g(has)g(b)s(een)227 │ │ │ │ │ 511 y(shifted)h(bac)m(k)g(to)g(its)h(original)f(p)s(osition,)h(a)f │ │ │ │ │ (segmen)m(tation)i(violation)f(will)f(lik)m(ely)i(result.)40 │ │ │ │ │ b(This)28 b(is)g(a)i(v)m(ery)227 624 y(useful)g(metho)s(d,)g(but)g(use) │ │ │ │ │ g(with)g(caution.)227 779 y Fd(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ @@ -4192,19 +4186,19 @@ │ │ │ │ │ (;)227 5294 y Fj(This)24 b(metho)s(d)f(examines)i(the)g(en)m(tries)g │ │ │ │ │ (in)f(the)g(v)m(ector.)40 b(Let)25 b Fi(k)f Fj(b)s(e)g(en)m(try)g │ │ │ │ │ Fi(i)g Fj(in)g(the)h(v)m(ector.)40 b(If)24 b Fi(tags[k])46 │ │ │ │ │ b(!=)227 5407 y(keepTag)p Fj(,)28 b(the)i(en)m(try)g(is)g(mo)m(v)m(ed)g │ │ │ │ │ (to)h(the)f(end)f(of)g(the)h(v)m(ector,)i(otherwise)e(it)g(is)g(mo)m(v) │ │ │ │ │ m(ed)g(to)h(the)f(b)s(eginning)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fj(6)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fi(IV)30 b Fe(:)h Fd(DRAFT)f Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 227 399 a Fj(of)f(the)g(v)m(ector.)42 │ │ │ │ │ -b(The)29 b(size)h(of)g(the)g(v)m(ector)h(is)e(reset)i(to)f(b)s(e)f(the) │ │ │ │ │ -g(n)m(um)m(b)s(er)g(of)g(tagged)i(en)m(tries)g(that)f(are)g(no)m(w)227 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fj(6)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 227 399 a Fj(of)f(the)g(v)m(ector.)42 b(The)29 │ │ │ │ │ +b(size)h(of)g(the)g(v)m(ector)h(is)e(reset)i(to)f(b)s(e)f(the)g(n)m(um) │ │ │ │ │ +m(b)s(er)g(of)g(tagged)i(en)m(tries)g(that)f(are)g(no)m(w)227 │ │ │ │ │ 511 y(in)g(the)h(leading)g(lo)s(cations.)227 660 y Fd(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b Fi(iv)g Fj(of)h │ │ │ │ │ Fi(tags)e Fj(is)h Fi(NULL)f Fj(an)i(error)f(message)h(is)g(prin)m(ted)f │ │ │ │ │ (and)f(the)i(program)f(exits.)111 844 y(9.)46 b Fi(void)h │ │ │ │ │ (IV_filterPurge)d(\()j(IV)g(*iv,)g(int)g(tags[],)f(int)h(purgeTag)e(\)) │ │ │ │ │ j(;)227 992 y Fj(This)24 b(metho)s(d)f(examines)i(the)g(en)m(tries)g │ │ │ │ │ (in)f(the)g(v)m(ector.)40 b(Let)25 b Fi(k)f Fj(b)s(e)g(en)m(try)g │ │ │ │ │ @@ -4261,17 +4255,17 @@ │ │ │ │ │ Fi(loc)p Fj('th)g(lo)s(cation)h(of)g(the)f Fi(iv)f Fj(ob)5 │ │ │ │ │ b(ject)39 b(b)m(y)f(one)h(and)e(returns)g(the)h(new)227 │ │ │ │ │ 5146 y(v)-5 b(alue.)227 5294 y Fd(Err)g(or)38 b(che)-5 │ │ │ │ │ b(cking:)49 b Fj(If)34 b Fi(iv)g Fj(is)h Fi(NULL)f Fj(or)g(if)h │ │ │ │ │ Fi(loc)f Fj(is)h(out)g(of)f(range,)j(an)d(error)h(message)h(is)e(prin)m │ │ │ │ │ (ted)h(and)f(the)227 5407 y(program)c(exits.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1187 4 v 1368 100 a Fi(IV)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fj(7)66 399 y(15.)46 b Fi(int)h(IV_findValue)e(\()i │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1206 4 v 1387 100 a Fi(IV)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fj(7)66 399 y(15.)46 b Fi(int)h(IV_findValue)e(\()i │ │ │ │ │ (IV)g(*iv,)g(int)g(value)f(\))i(;)227 547 y Fj(This)30 │ │ │ │ │ b(metho)s(d)f(lo)s(oks)i(for)e Fi(value)g Fj(in)h(its)g(en)m(tries.)42 │ │ │ │ │ b(If)29 b Fi(value)g Fj(is)h(presen)m(t,)g(the)h(\014rst)e(lo)s(cation) │ │ │ │ │ j(is)e(returned,)227 660 y(otherwise)h Fi(-1)f Fj(is)g(returned.)40 │ │ │ │ │ b(The)30 b(cost)h(is)f(linear)h(in)f(the)h(n)m(um)m(b)s(er)e(of)h(en)m │ │ │ │ │ (tries.)227 808 y Fd(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fj(If)30 b Fi(iv)g Fj(is)h Fi(NULL)p Fj(,)e(an)h(error)g(message)i │ │ │ │ │ @@ -4342,31 +4336,30 @@ │ │ │ │ │ 5294 y Fd(Err)-5 b(or)36 b(che)-5 b(cking:)43 b Fj(If)31 │ │ │ │ │ b Fi(iv)g Fj(or)h Fi(fn)f Fj(are)i Fi(NULL)p Fj(,)d(or)i(if)g │ │ │ │ │ Fi(fn)f Fj(is)h(not)g(of)g(the)g(form)g Fi(*.ivf)e Fj(\(for)i(a)g │ │ │ │ │ (formatted)g(\014le\))227 5407 y(or)f Fi(*.ivb)e Fj(\(for)h(a)h(binary) │ │ │ │ │ e(\014le\),)j(an)e(error)g(message)h(is)g(prin)m(ted)f(and)f(the)i │ │ │ │ │ (metho)s(d)f(returns)f(zero.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fj(8)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fi(IV)30 b Fe(:)h Fd(DRAFT)f Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 111 399 a Fj(2.)46 b Fi(int)h │ │ │ │ │ -(IV_readFromFormattedFile)41 b(\()48 b(IV)f(*iv,)g(FILE)f(*fp)h(\))h(;) │ │ │ │ │ -227 550 y Fj(This)27 b(metho)s(d)g(reads)h(in)f(an)g │ │ │ │ │ -Fi(IV)g Fj(ob)5 b(ject)29 b(from)e(a)h(formatted)g(\014le.)40 │ │ │ │ │ -b(If)27 b(there)h(are)g(no)g(errors)f(in)g(reading)h(the)227 │ │ │ │ │ -663 y(data,)k(the)e(v)-5 b(alue)31 b Fi(1)f Fj(is)g(returned.)40 │ │ │ │ │ -b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ -Fi(fscanf)p Fj(,)f(zero)i(is)g(returned.)227 815 y Fd(Err)-5 │ │ │ │ │ -b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b Fi(iv)g Fj(or)g │ │ │ │ │ -Fi(fp)g Fj(are)h Fi(NULL)e Fj(an)h(error)g(message)i(is)e(prin)m(ted)g │ │ │ │ │ -(and)g(zero)h(is)g(returned.)111 1006 y(3.)46 b Fi(int)h │ │ │ │ │ -(IV_readFromBinaryFile)42 b(\()48 b(IV)f(*iv,)f(FILE)h(*fp)g(\))g(;)227 │ │ │ │ │ -1158 y Fj(This)34 b(metho)s(d)h(reads)f(in)h(an)f Fi(IV)g │ │ │ │ │ -Fj(ob)5 b(ject)36 b(from)e(a)i(binary)e(\014le.)54 b(If)34 │ │ │ │ │ -b(there)h(are)g(no)g(errors)f(in)h(reading)g(the)227 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fj(8)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 111 399 a Fj(2.)46 b Fi(int)h(IV_readFromFormattedFile)41 │ │ │ │ │ +b(\()48 b(IV)f(*iv,)g(FILE)f(*fp)h(\))h(;)227 550 y Fj(This)27 │ │ │ │ │ +b(metho)s(d)g(reads)h(in)f(an)g Fi(IV)g Fj(ob)5 b(ject)29 │ │ │ │ │ +b(from)e(a)h(formatted)g(\014le.)40 b(If)27 b(there)h(are)g(no)g │ │ │ │ │ +(errors)f(in)g(reading)h(the)227 663 y(data,)k(the)e(v)-5 │ │ │ │ │ +b(alue)31 b Fi(1)f Fj(is)g(returned.)40 b(If)30 b(an)g(IO)g(error)g(is) │ │ │ │ │ +g(encoun)m(tered)h(from)f Fi(fscanf)p Fj(,)f(zero)i(is)g(returned.)227 │ │ │ │ │ +815 y Fd(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 │ │ │ │ │ +b Fi(iv)g Fj(or)g Fi(fp)g Fj(are)h Fi(NULL)e Fj(an)h(error)g(message)i │ │ │ │ │ +(is)e(prin)m(ted)g(and)g(zero)h(is)g(returned.)111 1006 │ │ │ │ │ +y(3.)46 b Fi(int)h(IV_readFromBinaryFile)42 b(\()48 b(IV)f(*iv,)f(FILE) │ │ │ │ │ +h(*fp)g(\))g(;)227 1158 y Fj(This)34 b(metho)s(d)h(reads)f(in)h(an)f │ │ │ │ │ +Fi(IV)g Fj(ob)5 b(ject)36 b(from)e(a)i(binary)e(\014le.)54 │ │ │ │ │ +b(If)34 b(there)h(are)g(no)g(errors)f(in)h(reading)g(the)227 │ │ │ │ │ 1271 y(data,)d(the)e(v)-5 b(alue)31 b Fi(1)f Fj(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fi(fread)p Fj(,)f(zero)i(is)g(returned.)227 1423 y Fd(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b Fi(iv)g Fj(or)g │ │ │ │ │ Fi(fp)g Fj(are)h Fi(NULL)e Fj(an)h(error)g(message)i(is)e(prin)m(ted)g │ │ │ │ │ (and)g(zero)h(is)g(returned.)111 1614 y(4.)46 b Fi(int)h │ │ │ │ │ (IV_writeToFile)d(\()k(IV)f(*iv,)f(char)h(*fn)g(\))g(;)227 │ │ │ │ │ @@ -4431,17 +4424,17 @@ │ │ │ │ │ h(separated)g(b)m(y)g(a)g(whitespace.)40 b(The)227 5255 │ │ │ │ │ y(v)-5 b(alue)31 b Fi(1)f Fj(is)h(returned.)227 5407 │ │ │ │ │ y Fd(Err)-5 b(or)27 b(che)-5 b(cking:)36 b Fj(If)22 b │ │ │ │ │ Fi(iv)g Fj(or)g Fi(fp)g Fj(or)g Fi(pierr)f Fj(are)i Fi(NULL)p │ │ │ │ │ Fj(,)e(an)i(error)f(message)h(is)g(prin)m(ted)e(and)h(zero)h(is)g │ │ │ │ │ (returned.)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1187 4 v 1368 100 a Fi(IV)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fj(9)66 399 y(10.)46 b Fi(int)h(IV_writeForMatlab)c │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1206 4 v 1387 100 a Fi(IV)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fj(9)66 399 y(10.)46 b Fi(int)h(IV_writeForMatlab)c │ │ │ │ │ (\()48 b(IV)f(*iv,)g(char)f(*name,)g(FILE)h(*fp)g(\))g(;)227 │ │ │ │ │ 549 y Fj(This)37 b(metho)s(d)h(writes)f(the)i(en)m(tries)f(of)g(the)g │ │ │ │ │ (v)m(ector)i(to)e(a)g(\014le)g(suitable)h(to)f(b)s(e)g(read)f(b)m(y)h │ │ │ │ │ (Matlab.)64 b(The)227 662 y(c)m(haracter)31 b(string)e │ │ │ │ │ Fi(name)f Fj(is)h(the)g(name)g(of)g(the)g(v)m(ector,)i(e.g,)g(if)e │ │ │ │ │ Fi(name)46 b(=)i("A")p Fj(,)28 b(then)h(w)m(e)g(ha)m(v)m(e)h(lines)g │ │ │ │ │ (of)f(the)227 775 y(form)227 1000 y Fi(A\(1\))47 b(=)g(32)h(;)227 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -24,15 +24,15 @@ │ │ │ │ │ │ IV setMaxsize() methods) than it is to duplicate code to work on an int vector. │ │ │ │ │ │ Onemustchoose where to use this object. There is a substantial performance penalty for doing the │ │ │ │ │ │ simplest operations, and so when we need to manipulate an int vector inside a loop, we extract │ │ │ │ │ │ out the size and pointer to the base array from the IV object. On the other hand, the convenience │ │ │ │ │ │ makes it a widely used object. Originally its use was restricted to reading and writing *.iv{f,b} │ │ │ │ │ │ files, but now IV objects appear much more frequently in new development. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 IV : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 IV : DRAFT January 7, 2024 │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ The IV structure has four fields. │ │ │ │ │ │ • int size : present size of the vector. │ │ │ │ │ │ • int maxsize : maximum size of the vector. │ │ │ │ │ │ • int owned : owner flag for the data. When owned = 1, storage for maxsize int’s has been │ │ │ │ │ │ allocated by this object and can be free’d by the object. When nowned = 0 but maxsize > │ │ │ │ │ │ 0, this object points to entries that have been allocated elsewhere, and these entries will not │ │ │ │ │ │ @@ -58,15 +58,15 @@ │ │ │ │ │ │ the storage for vec is free’d by a call to IVfree(). The structure’s default fields are then set │ │ │ │ │ │ with a call to IV setDefaultFields(). │ │ │ │ │ │ Error checking: If iv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void IV_free ( IV *iv ) ; │ │ │ │ │ │ This method releases any storage by a call to IV clearData() then free’s the storage for the │ │ │ │ │ │ structure with a call to free(). │ │ │ │ │ │ Error checking: If iv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - IV : DRAFT February 8, 2025 3 │ │ │ │ │ │ + IV : DRAFT January 7, 2024 3 │ │ │ │ │ │ 1.2.2 Instance methods │ │ │ │ │ │ These method allow access to information in the data fields without explicitly following pointers. │ │ │ │ │ │ There is overhead involved with these method due to the function call and error checking inside │ │ │ │ │ │ the methods. │ │ │ │ │ │ 1. int IV_owned ( IV *iv ) ; │ │ │ │ │ │ This method returns the value of owned. If owned = 1, then the object owns the data pointed │ │ │ │ │ │ to by vec and will free this data with a call to IVfree() when its data is cleared by a call to │ │ │ │ │ │ @@ -91,15 +91,15 @@ │ │ │ │ │ │ the vector. │ │ │ │ │ │ Error checking: If iv, psize or pentries is NULL an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 7. void IV_setEntry ( IV *iv, int loc, int value ) ; │ │ │ │ │ │ This method sets the loc’th entry of the vector to value. │ │ │ │ │ │ Error checking: If iv, loc < 0 or loc >= size, or if vec is NULL an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ - 4 IV : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 IV : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.3 Initializer methods │ │ │ │ │ │ 1. void IV_init ( IV *iv, int size, int *entries ) ; │ │ │ │ │ │ This method initializes the object given a size for the vector and a possible pointer to the │ │ │ │ │ │ vectors storage. Any previous data with a call to IV clearData(). If entries != NULL then │ │ │ │ │ │ the vec field is set to entries, the size and maxsize fields are set to size , and owned is │ │ │ │ │ │ set to zero because the object does not own the entries. If entries is NULL and if size > 0 │ │ │ │ │ │ then a vector is allocated by the object, and the object owns this storage. │ │ │ │ │ │ @@ -128,15 +128,15 @@ │ │ │ │ │ │ Error checking: If iv is NULL or newsize < 0, or if 0 < maxsize < newsize and owned == │ │ │ │ │ │ 0, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.4 Utility methods │ │ │ │ │ │ 1. void IV_shiftBase ( IV *iv, int offset ) ; │ │ │ │ │ │ This method shifts the base entries of the vector and decrements the present size and max- │ │ │ │ │ │ imum size of the vector by offset. This is a dangerous method to use because the state of │ │ │ │ │ │ the vector is lost, namely vec, the base of the entries, is corrupted. If the object owns its │ │ │ │ │ │ - IV : DRAFT February 8, 2025 5 │ │ │ │ │ │ + IV : DRAFT January 7, 2024 5 │ │ │ │ │ │ entries and IV free(), IV setSize() or IV setMaxsize() is called before the base has been │ │ │ │ │ │ shifted back to its original position, a segmentation violation will likely result. This is a very │ │ │ │ │ │ useful method, but use with caution. │ │ │ │ │ │ Error checking: If iv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. void IV_push ( IV *iv, int val ) ; │ │ │ │ │ │ This method pushes an entry onto the vector. If the vector is full, i.e., if size = maxsize │ │ │ │ │ │ - 1, then the size of the vector is doubled if possible. If the storage cannot grow, i.e., if the │ │ │ │ │ │ @@ -164,15 +164,15 @@ │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 7. int IV_sizeOf ( IV *iv ) ; │ │ │ │ │ │ This method returns the number of bytes taken by the object. │ │ │ │ │ │ Error checking: If iv is NULL an error message is printed and the program exits. │ │ │ │ │ │ 8. void IV_filterKeep ( IV *iv, int tags[], int keepTag ) ; │ │ │ │ │ │ This method examines the entries in the vector. Let k be entry i in the vector. If tags[k] != │ │ │ │ │ │ keepTag, the entry is moved to the end of the vector, otherwise it is moved to the beginning │ │ │ │ │ │ - 6 IV : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 IV : DRAFT January 7, 2024 │ │ │ │ │ │ of the vector. The size of the vector is reset to be the number of tagged entries that are now │ │ │ │ │ │ in the leading locations. │ │ │ │ │ │ Error checking: If iv of tags is NULL an error message is printed and the program exits. │ │ │ │ │ │ 9. void IV_filterPurge ( IV *iv, int tags[], int purgeTag ) ; │ │ │ │ │ │ This method examines the entries in the vector. Let k be entry i in the vector. If tags[k] == │ │ │ │ │ │ purgeTag, the entry is moved to the end of the vector, otherwise it is moved to the beginning │ │ │ │ │ │ of the vector. The size of the vector is reset to be the number of untagged entries that are │ │ │ │ │ │ @@ -201,15 +201,15 @@ │ │ │ │ │ │ Error checking: If iv is NULL or if loc is out of range, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 14. int IV_decrement ( IV *iv, int loc ) ; │ │ │ │ │ │ This method decrements the loc’th location of the iv object by one and returns the new │ │ │ │ │ │ value. │ │ │ │ │ │ Error checking: If iv is NULL or if loc is out of range, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ - IV : DRAFT February 8, 2025 7 │ │ │ │ │ │ + IV : DRAFT January 7, 2024 7 │ │ │ │ │ │ 15. int IV_findValue ( IV *iv, int value ) ; │ │ │ │ │ │ This method looks for value in its entries. If value is present, the first location is returned, │ │ │ │ │ │ otherwise -1 is returned. The cost is linear in the number of entries. │ │ │ │ │ │ Error checking: If iv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 16. int IV_findValueAscending ( IV *iv, int value ) ; │ │ │ │ │ │ Thismethodlooksforvalueinitsentries. Ifvalueispresent, alocation isreturned, otherwise │ │ │ │ │ │ -1 is returned. This method assumes that the entries are sorted in ascending order. The cost │ │ │ │ │ │ @@ -238,15 +238,15 @@ │ │ │ │ │ │ is size, followed by the size entries found in vec[]. │ │ │ │ │ │ 1. int IV_readFromFile ( IV *iv, char *fn ) ; │ │ │ │ │ │ This method reads an IV object from a formatted file. It tries to open the file and if it is │ │ │ │ │ │ successful, it then calls IV readFromFormattedFile() or IV readFromBinaryFile(), closes │ │ │ │ │ │ the file and returns the value returned from the called routine. │ │ │ │ │ │ Error checking: If iv or fn are NULL, or if fn is not of the form *.ivf (for a formatted file) │ │ │ │ │ │ or *.ivb (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ - 8 IV : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 IV : DRAFT January 7, 2024 │ │ │ │ │ │ 2. int IV_readFromFormattedFile ( IV *iv, FILE *fp ) ; │ │ │ │ │ │ This method reads in an IV object from a formatted file. If there are no errors in reading the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fscanf, zero is returned. │ │ │ │ │ │ Error checking: If iv or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 3. int IV_readFromBinaryFile ( IV *iv, FILE *fp ) ; │ │ │ │ │ │ This method reads in an IV object from a binary file. If there are no errors in reading the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fread, zero is returned. │ │ │ │ │ │ @@ -274,15 +274,15 @@ │ │ │ │ │ │ This method writes the header and statistics to a file. The value 1 is returned. │ │ │ │ │ │ Error checking: If iv or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 9. int IV_fp80 ( IV *iv, FILE *fp, int column, int *pierr ) ; │ │ │ │ │ │ This method is just a wrapper around the IVfp80() method for an int method. The entries │ │ │ │ │ │ in the vector are found on lines with eighty columns and are separated by a whitespace. The │ │ │ │ │ │ value 1 is returned. │ │ │ │ │ │ Error checking: If iv or fp or pierr are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - IV : DRAFT February 8, 2025 9 │ │ │ │ │ │ + IV : DRAFT January 7, 2024 9 │ │ │ │ │ │ 10. int IV_writeForMatlab ( IV *iv, char *name, FILE *fp ) ; │ │ │ │ │ │ This method writes the entries of the vector to a file suitable to be read by Matlab. The │ │ │ │ │ │ character string name is the name of the vector, e.g, if name = "A", then we have lines of the │ │ │ │ │ │ form │ │ │ │ │ │ A(1) = 32 ; │ │ │ │ │ │ A(2) = -433 ; │ │ │ │ │ │ ... │ │ │ ├── ./usr/share/doc/spooles-doc/IVL.ps.gz │ │ │ │ ├── IVL.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o IVL.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1856,21 +1856,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2054,88 +2053,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3823,16 +3817,16 @@ │ │ │ │ │ @start /Fa 133[50 59 3[62 44 44 46 1[62 56 62 93 31 2[31 │ │ │ │ │ 62 56 1[51 62 50 1[54 11[86 5[84 1[106 67 2[42 6[80 10[56 │ │ │ │ │ 56 56 56 56 56 56 2[31 46[{}32 99.6264 /CMBX12 rf /Fb │ │ │ │ │ 169[62 9[62 2[62 73[{}3 119.552 /CMTT12 rf /Fc 152[45 │ │ │ │ │ 45 99[71 2[{}3 90.9091 /CMSY10 rf /Fd 137[42 49 30 37 │ │ │ │ │ 38 1[46 46 51 1[23 42 1[28 46 42 1[42 46 42 1[46 12[65 │ │ │ │ │ 1[66 11[59 62 69 2[68 6[28 58[{}24 90.9091 /CMTI10 rf │ │ │ │ │ -/Fe 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 │ │ │ │ │ -2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf │ │ │ │ │ +/Fe 134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 │ │ │ │ │ +1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf │ │ │ │ │ %DVIPSBitmapFont: Ff tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3948,17 +3942,17 @@ │ │ │ │ │ b(Absolutely)31 b(no)f(free'ing)h(of)f(data)h(is)g(done)f(when)f(the)i │ │ │ │ │ Fi(IVL)e Fj(ob)5 b(ject)32 b(is)e(free'd.)227 5407 y(The)g(storage)i │ │ │ │ │ (managemen)m(t)g(is)e(handled)g(b)m(y)g Fi(IVL)p 1972 │ │ │ │ │ 5407 V 34 w(setList\(\))d Fj(and)j Fi(IVL)p 2786 5407 │ │ │ │ │ V 34 w(setPointerToList\(\))p Fj(.)1927 5656 y(1)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1163 4 v │ │ │ │ │ -1345 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2738 100 V 137 399 a Ff(\210)45 b Fi(int)i(maxnlist)28 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1182 4 v │ │ │ │ │ +1364 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2719 100 V 137 399 a Ff(\210)45 b Fi(int)i(maxnlist)28 │ │ │ │ │ b Fj(:)41 b(maxim)m(um)30 b(n)m(um)m(b)s(er)f(of)i(lists.)227 │ │ │ │ │ 543 y Fi(int)47 b(nlist)29 b Fj(:)41 b(n)m(um)m(b)s(er)29 │ │ │ │ │ b(of)h(lists.)227 688 y(W)-8 b(e)33 b(ma)m(y)g(not)f(kno)m(w)g(ho)m(w)g │ │ │ │ │ (man)m(y)g(lists)g(w)m(e)h(will)f(need)g(for)f(the)h(ob)5 │ │ │ │ │ b(ject)33 b(|)f Fi(maxnlist)d Fj(is)j(the)h(dimension)227 │ │ │ │ │ 801 y(of)j(the)f Fi(sizes[])e Fj(and)i Fi(p)p 1102 801 │ │ │ │ │ 29 4 v 34 w(vec[])e Fj(arra)m(ys)j(and)f Fi(nlist)e Fj(is)i(the)h │ │ │ │ │ @@ -4025,17 +4019,17 @@ │ │ │ │ │ b Fi(tsize)f Fj(are)i(zero,)g Fi(incr)e Fj(is)i Fi(1024)p │ │ │ │ │ Fj(,)e(and)h Fi(sizes)p Fj(,)f Fi(p)p 2126 5262 V 34 │ │ │ │ │ w(vec)h Fj(and)g Fi(chunk)e Fj(are)j Fi(NULL)p Fj(.)227 │ │ │ │ │ 5407 y Fd(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 │ │ │ │ │ b Fi(ivl)g Fj(is)g Fi(NULL)p Fj(,)g(an)g(error)g(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)g(the)g(program)g(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1163 4 v 1344 100 a Fi(IVL)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2690 100 V 1163 w Fj(3)111 399 y(3.)46 b Fi(void)h(IVL_clearData)d(\()k │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1182 4 v 1363 100 a Fi(IVL)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2671 100 V 1182 w Fj(3)111 399 y(3.)46 b Fi(void)h(IVL_clearData)d(\()k │ │ │ │ │ (IVL)e(*ivl)h(\))h(;)227 566 y Fj(This)32 b(metho)s(d)f(clears)i(an)m │ │ │ │ │ (y)g(data)f(allo)s(cated)j(b)m(y)d(this)g(ob)5 b(ject)33 │ │ │ │ │ b(and)e(then)h(sets)h(the)f(default)g(\014elds)g(with)g(a)227 │ │ │ │ │ 679 y(call)j(to)g Fi(IVL)p 662 679 29 4 v 33 w(setDefaultFields\(\))p │ │ │ │ │ Fj(.)46 b(An)m(y)34 b(storage)i(held)d(b)m(y)h(the)g │ │ │ │ │ Fi(Ichunk)e Fj(structures)h(is)h(free'd,)h(and)227 792 │ │ │ │ │ y(if)c Fi(sizes)e Fj(or)h Fi(p)p 745 792 V 34 w(vec)f │ │ │ │ │ @@ -4083,27 +4077,27 @@ │ │ │ │ │ (int)g(incr)f(\))i(;)227 5126 y Fj(This)30 b(metho)s(d)g(sets)g(the)h │ │ │ │ │ (storage)h(incremen)m(t)f(to)g Fi(incr)p Fj(.)227 5294 │ │ │ │ │ y Fd(Err)-5 b(or)27 b(che)-5 b(cking:)36 b Fj(If)21 b │ │ │ │ │ Fi(ivl)g Fj(is)i Fi(NULL)e Fj(or)h Fi(incr)f Fj(is)h(negativ)m(e,)k(an) │ │ │ │ │ c(error)f(message)j(is)e(prin)m(ted)f(and)h(the)g(program)227 │ │ │ │ │ 5407 y(exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1163 4 v │ │ │ │ │ -1345 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2738 100 V 0 399 a Fa(1.2.3)112 b(Initialization)39 │ │ │ │ │ -b(and)f(resizing)g(metho)s(ds)111 606 y Fj(1.)46 b Fi(void)h(IVL_init1) │ │ │ │ │ -e(\()j(IVL)f(*ivl,)f(int)h(type,)f(int)h(maxnlist)f(\))h(;)227 │ │ │ │ │ -767 y Fj(This)34 b(metho)s(d)g(is)g(used)g(when)f(only)i(the)f(n)m(um)m │ │ │ │ │ -(b)s(er)f(of)i(lists)g(is)f(kno)m(wn.)52 b(An)m(y)35 │ │ │ │ │ -b(previous)e(data)j(is)e(cleared)227 879 y(with)c(a)f(call)i(to)g │ │ │ │ │ -Fi(IVL)p 935 879 29 4 v 33 w(clearData\(\))p Fj(.)37 │ │ │ │ │ -b(The)30 b Fi(type)e Fj(\014eld)h(is)h(set.)41 b(If)29 │ │ │ │ │ -b Fi(maxnlist)45 b(>)j(0)p Fj(,)29 b(storage)i(is)f(allo)s(cated)227 │ │ │ │ │ -992 y(for)g(the)h Fi(sizes[])d Fj(and)i Fi(p)p 1118 992 │ │ │ │ │ -V 34 w(vec[])f Fj(arra)m(ys)i(and)f Fi(nlist)f Fj(is)h(set)h(to)g │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1182 4 v │ │ │ │ │ +1364 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2719 100 V 0 399 a Fa(1.2.3)112 b(Initialization)39 b(and)f(resizing)g │ │ │ │ │ +(metho)s(ds)111 606 y Fj(1.)46 b Fi(void)h(IVL_init1)e(\()j(IVL)f │ │ │ │ │ +(*ivl,)f(int)h(type,)f(int)h(maxnlist)f(\))h(;)227 767 │ │ │ │ │ +y Fj(This)34 b(metho)s(d)g(is)g(used)g(when)f(only)i(the)f(n)m(um)m(b)s │ │ │ │ │ +(er)f(of)i(lists)g(is)f(kno)m(wn.)52 b(An)m(y)35 b(previous)e(data)j │ │ │ │ │ +(is)e(cleared)227 879 y(with)c(a)f(call)i(to)g Fi(IVL)p │ │ │ │ │ +935 879 29 4 v 33 w(clearData\(\))p Fj(.)37 b(The)30 │ │ │ │ │ +b Fi(type)e Fj(\014eld)h(is)h(set.)41 b(If)29 b Fi(maxnlist)45 │ │ │ │ │ +b(>)j(0)p Fj(,)29 b(storage)i(is)f(allo)s(cated)227 992 │ │ │ │ │ +y(for)g(the)h Fi(sizes[])d Fj(and)i Fi(p)p 1118 992 V │ │ │ │ │ +34 w(vec[])f Fj(arra)m(ys)i(and)f Fi(nlist)f Fj(is)h(set)h(to)g │ │ │ │ │ Fi(maxnlist)p Fj(.)227 1153 y Fd(Err)-5 b(or)33 b(che)-5 │ │ │ │ │ b(cking:)39 b Fj(If)28 b Fi(ivl)g Fj(is)g Fi(NULL)g Fj(or)g │ │ │ │ │ Fi(type)g Fj(is)g(in)m(v)-5 b(alid)30 b(or)e Fi(maxnlist)e │ │ │ │ │ Fj(is)j(negativ)m(e,)j(an)c(error)g(message)i(is)227 │ │ │ │ │ 1266 y(prin)m(ted)g(and)g(the)h(program)f(exits.)111 │ │ │ │ │ 1476 y(2.)46 b Fi(void)h(IVL_init2)e(\()j(IVL)f(*ivl,)f(int)h(type,)f │ │ │ │ │ (int)h(nlist,)f(int)h(tsize)f(\))i(;)227 1637 y Fj(This)30 │ │ │ │ │ @@ -4172,17 +4166,17 @@ │ │ │ │ │ 5085 y Fd(Err)-5 b(or)32 b(che)-5 b(cking:)40 b Fj(If)27 │ │ │ │ │ b Fi(ivl)h Fj(is)g Fi(NULL)f Fj(or)i(if)f Fi(newmaxnlist)d │ │ │ │ │ Fj(is)k(negativ)m(e,)i(an)d(error)g(message)h(is)g(prin)m(ted)f(and)227 │ │ │ │ │ 5198 y(the)j(program)f(exits.)111 5407 y(6.)46 b Fi(void)h │ │ │ │ │ (IVL_setNlist)d(\()k(IVL)f(*ivl,)f(int)h(newnlist)f(\))h(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1163 4 v 1344 100 a Fi(IVL)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2690 100 V 1163 w Fj(5)227 399 y(This)39 b(metho)s(d)f(is)h(used)g(to)g │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1182 4 v 1363 100 a Fi(IVL)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2671 100 V 1182 w Fj(5)227 399 y(This)39 b(metho)s(d)f(is)h(used)g(to)g │ │ │ │ │ (c)m(hange)i(the)e(n)m(um)m(b)s(er)f(of)h(lists.)68 b(If)38 │ │ │ │ │ b Fi(newnlist)46 b(>)h(maxnlist)p Fj(,)40 b(storage)g(for)227 │ │ │ │ │ 511 y(the)h(lists)g(is)f(increased)g(via)h(a)g(call)g(to)g(the)g │ │ │ │ │ Fi(IVL)p 1956 511 29 4 v 33 w(setMaxnlist\(\))c Fj(metho)s(d.)70 │ │ │ │ │ b(Then)39 b Fi(nlist)g Fj(is)h(set)h(to)227 624 y Fi(newnlist)p │ │ │ │ │ Fj(.)227 852 y Fd(Err)-5 b(or)39 b(che)-5 b(cking:)50 │ │ │ │ │ b Fj(If)35 b Fi(ivl)g Fj(is)g Fi(NULL)p Fj(,)g(or)g(if)g │ │ │ │ │ @@ -4225,28 +4219,28 @@ │ │ │ │ │ 5294 y Fj(This)39 b(metho)s(d)f(sets)i(the)g(size)g(and)e(\(p)s │ │ │ │ │ (ossibly\))i(p)s(oin)m(ter)f(to)h(a)g(list)f(of)h(en)m(tries.)68 │ │ │ │ │ b(The)39 b(b)s(eha)m(vior)g(of)h(the)227 5407 y(metho)s(d)30 │ │ │ │ │ b(dep)s(ends)f(on)h(the)g(t)m(yp)s(e)h(of)g(the)f Fi(ivl)g │ │ │ │ │ Fj(ob)5 b(ject.)41 b(Here)31 b(is)f(the)h(\015o)m(w)f(c)m(hart:)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fj(6)p 136 100 1163 4 v │ │ │ │ │ -1345 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2738 100 V 605 311 2918 4 v 605 2506 4 │ │ │ │ │ -2196 v 663 414 a Fj(if)g Fi(ilist)46 b(>=)h(maxnlist)28 │ │ │ │ │ -b Fj(then)898 527 y(the)j(n)m(um)m(b)s(er)e(of)h(lists)h(is)g │ │ │ │ │ -(increased)f(via)h(a)g(call)h(to)f Fi(IVL)p 2816 527 │ │ │ │ │ -29 4 v 33 w(setMaxnlist\(\))663 640 y Fj(endif)663 753 │ │ │ │ │ -y(if)g Fi(ilist)46 b(>=)h(nlist)29 b Fj(then)898 866 │ │ │ │ │ -y Fi(nlist)g Fj(is)i(increased)663 979 y(endif)663 1092 │ │ │ │ │ -y(if)g Fi(isize)46 b(=)i(0)30 b Fj(then)898 1205 y(release)i(the)e │ │ │ │ │ -(storage)i(for)f(that)f(list,)i(reclaim)f(storage)h(if)e(p)s(ossible) │ │ │ │ │ -663 1318 y(else)i(if)e Fi(type)f Fj(is)i Fi(IVL)p 1382 │ │ │ │ │ -1318 V 33 w(UNKNOWN)d Fj(then)898 1431 y(set)j(the)g(p)s(oin)m(ter)663 │ │ │ │ │ -1544 y(else)898 1656 y(if)g(the)f(presen)m(t)h(size)g(of)f(list)h │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fj(6)p 136 100 1182 4 v │ │ │ │ │ +1364 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2719 100 V 605 311 2918 4 v 605 2506 4 2196 v 663 414 │ │ │ │ │ +a Fj(if)g Fi(ilist)46 b(>=)h(maxnlist)28 b Fj(then)898 │ │ │ │ │ +527 y(the)j(n)m(um)m(b)s(er)e(of)h(lists)h(is)g(increased)f(via)h(a)g │ │ │ │ │ +(call)h(to)f Fi(IVL)p 2816 527 29 4 v 33 w(setMaxnlist\(\))663 │ │ │ │ │ +640 y Fj(endif)663 753 y(if)g Fi(ilist)46 b(>=)h(nlist)29 │ │ │ │ │ +b Fj(then)898 866 y Fi(nlist)g Fj(is)i(increased)663 │ │ │ │ │ +979 y(endif)663 1092 y(if)g Fi(isize)46 b(=)i(0)30 b │ │ │ │ │ +Fj(then)898 1205 y(release)i(the)e(storage)i(for)f(that)f(list,)i │ │ │ │ │ +(reclaim)f(storage)h(if)e(p)s(ossible)663 1318 y(else)i(if)e │ │ │ │ │ +Fi(type)f Fj(is)i Fi(IVL)p 1382 1318 V 33 w(UNKNOWN)d │ │ │ │ │ +Fj(then)898 1431 y(set)j(the)g(p)s(oin)m(ter)663 1544 │ │ │ │ │ +y(else)898 1656 y(if)g(the)f(presen)m(t)h(size)g(of)f(list)h │ │ │ │ │ Fi(ilist)e Fj(is)i(smaller)g(than)f Fi(isize)f Fj(then)1133 │ │ │ │ │ 1769 y(get)j(new)d(storage)j(for)e(a)h(new)f(larger)h(list)898 │ │ │ │ │ 1882 y(endif)898 1995 y(set)g(the)g(size)898 2108 y(if)g │ │ │ │ │ Fi(ivec)e Fj(is)h(not)h Fi(NULL)e Fj(then)1133 2221 y(cop)m(y)i(the)g │ │ │ │ │ (en)m(tries)898 2334 y(endif)663 2447 y(endif)p 3519 │ │ │ │ │ 2506 4 2196 v 605 2509 2918 4 v 227 2720 a Fd(Err)-5 │ │ │ │ │ b(or)28 b(che)-5 b(cking:)37 b Fj(If)23 b Fi(ivl)g Fj(is)g │ │ │ │ │ @@ -4278,17 +4272,17 @@ │ │ │ │ │ y(int)g(IVL_sum)f(\()h(IVL)g(*ivl)g(\))g(;)227 5246 y │ │ │ │ │ Fj(These)30 b(metho)s(ds)g(return)f(some)i(simple)f(information)h(ab)s │ │ │ │ │ (out)f(the)h(ob)5 b(ject.)227 5407 y Fd(Err)-5 b(or)34 │ │ │ │ │ b(che)-5 b(cking:)40 b Fj(If)30 b Fi(ivl)g Fj(is)g Fi(NULL)f │ │ │ │ │ Fj(then)i(an)f(error)g(message)h(is)g(prin)m(ted)f(and)f(the)i(program) │ │ │ │ │ f(exits.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1163 4 v 1344 100 a Fi(IVL)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2690 100 V 1163 w Fj(7)111 399 y(3.)46 b Fi(int)h(IVL_sortUp)e(\()j │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1182 4 v 1363 100 a Fi(IVL)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2671 100 V 1182 w Fj(7)111 399 y(3.)46 b Fi(int)h(IVL_sortUp)e(\()j │ │ │ │ │ (IVL)f(*ivl)f(\))i(;)227 559 y Fj(This)30 b(metho)s(d)g(sorts)g(eac)m │ │ │ │ │ (h)i(list)f(in)m(to)g(ascending)g(order.)227 720 y Fd(Err)-5 │ │ │ │ │ b(or)28 b(che)-5 b(cking:)37 b Fj(If)23 b Fi(ivl)g Fj(is)g │ │ │ │ │ Fi(NULL)g Fj(or)g Fi(nlist)46 b(<)i(0)23 b Fj(then)g(an)h(error)f │ │ │ │ │ (message)i(is)e(prin)m(ted)g(and)g(the)h(program)227 │ │ │ │ │ 833 y(exits.)111 1042 y(4.)46 b Fi(int)h(*)h(IVL_equivMap1)c(\()j(IVL)g │ │ │ │ │ (*ivl)g(\))g(;)227 1155 y(IV)95 b(*)48 b(IVL_equivMap2)c(\()j(IVL)g │ │ │ │ │ @@ -4356,49 +4350,48 @@ │ │ │ │ │ b(so)227 5246 y(w)m(e)31 b(create)h(and)e(return)f(a)i(new)f │ │ │ │ │ Fi(IVL)f Fj(ob)5 b(ject)31 b(that)g(con)m(tains)h(en)m(tries)f(for)f │ │ │ │ │ (the)h(uncompressed)e(graph.)227 5407 y Fd(Err)-5 b(or)30 │ │ │ │ │ b(che)-5 b(cking:)38 b Fj(If)26 b Fi(ivl)f Fj(or)h Fi(eqmapIV)e │ │ │ │ │ Fj(is)i Fi(NULL)p Fj(,)f(an)h(error)f(message)i(is)f(prin)m(ted)g(and)f │ │ │ │ │ (the)h(program)g(exits.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fj(8)p 136 100 1163 4 v │ │ │ │ │ -1345 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2738 100 V 0 399 a Fa(1.2.6)112 b(Miscellaneous)40 │ │ │ │ │ -b(metho)s(ds)111 598 y Fj(1.)46 b Fi(IVL)h(*)h(IVL_make9P)d(\()i(int)g │ │ │ │ │ -(n1,)g(int)g(n2,)g(int)g(ncomp)f(\))h(;)227 752 y Fj(This)35 │ │ │ │ │ -b(metho)s(d)g(returns)f(an)h Fi(IVL)f Fj(ob)5 b(ject)36 │ │ │ │ │ -b(that)g(con)m(tains)h(the)e(full)g(adjacency)i(structure)d(for)h(a)h │ │ │ │ │ -(9-p)s(oin)m(t)227 865 y(op)s(erator)31 b(on)f(a)h Fi(n1)20 │ │ │ │ │ -b Fc(\002)g Fi(n2)29 b Fj(grid)h(with)g Fi(ncomp)f Fj(comp)s(onen)m(ts) │ │ │ │ │ -i(at)g(eac)m(h)h(grid)e(p)s(oin)m(t.)227 1018 y Fd(Err)-5 │ │ │ │ │ -b(or)37 b(che)-5 b(cking:)45 b Fj(If)32 b Fi(n1)p Fj(,)h │ │ │ │ │ -Fi(n2)g Fj(or)g Fi(ncomp)e Fj(is)i(less)g(than)g(or)g(equal)g(to)h │ │ │ │ │ -(zero,)g(an)f(error)f(message)i(is)f(prin)m(ted)227 1131 │ │ │ │ │ -y(and)d(the)h(program)f(exits.)111 1325 y(2.)46 b Fi(IVL)h(*)h │ │ │ │ │ -(IVL_make13P)c(\()k(int)f(n1,)g(int)g(n2)g(\))g(;)227 │ │ │ │ │ -1479 y Fj(This)32 b(metho)s(d)f(returns)g(an)h Fi(IVL)f │ │ │ │ │ -Fj(ob)5 b(ject)33 b(that)g(con)m(tains)g(the)f(full)g(adjacency)h │ │ │ │ │ -(structure)e(for)h(a)h(13-p)s(oin)m(t)227 1592 y(t)m(w)m(o)f │ │ │ │ │ -(dimensional)e(op)s(erator)h(on)f(a)h Fi(n1)20 b Fc(\002)g │ │ │ │ │ -Fi(n2)30 b Fj(grid.)227 1745 y Fd(Err)-5 b(or)35 b(che)-5 │ │ │ │ │ -b(cking:)41 b Fj(If)30 b Fi(n1)g Fj(or)h Fi(n2)g Fj(is)f(less)i(than)e │ │ │ │ │ -(or)h(equal)g(to)h(zero,)g(an)f(error)f(message)i(is)f(prin)m(ted)f │ │ │ │ │ -(and)h(the)227 1858 y(program)f(exits.)111 2052 y(3.)46 │ │ │ │ │ -b Fi(IVL)h(*)h(IVL_make5P)d(\()i(int)g(n1,)g(int)g(n2)g(\))g(;)227 │ │ │ │ │ -2206 y Fj(This)35 b(metho)s(d)g(returns)f(an)h Fi(IVL)f │ │ │ │ │ -Fj(ob)5 b(ject)36 b(that)g(con)m(tains)h(the)e(full)g(adjacency)i │ │ │ │ │ -(structure)d(for)h(a)h(5-p)s(oin)m(t)227 2318 y(t)m(w)m(o)c │ │ │ │ │ -(dimensional)e(op)s(erator)h(on)f(a)h Fi(n1)20 b Fc(\002)g │ │ │ │ │ -Fi(n2)30 b Fj(grid.)227 2472 y Fd(Err)-5 b(or)35 b(che)-5 │ │ │ │ │ -b(cking:)41 b Fj(If)30 b Fi(n1)g Fj(or)h Fi(n2)g Fj(is)f(less)i(than)e │ │ │ │ │ -(or)h(equal)g(to)h(zero,)g(an)f(error)f(message)i(is)f(prin)m(ted)f │ │ │ │ │ -(and)h(the)227 2585 y(program)f(exits.)111 2779 y(4.)46 │ │ │ │ │ -b Fi(IVL)h(*)h(IVL_make27P)c(\()k(int)f(n1,)g(int)g(n2,)f(int)h(ncomp)g │ │ │ │ │ -(\))g(;)227 2932 y Fj(This)32 b(metho)s(d)f(returns)g(an)h │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fj(8)p 136 100 1182 4 v │ │ │ │ │ +1364 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2719 100 V 0 399 a Fa(1.2.6)112 b(Miscellaneous)40 b(metho)s(ds)111 │ │ │ │ │ +598 y Fj(1.)46 b Fi(IVL)h(*)h(IVL_make9P)d(\()i(int)g(n1,)g(int)g(n2,)g │ │ │ │ │ +(int)g(ncomp)f(\))h(;)227 752 y Fj(This)35 b(metho)s(d)g(returns)f(an)h │ │ │ │ │ +Fi(IVL)f Fj(ob)5 b(ject)36 b(that)g(con)m(tains)h(the)e(full)g │ │ │ │ │ +(adjacency)i(structure)d(for)h(a)h(9-p)s(oin)m(t)227 │ │ │ │ │ +865 y(op)s(erator)31 b(on)f(a)h Fi(n1)20 b Fc(\002)g │ │ │ │ │ +Fi(n2)29 b Fj(grid)h(with)g Fi(ncomp)f Fj(comp)s(onen)m(ts)i(at)g(eac)m │ │ │ │ │ +(h)h(grid)e(p)s(oin)m(t.)227 1018 y Fd(Err)-5 b(or)37 │ │ │ │ │ +b(che)-5 b(cking:)45 b Fj(If)32 b Fi(n1)p Fj(,)h Fi(n2)g │ │ │ │ │ +Fj(or)g Fi(ncomp)e Fj(is)i(less)g(than)g(or)g(equal)g(to)h(zero,)g(an)f │ │ │ │ │ +(error)f(message)i(is)f(prin)m(ted)227 1131 y(and)d(the)h(program)f │ │ │ │ │ +(exits.)111 1325 y(2.)46 b Fi(IVL)h(*)h(IVL_make13P)c(\()k(int)f(n1,)g │ │ │ │ │ +(int)g(n2)g(\))g(;)227 1479 y Fj(This)32 b(metho)s(d)f(returns)g(an)h │ │ │ │ │ Fi(IVL)f Fj(ob)5 b(ject)33 b(that)g(con)m(tains)g(the)f(full)g │ │ │ │ │ +(adjacency)h(structure)e(for)h(a)h(13-p)s(oin)m(t)227 │ │ │ │ │ +1592 y(t)m(w)m(o)f(dimensional)e(op)s(erator)h(on)f(a)h │ │ │ │ │ +Fi(n1)20 b Fc(\002)g Fi(n2)30 b Fj(grid.)227 1745 y Fd(Err)-5 │ │ │ │ │ +b(or)35 b(che)-5 b(cking:)41 b Fj(If)30 b Fi(n1)g Fj(or)h │ │ │ │ │ +Fi(n2)g Fj(is)f(less)i(than)e(or)h(equal)g(to)h(zero,)g(an)f(error)f │ │ │ │ │ +(message)i(is)f(prin)m(ted)f(and)h(the)227 1858 y(program)f(exits.)111 │ │ │ │ │ +2052 y(3.)46 b Fi(IVL)h(*)h(IVL_make5P)d(\()i(int)g(n1,)g(int)g(n2)g │ │ │ │ │ +(\))g(;)227 2206 y Fj(This)35 b(metho)s(d)g(returns)f(an)h │ │ │ │ │ +Fi(IVL)f Fj(ob)5 b(ject)36 b(that)g(con)m(tains)h(the)e(full)g │ │ │ │ │ +(adjacency)i(structure)d(for)h(a)h(5-p)s(oin)m(t)227 │ │ │ │ │ +2318 y(t)m(w)m(o)c(dimensional)e(op)s(erator)h(on)f(a)h │ │ │ │ │ +Fi(n1)20 b Fc(\002)g Fi(n2)30 b Fj(grid.)227 2472 y Fd(Err)-5 │ │ │ │ │ +b(or)35 b(che)-5 b(cking:)41 b Fj(If)30 b Fi(n1)g Fj(or)h │ │ │ │ │ +Fi(n2)g Fj(is)f(less)i(than)e(or)h(equal)g(to)h(zero,)g(an)f(error)f │ │ │ │ │ +(message)i(is)f(prin)m(ted)f(and)h(the)227 2585 y(program)f(exits.)111 │ │ │ │ │ +2779 y(4.)46 b Fi(IVL)h(*)h(IVL_make27P)c(\()k(int)f(n1,)g(int)g(n2,)f │ │ │ │ │ +(int)h(ncomp)g(\))g(;)227 2932 y Fj(This)32 b(metho)s(d)f(returns)g(an) │ │ │ │ │ +h Fi(IVL)f Fj(ob)5 b(ject)33 b(that)g(con)m(tains)g(the)f(full)g │ │ │ │ │ (adjacency)h(structure)e(for)h(a)h(27-p)s(oin)m(t)227 │ │ │ │ │ 3045 y(op)s(erator)e(on)f(a)h Fi(n1)20 b Fc(\002)g Fi(n2)f │ │ │ │ │ Fc(\002)h Fi(n3)30 b Fj(grid)g(with)g Fi(ncomp)f Fj(comp)s(onen)m(ts)h │ │ │ │ │ (at)i(eac)m(h)f(grid)f(p)s(oin)m(t.)227 3199 y Fd(Err)-5 │ │ │ │ │ b(or)29 b(che)-5 b(cking:)37 b Fj(If)24 b Fi(n1)p Fj(,)i │ │ │ │ │ Fi(n2)p Fj(,)f Fi(n3)f Fj(or)h Fi(ncomp)e Fj(is)i(less)g(than)f(or)h │ │ │ │ │ (equal)g(to)g(zero,)i(an)e(error)f(message)i(is)e(prin)m(ted)227 │ │ │ │ │ @@ -4431,17 +4424,17 @@ │ │ │ │ │ 5254 y(data,)h(the)e(v)-5 b(alue)31 b Fi(1)f Fj(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fi(fscanf)p Fj(,)f(zero)i(is)g(returned.)227 5407 y Fd(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b Fi(ivl)g Fj(or)g │ │ │ │ │ Fi(fp)g Fj(are)h Fi(NULL)e Fj(an)h(error)g(message)i(is)e(prin)m(ted)g │ │ │ │ │ (and)g(zero)h(is)f(returned.)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1163 4 v 1344 100 a Fi(IVL)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2690 100 V 1163 w Fj(9)111 399 y(3.)46 b Fi(int)h │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1182 4 v 1363 100 a Fi(IVL)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2671 100 V 1182 w Fj(9)111 399 y(3.)46 b Fi(int)h │ │ │ │ │ (IVL_readFromBinaryFile)42 b(\()47 b(IVL)g(*ivl,)g(FILE)f(*fp)h(\))h(;) │ │ │ │ │ 227 556 y Fj(This)25 b(metho)s(d)g(reads)g(an)g Fi(IVL)g │ │ │ │ │ Fj(ob)5 b(ject)26 b(from)f(a)h(binary)f(\014le.)39 b(If)25 │ │ │ │ │ b(there)h(are)f(no)h(errors)f(in)g(reading)g(the)h(data,)227 │ │ │ │ │ 669 y(the)31 b(v)-5 b(alue)31 b Fi(1)f Fj(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fi(fread)p Fj(,)f(zero)i(is)g(returned.)227 826 y Fd(Err)-5 │ │ │ │ │ @@ -4508,19 +4501,19 @@ │ │ │ │ │ Fi(IVL)e Fj(ob)5 b(ject)29 b(from)e Fi(inFile)e Fj(and)i(writes)h(out)g │ │ │ │ │ (the)f(ob)5 b(ject)29 b(to)f Fi(outFile)337 5294 y Ff(\210)45 │ │ │ │ │ b Fj(The)28 b Fi(msglvl)f Fj(parameter)i(determines)g(the)g(amoun)m(t)g │ │ │ │ │ (of)f(output)h(|)f(taking)i Fi(msglvl)46 b(>=)h(3)28 │ │ │ │ │ b Fj(means)427 5407 y(the)j Fi(IVL)e Fj(ob)5 b(ject)32 │ │ │ │ │ b(is)e(written)g(to)i(the)e(message)i(\014le.)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fj(10)p 182 100 1140 4 │ │ │ │ │ -v 1322 w Fi(IVL)30 b Fe(:)g Fd(DRAFT)h Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2760 100 V 337 399 a Ff(\210)45 b Fj(The)33 │ │ │ │ │ -b Fi(msgFile)e Fj(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ -(if)f Fi(msgFile)e Fj(is)i Fi(stdout)p Fj(,)g(then)g(the)427 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fj(10)p 182 100 1159 4 │ │ │ │ │ +v 1341 w Fi(IVL)30 b Fe(:)g Fd(DRAFT)h Fe(Jan)m(uary)f(7,)h(2024)p │ │ │ │ │ +2741 100 V 337 399 a Ff(\210)45 b Fj(The)33 b Fi(msgFile)e │ │ │ │ │ +Fj(parameter)j(determines)f(the)h(message)g(\014le)f(|)h(if)f │ │ │ │ │ +Fi(msgFile)e Fj(is)i Fi(stdout)p Fj(,)g(then)g(the)427 │ │ │ │ │ 511 y(message)27 b(\014le)f(is)g Fd(stdout)p Fj(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Fd(app)-5 b(end)28 │ │ │ │ │ b Fj(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 624 │ │ │ │ │ y(data.)337 770 y Ff(\210)45 b Fj(The)25 b Fi(inFile)e │ │ │ │ │ Fj(parameter)i(is)g(the)g(input)f(\014le)g(for)h(the)g │ │ │ │ │ Fi(IVL)f Fj(ob)5 b(ject.)40 b(It)25 b(m)m(ust)f(b)s(e)g(of)h(the)g │ │ │ │ │ (form)g Fi(*.ivlf)427 883 y Fj(or)31 b Fi(*.ivlb)p Fj(.)39 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -22,15 +22,15 @@ │ │ │ │ │ │ Each list is allocated separately using the IVinit() function. When the IVL object is │ │ │ │ │ │ free’d, each list is free’d separately using the IVfree() function. │ │ │ │ │ │ – IVL UNKNOWN │ │ │ │ │ │ This storage mode is available for the cases where storage for a list is aliased to another │ │ │ │ │ │ location. Absolutely no free’ing of data is done when the IVL object is free’d. │ │ │ │ │ │ The storage management is handled by IVL setList() and IVL setPointerToList(). │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 IVL : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 IVL : DRAFT January 7, 2024 │ │ │ │ │ │ • int maxnlist : maximum number of lists. │ │ │ │ │ │ int nlist : number of lists. │ │ │ │ │ │ We may not know how many lists we will need for the object — maxnlist is the dimension │ │ │ │ │ │ of the sizes[] and p vec[] arrays and nlist is the present number of active lists. When │ │ │ │ │ │ we initialize the object using one of the IVL init{1,2,3}() methods, we set nlist equal to │ │ │ │ │ │ maxnlist. We resize the object using IVL setMaxnlist(). │ │ │ │ │ │ • int tsize : total number of list entries. │ │ │ │ │ │ @@ -57,15 +57,15 @@ │ │ │ │ │ │ 1. IVL * IVL_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the IVL structure and then sets the default fields by │ │ │ │ │ │ a call to IVL setDefaultFields(). │ │ │ │ │ │ 2. void IVL_setDefaultFields ( IVL *ivl ) ; │ │ │ │ │ │ This method sets the default fields of the object — type = IVL NOTYPE, maxnlist, nlist │ │ │ │ │ │ and tsize are zero, incr is 1024, and sizes, p vec and chunk are NULL. │ │ │ │ │ │ Error checking: If ivl is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - IVL : DRAFT February 8, 2025 3 │ │ │ │ │ │ + IVL : DRAFT January 7, 2024 3 │ │ │ │ │ │ 3. void IVL_clearData ( IVL *ivl ) ; │ │ │ │ │ │ This method clears any data allocated by this object and then sets the default fields with a │ │ │ │ │ │ call to IVL setDefaultFields(). Any storage held by the Ichunk structures is free’d, and │ │ │ │ │ │ if sizes or p vec are not NULL, they are free’d. │ │ │ │ │ │ Error checking: If ivl is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void IVL_free ( IVL *ivl ) ; │ │ │ │ │ │ This method releases any storage by a call to IVL clearData() then free’s the storage for │ │ │ │ │ │ @@ -87,15 +87,15 @@ │ │ │ │ │ │ 5. int IVL_incr ( IVL *ivl ) ; │ │ │ │ │ │ This method returns incr, the storage increment. │ │ │ │ │ │ Error checking: If ivl is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 6. int IVL_setincr ( IVL *ivl, int incr ) ; │ │ │ │ │ │ This method sets the storage increment to incr. │ │ │ │ │ │ Error checking: If ivl is NULL or incr is negative, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - 4 IVL : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 IVL : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.3 Initialization and resizing methods │ │ │ │ │ │ 1. void IVL_init1 ( IVL *ivl, int type, int maxnlist ) ; │ │ │ │ │ │ This method is used when only the number of lists is known. Any previous data is cleared │ │ │ │ │ │ with a call to IVL clearData(). The type field is set. If maxnlist > 0, storage is allocated │ │ │ │ │ │ for the sizes[] and p vec[] arrays and nlist is set to maxnlist. │ │ │ │ │ │ Error checking: If ivl is NULL or type is invalid or maxnlist is negative, an error message is │ │ │ │ │ │ printed and the program exits. │ │ │ │ │ │ @@ -124,15 +124,15 @@ │ │ │ │ │ │ newmaxnlist == maxnlist,nothingisdone. Otherwise,newstorageforsizes[]andp vec[] │ │ │ │ │ │ is allocated, the information for the first nlist lists is copied over, and the old storage │ │ │ │ │ │ free’d. Note, maxnlist is set to newmaxnlist and nlist is set to the minimum of nlist and │ │ │ │ │ │ newmaxnlist. │ │ │ │ │ │ Error checking: If ivl is NULL or if newmaxnlist is negative, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 6. void IVL_setNlist ( IVL *ivl, int newnlist ) ; │ │ │ │ │ │ - IVL : DRAFT February 8, 2025 5 │ │ │ │ │ │ + IVL : DRAFT January 7, 2024 5 │ │ │ │ │ │ This method is used to change the number of lists. If newnlist > maxnlist, storage for │ │ │ │ │ │ the lists is increased via a call to the IVL setMaxnlist() method. Then nlist is set to │ │ │ │ │ │ newnlist. │ │ │ │ │ │ Error checking: If ivl is NULL, or if newnlist is negative, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 1.2.4 List manipulation methods │ │ │ │ │ │ 1. void IVL_listAndSize ( IVL *ivl, int ilist, int *psize, int **pivec) ; │ │ │ │ │ │ @@ -151,15 +151,15 @@ │ │ │ │ │ │ if so an error message is printed and the program exits. In method IVL firstInList(), if │ │ │ │ │ │ sizes[ilist] > 0 and p vec[ilist] = NULL, an error message is printed and the program │ │ │ │ │ │ exits. In method IVL nextInList(), if pi is not in the valid range for list ilist, an error │ │ │ │ │ │ message is printed and the program exits. │ │ │ │ │ │ 3. void IVL_setList ( IVL *ivl, int ilist, int isize, int ivec[] ) ; │ │ │ │ │ │ This method sets the size and (possibly) pointer to a list of entries. The behavior of the │ │ │ │ │ │ method depends on the type of the ivl object. Here is the flow chart: │ │ │ │ │ │ - 6 IVL : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 IVL : DRAFT January 7, 2024 │ │ │ │ │ │ if ilist >= maxnlist then │ │ │ │ │ │ the number of lists is increased via a call to IVL setMaxnlist() │ │ │ │ │ │ endif │ │ │ │ │ │ if ilist >= nlist then │ │ │ │ │ │ nlist is increased │ │ │ │ │ │ endif │ │ │ │ │ │ if isize = 0 then │ │ │ │ │ │ @@ -189,15 +189,15 @@ │ │ │ │ │ │ Error checking: If ivl is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. int IVL_min ( IVL *ivl ) ; │ │ │ │ │ │ int IVL_max ( IVL *ivl ) ; │ │ │ │ │ │ int IVL_maxListSize ( IVL *ivl ) ; │ │ │ │ │ │ int IVL_sum ( IVL *ivl ) ; │ │ │ │ │ │ These methods return some simple information about the object. │ │ │ │ │ │ Error checking: If ivl is NULL then an error message is printed and the program exits. │ │ │ │ │ │ - IVL : DRAFT February 8, 2025 7 │ │ │ │ │ │ + IVL : DRAFT January 7, 2024 7 │ │ │ │ │ │ 3. int IVL_sortUp ( IVL *ivl ) ; │ │ │ │ │ │ This method sorts each list into ascending order. │ │ │ │ │ │ Error checking: If ivl is NULL or nlist < 0 then an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 4. int * IVL_equivMap1 ( IVL *ivl ) ; │ │ │ │ │ │ IV * IVL_equivMap2 ( IVL *ivl ) ; │ │ │ │ │ │ Two lists are equivalent if their contents are identical. These methods are used to find the │ │ │ │ │ │ @@ -226,15 +226,15 @@ │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 8. IVL * IVL_expand ( IVL *ivl, IV *eqmapIV ) ; │ │ │ │ │ │ This method was created in support of a symbolic factorization. An IVL object is constructed │ │ │ │ │ │ using a compressed graph. it must be expanded to reflect the compressed graph. The number │ │ │ │ │ │ of lists does not change (there is one list per front) but the size of each list may change. so │ │ │ │ │ │ we create and return a new IVL object that contains entries for the uncompressed graph. │ │ │ │ │ │ Error checking: If ivl or eqmapIV is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 8 IVL : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 IVL : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.6 Miscellaneous methods │ │ │ │ │ │ 1. IVL * IVL_make9P ( int n1, int n2, int ncomp ) ; │ │ │ │ │ │ This method returns an IVL object that contains the full adjacency structure for a 9-point │ │ │ │ │ │ operator on a n1×n2 grid with ncomp components at each grid point. │ │ │ │ │ │ Error checking: If n1, n2 or ncomp is less than or equal to zero, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 2. IVL * IVL_make13P ( int n1, int n2 ) ; │ │ │ │ │ │ @@ -261,15 +261,15 @@ │ │ │ │ │ │ and returns the value returned from the called routine. │ │ │ │ │ │ Error checking: If ivl or fn are NULL, or if fn is not of the form *.ivlf (for a formatted file) │ │ │ │ │ │ or *.ivlb (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ 2. int IVL_readFromFormattedFile ( IVL *ivl, FILE *fp ) ; │ │ │ │ │ │ This method reads an IVL object from a formatted file. If there are no errors in reading the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fscanf, zero is returned. │ │ │ │ │ │ Error checking: If ivl or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ - IVL : DRAFT February 8, 2025 9 │ │ │ │ │ │ + IVL : DRAFT January 7, 2024 9 │ │ │ │ │ │ 3. int IVL_readFromBinaryFile ( IVL *ivl, FILE *fp ) ; │ │ │ │ │ │ This method reads an IVL object from a binary file. If there are no errors in reading the data, │ │ │ │ │ │ the value 1 is returned. If an IO error is encountered from fread, zero is returned. │ │ │ │ │ │ Error checking: If ivl or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 4. int IVL_writeToFile ( IVL *ivl, char *fn ) ; │ │ │ │ │ │ This method writes an IVL object to a file. If the the file can be opened successfully, the │ │ │ │ │ │ method calls IVL writeFromFormattedFile() or IVL writeFromBinaryFile(), closes the │ │ │ │ │ │ @@ -293,15 +293,15 @@ │ │ │ │ │ │ Error checking: If ivl or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 1.3 Driver programs for the IVL object │ │ │ │ │ │ This section contains brief descriptions of six driver programs. │ │ │ │ │ │ 1. testIO msglvl msgFile inFile outFile │ │ │ │ │ │ This driver program reads in a IVL object from inFile and writes out the object to outFile │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the IVL object is written to the message file. │ │ │ │ │ │ - 10 IVL : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 IVL : DRAFT January 7, 2024 │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The inFileparameter is the input file for the IVL object. It must be of the form *.ivlf │ │ │ │ │ │ or *.ivlb. The IVL object is read from the file via the IVL readFromFile() method. │ │ │ │ │ │ • The outFile parameter is the output file for the IVL object. It must be of the form │ │ │ │ │ │ *.ivlf or *.ivlb. The IVL object is written to the file via the IVL writeToFile() │ │ │ ├── ./usr/share/doc/spooles-doc/Ideq.ps.gz │ │ │ │ ├── Ideq.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Ideq.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1256,21 +1256,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1454,88 +1453,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3215,16 +3209,16 @@ │ │ │ │ │ cleartomark │ │ │ │ │ {restore}if │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 195[71 60[{}1 90.9091 /CMMI10 rf /Fb 133[50 │ │ │ │ │ 59 4[44 44 46 2[56 62 93 31 2[31 62 2[51 62 50 1[54 11[86 │ │ │ │ │ 5[84 5[42 6[80 13[56 56 56 56 2[31 46[{}24 99.6264 /CMBX12 │ │ │ │ │ -rf /Fc 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 │ │ │ │ │ -2[45 2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf /Fd 142[62 │ │ │ │ │ +rf /Fc 134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 │ │ │ │ │ +1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf /Fd 142[62 │ │ │ │ │ 11[62 62 26[62 73[{}4 119.552 /CMTT12 rf │ │ │ │ │ %DVIPSBitmapFont: Fe tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ @@ -3324,35 +3318,35 @@ │ │ │ │ │ b(,)31 b Fh(head)47 b(=)h(tail)e(=)i(-1)p Fi(.)0 5049 │ │ │ │ │ y Ff(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g │ │ │ │ │ Fd(Ideq)e Ff(metho)t(ds)0 5294 y Fi(This)25 b(section)h(con)m(tains)h │ │ │ │ │ (brief)e(descriptions)h(including)f(protot)m(yp)s(es)h(of)f(all)i │ │ │ │ │ (metho)s(ds)d(that)j(b)s(elong)e(to)h(the)g Fh(Ideq)0 │ │ │ │ │ 5407 y Fi(ob)5 b(ject.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fi(2)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fh(Ideq)29 b Fc(:)41 b Fg(DRAFT)30 b Fc(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 0 399 a Fb(1.2.1)112 b(Basic)38 │ │ │ │ │ -b(metho)s(ds)0 616 y Fi(As)d(usual,)h(there)f(are)g(four)f(basic)h │ │ │ │ │ -(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e │ │ │ │ │ -(default)f(\014elds,)h(clearing)0 729 y(an)m(y)31 b(allo)s(cated)h │ │ │ │ │ -(data,)f(and)f(free'ing)h(the)g(ob)5 b(ject.)111 1021 │ │ │ │ │ -y(1.)46 b Fh(Ideq)h(*)g(Ideq_new)f(\()h(void)g(\))g(;)227 │ │ │ │ │ -1194 y Fi(This)32 b(metho)s(d)f(simply)h(allo)s(cates)i(storage)g(for)e │ │ │ │ │ -(the)g Fh(Ideq)f Fi(structure)h(and)f(then)h(sets)h(the)f(default)g │ │ │ │ │ -(\014elds)227 1306 y(b)m(y)f(a)f(call)i(to)f Fh(Ideq)p │ │ │ │ │ -905 1306 29 4 v 33 w(setDefaultFields\(\))p Fi(.)111 │ │ │ │ │ -1538 y(2.)46 b Fh(void)h(Ideq_setDefaultFields)42 b(\()47 │ │ │ │ │ -b(Ideq)g(*deq)g(\))g(;)227 1710 y Fi(This)22 b(metho)s(d)h(sets)g(the)g │ │ │ │ │ -(structure's)f(\014elds)g(to)i(default)f(v)-5 b(alues:)37 │ │ │ │ │ -b Fh(head)22 b Fi(and)g Fh(tail)g Fi(are)h(set)g(to)h │ │ │ │ │ -Fh(-1)p Fi(,)g Fh(maxsize)227 1823 y Fi(is)31 b(set)g(to)g(zero,)g(and) │ │ │ │ │ -f(the)g(\014elds)g(for)g Fh(iv)g Fi(are)h(set)g(via)g(a)g(call)g(to)g │ │ │ │ │ -Fh(IV)p 2518 1823 V 34 w(setDefaultFields\(\))p Fi(.)227 │ │ │ │ │ -1995 y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fi(If)30 │ │ │ │ │ -b Fh(deq)g Fi(is)g Fh(NULL)p Fi(,)g(an)g(error)g(message)h(is)g(prin)m │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fi(2)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fh(Ideq)29 b Fc(:)41 b Fg(DRAFT)30 b Fc(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 0 399 a Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +616 y Fi(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ +(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ +(\014elds,)h(clearing)0 729 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ +(free'ing)h(the)g(ob)5 b(ject.)111 1021 y(1.)46 b Fh(Ideq)h(*)g │ │ │ │ │ +(Ideq_new)f(\()h(void)g(\))g(;)227 1194 y Fi(This)32 │ │ │ │ │ +b(metho)s(d)f(simply)h(allo)s(cates)i(storage)g(for)e(the)g │ │ │ │ │ +Fh(Ideq)f Fi(structure)h(and)f(then)h(sets)h(the)f(default)g(\014elds) │ │ │ │ │ +227 1306 y(b)m(y)f(a)f(call)i(to)f Fh(Ideq)p 905 1306 │ │ │ │ │ +29 4 v 33 w(setDefaultFields\(\))p Fi(.)111 1538 y(2.)46 │ │ │ │ │ +b Fh(void)h(Ideq_setDefaultFields)42 b(\()47 b(Ideq)g(*deq)g(\))g(;)227 │ │ │ │ │ +1710 y Fi(This)22 b(metho)s(d)h(sets)g(the)g(structure's)f(\014elds)g │ │ │ │ │ +(to)i(default)f(v)-5 b(alues:)37 b Fh(head)22 b Fi(and)g │ │ │ │ │ +Fh(tail)g Fi(are)h(set)g(to)h Fh(-1)p Fi(,)g Fh(maxsize)227 │ │ │ │ │ +1823 y Fi(is)31 b(set)g(to)g(zero,)g(and)f(the)g(\014elds)g(for)g │ │ │ │ │ +Fh(iv)g Fi(are)h(set)g(via)g(a)g(call)g(to)g Fh(IV)p │ │ │ │ │ +2518 1823 V 34 w(setDefaultFields\(\))p Fi(.)227 1995 │ │ │ │ │ +y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fi(If)30 b │ │ │ │ │ +Fh(deq)g Fi(is)g Fh(NULL)p Fi(,)g(an)g(error)g(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)g(the)g(program)g(exits.)111 2227 y(3.)46 │ │ │ │ │ b Fh(void)h(Ideq_clearData)d(\()j(Ideq)g(*deq)g(\))g(;)227 │ │ │ │ │ 2399 y Fi(This)23 b(metho)s(d)h(clears)h(an)m(y)f(data)g(o)m(wned)g(b)m │ │ │ │ │ (y)g(the)g(ob)5 b(ject.)40 b(It)24 b(releases)h(an)m(y)f(storage)h │ │ │ │ │ (held)f(b)m(y)g(the)g Fh(deq->iv)227 2512 y Fi(ob)5 b(ject)32 │ │ │ │ │ b(with)e(a)g(call)i(to)f Fh(IV)p 1165 2512 V 34 w(clearData\(\))p │ │ │ │ │ Fi(.)38 b(It)30 b(then)g(calls)i Fh(Ideq)p 2490 2512 │ │ │ │ │ @@ -3389,17 +3383,17 @@ │ │ │ │ │ Fi(and)h Fh(maxsize)e Fi(\014elds)i(are)h(set.)41 b(The)30 │ │ │ │ │ b(metho)s(d)f(then)i(returns)e Fh(1)p Fi(.)227 5294 y │ │ │ │ │ Fg(Err)-5 b(or)28 b(che)-5 b(cking:)37 b Fi(If)23 b Fh(deq)g │ │ │ │ │ Fi(is)g Fh(NULL)p Fi(,)g(or)h(if)f Fh(newsize)h Fa(<)h │ │ │ │ │ Fi(0,)g(an)f(error)f(message)i(is)e(prin)m(ted)g(and)g(the)h(program) │ │ │ │ │ 227 5407 y(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1134 4 v 1315 100 a Fh(Ideq)29 │ │ │ │ │ -b Fc(:)41 b Fg(DRAFT)121 b Fc(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fi(3)0 399 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1153 4 v 1334 100 a Fh(Ideq)29 │ │ │ │ │ +b Fc(:)41 b Fg(DRAFT)121 b Fc(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fi(3)0 399 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ b(metho)s(ds)111 603 y Fi(1.)46 b Fh(void)h(Ideq_clear)e(\()i(Ideq)g │ │ │ │ │ (*deq)g(\))g(;)227 762 y Fi(This)30 b(metho)s(d)g(clears)h(the)g │ │ │ │ │ (dequeue.)40 b(The)30 b Fh(head)f Fi(and)h Fh(tail)f │ │ │ │ │ Fi(\014elds)h(are)h(set)f(to)i Fh(-1)p Fi(.)227 921 y │ │ │ │ │ Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fi(If)30 b Fh(deq)g │ │ │ │ │ Fi(is)g Fh(NULL)p Fi(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)g │ │ │ │ │ (the)g(program)g(exits.)111 1125 y(2.)46 b Fh(int)h(Ideq_head)e(\()j │ │ │ │ │ @@ -3468,21 +3462,21 @@ │ │ │ │ │ 3130 5136 V 34 w(resize\(\))d Fi(metho)s(d.)227 5248 │ │ │ │ │ y(Otherwise,)f(the)f(item)h(is)g(placed)f(in)m(to)i(the)e(list)h(and)f │ │ │ │ │ Fh(1)g Fi(is)h(returned.)227 5407 y Fg(Err)-5 b(or)34 │ │ │ │ │ b(che)-5 b(cking:)40 b Fi(If)30 b Fh(deq)g Fi(is)g Fh(NULL)p │ │ │ │ │ Fi(,)g(an)g(error)g(message)h(is)g(prin)m(ted)f(and)g(the)g(program)g │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fi(4)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fh(Ideq)29 b Fc(:)41 b Fg(DRAFT)30 b Fc(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 0 399 a Fb(1.2.4)112 b(IO)38 │ │ │ │ │ -b(metho)s(ds)111 595 y Fi(1.)46 b Fh(void)h(Ideq_writeForHumanEye)42 │ │ │ │ │ -b(\()47 b(Ideq)g(*deq)g(\))g(;)227 745 y Fi(This)31 b(metho)s(d)g │ │ │ │ │ -(write)h(the)f(state)i(of)f(the)f(ob)5 b(ject,)33 b(\(the)f(size,)h │ │ │ │ │ -(head)f(and)e(tail\))k(and)c(the)i(list)g(of)g(en)m(tries)g(to)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fi(4)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fh(Ideq)29 b Fc(:)41 b Fg(DRAFT)30 b Fc(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 0 399 a Fb(1.2.4)112 b(IO)38 b(metho)s(ds)111 │ │ │ │ │ +595 y Fi(1.)46 b Fh(void)h(Ideq_writeForHumanEye)42 b(\()47 │ │ │ │ │ +b(Ideq)g(*deq)g(\))g(;)227 745 y Fi(This)31 b(metho)s(d)g(write)h(the)f │ │ │ │ │ +(state)i(of)f(the)f(ob)5 b(ject,)33 b(\(the)f(size,)h(head)f(and)e │ │ │ │ │ +(tail\))k(and)c(the)i(list)g(of)g(en)m(tries)g(to)227 │ │ │ │ │ 858 y(a)f(\014le.)227 1008 y Fg(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fi(If)30 b Fh(deq)g Fi(or)g Fh(fp)g Fi(is)g │ │ │ │ │ Fh(NULL)p Fi(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g(the)g │ │ │ │ │ (program)g(exits.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ TeXDict begin 5 4 bop 0 866 a Fj(Index)0 1289 y Fh(Ideq)p │ │ │ │ │ 198 1289 29 4 v 33 w(clear\(\))p Fi(,)29 b(3)0 1402 y │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -16,15 +16,15 @@ │ │ │ │ │ │ • IV iv : an IV object to hold the list vector. │ │ │ │ │ │ A correctly initialized and nontrivial Ideq object will have maxsize > 0. When the dequeue is │ │ │ │ │ │ empty, head = tail = -1. │ │ │ │ │ │ 1.2 Prototypes and descriptions of Ideq methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the Ideq │ │ │ │ │ │ object. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Ideq : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Ideq : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. Ideq * Ideq_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the Ideq structure and then sets the default fields │ │ │ │ │ │ by a call to Ideq setDefaultFields(). │ │ │ │ │ │ 2. void Ideq_setDefaultFields ( Ideq *deq ) ; │ │ │ │ │ │ @@ -47,15 +47,15 @@ │ │ │ │ │ │ initializer. │ │ │ │ │ │ If the present size of the list (the number of entries between head and tail inclusive) is larger │ │ │ │ │ │ than newsize, the method returns -1. Otherwise, a new int vector is allocated and filled │ │ │ │ │ │ with the entries in the list. The old int vector is free’d, the new vector is spliced into the IV │ │ │ │ │ │ object, and the head, tail and maxsize fields are set. The method then returns 1. │ │ │ │ │ │ Error checking: If deq is NULL, or if newsize < 0, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - Ideq : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Ideq : DRAFT January 7, 2024 3 │ │ │ │ │ │ 1.2.3 Utility methods │ │ │ │ │ │ 1. void Ideq_clear ( Ideq *deq ) ; │ │ │ │ │ │ This method clears the dequeue. The head and tail fields are set to -1. │ │ │ │ │ │ Error checking: If deq is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. int Ideq_head ( Ideq *deq ) ; │ │ │ │ │ │ This method returns the value at the head of the list without removing that value. If head │ │ │ │ │ │ == -1 then -1 is returned. Note, the list may be nonempty and the first value may be -1, so │ │ │ │ │ │ @@ -82,15 +82,15 @@ │ │ │ │ │ │ may signal an empty list or a terminating element. │ │ │ │ │ │ Error checking: If deq is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 7. int Ideq_insertAtTail ( Ideq *deq, int val ) ; │ │ │ │ │ │ This method inserts a value val into the list at the tail of the list. If there is no room in │ │ │ │ │ │ the list, -1 is returned and the dequeue must be resized using the Ideq resize() method. │ │ │ │ │ │ Otherwise, the item is placed into the list and 1 is returned. │ │ │ │ │ │ Error checking: If deq is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 4 Ideq : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Ideq : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.4 IO methods │ │ │ │ │ │ 1. void Ideq_writeForHumanEye ( Ideq *deq ) ; │ │ │ │ │ │ This method write the state of the object, (the size, head and tail) and the list of entries to │ │ │ │ │ │ a file. │ │ │ │ │ │ Error checking: If deq or fp is NULL, an error message is printed and the program exits. │ │ │ │ │ │ Index │ │ │ │ │ │ Ideq clear(), 3 │ │ │ ├── ./usr/share/doc/spooles-doc/InpMtx.ps.gz │ │ │ │ ├── InpMtx.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o InpMtx.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2763,21 +2763,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2961,88 +2960,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5611,16 +5605,16 @@ │ │ │ │ │ 56 56 56 56 56 56 56 56 56 1[31 37 31 44[{}41 99.6264 │ │ │ │ │ /CMBX12 rf /Ff 135[62 3[62 3[62 1[62 32[62 3[62 73[{}6 │ │ │ │ │ 119.552 /CMTT12 rf /Fg 201[0 32[65 65 17[65 1[65{}5 83.022 │ │ │ │ │ /CMSY10 rf /Fh 134[71 2[71 75 52 53 55 1[75 67 75 112 │ │ │ │ │ 2[41 37 75 67 41 61 75 60 75 65 13[75 2[92 11[103 16[67 │ │ │ │ │ 67 67 2[37 46[{}27 119.552 /CMBX12 rf /Fi 132[48 38[66 │ │ │ │ │ 4[72 75 8[63 10[27 58[{}6 83.022 /CMBX10 rf /Fj 134[44 │ │ │ │ │ -3[46 2[33 12[37 2[46 42 26[54 11[23 1[42 2[42 2[42 1[42 │ │ │ │ │ -3[23 44[{}13 83.022 /CMSL10 rf /Fk 148[35 27 23 20[39 │ │ │ │ │ +3[46 2[33 3[46 12[42 22[43 15[23 2[42 2[42 1[42 1[42 │ │ │ │ │ +3[23 44[{}12 83.022 /CMSL10 rf /Fk 148[35 27 23 20[39 │ │ │ │ │ 11[54 12[20 59[{}6 58.1154 /CMMI7 rf /Fl 134[41 47 1[40 │ │ │ │ │ 10[43 34 29 7[44 7[48 69 21[63 62 2[65 1[65 23 46[47 │ │ │ │ │ 53 11[{}16 83.022 /CMMI10 rf /Fm 137[38 45 28 34 35 1[42 │ │ │ │ │ 42 47 1[21 38 1[25 42 38 1[38 42 38 1[42 12[59 1[61 11[54 │ │ │ │ │ 56 63 2[62 6[25 12[30 45[{}25 83.022 /CMTI10 rf │ │ │ │ │ %DVIPSBitmapFont: Fn tcrm1000 10 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ @@ -5758,19 +5752,19 @@ │ │ │ │ │ Fo(InpMtx)p 1881 5140 V 28 w(changeStorageMode)o(\(\))p │ │ │ │ │ Fp(.)101 5308 y(5.)42 b(Create)18 b(an)h Fo(IVL)g Fp(ob)5 │ │ │ │ │ b(ject)19 b(that)h(con)n(tains)e(the)i(full)h(adjacency)d(of)i │ │ │ │ │ Fl(A)r Fp(+)r Fl(A)2384 5277 y Fk(T)2456 5308 y Fp(b)n(y)g(calling)e │ │ │ │ │ (the)i Fo(InpMtx)p 3222 5308 V 29 w(fullAdjacency\(\))208 │ │ │ │ │ 5407 y Fp(metho)r(d.)1929 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fp(2)p 125 100 1161 4 v │ │ │ │ │ -1326 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)28 b Fj(F)-7 │ │ │ │ │ -b(ebruary)26 b(8,)h(2025)p 2739 100 V 101 390 a Fp(6.)42 │ │ │ │ │ -b(Create)26 b(a)h Fo(Graph)f Fp(ob)5 b(ject)27 b(using)h(the)g │ │ │ │ │ -Fo(Graph)p 1627 390 27 4 v 29 w(init2\(\))d Fp(metho)r(d)j(and)f(the)h │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fp(2)p 125 100 1179 4 v │ │ │ │ │ +1344 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)f(7,)h │ │ │ │ │ +(2024)p 2722 100 V 101 390 a Fp(6.)42 b(Create)26 b(a)h │ │ │ │ │ +Fo(Graph)f Fp(ob)5 b(ject)27 b(using)h(the)g Fo(Graph)p │ │ │ │ │ +1627 390 27 4 v 29 w(init2\(\))d Fp(metho)r(d)j(and)f(the)h │ │ │ │ │ Fo(IVL)f Fp(ob)5 b(ject)27 b(as)g(an)g(input)i(argumen)n(t.)0 │ │ │ │ │ 591 y(A)i(similar)e(functionalit)n(y)i(exists)f(for)f(creating)h(a)f │ │ │ │ │ Fo(Graph)g Fp(ob)5 b(ject)30 b(from)g(a)g(linear)f(com)n(bination)h(of) │ │ │ │ │ g(t)n(w)n(o)g Fo(InpMtx)e Fp(ob)5 b(jects)0 691 y(that)33 │ │ │ │ │ b(con)n(tains)e(the)i(matrices)e Fl(A)i Fp(and)f Fl(B)t │ │ │ │ │ Fp(.)52 b(The)32 b Fo(InpMtx)p 1847 691 V 29 w(fullAdjacency2\(\))26 │ │ │ │ │ b Fp(metho)r(d)33 b(returns)e(an)h Fo(IVL)f Fp(ob)5 b(ject)33 │ │ │ │ │ @@ -5858,17 +5852,17 @@ │ │ │ │ │ (or)g(t)n(w)n(o)390 5168 y(double)28 b(precision)e(v)-5 │ │ │ │ │ b(alues.)301 5308 y Fi({)41 b Fo(INPMTX)p 659 5308 V │ │ │ │ │ 29 w(SORTED)25 b Fp(|)j(data)f(is)h(sorted)f(and)g(distinct)i(triples,) │ │ │ │ │ e(the)h(primary)f(k)n(ey)g(is)h(the)g(\014rst)f(co)r(ordinate,)g(the) │ │ │ │ │ 390 5407 y(secondary)f(k)n(ey)h(is)g(the)h(second)f(co)r(ordinate.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 83 100 1161 4 v 1327 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2700 100 V 1161 w Fp(3)301 390 y Fi({)41 b Fo(INPMTX)p │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1179 4 v 1344 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2682 100 V 1179 w Fp(3)301 390 y Fi({)41 b Fo(INPMTX)p │ │ │ │ │ 659 390 27 4 v 29 w(BY)p 776 390 V 31 w(VECTORS)32 b │ │ │ │ │ Fp(|)i(data)h(is)f(sorted)g(and)h(distinct)g(v)n(ectors.)57 │ │ │ │ │ b(All)35 b(en)n(tries)f(in)h(a)f(v)n(ector)f(share)h(some-)390 │ │ │ │ │ 490 y(thing)41 b(in)g(common.)75 b(F)-7 b(or)40 b(example,)k(when)d │ │ │ │ │ Fo(coordType)c Fp(is)j Fo(INPMTX)p 2688 490 V 29 w(BY)p │ │ │ │ │ 2805 490 V 31 w(ROWS)p Fp(,)f Fo(INPMTX)p 3338 490 V │ │ │ │ │ 29 w(BY)p 3455 490 V 30 w(COLUMNS)f Fp(or)390 589 y Fo(INPMTX)p │ │ │ │ │ @@ -5964,27 +5958,27 @@ │ │ │ │ │ (stored)g(as)g(unsorted)g(pairs)g(or)h(triples,)g(and)f │ │ │ │ │ Fo(0)h Fp(other-)208 5242 y(wise.)125 5407 y Fn(\210)42 │ │ │ │ │ b Fo(INPMTX)p 477 5407 V 28 w(IS)p 593 5407 V 31 w(SORTED\(mtx\))23 │ │ │ │ │ b Fp(returns)k Fo(1)g Fp(if)h(the)g(en)n(tries)f(are)g(stored)g(as)g │ │ │ │ │ (sorted)f(pairs)h(or)g(triples,)g(and)h Fo(0)f Fp(otherwise.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fp(4)p 125 100 1161 4 v │ │ │ │ │ -1326 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)28 b Fj(F)-7 │ │ │ │ │ -b(ebruary)26 b(8,)h(2025)p 2739 100 V 125 390 a Fn(\210)42 │ │ │ │ │ -b Fo(INPMTX)p 477 390 27 4 v 28 w(IS)p 593 390 V 31 w(BY)p │ │ │ │ │ -712 390 V 31 w(VECTORS\(mtx\))22 b Fp(returns)27 b Fo(1)g │ │ │ │ │ -Fp(if)i(the)f(en)n(tries)e(are)h(stored)g(as)g(v)n(ectors,)f(and)h │ │ │ │ │ -Fo(0)g Fp(otherwise.)125 560 y Fn(\210)42 b Fo(INPMTX)p │ │ │ │ │ -477 560 V 28 w(IS)p 593 560 V 31 w(INDICES)p 932 560 │ │ │ │ │ -V 28 w(ONLY\(mtx\))24 b Fp(returns)j Fo(1)h Fp(if)g(the)g(en)n(tries)f │ │ │ │ │ -(are)f(not)i(stored,)f(and)g Fo(0)g Fp(otherwise.)125 │ │ │ │ │ -730 y Fn(\210)42 b Fo(INPMTX)p 477 730 V 28 w(IS)p 593 │ │ │ │ │ -730 V 31 w(REAL)p 800 730 V 30 w(ENTRIES\(mtx\))22 b │ │ │ │ │ -Fp(returns)27 b Fo(1)h Fp(if)g(the)g(en)n(tries)f(are)f(real,)h(and)g │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fp(4)p 125 100 1179 4 v │ │ │ │ │ +1344 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)f(7,)h │ │ │ │ │ +(2024)p 2722 100 V 125 390 a Fn(\210)42 b Fo(INPMTX)p │ │ │ │ │ +477 390 27 4 v 28 w(IS)p 593 390 V 31 w(BY)p 712 390 │ │ │ │ │ +V 31 w(VECTORS\(mtx\))22 b Fp(returns)27 b Fo(1)g Fp(if)i(the)f(en)n │ │ │ │ │ +(tries)e(are)h(stored)g(as)g(v)n(ectors,)f(and)h Fo(0)g │ │ │ │ │ +Fp(otherwise.)125 560 y Fn(\210)42 b Fo(INPMTX)p 477 │ │ │ │ │ +560 V 28 w(IS)p 593 560 V 31 w(INDICES)p 932 560 V 28 │ │ │ │ │ +w(ONLY\(mtx\))24 b Fp(returns)j Fo(1)h Fp(if)g(the)g(en)n(tries)f(are)f │ │ │ │ │ +(not)i(stored,)f(and)g Fo(0)g Fp(otherwise.)125 730 y │ │ │ │ │ +Fn(\210)42 b Fo(INPMTX)p 477 730 V 28 w(IS)p 593 730 │ │ │ │ │ +V 31 w(REAL)p 800 730 V 30 w(ENTRIES\(mtx\))22 b Fp(returns)27 │ │ │ │ │ +b Fo(1)h Fp(if)g(the)g(en)n(tries)f(are)f(real,)h(and)g │ │ │ │ │ Fo(0)h Fp(otherwise.)125 900 y Fn(\210)42 b Fo(INPMTX)p │ │ │ │ │ 477 900 V 28 w(IS)p 593 900 V 31 w(COMPLEX)p 932 900 │ │ │ │ │ V 28 w(ENTRIES\(mtx\))23 b Fp(returns)k Fo(1)g Fp(if)h(the)g(en)n │ │ │ │ │ (tries)f(are)g(complex,)g(and)h Fo(0)f Fp(otherwise.)0 │ │ │ │ │ 1205 y Fh(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g │ │ │ │ │ Ff(InpMtx)d Fh(metho)t(ds)0 1414 y Fp(This)22 b(section)f(con)n(tains)g │ │ │ │ │ (brief)h(descriptions)f(including)h(protot)n(yp)r(es)f(of)h(all)g │ │ │ │ │ @@ -6040,17 +6034,17 @@ │ │ │ │ │ 5137 y Fn(\210)42 b Fo(INPMTX)p 659 5137 V 29 w(BY)p │ │ │ │ │ 776 5137 V 31 w(COLUMNS)24 b Fp({)k(storage)d(b)n(y)j(column)f(triples) │ │ │ │ │ 307 5272 y Fn(\210)42 b Fo(INPMTX)p 659 5272 V 29 w(BY)p │ │ │ │ │ 776 5272 V 31 w(CHEVRONS)24 b Fp({)j(storage)f(b)n(y)h(c)n(hevron)f │ │ │ │ │ (triples)307 5407 y Fn(\210)42 b Fo(INPMTX)p 659 5407 │ │ │ │ │ V 29 w(CUSTOM)25 b Fp({)i(custom)h(t)n(yp)r(e)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 83 100 1161 4 v 1327 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2700 100 V 1161 w Fp(5)208 390 y Fm(Err)l(or)j(che)l(cking:)38 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1179 4 v 1344 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2682 100 V 1179 w Fp(5)208 390 y Fm(Err)l(or)j(che)l(cking:)38 │ │ │ │ │ b Fp(If)28 b Fo(inpmtx)e Fp(is)h Fo(NULL)p Fp(,)f(an)i(error)d(message) │ │ │ │ │ h(is)i(prin)n(ted)f(and)h(the)g(program)d(exits.)101 │ │ │ │ │ 559 y(2.)42 b Fo(int)g(InpMtx_storageMo)o(de)37 b(\()43 │ │ │ │ │ b(InpMtx)e(*inpmtx)g(\))i(;)208 693 y Fp(This)27 b(metho)r(d)h(returns) │ │ │ │ │ f(the)h(storage)e(mo)r(de.)307 862 y Fn(\210)42 b Fo(INPMTX)p │ │ │ │ │ 659 862 27 4 v 29 w(NO)p 776 862 V 31 w(MODE)26 b Fp({)h(none)g(sp)r │ │ │ │ │ (eci\014ed)307 997 y Fn(\210)42 b Fo(INPMTX)p 659 997 │ │ │ │ │ @@ -6108,37 +6102,37 @@ │ │ │ │ │ (exits.)60 5139 y(10.)41 b Fo(int)h(*)h(InpMtx_ivec2)c(\()k(InpMtx)e │ │ │ │ │ (*inpmtx)g(\))i(;)208 5273 y Fp(This)27 b(metho)r(d)h(returns)f(the)h │ │ │ │ │ (base)f(address)f(of)i(the)g Fo(ivec2[])d Fp(v)n(ector.)208 │ │ │ │ │ 5407 y Fm(Err)l(or)30 b(che)l(cking:)38 b Fp(If)28 b │ │ │ │ │ Fo(inpmtx)e Fp(is)h Fo(NULL)p Fp(,)f(an)i(error)d(message)h(is)i(prin)n │ │ │ │ │ (ted)f(and)h(the)g(program)d(exits.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fp(6)p 125 100 1161 4 v │ │ │ │ │ -1326 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)28 b Fj(F)-7 │ │ │ │ │ -b(ebruary)26 b(8,)h(2025)p 2739 100 V 60 390 a Fp(11.)41 │ │ │ │ │ -b Fo(double)g(*)i(InpMtx_dvec)c(\()k(InpMtx)e(*inpmtx)g(\))i(;)208 │ │ │ │ │ -524 y Fp(This)27 b(metho)r(d)h(returns)f(the)h(base)f(address)f(of)i │ │ │ │ │ -(the)g Fo(dvec[])d Fp(v)n(ector.)208 658 y Fm(Err)l(or)30 │ │ │ │ │ -b(che)l(cking:)38 b Fp(If)28 b Fo(inpmtx)e Fp(is)h Fo(NULL)p │ │ │ │ │ -Fp(,)f(an)i(error)d(message)h(is)i(prin)n(ted)f(and)h(the)g(program)d │ │ │ │ │ -(exits.)60 825 y(12.)41 b Fo(int)h(*)h(InpMtx_vecids)38 │ │ │ │ │ -b(\()43 b(InpMtx)f(*inpmtx)e(\))j(;)208 959 y Fp(This)27 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fp(6)p 125 100 1179 4 v │ │ │ │ │ +1344 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)f(7,)h │ │ │ │ │ +(2024)p 2722 100 V 60 390 a Fp(11.)41 b Fo(double)g(*)i(InpMtx_dvec)c │ │ │ │ │ +(\()k(InpMtx)e(*inpmtx)g(\))i(;)208 524 y Fp(This)27 │ │ │ │ │ b(metho)r(d)h(returns)f(the)h(base)f(address)f(of)i(the)g │ │ │ │ │ -Fo(vecids[])c Fp(v)n(ector.)208 1093 y Fm(Err)l(or)30 │ │ │ │ │ +Fo(dvec[])d Fp(v)n(ector.)208 658 y Fm(Err)l(or)30 b(che)l(cking:)38 │ │ │ │ │ +b Fp(If)28 b Fo(inpmtx)e Fp(is)h Fo(NULL)p Fp(,)f(an)i(error)d(message) │ │ │ │ │ +h(is)i(prin)n(ted)f(and)h(the)g(program)d(exits.)60 825 │ │ │ │ │ +y(12.)41 b Fo(int)h(*)h(InpMtx_vecids)38 b(\()43 b(InpMtx)f(*inpmtx)e │ │ │ │ │ +(\))j(;)208 959 y Fp(This)27 b(metho)r(d)h(returns)f(the)h(base)f │ │ │ │ │ +(address)f(of)i(the)g Fo(vecids[])c Fp(v)n(ector.)208 │ │ │ │ │ +1093 y Fm(Err)l(or)30 b(che)l(cking:)38 b Fp(If)28 b │ │ │ │ │ +Fo(inpmtx)e Fp(is)h Fo(NULL)p Fp(,)f(an)i(error)d(message)h(is)i(prin)n │ │ │ │ │ +(ted)f(and)h(the)g(program)d(exits.)60 1261 y(13.)41 │ │ │ │ │ +b Fo(int)h(*)h(InpMtx_sizes)c(\()k(InpMtx)e(*inpmtx)g(\))i(;)208 │ │ │ │ │ +1394 y Fp(This)27 b(metho)r(d)h(returns)f(the)h(base)f(address)f(of)i │ │ │ │ │ +(the)g Fo(sizes[])d Fp(v)n(ector.)208 1528 y Fm(Err)l(or)30 │ │ │ │ │ b(che)l(cking:)38 b Fp(If)28 b Fo(inpmtx)e Fp(is)h Fo(NULL)p │ │ │ │ │ Fp(,)f(an)i(error)d(message)h(is)i(prin)n(ted)f(and)h(the)g(program)d │ │ │ │ │ -(exits.)60 1261 y(13.)41 b Fo(int)h(*)h(InpMtx_sizes)c(\()k(InpMtx)e │ │ │ │ │ -(*inpmtx)g(\))i(;)208 1394 y Fp(This)27 b(metho)r(d)h(returns)f(the)h │ │ │ │ │ -(base)f(address)f(of)i(the)g Fo(sizes[])d Fp(v)n(ector.)208 │ │ │ │ │ -1528 y Fm(Err)l(or)30 b(che)l(cking:)38 b Fp(If)28 b │ │ │ │ │ -Fo(inpmtx)e Fp(is)h Fo(NULL)p Fp(,)f(an)i(error)d(message)h(is)i(prin)n │ │ │ │ │ -(ted)f(and)h(the)g(program)d(exits.)60 1696 y(14.)41 │ │ │ │ │ -b Fo(int)h(*)h(InpMtx_offsets)38 b(\()43 b(InpMtx)e(*inpmtx)g(\))i(;) │ │ │ │ │ -208 1829 y Fp(This)27 b(metho)r(d)h(returns)f(the)h(base)f(address)f │ │ │ │ │ -(of)i(the)g Fo(offsets[])c Fp(v)n(ector.)208 1963 y Fm(Err)l(or)30 │ │ │ │ │ +(exits.)60 1696 y(14.)41 b Fo(int)h(*)h(InpMtx_offsets)38 │ │ │ │ │ +b(\()43 b(InpMtx)e(*inpmtx)g(\))i(;)208 1829 y Fp(This)27 │ │ │ │ │ +b(metho)r(d)h(returns)f(the)h(base)f(address)f(of)i(the)g │ │ │ │ │ +Fo(offsets[])c Fp(v)n(ector.)208 1963 y Fm(Err)l(or)30 │ │ │ │ │ b(che)l(cking:)38 b Fp(If)28 b Fo(inpmtx)e Fp(is)h Fo(NULL)p │ │ │ │ │ Fp(,)f(an)i(error)d(message)h(is)i(prin)n(ted)f(and)h(the)g(program)d │ │ │ │ │ (exits.)60 2131 y(15.)41 b Fo(void)g(InpMtx_vector)e(\()k(InpMtx)e │ │ │ │ │ (*inpmtx,)f(int)j(id,)f(int)g(*pnent,)f(int)h(**pindices)e(\))j(;)208 │ │ │ │ │ 2231 y(void)e(InpMtx_realVector)c(\()43 b(InpMtx)e(*inpmtx,)g(int)h │ │ │ │ │ (id,)g(int)h(*pnent,)1297 2330 y(int)g(**pindices,)c(double)i │ │ │ │ │ (**pentries)e(\))k(;)208 2430 y(void)e(InpMtx_complexVec)o(tor)c(\()43 │ │ │ │ │ @@ -6188,17 +6182,17 @@ │ │ │ │ │ 208 5174 y Fp(This)27 b(metho)r(d)h(sets)g(the)g(presen)n(t)f(n)n(um)n │ │ │ │ │ (b)r(er)g(of)g(en)n(tries)g(in)h(the)g(indices)g(and)f(en)n(tries)g(v)n │ │ │ │ │ (ectors.)208 5308 y Fm(Err)l(or)35 b(che)l(cking:)50 │ │ │ │ │ b Fp(If)33 b Fo(inpmtx)e Fp(is)i Fo(NULL)p Fp(,)f(or)g(if)h │ │ │ │ │ Fo(newnent)d Fl(<)i Fp(0,)i(an)f(error)e(message)h(is)h(prin)n(ted)g │ │ │ │ │ (and)g(the)g(program)208 5407 y(exits.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 83 100 1161 4 v 1327 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2700 100 V 1161 w Fp(7)60 390 y(19.)41 b Fo(void)g(InpMtx_setMaxnvec)o │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1179 4 v 1344 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2682 100 V 1179 w Fp(7)60 390 y(19.)41 b Fo(void)g(InpMtx_setMaxnvec)o │ │ │ │ │ (tor)c(\()43 b(InpMtx)e(*inpmtx,)f(int)j(newmaxnvector)38 │ │ │ │ │ b(\))43 b(;)208 516 y Fp(This)27 b(metho)r(d)h(sets)g(the)g(maxin)n(um) │ │ │ │ │ f(n)n(um)n(b)r(er)g(of)h(v)n(ectors.)208 641 y Fm(Err)l(or)38 │ │ │ │ │ b(che)l(cking:)58 b Fp(If)38 b Fo(inpmtx)c Fp(is)j Fo(NULL)p │ │ │ │ │ Fp(,)f(or)g(if)h Fo(newmaxnvector)d Fl(<)k Fp(0,)h(an)e(error)e │ │ │ │ │ (message)h(is)h(prin)n(ted)g(and)g(the)208 741 y(program)25 │ │ │ │ │ b(exits.)60 892 y(20.)41 b Fo(void)g(InpMtx_setNvector)c(\()43 │ │ │ │ │ @@ -6283,25 +6277,24 @@ │ │ │ │ │ b Fp(and)23 b Fo(InpMtx)p 2609 5083 V 29 w(convertToVectors\()o(\))p │ │ │ │ │ Fp(,)18 b(as)23 b(appropri-)208 5182 y(ate.)208 5308 │ │ │ │ │ y Fm(Err)l(or)30 b(che)l(cking:)41 b Fp(If)28 b Fo(inpmtx)e │ │ │ │ │ Fp(is)j Fo(NULL)d Fp(or)i Fo(newMode)d Fp(is)k(in)n(v)-5 │ │ │ │ │ b(alid,)28 b(an)g(error)f(message)g(is)h(prin)n(ted)g(and)g(the)h │ │ │ │ │ (program)208 5407 y(exits.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fp(8)p 125 100 1161 4 v │ │ │ │ │ -1326 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)28 b Fj(F)-7 │ │ │ │ │ -b(ebruary)26 b(8,)h(2025)p 2739 100 V 0 390 a Fe(1.2.4)112 │ │ │ │ │ -b(Input)38 b(metho)s(ds)101 570 y Fp(1.)k Fo(void)f(InpMtx_inputEntry)c │ │ │ │ │ -(\()43 b(InpMtx)e(*inpmtx,)g(int)h(row,)g(int)g(col)h(\))g(;)208 │ │ │ │ │ -669 y(void)e(InpMtx_inputRealE)o(ntr)o(y)c(\()44 b(InpMtx)d(*inpmtx,)f │ │ │ │ │ -(int)i(row,)g(int)h(col,)e(double)h(value)f(\))i(;)208 │ │ │ │ │ -769 y(void)e(InpMtx_inputCompl)o(exE)o(nt)o(ry)c(\()43 │ │ │ │ │ -b(InpMtx)e(*inpmtx,)g(int)h(row,)g(int)g(col,)1602 869 │ │ │ │ │ -y(double)f(real,)h(double)f(imag)h(\))h(;)208 1003 y │ │ │ │ │ -Fp(This)29 b(metho)r(d)g(places)g(a)f(single)h(en)n(try)f(in)n(to)h │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fp(8)p 125 100 1179 4 v │ │ │ │ │ +1344 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)f(7,)h │ │ │ │ │ +(2024)p 2722 100 V 0 390 a Fe(1.2.4)112 b(Input)38 b(metho)s(ds)101 │ │ │ │ │ +570 y Fp(1.)k Fo(void)f(InpMtx_inputEntry)c(\()43 b(InpMtx)e(*inpmtx,)g │ │ │ │ │ +(int)h(row,)g(int)g(col)h(\))g(;)208 669 y(void)e(InpMtx_inputRealE)o │ │ │ │ │ +(ntr)o(y)c(\()44 b(InpMtx)d(*inpmtx,)f(int)i(row,)g(int)h(col,)e │ │ │ │ │ +(double)h(value)f(\))i(;)208 769 y(void)e(InpMtx_inputCompl)o(exE)o(nt) │ │ │ │ │ +o(ry)c(\()43 b(InpMtx)e(*inpmtx,)g(int)h(row,)g(int)g(col,)1602 │ │ │ │ │ +869 y(double)f(real,)h(double)f(imag)h(\))h(;)208 1003 │ │ │ │ │ +y Fp(This)29 b(metho)r(d)g(places)g(a)f(single)h(en)n(try)f(in)n(to)h │ │ │ │ │ (the)g(matrix)g(ob)5 b(ject.)41 b(The)29 b(co)r(ordinate)f(t)n(yp)r(e)h │ │ │ │ │ (of)g(the)h(ob)5 b(ject)29 b(m)n(ust)g(b)r(e)208 1102 │ │ │ │ │ y Fo(INPMTX)p 477 1102 27 4 v 28 w(BY)p 593 1102 V 31 │ │ │ │ │ w(ROWS)p Fp(,)g Fo(INPMTX)p 1116 1102 V 29 w(BY)p 1233 │ │ │ │ │ 1102 V 30 w(COLUMNS)f Fp(or)h Fo(INPMTX)p 1967 1102 V │ │ │ │ │ 29 w(BY)p 2084 1102 V 31 w(CHEVRONS)p Fp(.)e(The)j(triple)h(is)f │ │ │ │ │ (formed)g(and)g(inserted)g(in)n(to)208 1202 y(the)e(v)n(ectors,)e(whic) │ │ │ │ │ @@ -6383,17 +6376,17 @@ │ │ │ │ │ (colind[])f(\))i(;)208 5208 y(void)e(InpMtx_inputRealM)o(atr)o(ix)c(\() │ │ │ │ │ 43 b(InpMtx)e(*inpmtx,)g(int)h(nrow,)f(int)i(col,)338 │ │ │ │ │ 5308 y(int)g(rowstride,)c(int)j(colstride,)e(int)i(rowind[],)e(int)i │ │ │ │ │ (colind[],)e(double)h(mtxent[])g(\))i(;)208 5407 y(void)e │ │ │ │ │ (InpMtx_inputCompl)o(exM)o(at)o(rix)c(\()43 b(InpMtx)e(*inpmtx,)f(int)j │ │ │ │ │ (nrow,)e(int)h(col,)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 83 100 1161 4 v 1327 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2700 100 V 1161 w Fp(9)338 390 y Fo(int)43 b(rowstride,)c(int)j │ │ │ │ │ +TeXDict begin 9 8 bop 83 100 1179 4 v 1344 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2682 100 V 1179 w Fp(9)338 390 y Fo(int)43 b(rowstride,)c(int)j │ │ │ │ │ (colstride,)e(int)i(rowind[],)e(int)i(colind[],)e(double)h(mtxent[])g │ │ │ │ │ (\))i(;)208 526 y Fp(This)25 b(metho)r(d)h(places)f(a)g(dense)g │ │ │ │ │ (submatrix)g(in)n(to)g(the)h(matrix)f(ob)5 b(ject.)36 │ │ │ │ │ b(The)25 b(co)r(ordinate)g(t)n(yp)r(e)g(of)h(the)g(ob)5 │ │ │ │ │ b(ject)25 b(m)n(ust)208 625 y(b)r(e)h Fo(INPMTX)p 588 │ │ │ │ │ 625 27 4 v 28 w(BY)p 704 625 V 31 w(ROWS)p Fp(,)e Fo(INPMTX)p │ │ │ │ │ 1222 625 V 29 w(BY)p 1339 625 V 31 w(COLUMNS)e Fp(or)j │ │ │ │ │ @@ -6491,31 +6484,30 @@ │ │ │ │ │ (map)f(a)g(part)g(of)h(a)f(distributed)h(matrix)f(b)r(et)n(w)n(een)h │ │ │ │ │ (the)g(global)e(and)i(lo)r(cal)f(n)n(um)n(b)r(erings.)208 │ │ │ │ │ 5407 y Fm(Err)l(or)e(che)l(cking:)37 b Fp(If)23 b Fo(A)p │ │ │ │ │ Fp(,)f Fo(rowmapIV)e Fp(or)i Fo(colmapIV)d Fp(is)k Fo(NULL)p │ │ │ │ │ Fp(,)e(an)h(error)f(message)g(is)i(prin)n(ted)g(and)f(the)h(program)e │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fp(10)p 166 100 1140 4 │ │ │ │ │ -v 1305 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2760 100 V 101 390 a Fp(4.)42 │ │ │ │ │ -b Fo(void)f(InpMtx_permute)d(\()43 b(InpMtx)f(*inpmtx,)e(int)i │ │ │ │ │ -(rowOldToNew[],)c(int)k(colOldToNew[])d(\))k(;)208 528 │ │ │ │ │ -y Fp(This)28 b(metho)r(d)g(p)r(erm)n(utes)g(the)h(ro)n(ws)d(and)i(or)g │ │ │ │ │ -(columns)g(of)g(the)g(matrix.)38 b(If)29 b Fo(rowOldToNew)23 │ │ │ │ │ -b Fp(and)28 b Fo(colOldToNew)c Fp(are)208 628 y(b)r(oth)29 │ │ │ │ │ -b Fo(NULL)p Fp(,)e(or)h(if)h(there)g(are)f(no)g(en)n(tries)g(in)i(the)f │ │ │ │ │ -(matrix,)f(the)i(metho)r(d)f(returns.)40 b(Note,)29 b(either)g │ │ │ │ │ -Fo(rowOldToNew)24 b Fp(or)208 727 y Fo(colOldToNew)i │ │ │ │ │ -Fp(can)k(b)r(e)h Fo(NULL)p Fp(.)e(If)i Fo(coordType)40 │ │ │ │ │ -b(==)i(INPMTX)p 2138 727 27 4 v 29 w(BY)p 2255 727 V │ │ │ │ │ -31 w(CHEVRONS)p Fp(,)27 b(then)k(the)g(co)r(ordinates)f(are)f(c)n │ │ │ │ │ -(hanged)208 827 y(to)d(ro)n(w)g(co)r(ordinates.)35 b(The)27 │ │ │ │ │ -b(co)r(ordinates)e(are)h(then)h(mapp)r(ed)g(to)g(their)g(new)f(v)-5 │ │ │ │ │ -b(alues.)37 b(The)26 b Fo(storageMode)d Fp(is)j(set)h(to)208 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fp(10)p 166 100 1158 4 │ │ │ │ │ +v 1322 w Fo(InpMtx)26 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)e(7,)j │ │ │ │ │ +(2024)p 2743 100 V 101 390 a Fp(4.)42 b Fo(void)f(InpMtx_permute)d(\() │ │ │ │ │ +43 b(InpMtx)f(*inpmtx,)e(int)i(rowOldToNew[],)c(int)k(colOldToNew[])d │ │ │ │ │ +(\))k(;)208 528 y Fp(This)28 b(metho)r(d)g(p)r(erm)n(utes)g(the)h(ro)n │ │ │ │ │ +(ws)d(and)i(or)g(columns)g(of)g(the)g(matrix.)38 b(If)29 │ │ │ │ │ +b Fo(rowOldToNew)23 b Fp(and)28 b Fo(colOldToNew)c Fp(are)208 │ │ │ │ │ +628 y(b)r(oth)29 b Fo(NULL)p Fp(,)e(or)h(if)h(there)g(are)f(no)g(en)n │ │ │ │ │ +(tries)g(in)i(the)f(matrix,)f(the)i(metho)r(d)f(returns.)40 │ │ │ │ │ +b(Note,)29 b(either)g Fo(rowOldToNew)24 b Fp(or)208 727 │ │ │ │ │ +y Fo(colOldToNew)i Fp(can)k(b)r(e)h Fo(NULL)p Fp(.)e(If)i │ │ │ │ │ +Fo(coordType)40 b(==)i(INPMTX)p 2138 727 27 4 v 29 w(BY)p │ │ │ │ │ +2255 727 V 31 w(CHEVRONS)p Fp(,)27 b(then)k(the)g(co)r(ordinates)f(are) │ │ │ │ │ +f(c)n(hanged)208 827 y(to)d(ro)n(w)g(co)r(ordinates.)35 │ │ │ │ │ +b(The)27 b(co)r(ordinates)e(are)h(then)h(mapp)r(ed)g(to)g(their)g(new)f │ │ │ │ │ +(v)-5 b(alues.)37 b(The)26 b Fo(storageMode)d Fp(is)j(set)h(to)208 │ │ │ │ │ 927 y Fo(1)p Fp(,)g(\(ra)n(w)g(triples\).)208 1065 y │ │ │ │ │ Fm(Err)l(or)j(che)l(cking:)38 b Fp(If)28 b Fo(inpmtx)e │ │ │ │ │ Fp(is)h Fo(NULL)p Fp(,)f(an)i(error)d(message)h(is)i(prin)n(ted)f(and)h │ │ │ │ │ (the)g(program)d(exits.)0 1336 y Fe(1.2.6)112 b(Matrix-matrix)39 │ │ │ │ │ b(m)m(ultiply)f(metho)s(ds)0 1518 y Fp(There)18 b(are)f(four)h │ │ │ │ │ (families)h(of)f(matrix-v)n(ector)e(and)j(matrix-matrix)d(m)n(ultiply)j │ │ │ │ │ (metho)r(ds.)34 b(The)19 b Fo(InpMtx)p 3214 1518 V 29 │ │ │ │ │ @@ -6604,17 +6596,17 @@ │ │ │ │ │ 5208 V 29 w(SORTED)f Fp(or)i Fo(INPMTX)p 3713 5208 V │ │ │ │ │ 29 w(BY)p 3830 5208 V 30 w(VECTORS)p Fp(,)208 5308 y(or)i(if)j │ │ │ │ │ Fo(inputMode)18 b Fp(is)j(not)h Fo(SPOOLES)p 1320 5308 │ │ │ │ │ V 28 w(REAL)f Fp(or)f Fo(SPOOLES)p 1948 5308 V 29 w(COMPLEX)p │ │ │ │ │ Fp(,)f(an)i(error)f(message)g(is)i(prin)n(ted)f(and)h(the)g(program)208 │ │ │ │ │ 5407 y(exits.)p eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 83 100 1140 4 v 1306 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2679 100 V 1140 w Fp(11)101 390 y(2.)42 b Fo(void)f(InpMtx_nonsym_mmm)o │ │ │ │ │ +TeXDict begin 11 10 bop 83 100 1158 4 v 1323 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)36 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2662 100 V 1158 w Fp(11)101 390 y(2.)42 b Fo(void)f(InpMtx_nonsym_mmm)o │ │ │ │ │ (Vec)o(to)o(r)d(\()43 b(InpMtx)e(*A,)h(DenseMtx)e(*Y,)j(double)e │ │ │ │ │ (alpha[],)f(DenseMtx)g(*X)j(\))g(;)208 490 y(void)e(InpMtx_sym_mmmVec)o │ │ │ │ │ (tor)c(\()43 b(InpMtx)e(*A,)h(DenseMtx)f(*Y,)h(double)f(alpha[],)f │ │ │ │ │ (DenseMtx)h(*X)h(\))i(;)208 589 y(void)d(InpMtx_herm_mmmVe)o(cto)o(r)c │ │ │ │ │ (\()44 b(InpMtx)d(*A,)h(DenseMtx)e(*Y,)j(double)e(alpha[],)f(DenseMtx)g │ │ │ │ │ (*X)j(\))g(;)208 689 y(void)e(InpMtx_nonsym_mmm)o(Vec)o(to)o(r_T)c(\() │ │ │ │ │ 43 b(InpMtx)e(*A,)h(DenseMtx)f(*Y,)h(double)f(alpha[],)f(DenseMtx)h(*X) │ │ │ │ │ @@ -6716,30 +6708,30 @@ │ │ │ │ │ b(dimensions)f(and)g(strides)g(for)g Fo(X)1889 5220 y │ │ │ │ │ Fp(-13)98 b(en)n(tries)27 b(of)h Fo(X)f Fp(are)f Fo(NULL)1889 │ │ │ │ │ 5319 y Fp(-14)98 b(t)n(yp)r(es)28 b(of)f Fo(A)p Fp(,)h │ │ │ │ │ Fo(X)f Fp(and)g Fo(Y)g Fp(are)g(not)h(iden)n(tical)1889 │ │ │ │ │ 5419 y(-15)98 b(n)n(um)n(b)r(er)27 b(of)h(columns)f(in)h │ │ │ │ │ Fo(X)f Fp(and)h Fo(Y)f Fp(are)g(not)g(equal)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fp(12)p 166 100 1140 │ │ │ │ │ -4 v 1305 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2760 100 V 101 390 a Fp(4.)42 │ │ │ │ │ -b Fo(int)g(InpMtx_nonsym_gm)o(vm)37 b(\()43 b(InpMtx)e(*A,)i(double)e │ │ │ │ │ -(beta[],)f(int)j(ny,)f(double)f(y[],)1297 490 y(double)g(alpha[],)g │ │ │ │ │ -(int)h(nx,)g(double)f(x[])i(\))g(;)208 589 y(int)f(InpMtx_sym_gmvm)37 │ │ │ │ │ -b(\()43 b(InpMtx)f(*A,)g(double)f(beta[],)g(int)h(ny,)g(double)f(y[],) │ │ │ │ │ -1166 689 y(double)h(alpha[],)e(int)i(nx,)h(double)e(x[])h(\))h(;)208 │ │ │ │ │ -789 y(int)f(InpMtx_herm_gmvm)37 b(\()43 b(InpMtx)e(*A,)h(double)g │ │ │ │ │ -(beta[],)e(int)j(ny,)f(double)f(y[],)1210 888 y(double)g(alpha[],)f │ │ │ │ │ -(int)j(nx,)f(double)f(x[])i(\))g(;)208 988 y(int)f(InpMtx_nonsym_gm)o │ │ │ │ │ -(vm)o(_T)37 b(\()43 b(InpMtx)e(*A,)i(double)e(beta[],)g(int)h(ny,)g │ │ │ │ │ -(double)f(y[],)1384 1088 y(double)g(alpha[],)g(int)h(nx,)g(double)g │ │ │ │ │ -(x[])g(\))h(;)208 1187 y(int)f(InpMtx_nonsym_gm)o(vm)o(_H)37 │ │ │ │ │ -b(\()43 b(InpMtx)e(*A,)i(double)e(beta[],)g(int)h(ny,)g(double)f(y[],) │ │ │ │ │ -1384 1287 y(double)g(alpha[],)g(int)h(nx,)g(double)g(x[])g(\))h(;)208 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fp(12)p 166 100 1158 │ │ │ │ │ +4 v 1322 w Fo(InpMtx)26 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)e(7,)j │ │ │ │ │ +(2024)p 2743 100 V 101 390 a Fp(4.)42 b Fo(int)g(InpMtx_nonsym_gm)o(vm) │ │ │ │ │ +37 b(\()43 b(InpMtx)e(*A,)i(double)e(beta[],)f(int)j(ny,)f(double)f │ │ │ │ │ +(y[],)1297 490 y(double)g(alpha[],)g(int)h(nx,)g(double)f(x[])i(\))g(;) │ │ │ │ │ +208 589 y(int)f(InpMtx_sym_gmvm)37 b(\()43 b(InpMtx)f(*A,)g(double)f │ │ │ │ │ +(beta[],)g(int)h(ny,)g(double)f(y[],)1166 689 y(double)h(alpha[],)e │ │ │ │ │ +(int)i(nx,)h(double)e(x[])h(\))h(;)208 789 y(int)f(InpMtx_herm_gmvm)37 │ │ │ │ │ +b(\()43 b(InpMtx)e(*A,)h(double)g(beta[],)e(int)j(ny,)f(double)f(y[],) │ │ │ │ │ +1210 888 y(double)g(alpha[],)f(int)j(nx,)f(double)f(x[])i(\))g(;)208 │ │ │ │ │ +988 y(int)f(InpMtx_nonsym_gm)o(vm)o(_T)37 b(\()43 b(InpMtx)e(*A,)i │ │ │ │ │ +(double)e(beta[],)g(int)h(ny,)g(double)f(y[],)1384 1088 │ │ │ │ │ +y(double)g(alpha[],)g(int)h(nx,)g(double)g(x[])g(\))h(;)208 │ │ │ │ │ +1187 y(int)f(InpMtx_nonsym_gm)o(vm)o(_H)37 b(\()43 b(InpMtx)e(*A,)i │ │ │ │ │ +(double)e(beta[],)g(int)h(ny,)g(double)f(y[],)1384 1287 │ │ │ │ │ +y(double)g(alpha[],)g(int)h(nx,)g(double)g(x[])g(\))h(;)208 │ │ │ │ │ 1414 y Fp(These)27 b(\014v)n(e)g(metho)r(ds)h(p)r(erform)f(the)h(follo) │ │ │ │ │ n(wing)f(computations.)608 1582 y Fo(InpMtx)p 877 1582 │ │ │ │ │ 27 4 v 28 w(nonsym)p 1169 1582 V 29 w(gmvm\(\))172 b │ │ │ │ │ Fl(y)26 b Fp(:=)d Fl(\014)t(y)e Fp(+)d Fl(\013Ax)164 │ │ │ │ │ b Fp(nonsymmetric)99 b(real)27 b(or)f(complex)608 1681 │ │ │ │ │ y Fo(InpMtx)p 877 1681 V 28 w(sym)p 1037 1681 V 31 w(gmvm\(\))302 │ │ │ │ │ b Fl(y)26 b Fp(:=)d Fl(\014)t(y)e Fp(+)d Fl(\013Ax)164 │ │ │ │ │ @@ -6818,17 +6810,17 @@ │ │ │ │ │ (of)h Fl(A)3522 5150 y Fk(T)3575 5180 y Fl(A)p Fp(,)h(where)208 │ │ │ │ │ 5280 y Fo(inpmtxA)c Fp(con)n(tains)j(the)h(en)n(tries)f(in)h │ │ │ │ │ Fl(A)p Fp(.)208 5407 y Fm(Err)l(or)i(che)l(cking:)38 │ │ │ │ │ b Fp(If)28 b Fo(inpmtxA)d Fp(is)j Fo(NULL)p Fp(,)e(an)h(error)f │ │ │ │ │ (message)g(is)h(prin)n(ted)h(and)f(the)h(program)e(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 83 100 1140 4 v 1306 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2679 100 V 1140 w Fp(13)0 390 y Fe(1.2.8)112 b(Submatrix)39 │ │ │ │ │ +TeXDict begin 13 12 bop 83 100 1158 4 v 1323 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)36 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2662 100 V 1158 w Fp(13)0 390 y Fe(1.2.8)112 b(Submatrix)39 │ │ │ │ │ b(extraction)e(metho)s(d)101 569 y Fp(1.)42 b Fo(int)g │ │ │ │ │ (InpMtx_initFromS)o(ub)o(mat)o(ri)o(x)c(\()43 b(InpMtx)e(*B,)h(InpMtx)f │ │ │ │ │ (*A,)i(IV)f(*BrowsIV,)731 669 y(IV)g(*BcolsIV,)e(int)j(symmetryflag,)38 │ │ │ │ │ b(int)k(msglvl,)f(FILE)h(*msgFile)e(\))j(;)208 802 y │ │ │ │ │ Fp(This)27 b(metho)r(d)g(\014lls)h Fo(B)e Fp(with)i(the)g(submatrix)e │ │ │ │ │ (formed)h(from)g(the)g(ro)n(ws)f(and)h(columns)g(of)g │ │ │ │ │ Fo(A)g Fp(found)g(in)h Fo(BrowsIV)c Fp(and)208 902 y │ │ │ │ │ @@ -6916,20 +6908,20 @@ │ │ │ │ │ Fp(to)29 b Fl(a)2795 5320 y Fk(j;i)2869 5308 y Fp(.)43 │ │ │ │ │ b(The)29 b(second)g(metho)r(d)g(mo)n(v)n(es)208 5407 │ │ │ │ │ y Fl(a)252 5419 y Fk(i;j)353 5407 y Fp(for)22 b Fl(i)h(>)g(j)28 │ │ │ │ │ b Fp(to)23 b Fl(a)818 5419 y Fk(j;i)892 5407 y Fp(,)i(\(If)f(the)f │ │ │ │ │ (matrix)g(is)g(Hermitian,)h(the)f(sign)g(of)g(the)h(imaginary)d(part)i │ │ │ │ │ (of)g(an)g(en)n(try)f(is)h(dealt)h(with)p eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ -TeXDict begin 14 13 bop 0 100 a Fp(14)p 166 100 1140 │ │ │ │ │ -4 v 1305 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2760 100 V 208 390 a Fp(in)g(the)g(correct)f │ │ │ │ │ -(fashion.\))36 b(In)27 b(other)g(w)n(ords,)e(using)i(these)g(metho)r │ │ │ │ │ -(ds)g(will)g(restore)f(the)h(lo)n(w)n(er)f(or)g(upp)r(er)h(triangular) │ │ │ │ │ -208 490 y(structure)g(after)g(a)g(p)r(erm)n(utation.)208 │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fp(14)p 166 100 1158 │ │ │ │ │ +4 v 1322 w Fo(InpMtx)26 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)e(7,)j │ │ │ │ │ +(2024)p 2743 100 V 208 390 a Fp(in)f(the)g(correct)f(fashion.\))36 │ │ │ │ │ +b(In)27 b(other)g(w)n(ords,)e(using)i(these)g(metho)r(ds)g(will)g │ │ │ │ │ +(restore)f(the)h(lo)n(w)n(er)f(or)g(upp)r(er)h(triangular)208 │ │ │ │ │ +490 y(structure)g(after)g(a)g(p)r(erm)n(utation.)208 │ │ │ │ │ 641 y Fm(Err)l(or)38 b(che)l(cking:)56 b Fp(If)37 b Fo(inpmtx)d │ │ │ │ │ Fp(is)i Fo(NULL)p Fp(,)f(or)h(if)h Fo(coordType)32 b │ │ │ │ │ Fp(is)37 b(in)n(v)-5 b(alid,)38 b(an)e(error)f(message)g(is)h(prin)n │ │ │ │ │ (ted)g(and)h(the)208 741 y(program)25 b(exits.)101 945 │ │ │ │ │ y(5.)42 b Fo(void)f(InpMtx_log10profi)o(le)c(\()43 b(InpMtx)e(*inpmtx,) │ │ │ │ │ g(int)h(npts,)g(DV)g(*xDV,)g(DV)h(*yDV,)1428 1044 y(double)e(tausmall,) │ │ │ │ │ f(double)h(taubig,)1428 1144 y(int)h(*pnzero,)f(int)h(*pnsmall,)e(int)i │ │ │ │ │ @@ -7019,17 +7011,17 @@ │ │ │ │ │ 5020 y(-5)98 b Fo(nrow)26 b Fp(or)h Fo(ncol)f Fp(negativ)n(e)1985 │ │ │ │ │ 5120 y(-6)98 b Fo(symflag)25 b Fp(is)j(in)n(v)-5 b(alid)1985 │ │ │ │ │ 5220 y(-7)98 b Fo(\(symflag,inputMod)o(e\))21 b Fp(in)n(v)-5 │ │ │ │ │ b(alid)1985 5319 y(-8)98 b Fo(\(symflag,nrow,nco)o(l\))21 │ │ │ │ │ b Fp(in)n(v)-5 b(alid)1985 5419 y(-9)98 b Fo(nitem)26 │ │ │ │ │ b Fp(negativ)n(e)p eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 83 100 1140 4 v 1306 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2679 100 V 1140 w Fp(15)0 390 y Fe(1.2.10)113 b(IO)37 │ │ │ │ │ +TeXDict begin 15 14 bop 83 100 1158 4 v 1323 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)36 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2662 100 V 1158 w Fp(15)0 390 y Fe(1.2.10)113 b(IO)37 │ │ │ │ │ b(metho)s(ds)0 568 y Fp(There)k(are)f(the)i(usual)f(eigh)n(t)g(IO)g │ │ │ │ │ (routines.)78 b(The)42 b(\014le)f(structure)g(of)g(a)g │ │ │ │ │ Fo(InpMtx)e Fp(ob)5 b(ject)42 b(is)f(simple:)65 b(The)41 │ │ │ │ │ b(\014rst)g(en-)0 667 y(tries)i(in)h(the)g(\014le)g(are)e │ │ │ │ │ Fo(coordType)p Fp(,)i Fo(storageMode)p Fp(,)f Fo(inputMode)p │ │ │ │ │ Fp(,)h Fo(nent)e Fp(and)h Fo(nvector)p Fp(.)82 b(If)44 │ │ │ │ │ b Fo(nent)e(>)h(0)p Fp(,)48 b(then)c(the)0 767 y Fo(ivec1IV)33 │ │ │ │ │ @@ -7126,22 +7118,22 @@ │ │ │ │ │ y(the)h(storage)d(mo)r(de)j(is)f(b)n(y)h(triples,)f(triples)g(are)g │ │ │ │ │ (written)h(out.)37 b(The)27 b(v)-5 b(alue)28 b Fo(1)f │ │ │ │ │ Fp(is)h(returned.)208 5407 y Fm(Err)l(or)i(che)l(cking:)38 │ │ │ │ │ b Fp(If)28 b Fo(inpmtx)e Fp(or)g Fo(fp)h Fp(are)g Fo(NULL)p │ │ │ │ │ Fp(,)f(an)h(error)f(message)g(is)h(prin)n(ted)h(and)f(zero)g(is)g │ │ │ │ │ (returned.)p eop end │ │ │ │ │ %%Page: 16 16 │ │ │ │ │ -TeXDict begin 16 15 bop 0 100 a Fp(16)p 166 100 1140 │ │ │ │ │ -4 v 1305 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2760 100 V 101 390 a Fp(8.)42 │ │ │ │ │ -b Fo(int)g(InpMtx_writeStat)o(s)37 b(\()44 b(InpMtx)d(*inpmtx,)f(FILE)i │ │ │ │ │ -(*fp)g(\))h(;)208 520 y Fp(This)27 b(metho)r(d)h(writes)f(the)h │ │ │ │ │ -(statistics)g(ab)r(out)f(the)h(ob)5 b(ject)28 b(to)f(a)g(\014le.)37 │ │ │ │ │ -b(h)n(uman.)g(The)28 b(v)-5 b(alue)27 b Fo(1)g Fp(is)h(returned.)208 │ │ │ │ │ -649 y Fm(Err)l(or)i(che)l(cking:)38 b Fp(If)28 b Fo(inpmtx)e │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fp(16)p 166 100 1158 │ │ │ │ │ +4 v 1322 w Fo(InpMtx)26 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)e(7,)j │ │ │ │ │ +(2024)p 2743 100 V 101 390 a Fp(8.)42 b Fo(int)g(InpMtx_writeStat)o(s) │ │ │ │ │ +37 b(\()44 b(InpMtx)d(*inpmtx,)f(FILE)i(*fp)g(\))h(;)208 │ │ │ │ │ +520 y Fp(This)27 b(metho)r(d)h(writes)f(the)h(statistics)g(ab)r(out)f │ │ │ │ │ +(the)h(ob)5 b(ject)28 b(to)f(a)g(\014le.)37 b(h)n(uman.)g(The)28 │ │ │ │ │ +b(v)-5 b(alue)27 b Fo(1)g Fp(is)h(returned.)208 649 y │ │ │ │ │ +Fm(Err)l(or)i(che)l(cking:)38 b Fp(If)28 b Fo(inpmtx)e │ │ │ │ │ Fp(or)g Fo(fp)h Fp(are)g Fo(NULL)p Fp(,)f(an)h(error)f(message)g(is)h │ │ │ │ │ (prin)n(ted)h(and)f(zero)g(is)g(returned.)101 808 y(9.)42 │ │ │ │ │ b Fo(void)f(InpMtx_writeForMa)o(tla)o(b)c(\()44 b(InpMtx)d(*mtx,)g │ │ │ │ │ (char)h(*mtxname,)e(FILE)i(*fp)g(\))h(;)208 937 y Fp(This)27 │ │ │ │ │ b(metho)r(d)h(writes)f(out)h(a)f Fo(InpMtx)e Fp(ob)5 │ │ │ │ │ b(ject)28 b(to)f(a)g(\014le)h(in)g(a)f(Matlab)g(format.)37 │ │ │ │ │ b(A)28 b(sample)f(line)h(is)208 1119 y Fo(a\(10,5\))40 │ │ │ │ │ @@ -7216,17 +7208,17 @@ │ │ │ │ │ b(structure)h(of)h Fl(A)19 b Fp(+)f Fl(A)1267 5238 y │ │ │ │ │ Fk(T)1319 5268 y Fp(,)28 b(diagonal)e(edges)h(included.)p │ │ │ │ │ 0 5330 1560 4 v 92 5384 a Fc(1)127 5407 y Fb(http://math.nist.gov/mc)q │ │ │ │ │ (sd/S)q(taf)q(f/KR)q(emi)q(ngto)q(n/h)q(arwe)q(ll)p 1890 │ │ │ │ │ 5407 22 4 v 32 w(io/harwell)p 2271 5407 V 28 w(io.html)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 17 17 │ │ │ │ │ -TeXDict begin 17 16 bop 83 100 1140 4 v 1306 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2679 100 V 1140 w Fp(17)307 390 y Fn(\210)42 b Fp(The)19 │ │ │ │ │ +TeXDict begin 17 16 bop 83 100 1158 4 v 1323 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)36 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2662 100 V 1158 w Fp(17)307 390 y Fn(\210)42 b Fp(The)19 │ │ │ │ │ b Fo(msglvl)e Fp(parameter)g(determines)i(the)h(amoun)n(t)e(of)h │ │ │ │ │ (output)h(|)f(taking)f Fo(msglvl)41 b(>=)i(3)19 b Fp(means)f(the)h │ │ │ │ │ Fo(InpMtx)390 490 y Fp(ob)5 b(ject)28 b(is)f(written)h(to)f(the)h │ │ │ │ │ (message)e(\014le.)307 627 y Fn(\210)42 b Fp(The)32 b │ │ │ │ │ Fo(msgFile)c Fp(parameter)i(determines)h(the)h(message)e(\014le)i(|)f │ │ │ │ │ (if)h Fo(msgFile)d Fp(is)i Fo(stdout)p Fp(,)f(then)i(the)g(message)390 │ │ │ │ │ 727 y(\014le)c(is)f Fm(stdout)p Fp(,)h(otherwise)e(a)i(\014le)f(is)h │ │ │ │ │ @@ -7322,50 +7314,49 @@ │ │ │ │ │ b(driv)n(er)f(program)f(reads)h(in)i Fo(InpMtx)d Fp(ob)5 │ │ │ │ │ b(ject)23 b(from)g(the)g(\014le)h Fo(inFile)d Fp(that)i(holds)g(a)g │ │ │ │ │ (matrix)g Fl(A)p Fp(.)36 b(It)23 b(then)h(creates)208 │ │ │ │ │ 5407 y(a)j Fo(Graph)e Fp(ob)5 b(ject)28 b(for)f Fl(B)g │ │ │ │ │ Fp(=)c Fl(A)1141 5377 y Fk(T)1193 5407 y Fl(A)28 b Fp(and)g(writes)f │ │ │ │ │ (it)h(to)f(the)h(\014le)g Fo(outFile)p Fp(.)p eop end │ │ │ │ │ %%Page: 18 18 │ │ │ │ │ -TeXDict begin 18 17 bop 0 100 a Fp(18)p 166 100 1140 │ │ │ │ │ -4 v 1305 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2760 100 V 307 390 a Fn(\210)42 │ │ │ │ │ -b Fp(The)19 b Fo(msglvl)e Fp(parameter)g(determines)i(the)h(amoun)n(t)e │ │ │ │ │ -(of)h(output)h(|)f(taking)f Fo(msglvl)41 b(>=)i(3)19 │ │ │ │ │ -b Fp(means)f(the)h Fo(InpMtx)390 490 y Fp(ob)5 b(ject)28 │ │ │ │ │ -b(is)f(written)h(to)f(the)h(message)e(\014le.)307 618 │ │ │ │ │ -y Fn(\210)42 b Fp(The)32 b Fo(msgFile)c Fp(parameter)i(determines)h │ │ │ │ │ -(the)h(message)e(\014le)i(|)f(if)h Fo(msgFile)d Fp(is)i │ │ │ │ │ -Fo(stdout)p Fp(,)f(then)i(the)g(message)390 718 y(\014le)c(is)f │ │ │ │ │ -Fm(stdout)p Fp(,)h(otherwise)e(a)i(\014le)f(is)h(op)r(ened)f(with)i │ │ │ │ │ -Fm(app)l(end)g Fp(status)e(to)g(receiv)n(e)g(an)n(y)g(output)h(data.) │ │ │ │ │ -307 846 y Fn(\210)42 b Fp(The)27 b Fo(inFile)e Fp(parameter)h(is)h(the) │ │ │ │ │ -h(input)g(\014le)f(for)g(the)g Fo(InpMtx)e Fp(ob)5 b(ject.)37 │ │ │ │ │ -b(It)27 b(m)n(ust)h(b)r(e)f(of)g(the)h(form)f Fo(*.inpmtxf)390 │ │ │ │ │ -946 y Fp(or)g Fo(*.inpmtxb)p Fp(.)33 b(The)27 b Fo(InpMtx)e │ │ │ │ │ -Fp(ob)5 b(ject)27 b(is)g(read)g(from)g(the)g(\014le)h(via)e(the)i │ │ │ │ │ -Fo(InpMtx)p 2941 946 27 4 v 29 w(readFromFile\(\))22 │ │ │ │ │ -b Fp(metho)r(d.)307 1075 y Fn(\210)42 b Fp(The)35 b Fo(outFile)d │ │ │ │ │ -Fp(parameter)h(is)i(the)g(output)g(\014le)g(for)f(the)h │ │ │ │ │ -Fo(InpMtx)e Fp(ob)5 b(ject.)58 b(If)35 b Fo(outFile)d │ │ │ │ │ -Fp(is)i Fo(none)f Fp(then)j(the)390 1174 y Fo(InpMtx)30 │ │ │ │ │ -b Fp(ob)5 b(ject)32 b(is)g(not)h(written)f(to)g(a)g(\014le.)51 │ │ │ │ │ -b(Otherwise,)33 b(the)g Fo(InpMtx)p 2675 1174 V 28 w(writeToFile\(\))27 │ │ │ │ │ -b Fp(metho)r(d)33 b(is)f(called)390 1274 y(to)d(write)g(the)h(ob)5 │ │ │ │ │ -b(ject)29 b(to)g(a)g(formatted)g(\014le)g(\(if)h Fo(outFile)d │ │ │ │ │ -Fp(is)i(of)g(the)h(form)f Fo(*.inpmtxf)p Fp(\),)d(or)j(a)f(binary)h │ │ │ │ │ -(\014le)g(\(if)390 1373 y Fo(outFile)c Fp(is)i(of)h(the)g(form)f │ │ │ │ │ -Fo(*.inpmtxb)p Fp(\).)101 1550 y(6.)42 b Fo(adjToGraph)d(msglvl)i │ │ │ │ │ -(msgFile)g(inAdjacencyFile)c(outGraphFile)i(flag)208 │ │ │ │ │ -1680 y Fp(This)23 b(driv)n(er)g(program)e(w)n(as)i(used)g(to)h │ │ │ │ │ -(generate)e(a)h Fo(type)42 b(0)24 b(Graph)d Fp(ob)5 b(ject)24 │ │ │ │ │ -b(\(unit)g(w)n(eigh)n(t)f(v)n(ertices)g(and)g(edges\))g(from)208 │ │ │ │ │ -1780 y(a)k(\014le)g(that)h(con)n(tained)f(the)h(adjacency)f(structure)g │ │ │ │ │ -(of)h(a)f(matrix)g(in)h(the)g(follo)n(wing)e(form.)469 │ │ │ │ │ -1968 y Fo(nvtx)42 b(nadj)469 2068 y(offsets[nvtx+1])469 │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fp(18)p 166 100 1158 │ │ │ │ │ +4 v 1322 w Fo(InpMtx)26 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)e(7,)j │ │ │ │ │ +(2024)p 2743 100 V 307 390 a Fn(\210)42 b Fp(The)19 b │ │ │ │ │ +Fo(msglvl)e Fp(parameter)g(determines)i(the)h(amoun)n(t)e(of)h(output)h │ │ │ │ │ +(|)f(taking)f Fo(msglvl)41 b(>=)i(3)19 b Fp(means)f(the)h │ │ │ │ │ +Fo(InpMtx)390 490 y Fp(ob)5 b(ject)28 b(is)f(written)h(to)f(the)h │ │ │ │ │ +(message)e(\014le.)307 618 y Fn(\210)42 b Fp(The)32 b │ │ │ │ │ +Fo(msgFile)c Fp(parameter)i(determines)h(the)h(message)e(\014le)i(|)f │ │ │ │ │ +(if)h Fo(msgFile)d Fp(is)i Fo(stdout)p Fp(,)f(then)i(the)g(message)390 │ │ │ │ │ +718 y(\014le)c(is)f Fm(stdout)p Fp(,)h(otherwise)e(a)i(\014le)f(is)h │ │ │ │ │ +(op)r(ened)f(with)i Fm(app)l(end)g Fp(status)e(to)g(receiv)n(e)g(an)n │ │ │ │ │ +(y)g(output)h(data.)307 846 y Fn(\210)42 b Fp(The)27 │ │ │ │ │ +b Fo(inFile)e Fp(parameter)h(is)h(the)h(input)g(\014le)f(for)g(the)g │ │ │ │ │ +Fo(InpMtx)e Fp(ob)5 b(ject.)37 b(It)27 b(m)n(ust)h(b)r(e)f(of)g(the)h │ │ │ │ │ +(form)f Fo(*.inpmtxf)390 946 y Fp(or)g Fo(*.inpmtxb)p │ │ │ │ │ +Fp(.)33 b(The)27 b Fo(InpMtx)e Fp(ob)5 b(ject)27 b(is)g(read)g(from)g │ │ │ │ │ +(the)g(\014le)h(via)e(the)i Fo(InpMtx)p 2941 946 27 4 │ │ │ │ │ +v 29 w(readFromFile\(\))22 b Fp(metho)r(d.)307 1075 y │ │ │ │ │ +Fn(\210)42 b Fp(The)35 b Fo(outFile)d Fp(parameter)h(is)i(the)g(output) │ │ │ │ │ +g(\014le)g(for)f(the)h Fo(InpMtx)e Fp(ob)5 b(ject.)58 │ │ │ │ │ +b(If)35 b Fo(outFile)d Fp(is)i Fo(none)f Fp(then)j(the)390 │ │ │ │ │ +1174 y Fo(InpMtx)30 b Fp(ob)5 b(ject)32 b(is)g(not)h(written)f(to)g(a)g │ │ │ │ │ +(\014le.)51 b(Otherwise,)33 b(the)g Fo(InpMtx)p 2675 │ │ │ │ │ +1174 V 28 w(writeToFile\(\))27 b Fp(metho)r(d)33 b(is)f(called)390 │ │ │ │ │ +1274 y(to)d(write)g(the)h(ob)5 b(ject)29 b(to)g(a)g(formatted)g(\014le) │ │ │ │ │ +g(\(if)h Fo(outFile)d Fp(is)i(of)g(the)h(form)f Fo(*.inpmtxf)p │ │ │ │ │ +Fp(\),)d(or)j(a)f(binary)h(\014le)g(\(if)390 1373 y Fo(outFile)c │ │ │ │ │ +Fp(is)i(of)h(the)g(form)f Fo(*.inpmtxb)p Fp(\).)101 1550 │ │ │ │ │ +y(6.)42 b Fo(adjToGraph)d(msglvl)i(msgFile)g(inAdjacencyFile)c │ │ │ │ │ +(outGraphFile)i(flag)208 1680 y Fp(This)23 b(driv)n(er)g(program)e(w)n │ │ │ │ │ +(as)i(used)g(to)h(generate)e(a)h Fo(type)42 b(0)24 b(Graph)d │ │ │ │ │ +Fp(ob)5 b(ject)24 b(\(unit)g(w)n(eigh)n(t)f(v)n(ertices)g(and)g │ │ │ │ │ +(edges\))g(from)208 1780 y(a)k(\014le)g(that)h(con)n(tained)f(the)h │ │ │ │ │ +(adjacency)f(structure)g(of)h(a)f(matrix)g(in)h(the)g(follo)n(wing)e │ │ │ │ │ +(form.)469 1968 y Fo(nvtx)42 b(nadj)469 2068 y(offsets[nvtx+1])469 │ │ │ │ │ 2167 y(indices[nadj])208 2356 y Fp(There)33 b(are)g Fo(nvtx)f │ │ │ │ │ Fp(v)n(ertices)h(in)h(the)g(graph)f(and)g(the)i(adjacency)e(v)n(ector)f │ │ │ │ │ (has)i Fo(nadj)e Fp(en)n(tries.)55 b(It)34 b(w)n(as)f(not)h(kno)n(wn) │ │ │ │ │ 208 2455 y(whether)27 b(the)h(adjacency)f(structure)h(con)n(tained)f │ │ │ │ │ Fo(\(v,v\))e Fp(en)n(tries)i(or)g(if)i(it)f(w)n(as)f(only)g(the)h(upp)r │ │ │ │ │ (er)g(or)f(lo)n(w)n(er)f(triangle.)208 2555 y(Our)k Fo(Graph)f │ │ │ │ │ Fp(ob)5 b(ject)31 b(is)g(symmetric)f(with)i(lo)r(ops,)f(i.e.,)h │ │ │ │ │ @@ -7426,17 +7417,17 @@ │ │ │ │ │ 5308 y Fp(This)22 b(driv)n(er)f(program)g(w)n(as)g(used)i(to)f │ │ │ │ │ (generate)g(a)g Fo(type)42 b(1)22 b(Graph)e Fp(ob)5 b(ject)23 │ │ │ │ │ b(\(w)n(eigh)n(ted)f(v)n(ertices,)g(unit)i(w)n(eigh)n(t)e(edges\))208 │ │ │ │ │ 5407 y(from)27 b(a)g(\014le)h(that)g(con)n(tained)f(the)h(adjacency)e │ │ │ │ │ (structure)h(of)h(a)f(matrix)g(in)h(the)g(follo)n(wing)f(form.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 19 19 │ │ │ │ │ -TeXDict begin 19 18 bop 83 100 1140 4 v 1306 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2679 100 V 1140 w Fp(19)469 390 y Fo(nvtx)42 b(nadj)469 │ │ │ │ │ +TeXDict begin 19 18 bop 83 100 1158 4 v 1323 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)36 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2662 100 V 1158 w Fp(19)469 390 y Fo(nvtx)42 b(nadj)469 │ │ │ │ │ 490 y(vwghts[nvtx])469 589 y(offsets[nvtx+1])469 689 │ │ │ │ │ y(indices[nadj])208 878 y Fp(There)33 b(are)g Fo(nvtx)f │ │ │ │ │ Fp(v)n(ertices)h(in)h(the)g(graph)f(and)g(the)i(adjacency)e(v)n(ector)f │ │ │ │ │ (has)i Fo(nadj)e Fp(en)n(tries.)55 b(It)34 b(w)n(as)f(not)h(kno)n(wn) │ │ │ │ │ 208 978 y(whether)27 b(the)h(adjacency)f(structure)h(con)n(tained)f │ │ │ │ │ Fo(\(v,v\))e Fp(en)n(tries)i(or)g(if)i(it)f(w)n(as)f(only)g(the)h(upp)r │ │ │ │ │ (er)g(or)f(lo)n(w)n(er)f(triangle.)208 1078 y(Our)k Fo(Graph)f │ │ │ │ │ @@ -7526,24 +7517,24 @@ │ │ │ │ │ Fp(is)j(the)g(\014le)g(that)h(holds)f(the)g Fo(Coords)e │ │ │ │ │ Fp(ob)5 b(ject)32 b(|)g(m)n(ust)g(b)r(e)h(of)f(the)h(form)e │ │ │ │ │ Fo(*.coordsf)e Fp(or)390 5278 y Fo(*.coordsb)p Fp(.)307 │ │ │ │ │ 5407 y Fn(\210)42 b Fp(The)28 b Fo(coordType)c Fp(determines)j(the)h │ │ │ │ │ (co)r(ordinate)f(t)n(yp)r(e)g(for)g(the)h Fo(InpMtx)e │ │ │ │ │ Fp(ob)5 b(ject.)p eop end │ │ │ │ │ %%Page: 20 20 │ │ │ │ │ -TeXDict begin 20 19 bop 0 100 a Fp(20)p 166 100 1140 │ │ │ │ │ -4 v 1305 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2760 100 V 456 390 a Fi({)41 │ │ │ │ │ -b Fo(1)28 b Fp(|)f(storage)f(of)i(en)n(tries)f(b)n(y)g(ro)n(ws)456 │ │ │ │ │ -516 y Fi({)41 b Fo(2)28 b Fp(|)f(storage)f(of)i(en)n(tries)f(b)n(y)g │ │ │ │ │ -(columns)456 642 y Fi({)41 b Fo(3)28 b Fp(|)f(storage)f(of)i(en)n │ │ │ │ │ -(tries)f(b)n(y)g(c)n(hevrons)307 795 y Fn(\210)42 b Fp(The)28 │ │ │ │ │ -b Fo(seed)f Fp(parameter)f(is)i(used)g(as)f(a)h(random)f(n)n(um)n(b)r │ │ │ │ │ -(er)h(seed)g(to)f(determine)i(the)f(ro)n(w)f(and)g(column)h(p)r(erm)n │ │ │ │ │ -(u-)390 895 y(tations)f(for)g(the)h(matrix-v)n(ector)e(m)n(ultiply)-7 │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fp(20)p 166 100 1158 │ │ │ │ │ +4 v 1322 w Fo(InpMtx)26 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)e(7,)j │ │ │ │ │ +(2024)p 2743 100 V 456 390 a Fi({)41 b Fo(1)28 b Fp(|)f(storage)f(of)i │ │ │ │ │ +(en)n(tries)f(b)n(y)g(ro)n(ws)456 516 y Fi({)41 b Fo(2)28 │ │ │ │ │ +b Fp(|)f(storage)f(of)i(en)n(tries)f(b)n(y)g(columns)456 │ │ │ │ │ +642 y Fi({)41 b Fo(3)28 b Fp(|)f(storage)f(of)i(en)n(tries)f(b)n(y)g(c) │ │ │ │ │ +n(hevrons)307 795 y Fn(\210)42 b Fp(The)28 b Fo(seed)f │ │ │ │ │ +Fp(parameter)f(is)i(used)g(as)f(a)h(random)f(n)n(um)n(b)r(er)h(seed)g │ │ │ │ │ +(to)f(determine)i(the)f(ro)n(w)f(and)g(column)h(p)r(erm)n(u-)390 │ │ │ │ │ +895 y(tations)f(for)g(the)h(matrix-v)n(ector)e(m)n(ultiply)-7 │ │ │ │ │ b(.)307 1047 y Fn(\210)42 b Fp(The)23 b Fo(outInpMtxFile)18 │ │ │ │ │ b Fp(parameter)j(is)i(the)g(output)h(\014le)f(for)f(the)h │ │ │ │ │ Fo(InpMtx)e Fp(ob)5 b(ject.)35 b(If)23 b Fo(outInpMtxFile)18 │ │ │ │ │ b Fp(is)23 b Fo(none)390 1147 y Fp(then)j(the)g Fo(InpMtx)e │ │ │ │ │ Fp(ob)5 b(ject)25 b(is)h(not)f(written)h(to)g(a)f(\014le.)36 │ │ │ │ │ b(Otherwise,)26 b(the)g Fo(InpMtx)p 2928 1147 27 4 v │ │ │ │ │ 29 w(writeToFile\(\))20 b Fp(metho)r(d)26 b(is)390 1246 │ │ │ │ │ @@ -7603,17 +7594,17 @@ │ │ │ │ │ 4969 y(...)556 5069 y(xnpts)42 b(ynpts)f(])i(;)208 5308 │ │ │ │ │ y Fp(whic)n(h)24 b(can)h(b)r(e)g(used)g(to)g(generate)e(the)i(follo)n │ │ │ │ │ (wing)f(matlab)h(plot.)36 b(An)25 b(example)f(is)h(giv)n(en)f(b)r(elo)n │ │ │ │ │ (w)h(for)f(the)h Fa(bcsstk23)208 5407 y Fp(matrix,)i(where)g │ │ │ │ │ Fo(npts)42 b(=)h(200)p Fp(,)26 b Fo(tausmall)41 b(=)i(1.e-10)25 │ │ │ │ │ b Fp(and)i Fo(taubig)42 b(=)h(1.e100)p Fp(.)p eop end │ │ │ │ │ %%Page: 21 21 │ │ │ │ │ -TeXDict begin 21 20 bop 83 100 1140 4 v 1306 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2679 100 V 1140 w Fp(21)1154 1747 y @beginspecial 47 │ │ │ │ │ +TeXDict begin 21 20 bop 83 100 1158 4 v 1323 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)36 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2662 100 V 1158 w Fp(21)1154 1747 y @beginspecial 47 │ │ │ │ │ @llx 197 @lly 550 @urx 604 @ury 2160 @rwi 1728 @rhi @setspecial │ │ │ │ │ %%BeginDocument: ../../InpMtx/doc/BCSSTK23.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%Creator: MATLAB, The Mathworks, Inc. │ │ │ │ │ %%Title: profile.eps │ │ │ │ │ %%CreationDate: 03/13/97 09:20:11 │ │ │ │ │ %%DocumentNeededFonts: Helvetica │ │ │ │ │ @@ -8018,37 +8009,36 @@ │ │ │ │ │ Fo(InpMtx)c Fp(ob)5 b(ject)43 b(that)g(holds)g(the)g(matrix.)83 │ │ │ │ │ b(It)390 5308 y(m)n(ust)40 b(b)r(e)f(of)h(the)f(form)g │ │ │ │ │ Fo(*.inpmtxf)d Fp(or)j Fo(*.inpmtxb)p Fp(.)68 b(The)39 │ │ │ │ │ b Fo(InpMtx)e Fp(ob)5 b(ject)39 b(is)h(written)f(to)g(the)h(\014le)g │ │ │ │ │ (via)390 5407 y(the)28 b Fo(InpMtx)p 802 5407 V 29 w(writeToFile\(\))22 │ │ │ │ │ b Fp(metho)r(d.)p eop end │ │ │ │ │ %%Page: 22 22 │ │ │ │ │ -TeXDict begin 22 21 bop 0 100 a Fp(22)p 166 100 1140 │ │ │ │ │ -4 v 1305 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(F)-7 │ │ │ │ │ -b(ebruary)27 b(8,)g(2025)p 2760 100 V 60 390 a Fp(12.)41 │ │ │ │ │ -b Fo(testMMM)f(msglvl)h(msgFile)g(dataType)f(symflag)h(coordType)f │ │ │ │ │ -(transpose)556 490 y(nrow)i(ncol)g(nitem)g(nrhs)g(seed)f(alphaReal)f │ │ │ │ │ -(alphaImag)208 623 y Fp(This)32 b(driv)n(er)f(program)f(tests)i(the)h │ │ │ │ │ -(matrix-matrix)e(m)n(ultiply)h(metho)r(ds.)52 b(This)32 │ │ │ │ │ -b(driv)n(er)f(program)f(generates)h Fl(A)p Fp(,)i(a)208 │ │ │ │ │ -723 y Fo(nrow)14 b Fg(\002)i Fo(ncol)25 b Fp(matrix)h(using)g │ │ │ │ │ -Fo(nitem)f Fp(input)i(en)n(tries,)f Fl(X)33 b Fp(and)26 │ │ │ │ │ -b Fl(Y)19 b Fp(,)27 b Fo(nrow)15 b Fg(\002)h Fo(nrhs)25 │ │ │ │ │ -b Fp(matrices,)h(and)g(all)g(are)g(\014lled)h(with)208 │ │ │ │ │ -823 y(random)33 b(n)n(um)n(b)r(ers.)58 b(It)35 b(then)h(computes)e │ │ │ │ │ -Fl(Y)54 b Fp(:=)34 b Fl(Y)42 b Fp(+)23 b Fl(\013AX)7 │ │ │ │ │ -b Fp(,)37 b Fl(Y)53 b Fp(:=)35 b Fl(Y)42 b Fp(+)23 b │ │ │ │ │ -Fl(\013A)2748 792 y Fk(T)2801 823 y Fl(X)41 b Fp(or)34 │ │ │ │ │ -b Fl(Y)53 b Fp(:=)35 b Fl(Y)42 b Fp(+)23 b Fl(\013A)3537 │ │ │ │ │ -792 y Fk(H)3600 823 y Fl(X)7 b Fp(.)58 b(The)208 922 │ │ │ │ │ -y(program's)25 b(output)j(is)g(a)f(\014le)g(whic)n(h)h(when)g(sen)n(t)f │ │ │ │ │ -(in)n(to)h(Matlab,)f(outputs)h(the)g(error)d(in)j(the)g(computation.) │ │ │ │ │ -307 1106 y Fn(\210)42 b Fp(The)19 b Fo(msglvl)e Fp(parameter)g │ │ │ │ │ -(determines)i(the)h(amoun)n(t)e(of)h(output)h(|)f(taking)f │ │ │ │ │ -Fo(msglvl)41 b(>=)i(3)19 b Fp(means)f(the)h Fo(InpMtx)390 │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fp(22)p 166 100 1158 │ │ │ │ │ +4 v 1322 w Fo(InpMtx)26 b Fj(:)37 b Fm(DRAFT)27 b Fj(Jan)n(uary)e(7,)j │ │ │ │ │ +(2024)p 2743 100 V 60 390 a Fp(12.)41 b Fo(testMMM)f(msglvl)h(msgFile)g │ │ │ │ │ +(dataType)f(symflag)h(coordType)f(transpose)556 490 y(nrow)i(ncol)g │ │ │ │ │ +(nitem)g(nrhs)g(seed)f(alphaReal)f(alphaImag)208 623 │ │ │ │ │ +y Fp(This)32 b(driv)n(er)f(program)f(tests)i(the)h(matrix-matrix)e(m)n │ │ │ │ │ +(ultiply)h(metho)r(ds.)52 b(This)32 b(driv)n(er)f(program)f(generates)h │ │ │ │ │ +Fl(A)p Fp(,)i(a)208 723 y Fo(nrow)14 b Fg(\002)i Fo(ncol)25 │ │ │ │ │ +b Fp(matrix)h(using)g Fo(nitem)f Fp(input)i(en)n(tries,)f │ │ │ │ │ +Fl(X)33 b Fp(and)26 b Fl(Y)19 b Fp(,)27 b Fo(nrow)15 │ │ │ │ │ +b Fg(\002)h Fo(nrhs)25 b Fp(matrices,)h(and)g(all)g(are)g(\014lled)h │ │ │ │ │ +(with)208 823 y(random)33 b(n)n(um)n(b)r(ers.)58 b(It)35 │ │ │ │ │ +b(then)h(computes)e Fl(Y)54 b Fp(:=)34 b Fl(Y)42 b Fp(+)23 │ │ │ │ │ +b Fl(\013AX)7 b Fp(,)37 b Fl(Y)53 b Fp(:=)35 b Fl(Y)42 │ │ │ │ │ +b Fp(+)23 b Fl(\013A)2748 792 y Fk(T)2801 823 y Fl(X)41 │ │ │ │ │ +b Fp(or)34 b Fl(Y)53 b Fp(:=)35 b Fl(Y)42 b Fp(+)23 b │ │ │ │ │ +Fl(\013A)3537 792 y Fk(H)3600 823 y Fl(X)7 b Fp(.)58 │ │ │ │ │ +b(The)208 922 y(program's)25 b(output)j(is)g(a)f(\014le)g(whic)n(h)h │ │ │ │ │ +(when)g(sen)n(t)f(in)n(to)h(Matlab,)f(outputs)h(the)g(error)d(in)j(the) │ │ │ │ │ +g(computation.)307 1106 y Fn(\210)42 b Fp(The)19 b Fo(msglvl)e │ │ │ │ │ +Fp(parameter)g(determines)i(the)h(amoun)n(t)e(of)h(output)h(|)f(taking) │ │ │ │ │ +f Fo(msglvl)41 b(>=)i(3)19 b Fp(means)f(the)h Fo(InpMtx)390 │ │ │ │ │ 1206 y Fp(ob)5 b(ject)28 b(is)f(written)h(to)f(the)h(message)e(\014le.) │ │ │ │ │ 307 1339 y Fn(\210)42 b Fp(The)32 b Fo(msgFile)c Fp(parameter)i │ │ │ │ │ (determines)h(the)h(message)e(\014le)i(|)f(if)h Fo(msgFile)d │ │ │ │ │ Fp(is)i Fo(stdout)p Fp(,)f(then)i(the)g(message)390 1439 │ │ │ │ │ y(\014le)c(is)f Fm(stdout)p Fp(,)h(otherwise)e(a)i(\014le)f(is)h(op)r │ │ │ │ │ (ened)f(with)i Fm(app)l(end)g Fp(status)e(to)g(receiv)n(e)g(an)n(y)g │ │ │ │ │ (output)h(data.)307 1573 y Fn(\210)42 b Fo(dataType)25 │ │ │ │ │ @@ -8129,17 +8119,17 @@ │ │ │ │ │ (the)g(matrix.)307 5274 y Fn(\210)42 b Fo(nrhs)26 b Fp(is)i(the)g(n)n │ │ │ │ │ (um)n(b)r(er)f(of)h(columns)f(in)h Fl(X)34 b Fp(and)27 │ │ │ │ │ b Fl(Y)19 b Fp(.)307 5407 y Fn(\210)42 b Fp(The)21 b │ │ │ │ │ Fo(seed)e Fp(parameter)g(is)h(a)g(random)g(n)n(um)n(b)r(er)g(seed)g │ │ │ │ │ (used)g(to)h(\014ll)f(the)h(matrix)f(en)n(tries)g(with)h(random)f(n)n │ │ │ │ │ (um)n(b)r(ers.)p eop end │ │ │ │ │ %%Page: 23 23 │ │ │ │ │ -TeXDict begin 23 22 bop 83 100 1140 4 v 1306 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2679 100 V 1140 w Fp(23)307 390 y Fn(\210)42 b Fo(alphaReal)24 │ │ │ │ │ +TeXDict begin 23 22 bop 83 100 1158 4 v 1323 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)36 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2662 100 V 1158 w Fp(23)307 390 y Fn(\210)42 b Fo(alphaReal)24 │ │ │ │ │ b Fp(and)k Fo(alphaImag)c Fp(form)j(the)h Fl(\013)g Fp(scalar)e(in)i │ │ │ │ │ (the)g(m)n(ultiply)-7 b(.)307 523 y Fn(\210)42 b Fo(betaReal)25 │ │ │ │ │ b Fp(and)i Fo(betaImag)d Fp(form)k(the)g Fl(\014)k Fp(scalar)26 │ │ │ │ │ b(in)h(the)h(m)n(ultiply)-7 b(.)60 706 y(14.)41 b Fo(testGMVM)f(msglvl) │ │ │ │ │ h(msgFile)g(dataType)f(symflag)h(coordType)e(transpose)600 │ │ │ │ │ 805 y(nrow)j(ncol)g(nitem)f(seed)h(alphaReal)e(alphaImag)g(betaReal)g │ │ │ │ │ (betaImag)208 938 y Fp(This)18 b(driv)n(er)g(program)e(tests)j(the)g │ │ │ │ │ @@ -8320,17 +8310,17 @@ │ │ │ │ │ y Fo(InpMtx)p 2261 5005 V 28 w(storageMode\(\))p Fp(,)h(5)1992 │ │ │ │ │ 5105 y Fo(InpMtx)p 2261 5105 V 28 w(supportNonsym\(\))p │ │ │ │ │ Fp(,)f(9)1992 5206 y Fo(InpMtx)p 2261 5206 V 28 w(supportNonsymH\(\))p │ │ │ │ │ Fp(,)g(9)1992 5307 y Fo(InpMtx)p 2261 5307 V 28 w(supportNonsymT\(\))p │ │ │ │ │ Fp(,)g(9)1992 5407 y Fo(InpMtx)p 2261 5407 V 28 w(supportSym\(\))p │ │ │ │ │ Fp(,)h(9)1908 5656 y(24)p eop end │ │ │ │ │ %%Page: 25 25 │ │ │ │ │ -TeXDict begin 25 24 bop 83 100 1140 4 v 1306 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2679 100 V 1140 w Fp(25)0 390 y Fo(InpMtx)p 269 390 27 │ │ │ │ │ +TeXDict begin 25 24 bop 83 100 1158 4 v 1323 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)36 b Fm(DRAFT)111 b Fj(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2662 100 V 1158 w Fp(25)0 390 y Fo(InpMtx)p 269 390 27 │ │ │ │ │ 4 v 29 w(supportSymH\(\))p Fp(,)22 b(9)0 490 y Fo(InpMtx)p │ │ │ │ │ 269 490 V 29 w(sym)p 430 490 V 30 w(gmmm\(\))p Fp(,)j(11)0 │ │ │ │ │ 589 y Fo(InpMtx)p 269 589 V 29 w(sym)p 430 589 V 30 w(gmvm\(\))p │ │ │ │ │ Fp(,)g(11)0 689 y Fo(InpMtx)p 269 689 V 29 w(sym)p 430 │ │ │ │ │ 689 V 30 w(mmm\(\))p Fp(,)h(10)0 789 y Fo(InpMtx)p 269 │ │ │ │ │ 789 V 29 w(vecids\(\))p Fp(,)e(6)0 888 y Fo(InpMtx)p │ │ │ │ │ 269 888 V 29 w(vector\(\))p Fp(,)g(6)0 988 y Fo(InpMtx)p │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -28,15 +28,15 @@ │ │ │ │ │ │ be efficient to have sufficient elbow room to minimize the number of sorts and compressions. In this │ │ │ │ │ │ case, a tight upper bound on the necessary storage is the sum of the sizes of the elemental matrices. │ │ │ │ │ │ The entries are assembled by a call to InpMtx changeStorageMode(). │ │ │ │ │ │ T │ │ │ │ │ │ 5. CreateanIVLobjectthatcontainsthefull adjacencyofA+A bycallingtheInpMtx fullAdjacency() │ │ │ │ │ │ method. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 6. Create a Graph object using the Graph init2() method and the IVL object as an input argument. │ │ │ │ │ │ A similar functionality exists for creating a Graph object from a linear combination of two InpMtx objects │ │ │ │ │ │ that contains the matrices A and B. The InpMtx fullAdjacency2() method returns an IVL object with │ │ │ │ │ │ the full adjacency of (A+B)+(A+B)T. These two methods are called by the DPencil fullAdjacency() │ │ │ │ │ │ methods to return the full adjacency of a matrix pencil. │ │ │ │ │ │ Here is a common sequence of events to use this object when we want to assemble the entries of a sparse │ │ │ │ │ │ matrix. │ │ │ │ │ │ @@ -68,15 +68,15 @@ │ │ │ │ │ │ j,j j,k k,j │ │ │ │ │ │ – INPMTX CUSTOM — custom coordinates. │ │ │ │ │ │ • int storageMode : mode of storage │ │ │ │ │ │ – INPMTX RAW DATA — data is raw pairs or triples, two coordinates and (optionally) one or two │ │ │ │ │ │ double precision values. │ │ │ │ │ │ – INPMTX SORTED — data is sorted and distinct triples, the primary key is the first coordinate, the │ │ │ │ │ │ secondary key is the second coordinate. │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 3 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 3 │ │ │ │ │ │ – INPMTX BY VECTORS — data is sorted and distinct vectors. All entries in a vector share some- │ │ │ │ │ │ thing in common. For example, when coordType is INPMTX BY ROWS, INPMTX BY COLUMNS or │ │ │ │ │ │ INPMTX BY CHEVRONS, row vectors, column vectors, or chevron vectors are stored, respectively. │ │ │ │ │ │ WhencoordTypeis INPMTX CUSTOM, a custom type, entries in the same vector have something in │ │ │ │ │ │ common but it need not be a common row, column or chevron coordinate. │ │ │ │ │ │ • int inputMode : mode of data input │ │ │ │ │ │ – INPMTX INDICES ONLY — only indices are stored, not entries. │ │ │ │ │ │ @@ -106,15 +106,15 @@ │ │ │ │ │ │ • INPMTX IS BY COLUMNS(mtx) returns 1 if the entries are stored by columns, and 0 otherwise. │ │ │ │ │ │ • INPMTX IS BY CHEVRONS(mtx) returns 1 if the entries are stored by chevrons, and 0 otherwise. │ │ │ │ │ │ • INPMTX IS BY CUSTOM(mtx) returns 1 if the entries are stored by some custom coordinate, and 0 │ │ │ │ │ │ otherwise. │ │ │ │ │ │ • INPMTX IS RAW DATA(mtx) returns 1 if the entries are stored as unsorted pairs or triples, and 0 other- │ │ │ │ │ │ wise. │ │ │ │ │ │ • INPMTX IS SORTED(mtx) returns 1 if the entries are stored as sorted pairs or triples, and 0 otherwise. │ │ │ │ │ │ - 4 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ • INPMTX IS BY VECTORS(mtx) returns 1 if the entries are stored as vectors, and 0 otherwise. │ │ │ │ │ │ • INPMTX IS INDICES ONLY(mtx) returns 1 if the entries are not stored, and 0 otherwise. │ │ │ │ │ │ • INPMTX IS REAL ENTRIES(mtx) returns 1 if the entries are real, and 0 otherwise. │ │ │ │ │ │ • INPMTX IS COMPLEX ENTRIES(mtx) returns 1 if the entries are complex, and 0 otherwise. │ │ │ │ │ │ 1.2 Prototypes and descriptions of InpMtx methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the InpMtx object. │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ @@ -140,15 +140,15 @@ │ │ │ │ │ │ 1. int InpMtx_coordType ( InpMtx *inpmtx ) ; │ │ │ │ │ │ This method returns the coordinate type. │ │ │ │ │ │ • INPMTX NO TYPE – none specified │ │ │ │ │ │ • INPMTX BY ROWS – storage by row triples │ │ │ │ │ │ • INPMTX BY COLUMNS – storage by column triples │ │ │ │ │ │ • INPMTX BY CHEVRONS – storage by chevron triples │ │ │ │ │ │ • INPMTX CUSTOM – custom type │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 5 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 5 │ │ │ │ │ │ Error checking: If inpmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. int InpMtx_storageMode ( InpMtx *inpmtx ) ; │ │ │ │ │ │ This method returns the storage mode. │ │ │ │ │ │ • INPMTX NO MODE – none specified │ │ │ │ │ │ • INPMTX RAW DATA – raw triples │ │ │ │ │ │ • INPMTX SORTED – sorted and distinct triples │ │ │ │ │ │ • INPMTX BY VECTORS – vectors by the first coordinate │ │ │ │ │ │ @@ -176,15 +176,15 @@ │ │ │ │ │ │ Error checking: If inpmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 9. int * InpMtx_ivec1 ( InpMtx *inpmtx ) ; │ │ │ │ │ │ This method returns the base address of the ivec1[] vector. │ │ │ │ │ │ Error checking: If inpmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 10. int * InpMtx_ivec2 ( InpMtx *inpmtx ) ; │ │ │ │ │ │ This method returns the base address of the ivec2[] vector. │ │ │ │ │ │ Error checking: If inpmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 6 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 11. double * InpMtx_dvec ( InpMtx *inpmtx ) ; │ │ │ │ │ │ This method returns the base address of the dvec[] vector. │ │ │ │ │ │ Error checking: If inpmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 12. int * InpMtx_vecids ( InpMtx *inpmtx ) ; │ │ │ │ │ │ This method returns the base address of the vecids[] vector. │ │ │ │ │ │ Error checking: If inpmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 13. int * InpMtx_sizes ( InpMtx *inpmtx ) ; │ │ │ │ │ │ @@ -217,15 +217,15 @@ │ │ │ │ │ │ This method sets the maxinum number of entries in the indices and entries vectors. │ │ │ │ │ │ Error checking: If inpmtx is NULL, or if newmaxnent < 0, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 18. void InpMtx_setNent ( InpMtx *inpmtx, int newnent ) ; │ │ │ │ │ │ This method sets the present number of entries in the indices and entries vectors. │ │ │ │ │ │ Error checking: If inpmtx is NULL, or if newnent < 0, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 7 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 7 │ │ │ │ │ │ 19. void InpMtx_setMaxnvector ( InpMtx *inpmtx, int newmaxnvector ) ; │ │ │ │ │ │ This method sets the maxinum number of vectors. │ │ │ │ │ │ Error checking: If inpmtx is NULL, or if newmaxnvector < 0, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 20. void InpMtx_setNvector ( InpMtx *inpmtx, int newnvector ) ; │ │ │ │ │ │ This method sets the present number of vectors. │ │ │ │ │ │ Error checking: If inpmtx is NULL, or if newnvector < 0, an error message is printed and the program │ │ │ │ │ │ @@ -261,15 +261,15 @@ │ │ │ │ │ │ exits. │ │ │ │ │ │ 3. void InpMtx_changeStorageMode ( InpMtx *inpmtx, int newMode ) ; │ │ │ │ │ │ If storageMode = newMode, the method returns. Otherwise, a translation between the three valid │ │ │ │ │ │ modes is made by calling InpMtx sortAndCompress()and InpMtx convertToVectors(),as appropri- │ │ │ │ │ │ ate. │ │ │ │ │ │ Error checking: If inpmtx is NULL or newMode is invalid, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - 8 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.4 Input methods │ │ │ │ │ │ 1. void InpMtx_inputEntry ( InpMtx *inpmtx, int row, int col ) ; │ │ │ │ │ │ void InpMtx_inputRealEntry ( InpMtx *inpmtx, int row, int col, double value ) ; │ │ │ │ │ │ void InpMtx_inputComplexEntry ( InpMtx *inpmtx, int row, int col, │ │ │ │ │ │ double real, double imag ) ; │ │ │ │ │ │ This method places a single entry into the matrix object. The coordinate type of the object must be │ │ │ │ │ │ INPMTX BY ROWS, INPMTX BY COLUMNS or INPMTX BY CHEVRONS. The triple is formed and inserted into │ │ │ │ │ │ @@ -307,15 +307,15 @@ │ │ │ │ │ │ Error checking: If inpmtx is NULL, or chv or chvsize are negative, or chvind or chvent are NULL, an │ │ │ │ │ │ error message is printed and the program exits. │ │ │ │ │ │ 5. void InpMtx_inputMatrix ( InpMtx *inpmtx, int nrow, int col, │ │ │ │ │ │ int rowstride, int colstride, int rowind[], int colind[] ) ; │ │ │ │ │ │ void InpMtx_inputRealMatrix ( InpMtx *inpmtx, int nrow, int col, │ │ │ │ │ │ int rowstride, int colstride, int rowind[], int colind[], double mtxent[] ) ; │ │ │ │ │ │ void InpMtx_inputComplexMatrix ( InpMtx *inpmtx, int nrow, int col, │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 9 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 9 │ │ │ │ │ │ int rowstride, int colstride, int rowind[], int colind[], double mtxent[] ) ; │ │ │ │ │ │ This method places a dense submatrix into the matrix object. The coordinate type of the object must │ │ │ │ │ │ be INPMTX BY ROWS, INPMTX BY COLUMNS or INPMTX BY CHEVRONS. The individual entries of the matrix │ │ │ │ │ │ are placed into the vector storage as triples, and the vectors are resized if necessary. │ │ │ │ │ │ Error checking: If inpmtx is NULL, or col or row are negative, or rowstride or colstride are less │ │ │ │ │ │ than 1, or rowind, colind or mtxent are NULL, an error message is printed and the program exits. │ │ │ │ │ │ 6. void InpMtx_inputTriples ( InpMtx *inpmtx, int ntriples, │ │ │ │ │ │ @@ -351,15 +351,15 @@ │ │ │ │ │ │ and A will contain only part of the larger global matrix A. Finding the row an column support enables │ │ │ │ │ │ one to construct local data structures for X and the product αAX. │ │ │ │ │ │ Error checking: If A or supIV is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. void InpMtx_mapEntries ( InpMtx *A, IV *rowmapIV, IV *colmapIV ) ; │ │ │ │ │ │ These methods are used to map a matrix from one numbering system to another. The primary use of │ │ │ │ │ │ this method is to map a part of a distributed matrix between the global and local numberings. │ │ │ │ │ │ Error checking: If A, rowmapIV or colmapIV is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 10 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 4. void InpMtx_permute ( InpMtx *inpmtx, int rowOldToNew[], int colOldToNew[] ) ; │ │ │ │ │ │ This method permutes the rows and or columns of the matrix. If rowOldToNew and colOldToNew are │ │ │ │ │ │ both NULL, or if there are no entries in the matrix, the method returns. Note, either rowOldToNew or │ │ │ │ │ │ colOldToNew can be NULL. If coordType == INPMTX BY CHEVRONS, then the coordinates are changed │ │ │ │ │ │ to row coordinates. The coordinates are then mapped to their new values. The storageMode is set to │ │ │ │ │ │ 1, (raw triples). │ │ │ │ │ │ Error checking: If inpmtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ @@ -395,15 +395,15 @@ │ │ │ │ │ │ InpMtx nonsym mmm H() Y := Y +αA X nonsymmetric complex │ │ │ │ │ │ A, X and Y must all be real or all be complex. When A is real, then α = alpha[0]. When A is complex, │ │ │ │ │ │ then α = alpha[0] + i* alpha[1]. The values of α must be loaded into an array of length 1 or 2. │ │ │ │ │ │ Error checking: If A, Y or X are NULL, or if coordType is not INPMTX BY ROWS, INPMTX BY COLUMNS or │ │ │ │ │ │ INPMTX BY CHEVRONS,orifstorageModeisnotoneofINPMTX RAW DATA,INPMTX SORTEDorINPMTX BY VECTORS, │ │ │ │ │ │ or if inputModeis not SPOOLES REAL or SPOOLES COMPLEX,an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 11 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 11 │ │ │ │ │ │ 2. void InpMtx_nonsym_mmmVector ( InpMtx *A, DenseMtx *Y, double alpha[], DenseMtx *X ) ; │ │ │ │ │ │ void InpMtx_sym_mmmVector ( InpMtx *A, DenseMtx *Y, double alpha[], DenseMtx *X ) ; │ │ │ │ │ │ void InpMtx_herm_mmmVector ( InpMtx *A, DenseMtx *Y, double alpha[], DenseMtx *X ) ; │ │ │ │ │ │ void InpMtx_nonsym_mmmVector_T ( InpMtx *A, DenseMtx *Y, double alpha[], DenseMtx *X ) ; │ │ │ │ │ │ void InpMtx_nonsym_mmmVector_H ( InpMtx *A, DenseMtx *Y, double alpha[], DenseMtx *X ) ; │ │ │ │ │ │ These five methods perform the following computations. │ │ │ │ │ │ InpMtx nonsym mmm() y := y +αAx nonsymmetric real or complex │ │ │ │ │ │ @@ -443,15 +443,15 @@ │ │ │ │ │ │ -1 A is NULL -9 alpha is NULL │ │ │ │ │ │ -2 type of A is invalid -10 X is NULL │ │ │ │ │ │ -3 indices of entries of A are NULL -11 type of X is invalid │ │ │ │ │ │ -4 beta is NULL -12 bad dimensions and strides for X │ │ │ │ │ │ -5 Y is NULL -13 entries of X are NULL │ │ │ │ │ │ -6 type of Y is invalid -14 types of A, X and Y are not identical │ │ │ │ │ │ -7 bad dimensions and strides for Y -15 number of columns in X and Y are not equal │ │ │ │ │ │ - 12 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 4. int InpMtx_nonsym_gmvm ( InpMtx *A, double beta[], int ny, double y[], │ │ │ │ │ │ double alpha[], int nx, double x[] ) ; │ │ │ │ │ │ int InpMtx_sym_gmvm ( InpMtx *A, double beta[], int ny, double y[], │ │ │ │ │ │ double alpha[], int nx, double x[] ) ; │ │ │ │ │ │ int InpMtx_herm_gmvm ( InpMtx *A, double beta[], int ny, double y[], │ │ │ │ │ │ double alpha[], int nx, double x[] ) ; │ │ │ │ │ │ int InpMtx_nonsym_gmvm_T ( InpMtx *A, double beta[], int ny, double y[], │ │ │ │ │ │ @@ -492,15 +492,15 @@ │ │ │ │ │ │ Error checking: If inpmtxAisNULL,orifthecoordinatetypeisnotINPMTX BY ROWSorINPMTX BY COLUMNS, │ │ │ │ │ │ or if the storage mode is not INPMTX BY VECTORS, an error message is printed and the program exits. │ │ │ │ │ │ 3. IVL * InpMtx_adjForATA ( InpMtx *inpmtxA ) ; │ │ │ │ │ │ T │ │ │ │ │ │ This method creates and returns an IVL object that holds the full adjacency structure of A A, where │ │ │ │ │ │ inpmtxA contains the entries in A. │ │ │ │ │ │ Error checking: If inpmtxA is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 13 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 13 │ │ │ │ │ │ 1.2.8 Submatrix extraction method │ │ │ │ │ │ 1. int InpMtx_initFromSubmatrix ( InpMtx *B, InpMtx *A, IV *BrowsIV, │ │ │ │ │ │ IV *BcolsIV, int symmetryflag, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method fills B with the submatrix formed from the rows and columns of A found in BrowsIV and │ │ │ │ │ │ BcolsIV. The row and column indices in B are local with respect to BrowsIV and BcolsIV. │ │ │ │ │ │ Whensymmetryflagis SPOOLES SYMMETRICor SPOOLES HERMITIAN, then we assume that when i 6= j, │ │ │ │ │ │ A orA isstored, but not both. (A could be stored by rows of its upper triangle, or by columns of │ │ │ │ │ │ @@ -538,15 +538,15 @@ │ │ │ │ │ │ void InpMtx_mapToUpperTriangleH ( InpMtx *inpmtx ) ; │ │ │ │ │ │ If the InpMtxobject holds only the loweror upper triangle of a matrix (as when the matrix is symmetric │ │ │ │ │ │ or Hermitian), and is then permuted, it is not likely that the permuted object will only have entries in │ │ │ │ │ │ the lower or upper triangle. The first method moves a for i < j to a . The second method moves │ │ │ │ │ │ i,j j,i │ │ │ │ │ │ a for i > j to a , (If the matrix is Hermitian, the sign of the imaginary part of an entry is dealt with │ │ │ │ │ │ i,j j,i │ │ │ │ │ │ - 14 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 14 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ in the correct fashion.) In other words, using these methods will restore the lower or upper triangular │ │ │ │ │ │ structure after a permutation. │ │ │ │ │ │ Error checking: If inpmtx is NULL, or if coordType is invalid, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 5. void InpMtx_log10profile ( InpMtx *inpmtx, int npts, DV *xDV, DV *yDV, │ │ │ │ │ │ double tausmall, double taubig, │ │ │ │ │ │ int *pnzero, int *pnsmall, int *pnbig ) ; │ │ │ │ │ │ @@ -582,15 +582,15 @@ │ │ │ │ │ │ returned. If nitem is not positive, -9 is returned. Otherwise, 1 is returned. │ │ │ │ │ │ Return codes: │ │ │ │ │ │ 1 normal return -5 nrow or ncol negative │ │ │ │ │ │ -1 inpmtx is NULL -6 symflag is invalid │ │ │ │ │ │ -2 inputMode invalid -7 (symflag,inputMode)invalid │ │ │ │ │ │ -3 coordType invalid -8 (symflag,nrow,ncol)invalid │ │ │ │ │ │ -4 storageMode invalid -9 nitem negative │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 15 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 15 │ │ │ │ │ │ 1.2.10 IO methods │ │ │ │ │ │ There are the usual eight IO routines. The file structure of a InpMtx object is simple: The first en- │ │ │ │ │ │ tries in the file are coordType, storageMode, inputMode, nent and nvector. If nent > 0, then the │ │ │ │ │ │ ivec1IV and ivec2IV vectors follow, If nent > 0 and inputMode = SPOOLES REAL or SPOOLES COMPLEX, │ │ │ │ │ │ the dvecDVvectorfollows. If storageMode = INPMTX BY VECTORSand nvector > 0, the vecidsIV,sizesIV │ │ │ │ │ │ and offsetsIV vectors follow. │ │ │ │ │ │ 1. int InpMtx_readFromFile ( InpMtx *inpmtx, char *fn ) ; │ │ │ │ │ │ @@ -624,15 +624,15 @@ │ │ │ │ │ │ is returned. If an IO error is encountered from fwrite, zero is returned. │ │ │ │ │ │ Error checking: If inpmtx or fp is NULL, an error message is printed and the method returns zero. │ │ │ │ │ │ 7. int InpMtx_writeForHumanEye ( InpMtx *inpmtx, FILE *fp ) ; │ │ │ │ │ │ Thismethodwritestheobjecttoafilesuitableforreadingbyahuman. ThemethodInpMtx writeStats() │ │ │ │ │ │ is called to write out the header and statistics. The data is written out in the appropriate way, e.g., if │ │ │ │ │ │ the storage mode is by triples, triples are written out. The value 1 is returned. │ │ │ │ │ │ Error checking: If inpmtx or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - 16 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 16 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 8. int InpMtx_writeStats ( InpMtx *inpmtx, FILE *fp ) ; │ │ │ │ │ │ This method writes the statistics about the object to a file. human. The value 1 is returned. │ │ │ │ │ │ Error checking: If inpmtx or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 9. void InpMtx_writeForMatlab ( InpMtx *mtx, char *mtxname, FILE *fp ) ; │ │ │ │ │ │ This method writes out a InpMtx object to a file in a Matlab format. A sample line is │ │ │ │ │ │ a(10,5) = -1.550328201511e-01 + 1.848033378871e+00*i ; │ │ │ │ │ │ for complex matrices, or │ │ │ │ │ │ @@ -663,15 +663,15 @@ │ │ │ │ │ │ to write the object to a formatted file (if outFile is of the form *.inpmtxf), or a binary file (if │ │ │ │ │ │ outFile is of the form *.inpmtxb). │ │ │ │ │ │ 2. testFullAdj msglvl msgFile nvtx nent seed │ │ │ │ │ │ This driver program tests the InpMtx fullAdjacency() method. If first generates a InpMtx object │ │ │ │ │ │ filled with random entries of a matrix A and then constructs an IVL object that contains the full │ │ │ │ │ │ adjacency structure of A +AT, diagonal edges included. │ │ │ │ │ │ 1http://math.nist.gov/mcsd/Staff/KRemington/harwell io/harwell io.html │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 17 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 17 │ │ │ │ │ │ • Themsglvlparameterdeterminestheamountofoutput—takingmsglvl >= 3meanstheInpMtx │ │ │ │ │ │ object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • The nvtx parameter is the number of rows and columns in A. │ │ │ │ │ │ • The nent parameter is an upper bound on the number of entries in A. (Since the locations of the │ │ │ │ │ │ entries are generated via random numbers, there may be duplicate entries.) │ │ │ │ │ │ @@ -707,15 +707,15 @@ │ │ │ │ │ │ • The outFile parameter is the output file for the InpMtx object. If outFile is none then the │ │ │ │ │ │ InpMtx object is not written to a file. Otherwise, the InpMtx writeToFile() method is called │ │ │ │ │ │ to write the object to a formatted file (if outFile is of the form *.inpmtxf), or a binary file (if │ │ │ │ │ │ outFile is of the form *.inpmtxb). │ │ │ │ │ │ 5. createGraphForATA msglvl msgFile inFile outFile │ │ │ │ │ │ This driver program reads in InpMtx object from the file inFile that holds a matrix A. It then creates │ │ │ │ │ │ a Graph object for B = ATA and writes it to the file outFile. │ │ │ │ │ │ - 18 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 18 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ • Themsglvlparameterdeterminestheamountofoutput—takingmsglvl >= 3meanstheInpMtx │ │ │ │ │ │ object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • The inFile parameter is the input file for the InpMtx object. It must be of the form *.inpmtxf │ │ │ │ │ │ or *.inpmtxb. The InpMtx object is read from the file via the InpMtx readFromFile() method. │ │ │ │ │ │ • The outFile parameter is the output file for the InpMtx object. If outFile is none then the │ │ │ │ │ │ @@ -752,15 +752,15 @@ │ │ │ │ │ │ binary file (if outGraphFile is of the form *.graphb). │ │ │ │ │ │ • The flag parameter is used to specify whether the offsets and indices are 0-indexed (as in C) or │ │ │ │ │ │ 1-indexed (as in Fortran). If they are 1-indexed, the offsets and indices are decremented prior to │ │ │ │ │ │ loading into the InpMtx object. │ │ │ │ │ │ 7. weightedAdjToGraph msglvl msgFile inAdjacencyFile outGraphFile flag │ │ │ │ │ │ This driver program was used to generate a type 1 Graph object (weighted vertices, unit weight edges) │ │ │ │ │ │ from a file that contained the adjacency structure of a matrix in the following form. │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 19 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 19 │ │ │ │ │ │ nvtx nadj │ │ │ │ │ │ vwghts[nvtx] │ │ │ │ │ │ offsets[nvtx+1] │ │ │ │ │ │ indices[nadj] │ │ │ │ │ │ There are nvtx vertices in the graph and the adjacency vector has nadj entries. It was not known │ │ │ │ │ │ whether the adjacency structure contained (v,v) entries or if it was only the upper or lower triangle. │ │ │ │ │ │ Our Graph object is symmetric with loops, i.e., (u,v) is present if and only if (v,u) is present, and │ │ │ │ │ │ @@ -798,15 +798,15 @@ │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any message data. │ │ │ │ │ │ • The EGraphFile is the file that holds the EGraph object — must be of the form *.egraphf or │ │ │ │ │ │ *.egraphb. │ │ │ │ │ │ • The CoordsFile is the file that holds the Coords object — must be of the form *.coordsf or │ │ │ │ │ │ *.coordsb. │ │ │ │ │ │ • The coordType determines the coordinate type for the InpMtx object. │ │ │ │ │ │ - 20 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 20 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ – 1 — storage of entries by rows │ │ │ │ │ │ – 2 — storage of entries by columns │ │ │ │ │ │ – 3 — storage of entries by chevrons │ │ │ │ │ │ • The seed parameter is used as a random number seed to determine the row and column permu- │ │ │ │ │ │ tations for the matrix-vector multiply. │ │ │ │ │ │ • The outInpMtxFileparameteris the output file for the InpMtx object. If outInpMtxFileis none │ │ │ │ │ │ then the InpMtx object is not written to a file. Otherwise, the InpMtx writeToFile() method is │ │ │ │ │ │ @@ -839,15 +839,15 @@ │ │ │ │ │ │ profile plot. The message file will contain line of the form. │ │ │ │ │ │ data = [ ... │ │ │ │ │ │ x1 y1 │ │ │ │ │ │ ... │ │ │ │ │ │ xnpts ynpts ] ; │ │ │ │ │ │ which can be used to generate the following matlab plot. An example is given below for the bcsstk23 │ │ │ │ │ │ matrix, where npts = 200, tausmall = 1.e-10 and taubig = 1.e100. │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 21 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 21 │ │ │ │ │ │ BCSSTK23: profile of magnitudes of matrix entries │ │ │ │ │ │ 1600 │ │ │ │ │ │ 1400 │ │ │ │ │ │ 1200 │ │ │ │ │ │ 1000 │ │ │ │ │ │ 800 │ │ │ │ │ │ # of entries │ │ │ │ │ │ @@ -883,15 +883,15 @@ │ │ │ │ │ │ • n1 is the number of points in the first direction. │ │ │ │ │ │ • n2 is the number of points in the second direction. │ │ │ │ │ │ • n3 is the number of points in the third direction. │ │ │ │ │ │ • Theseedparameterisarandomnumberseedusedtofillthematrixentrieswithrandomnumbers. │ │ │ │ │ │ • The outFile parameter is the output file for the InpMtx object that holds the matrix. It │ │ │ │ │ │ must be of the form *.inpmtxf or *.inpmtxb. The InpMtx object is written to the file via │ │ │ │ │ │ the InpMtx writeToFile() method. │ │ │ │ │ │ - 22 InpMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 22 InpMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 12. testMMM msglvl msgFile dataType symflag coordType transpose │ │ │ │ │ │ nrow ncol nitem nrhs seed alphaReal alphaImag │ │ │ │ │ │ This driver program tests the matrix-matrix multiply methods. This driver program generates A, a │ │ │ │ │ │ nrow×ncol matrix using nitem input entries, X and Y, nrow×nrhs matrices, and all are filled with │ │ │ │ │ │ T H │ │ │ │ │ │ random numbers. It then computes Y := Y + αAX, Y := Y + αA X or Y := Y + αA X. The │ │ │ │ │ │ program’s output is a file which when sent into Matlab, outputs the error in the computation. │ │ │ │ │ │ @@ -930,15 +930,15 @@ │ │ │ │ │ │ T │ │ │ │ │ │ Y := βY +αA X. │ │ │ │ │ │ • nrowA is the number of rows in A │ │ │ │ │ │ • ncolA is the number of columns in A │ │ │ │ │ │ • nitem is the number of matrix entries that are assembled into the matrix. │ │ │ │ │ │ • nrhs is the number of columns in X and Y. │ │ │ │ │ │ • Theseedparameterisarandomnumberseedusedtofillthematrixentrieswithrandomnumbers. │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 23 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 23 │ │ │ │ │ │ • alphaReal and alphaImag form the α scalar in the multiply. │ │ │ │ │ │ • betaReal and betaImag form the β scalar in the multiply. │ │ │ │ │ │ 14. testGMVM msglvl msgFile dataType symflag coordType transpose │ │ │ │ │ │ nrow ncol nitem seed alphaReal alphaImag betaReal betaImag │ │ │ │ │ │ Thisdriverprogramteststhegeneralizedmatrix-vectormultiplymethods. ItgeneratesA, anrow×ncol │ │ │ │ │ │ matrix using nitem input entries, x and y, and fills the matrices with random numbers. It then │ │ │ │ │ │ T H │ │ │ │ │ │ @@ -1013,15 +1013,15 @@ │ │ │ │ │ │ InpMtx inputRealTriples(), 9 InpMtx sortAndCompress(), 13 │ │ │ │ │ │ InpMtx inputRow(), 8 InpMtx storageMode(), 5 │ │ │ │ │ │ InpMtx inputTriples(), 9 InpMtx supportNonsym(), 9 │ │ │ │ │ │ InpMtx ivec1(), 5 InpMtx supportNonsymH(), 9 │ │ │ │ │ │ InpMtx ivec2(), 5 InpMtx supportNonsymT(), 9 │ │ │ │ │ │ InpMtx log10profile(), 13 InpMtx supportSym(), 9 │ │ │ │ │ │ 24 │ │ │ │ │ │ - InpMtx : DRAFT February 8, 2025 25 │ │ │ │ │ │ + InpMtx : DRAFT January 7, 2024 25 │ │ │ │ │ │ InpMtx supportSymH(), 9 │ │ │ │ │ │ InpMtx sym gmmm(), 11 │ │ │ │ │ │ InpMtx sym gmvm(), 11 │ │ │ │ │ │ InpMtx sym mmm(), 10 │ │ │ │ │ │ InpMtx vecids(), 6 │ │ │ │ │ │ InpMtx vector(), 6 │ │ │ │ │ │ InpMtx writeForHumanEye(), 15 │ │ │ ├── ./usr/share/doc/spooles-doc/LinSol.ps.gz │ │ │ │ ├── LinSol.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o LinSol.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0426 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2991,21 +2991,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -3189,88 +3188,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -6547,26 +6541,25 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 66 /B put │ │ │ │ │ dup 67 /C put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ dup 71 /G put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 80 /P put │ │ │ │ │ dup 82 /R put │ │ │ │ │ dup 83 /S put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 100 /d put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 102 /f put │ │ │ │ │ dup 103 /g put │ │ │ │ │ dup 104 /h put │ │ │ │ │ dup 105 /i put │ │ │ │ │ @@ -6758,196 +6751,188 @@ │ │ │ │ │ 82032FBD2FCB6E403D34B85ED4053A8CB619BDD4DE001F4C3007B1F317579651 │ │ │ │ │ E6D6662189CC2D95AB85D7473F65C5D7B4AC63B0FE928F3400035D5A9D443D0D │ │ │ │ │ F3532B99F3AC26CB25EA3CD64C341159061E02EFBC7C033C05CD919BBD827A6A │ │ │ │ │ BFCF3BD739E32E7FE909AEE068D50FAC33605FFF98C7D0115FB860178FD03DB9 │ │ │ │ │ 7985B78E0AC21F2EA065FA841F5928FB85163B2E2D8F850DC7EE313912C45C28 │ │ │ │ │ 2783F6762C67882EFEDDC7E7567F91C16B16FD8D5A1ABF35B5586307701B91AD │ │ │ │ │ 54984598F2AD46FEE3D68A2731BEAA754C8E730FE0E84952EF77930E4118F8D7 │ │ │ │ │ -2F3AD7547BA1B44C698428BA878986BAD1DA8368E8F5B3774FCBE3C72540A92C │ │ │ │ │ -7BA6298D386975A4FE6B5612A807D5C03EE4582DBD9DD9BF6A01C6C70A9A765A │ │ │ │ │ -38D20AB1B02DA94DEF94BF1A2CD76923DACC5566750775CD474EAA165C02262F │ │ │ │ │ -2A896898A8F67CBCBCE53648ABE9CC1CAC420AAD2B48D9054F2A27FDA27BF115 │ │ │ │ │ -23732B2C0353E3035E724B186BBDB27C03905EF40F67F69E3F63A93FBEBCA436 │ │ │ │ │ -7803AEC143D8163B0686A713DDA163148F362FA5348389E0F834ABD204D14CB7 │ │ │ │ │ -AB6DFBFF780676E89ED96284B58545408904AD53098EE76659405336A5207814 │ │ │ │ │ -3FC60F431CFAB56AE03ED36E18D5B577B68431D905734282B590DB1CC6353A26 │ │ │ │ │ -58BE5C97A55E92ADDCD8D653EB41C38D55CE9E13F294A872DDEC30183118927E │ │ │ │ │ -5A666B87BFF4B6C1FC47420CF7F5F09CD664C837EB47F8ABB08D781F4FCAB771 │ │ │ │ │ -E7AE53830444ACC1584CD67F313CC24C00540D736CE272A7016AF0A8EDB799EB │ │ │ │ │ -77ABDEA80A2CC522B44993241F06F3887EF21BBD5D3E1807DACB8D485529C366 │ │ │ │ │ -A53FC7B59D3CDA9C921585F929D7526787D6D39F85551DE939943DE368D6A114 │ │ │ │ │ -BC1ED21FB4AEBB953CACE8A4F4FE64F2DBC1369A665D1602EE6E6720B3DA5408 │ │ │ │ │ -3726CAA187FFB3C368307E30983A1EF8824B296474EB337A799B6BD986A2913E │ │ │ │ │ -8C7EAB0AAEF8A94A614BD39ECDE8A091B713A409E6C86DEA50E7439BAE897AA8 │ │ │ │ │ -B488AF7EA12F5ED0B7EF4C73CA9F6C5FC1107DE9AB0861D7BDEEDD66F951FFC4 │ │ │ │ │ -DAED5500FA199A1E802817B8F037CE27C705D5D217235A9B33F16B632A6097F0 │ │ │ │ │ -5E7CCAB458FD34018922663E97562133D5643B6309F4A6160BDF02F8D5B33616 │ │ │ │ │ -EF31656C46660142E129CEA4EBE58DA394C01D5D62C0462ACD307C4BF0D584A7 │ │ │ │ │ -FEC00775D5F63BC4A476F980EBE56CD90B73998BF74DAECC40436ACBB6383D87 │ │ │ │ │ -A1063E9DE0CE3A63781B46D5A71A9400DB4E7D4AB056D98731126B4F203093B4 │ │ │ │ │ -703138C4E83E76DB827500C7F102B719313BE90740C0126E84F9B2EEF5627E1E │ │ │ │ │ -FFE51F09FAA92410D5BEB835D887E28987A1F373691C18DA6EDF196920B3BC51 │ │ │ │ │ -105F3D1FFECB2E6D5F71C601C83398A1BAB6AB096D86E926DBB47D9EB7E69D7A │ │ │ │ │ -7DB39558B746095DB68DD28D260C6B62FEE05AB5430C6AA9738F5C44CF02DBA4 │ │ │ │ │ -A44559DA5E995DED25ED8AF871444D6D9A1149B1BE969B249C23245FDA942F9F │ │ │ │ │ -E56D86ACE50F21675C5C24B5CDEE50B6FD83815C6B79A58081316FD0E77F2DF6 │ │ │ │ │ -0EC6211907354A8BED6F317EBFD7814F38E1CA71BA62998575FF9F35C10C5C30 │ │ │ │ │ -CFD3F9D211C22F4E0E2B9C4AA755237485385FA106EF77B480BF2C65234EF4B9 │ │ │ │ │ -FCB12ED6E9450DEF43F30676F55B8896549F8B2E5ED88AC19726264E4231BD64 │ │ │ │ │ -A42C86F3962BCD0C0A754C4EF562FEDB14CD7AAC6AA42D2D16191926234DF8B5 │ │ │ │ │ -B4C983F3EAC33502AF6540888E0F8B87A2645D49B27630DAD86E7791424EAE63 │ │ │ │ │ -9C015BC93793605D8BEDA3A1565DAD1C0859867422DA4C51A6CE6E3CF4F50EDD │ │ │ │ │ -DD9D734DFCB7465E75423EAEB17966966CF97C028037236B5F260B783032DFD5 │ │ │ │ │ -542EAC00C7F3F98AE811E71D6FD0E2D87505FE6E15A8B509A5B2005E65F6136F │ │ │ │ │ -A05E3DCD4036790994EF514AFB91B73C18CC1312B2D22F390ED23AE1BE2C2D6B │ │ │ │ │ -27C3B014EB57687B4DB0D3C9B52216478719FCDDC7CC500160D4A58A0A77CB1F │ │ │ │ │ -2ED9B9EF808026F41CAEA1E3A9C4D95D0ACEE488B872846E0103C72959FCC20E │ │ │ │ │ -F9621E315AB618C51F197C3013AFBF136A273FE208561D2F814E2FE3A2AC872A │ │ │ │ │ -001AC83D298F2E05A5C762977FF0F85BEBC4D254C72AC74A2FA0111E7E9A3A2D │ │ │ │ │ -71D817DDE93A58AEE96DB3B27A87E72575323120DAC819EA2A0302D12E0A3BFE │ │ │ │ │ -7FF8FC09691718420662B8A2E618F949A7C535BD506B2B9D87B3A993DD5E2164 │ │ │ │ │ -3D86DD900C7C4E6C5D0AF002357DA47C31F3316601FB5E29BAD57B379331209E │ │ │ │ │ -9BBB0A707370E182D38596BF99688E86991DB883E4B07F16E4C20FB8D541ACB8 │ │ │ │ │ -3589D15191725428763CD1CA910C7F7571C4A0A50543D8D0B883B3363ED5C919 │ │ │ │ │ -D4755052D7ADAC22F28D06F212128011CF19999ABA8B301DC1921949DB463E46 │ │ │ │ │ -9BAE901FD054B27FA93756B033DA04E81CA7AC851150830C23B6F11E2FE0CB1B │ │ │ │ │ -0FA22C96939305130A3B607805B2A8A136B96F6B34F6255D520F83A48C786A6D │ │ │ │ │ -7E4FCC80B1B124CDC8F84E69BC18DE3A8EDBD7FE417C0630C38207E4C1E4E54B │ │ │ │ │ -96CD4410D1DFCDD3282959C9932BE96156F9CFC71F3B391D4FA0320E8B4F5670 │ │ │ │ │ -DCCEB9D7321D267AC564395CFD6932DAF6AD3E2E0F460E55E704928A4EAD8967 │ │ │ │ │ -4F01400DA1F6437CDDDCA19A25079BB13DFB796644399E18E804CAD1D0AE0A35 │ │ │ │ │ -D9042EAB7C84D74DA86AD61262988834D694C5EDD662C87EB32567DC655B23C9 │ │ │ │ │ -2AC056071F43F9FC89F011338C1D35343E236869175728A1C4ECDE8072DB0262 │ │ │ │ │ -D146A054163D77DCB17A1199BC723BB89EB5F7779ADBF6D3C255EF5E4FB0FEC4 │ │ │ │ │ -9551B616C31C902CA9DBEBB950EBB39D3C967A873360E0F18F57886384679102 │ │ │ │ │ -A8CD9CDC3B6D987B9A9BA20E0134B78030A7CC9F9E4FC3A8EC5BEBE5BC86D6A6 │ │ │ │ │ -4BED35CFCB631CB2A6D990B21363475C48DD1F2F627D062259B775AE260FEE55 │ │ │ │ │ -DC5EC2A61988702BB68609A7C9B2460A3C68558F55B66DBBD955C2F334AC79C6 │ │ │ │ │ -03BDE546D5EB888E3F1511279407112C229CB6F6D3DC5BF17036D0F46F982F5A │ │ │ │ │ -5CA5AAB16BF36828D9FF1CC327C3B13B48B899F6DF423F22AB71EFFA9FCF0B0F │ │ │ │ │ -06C05D25B3B393DABD8D0110F6D80445C0C5F5B50E62EF7C9377E2A136E8DA07 │ │ │ │ │ -E06498DDBA33E8F2506F9EA05F9CD8FD6063679848BEF68EE1F7C256087A643E │ │ │ │ │ -F38DD6AF7D27F44ED80A61D10D587273DAF539FF374532BE6F1B4723D197927E │ │ │ │ │ -609960BC88B0A3ABF50D99457AA707D03B33515CECEA78550EE3D74336795920 │ │ │ │ │ -0B2BFBF026466C3D775222012D166B4A4AC6063E0DD3D57131CDCA2136127875 │ │ │ │ │ -BDFE549BE69B8454D58AE1E4EFC75EC204761D73C1DB4967FBD72AA6A4A691ED │ │ │ │ │ -50CFB5AC53D17DA5BCACC3DA7E904A9B9DDD29707BF8293EA02D8A2907FA6A02 │ │ │ │ │ -A4D4AF9F3F78F9FAEBDB9D62603F7ADB053C635694921EAAA290F138A82C6460 │ │ │ │ │ -37BC39AF2D55C2252890D4EC6C707A1F33EEA3FAD47D993ACF712FBEB4855780 │ │ │ │ │ -CAA7486BF78032979356F68BEC50B1503E42FC4CFD47E62B293603C819904229 │ │ │ │ │ -6CB3379D9736E2871A078D41C85EA333AD9544E45930DA716B6BDD3FE5E47BEF │ │ │ │ │ -A4E1EC87F4177A3EB3F1DF033977F92A4C60C5E1567B6DAA5AAA90E101893F48 │ │ │ │ │ -35C421EB30763CCAABF9CC843E0EBCA545F99CA3B8CFC9143DD50D22958A4EE7 │ │ │ │ │ -AFEF5FFA49691C12729EA41AF84989C639473276DAD5BF9A06548437CF2BF35D │ │ │ │ │ -42931452E37FC1D4F2BD854F56B6FA6098E4D4CAF104DD65BD1CDAA8655CE9B3 │ │ │ │ │ -24AD58BD1307F4EE67584C7D54A6C4147789E6E719311272B4C48DB0B0363A83 │ │ │ │ │ -AABDE54757E89B97839A64B59269823C087AB0E86D45FB8BCA7003EBCA34011D │ │ │ │ │ -C0BB0DA3CB516C7B7FF2AD33D416EEAF3521EEBD916EEAE6663CC3FB07F46E19 │ │ │ │ │ -5159D93BC85B645BEB8FB1803A6BF70C74D8EFEB304710059A217F48191E8E11 │ │ │ │ │ -2250C0E9191F4B880523CF1DB4D4EC8121129CD0E2797B013617E2B02F894BE3 │ │ │ │ │ -90339F7FF9ACE8A4E641D6816FCECB98FE88E1C5065F1FEA7A3064B38FF74CE0 │ │ │ │ │ -32A0D88B2CAF668F9BC7EF58D3E938087F45D562FBE673F58202E5AC82721C3B │ │ │ │ │ -8FAC4F20C5C70D51B76A2BD921937DE65392895569CCC1186564B121F09A52F3 │ │ │ │ │ -284D29ECF7854042709CDDCCA24AA08B05DDB42B4A93E199AA27209363B258A1 │ │ │ │ │ -9917D9658D23A7A65D6B8F47AB41032180AE8C2E9359EF686CAE3049CA0C5DD1 │ │ │ │ │ -F6A6D92F61A7A56C8BD58385B2CFE78B3466A655563A116D2E0A8534951C6244 │ │ │ │ │ -174A15FA452280A82466A9A9547AB287459FBA2C3F150F7FC623C794FDA4E0B6 │ │ │ │ │ -3C78F552D411F76FCABF84A61B23B33DBA3B026493D9F103DED377E150509585 │ │ │ │ │ -0C9D931B1654A75058A0CE4690D4FA6E46368B4E23DF7B86FF43D5E3D5F839AB │ │ │ │ │ -437CC9765462AC0CD27FAD394FE555E54078C3914C4BED201E6571C5922CA664 │ │ │ │ │ -DD568DF9A9D32FED9A9C55521E2F48FCEFEE06E62C410C2CCE5A3E3A8E311E07 │ │ │ │ │ -3172A7A2D3968EC7CA8ED78341EC5140D5AF7FA2901E62EF8899AD7AAFC99AE3 │ │ │ │ │ -D41429AE6F8EB6FCAD35A97E7489A4E90220FD7E535BFCEE06E9C154AAC504FD │ │ │ │ │ -042301CC9ED0735D7E3F13431EDF1433FB9788EFE5F14447793BA18331FAB2B8 │ │ │ │ │ -0C59464F87969A9BEF81D1488BB80118F842000DCC0C825A40799BDAF96AECDD │ │ │ │ │ -868122ACFD730220C7D7883308DC7DFF876D9999CC0741B95BE28FC0E42FECBA │ │ │ │ │ -0ADAB66A2AF69BE31E8BBF45DF7956ED542F902D4D0C1F2EBEC83C82661E88D0 │ │ │ │ │ -24C4BEC2FC6A4CB20D48088B0072276CE6BDE22595C25BAD22DD11D3BB0ED2A5 │ │ │ │ │ -BD2FB103B82B11561BFC5BE514AFB6800E672C27952FF769AB98BA86229942A8 │ │ │ │ │ -1F286296C235FE0BC2667D1AA0736503D1991B89A5154D5D2D88DF3112C05A4F │ │ │ │ │ -22637C2914BF89362D1E342CB0AE60FA99EDB2C3422DE3AF71892D88446CF82B │ │ │ │ │ -8CCDBA92637D2CE33DE352F18BC061F51AFEDA710016AF878CBCBB177497C96A │ │ │ │ │ -7E0B8EA4CF8EA257E94D370542E1A25DAE6CB5A103420867391DB9D6A26A5066 │ │ │ │ │ -182C64CB52AAB3AD0D73C80162428B6F1205C8037FC71C71C878A34838A0BDEC │ │ │ │ │ -F32696EF34C1DA1FBC016B8200B595319184B676374EA43D9293B7929B36EA73 │ │ │ │ │ -47B4FDE3AA153078CA48387B92EFC71A28930D28E2C9FDD7BC1D41DF246249F9 │ │ │ │ │ -7F2738CB4A8DD429DDF57F6E49B3D8479FA74814F3A1FAA6D59D0A4D187EEB01 │ │ │ │ │ -2EA96E99612B64ABF0A9FD45D44B607D062621CD4DBCF6A540F5179895A5B187 │ │ │ │ │ -49DB513CB30380B0AF1636EB679D0FE9B9C275FA737DAF994FA4B27DF9929407 │ │ │ │ │ -074B45807976F9EAC420DD89974DC14C28466661852CA94FD795F18A4289312E │ │ │ │ │ -745A22757374B0C6FD2EDD314F2567FD89821BD15E2A8A481744EF151C956423 │ │ │ │ │ -8946782FD12284C10C9E7BF22A4B18FC03CA3B41AC0C4532B4F5CEB812D07967 │ │ │ │ │ -1E138E3F72B60D4DCB1372C48BCC17CBE24A1F17C7655BC1EAEA6981103A5ACC │ │ │ │ │ -5B92AA0411246631E0251510DDB3AE7863C250607FF1E8CAB768F8A7C41A262A │ │ │ │ │ -E7A0521370E44C4B3669D3B763610BE6D69C95E24742AF2A3729C22A9B2ADC3C │ │ │ │ │ -7080A42162D104DB431D3842E40B8D718E0D3D9E32FCB9F0E2A6364C526A3AC5 │ │ │ │ │ -82B088C106642DF5AB38B9DD405F42FA51CE78E5F56420DA236D8D4E7B48B49D │ │ │ │ │ -93340B241590C400D7A5C307AEC9C8B6499E392F64991DA014E46E0D01C0CBA4 │ │ │ │ │ -50323596E65E32F5C9B7C7A8C612AFEA48CC21DCBB81CC6E2D850BA73F2AE7C4 │ │ │ │ │ -6CFE07151541292C3EF50199CEAD279718160A786906971032F099786104C5FE │ │ │ │ │ -52256206ED9F4D5584366EC7B8B12BED59AAE9B0D095558A0E094319070873E7 │ │ │ │ │ -00F6B71D871C67F7ADE989C5A29D0A4F86B4CF5807B38D64CA681950FB3C640D │ │ │ │ │ -E2BF48102CD95E0E434B7A21FFAE05B41126767A36F8A87939303213BD52B2BE │ │ │ │ │ -DE19DF0A8DFF42A7FEC195D23ACC367C05A36C038358E94E66FCECE627B6DEC6 │ │ │ │ │ -B6B6AAA0279AC21BCC51E404955215BF52FD453207219F1D59D30E103F025901 │ │ │ │ │ -FF2790C18C0B832B7CDBF656A4BA2951285D61A74B2F4961A0025A5F606E5348 │ │ │ │ │ -28805CE195DE8F685319CD58F591F27BC28FE354CAB4FA22E036F1EDABAD4718 │ │ │ │ │ -EC8599A334CFEADEAD351463B96907319B36FBBDBBC3780CCECCB8689784C69C │ │ │ │ │ -FB02ABAE47FE98D2CDA51E5F61810AD126EDD41399A21C5E8031E0466F1F88E0 │ │ │ │ │ -A056E43120AD58987EF33978FB1FC4D2E65B1E35F48914B92C706E21687D5CC6 │ │ │ │ │ -0665A37D5E2ABEF14BA49C2FB6ECA84F8ED92ECEEC2A93D21B3A742DA085FA51 │ │ │ │ │ -B000F5626B4257C8F6AA9362E8A864BF48EFA7AB100D3C7C0482263A0A55442D │ │ │ │ │ -82B559F702027D39DDC86B7D800FE929B93F5BC80035A6985046CB486E18DBE4 │ │ │ │ │ -0145ED9CEBE49C9D77904F5D85E575AEB7A3502A869D1EB8A9649BE37BF9EE22 │ │ │ │ │ -939185389723357F66DCC2598AF1E2E43D75C0E578C47A016759702083219B49 │ │ │ │ │ -5B795DE7E896D5F28E782C2334A46069F71022DF0148BFC4C6B698E43C5669CC │ │ │ │ │ -E5E1E505007852445AFD873C9E2AFFEC6A2834E675A9636742F67D76106A8A6F │ │ │ │ │ -2A6B5FF6E4025A66E07AA177D584A81C7862C1977646F674B219CC748934A17C │ │ │ │ │ -A0E0F7E1C6C9F94D84EA69F1F9373BB0E71D1BCB259C43598AD08E7F3FEB1FAE │ │ │ │ │ -AA985FF0F3536D4BE3B1BF7130CF09067ACAE066E68AFCE722D4A7FDDFAFC73C │ │ │ │ │ -9876BD13BA8DE884F7387C45A8F789863152EC22646CC2369F71C4A7A280F5A9 │ │ │ │ │ -BBD2FEA9895592A0094BF6B9C618D375CC42537349622DE42F0B4CBA88B9C7C9 │ │ │ │ │ -96E0165381A80A6482AD898710D1AF379B944A5210E582F9D1C0FA5315D91924 │ │ │ │ │ -53F3AD19D701348EF82803805788899704311215CEB7A5F2D01EB4AD9777C68E │ │ │ │ │ -336E4608B78D8BA1089A1CB08171348F1E1B23EFB82B8A6323270A3FCAE23794 │ │ │ │ │ -E464096338B89BAD91B0CDC7C184178C7780153B4F39D43904CE7FBD7406A442 │ │ │ │ │ -70F8F452389AFC2B9E5D8664F09AD94A439DAE108F344E5F0CF97CFC258E6EF6 │ │ │ │ │ -6A9EE29F52DB8651D602C152AD4D234165FD7BCE30C9B9EE83266AFCF1790773 │ │ │ │ │ -3FBB5D7F7EB830E41D245B3663C724CE1A4510C115AF410B8B7C5E7093BB380C │ │ │ │ │ -BE9CEA4E90A2FA79A7079C026511BCBBCD7CD70FF213573DA6E91E0179A9E182 │ │ │ │ │ -A17FFFD8250CB0C8E6C064A38C96A5AF3557D0ED07D23FD609EC3689F3C8FB71 │ │ │ │ │ -75D1CAB53C14423D45D42549CC6F045F1C022D7513520F00893BA36419BD27E4 │ │ │ │ │ -4A1E5A232D9B46444922C66B44B807DB511C0820DA8F235F3EFC11ADCF40302B │ │ │ │ │ -FB9EE32F0F94CC9DF166358F00B8267D72A0B1D3DF9AB341572BE77D724DF05E │ │ │ │ │ -73B6CB96B76AC8D6A1976D8FAFFAC71EFDF1E2C723DC7182EECB3D524A7A2986 │ │ │ │ │ -F706C852579C814AFC7EDE4EBBDDEACE7F735F3D68BAABD9CD6C7372B249F9BD │ │ │ │ │ -30EA14D495B816AC7005575762E27DB847D0927A2AD7AE32D62F6D51F67610ED │ │ │ │ │ -302A6DFE3579EB3F7FAF25298DCFB1F4E04B3F8AE90599BCF49977BA96C7965B │ │ │ │ │ -C6E702B63A672EF225F337D8242A5C055E99985C40E85C04C653C94CD5A0A695 │ │ │ │ │ -C2990BAC08A89CA688375BA5E9482F847666FAAC10A068363EDFD7A8B06A11EA │ │ │ │ │ -4F6F629EAD2AB3BF6CA1C2E71BE01B2AB6F5481879996978E84713472F63186E │ │ │ │ │ -F83382818D69A2E0352DDFB66EC53280FC14B7AA9AA1B5AEB061E01DA0D03C7D │ │ │ │ │ -6B7F1D6B7BE3DA2488F2AC80D16B25F6035BC1DF82237EE0243C3DCB4645601F │ │ │ │ │ -AFD81C15463B03399F73E7B7A6CD76EF9C4777DD4127EEA57E2DC4A983CA68C0 │ │ │ │ │ -8FE0066BA0DDC5C587F6552E1B9CE431057424152AE1C959BD30AD272358A63E │ │ │ │ │ -739901C4EB13C81FC91CACCCA1ADCFBD1E27024688B0511605B55C37A7809C32 │ │ │ │ │ -840558A91D706DC48FCEF47900498C2F98347991BE2BA47692E3358F2D19BD9A │ │ │ │ │ -222F4AE30B0A3C1165B4FF9117A8981EE2CA634709A2E0948D105F47F410C7DB │ │ │ │ │ -AE062451E75DBB7DEF5C3505FE3BA610A0E31B92CF1FEC935E3783D53DA778BE │ │ │ │ │ -4303C566B25A8C6C6FC832B5E29E01BCBF24DD1DA0D9430002D9EADEB47D529F │ │ │ │ │ -08AA3BFC42ABE98DE854DF77F9204D9280AA9CDE8944E78EE934E65DAB8C7B7E │ │ │ │ │ -DC148D5E8883B6A9E24D597410C629B40505AE476AF40DB6E5EA81735D7EF2FB │ │ │ │ │ -481D464D5F47B50081930DFDAA23E644AB568FBA103E59FE08FE443F46F1E5B6 │ │ │ │ │ -0E174E80EA0A3922A21B6B2D5C7D776889CE4A837D279EE75A7C94FAA48BE555 │ │ │ │ │ -CB0D6551741B4ACBB4B87B619AFB8D7EC17B7359FDE16F7DE22F4B3F69EE12A1 │ │ │ │ │ -329430F87CEF39C8F4BDDBC3AEC8AD2B5983ABE75E7B25EF560A7303F340216F │ │ │ │ │ -9E9D1F2E588495D4597F78FCA613D06C03C9AE47A81BE558D82000D6E77DBE65 │ │ │ │ │ -2C4DDD04B7ACF6E57DED226B1D5056A0C53F13A6EB7BB45EA8FB8C949EB8AB6D │ │ │ │ │ -3EAF2329EEF86A8D35256F38106EB6F95972473A300AF33538865BC1938E335D │ │ │ │ │ -BFDA7FE210106A70E75FDC0CA4C93389B37C2372 │ │ │ │ │ +2F3AD7547C7083385FD3871F7D9D6AB0715C16A94E4064BAD18DE77DC47979ED │ │ │ │ │ +9ACBD9A9F110703EE62CB30935404C97B62408A2F6B8250BFC3E5BEF8D7B9424 │ │ │ │ │ +447E2145DFB3AA7C4D6665A67B4B1D771BE08109076CE86E7C4FF00B11C3750D │ │ │ │ │ +FDAD6EC03035CAE67CFE15E076F3005E035FDD653336D840574B6B04525D3FA1 │ │ │ │ │ +94630463A7A0A8200642283D1F10FA639022F74C4DDE6148069D909F3DA0A9D5 │ │ │ │ │ +93462CF91CA2CAB590EAF2310184A7866D593E5CEEE3E18CD95BADEFC0132F8A │ │ │ │ │ +A65AD5D3DE74250539F5CE66ECDD43CC7BB7CA82394752376DEBC71F860BE388 │ │ │ │ │ +EFA679BCE3CCACE2753F2D6E0E664F2EC078DCADC02A0358EB040A84E62C7334 │ │ │ │ │ +4205A796FE3B45DA1473F334D7B1F23B9C9FEA91AD3805BF4499CDB6790D84ED │ │ │ │ │ +9BC544829DC4B1ABD23F75A3823CA2B822E174659432CA5E4CBA59E6D91CFF30 │ │ │ │ │ +D5FC3A8B0B7E99C3C08C33FEDCE8548B3A08A6A6D4D5BDA603BCA2870A3F3D1E │ │ │ │ │ +36542D1DF43399EFBCE7B52CDF7A4C07F97E90B3D84BFA524D71828A0789FAEF │ │ │ │ │ +1EE16423B27E9B5D135D8E140AFB9DCCF0EF8A9F20207212C6F4FBD1F5914A60 │ │ │ │ │ +B7F625C3BD443EDD7B8ED1326B07DC3F16E55A4AE9087563E75AE36AFFDB02E8 │ │ │ │ │ +48781622F89F2641D8FB849DB2CAE68093A698A65974AB905961E7C6928B4A48 │ │ │ │ │ +AFEF6DA1CCB3E1864044C18EEF58E08314B062E2176C40C68B5AC3FAFF8636D3 │ │ │ │ │ +4AA42B595C215728780F33C2A59ACC976305664E43D3ED3E7A6E667C635F06B3 │ │ │ │ │ +EA959D5B0223E51EDA33FF89261582D41AED1E977D161764A2D872CAAF655F0C │ │ │ │ │ +0D8CF1DD8B68BB1EE0D16B49A1F5C485D885EFC68438B5417D87C176BA3F1E1D │ │ │ │ │ +C91E94F73A316A51008A1733401724A204B577BD767381341C92753C10315BB4 │ │ │ │ │ +B36E9160171D92EC1DF2CAA4DB59E5CA692C54991584A651E534181244AFC734 │ │ │ │ │ +CBC63C0172F5EA070ABE0DB498E6DC52EECBC652E709AF9471AAD86B52E05C46 │ │ │ │ │ +DC870AD26F4BBDFFED2B4D42A25F57EDEF88FB3A42DB8A649240FF5D30D46518 │ │ │ │ │ +DDEF4034D5CF834E45B944B22A7BE3576FCB9D9D25DF55A55406122A0B002CC0 │ │ │ │ │ +3C4CF6900DDD8994450D6F27A4941A21579BFAA13985584D199B4259021C8949 │ │ │ │ │ +DB4A5F3FBF48185C085E65785928E7AF374758EB06C28AE4D3A7C81AD4CB9BAC │ │ │ │ │ +E43A89F2C6EDFFDD3626EC1FC44030C2CB699515B2441435D8AFF439AA3C200E │ │ │ │ │ +9CBFE9D6262F585CCDFD1B2190493089BD5AD555A2025B6F70EECDBA7BCE239B │ │ │ │ │ +8F5EF885FA753482A144008CFBD960DC4BFEDA4F8AB6ABB2E4F2B8702FBFC1BD │ │ │ │ │ +3AD026F242BD737CB2311AEB4F69A8503EB494FD9E13F8DC7AB5AE8B8C364371 │ │ │ │ │ +3A954072436EDF604EAA8F6BEBD1A4AE36D5876808AA076A247FB62BA6EA1A6A │ │ │ │ │ +E9EC6490BEB27813B47E64C768E474BDBB29B0CA029A8E0132439DF8B454B85F │ │ │ │ │ +3476FA636C4D02A58CC118FFD22BE0D8D037514674844C6F0FADCC2E2D68EC88 │ │ │ │ │ +0C75FB699FD730FA5E1DF7A5F0E34D5597DC366E60A0B59DDA88D9CCF071F9FA │ │ │ │ │ +063B381BA1812FBC2065829C97CAD30D27255773A5060FC501B4758F1C0C157F │ │ │ │ │ +E3A43597A846AE3397BAD5FCF808D69B1E5BBA8B534963DB44DDBC8A69C3B3C7 │ │ │ │ │ +8032A7ABA3F16F41023DDC4733DF2B51D8228C5E9070FA8B15534547567402B8 │ │ │ │ │ +F6B2FDAA7A8AB122B967588C411AC3133AB4ED81EB51317988D3DF9DE1C50427 │ │ │ │ │ +99BAE96F9196C910CEBD0556F55C16CC454E09921B9B2BACCFD25172FCC6D6AA │ │ │ │ │ +8B9664BD9DC506AB9675F371970982F6BAD13C9704A183EC4F2709F103E10DFA │ │ │ │ │ +AC13C344E695B0D19AC7DFEA4CC2F4C74DC8367D773FA6E4E49761BFD95D14AB │ │ │ │ │ +A9965325B1D8E98D3B8CDB3D1E11844726C3B87B5D751A95D1A2602B564E01C2 │ │ │ │ │ +93770D44EA0143CEA41BA1B716603530D8CBDA7034E2D3A2671C17A4C3C0936C │ │ │ │ │ +877A5EF33D71A82A7B1A6CF302C26A353A13AA4DD341C3DC4D4A549094ACB260 │ │ │ │ │ +75EFDC6876DF87F4195A6B82AED7AE588717152DFB17894F5F597B068B19A80E │ │ │ │ │ +FBAFD743BA73C553D7A1E574484A3971D84FED3DAAC5CF69A935CD4E8D264057 │ │ │ │ │ +77B063915E9D037D1C8FA5D728055A81E9282D5EB01C6A7A2A68BF0377F74E26 │ │ │ │ │ +33A163E11A3680995A89BA5A3C43A64A3277C1A9D013761A6489BB9A065A1009 │ │ │ │ │ +D2516ED73CF1B8EA2CE20F834D57EB7A842E9918E6CD513C0AECC128B9560735 │ │ │ │ │ +1F9CDA9691467D003FD27A30E0EE191576857BED060F67FD98DBFD43A1A09E4D │ │ │ │ │ +0C66BE58A164CF9D975A430CAF574140FD81A22DE96084D718A7DECBED55739E │ │ │ │ │ +8E3477448900E80EF2430ED4C5E76937D3668A607EA53CCF82B6C1B38D4E0611 │ │ │ │ │ +89DA6102FA5054F722100DC59B02CC2C6D38B1A0DA44517124035985A88EB28B │ │ │ │ │ +E43A0EA0E9A1726B6648127C9AAC7B472F72DDD4345D7D1C26A7B273BF268FF5 │ │ │ │ │ +B90BBE0694E084439C9488F839DAB285496DF8F4205E8EE81F136D0E74F93A31 │ │ │ │ │ +EF3FCE5616CC77C4ABE46689C533D5928FB276C5EA893C02579F804F56D5C5CC │ │ │ │ │ +D247F77697E312D135239C9ACBDBC9A6141D09316C98005E252560C77F8F9DAB │ │ │ │ │ +06535501D538C34B90629EA2250CBCC656109BFBA42BD1716F7560ED9CD5409D │ │ │ │ │ +20857560604C0AA33A8CA349AD4B4B51978805D48DE9DCD1F30302ACF885BCCC │ │ │ │ │ +C2E3E0248C13BCCC677820E0CCC0BB131A6F357BD12D74C568106F176E73931D │ │ │ │ │ +E28D21A4FFB534A03EE152AB639AFA400DF1F83B71D87929F582C5D9FDE45B4D │ │ │ │ │ +D86B27797675719208991EEC9E0900487830C7C4D1F028B7BE938C7C0086E7C4 │ │ │ │ │ +E4003EBDB482ADB21EBA3650C7CDC909B350751DEB4786A2E7EFCC74BA06C822 │ │ │ │ │ +759060F2FEB760F51059FB6917FFF0E50A670FD748965EED1EC1FD0A4F4D715C │ │ │ │ │ +97DBB7B7D1FF4655353C360C86120B22981C0447BA1B194012B998359C98F851 │ │ │ │ │ +4064EF73BF71A3433477212D24669110A61B13502824CB8C29FAA91B4230CE12 │ │ │ │ │ +34094EFC083DD75B697F08C5C9E1BFBD1876634F2978BA2CB7D3579A3DA8C684 │ │ │ │ │ +CB5DC3B9448907CA619035D102827421C48FCD21D92A5858AB41C029EBF79CBE │ │ │ │ │ +277B1EEECC31BE1C65F99915BFD63907005C1C753C3E3764C2C6ABD0B98FB6AD │ │ │ │ │ +3D6512ACE71F7FD51CE613241ED4DFFDE51A464C0F4A564855E40B7A6BAEEB16 │ │ │ │ │ +AC33D9E21EE5CCEFCF585B0F62020ADFBD4963ECA2C902D70A1930FE1C830722 │ │ │ │ │ +548F777C6F46D9678C0931F0F3F9ADA0B4BB7F399A14F6D51D481696AAC1550E │ │ │ │ │ +4F97C7D9E4C4EACEC889BBC7EF92F845077DF85F4B67DAD9C3BA8211A7A719E0 │ │ │ │ │ +A637E506E342884721ABE571DB71A2945AAAE1163A088C478F37A21DBE3C0350 │ │ │ │ │ +9FDA3241029F2E744629EBB24A89ABA63F3ABFAE34F1F261276B3FBEAA382AE7 │ │ │ │ │ +0DB0682488980D6EDD19BEE3DFDE812BBC78B28C0C01DB1183FA0E50C6AE8568 │ │ │ │ │ +CF309644C38F21E57610CCAD984B94EBF84ECFDFD0E02CD0D4752EE826B8DC4D │ │ │ │ │ +2A4FE441E990FA98129BFFA9FB310077F2982D2B0BE5155024739A6AC2154D70 │ │ │ │ │ +12208AA311AB4F4C32E64DFA6A7D33A08D1FE224FDE4EC761E1867DA8948FDE2 │ │ │ │ │ +5BD4A2FEF301B66A6408D3626E316195295F43D379F05688052837D7CF3F42AC │ │ │ │ │ +D7A66BB4C922A6AD00E9DF4D358E8B8DDC32EAB2306B858970F0DB2745F6AB85 │ │ │ │ │ +CDC0228DDA88EBC9C9BABDE2FBED79CE931F1FC7DBCD486CDB51BB4108E8158D │ │ │ │ │ +F6A16475E8C6A450C62A16DADF95A0E46E2B51BA8448F344259866E327A08C4F │ │ │ │ │ +D1C179A0F0399BE929F58B88C72D2BEAE07A5ECD196B19142FC3F81B0FC3ADAE │ │ │ │ │ +B0BDADE10DC8EDFC9AFD95B9FD0E3D6384F7DC1DC5744BFAADD299E204F86BAA │ │ │ │ │ +ABEAAEBA35852BEDDEAA3E177C51E32D2BC516F7C9346210B77584176ED17A05 │ │ │ │ │ +AF8E6E29C2BD70BDAD0A05B784DFA644A98B203FC7FDE0C1C84840D7924E1642 │ │ │ │ │ +C2F0727DFD869B4EB7866412A86F43A6354D0EBF84F4B0A8934F3DCAFA3E3630 │ │ │ │ │ +F9B19749CDFAF2D74A212C1F09D2B66DAC70C95E86B57B3263655F5CA8823639 │ │ │ │ │ +1B1FD4B6ACFBD39955BA16571EA5429A72DB868EBB39E59E8B5F9405BDAD17EA │ │ │ │ │ +8622EA9623BEA57A7FC93B92AFCB63309195F5CF20FBEE294F882D3FC4677857 │ │ │ │ │ +B3487C79AEEC28A4D991C0E628811419A68736168FF871F93E602A93D0B7CD09 │ │ │ │ │ +C6A41E04327AF7B4634C90624AC6C7DDCC7FD3B4B750809F0BABA624037674FC │ │ │ │ │ +FE032F9B6320F6E67957F63180BE3D9459C2F084BFEC4E98D14A73EEB21B4A91 │ │ │ │ │ +C9C9FF6262EA85AF8B8552035C4667FFDEE2AF8A30450494CE3884E9E8564867 │ │ │ │ │ +141CC932CAFCBBDEBDB1D3A35FFF43D06BB1A7230006B7EA6C1B184A85CE0D25 │ │ │ │ │ +5805107ED8F0A89223214DC45B7C2CDD47A583E378AE91D657A42B0005BFA9E4 │ │ │ │ │ +206AC79837123120854F87CE080399B66582581C5CEC6FADABDBC63B688F40F9 │ │ │ │ │ +81DB7251A67443E17511B5464D2B28C09F96623C2AA5A05E7FDCC08D2D7B8413 │ │ │ │ │ +A9801F9F1278DE2903BE024C762E9500F911E32D3841DA0EF4534B3E4A8A800C │ │ │ │ │ +4652FB706D837B22B6E391519423F432D856E12071A6A6A2DBF3FBA89AF6E535 │ │ │ │ │ +6DA012AD620BD523807818910770F0DD21D263205FB4194CE0BB69E91355F68A │ │ │ │ │ +E0DE3FBC5AA29A4F61B6D886CB0049067346EA6E37DB50E27C609332483DC8E9 │ │ │ │ │ +C7F1304D4CCFE0D6959D5114EA0FA864FE6A87A31E124BFF1C9463EA0D7B352D │ │ │ │ │ +ECB1207B0594F8722380FD2AB7D65C78C1043818E7C353F9840D3C0A952C758A │ │ │ │ │ +857D11EA0CF5F968A01D182E4800259D582B0E12144F4CB6ED01DFCB7AC4E74F │ │ │ │ │ +00AB536F0931D4FFCF46ADB2B3A6BB3C7477B9700C30EFD7987FCF8EF2F7C8E6 │ │ │ │ │ +52443D5B29E63133A0346FE73F9E956A4967D048D8311C12F0AD53F019D042A8 │ │ │ │ │ +CBB41E1890D930146F97B9C323F590ED012042A083720661F11A02274B61AFA4 │ │ │ │ │ +5B9D7F6BAE4113E055FE8D11F7F14AC2B6800D4E9867138134BDA4CE27C78263 │ │ │ │ │ +FE0864080FACFA56E1FD4EF96D952408D8BEDE3E3C30A1C30B85707B47AD19D2 │ │ │ │ │ +A4962CB7E3DD3C354C82A2466156364E2E732733AF4CBCD73463447E510AA9A6 │ │ │ │ │ +669498B7DE64612B26F770B456F431C266247DD11733D085618838D01CB330EF │ │ │ │ │ +9B10F24200B1F73DA6C1DAD0D7096429EDD6168C66234CEF25B70BA91375D1E5 │ │ │ │ │ +A752CBC4D1D54ADC2CB7301F21DF7AE2EF505C0FBB6C84B0D84AC52AAC340651 │ │ │ │ │ +05D470FB8937C3F94DF3687BE551EE0DC87374363D02BBC7F4535FE99DA5E052 │ │ │ │ │ +64BEBE746AF2FA3BA8D749ACA17C49558836B00A77BAFCB70A058903E3265CF8 │ │ │ │ │ +4220311EA2243FEEA836D0FF3A5C6077501BA661DACEEDD964A9B952053C409C │ │ │ │ │ +FAD49A8A76AC7BE464031879276B34ED4DC4034D3ED38989E57586808E3E10B7 │ │ │ │ │ +D68C6C8363058D7E593A8ADED04039720711B22C9E3CCA568E1107B098FE68BF │ │ │ │ │ +264C0E3144778060D5D6A291F846BB7AA75FF7CB6A5B99C5D7FFE2107AA508BB │ │ │ │ │ +E260E8526CFC0772C0A576F81E87D05510A6D51526F397CED9FB1F8F9E8E0437 │ │ │ │ │ +2B862713EB9A8E45DE80BCE14AADB849B641D143BDD0E833A28CD336F9CDF0A1 │ │ │ │ │ +B1630B2EF508F19DBC5923D4609244BC505D976D553D00600E68FEAF2F08BAF8 │ │ │ │ │ +E496F2915C5AA09DBCFB3DF18B2A2176675B69B7ED30FCFA1023A8599BE73DF1 │ │ │ │ │ +6F0C09916F5D0B2A84DECBBD12D99D61521722AF1C99365E3B02792E73066A88 │ │ │ │ │ +2B4E045688B282E66F17A0B0E79805D41BDD0A6B225A4973482C06332E2E1B01 │ │ │ │ │ +9912A88716EFFDDFD51FE91C29922CB94BBCE7A9135A56BDA110EE0381AF9508 │ │ │ │ │ +6C87BD9537EF61A5FF7175F3E41801548A13CD62787ED67D352B303F2518E0F0 │ │ │ │ │ +E5F5B2935ED90F491DB37A832FAB15C1512583A357B43288E5384F580BB38BC8 │ │ │ │ │ +C0590438F10E42FE54C772867FC89FA8D34A019A8541060F437E6DC0CA38A842 │ │ │ │ │ +12E9D2EE025D67F852587255A91DB4D9D7A87E2FDAFC58670FE4D596986C6E80 │ │ │ │ │ +F5F076A4B41859A5FA463F19F021170C546DDCE126BAC70D56649EDF25D550D6 │ │ │ │ │ +E2CC7F62BA1A62293D0204AEEE57E7F5BC33A6DE9308FD282EAFB4053BF54345 │ │ │ │ │ +2C3C71DCEA5DEADA870D3D7734F5D746B55F71367895D4709B3813BF24D742CC │ │ │ │ │ +F065FAC19BB12560FB75C11D5655FBB332547666DD02536E9B72E40939F1DEB9 │ │ │ │ │ +C24DDECA5FF05D105217DAD5F85BF10648D01D9C2935B33E41A42668C3E72E36 │ │ │ │ │ +B721CE4CF9059EC1C784FE5332720B320C14089BA8ED6AA3F518B64FF0391A75 │ │ │ │ │ +037325857F6B5B366E93435FC6149DB7F13F16B1B9C3ECC05CDE3E0BBAE62916 │ │ │ │ │ +A20654DC9212DF71C9313CA7DE9EE3BCB5C4A664B8E9614246C68DFB927128F6 │ │ │ │ │ +AE8A28324F9A7B3812945E23E071F3186B609E63BB2CE32EFFAFC60D47EED526 │ │ │ │ │ +CBEF58ED6257E33D409EAC2BD04AC74AB7DBDB0D8E5A3F4213A816BD5B644C81 │ │ │ │ │ +114B99CB49E02A3EF91A42394EF045B7F3D01194562EEF246051D3D95CC3B4E8 │ │ │ │ │ +C032DC9D1C956FAE3262E5BFC4CAF78A09CC18812605919A4A6FD5215055C8B3 │ │ │ │ │ +DAFE9676844FA09AC2B83B462C97BF12629D4A3FA022B87BA2A38658ACED3850 │ │ │ │ │ +AAC8B99D6D11BC90D4FC56071242E5C5F53468511EC2FF63148C5037C6C152C5 │ │ │ │ │ +904FD8214B780FB813E25B533BC9ED89A17D8CDE0DFE84D4F754673E9A7C07A1 │ │ │ │ │ +490DC9C0D81948A33F91A5E43730941F72587ECF512E8BE9A591A6FED369C250 │ │ │ │ │ +7BD9CFEB9212175BC1120B9C12A714926135877BE0BE24E0CB5622D9AD9C6AAC │ │ │ │ │ +0D8F1F44377A4AD25AF7DA08BA1B9D083B5E78C9C3361AE713F750368BCF9EAC │ │ │ │ │ +91CE1BD276BF316DA21171D193F0B28E2C7D2AD56622741312A967D3D3B30C93 │ │ │ │ │ +462B5F6ADEB68B0E98C471CE61FE76C8F4FD6E5AB7002A7C6393E262EAA20F63 │ │ │ │ │ +682E0247FC4B1AB22C908981DBC7EB8412489487C936E2274FC42FF3C35E307B │ │ │ │ │ +75A294F7708F6987284E3343BAD4D644BF03C6D46DC3FE35822A8B247153BEF8 │ │ │ │ │ +E2BD050D328F569EB296900ED4A4AB63E87F3415E5FEC75CAB856997B01229A1 │ │ │ │ │ +10FBEBF5B0A3FF6451C93279A1C8E0F2665929D7028C4F9AF70ABFFD45215796 │ │ │ │ │ +E4A9CEEDD5C438DD2D65969A8E6F50A96EAE4FD08873FB1C24F723A8B082963D │ │ │ │ │ +E682C1915122F9500F8CB30B5212269AED3FC6AA5BC6BB1549A35E7C591E64AD │ │ │ │ │ +929F50811D4A57745BCB63CD2EA783F70EAD383949840FED961BEAC30D3EA569 │ │ │ │ │ +0370438596E63C5771E2F69098948786F82C1F08449E59F469071963E5A576DB │ │ │ │ │ +27A1CE2EDE111637CEF7D689DC12A93FFD61BAA5BEB3C366D7F409856D721316 │ │ │ │ │ +14DF82F689AB496FA7C70A425F89B723DFCA56321DACDBBF2D19A4DFFFA63BB4 │ │ │ │ │ +3A2AC1278718B0D3599E6DBA5FD9B560FB9C4DF5F6B71640B671C48B6B53805E │ │ │ │ │ +46459B182AAE07FD9D999FE390CFDE8567E7E2FCD643B01EC2601BFE97D21956 │ │ │ │ │ +E088A2DE90D27940434CC1794A2B71916FDA827425BE842955EA3A1A75946505 │ │ │ │ │ +34EDE916A07AD3A1138FBD44305EB4D19ACA539FC22ABE29ACDD63F44708B619 │ │ │ │ │ +D60310BF127050DD76DEA375F0C0B7FA07E10F5C17C7EB3CD9A8B5D500CE336F │ │ │ │ │ +905CADFB5B559C65393BE11269C870CC2806E223E55605509F99C20A99E594B4 │ │ │ │ │ +6C5018A40A2581533F2C893BA4DF78F7C26C7E786F70ABB6F2FE55AE676F94F5 │ │ │ │ │ +FD1573E17D8A59821F3E5C5E3D2B0B08BAC4F5669EC502FF88A8914302B87927 │ │ │ │ │ +3562D53FA480C59C985C6571D660CEC990DADF6A71E89F79DAF3458EDE22A8E0 │ │ │ │ │ +DE89BEEA9A71BA291E13FE4101B452F515C683C201A605676D66F71F382D72AE │ │ │ │ │ +3B652CF1AD010818CBFDB9F947ED5C725932DF7415AAA8C879443075699423B6 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -7413,15 +7398,15 @@ │ │ │ │ │ rf /Fh 149[27 23 20[39 11[54 12[20 59[{}5 58.1154 /CMMI7 │ │ │ │ │ rf /Fi 157[46 44[55 55 55 55 50[{}5 83.022 /CMEX10 rf │ │ │ │ │ /Fj 137[40 48 2[37 3[50 1[25 1[34 29 1[40 1[39 1[36 1[44 │ │ │ │ │ 7[48 69 2[57 4[53 3[57 2[36 4[69 2[62 2[65 1[65 23 23 │ │ │ │ │ 58[{}23 83.022 /CMMI10 rf /Fk 135[102 3[75 1[79 1[108 │ │ │ │ │ 1[108 4[54 108 2[88 108 2[94 29[140 138 146 11[97 97 │ │ │ │ │ 97 97 97 49[{}18 172.188 /CMBX12 rf /Fl 134[44 3[46 2[33 │ │ │ │ │ -12[37 2[46 42 26[54 11[23 1[42 2[42 2[42 1[42 3[23 44[{}13 │ │ │ │ │ +3[46 12[42 22[43 15[23 2[42 2[42 1[42 1[42 3[23 44[{}12 │ │ │ │ │ 83.022 /CMSL10 rf /Fm 130[44 1[44 44 44 44 44 44 44 44 │ │ │ │ │ 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 │ │ │ │ │ 44 1[44 1[44 44 44 44 44 44 44 44 44 44 44 44 1[44 44 │ │ │ │ │ 44 44 44 2[44 44 44 44 44 44 44 44 44 2[44 44 44 44 44 │ │ │ │ │ 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 │ │ │ │ │ 44 44 44 1[44 44 44 33[{}84 83.022 /CMTT10 rf /Fn 131[232 │ │ │ │ │ 2[123 123 1[123 129 90 92 95 1[129 116 129 194 65 1[71 │ │ │ │ │ @@ -7438,16 +7423,16 @@ │ │ │ │ │ 8[48 48 1[48 48 48 48 48 48 1[27 46[{}44 83.022 /CMBX10 │ │ │ │ │ rf /Fq 133[34 41 41 55 41 43 30 30 30 1[43 38 43 64 21 │ │ │ │ │ 2[21 43 38 23 34 43 34 43 38 9[79 2[55 43 57 1[52 60 │ │ │ │ │ 1[70 48 2[28 58 3[59 55 54 58 7[38 38 38 38 38 38 38 │ │ │ │ │ 38 38 38 1[21 26 21 44[{}50 74.7198 /CMR9 rf /Fr 205[30 │ │ │ │ │ 30 49[{}2 49.8132 /CMR6 rf /Fs 205[35 35 49[{}2 66.4176 │ │ │ │ │ /CMR8 rf /Ft 133[43 51 2[51 54 38 38 38 1[54 49 54 1[27 │ │ │ │ │ -2[27 54 49 30 43 54 43 54 49 13[54 72 1[66 8[77 64 2[70 │ │ │ │ │ -69 73 8[49 2[49 2[49 1[49 3[27 44[{}33 99.6264 /CMR12 │ │ │ │ │ +2[27 54 49 30 43 54 43 1[49 13[54 72 1[66 5[50 2[77 3[70 │ │ │ │ │ +69 73 9[49 2[49 1[49 1[49 3[27 44[{}32 99.6264 /CMR12 │ │ │ │ │ rf /Fu 172[90 2[110 121 2[97 6[106 69[{}5 143.462 /CMBX12 │ │ │ │ │ rf /Fv 134[70 2[70 73 51 52 51 70 73 66 73 111 36 1[40 │ │ │ │ │ 36 1[66 40 58 1[58 73 66 9[137 3[73 3[103 2[83 6[90 18[66 │ │ │ │ │ 3[36 46[{}27 143.462 /CMR17 rf end │ │ │ │ │ %%EndProlog │ │ │ │ │ %%BeginSetup │ │ │ │ │ %%Feature: *Resolution 600dpi │ │ │ │ │ @@ -7457,22 +7442,22 @@ │ │ │ │ │ { pop << /PageSize [612 792] >> setpagedevice } │ │ │ │ │ { /letter where { pop letter } if } │ │ │ │ │ ifelse │ │ │ │ │ %%EndPaperSize │ │ │ │ │ end │ │ │ │ │ %%EndSetup │ │ │ │ │ %%Page: 1 1 │ │ │ │ │ -TeXDict begin 1 0 bop 1103 1879 a Fv(W)-11 b(rapp)t(er)44 │ │ │ │ │ +TeXDict begin 1 0 bop 1103 1880 a Fv(W)-11 b(rapp)t(er)44 │ │ │ │ │ b(Ob)7 b(jects)43 b(for)g(Solving)1099 2062 y(a)g(Linear)g(System)g(of) │ │ │ │ │ g(Equations)1306 2245 y(using)g Fu(SPOOLES)g Fv(2.2)1052 │ │ │ │ │ 2635 y Ft(Clev)m(e)35 b(Ashcraft)699 2751 y(Bo)s(eing)e(Shared)g │ │ │ │ │ (Services)i(Group)1995 2715 y Fs(1)2483 2635 y Ft(P)m(eter)f(Sc)m │ │ │ │ │ (hartz)2342 2751 y(CSAR)f(Corp)s(oration)3162 2715 y │ │ │ │ │ -Fs(2)1590 3013 y Ft(F)-8 b(ebruary)33 b(8,)g(2025)104 │ │ │ │ │ -4919 y Fr(1)138 4951 y Fq(P)-6 b(.)35 b(O.)g(Bo)n(x)f(24346,)39 │ │ │ │ │ +Fs(2)1611 3012 y Ft(Jan)m(uary)g(7,)f(2024)104 4919 y │ │ │ │ │ +Fr(1)138 4951 y Fq(P)-6 b(.)35 b(O.)g(Bo)n(x)f(24346,)39 │ │ │ │ │ b(Mail)d(Stop)e(7L-21,)k(Seattle,)g(W)-6 b(ashington)34 │ │ │ │ │ b(98124.)64 b(This)35 b(researc)n(h)g(w)n(as)h(supp)r(orted)e(in)g │ │ │ │ │ (part)h(b)n(y)e(the)0 5042 y(D)n(ARP)-6 b(A)20 b(Con)n(tract)j(D)n │ │ │ │ │ (ABT63-95-C-0122)i(and)d(the)f(DoD)h(High)g(P)n(erformance)i(Computing) │ │ │ │ │ f(Mo)r(dernization)g(Program)h(Common)0 5133 y(HPC)i(Soft)n(w)n(are)h │ │ │ │ │ (Supp)r(ort)d(Initiativ)n(e.)104 5193 y Fr(2)138 5224 │ │ │ │ │ y Fq(28035)32 b(Doroth)n(y)e(Driv)n(e,)h(Agoura)g(Hills,)h(CA)e(91301.) │ │ │ │ │ @@ -7599,17 +7584,17 @@ │ │ │ │ │ g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ (.)93 b(30)125 5407 y(5.3)83 b(Protot)n(yp)r(es)26 b(and)i │ │ │ │ │ (descriptions)f(of)34 b Fm(BridgeMPI)24 b Fo(metho)r(ds)29 │ │ │ │ │ b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(32)1929 5656 y(1)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 2 4 │ │ │ │ │ -TeXDict begin 2 3 bop 83 100 785 4 v 950 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fo(2)315 │ │ │ │ │ +TeXDict begin 2 3 bop 83 100 802 4 v 968 100 a Fp(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fo(2)315 │ │ │ │ │ 390 y(5.3.1)94 b(Basic)27 b(metho)r(ds)74 b(.)42 b(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ (.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 │ │ │ │ │ b(32)315 515 y(5.3.2)h(Instance)27 b(metho)r(ds)j(.)41 │ │ │ │ │ b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h │ │ │ │ │ (.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.) │ │ │ │ │ f(.)h(.)f(.)93 b(33)315 639 y(5.3.3)h(P)n(arameter)25 │ │ │ │ │ @@ -7731,17 +7716,17 @@ │ │ │ │ │ h(structures)f(using)h(serial)g(metho)r(ds.)48 b(In)32 │ │ │ │ │ b(the)f(MPI)g(en)n(vironmen)n(t,)h(the)0 5382 y(data)26 │ │ │ │ │ b(structures)h(for)f Fj(A)p Fo(,)h Fj(X)34 b Fo(and)26 │ │ │ │ │ b Fj(Y)46 b Fo(ma)n(y)26 b(b)r(e)i(distributed,)f(and)g(all)f(w)n │ │ │ │ │ (orking)g(data)g(structures)g(that)h(con)n(tain)g(the)g(factor)1929 │ │ │ │ │ 5656 y(3)p eop end │ │ │ │ │ %%Page: 4 6 │ │ │ │ │ -TeXDict begin 4 5 bop 83 100 785 4 v 950 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fo(4)0 │ │ │ │ │ +TeXDict begin 4 5 bop 83 100 802 4 v 968 100 a Fp(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fo(4)0 │ │ │ │ │ 390 y(matrices)i(and)h(their)h(supp)r(orting)e(information)h(are)f │ │ │ │ │ (distributed.)45 b(The)30 b(MPI)g(co)r(de)g(is)g(m)n(uc)n(h)g(more)g │ │ │ │ │ (complex)f(than)i(the)0 490 y(serial)19 b(or)g(m)n(ultithreaded)h(co)r │ │ │ │ │ (des,)h(for)e(not)h(only)g(are)f(the)h(factor)f(and)h(solv)n(es)e │ │ │ │ │ (parallel)h(and)h(distributed)g(\(as)f(is)h(the)h(sym)n(b)r(olic)0 │ │ │ │ │ 589 y(factorization\),)j(but)h(there)g(is)f(a)h(great)e(deal)h(of)h │ │ │ │ │ (supp)r(ort)f(co)r(de)h(necessary)e(b)r(ecause)h(of)h(the)g │ │ │ │ │ @@ -7843,17 +7828,17 @@ │ │ │ │ │ (and)0 5308 y(en)n(tries)f(in)i(the)f Fj(j)5 b Fo(-th)35 │ │ │ │ │ b(column)g(of)g(the)g(lo)n(w)n(er)f(triangle.)58 b(It)35 │ │ │ │ │ b(is)g(the)h(natural)e(data)g(structure)h(for)f(the)i(assem)n(bly)e(of) │ │ │ │ │ h(the)0 5407 y(matrix)27 b(en)n(tries)g(in)n(to)g(the)h(\\fron)n(ts")e │ │ │ │ │ (used)i(to)f(factor)g(the)h(matrix.)1929 5656 y(5)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 6 8 │ │ │ │ │ -TeXDict begin 6 7 bop 83 100 785 4 v 950 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fo(6)125 │ │ │ │ │ +TeXDict begin 6 7 bop 83 100 802 4 v 968 100 a Fp(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fo(6)125 │ │ │ │ │ 390 y(The)h Fm(InpMtx)e Fo(ob)5 b(ject)29 b(can)f(hold)g(one)h(of)f │ │ │ │ │ (three)h(t)n(yp)r(es)f(of)h(en)n(tries)f(as)g(\\indices)g(only")f(\(no) │ │ │ │ │ i(en)n(tries)f(are)f(presen)n(t\),)i(real)0 490 y(en)n(tries,)22 │ │ │ │ │ b(or)e(complex)h(en)n(tries.)34 b(The)22 b(t)n(yp)r(e)f(is)g(sp)r │ │ │ │ │ (eci\014ed)h(b)n(y)f(the)g Fm(inputMode)d Fo(parameter)i(to)h(the)h │ │ │ │ │ Fm(InpMtx)p 3296 490 27 4 v 29 w(init\(\))d Fo(metho)r(d.)125 │ │ │ │ │ 678 y Ff(\210)42 b Fm(INPMTX)p 477 678 V 28 w(INDICES)p │ │ │ │ │ @@ -7941,17 +7926,17 @@ │ │ │ │ │ (submatrices,)f(and)h(eac)n(h)e(input)j(metho)r(d)f(has)f(three)g(t)n │ │ │ │ │ (yp)r(es)g(of)h(input,)h(e.g,)0 5219 y(indices)28 b(only)-7 │ │ │ │ │ b(,)27 b(real)g(en)n(tries,)g(or)f(complex)h(en)n(tries.)37 │ │ │ │ │ b(Here)27 b(are)f(the)i(protot)n(yp)r(es)f(b)r(elo)n(w.)125 │ │ │ │ │ 5407 y Ff(\210)42 b Fo(Input)28 b(metho)r(ds)g(for)f(\\indices)g(only") │ │ │ │ │ g(mo)r(de.)p eop end │ │ │ │ │ %%Page: 7 9 │ │ │ │ │ -TeXDict begin 7 8 bop 83 100 785 4 v 950 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fo(7)208 │ │ │ │ │ +TeXDict begin 7 8 bop 83 100 802 4 v 968 100 a Fp(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fo(7)208 │ │ │ │ │ 390 y Fm(void)41 b(InpMtx_inputEntry)c(\()43 b(InpMtx)e(*mtxA,)g(int)i │ │ │ │ │ (row,)f(int)g(col)g(\))i(;)208 490 y(void)d(InpMtx_inputRow)d(\()43 │ │ │ │ │ b(InpMtx)e(*mtxA,)g(int)i(row,)f(int)g(rowsize,)e(int)i(rowind[])f(\))i │ │ │ │ │ (;)208 589 y(void)e(InpMtx_inputColum)o(n)d(\()43 b(InpMtx)e(*mtxA,)g │ │ │ │ │ (int)h(col,)g(int)h(colsize,)d(int)i(colind[])f(\))i(;)208 │ │ │ │ │ 689 y(void)e(InpMtx_inputMatri)o(x)d(\()43 b(InpMtx)e(*mtxA,)g(int)h │ │ │ │ │ (nrow,)g(int)g(ncol,)g(int)g(rowstride,)1341 789 y(int)g(colstride,)e │ │ │ │ │ @@ -8004,17 +7989,17 @@ │ │ │ │ │ 262 4582 y(entries[0])c(=)k(4.0)f(;)262 4682 y(count)f(=)i(1)g(;)262 │ │ │ │ │ 4781 y(if)f(\()h(ii)g(<)g(n1)g(\))g({)392 4881 y(indices[count])38 │ │ │ │ │ b(=)43 b(ij)g(+)g(1)g(;)392 4980 y(entries[count])38 │ │ │ │ │ b(=)43 b(-1.0)f(;)392 5080 y(count++)f(;)262 5180 y(})262 │ │ │ │ │ 5279 y(if)h(\()h(jj)g(<)g(n2)g(\))g({)392 5379 y(indices[count])38 │ │ │ │ │ b(=)43 b(ij)g(+)g(n1)g(;)p eop end │ │ │ │ │ %%Page: 8 10 │ │ │ │ │ -TeXDict begin 8 9 bop 83 100 785 4 v 950 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fo(8)392 │ │ │ │ │ +TeXDict begin 8 9 bop 83 100 802 4 v 968 100 a Fp(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fo(8)392 │ │ │ │ │ 390 y Fm(entries[count])38 b(=)43 b(-1.0)f(;)392 490 │ │ │ │ │ y(count++)f(;)262 589 y(})262 689 y(InpMtx_inputRea)o(lR)o(ow\()o(mt)o │ │ │ │ │ (xA,)c(ij,)42 b(count,)f(indices,)f(entries\))h(;)131 │ │ │ │ │ 789 y(})0 888 y(})0 988 y(InpMtx_changeSto)o(rag)o(eM)o(od)o(e\(m)o(tx) │ │ │ │ │ o(A,)c(INPMTX_BY_VECTORS)o(\))g(;)0 1169 y Fo(The)24 │ │ │ │ │ b(pro)r(cess)f(b)r(egins)i(b)n(y)f(allo)r(cating)f(an)h │ │ │ │ │ Fm(InpMtx)e Fo(ob)5 b(ject)24 b Fm(mtxA)e Fo(using)i(the)h │ │ │ │ │ @@ -8093,17 +8078,17 @@ │ │ │ │ │ 5208 y Fm(void)42 b(DenseMtx_rowIndi)o(ce)o(s)c(\()43 │ │ │ │ │ b(DenseMtx)d(*mtx,)i(int)g(*pnrow,)f(int)h(*prowind)e(\))j(;)0 │ │ │ │ │ 5308 y(void)f(DenseMtx_columnI)o(nd)o(ice)o(s)37 b(\()44 │ │ │ │ │ b(DenseMtx)c(*mtx,)h(int)i(*pncol,)d(int)j(*pcolind)d(\))j(;)0 │ │ │ │ │ 5407 y(double)e(*)i(DenseMtx_entries)37 b(\()43 b(DenseMtx)e(*mtx)h(\)) │ │ │ │ │ h(;)p eop end │ │ │ │ │ %%Page: 9 11 │ │ │ │ │ -TeXDict begin 9 10 bop 83 100 785 4 v 950 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)h(2025)p 3076 100 V 785 w Fo(9)0 │ │ │ │ │ +TeXDict begin 9 10 bop 83 100 802 4 v 968 100 a Fp(SPOOLES)31 │ │ │ │ │ +b(2.2)g(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3059 100 V 802 w Fo(9)0 │ │ │ │ │ 390 y(W)-7 b(e)28 b(w)n(ould)f(use)h(them)g(as)f(follo)n(ws.)0 │ │ │ │ │ 578 y Fm(double)128 b(*entries)41 b(;)0 678 y(int)260 │ │ │ │ │ b(ncol,)42 b(nrow,)f(*colind,)g(*rowind)f(;)0 877 y(DenseMtx_rowIndi)o │ │ │ │ │ (ces)o(\(m)o(tx)o(,)e(&nrow,)j(&rowind\))f(;)0 977 y(DenseMtx_columnI)o │ │ │ │ │ (ndi)o(ce)o(s\()o(mtx)o(,)d(&ncol,)42 b(&colind\))e(;)0 │ │ │ │ │ 1076 y(entries)h(=)i(DenseMtx_entries)o(\(m)o(tx\))37 │ │ │ │ │ b(;)0 1264 y Fo(W)-7 b(e)35 b(can)f(no)n(w)g(\014ll)h(the)g(indices)f │ │ │ │ │ @@ -8158,17 +8143,17 @@ │ │ │ │ │ b(InpMtx)d(*obj,)g(char)h(*filename)e(\))j(;)125 5242 │ │ │ │ │ y Ff(\210)f Fm(int)g(InpMtx)p 651 5242 V 29 w(readFromFormatte)o(dF)o │ │ │ │ │ (ile)37 b(\()43 b(InpMtx)e(*obj,)g(FILE)h(*fp)h(\))g(;)125 │ │ │ │ │ 5407 y Ff(\210)f Fm(int)g(InpMtx)p 651 5407 V 29 w(readFromBinaryFi)o │ │ │ │ │ (le)37 b(\()43 b(InpMtx)e(*obj,)h(FILE)g(*fp)g(\))h(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 10 12 │ │ │ │ │ -TeXDict begin 10 11 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(10)125 │ │ │ │ │ +TeXDict begin 10 11 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(10)125 │ │ │ │ │ 390 y Ff(\210)42 b Fm(int)g(InpMtx)p 651 390 27 4 v 29 │ │ │ │ │ w(writeToFile)d(\()k(InpMtx)e(*obj,)h(char)g(*filename)d(\))44 │ │ │ │ │ b(;)125 556 y Ff(\210)e Fm(int)g(InpMtx)p 651 556 V 29 │ │ │ │ │ w(writeToFormatted)o(Fi)o(le)37 b(\()43 b(InpMtx)e(*obj,)h(FILE)g(*fp)g │ │ │ │ │ (\))h(;)125 722 y Ff(\210)f Fm(int)g(InpMtx)p 651 722 │ │ │ │ │ V 29 w(writeToBinaryFil)o(e)37 b(\()44 b(InpMtx)d(*obj,)g(FILE)h(*fp)g │ │ │ │ │ (\))i(;)125 888 y Ff(\210)e Fm(int)g(InpMtx)p 651 888 │ │ │ │ │ @@ -8293,17 +8278,17 @@ │ │ │ │ │ Fm(Bridge)d Fo(metho)r(ds.)0 5115 y Fe(3.1)135 b(A)45 │ │ │ │ │ b(quic)l(k)g(lo)t(ok)g(at)h(serial)g(driv)l(er)f(program)0 │ │ │ │ │ 5321 y Fo(The)28 b(en)n(tire)f(listing)g(of)h(this)g(serial)e(driv)n │ │ │ │ │ (er)h(is)g(found)h(in)g(App)r(endix)g(A.)38 b(W)-7 b(e)28 │ │ │ │ │ b(no)n(w)f(extract)f(parts)h(of)h(the)g(co)r(de.)1908 │ │ │ │ │ 5656 y(11)p eop end │ │ │ │ │ %%Page: 12 14 │ │ │ │ │ -TeXDict begin 12 13 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(12)125 │ │ │ │ │ +TeXDict begin 12 13 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(12)125 │ │ │ │ │ 390 y Ff(\210)42 b Fo(Deco)r(de)27 b(the)h(input.)208 │ │ │ │ │ 606 y Fm(msglvl)302 b(=)43 b(atoi\(argv[1]\))c(;)208 │ │ │ │ │ 706 y(msgFileName)82 b(=)43 b(argv[6])e(;)208 805 y(neqns)346 │ │ │ │ │ b(=)43 b(atoi\(argv[3]\))c(;)208 905 y(type)390 b(=)43 │ │ │ │ │ b(atoi\(argv[4]\))c(;)208 1005 y(symmetryflag)f(=)43 │ │ │ │ │ b(atoi\(argv[5]\))c(;)208 1104 y(mtxFileName)82 b(=)43 │ │ │ │ │ b(argv[6])e(;)208 1204 y(rhsFileName)82 b(=)43 b(argv[7])e(;)208 │ │ │ │ │ @@ -8358,17 +8343,17 @@ │ │ │ │ │ 5006 y Fo(The)28 b Fm(nrhs)f Fo(parameter)g(con)n(tains)g(the)i(n)n(um) │ │ │ │ │ n(b)r(er)f(of)g(righ)n(t)g(hand)g(sides,)g(or)g(equiv)-5 │ │ │ │ │ b(alen)n(tly)e(,)28 b(the)h(n)n(um)n(b)r(er)f(of)g(columns)208 │ │ │ │ │ 5106 y(in)f Fj(Y)19 b Fo(.)125 5272 y Ff(\210)42 b Fo(Create)26 │ │ │ │ │ b(and)i(setup)g(the)g Fm(Bridge)d Fo(ob)5 b(ject.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 13 15 │ │ │ │ │ -TeXDict begin 13 14 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(13)208 │ │ │ │ │ +TeXDict begin 13 14 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(13)208 │ │ │ │ │ 390 y Fm(bridge)41 b(=)i(Bridge_new\(\))38 b(;)208 490 │ │ │ │ │ y(Bridge_setMatri)o(xPa)o(ra)o(ms)o(\(br)o(id)o(ge,)f(neqns,)k(type,)g │ │ │ │ │ (symmetryflag\))e(;)208 589 y(Bridge_setMessa)o(geI)o(nf)o(o\()o(bri)o │ │ │ │ │ (dg)o(e,)e(msglvl,)k(msgFile\))f(;)208 689 y(rc)i(=)h │ │ │ │ │ (Bridge_setup\(brid)o(ge,)37 b(mtxA\))k(;)208 888 y Fo(The)19 │ │ │ │ │ b Fm(Bridge)d Fo(ob)5 b(ject)19 b(is)g(allo)r(cated)f(b)n(y)g │ │ │ │ │ Fm(Bridge)p 1687 888 27 4 v 29 w(new\(\))p Fo(,)h(and)g(v)-5 │ │ │ │ │ @@ -8424,17 +8409,17 @@ │ │ │ │ │ (of)h(zeros)f(to)h(allo)n(w)f(in)h(a)f(fron)n(t)h(during)f(the)i(sup)r │ │ │ │ │ (erno)r(de)e(amalgama-)390 5039 y(tion)j(pro)r(cess.)301 │ │ │ │ │ 5172 y Fp({)41 b Fm(int)i(maxsize)24 b Fo(:)37 b(maxim)n(um)28 │ │ │ │ │ b(size)f(of)h(a)f(fron)n(t)g(when)h(the)g(fron)n(ts)f(are)f(split.)301 │ │ │ │ │ 5305 y Fp({)41 b Fm(int)i(seed)26 b Fo(:)37 b(random)26 │ │ │ │ │ b(n)n(um)n(b)r(er)i(seed.)p eop end │ │ │ │ │ %%Page: 14 16 │ │ │ │ │ -TeXDict begin 14 15 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(14)301 │ │ │ │ │ +TeXDict begin 14 15 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(14)301 │ │ │ │ │ 390 y Fp({)41 b Fm(double)g(compressCutoff)22 b Fo(:)36 │ │ │ │ │ b(if)28 b(the)g Fm(Neqns)d Fj(<)i Fm(compressCutoff)21 │ │ │ │ │ b Fc(\003)27 b Fm(neqns)p Fo(,)e(then)j(the)f(compressed)f(graph)390 │ │ │ │ │ 490 y(is)i(formed,)f(ordered)f(and)i(used)f(to)h(create)e(the)i(sym)n │ │ │ │ │ (b)r(olic)g(factorization.)125 642 y Ff(\210)42 b Fo(Matrix)27 │ │ │ │ │ b(parameters:)301 795 y Fp({)41 b Fm(int)i(type)26 b │ │ │ │ │ Fo(:)37 b(t)n(yp)r(e)27 b(of)h(en)n(tries,)f Fm(SPOOLES)p │ │ │ │ │ @@ -8531,17 +8516,17 @@ │ │ │ │ │ b(factor)g(time)2242 5120 y Fm(cpus[10])d Fo(:)100 b(time)28 │ │ │ │ │ b(to)f(p)r(erm)n(ute)h(rhs)2242 5220 y Fm(cpus[11])c │ │ │ │ │ Fo(:)100 b(time)28 b(to)f(solv)n(e)2242 5319 y Fm(cpus[12])d │ │ │ │ │ Fo(:)100 b(time)28 b(to)f(p)r(erm)n(ute)h(solution)2242 │ │ │ │ │ 5419 y Fm(cpus[13])c Fo(:)100 b(total)27 b(solv)n(e)g(time)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 15 17 │ │ │ │ │ -TeXDict begin 15 16 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(15)0 │ │ │ │ │ +TeXDict begin 15 16 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(15)0 │ │ │ │ │ 390 y Fe(3.3)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)58 │ │ │ │ │ b Fd(Bridge)42 b Fe(metho)t(ds)0 597 y Fo(This)22 b(section)f(con)n │ │ │ │ │ (tains)g(brief)h(descriptions)f(including)h(protot)n(yp)r(es)f(of)h │ │ │ │ │ (all)g(metho)r(ds)g(that)g(b)r(elong)g(to)f(the)i Fm(Bridge)c │ │ │ │ │ Fo(ob)5 b(ject.)0 854 y Fb(3.3.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ 1032 y Fo(As)21 b(usual,)g(there)f(are)g(four)g(basic)g(metho)r(ds)g │ │ │ │ │ (to)h(supp)r(ort)f(ob)5 b(ject)20 b(creation,)h(setting)f(default)h │ │ │ │ │ @@ -8599,17 +8584,17 @@ │ │ │ │ │ b Fm(int)g(Bridge_newToOldI)o(V)37 b(\()44 b(Bridge)d(*bridge,)f(IV)j │ │ │ │ │ (**pobj)e(\))i(;)208 5229 y Fo(This)27 b(metho)r(d)h(\014lls)g │ │ │ │ │ Fm(*pobj)e Fo(with)i(its)f Fm(newToOldIV)d Fo(p)r(oin)n(ter.)208 │ │ │ │ │ 5362 y Fg(R)l(eturn)k(value:)38 b Fo(1)27 b(for)g(a)g(normal)g(return,) │ │ │ │ │ g(-1)g(if)34 b Fm(bridge)25 b Fo(is)j Fm(NULL)p Fo(.)e(-2)h(if)34 │ │ │ │ │ b Fm(pobj)26 b Fo(is)i Fm(NULL)p Fo(.)p eop end │ │ │ │ │ %%Page: 16 18 │ │ │ │ │ -TeXDict begin 16 17 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(16)101 │ │ │ │ │ +TeXDict begin 16 17 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(16)101 │ │ │ │ │ 390 y(3.)42 b Fm(int)g(Bridge_frontETre)o(e)37 b(\()44 │ │ │ │ │ b(Bridge)d(*bridge,)f(ETree)i(**pobj)f(\))i(;)208 523 │ │ │ │ │ y Fo(This)27 b(metho)r(d)h(\014lls)g Fm(*pobj)e Fo(with)i(its)f │ │ │ │ │ Fm(frontETree)d Fo(p)r(oin)n(ter.)208 656 y Fg(R)l(eturn)k(value:)38 │ │ │ │ │ b Fo(1)27 b(for)g(a)g(normal)g(return,)g(-1)g(if)34 b │ │ │ │ │ Fm(bridge)25 b Fo(is)j Fm(NULL)p Fo(.)e(-2)h(if)34 b │ │ │ │ │ Fm(pobj)26 b Fo(is)i Fm(NULL)p Fo(.)101 822 y(4.)42 b │ │ │ │ │ @@ -8670,17 +8655,17 @@ │ │ │ │ │ 208 5233 y Fo(This)27 b(metho)r(d)h(sets)g(the)g(message)e(lev)n(el)h │ │ │ │ │ (and)g(\014le.)208 5366 y Fg(R)l(eturn)h(value:)38 b │ │ │ │ │ Fo(1)27 b(for)g(a)g(normal)g(return,)g(-1)g(if)34 b Fm(bridge)25 │ │ │ │ │ b Fo(is)j Fm(NULL)p Fo(,)e(-2)h(if)34 b Fm(msglvl)26 │ │ │ │ │ b Fj(>)h Fo(0)g(and)g Fm(msgFile)e Fo(is)j Fm(NULL)p │ │ │ │ │ Fo(.)p eop end │ │ │ │ │ %%Page: 17 19 │ │ │ │ │ -TeXDict begin 17 18 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(17)0 │ │ │ │ │ +TeXDict begin 17 18 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(17)0 │ │ │ │ │ 390 y Fb(3.3.4)112 b(Setup)38 b(metho)s(ds)101 568 y │ │ │ │ │ Fo(1.)k Fm(int)g(Bridge_setup)d(\()k(Bridge)e(*bridge,)f(InpMtx)h │ │ │ │ │ (*mtxA)h(\))h(;)208 701 y Fo(This)38 b(metho)r(d)i(orders)d(the)i │ │ │ │ │ (graph,)h(generates)d(the)j(fron)n(t)e(tree,)j(computes)e(the)g(sym)n │ │ │ │ │ (b)r(olic)f(factorization,)i(and)208 801 y(creates)26 │ │ │ │ │ b(the)i(t)n(w)n(o)f(p)r(erm)n(utation)g(v)n(ectors.)208 │ │ │ │ │ 934 y Fg(R)l(eturn)h(value:)38 b Fo(1)27 b(for)g(a)g(normal)g(return,)g │ │ │ │ │ @@ -8795,17 +8780,17 @@ │ │ │ │ │ g Fm(BridgeMT)d Fo(driv)n(er)h(program)g(\(whose)i(complete)g(listing)g │ │ │ │ │ (is)g(found)g(in)0 5308 y(App)r(endix)27 b(B\).)36 b(Section)26 │ │ │ │ │ b(4.2)f(describ)r(es)h(the)g(in)n(ternal)f(data)h(\014elds)g(of)g(the)g │ │ │ │ │ Fm(BridgeMT)d Fo(ob)5 b(ject.)36 b(Section)26 b(3.3)f(con)n(tains)g │ │ │ │ │ (the)0 5407 y(protot)n(yp)r(es)h(and)i(descriptions)f(of)g(all)h │ │ │ │ │ Fm(Bridge)d Fo(metho)r(ds.)1908 5656 y(18)p eop end │ │ │ │ │ %%Page: 19 21 │ │ │ │ │ -TeXDict begin 19 20 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(19)0 │ │ │ │ │ +TeXDict begin 19 20 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(19)0 │ │ │ │ │ 390 y Fe(4.1)135 b(A)45 b(quic)l(k)g(lo)t(ok)g(at)h(the)f(m)l │ │ │ │ │ (ultithreaded)h(driv)l(er)g(program)0 596 y Fo(The)28 │ │ │ │ │ b(en)n(tire)f(listing)g(of)h(this)g(m)n(ultithreaded)f(driv)n(er)g(is)g │ │ │ │ │ (found)h(in)g(App)r(endix)g(B.)37 b(W)-7 b(e)28 b(no)n(w)f(extract)g │ │ │ │ │ (parts)g(of)g(the)h(co)r(de.)125 785 y Ff(\210)42 b Fo(Deco)r(de)27 │ │ │ │ │ b(the)h(input.)208 998 y Fm(msglvl)302 b(=)43 b(atoi\(argv[1]\))c(;)208 │ │ │ │ │ 1097 y(msgFileName)82 b(=)43 b(argv[6])e(;)208 1197 y(neqns)346 │ │ │ │ │ @@ -8862,18 +8847,18 @@ │ │ │ │ │ 125 5011 y Ff(\210)42 b Fo(Read)27 b(in)h(the)g Fm(DenseMtx)c │ │ │ │ │ Fo(ob)5 b(ject)27 b(for)h Fj(Y)18 b Fo(.)208 5208 y Fm(mtxY)41 │ │ │ │ │ b(=)j(DenseMtx_new\(\))37 b(;)208 5308 y(rc)42 b(=)h(DenseMtx_readFrom) │ │ │ │ │ o(Fil)o(e\()o(mtx)o(Y,)37 b(mtxFileName\))i(;)208 5407 │ │ │ │ │ y(DenseMtx_dimens)o(ion)o(s\()o(mt)o(xY,)e(&nrow,)k(&nrhs\))g(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 20 22 │ │ │ │ │ -TeXDict begin 20 21 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(20)208 │ │ │ │ │ -390 y(The)g Fm(nrhs)f Fo(parameter)g(con)n(tains)g(the)i(n)n(um)n(b)r │ │ │ │ │ +TeXDict begin 20 21 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(20)208 │ │ │ │ │ +390 y(The)h Fm(nrhs)f Fo(parameter)g(con)n(tains)g(the)i(n)n(um)n(b)r │ │ │ │ │ (er)f(of)g(righ)n(t)g(hand)g(sides,)g(or)g(equiv)-5 b(alen)n(tly)e(,)28 │ │ │ │ │ b(the)h(n)n(um)n(b)r(er)f(of)g(columns)208 490 y(in)f │ │ │ │ │ Fj(Y)19 b Fo(.)125 656 y Ff(\210)42 b Fo(Create)26 b(and)i(setup)g(the) │ │ │ │ │ g Fm(BridgeMT)c Fo(ob)5 b(ject.)208 855 y Fm(bridge)41 │ │ │ │ │ b(=)i(BridgeMT_new\(\))38 b(;)208 955 y(BridgeMT_setMat)o(rix)o(Pa)o │ │ │ │ │ (ra)o(ms\()o(br)o(idg)o(e,)f(neqns,)k(type,)h(symmetryflag\))c(;)208 │ │ │ │ │ 1054 y(BridgeMT_setMes)o(sag)o(eI)o(nf)o(o\(b)o(ri)o(dge)o(,)f(msglvl,) │ │ │ │ │ @@ -8927,17 +8912,17 @@ │ │ │ │ │ b(The)28 b(solution)g(is)g(then)g(solv)n(ed.)208 5006 │ │ │ │ │ y(Again,)d(note)h(the)g(presence)g(of)f Fm(permuteflag)p │ │ │ │ │ Fo(.)32 b(When)27 b Fm(1)p Fo(,)f Fm(mtxY)e Fo(needs)i(to)f(b)r(e)i(p)r │ │ │ │ │ (erm)n(uted)f(in)n(to)f(the)i(new)f(ordering,)208 5106 │ │ │ │ │ y(and)h Fm(mtxX)f Fo(is)h(returned)h(in)g(the)f(original)g(ordering.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 21 23 │ │ │ │ │ -TeXDict begin 21 22 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(21)0 │ │ │ │ │ +TeXDict begin 21 22 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(21)0 │ │ │ │ │ 390 y Fe(4.2)135 b(The)45 b Fd(BridgeMT)c Fe(Data)46 │ │ │ │ │ b(Structure)0 596 y Fo(The)28 b Fm(BridgeMT)c Fo(structure)j(has)g(the) │ │ │ │ │ h(follo)n(wing)f(\014elds.)125 784 y Ff(\210)42 b Fo(Graph)27 │ │ │ │ │ b(parameters:)301 949 y Fp({)41 b Fm(int)i(neqns)25 b │ │ │ │ │ Fo(:)37 b(n)n(um)n(b)r(er)27 b(of)h(equations,)f(i.e.,)h(n)n(um)n(b)r │ │ │ │ │ (er)f(of)h(v)n(ertices)e(in)i(the)g(graph.)301 1081 y │ │ │ │ │ Fp({)41 b Fm(int)i(nedges)25 b Fo(:)37 b(n)n(um)n(b)r(er)27 │ │ │ │ │ @@ -9015,17 +9000,17 @@ │ │ │ │ │ b Fo(:)k(ob)5 b(ject)28 b(that)g(con)n(tains)e(the)i(sym)n(b)r(olic)f │ │ │ │ │ (factorization)g(of)g(the)h(matrix.)301 5308 y Fp({)41 │ │ │ │ │ b Fm(SubMtxManager)d(*mtxmanager)33 b Fo(:)55 b(ob)5 │ │ │ │ │ b(ject)37 b(that)g(manages)f(the)h Fm(SubMtx)d Fo(ob)5 │ │ │ │ │ b(jects)37 b(that)g(store)f(the)h(factor)390 5407 y(en)n(tries)27 │ │ │ │ │ b(and)h(are)e(used)i(in)g(the)g(solv)n(es.)p eop end │ │ │ │ │ %%Page: 22 24 │ │ │ │ │ -TeXDict begin 22 23 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(22)301 │ │ │ │ │ +TeXDict begin 22 23 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(22)301 │ │ │ │ │ 390 y Fp({)41 b Fm(FrontMtx)f(*frontmtx)24 b Fo(:)37 │ │ │ │ │ b(ob)5 b(ject)28 b(that)g(stores)e(the)i Fj(L)p Fo(,)f │ │ │ │ │ Fj(D)j Fo(and)d Fj(U)37 b Fo(factor)27 b(matrices.)301 │ │ │ │ │ 523 y Fp({)41 b Fm(IV)i(*oldToNewIV)23 b Fo(:)28 b(ob)5 │ │ │ │ │ b(ject)27 b(that)h(stores)e(old-to-new)h(p)r(erm)n(utation)g(v)n │ │ │ │ │ (ector.)301 656 y Fp({)41 b Fm(IV)i(*newToOldIV)23 b │ │ │ │ │ Fo(:)28 b(ob)5 b(ject)27 b(that)h(stores)e(new-to-old)h(p)r(erm)n │ │ │ │ │ @@ -9099,17 +9084,17 @@ │ │ │ │ │ 4973 y Fb(4.3.1)112 b(Basic)38 b(metho)s(ds)0 5151 y │ │ │ │ │ Fo(As)21 b(usual,)g(there)f(are)g(four)g(basic)g(metho)r(ds)g(to)h │ │ │ │ │ (supp)r(ort)f(ob)5 b(ject)20 b(creation,)h(setting)f(default)h │ │ │ │ │ (\014elds,)h(clearing)d(an)n(y)h(allo)r(cated)0 5251 │ │ │ │ │ y(data,)27 b(and)h(free'ing)f(the)h(ob)5 b(ject.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 23 25 │ │ │ │ │ -TeXDict begin 23 24 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(23)101 │ │ │ │ │ +TeXDict begin 23 24 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(23)101 │ │ │ │ │ 390 y(1.)42 b Fm(BridgeMT)e(*)j(BridgeMT_new)c(\()k(void)f(\))h(;)208 │ │ │ │ │ 521 y Fo(This)27 b(metho)r(d)h(simply)g(allo)r(cates)f(storage)f(for)h │ │ │ │ │ (the)h Fm(BridgeMT)d Fo(structure)i(and)g(then)i(sets)e(the)h(default)g │ │ │ │ │ (\014elds)g(b)n(y)f(a)208 621 y(call)g(to)g Fm(BridgeMT)p │ │ │ │ │ 818 621 27 4 v 28 w(setDefaultFields\()o(\))p Fo(.)101 │ │ │ │ │ 783 y(2.)42 b Fm(int)g(BridgeMT_setDefa)o(ul)o(tFi)o(el)o(ds)37 │ │ │ │ │ b(\()43 b(BridgeMT)e(*bridge)f(\))j(;)208 913 y Fo(The)27 │ │ │ │ │ @@ -9173,17 +9158,17 @@ │ │ │ │ │ b Fm(int)g(BridgeMT_symbfac)o(IV)o(L)c(\()43 b(BridgeMT)d(*bridge,)g │ │ │ │ │ (IVL)j(**pobj)e(\))i(;)208 5276 y Fo(This)27 b(metho)r(d)h(\014lls)g │ │ │ │ │ Fm(*pobj)e Fo(with)i(its)f Fm(symbfacIVL)d Fo(p)r(oin)n(ter.)208 │ │ │ │ │ 5407 y Fg(R)l(eturn)k(value:)38 b Fo(1)27 b(for)g(a)g(normal)g(return,) │ │ │ │ │ g(-1)g(if)34 b Fm(bridge)25 b Fo(is)j Fm(NULL)p Fo(.)e(-2)h(if)34 │ │ │ │ │ b Fm(pobj)26 b Fo(is)i Fm(NULL)p Fo(.)p eop end │ │ │ │ │ %%Page: 24 26 │ │ │ │ │ -TeXDict begin 24 25 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(24)101 │ │ │ │ │ +TeXDict begin 24 25 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(24)101 │ │ │ │ │ 390 y(5.)42 b Fm(int)g(BridgeMT_mtxmana)o(ge)o(r)c(\()43 │ │ │ │ │ b(BridgeMT)d(*bridge,)g(SubMtxManager)f(**pobj)i(\))i(;)208 │ │ │ │ │ 523 y Fo(This)27 b(metho)r(d)h(\014lls)g Fm(*pobj)e Fo(with)i(its)f │ │ │ │ │ Fm(mtxmanager)d Fo(p)r(oin)n(ter.)208 656 y Fg(R)l(eturn)k(value:)38 │ │ │ │ │ b Fo(1)27 b(for)g(a)g(normal)g(return,)g(-1)g(if)34 b │ │ │ │ │ Fm(bridge)25 b Fo(is)j Fm(NULL)p Fo(.)e(-2)h(if)34 b │ │ │ │ │ Fm(pobj)26 b Fo(is)i Fm(NULL)p Fo(.)101 822 y(6.)42 b │ │ │ │ │ @@ -9244,17 +9229,17 @@ │ │ │ │ │ (Par)o(am)o(s)c(\()43 b(BridgeMT)d(*bridge,)g(int)j(sparsityflag,)38 │ │ │ │ │ b(int)k(pivotingflag,)818 5125 y(double)f(tau,)h(double)f(droptol,)f │ │ │ │ │ (int)j(lookahead,)c(PatchAndGoInfo)f(*patchinfo)h(\))k(;)208 │ │ │ │ │ 5258 y Fo(This)27 b(metho)r(d)h(sets)g(parameters)d(needed)j(for)f(the) │ │ │ │ │ h(factorization.)208 5391 y Fg(R)l(eturn)g(value:)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 25 27 │ │ │ │ │ -TeXDict begin 25 26 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(25)1135 │ │ │ │ │ +TeXDict begin 25 26 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(25)1135 │ │ │ │ │ 377 y(1)99 b(normal)27 b(return)1107 477 y(-1)99 b Fm(bridge)25 │ │ │ │ │ b Fo(is)j Fm(NULL)1107 576 y Fo(-2)99 b Fm(sparsityflag)23 │ │ │ │ │ b Fo(is)k(in)n(v)-5 b(alid)1107 676 y(-3)99 b Fm(pivotingflag)23 │ │ │ │ │ b Fo(is)k(in)n(v)-5 b(alid)2278 427 y(-4)98 b Fm(tau)27 │ │ │ │ │ b Fj(<)g Fo(2.0)2278 526 y(-5)98 b Fm(droptol)25 b Fj(<)i │ │ │ │ │ Fo(0.0)2278 626 y(-6)98 b Fm(lookahead)24 b Fj(<)k Fo(0)101 │ │ │ │ │ 871 y(4.)42 b Fm(int)g(BridgeMT_setMess)o(ag)o(esI)o(nf)o(o)c(\()43 │ │ │ │ │ @@ -9317,17 +9302,17 @@ │ │ │ │ │ b(whic)n(h)h(sp)r(eci\014es)g(the)g(relativ)n(e)f(size)g(of)h(a)g │ │ │ │ │ (subtree)f(that)h(forms)f(a)208 5132 y(domain.)49 b(If)39 │ │ │ │ │ b Fm(maptype)30 b Fo(is)i(not)g(one)f(of)h(1,)h(2,)g(3)f(or)f(4,)i(the) │ │ │ │ │ f(default)h(map)f(is)g(used:)45 b(domain)32 b(decomp)r(osition)g(with) │ │ │ │ │ 208 5232 y Fm(cutoff)25 b Fo(=)i(1/\(2*)p Fm(nthread)p │ │ │ │ │ Fo(\).)208 5365 y Fg(R)l(eturn)h(value:)p eop end │ │ │ │ │ %%Page: 26 28 │ │ │ │ │ -TeXDict begin 26 27 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(26)618 │ │ │ │ │ +TeXDict begin 26 27 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(26)618 │ │ │ │ │ 377 y(1)99 b(normal)26 b(return,)i(factorization)e(did)i(complete)590 │ │ │ │ │ 477 y(-1)99 b Fm(bridge)25 b Fo(is)i Fm(NULL)2393 377 │ │ │ │ │ y Fo(-2)99 b Fm(nthread)24 b Fj(<)k Fo(1)2393 477 y(-5)99 │ │ │ │ │ b Fm(frontETree)23 b Fo(is)28 b(not)f(presen)n(t)101 │ │ │ │ │ 672 y(2.)42 b Fm(int)g(BridgeMT_factor)37 b(\()43 b(BridgeMT)e │ │ │ │ │ (*bridge,)f(InpMtx)h(*mtxA,)g(int)i(permuteflag,)38 b(int)43 │ │ │ │ │ b(*perror)d(\))j(;)208 805 y Fo(This)24 b(metho)r(d)g(p)r(erm)n(utes)g │ │ │ │ │ @@ -9424,17 +9409,17 @@ │ │ │ │ │ Fm(BridgeMPI)d Fo(driv)n(er)i(program)f(\(whose)i(complete)g(listing)g │ │ │ │ │ (is)g(found)h(in)0 5164 y(App)r(endix)32 b(C\).)49 b(Section)32 │ │ │ │ │ b(5.2)e(describ)r(es)h(the)h(in)n(ternal)f(data)g(\014elds)g(of)h(the)g │ │ │ │ │ Fm(BridgeMPI)c Fo(ob)5 b(ject.)48 b(Section)31 b(3.3)g(con)n(tains)0 │ │ │ │ │ 5264 y(the)d(protot)n(yp)r(es)e(and)i(descriptions)f(of)g(all)h │ │ │ │ │ Fm(Bridge)d Fo(metho)r(ds.)1908 5656 y(27)p eop end │ │ │ │ │ %%Page: 28 30 │ │ │ │ │ -TeXDict begin 28 29 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(28)0 │ │ │ │ │ +TeXDict begin 28 29 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(28)0 │ │ │ │ │ 390 y Fe(5.1)135 b(A)45 b(quic)l(k)g(lo)t(ok)g(at)h(the)f(MPI)f(driv)l │ │ │ │ │ (er)i(program)0 594 y Fo(The)28 b(en)n(tire)f(listing)g(of)h(this)g │ │ │ │ │ (MPI)f(driv)n(er)f(is)i(found)g(in)g(App)r(endix)g(C.)37 │ │ │ │ │ b(W)-7 b(e)28 b(no)n(w)f(extract)g(parts)g(of)g(the)h(co)r(de.)125 │ │ │ │ │ 769 y Ff(\210)42 b Fo(Deco)r(de)27 b(the)h(input.)208 │ │ │ │ │ 966 y Fm(msglvl)302 b(=)43 b(atoi\(argv[1]\))c(;)208 │ │ │ │ │ 1065 y(msgFileName)82 b(=)43 b(argv[6])e(;)208 1165 y(neqns)346 │ │ │ │ │ @@ -9498,17 +9483,17 @@ │ │ │ │ │ (er)f(of)g(columns)208 5308 y(in)d Fj(Y)18 b Fo(.)36 │ │ │ │ │ b(Pro)r(cessor)23 b(0)h(then)h(broadcasts)e(the)j(error)d(return)h(to)h │ │ │ │ │ (the)g(other)g(pro)r(cessors.)33 b(If)25 b(an)g(error)e(o)r(ccured)h │ │ │ │ │ (reading)208 5407 y(in)j(the)h(matrix,)g(all)f(pro)r(cessors)e(call)i │ │ │ │ │ Fm(MPI)p 1541 5407 V 30 w(Finalize\(\))d Fo(and)j(exit.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 29 31 │ │ │ │ │ -TeXDict begin 29 30 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(29)125 │ │ │ │ │ +TeXDict begin 29 30 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(29)125 │ │ │ │ │ 390 y Ff(\210)42 b Fo(Create)26 b(and)i(setup)g(the)g │ │ │ │ │ Fm(BridgeMPI)c Fo(ob)5 b(ject.)208 589 y Fm(bridge)41 │ │ │ │ │ b(=)i(BridgeMPI_new\(\))37 b(;)208 689 y(BridgeMPI_setMP)o(Ipa)o(ra)o │ │ │ │ │ (ms)o(\(br)o(id)o(ge,)g(nproc,)k(myid,)g(MPI_COMM_WORLD\))d(;)208 │ │ │ │ │ 789 y(BridgeMPI_setMa)o(tri)o(xP)o(ar)o(ams)o(\(b)o(rid)o(ge)o(,)f │ │ │ │ │ (neqns,)42 b(type,)f(symmetryflag\))d(;)208 888 y(BridgeMPI_setMe)o │ │ │ │ │ (ssa)o(ge)o(In)o(fo\()o(br)o(idg)o(e,)f(msglvl,)k(msgFile\))f(;)208 │ │ │ │ │ @@ -9564,17 +9549,17 @@ │ │ │ │ │ o(rid)o(ge)o(,)38 b(permuteflag,)g(mtxX,)k(mtxY\))f(;)208 │ │ │ │ │ 5139 y Fo(Again,)25 b(note)h(the)g(presence)g(of)f Fm(permuteflag)p │ │ │ │ │ Fo(.)32 b(When)27 b Fm(1)p Fo(,)f Fm(mtxY)e Fo(needs)i(to)f(b)r(e)i(p)r │ │ │ │ │ (erm)n(uted)f(in)n(to)f(the)i(new)f(ordering,)208 5239 │ │ │ │ │ y(and)h Fm(mtxX)f Fo(is)h(returned)h(in)g(the)f(original)g(ordering.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 30 32 │ │ │ │ │ -TeXDict begin 30 31 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(30)0 │ │ │ │ │ +TeXDict begin 30 31 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(30)0 │ │ │ │ │ 390 y Fe(5.2)135 b(The)45 b Fd(BridgeMPI)40 b Fe(Data)46 │ │ │ │ │ b(Structure)0 595 y Fo(The)28 b Fm(BridgeMPI)c Fo(structure)j(has)g │ │ │ │ │ (the)h(follo)n(wing)e(\014elds.)125 776 y Ff(\210)42 │ │ │ │ │ b Fo(Graph)27 b(parameters:)301 939 y Fp({)41 b Fm(int)i(neqns)25 │ │ │ │ │ b Fo(:)37 b(n)n(um)n(b)r(er)27 b(of)h(equations,)f(i.e.,)h(n)n(um)n(b)r │ │ │ │ │ (er)f(of)h(v)n(ertices)e(in)i(the)g(graph.)301 1068 y │ │ │ │ │ Fp({)41 b Fm(int)i(nedges)25 b Fo(:)37 b(n)n(um)n(b)r(er)27 │ │ │ │ │ @@ -9657,17 +9642,17 @@ │ │ │ │ │ b(ject)30 b(that)h(de\014nes)f(the)h(factorizations,)e(e.g.,)i(the)g(n) │ │ │ │ │ n(um)n(b)r(er)f(of)g(fron)n(ts,)h(the)f(tree)390 5308 │ │ │ │ │ y(they)d(form,)f(the)h(n)n(um)n(b)r(er)g(of)f(in)n(ternal)g(and)h │ │ │ │ │ (external)e(ro)n(ws)g(for)h(eac)n(h)g(fron)n(t,)h(and)f(the)h(map)g │ │ │ │ │ (from)f(v)n(ertices)f(to)390 5407 y(the)j(fron)n(t)f(where)g(it)h(is)g │ │ │ │ │ (con)n(tained.)p eop end │ │ │ │ │ %%Page: 31 33 │ │ │ │ │ -TeXDict begin 31 32 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(31)301 │ │ │ │ │ +TeXDict begin 31 32 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(31)301 │ │ │ │ │ 390 y Fp({)41 b Fm(IVL)i(*symbfacIVL)23 b Fo(:)k(ob)5 │ │ │ │ │ b(ject)28 b(that)g(con)n(tains)e(the)i(sym)n(b)r(olic)f(factorization)g │ │ │ │ │ (of)g(the)h(matrix.)301 510 y Fp({)41 b Fm(SubMtxManager)d(*mtxmanager) │ │ │ │ │ 33 b Fo(:)55 b(ob)5 b(ject)37 b(that)g(manages)f(the)h │ │ │ │ │ Fm(SubMtx)d Fo(ob)5 b(jects)37 b(that)g(store)f(the)h(factor)390 │ │ │ │ │ 610 y(en)n(tries)27 b(and)h(are)e(used)i(in)g(the)g(solv)n(es.)301 │ │ │ │ │ 729 y Fp({)41 b Fm(FrontMtx)f(*frontmtx)24 b Fo(:)37 │ │ │ │ │ @@ -9753,17 +9738,17 @@ │ │ │ │ │ Fo(:)99 b(distribute)28 b(rhs)2257 5020 y Fm(cpus[17])d │ │ │ │ │ Fo(:)99 b(create)27 b(solution)g(matrix)2257 5120 y Fm(cpus[18])e │ │ │ │ │ Fo(:)99 b(solv)n(e)2257 5220 y Fm(cpus[19])25 b Fo(:)99 │ │ │ │ │ b(gather)27 b(solution)2257 5319 y Fm(cpus[20])e Fo(:)99 │ │ │ │ │ b(p)r(erm)n(ute)28 b(solution)2257 5419 y Fm(cpus[21])d │ │ │ │ │ Fo(:)99 b(total)28 b(solv)n(e)e(time)p eop end │ │ │ │ │ %%Page: 32 34 │ │ │ │ │ -TeXDict begin 32 33 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(32)0 │ │ │ │ │ +TeXDict begin 32 33 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(32)0 │ │ │ │ │ 390 y Fe(5.3)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)58 │ │ │ │ │ b Fd(BridgeMPI)40 b Fe(metho)t(ds)0 597 y Fo(This)32 │ │ │ │ │ b(section)f(con)n(tains)g(brief)h(descriptions)f(including)h(protot)n │ │ │ │ │ (yp)r(es)e(of)i(all)f(metho)r(ds)h(that)h(b)r(elong)e(to)h(the)g │ │ │ │ │ Fm(BridgeMPI)0 697 y Fo(ob)5 b(ject.)0 954 y Fb(5.3.1)112 │ │ │ │ │ b(Basic)38 b(metho)s(ds)0 1132 y Fo(As)21 b(usual,)g(there)f(are)g │ │ │ │ │ (four)g(basic)g(metho)r(ds)g(to)h(supp)r(ort)f(ob)5 b(ject)20 │ │ │ │ │ @@ -9816,17 +9801,17 @@ │ │ │ │ │ (\))k(;)208 4561 y Fo(This)35 b(metho)r(d)g(releases)f(an)n(y)g │ │ │ │ │ (storage)f(b)n(y)i(a)g(call)g(to)g Fm(BridgeMPI)p 2351 │ │ │ │ │ 4561 V 27 w(clearData\(\))c Fo(and)k(then)h(free)f(the)g(space)g(for) │ │ │ │ │ 208 4660 y Fm(bridge)p Fo(.)208 4793 y Fg(R)l(eturn)28 │ │ │ │ │ b(value:)38 b Fo(1)27 b(for)g(a)g(normal)g(return,)g(-1)g(if)34 │ │ │ │ │ b Fm(bridge)25 b Fo(is)j Fm(NULL)p Fo(.)p eop end │ │ │ │ │ %%Page: 33 35 │ │ │ │ │ -TeXDict begin 33 34 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(33)0 │ │ │ │ │ +TeXDict begin 33 34 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(33)0 │ │ │ │ │ 390 y Fb(5.3.2)112 b(Instance)38 b(metho)s(ds)101 568 │ │ │ │ │ y Fo(1.)k Fm(int)g(BridgeMPI_oldToN)o(ew)o(IV)37 b(\()43 │ │ │ │ │ b(BridgeMPI)d(*bridge,)h(IV)h(**pobj)f(\))j(;)208 701 │ │ │ │ │ y Fo(This)27 b(metho)r(d)h(\014lls)g Fm(*pobj)e Fo(with)i(its)f │ │ │ │ │ Fm(oldToNewIV)d Fo(p)r(oin)n(ter.)208 834 y Fg(R)l(eturn)k(value:)38 │ │ │ │ │ b Fo(1)27 b(for)g(a)g(normal)g(return,)g(-1)g(if)34 b │ │ │ │ │ Fm(bridge)25 b Fo(is)j Fm(NULL)p Fo(.)e(-2)h(if)34 b │ │ │ │ │ @@ -9896,17 +9881,17 @@ │ │ │ │ │ 5018 y Fo(This)27 b(metho)r(d)h(\014lls)g Fm(*pobj)e │ │ │ │ │ Fo(with)i(its)f Fm(ownedColumnsIV)22 b Fo(p)r(oin)n(ter.)208 │ │ │ │ │ 5151 y Fg(R)l(eturn)28 b(value:)38 b Fo(1)27 b(for)g(a)g(normal)g │ │ │ │ │ (return,)g(-1)g(if)34 b Fm(bridge)25 b Fo(is)j Fm(NULL)p │ │ │ │ │ Fo(.)e(-2)h(if)34 b Fm(pobj)26 b Fo(is)i Fm(NULL)p Fo(.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 34 36 │ │ │ │ │ -TeXDict begin 34 35 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(34)60 │ │ │ │ │ +TeXDict begin 34 35 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(34)60 │ │ │ │ │ 390 y(12.)41 b Fm(int)h(BridgeMPI_Xloc)c(\()43 b(BridgeMPI)d(*bridge,)g │ │ │ │ │ (DenseMtx)g(**pobj)h(\))j(;)208 523 y Fo(This)27 b(metho)r(d)h(\014lls) │ │ │ │ │ g Fm(*pobj)e Fo(with)i(its)f Fm(Xloc)f Fo(p)r(oin)n(ter.)208 │ │ │ │ │ 656 y Fg(R)l(eturn)i(value:)38 b Fo(1)27 b(for)g(a)g(normal)g(return,)g │ │ │ │ │ (-1)g(if)34 b Fm(bridge)25 b Fo(is)j Fm(NULL)p Fo(.)e(-2)h(if)34 │ │ │ │ │ b Fm(pobj)26 b Fo(is)i Fm(NULL)p Fo(.)60 822 y(13.)41 │ │ │ │ │ b Fm(int)h(BridgeMPI_Yloc)c(\()43 b(BridgeMPI)d(*bridge,)g(DenseMtx)g │ │ │ │ │ @@ -9961,17 +9946,17 @@ │ │ │ │ │ y Fg(R)l(eturn)g(value:)1099 4938 y Fo(1)99 b(normal)27 │ │ │ │ │ b(return)1071 5037 y(-1)99 b Fm(bridge)25 b Fo(is)j Fm(NULL)1071 │ │ │ │ │ 5137 y Fo(-2)99 b Fm(maxdomainsize)23 b Fc(\024)k Fo(0)2096 │ │ │ │ │ 4987 y(-3)98 b Fm(maxsize)25 b Fc(\024)i Fo(0)2096 5087 │ │ │ │ │ y(-4)98 b Fm(compressCutoff)22 b Fj(>)28 b Fo(1)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 35 37 │ │ │ │ │ -TeXDict begin 35 36 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(35)101 │ │ │ │ │ +TeXDict begin 35 36 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(35)101 │ │ │ │ │ 390 y(4.)42 b Fm(int)g(BridgeMPI_setFac)o(to)o(rPa)o(ra)o(ms)37 │ │ │ │ │ b(\()43 b(BridgeMPI)d(*bridge,)g(int)j(sparsityflag,)38 │ │ │ │ │ b(int)k(pivotingflag,)818 490 y(double)f(tau,)h(double)f(droptol,)f │ │ │ │ │ (int)j(lookahead,)c(PatchAndGoInfo)f(*patchinfo)h(\))k(;)208 │ │ │ │ │ 623 y Fo(This)27 b(metho)r(d)h(sets)g(parameters)d(needed)j(for)f(the)h │ │ │ │ │ (factorization.)208 756 y Fg(R)l(eturn)g(value:)1135 │ │ │ │ │ 933 y Fo(1)99 b(normal)27 b(return)1107 1033 y(-1)99 │ │ │ │ │ @@ -10028,17 +10013,17 @@ │ │ │ │ │ Fo(parameter)h(can)h(b)r(e)h(one)f(of)h(four)f(v)-5 b(alues:)307 │ │ │ │ │ 4725 y Ff(\210)42 b Fo(1)27 b(|)h(wrap)f(map)307 4858 │ │ │ │ │ y Ff(\210)42 b Fo(2)27 b(|)h(balanced)f(map)307 4991 │ │ │ │ │ y Ff(\210)42 b Fo(3)27 b(|)h(subtree-subset)f(map)307 │ │ │ │ │ 5124 y Ff(\210)42 b Fo(4)27 b(|)h(domain)f(decomp)r(osition)g(map)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 36 38 │ │ │ │ │ -TeXDict begin 36 37 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(36)208 │ │ │ │ │ +TeXDict begin 36 37 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(36)208 │ │ │ │ │ 390 y(The)22 b(wrap)g(map)h(and)g(balanced)f(map)g(are)g(not)h │ │ │ │ │ (recommended.)35 b(The)23 b(subtree-subset)f(map)g(is)h(a)f(go)r(o)r(d) │ │ │ │ │ h(map)f(with)h(a)208 490 y(v)n(ery)j(w)n(ell)i(balanced)f(nested)g │ │ │ │ │ (dissection)h(ordering.)35 b(The)28 b(domain)f(decomp)r(osition)h(map)f │ │ │ │ │ (is)h(recommended)f(when)208 589 y(the)j(nested)h(dissection)e(tree)h │ │ │ │ │ (is)h(im)n(balanced)e(or)g(for)h(the)h(m)n(ultisection)f(ordering.)43 │ │ │ │ │ b(The)31 b(domain)f(decomp)r(osition)208 689 y(map)i(requires)g(a)g │ │ │ │ │ @@ -10118,17 +10103,17 @@ │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 4674 y(/*)174 │ │ │ │ │ 4774 y(-----------------)o(--)o(-)174 4873 y(get)i(input)e(parameters) │ │ │ │ │ 174 4973 y(-----------------)o(--)o(-)0 5073 y(*/)0 5172 │ │ │ │ │ y(if)i(\()g(argc)f(!=)h(10)f(\))i({)131 5272 y(fprintf\(stdout,)479 │ │ │ │ │ 5372 y("\\n\\n)e(usage)f(:)j(\045s)e(msglvl)g(msgFile)e(neqns)i(type)g │ │ │ │ │ (symmetryflag")1908 5656 y Fo(37)p eop end │ │ │ │ │ %%Page: 38 40 │ │ │ │ │ -TeXDict begin 38 39 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(38)479 │ │ │ │ │ +TeXDict begin 38 39 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(38)479 │ │ │ │ │ 390 y Fm("\\n)391 b(mtxFile)41 b(rhsFile)g(seed")479 │ │ │ │ │ 490 y("\\n)130 b(msglvl)85 b(--)42 b(message)f(level")479 │ │ │ │ │ 589 y("\\n)261 b(0)43 b(--)g(no)f(output")479 689 y("\\n)261 │ │ │ │ │ b(1)43 b(--)g(timings)d(and)j(statistics")479 789 y("\\n)261 │ │ │ │ │ b(2)43 b(and)f(greater)f(--)i(lots)f(of)g(output")479 │ │ │ │ │ 888 y("\\n)130 b(msgFile)41 b(--)h(message)f(file")479 │ │ │ │ │ 988 y("\\n)130 b(neqns)f(--)42 b(#)i(of)e(equations")479 │ │ │ │ │ @@ -10164,17 +10149,17 @@ │ │ │ │ │ 4674 y("\\n\\n)j(\045s)i(input)e(:")349 4774 y("\\n)h(msglvl)303 │ │ │ │ │ b(=)43 b(\045d")349 4873 y("\\n)f(msgFile)259 b(=)43 │ │ │ │ │ b(\045s")349 4973 y("\\n)f(neqns)347 b(=)43 b(\045d")349 │ │ │ │ │ 5073 y("\\n)f(type)391 b(=)43 b(\045d")349 5172 y("\\n)f(symmetryflag)d │ │ │ │ │ (=)k(\045d")349 5272 y("\\n)f(mtxFile)259 b(=)43 b(\045s")349 │ │ │ │ │ 5372 y("\\n)f(rhsFile)259 b(=)43 b(\045s")p eop end │ │ │ │ │ %%Page: 39 41 │ │ │ │ │ -TeXDict begin 39 40 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(39)349 │ │ │ │ │ +TeXDict begin 39 40 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(39)349 │ │ │ │ │ 390 y Fm("\\n)42 b(solFile)259 b(=)43 b(\045s")349 490 │ │ │ │ │ y("\\n)f(seed)391 b(=)43 b(\045d")349 589 y("\\n",)349 │ │ │ │ │ 689 y(argv[0],)d(msglvl,)h(argv[2],)f(neqns,)h(type,)h(symmetryflag,) │ │ │ │ │ 349 789 y(mtxFileName,)c(rhsFileName,)h(solFileName,)g(seed\))i(;)0 │ │ │ │ │ 988 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(-*/)0 1088 y(/*)131 1187 y(----------------)o(--)131 │ │ │ │ │ @@ -10209,17 +10194,17 @@ │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(--)o(-*/)0 4973 y(/*)131 5073 │ │ │ │ │ y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(--)131 │ │ │ │ │ 5172 y(create)g(and)h(setup)g(a)h(Bridge)e(object)131 │ │ │ │ │ 5272 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(--)0 │ │ │ │ │ 5372 y(*/)p eop end │ │ │ │ │ %%Page: 40 42 │ │ │ │ │ -TeXDict begin 40 41 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(40)0 │ │ │ │ │ +TeXDict begin 40 41 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(40)0 │ │ │ │ │ 390 y Fm(bridge)41 b(=)i(Bridge_new\(\))c(;)0 490 y(Bridge_setMatrix)o │ │ │ │ │ (Par)o(am)o(s\()o(bri)o(dg)o(e,)e(neqns,)k(type,)h(symmetryflag\))c(;)0 │ │ │ │ │ 589 y(Bridge_setMessag)o(eIn)o(fo)o(\(b)o(rid)o(ge)o(,)g(msglvl,)i │ │ │ │ │ (msgFile\))h(;)0 689 y(rc)i(=)g(Bridge_setup\(bri)o(dg)o(e,)37 │ │ │ │ │ b(mtxA\))42 b(;)0 789 y(if)h(\()g(rc)g(!=)f(1)i(\))f({)131 │ │ │ │ │ 888 y(fprintf\(stderr,)37 b("\\n)42 b(error)g(return)f(\045d)i(from)f │ │ │ │ │ (Bridge_setup\(\)",)37 b(rc\))42 b(;)131 988 y(exit\(-1\))e(;)0 │ │ │ │ │ @@ -10259,17 +10244,17 @@ │ │ │ │ │ (-----\\n"\))i(;)0 5073 y(fprintf\(msgFile,)349 5172 │ │ │ │ │ y("\\n)173 b(CPU)42 b(\0458.3f)g(:)h(time)f(to)h(permute)d(original)g │ │ │ │ │ (matrix")349 5272 y("\\n)173 b(CPU)42 b(\0458.3f)g(:)h(time)f(to)h │ │ │ │ │ (initialize)c(factor)i(matrix")349 5372 y("\\n)173 b(CPU)42 │ │ │ │ │ b(\0458.3f)g(:)h(time)f(to)h(compute)d(factorization")p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 41 43 │ │ │ │ │ -TeXDict begin 41 42 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(41)349 │ │ │ │ │ +TeXDict begin 41 42 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(41)349 │ │ │ │ │ 390 y Fm("\\n)173 b(CPU)42 b(\0458.3f)g(:)h(time)f(to)h(post-process)38 │ │ │ │ │ b(factorization")349 490 y("\\n)k(CPU)g(\0458.3f)g(:)h(total)f │ │ │ │ │ (factorization)c(time\\n",)349 589 y(bridge->cpus[5])o(,)g │ │ │ │ │ (bridge->cpus[6])o(,)g(bridge->cpus[7])o(,)349 689 y(bridge->cpus[8])o │ │ │ │ │ (,)g(bridge->cpus[9])o(\))g(;)0 789 y(fprintf\(msgFile,)f("\\n\\n)k │ │ │ │ │ (factorization)e(statistics")349 888 y("\\n)j(\045d)h(pivots,)d(\045d)j │ │ │ │ │ (pivot)f(tests,)f(\045d)i(delayed)d(vertices")349 988 │ │ │ │ │ @@ -10314,17 +10299,17 @@ │ │ │ │ │ 4973 y(})0 5073 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(--)o(-*/)0 5172 y(if)43 b(\()g(strcmp\(solFileNa)o(me)o(,) │ │ │ │ │ 38 b("none"\))i(!=)j(0)g(\))g({)0 5272 y(/*)131 5372 │ │ │ │ │ y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 42 44 │ │ │ │ │ -TeXDict begin 42 43 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(42)131 │ │ │ │ │ +TeXDict begin 42 43 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(42)131 │ │ │ │ │ 390 y Fm(write)41 b(the)i(solution)d(matrix)h(to)i(a)g(file)131 │ │ │ │ │ 490 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)0 │ │ │ │ │ 589 y(*/)131 689 y(rc)g(=)g(DenseMtx_writeT)o(oFi)o(le)o(\(mt)o(xX)o(,) │ │ │ │ │ 38 b(solFileName\))g(;)131 789 y(if)43 b(\()g(rc)f(!=)h(1)g(\))h({)262 │ │ │ │ │ 888 y(fprintf\(msgFile)o(,)610 988 y("\\n)f(fatal)e(error)h(writing)e │ │ │ │ │ (mtxX)i(to)h(file)f(\045s,)g(rc)h(=)g(\045d",)610 1088 │ │ │ │ │ y(solFileName,)c(rc\))j(;)262 1187 y(fflush\(msgFile\))37 │ │ │ │ │ @@ -10369,17 +10354,17 @@ │ │ │ │ │ (---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 4873 y(/*)174 │ │ │ │ │ 4973 y(-----------------)o(--)o(-)174 5073 y(get)i(input)e(parameters) │ │ │ │ │ 174 5172 y(-----------------)o(--)o(-)0 5272 y(*/)0 5372 │ │ │ │ │ y(if)i(\()g(argc)f(!=)h(11)f(\))i({)1908 5656 y Fo(43)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 44 46 │ │ │ │ │ -TeXDict begin 44 45 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(44)131 │ │ │ │ │ +TeXDict begin 44 45 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(44)131 │ │ │ │ │ 390 y Fm(fprintf\(stdout,)392 490 y("\\n\\n)42 b(usage)f(:)i(\045s)g │ │ │ │ │ (msglvl)e(msgFile)g(neqns)h(type)f(symmetryflag)e(")392 │ │ │ │ │ 589 y("\\n)391 b(mtxFile)41 b(rhsFile)g(solFile)f(seed)i(nthread\\n") │ │ │ │ │ 392 689 y("\\n)130 b(msglvl)84 b(--)43 b(message)e(level")392 │ │ │ │ │ 789 y("\\n)261 b(0)43 b(--)f(no)h(output")392 888 y("\\n)261 │ │ │ │ │ b(1)43 b(--)f(timings)f(and)i(statistics")392 988 y("\\n)261 │ │ │ │ │ b(2)43 b(and)f(greater)f(--)i(lots)e(of)i(output")392 │ │ │ │ │ @@ -10417,17 +10402,17 @@ │ │ │ │ │ 4774 y(seed)391 b(=)43 b(atoi\(argv[9]\))38 b(;)0 4873 │ │ │ │ │ y(nthread)259 b(=)43 b(atoi\(argv[10]\))38 b(;)0 4973 │ │ │ │ │ y(fprintf\(msgFile,)349 5073 y("\\n\\n)j(\045s)i(input)e(:")349 │ │ │ │ │ 5172 y("\\n)h(msglvl)303 b(=)43 b(\045d")349 5272 y("\\n)f(msgFile)259 │ │ │ │ │ b(=)43 b(\045s")349 5372 y("\\n)f(neqns)347 b(=)43 b(\045d")p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 45 47 │ │ │ │ │ -TeXDict begin 45 46 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(45)349 │ │ │ │ │ +TeXDict begin 45 46 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(45)349 │ │ │ │ │ 390 y Fm("\\n)42 b(type)391 b(=)43 b(\045d")349 490 y("\\n)f │ │ │ │ │ (symmetryflag)d(=)k(\045d")349 589 y("\\n)f(mtxFile)259 │ │ │ │ │ b(=)43 b(\045s")349 689 y("\\n)f(rhsFile)259 b(=)43 b(\045s")349 │ │ │ │ │ 789 y("\\n)f(solFile)259 b(=)43 b(\045s")349 888 y("\\n)f(nthread)259 │ │ │ │ │ b(=)43 b(\045d")349 988 y("\\n",)349 1088 y(argv[0],)d(msglvl,)h │ │ │ │ │ (argv[2],)f(neqns,)h(type,)h(symmetryflag,)349 1187 y(mtxFileName,)c │ │ │ │ │ (rhsFileName,)h(solFileName,)g(nthread\))h(;)0 1287 y(/*--------------) │ │ │ │ │ @@ -10463,17 +10448,17 @@ │ │ │ │ │ d(;)0 4973 y(})0 5073 y(DenseMtx_dimensi)o(ons)o(\(m)o(tx)o(Y,)g │ │ │ │ │ (&nrow,)k(&nrhs\))g(;)0 5172 y(/*--------------)o(---)o(--)o(--)o(---)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(--)o(-*/)0 5272 y(/*)131 5372 │ │ │ │ │ y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(-)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 46 48 │ │ │ │ │ -TeXDict begin 46 47 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(46)131 │ │ │ │ │ +TeXDict begin 46 47 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(46)131 │ │ │ │ │ 390 y Fm(create)41 b(and)h(setup)g(a)h(BridgeMT)d(object)131 │ │ │ │ │ 490 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(-)0 │ │ │ │ │ 589 y(*/)0 689 y(bridge)h(=)i(BridgeMT_new\(\))38 b(;)0 │ │ │ │ │ 789 y(BridgeMT_setMatr)o(ixP)o(ar)o(am)o(s\(b)o(ri)o(dge)o(,)f(neqns,)k │ │ │ │ │ (type,)h(symmetryflag\))c(;)0 888 y(BridgeMT_setMess)o(age)o(In)o(fo)o │ │ │ │ │ (\(br)o(id)o(ge,)f(msglvl,)j(msgFile\))h(;)0 988 y(rc)i(=)g │ │ │ │ │ (BridgeMT_setup\(b)o(ri)o(dge)o(,)37 b(mtxA\))42 b(;)0 │ │ │ │ │ @@ -10512,17 +10497,17 @@ │ │ │ │ │ 4774 y(fprintf\(msgFile,)349 4873 y("\\n)173 b(CPU)42 │ │ │ │ │ b(\0458.3f)g(:)h(time)f(to)h(setup)e(parallel)f(factorization",)349 │ │ │ │ │ 4973 y(bridge->cpus[5])o(\))e(;)0 5073 y(if)43 b(\()g(msglvl)e(>)i(0)g │ │ │ │ │ (\))h({)131 5172 y(fprintf\(msgFile,)37 b("\\n)42 b(total)g(factor)f │ │ │ │ │ (operations)e(=)k(\045.0f",)479 5272 y(DV_sum\(bridge->cu)o(mop)o(sD)o │ │ │ │ │ (V\)\))37 b(;)131 5372 y(fprintf\(msgFile,)p eop end │ │ │ │ │ %%Page: 47 49 │ │ │ │ │ -TeXDict begin 47 48 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(47)479 │ │ │ │ │ +TeXDict begin 47 48 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(47)479 │ │ │ │ │ 390 y Fm("\\n)43 b(upper)e(bound)h(on)h(speedup)d(due)j(to)f(load)g │ │ │ │ │ (balance)f(=)i(\045.2f",)479 490 y(DV_sum\(bridge->cu)o(mop)o(sD)o │ │ │ │ │ (V\)/)o(DV)o(_m)o(ax\()o(br)o(idg)o(e-)o(>c)o(umo)o(ps)o(DV\))o(\))37 │ │ │ │ │ b(;)131 589 y(fprintf\(msgFile,)g("\\n)42 b(operations)e(distributions) │ │ │ │ │ e(over)k(threads"\))e(;)131 689 y(DV_writeForHuman)o(Ey)o(e\()o(bri)o │ │ │ │ │ (dg)o(e->)o(cu)o(mop)o(sD)o(V,)d(msgFile\))j(;)131 789 │ │ │ │ │ y(fflush\(msgFile\))d(;)0 888 y(})0 988 y(/*--------------)o(---)o(--)o │ │ │ │ │ @@ -10561,17 +10546,17 @@ │ │ │ │ │ (cpu)o(s[)o(10)o(]\))c(;)0 4774 y(fflush\(msgFile\))g(;)0 │ │ │ │ │ 4873 y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(-*/)0 4973 y(/*)131 5073 y(----------------)o(--)o(--)o(---)o(-) │ │ │ │ │ 131 5172 y(setup)k(the)i(parallel)d(solve)131 5272 y(----------------)o │ │ │ │ │ (--)o(--)o(---)o(-)0 5372 y(*/)p eop end │ │ │ │ │ %%Page: 48 50 │ │ │ │ │ -TeXDict begin 48 49 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(48)0 │ │ │ │ │ +TeXDict begin 48 49 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(48)0 │ │ │ │ │ 390 y Fm(rc)43 b(=)g(BridgeMT_solveSe)o(tu)o(p\(b)o(ri)o(dge)o(\))37 │ │ │ │ │ b(;)0 490 y(fprintf\(msgFile,)g("\\n\\n)k(-----)h(PARALLEL)e(SOLVE)i │ │ │ │ │ (SETUP)f(-----\\n"\))f(;)0 589 y(fprintf\(msgFile,)349 │ │ │ │ │ 689 y("\\n)173 b(CPU)42 b(\0458.3f)g(:)h(time)f(to)h(setup)e(parallel)f │ │ │ │ │ (solve",)349 789 y(bridge->cpus[11)o(]\))d(;)0 888 y(/*--------------)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ @@ -10612,17 +10597,17 @@ │ │ │ │ │ 4774 y(*/)131 4873 y(rc)g(=)g(DenseMtx_writeT)o(oFi)o(le)o(\(mt)o(xX)o │ │ │ │ │ (,)38 b(solFileName\))g(;)131 4973 y(if)43 b(\()g(rc)f(!=)h(1)g(\))h({) │ │ │ │ │ 262 5073 y(fprintf\(msgFile)o(,)610 5172 y("\\n)f(fatal)e(error)h │ │ │ │ │ (writing)e(mtxX)i(to)h(file)f(\045s,)g(rc)h(=)g(\045d",)610 │ │ │ │ │ 5272 y(solFileName,)c(rc\))j(;)262 5372 y(fflush\(msgFile\))37 │ │ │ │ │ b(;)p eop end │ │ │ │ │ %%Page: 49 51 │ │ │ │ │ -TeXDict begin 49 50 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(49)262 │ │ │ │ │ +TeXDict begin 49 50 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(49)262 │ │ │ │ │ 390 y Fm(exit\(-1\))40 b(;)131 490 y(})0 589 y(})0 689 │ │ │ │ │ y(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o │ │ │ │ │ (-*/)0 789 y(/*)131 888 y(----------------)o(--)o(--)o(-)131 │ │ │ │ │ 988 y(free)i(the)g(working)f(data)131 1088 y(----------------)o(--)o │ │ │ │ │ (--)o(-)0 1187 y(*/)0 1287 y(InpMtx_free\(mtxA)o(\))d(;)0 │ │ │ │ │ 1386 y(DenseMtx_free\(mt)o(xX\))f(;)0 1486 y(DenseMtx_free\(mt)o(xY\))g │ │ │ │ │ @@ -10664,17 +10649,17 @@ │ │ │ │ │ o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(-) │ │ │ │ │ 131 5172 y(find)g(out)g(the)g(identity)f(of)h(this)g(process)f(and)h │ │ │ │ │ (the)h(number)e(of)i(process)131 5272 y(----------------)o(--)o(--)o │ │ │ │ │ (---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o │ │ │ │ │ (--)o(---)o(--)o(---)o(-)0 5372 y(*/)1908 5656 y Fo(50)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 51 53 │ │ │ │ │ -TeXDict begin 51 52 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(51)0 │ │ │ │ │ +TeXDict begin 51 52 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(51)0 │ │ │ │ │ 390 y Fm(MPI_Init\(&argc,)37 b(&argv\))k(;)0 490 y(MPI_Comm_rank\(MP)o │ │ │ │ │ (I_C)o(OM)o(M_)o(WOR)o(LD)o(,)d(&myid\))j(;)0 589 y(MPI_Comm_size\(MP)o │ │ │ │ │ (I_C)o(OM)o(M_)o(WOR)o(LD)o(,)d(&nproc\))i(;)0 689 y(/*--------------)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ 789 y(/*)174 888 y(-----------------)o(--)o(-)174 988 │ │ │ │ │ y(get)j(input)e(parameters)174 1088 y(-----------------)o(--)o(-)0 │ │ │ │ │ @@ -10712,17 +10697,17 @@ │ │ │ │ │ ("\045s.\045d",)j(argv[2],)h(myid\))g(;)131 4774 y(if)i(\()g(\(msgFile) │ │ │ │ │ d(=)j(fopen\(buffer,)38 b("w"\)\))k(==)h(NULL)f(\))h({)262 │ │ │ │ │ 4873 y(fprintf\(stderr,)37 b("\\n)42 b(fatal)g(error)f(in)i(\045s")610 │ │ │ │ │ 4973 y("\\n)g(unable)e(to)h(open)g(file)g(\045s\\n",)610 │ │ │ │ │ 5073 y(argv[0],)e(argv[2]\))h(;)262 5172 y(MPI_Finalize\(\))c(;)262 │ │ │ │ │ 5272 y(return\(0\))i(;)131 5372 y(})p eop end │ │ │ │ │ %%Page: 52 54 │ │ │ │ │ -TeXDict begin 52 53 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(52)131 │ │ │ │ │ +TeXDict begin 52 53 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(52)131 │ │ │ │ │ 390 y Fm(CVfree\(buffer\))38 b(;)0 490 y(})0 589 y(neqns)347 │ │ │ │ │ b(=)43 b(atoi\(argv[3]\))38 b(;)0 689 y(type)391 b(=)43 │ │ │ │ │ b(atoi\(argv[4]\))38 b(;)0 789 y(symmetryflag)h(=)k(atoi\(argv[5]\))38 │ │ │ │ │ b(;)0 888 y(mtxFileName)83 b(=)43 b(argv[6])d(;)0 988 │ │ │ │ │ y(rhsFileName)83 b(=)43 b(argv[7])d(;)0 1088 y(solFileName)83 │ │ │ │ │ b(=)43 b(argv[8])d(;)0 1187 y(seed)391 b(=)43 b(atoi\(argv[9]\))38 │ │ │ │ │ b(;)0 1287 y(fprintf\(msgFile,)349 1386 y("\\n\\n)j(\045s)i(input)e(:") │ │ │ │ │ @@ -10758,17 +10743,17 @@ │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(---)o(-)131 5272 y(processor)j(0)j │ │ │ │ │ (broadcasts)c(the)k(error)e(return)g(to)i(the)f(other)g(processors)131 │ │ │ │ │ 5372 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(-)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 53 55 │ │ │ │ │ -TeXDict begin 53 54 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(53)0 │ │ │ │ │ +TeXDict begin 53 54 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(53)0 │ │ │ │ │ 390 y Fm(*/)0 490 y(MPI_Bcast\(\(void)37 b(*\))43 b(&rc,)f(1,)h │ │ │ │ │ (MPI_INT,)d(0,)j(MPI_COMM_WORLD\))37 b(;)0 589 y(if)43 │ │ │ │ │ b(\()g(rc)g(!=)f(1)i(\))f({)131 689 y(MPI_Finalize\(\))38 │ │ │ │ │ b(;)131 789 y(return\(-1\))h(;)0 888 y(})0 988 y(/*--------------)o │ │ │ │ │ (---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o(--)o(-*/)0 │ │ │ │ │ 1088 y(/*)131 1187 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ @@ -10806,17 +10791,17 @@ │ │ │ │ │ 4873 y(create)i(and)h(setup)g(a)h(BridgeMPI)d(object)131 │ │ │ │ │ 4973 y(set)i(the)g(MPI,)g(matrix)f(and)i(message)e(parameters)131 │ │ │ │ │ 5073 y(----------------)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(---)o(--)0 5172 y(*/)0 5272 y(bridge)g(=)i(BridgeMPI_new\(\))38 │ │ │ │ │ b(;)0 5372 y(BridgeMPI_setMPI)o(par)o(am)o(s\()o(bri)o(dg)o(e,)f │ │ │ │ │ (nproc,)k(myid,)h(MPI_COMM_WORLD\))37 b(;)p eop end │ │ │ │ │ %%Page: 54 56 │ │ │ │ │ -TeXDict begin 54 55 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(54)0 │ │ │ │ │ +TeXDict begin 54 55 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(54)0 │ │ │ │ │ 390 y Fm(BridgeMPI_setMat)o(rix)o(Pa)o(ra)o(ms\()o(br)o(idg)o(e,)37 │ │ │ │ │ b(neqns,)k(type,)h(symmetryflag\))c(;)0 490 y(BridgeMPI_setMes)o(sag)o │ │ │ │ │ (eI)o(nf)o(o\(b)o(ri)o(dge)o(,)f(msglvl,)k(msgFile\))f(;)0 │ │ │ │ │ 589 y(/*)131 689 y(----------------)o(-)131 789 y(setup)h(the)i │ │ │ │ │ (problem)131 888 y(----------------)o(-)0 988 y(*/)0 │ │ │ │ │ 1088 y(rc)g(=)g(BridgeMPI_setup\()o(br)o(idg)o(e,)37 │ │ │ │ │ b(mtxA\))42 b(;)0 1187 y(fprintf\(msgFile,)349 1287 y("\\n\\n)f(-----)h │ │ │ │ │ @@ -10856,17 +10841,17 @@ │ │ │ │ │ b(;)131 4774 y(MPI_Finalize\(\))38 b(;)131 4873 y(exit\(-1\))i(;)0 │ │ │ │ │ 4973 y(})0 5073 y(fprintf\(msgFile,)d("\\n\\n)k(-----)h(PARALLEL)e │ │ │ │ │ (FACTOR)h(SETUP)h(-----\\n"\))e(;)0 5172 y(fprintf\(msgFile,)349 │ │ │ │ │ 5272 y("\\n)173 b(CPU)42 b(\0458.3f)g(:)h(time)f(to)h(setup)e(parallel) │ │ │ │ │ f(factorization",)349 5372 y(bridge->cpus[7])o(\))e(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 55 57 │ │ │ │ │ -TeXDict begin 55 56 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(55)0 │ │ │ │ │ +TeXDict begin 55 56 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(55)0 │ │ │ │ │ 390 y Fm(if)43 b(\()g(msglvl)e(>)i(0)g(\))h({)131 490 │ │ │ │ │ y(fprintf\(msgFile,)37 b("\\n)42 b(total)g(factor)f(operations)e(=)k │ │ │ │ │ (\045.0f")479 589 y("\\n)g(upper)e(bound)h(on)h(speedup)d(due)j(to)f │ │ │ │ │ (load)g(balance)f(=)i(\045.2f",)479 689 y(DV_sum\(bridge->cu)o(mop)o │ │ │ │ │ (sD)o(V\),)479 789 y(DV_sum\(bridge->cu)o(mop)o(sD)o(V\)/)o(DV)o(_m)o │ │ │ │ │ (ax\()o(br)o(idg)o(e-)o(>c)o(umo)o(ps)o(DV\))o(\))37 │ │ │ │ │ b(;)131 888 y(fprintf\(msgFile,)g("\\n)42 b(operations)e(distributions) │ │ │ │ │ @@ -10913,17 +10898,17 @@ │ │ │ │ │ y(tstats[3],)f(tstats[4],)h(tstats[5]\))f(;)0 4973 y(fprintf\(msgFile,) │ │ │ │ │ 349 5073 y("\\n\\n)128 b(factorization:)38 b(raw)43 b(mflops)e │ │ │ │ │ (\0458.3f,)g(overall)f(mflops)i(\0458.3f",)349 5172 y(1.e-6*nfactorop)o │ │ │ │ │ (s/b)o(ri)o(dge)o(->)o(cpu)o(s[)o(11)o(],)349 5272 y(1.e-6*nfactorop)o │ │ │ │ │ (s/b)o(ri)o(dge)o(->)o(cpu)o(s[)o(13)o(]\))37 b(;)0 5372 │ │ │ │ │ y(fflush\(msgFile\))g(;)p eop end │ │ │ │ │ %%Page: 56 58 │ │ │ │ │ -TeXDict begin 56 57 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(56)0 │ │ │ │ │ +TeXDict begin 56 57 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(56)0 │ │ │ │ │ 390 y Fm(/*--------------)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o │ │ │ │ │ (--)o(--)o(---)o(--)o(---)o(--)o(--)o(---)o(--)o(---)o(--)o(---)o(--)o │ │ │ │ │ (--)o(-*/)0 490 y(/*)131 589 y(----------------)o(--)o(--)o(---)o(-)131 │ │ │ │ │ 689 y(setup)41 b(the)i(parallel)d(solve)131 789 y(----------------)o │ │ │ │ │ (--)o(--)o(---)o(-)0 888 y(*/)0 988 y(rc)j(=)g(BridgeMPI_solveS)o(et)o │ │ │ │ │ (up\()o(br)o(idg)o(e\))37 b(;)0 1088 y(fprintf\(msgFile,)g("\\n\\n)k │ │ │ │ │ (-----)h(PARALLEL)e(SOLVE)i(SETUP)f(-----\\n")349 1187 │ │ │ │ │ @@ -10964,17 +10949,17 @@ │ │ │ │ │ (time)f(to)h(solve)e(linear)g(system")349 5073 y("\\n)173 │ │ │ │ │ b(CPU)42 b(\0458.3f)g(:)h(time)f(to)h(gather)e(solution)f(")349 │ │ │ │ │ 5172 y("\\n)173 b(CPU)42 b(\0458.3f)g(:)h(time)f(to)h(permute)d │ │ │ │ │ (solution)g(into)i(old)h(ordering")349 5272 y("\\n)f(CPU)g(\0458.3f)g │ │ │ │ │ (:)h(total)f(solve)f(time")349 5372 y("\\n\\n)g(solve:)g(raw)i(mflops)e │ │ │ │ │ (\0458.3f,)g(overall)g(mflops)g(\0458.3f",)p eop end │ │ │ │ │ %%Page: 57 59 │ │ │ │ │ -TeXDict begin 57 58 bop 83 100 764 4 v 929 100 a Fp(SPOOLES)32 │ │ │ │ │ -b(2.2)f(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ -b(F)-7 b(ebruary)26 b(8,)i(2025)p 3056 100 V 764 w Fo(57)349 │ │ │ │ │ +TeXDict begin 57 58 bop 83 100 781 4 v 947 100 a Fp(SPOOLES)32 │ │ │ │ │ +b(2.2)e(W)-8 b(rapp)s(er)32 b(Ob)5 b(jects)28 b Fl(:)120 │ │ │ │ │ +b(Jan)n(uary)26 b(7,)h(2024)p 3038 100 V 781 w Fo(57)349 │ │ │ │ │ 390 y Fm(bridge->cpus[15)o(],)37 b(bridge->cpus[16],)g │ │ │ │ │ (bridge->cpus[17])o(,)349 490 y(bridge->cpus[18)o(],)g │ │ │ │ │ (bridge->cpus[19],)g(bridge->cpus[20])o(,)349 589 y(bridge->cpus[21)o │ │ │ │ │ (],)349 689 y(1.e-6*nsolveops)o(/br)o(id)o(ge-)o(>c)o(pus)o([1)o(8])o │ │ │ │ │ (,)349 789 y(1.e-6*nsolveops)o(/br)o(id)o(ge-)o(>c)o(pus)o([2)o(1])o │ │ │ │ │ (\))h(;)0 888 y(fflush\(msgFile\))f(;)0 988 y(if)43 b(\()g(myid)f(==)h │ │ │ │ │ (0)g(\))g({)131 1088 y(if)g(\()g(msglvl)e(>)i(0)g(\))g({)262 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ │ │ Wrapper Objects for Solving │ │ │ │ │ │ a Linear System of Equations │ │ │ │ │ │ using SPOOLES 2.2 │ │ │ │ │ │ Cleve Ashcraft Peter Schartz │ │ │ │ │ │ Boeing Shared Services Group1 CSARCorporation2 │ │ │ │ │ │ - February 8, 2025 │ │ │ │ │ │ + January 7, 2024 │ │ │ │ │ │ 1P. O. Box 24346, Mail Stop 7L-21, Seattle, Washington 98124. This research was supported in part by the │ │ │ │ │ │ DARPAContract DABT63-95-C-0122 and the DoD High Performance Computing Modernization Program Common │ │ │ │ │ │ HPCSoftware Support Initiative. │ │ │ │ │ │ 228035 Dorothy Drive, Agoura Hills, CA 91301. This research was supported in part by the DARPA Contract │ │ │ │ │ │ DABT63-95-C-0122 and the DoD High Performance Computing Modernization Program Common HPC Software │ │ │ │ │ │ Support Initiative. │ │ │ │ │ │ Abstract │ │ │ │ │ │ @@ -51,15 +51,15 @@ │ │ │ │ │ │ 4.3.5 Factor methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 │ │ │ │ │ │ 4.3.6 Solve methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 │ │ │ │ │ │ 5 The MPI Wrapper Object and Driver 27 │ │ │ │ │ │ 5.1 Aquick look at the MPI driver program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 │ │ │ │ │ │ 5.2 The BridgeMPI Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 │ │ │ │ │ │ 5.3 Prototypes and descriptions of BridgeMPI methods . . . . . . . . . . . . . . . . . . . . . . . . 32 │ │ │ │ │ │ 1 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 2 │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 2 │ │ │ │ │ │ 5.3.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 │ │ │ │ │ │ 5.3.2 Instance methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 │ │ │ │ │ │ 5.3.3 Parameter methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 │ │ │ │ │ │ 5.3.4 Setup methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 │ │ │ │ │ │ 5.3.5 Factor methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 │ │ │ │ │ │ 5.3.6 Solve methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 │ │ │ │ │ │ A testWrapper.c — A Serial Driver Program 37 │ │ │ │ │ │ @@ -104,25 +104,25 @@ │ │ │ │ │ │ the user must generate two SPOOLES objects — a InpMtx object for A and DenseMtx objects for Y and │ │ │ │ │ │ X. This process is described in section 2. │ │ │ │ │ │ Serial code has one process and one address space. Multithreaded code can have multiple threads sharing │ │ │ │ │ │ one address space. The SPOOLES library utilizes multiple threads only in the factorization and solve steps. │ │ │ │ │ │ All other operations act on the global data structures using serial methods. In the MPI environment, the │ │ │ │ │ │ data structures for A, X and Y may be distributed, and all working data structures that contain the factor │ │ │ │ │ │ 3 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 4 │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 4 │ │ │ │ │ │ matrices and their supporting information are distributed. The MPI code is much more complex than the │ │ │ │ │ │ serial or multithreaded codes, for not only are the factor and solves parallel and distributed (as is the symbolic │ │ │ │ │ │ factorization), but there is a great deal of support code necessary because of the distributed data structures. │ │ │ │ │ │ - ThewrappermethodsdescribedinthispaperdonotexerciseallthefunctionalityoftheMPIenvironment. │ │ │ │ │ │ + ThewrappermethodsdescribedinthispaperdonotexerciseallthefunctionalityoftheMPIenvironment. │ │ │ │ │ │ This is due to the present state of the CSAR-Nastran code from CSAR, where the matrix A and right hand │ │ │ │ │ │ side Y are generated on one processor. We chose to do all the serial preprocessing │ │ │ │ │ │ - • generate a graph of the matrix, │ │ │ │ │ │ - • order the graph, │ │ │ │ │ │ - • compute the symbolic factorization, │ │ │ │ │ │ - • and construct the permutations │ │ │ │ │ │ + • generate a graph of the matrix, │ │ │ │ │ │ + • order the graph, │ │ │ │ │ │ + • compute the symbolic factorization, │ │ │ │ │ │ + • and construct the permutations │ │ │ │ │ │ on processor 0 that reads in A and Y from the CSAR-Nastran files. Since the bulk of the overall time for a │ │ │ │ │ │ CSAR-Nastran run is dominated by the factor and solves, this approach was considered acceptable. For the │ │ │ │ │ │ user who is interested in using the MPI environment for the entire process, e.g., when A and Y cannot fit │ │ │ │ │ │ on one processor, see the SPOOLES User Manual for driver programs. │ │ │ │ │ │ Chapter 2 │ │ │ │ │ │ Setting up the linear system │ │ │ │ │ │ Ourtypical user is interested in solving AX = Y , where A is square, large and sparse, and X and Y are dense │ │ │ │ │ │ @@ -150,15 +150,15 @@ │ │ │ │ │ │ • INPMTX BY COLUMNS, where r(i,j) = j, c(i,j) = i. │ │ │ │ │ │ • INPMTX BY CHEVRONS, where r(i,j) = min(i,j), c(i,j) = j −i. │ │ │ │ │ │ Rows and columns are self-explanatory, the first coordinate r(i,j) is either the row or column of ai,j. The │ │ │ │ │ │ j-th “chevron” is composed of the diagonal entry aj,j, entries in the j-th row of the upper triangle, and │ │ │ │ │ │ entries in the j-th column of the lower triangle. It is the natural data structure for the assembly of the │ │ │ │ │ │ matrix entries into the “fronts” used to factor the matrix. │ │ │ │ │ │ 5 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 6 │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 6 │ │ │ │ │ │ The InpMtx object can hold one of three types of entries as “indices only” (no entries are present), real │ │ │ │ │ │ entries, or complex entries. The type is specified by the inputModeparameter to the InpMtx init() method. │ │ │ │ │ │ • INPMTX INDICES ONLY where the triples langler(i,j),c(i,j),−i are really only pairs, i.e., no numerical │ │ │ │ │ │ values are present. This mode is useful for assembling graphs. │ │ │ │ │ │ • SPOOLES REAL where ai,j is a real number, a double value. │ │ │ │ │ │ • SPOOLES COMPLEX where a is a complex number, really two consecutive double values. │ │ │ │ │ │ i,j │ │ │ │ │ │ @@ -192,15 +192,15 @@ │ │ │ │ │ │ to assemble finite element matrices.) The knowledgeable user can change the storage mode as necessary, │ │ │ │ │ │ and thus avoiding expensive sorts when possible. For example, after reading in the matrix data from the │ │ │ │ │ │ CSAR-Nastran file, the entries are already in sorted form, and the explicit sort can be avoided. │ │ │ │ │ │ Now let us see how we “input” information into the InpMtx object. There are several input methods, │ │ │ │ │ │ e.g., single entries, rows, columns, and submatrices, and each input method has three types of input, e.g, │ │ │ │ │ │ indices only, real entries, or complex entries. Here are the prototypes below. │ │ │ │ │ │ • Input methods for “indices only” mode. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 7 │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 7 │ │ │ │ │ │ void InpMtx_inputEntry ( InpMtx *mtxA, int row, int col ) ; │ │ │ │ │ │ void InpMtx_inputRow ( InpMtx *mtxA, int row, int rowsize, int rowind[] ) ; │ │ │ │ │ │ void InpMtx_inputColumn ( InpMtx *mtxA, int col, int colsize, int colind[] ) ; │ │ │ │ │ │ void InpMtx_inputMatrix ( InpMtx *mtxA, int nrow, int ncol, int rowstride, │ │ │ │ │ │ int colstride, int rowind[], colind[] ) ; │ │ │ │ │ │ • Input methods for real entries. │ │ │ │ │ │ void InpMtx_inputRealEntry ( InpMtx *mtxA, int row, int col, double value ) ; │ │ │ │ │ │ @@ -238,94 +238,94 @@ │ │ │ │ │ │ if ( ii < n1 ) { │ │ │ │ │ │ indices[count] = ij + 1 ; │ │ │ │ │ │ entries[count] = -1.0 ; │ │ │ │ │ │ count++ ; │ │ │ │ │ │ } │ │ │ │ │ │ if ( jj < n2 ) { │ │ │ │ │ │ indices[count] = ij + n1 ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 8 │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 8 │ │ │ │ │ │ entries[count] = -1.0 ; │ │ │ │ │ │ count++ ; │ │ │ │ │ │ - } │ │ │ │ │ │ - InpMtx_inputRealRow(mtxA, ij, count, indices, entries) ; │ │ │ │ │ │ - } │ │ │ │ │ │ + } │ │ │ │ │ │ + InpMtx_inputRealRow(mtxA, ij, count, indices, entries) ; │ │ │ │ │ │ + } │ │ │ │ │ │ } │ │ │ │ │ │ InpMtx_changeStorageMode(mtxA, INPMTX_BY_VECTORS) ; │ │ │ │ │ │ The process begins by allocating an InpMtx object mtxA using the InpMtx new() method, initializing it with │ │ │ │ │ │ the InpMtx init() method, and filling it with matrix entries with the InpMtx inputRealRow() method. │ │ │ │ │ │ The last method, InpMtx changeStorageMode(), “assembles” the data (not really necessary because the │ │ │ │ │ │ entries are disjoint, “sorts” the data (again not necessary since the entries were input in ascending order, │ │ │ │ │ │ and creates a vector structure inside the InpMtx object that allows easy access to each individual row. │ │ │ │ │ │ - We could have input all the entries and treated it as a nonsymmetric matrix, but that would not be │ │ │ │ │ │ + We could have input all the entries and treated it as a nonsymmetric matrix, but that would not be │ │ │ │ │ │ efficient with respect to storage or factorization cost. Alternatively, we could have input all the entries and │ │ │ │ │ │ called the InpMtx dropLowerTriangle() method to drop the lower triangular entries. │ │ │ │ │ │ - 2.2 Constructing an DenseMtx object │ │ │ │ │ │ + 2.2 Constructing an DenseMtx object │ │ │ │ │ │ The DenseMtx stores a real or complex dense matrix. It is not just an array of numbers, it also has row │ │ │ │ │ │ indices and column indices. This allows it to exist in a distributed MPI environment where each processors │ │ │ │ │ │ has only a submatrix of the matrix. Here is how to initialize a DenseMtx object. │ │ │ │ │ │ - int type, rowid, colid, nrow, ncol, inc1, inc2 ; │ │ │ │ │ │ - DenseMtx *mtx = DenseMtx_new() ; │ │ │ │ │ │ + int type, rowid, colid, nrow, ncol, inc1, inc2 ; │ │ │ │ │ │ + DenseMtx *mtx = DenseMtx_new() ; │ │ │ │ │ │ DenseMtx_init(mtx, type, rowid, colid, nrow, ncol, inc1, inc2) ; │ │ │ │ │ │ - • The type is either SPOOLES REAL or SPOOLES COMPLEX. │ │ │ │ │ │ - • The rowid and colid values are used to identify a DenseMtx as a submatrix of a larger matrix. Any │ │ │ │ │ │ + • The type is either SPOOLES REAL or SPOOLES COMPLEX. │ │ │ │ │ │ + • The rowid and colid values are used to identify a DenseMtx as a submatrix of a larger matrix. Any │ │ │ │ │ │ values are suitable. │ │ │ │ │ │ - • nrow and ncol are the number of rows and columns in the matrix, respectively. │ │ │ │ │ │ - • The entries of the matrix can be stored in either row major or column major form. For row major, use │ │ │ │ │ │ + • nrow and ncol are the number of rows and columns in the matrix, respectively. │ │ │ │ │ │ + • The entries of the matrix can be stored in either row major or column major form. For row major, use │ │ │ │ │ │ inc1 = ncol and inc2 = 1. For column major, use inc1 = 1 and inc2 = nrow. Note, all solve and │ │ │ │ │ │ matrix-matrix multiply methods require that the DenseMtx object be column major. │ │ │ │ │ │ For example, here is the call to initialize a DenseMtx object to have real entries, 100 rows and 5 columns, │ │ │ │ │ │ entries column major. │ │ │ │ │ │ DenseMtx_init(mtx, SPOOLES_REAL, 0, 0, 100, 5, 1, 100) ; │ │ │ │ │ │ During the initialization, the row indices are set to 0,1,...,nrow−1 and the column indices are set to │ │ │ │ │ │ 0,1,...,ncol−1. The entries are not initialized. Zero the entries with a call to DenseMtx zero(). (This is │ │ │ │ │ │ crucial when loading a sparse right hand side into the DenseMtx object.) │ │ │ │ │ │ - Once we have the DenseMtx object initialized, we want to be able to access the row indices, the column │ │ │ │ │ │ + Once we have the DenseMtx object initialized, we want to be able to access the row indices, the column │ │ │ │ │ │ indices and the entries. We do this through instance methods. │ │ │ │ │ │ void DenseMtx_rowIndices ( DenseMtx *mtx, int *pnrow, int *prowind ) ; │ │ │ │ │ │ void DenseMtx_columnIndices ( DenseMtx *mtx, int *pncol, int *pcolind ) ; │ │ │ │ │ │ double * DenseMtx_entries ( DenseMtx *mtx ) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 9 │ │ │ │ │ │ + SPOOLES2.2 Wrapper Objects : January 7, 2024 9 │ │ │ │ │ │ Wewould use them as follows. │ │ │ │ │ │ double *entries ; │ │ │ │ │ │ int ncol, nrow, *colind, *rowind ; │ │ │ │ │ │ DenseMtx_rowIndices(mtx, &nrow, &rowind) ; │ │ │ │ │ │ DenseMtx_columnIndices(mtx, &ncol, &colind) ; │ │ │ │ │ │ entries = DenseMtx_entries(mtx) ; │ │ │ │ │ │ We can now fill the indices or the entries. The location of the (irow,jcol) entry is found at offset = │ │ │ │ │ │ irow*inc1 + jcol*inc2. The row and column increments can be found as follows. │ │ │ │ │ │ int inc1 = DenseMtx_rowIncrement(mtx) ; │ │ │ │ │ │ int inc2 = DenseMtx_columnIncrement(mtx) ; │ │ │ │ │ │ - To avoid dealing with row and column increments, we can retrieve and set values of a particular entry. │ │ │ │ │ │ + To avoid dealing with row and column increments, we can retrieve and set values of a particular entry. │ │ │ │ │ │ double value, real, imag ; │ │ │ │ │ │ int irow, jcol ; │ │ │ │ │ │ DenseMtx_realEntry(mtx, irow, jcol, &value) ; │ │ │ │ │ │ DenseMtx_complexEntry(mtx, irow, jcol, &real, &imag) ; │ │ │ │ │ │ DenseMtx_setRealEntry(mtx, irow, jcol, value + 10.) ; │ │ │ │ │ │ DenseMtx_setComplexEntry(mtx, irow, jcol, real + 1., imag + 2.) ; │ │ │ │ │ │ As a real example, consider the n1 × n2 grid from the previous subsection, where we assembled a finite │ │ │ │ │ │ difference matrix. Assume that the right hand side is zero except for points where (n1-1,0:n2-1), where a │ │ │ │ │ │ unit load is applied. Here is the code to generate the DenseMtx object. │ │ │ │ │ │ mtxY = DenseMtx_new(); │ │ │ │ │ │ DenseMtx_init(mtxY, SPOOLES_REAL, 0, 0, n1*n2, 1, 1, n1*n2) ; │ │ │ │ │ │ DenseMtx_zero(mtxY) ; │ │ │ │ │ │ ii = n1 - 1 ; │ │ │ │ │ │ for ( jj = 0 ; jj < n2 ; jj++ ) { │ │ │ │ │ │ - ij = ii + jj*n1 ; │ │ │ │ │ │ - DenseMtx_setRealEntry(mtxY, ij, 1, 1.0) ; │ │ │ │ │ │ + ij = ii + jj*n1 ; │ │ │ │ │ │ + DenseMtx_setRealEntry(mtxY, ij, 1, 1.0) ; │ │ │ │ │ │ } │ │ │ │ │ │ Do not forget to zero the entries in mtxY before setting any entries. │ │ │ │ │ │ - 2.3 IO for the InpMtx and DenseMtx objects │ │ │ │ │ │ + 2.3 IO for the InpMtx and DenseMtx objects │ │ │ │ │ │ The three driver programs that we describe in the next sections read A and Y from files and write X to a │ │ │ │ │ │ file. So the first thing we know is that the InpMtx and DenseMtx objects can read and write themselves from │ │ │ │ │ │ and to files. This convention is supported by most of the objects in the SPOOLES library. In fact, there │ │ │ │ │ │ is a common protocol that is followed. Let us take a look at the common IO methods for the InpMtx. │ │ │ │ │ │ - • int InpMtx readFromFile ( InpMtx *obj, char *filename ) ; │ │ │ │ │ │ - • int InpMtx readFromFormattedFile ( InpMtx *obj, FILE *fp ) ; │ │ │ │ │ │ - • int InpMtx readFromBinaryFile ( InpMtx *obj, FILE *fp ) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 10 │ │ │ │ │ │ + • int InpMtx readFromFile ( InpMtx *obj, char *filename ) ; │ │ │ │ │ │ + • int InpMtx readFromFormattedFile ( InpMtx *obj, FILE *fp ) ; │ │ │ │ │ │ + • int InpMtx readFromBinaryFile ( InpMtx *obj, FILE *fp ) ; │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 10 │ │ │ │ │ │ • int InpMtx writeToFile ( InpMtx *obj, char *filename ) ; │ │ │ │ │ │ • int InpMtx writeToFormattedFile ( InpMtx *obj, FILE *fp ) ; │ │ │ │ │ │ • int InpMtx writeToBinaryFile ( InpMtx *obj, FILE *fp ) ; │ │ │ │ │ │ • int InpMtx writeForHumanEye ( InpMtx *obj, FILE *fp ) ; │ │ │ │ │ │ There are corresponding methods for the DenseMtx object, just replace “Inp” by “Dense” in the above │ │ │ │ │ │ prototypes. │ │ │ │ │ │ Two methods take as input char * file names. Each object can be archived in its own file with a │ │ │ │ │ │ @@ -375,15 +375,15 @@ │ │ │ │ │ │ ordering, factor and solve processes. │ │ │ │ │ │ Section 3.1 takes a quick look at the Bridge driver program (whose complete listing is found in Ap- │ │ │ │ │ │ pendix A). Section 3.2 describes the internal data fields of the Bridge object. Section 3.3 contains the │ │ │ │ │ │ prototypes and descriptions of all Bridge methods. │ │ │ │ │ │ 3.1 Aquick look at serial driver program │ │ │ │ │ │ The entire listing of this serial driver is found in Appendix A. We now extract parts of the code. │ │ │ │ │ │ 11 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 12 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 12 │ │ │ │ │ │ • Decode the input. │ │ │ │ │ │ msglvl = atoi(argv[1]) ; │ │ │ │ │ │ msgFileName = argv[6] ; │ │ │ │ │ │ neqns = atoi(argv[3]) ; │ │ │ │ │ │ type = atoi(argv[4]) ; │ │ │ │ │ │ symmetryflag = atoi(argv[5]) ; │ │ │ │ │ │ mtxFileName = argv[6] ; │ │ │ │ │ │ @@ -414,15 +414,15 @@ │ │ │ │ │ │ • Read in the DenseMtx object for Y. │ │ │ │ │ │ mtxY = DenseMtx_new() ; │ │ │ │ │ │ rc = DenseMtx_readFromFile(mtxY, mtxFileName) ; │ │ │ │ │ │ DenseMtx_dimensions(mtxY, &nrow, &nrhs) ; │ │ │ │ │ │ The nrhs parameter contains the number of right hand sides, or equivalently, the number of columns │ │ │ │ │ │ in Y . │ │ │ │ │ │ • Create and setup the Bridge object. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 13 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 13 │ │ │ │ │ │ bridge = Bridge_new() ; │ │ │ │ │ │ Bridge_setMatrixParams(bridge, neqns, type, symmetryflag) ; │ │ │ │ │ │ Bridge_setMessageInfo(bridge, msglvl, msgFile) ; │ │ │ │ │ │ rc = Bridge_setup(bridge, mtxA) ; │ │ │ │ │ │ TheBridgeobjectisallocatedbyBridge new(),andvariousparametersareset. Theactualorderingof │ │ │ │ │ │ the matrix, symbolic factorization, and permutation creation are performed inside the Bridge setup() │ │ │ │ │ │ method. │ │ │ │ │ │ @@ -451,15 +451,15 @@ │ │ │ │ │ │ • Ordering parameters: │ │ │ │ │ │ – int maxdomainsize : maximum size of a subgraph to not split any further during the nested │ │ │ │ │ │ dissection process. │ │ │ │ │ │ – int maxnzeros : maximum number of zeros to allow in a front during the supernode amalgama- │ │ │ │ │ │ tion process. │ │ │ │ │ │ – int maxsize : maximum size of a front when the fronts are split. │ │ │ │ │ │ – int seed : random number seed. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 14 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 14 │ │ │ │ │ │ – double compressCutoff : if the Neqns < compressCutoff ∗ neqns, then the compressed graph │ │ │ │ │ │ is formed, ordered and used to create the symbolic factorization. │ │ │ │ │ │ • Matrix parameters: │ │ │ │ │ │ – int type : type of entries, SPOOLES REAL or SPOOLES COMPLEX, default value is SPOOLES REAL. │ │ │ │ │ │ – int symmetryflag: type of symmetry for the matrix, SPOOLES SYMMETRIC, SPOOLES HERMITIAN │ │ │ │ │ │ or SPOOLES NONSYMMETRIC, default value is SPOOLES SYMMETRIC. │ │ │ │ │ │ • Factorization parameters: │ │ │ │ │ │ @@ -496,15 +496,15 @@ │ │ │ │ │ │ cpus[0] : time to construct Graph cpus[7] : time to factor matrix │ │ │ │ │ │ cpus[1] : time to compress Graph cpus[8] : time to post-process matrix │ │ │ │ │ │ cpus[2] : time to order Graph cpus[9] : total factor time │ │ │ │ │ │ cpus[3] : time for symbolic factorization cpus[10] : time to permute rhs │ │ │ │ │ │ cpus[4] : total setup time cpus[11] : time to solve │ │ │ │ │ │ cpus[5] : time to permute matrix cpus[12] : time to permute solution │ │ │ │ │ │ cpus[6] : time to initialize front matrix cpus[13] : total solve time │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 15 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 15 │ │ │ │ │ │ 3.3 Prototypes and descriptions of Bridge methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the Bridge object. │ │ │ │ │ │ 3.3.1 Basic methods │ │ │ │ │ │ Asusual, there are four basic methods to support object creation, setting default fields, clearing any allocated │ │ │ │ │ │ data, and free’ing the object. │ │ │ │ │ │ 1. Bridge * Bridge_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the Bridge structure and then sets the default fields by a call │ │ │ │ │ │ @@ -531,15 +531,15 @@ │ │ │ │ │ │ 3.3.2 Instance methods │ │ │ │ │ │ 1. int Bridge_oldToNewIV ( Bridge *bridge, IV **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its oldToNewIV pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 2. int Bridge_newToOldIV ( Bridge *bridge, IV **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its newToOldIV pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 16 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 16 │ │ │ │ │ │ 3. int Bridge_frontETree ( Bridge *bridge, ETree **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its frontETree pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 4. int Bridge_symbfacIVL ( Bridge *bridge, IVL **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its symbfacIVL pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 5. int Bridge_mtxmanager ( Bridge *bridge, SubMtxManager **pobj ) ; │ │ │ │ │ │ @@ -568,15 +568,15 @@ │ │ │ │ │ │ Return value: │ │ │ │ │ │ 1 normal return -3 pivotingflag is invalid │ │ │ │ │ │ -1 bridge is NULL -4 tau < 2.0 │ │ │ │ │ │ -2 sparsityflag is invalid -5 droptol < 0.0 │ │ │ │ │ │ 4. int Bridge_setMessagesInfo ( Bridge *bridge, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method sets the message level and file. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL, -2 if msglvl > 0 and msgFile is NULL. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 17 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 17 │ │ │ │ │ │ 3.3.4 Setup methods │ │ │ │ │ │ 1. int Bridge_setup ( Bridge *bridge, InpMtx *mtxA ) ; │ │ │ │ │ │ This method orders the graph, generates the front tree, computes the symbolic factorization, and │ │ │ │ │ │ creates the two permutation vectors. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL, -2 if mtxA is NULL. │ │ │ │ │ │ 2. int Bridge_factorStats ( Bridge *bridge, int type, int symmetryflag, int *pnfront, │ │ │ │ │ │ int *pnfactorind, int *pnfactorent, int *pnsolveops, double *pnfactorops ) ; │ │ │ │ │ │ @@ -635,15 +635,15 @@ │ │ │ │ │ │ (if pivoting is requested), the drop tolerance (for an approximate factorization), and so on. Rather than │ │ │ │ │ │ burden the user with the knowledge of and setting these parameters, there are decent default values built │ │ │ │ │ │ into the object. │ │ │ │ │ │ Section 4.1 takes a quick look at the BridgeMT driver program (whose complete listing is found in │ │ │ │ │ │ Appendix B). Section 4.2 describes the internal data fields of the BridgeMT object. Section 3.3 contains the │ │ │ │ │ │ prototypes and descriptions of all Bridge methods. │ │ │ │ │ │ 18 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 19 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 19 │ │ │ │ │ │ 4.1 Aquick look at the multithreaded driver program │ │ │ │ │ │ The entire listing of this multithreaded driver is found in Appendix B. We now extract parts of the code. │ │ │ │ │ │ • Decode the input. │ │ │ │ │ │ msglvl = atoi(argv[1]) ; │ │ │ │ │ │ msgFileName = argv[6] ; │ │ │ │ │ │ neqns = atoi(argv[3]) ; │ │ │ │ │ │ type = atoi(argv[4]) ; │ │ │ │ │ │ @@ -675,15 +675,15 @@ │ │ │ │ │ │ rc = InpMtx_readFromFile(mtxA, mtxFileName) ; │ │ │ │ │ │ The rc parameter is the error return. In the driver it is tested for an error, but we omit this from the │ │ │ │ │ │ present discussion. │ │ │ │ │ │ • Read in the DenseMtx object for Y. │ │ │ │ │ │ mtxY = DenseMtx_new() ; │ │ │ │ │ │ rc = DenseMtx_readFromFile(mtxY, mtxFileName) ; │ │ │ │ │ │ DenseMtx_dimensions(mtxY, &nrow, &nrhs) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 20 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 20 │ │ │ │ │ │ The nrhs parameter contains the number of right hand sides, or equivalently, the number of columns │ │ │ │ │ │ in Y . │ │ │ │ │ │ • Create and setup the BridgeMT object. │ │ │ │ │ │ bridge = BridgeMT_new() ; │ │ │ │ │ │ BridgeMT_setMatrixParams(bridge, neqns, type, symmetryflag) ; │ │ │ │ │ │ BridgeMT_setMessageInfo(bridge, msglvl, msgFile) ; │ │ │ │ │ │ rc = BridgeMT_setup(bridge, mtxA) ; │ │ │ │ │ │ @@ -711,15 +711,15 @@ │ │ │ │ │ │ DenseMtx_init(mtxX, type, 0, 0, neqns, nrhs, 1, neqns) ; │ │ │ │ │ │ DenseMtx_zero(mtxX) ; │ │ │ │ │ │ rc = BridgeMT_solve(bridge, permuteflag, mtxX, mtxY) ; │ │ │ │ │ │ The DenseMtx object mtxX is created and initialized to be the same type and size as mtxY. Its entries │ │ │ │ │ │ are explicitly zeroed (this is not necessary but is a good idea in general). The solution is then solved. │ │ │ │ │ │ Again, note the presence of permuteflag. When 1, mtxY needs to be permuted into the new ordering, │ │ │ │ │ │ and mtxX is returned in the original ordering. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 21 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 21 │ │ │ │ │ │ 4.2 The BridgeMT Data Structure │ │ │ │ │ │ The BridgeMT structure has the following fields. │ │ │ │ │ │ • Graph parameters: │ │ │ │ │ │ – int neqns : number of equations, i.e., number of vertices in the graph. │ │ │ │ │ │ – int nedges : number of edges (includes (u,v), (v,u) and (u,u)). │ │ │ │ │ │ – int Neqns : number of equations in the compressed graph. │ │ │ │ │ │ – int Nedges : number of edges in the compressed graph. │ │ │ │ │ │ @@ -751,15 +751,15 @@ │ │ │ │ │ │ • Pointers to objects: │ │ │ │ │ │ – ETree *frontETree : object that defines the factorizations, e.g., the number of fronts, the tree │ │ │ │ │ │ they form, the number of internal and external rows for each front, and the map from vertices to │ │ │ │ │ │ the front where it is contained. │ │ │ │ │ │ – IVL *symbfacIVL : object that contains the symbolic factorization of the matrix. │ │ │ │ │ │ – SubMtxManager *mtxmanager : object that manages the SubMtx objects that store the factor │ │ │ │ │ │ entries and are used in the solves. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 22 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 22 │ │ │ │ │ │ – FrontMtx *frontmtx : object that stores the L, D and U factor matrices. │ │ │ │ │ │ – IV *oldToNewIV : object that stores old-to-new permutation vector. │ │ │ │ │ │ – IV *newToOldIV : object that stores new-to-old permutation vector. │ │ │ │ │ │ • Multithreaded information: │ │ │ │ │ │ – int nthread : number of threads to be used during the factor and solve. │ │ │ │ │ │ – int lookahead : this parameter is used to possibly reduce the idle time of threads during the │ │ │ │ │ │ factorization. When lookahead is 0, the factorization uses the least amount of working storage │ │ │ │ │ │ @@ -790,15 +790,15 @@ │ │ │ │ │ │ cpus[7] : time to initialize front matrix cpus[15] : total solve time │ │ │ │ │ │ 4.3 Prototypes and descriptions of BridgeMT methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the BridgeMT │ │ │ │ │ │ object. │ │ │ │ │ │ 4.3.1 Basic methods │ │ │ │ │ │ Asusual, there are four basic methods to support object creation, setting default fields, clearing any allocated │ │ │ │ │ │ data, and free’ing the object. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 23 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 23 │ │ │ │ │ │ 1. BridgeMT * BridgeMT_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the BridgeMT structure and then sets the default fields by a │ │ │ │ │ │ call to BridgeMT setDefaultFields(). │ │ │ │ │ │ 2. int BridgeMT_setDefaultFields ( BridgeMT *bridge ) ; │ │ │ │ │ │ The structure’s fields are set to default values: │ │ │ │ │ │ • neqns = nedges = Neqns = Nedges = 0. │ │ │ │ │ │ • maxdomainsize = maxnzeros = maxsize = seed = -1. compressCutoff = 0. │ │ │ │ │ │ @@ -828,15 +828,15 @@ │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 3. int BridgeMT_frontETree ( BridgeMT *bridge, ETree **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its frontETree pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 4. int BridgeMT_symbfacIVL ( BridgeMT *bridge, IVL **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its symbfacIVL pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 24 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 24 │ │ │ │ │ │ 5. int BridgeMT_mtxmanager ( BridgeMT *bridge, SubMtxManager **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its mtxmanager pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 6. int BridgeMT_frontmtx ( BridgeMT *bridge, FrontMtx **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its frontmtx pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 7. int BridgeMT_ownersIV ( BridgeMT *bridge, IV **pobj ) ; │ │ │ │ │ │ @@ -865,15 +865,15 @@ │ │ │ │ │ │ 1 normal return -3 maxsize ≤ 0 │ │ │ │ │ │ -1 bridge is NULL -4 compressCutoff> 1 │ │ │ │ │ │ -2 maxdomainsize ≤ 0 │ │ │ │ │ │ 3. int BridgeMT_setFactorParams ( BridgeMT *bridge, int sparsityflag, int pivotingflag, │ │ │ │ │ │ double tau, double droptol, int lookahead, PatchAndGoInfo *patchinfo ) ; │ │ │ │ │ │ This method sets parameters needed for the factorization. │ │ │ │ │ │ Return value: │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 25 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 25 │ │ │ │ │ │ 1 normal return -4 tau < 2.0 │ │ │ │ │ │ -1 bridge is NULL -5 droptol < 0.0 │ │ │ │ │ │ -2 sparsityflag is invalid -6 lookahead < 0 │ │ │ │ │ │ -3 pivotingflag is invalid │ │ │ │ │ │ 4. int BridgeMT_setMessagesInfo ( BridgeMT *bridge, int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method sets the message level and file. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL, -2 if msglvl > 0 and msgFile is NULL. │ │ │ │ │ │ @@ -905,15 +905,15 @@ │ │ │ │ │ │ Thewrapmapandbalancedmaparenotrecommended. Thesubtree-subsetmapisagoodmapwitha │ │ │ │ │ │ very well balanced nested dissection ordering. The domain decomposition map is recommended when │ │ │ │ │ │ the nested dissection tree is imbalanced or for the multisection ordering. The domain decomposition │ │ │ │ │ │ map requires a cutoff parameter in [0,1] which specifies the relative size of a subtree that forms a │ │ │ │ │ │ domain. If maptype is not one of 1, 2, 3 or 4, the default map is used: domain decomposition with │ │ │ │ │ │ cutoff = 1/(2*nthread). │ │ │ │ │ │ Return value: │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 26 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 26 │ │ │ │ │ │ 1 normal return, factorization did complete -2 nthread < 1 │ │ │ │ │ │ -1 bridge is NULL -5 frontETree is not present │ │ │ │ │ │ 2. int BridgeMT_factor ( BridgeMT *bridge, InpMtx *mtxA, int permuteflag, int *perror ) ; │ │ │ │ │ │ This method permutes the matrix into the new ordering (if permuteflagis 1), factors the matrix, and │ │ │ │ │ │ then post-processes the factors. │ │ │ │ │ │ Return value: │ │ │ │ │ │ 1 normal return, factorization did complete -1 bridge is NULL │ │ │ │ │ │ @@ -960,15 +960,15 @@ │ │ │ │ │ │ burden the user with the knowledge of and setting these parameters, there are decent default values built │ │ │ │ │ │ into the object. Using the BridgeMPI object to solve a linear system of equations can be broken down into │ │ │ │ │ │ three steps. │ │ │ │ │ │ Section 5.1 takes a quick look at the BridgeMPI driver program (whose complete listing is found in │ │ │ │ │ │ Appendix C). Section 5.2 describes the internal data fields of the BridgeMPI object. Section 3.3 contains │ │ │ │ │ │ the prototypes and descriptions of all Bridge methods. │ │ │ │ │ │ 27 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 28 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 28 │ │ │ │ │ │ 5.1 Aquick look at the MPI driver program │ │ │ │ │ │ The entire listing of this MPI driver is found in Appendix C. We now extract parts of the code. │ │ │ │ │ │ • Decode the input. │ │ │ │ │ │ msglvl = atoi(argv[1]) ; │ │ │ │ │ │ msgFileName = argv[6] ; │ │ │ │ │ │ neqns = atoi(argv[3]) ; │ │ │ │ │ │ type = atoi(argv[4]) ; │ │ │ │ │ │ @@ -1001,15 +1001,15 @@ │ │ │ │ │ │ • Processor 0 reads in the DenseMtx object for Y. │ │ │ │ │ │ mtxY = DenseMtx_new() ; │ │ │ │ │ │ rc = DenseMtx_readFromFile(mtxY, mtxFileName) ; │ │ │ │ │ │ DenseMtx_dimensions(mtxY, &nrow, &nrhs) ; │ │ │ │ │ │ The nrhs parameter contains the number of right hand sides, or equivalently, the number of columns │ │ │ │ │ │ in Y . Processor 0 then broadcasts the error return to the other processors. If an error occured reading │ │ │ │ │ │ in the matrix, all processors call MPI Finalize() and exit. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 29 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 29 │ │ │ │ │ │ • Create and setup the BridgeMPI object. │ │ │ │ │ │ bridge = BridgeMPI_new() ; │ │ │ │ │ │ BridgeMPI_setMPIparams(bridge, nproc, myid, MPI_COMM_WORLD) ; │ │ │ │ │ │ BridgeMPI_setMatrixParams(bridge, neqns, type, symmetryflag) ; │ │ │ │ │ │ BridgeMPI_setMessageInfo(bridge, msglvl, msgFile) ; │ │ │ │ │ │ rc = BridgeMPI_setup(bridge, mtxA) ; │ │ │ │ │ │ The BridgeMPI object is allocated by BridgeMPI new(), and various parameters are set. The actual │ │ │ │ │ │ @@ -1037,15 +1037,15 @@ │ │ │ │ │ │ mtxX = DenseMtx_new() ; │ │ │ │ │ │ DenseMtx_init(mtxX, type, 0, 0, neqns, nrhs, 1, neqns) ; │ │ │ │ │ │ DenseMtx_zero(mtxX) ; │ │ │ │ │ │ All processors then cooperate to compute the solution X. │ │ │ │ │ │ rc = BridgeMPI_solve(bridge, permuteflag, mtxX, mtxY) ; │ │ │ │ │ │ Again, note the presence of permuteflag. When 1, mtxY needs to be permuted into the new ordering, │ │ │ │ │ │ and mtxX is returned in the original ordering. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 30 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 30 │ │ │ │ │ │ 5.2 The BridgeMPI Data Structure │ │ │ │ │ │ The BridgeMPI structure has the following fields. │ │ │ │ │ │ • Graph parameters: │ │ │ │ │ │ – int neqns : number of equations, i.e., number of vertices in the graph. │ │ │ │ │ │ – int nedges : number of edges (includes (u,v), (v,u) and (u,u)). │ │ │ │ │ │ – int Neqns : number of equations in the compressed graph. │ │ │ │ │ │ – int Nedges : number of edges in the compressed graph. │ │ │ │ │ │ @@ -1078,15 +1078,15 @@ │ │ │ │ │ │ factorization. When lookahead is 0, the factorization uses the least amount of working storage │ │ │ │ │ │ but threads can be idle. Larger values of lookahead tend to increase the working storage but │ │ │ │ │ │ may decrease the execution time. Values of lookahead greater than nthread are not useful. │ │ │ │ │ │ • Pointers to objects: │ │ │ │ │ │ – ETree *frontETree : object that defines the factorizations, e.g., the number of fronts, the tree │ │ │ │ │ │ they form, the number of internal and external rows for each front, and the map from vertices to │ │ │ │ │ │ the front where it is contained. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 31 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 31 │ │ │ │ │ │ – IVL *symbfacIVL : object that contains the symbolic factorization of the matrix. │ │ │ │ │ │ – SubMtxManager *mtxmanager : object that manages the SubMtx objects that store the factor │ │ │ │ │ │ entries and are used in the solves. │ │ │ │ │ │ – FrontMtx *frontmtx : object that stores the L, D and U factor matrices. │ │ │ │ │ │ – IV *oldToNewIV : object that stores old-to-new permutation vector. │ │ │ │ │ │ – IV *newToOldIV : object that stores new-to-old permutation vector. │ │ │ │ │ │ • MPI information: │ │ │ │ │ │ @@ -1124,15 +1124,15 @@ │ │ │ │ │ │ cpus[4] : broadcast the front tree cpus[15] : permute rhs │ │ │ │ │ │ cpus[5] : broadcast symbolic factor cpus[16] : distribute rhs │ │ │ │ │ │ cpus[6] : total setup time cpus[17] : create solution matrix │ │ │ │ │ │ cpus[7] : setup the factorization cpus[18] : solve │ │ │ │ │ │ cpus[8] : permute matrix cpus[19] : gather solution │ │ │ │ │ │ cpus[9] : distribute matrix cpus[20] : permute solution │ │ │ │ │ │ cpus[10] : initialize front matrix cpus[21] : total solve time │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 32 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 32 │ │ │ │ │ │ 5.3 Prototypes and descriptions of BridgeMPI methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the BridgeMPI │ │ │ │ │ │ object. │ │ │ │ │ │ 5.3.1 Basic methods │ │ │ │ │ │ Asusual, there are four basic methods to support object creation, setting default fields, clearing any allocated │ │ │ │ │ │ data, and free’ing the object. │ │ │ │ │ │ 1. BridgeMPI * BridgeMPI_new ( void ) ; │ │ │ │ │ │ @@ -1157,15 +1157,15 @@ │ │ │ │ │ │ 3. int BridgeMPI_clearData ( BridgeMPI *bridge ) ; │ │ │ │ │ │ Thismethodclearstheobjectandfree’sanyowneddata. ItthencallsBridgeMPI setDefaultFields(). │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. │ │ │ │ │ │ 4. int BridgeMPI_free ( BridgeMPI *bridge ) ; │ │ │ │ │ │ This method releases any storage by a call to BridgeMPI clearData() and then free the space for │ │ │ │ │ │ bridge. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 33 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 33 │ │ │ │ │ │ 5.3.2 Instance methods │ │ │ │ │ │ 1. int BridgeMPI_oldToNewIV ( BridgeMPI *bridge, IV **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its oldToNewIV pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 2. int BridgeMPI_newToOldIV ( BridgeMPI *bridge, IV **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its newToOldIV pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ @@ -1192,15 +1192,15 @@ │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 10. int BridgeMPI_rowmapIV ( BridgeMPI *bridge, IV **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its rowmapIV pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 11. int BridgeMPI_ownedColumns ( BridgeMPI *bridge, IV **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its ownedColumnsIV pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 34 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 34 │ │ │ │ │ │ 12. int BridgeMPI_Xloc ( BridgeMPI *bridge, DenseMtx **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its Xloc pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 13. int BridgeMPI_Yloc ( BridgeMPI *bridge, DenseMtx **pobj ) ; │ │ │ │ │ │ This method fills *pobj with its Yloc pointer. │ │ │ │ │ │ Return value: 1 for a normal return, -1 if bridge is NULL. -2 if pobj is NULL. │ │ │ │ │ │ 14. int BridgeMPI_nproc ( BridgeMPI *bridge, int *pnproc ) ; │ │ │ │ │ │ @@ -1227,15 +1227,15 @@ │ │ │ │ │ │ 3. int BridgeMPI_setOrderingParams ( BridgeMPI *bridge, int maxdomainsize, int maxnzeros, │ │ │ │ │ │ int maxsize, int seed, double compressCutoff ) ; │ │ │ │ │ │ This method sets parameters needed for the ordering. │ │ │ │ │ │ Return value: │ │ │ │ │ │ 1 normal return -3 maxsize ≤ 0 │ │ │ │ │ │ -1 bridge is NULL -4 compressCutoff> 1 │ │ │ │ │ │ -2 maxdomainsize ≤ 0 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 35 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 35 │ │ │ │ │ │ 4. int BridgeMPI_setFactorParams ( BridgeMPI *bridge, int sparsityflag, int pivotingflag, │ │ │ │ │ │ double tau, double droptol, int lookahead, PatchAndGoInfo *patchinfo ) ; │ │ │ │ │ │ This method sets parameters needed for the factorization. │ │ │ │ │ │ Return value: │ │ │ │ │ │ 1 normal return -4 tau < 2.0 │ │ │ │ │ │ -1 bridge is NULL -5 droptol < 0.0 │ │ │ │ │ │ -2 sparsityflag is invalid -6 lookahead < 0 │ │ │ │ │ │ @@ -1264,15 +1264,15 @@ │ │ │ │ │ │ 1. int BridgeMPI_factorSetup ( BridgeMPI *bridge, int maptype, double cutoff ) ; │ │ │ │ │ │ This method constructs the map from fronts to owning processors, and computes the number of factor │ │ │ │ │ │ operations that each thread will execute. The maptype parameter can be one of four values: │ │ │ │ │ │ • 1 — wrap map │ │ │ │ │ │ • 2 — balanced map │ │ │ │ │ │ • 3 — subtree-subset map │ │ │ │ │ │ • 4 — domain decomposition map │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 36 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 36 │ │ │ │ │ │ Thewrapmapandbalancedmaparenotrecommended. Thesubtree-subsetmapisagoodmapwitha │ │ │ │ │ │ very well balanced nested dissection ordering. The domain decomposition map is recommended when │ │ │ │ │ │ the nested dissection tree is imbalanced or for the multisection ordering. The domain decomposition │ │ │ │ │ │ map requires a cutoff parameter in [0,1] which specifies the relative size of a subtree that forms a │ │ │ │ │ │ domain. If maptype is not one of 1, 2, 3 or 4, the default map is used: domain decomposition with │ │ │ │ │ │ cutoff = 1/(2*nthread). │ │ │ │ │ │ Return value: 1 normal return, factorization did complete, -1 bridge is NULL, -2 frontETree is not │ │ │ │ │ │ @@ -1328,15 +1328,15 @@ │ │ │ │ │ │ get input parameters │ │ │ │ │ │ -------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ if ( argc != 10 ) { │ │ │ │ │ │ fprintf(stdout, │ │ │ │ │ │ "\n\n usage : %s msglvl msgFile neqns type symmetryflag" │ │ │ │ │ │ 37 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 38 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 38 │ │ │ │ │ │ "\n mtxFile rhsFile seed" │ │ │ │ │ │ "\n msglvl -- message level" │ │ │ │ │ │ "\n 0 -- no output" │ │ │ │ │ │ "\n 1 -- timings and statistics" │ │ │ │ │ │ "\n 2 and greater -- lots of output" │ │ │ │ │ │ "\n msgFile -- message file" │ │ │ │ │ │ "\n neqns -- # of equations" │ │ │ │ │ │ @@ -1380,15 +1380,15 @@ │ │ │ │ │ │ "\n msglvl = %d" │ │ │ │ │ │ "\n msgFile = %s" │ │ │ │ │ │ "\n neqns = %d" │ │ │ │ │ │ "\n type = %d" │ │ │ │ │ │ "\n symmetryflag = %d" │ │ │ │ │ │ "\n mtxFile = %s" │ │ │ │ │ │ "\n rhsFile = %s" │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 39 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 39 │ │ │ │ │ │ "\n solFile = %s" │ │ │ │ │ │ "\n seed = %d" │ │ │ │ │ │ "\n", │ │ │ │ │ │ argv[0], msglvl, argv[2], neqns, type, symmetryflag, │ │ │ │ │ │ mtxFileName, rhsFileName, solFileName, seed) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ @@ -1431,15 +1431,15 @@ │ │ │ │ │ │ DenseMtx_dimensions(mtxY, &nrow, &nrhs) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ -------------------------------- │ │ │ │ │ │ create and setup a Bridge object │ │ │ │ │ │ -------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 40 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 40 │ │ │ │ │ │ bridge = Bridge_new() ; │ │ │ │ │ │ Bridge_setMatrixParams(bridge, neqns, type, symmetryflag) ; │ │ │ │ │ │ Bridge_setMessageInfo(bridge, msglvl, msgFile) ; │ │ │ │ │ │ rc = Bridge_setup(bridge, mtxA) ; │ │ │ │ │ │ if ( rc != 1 ) { │ │ │ │ │ │ fprintf(stderr, "\n error return %d from Bridge_setup()", rc) ; │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ @@ -1483,15 +1483,15 @@ │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ fprintf(msgFile, "\n\n ----- FACTORIZATION -----\n") ; │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ "\n CPU %8.3f : time to permute original matrix" │ │ │ │ │ │ "\n CPU %8.3f : time to initialize factor matrix" │ │ │ │ │ │ "\n CPU %8.3f : time to compute factorization" │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 41 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 41 │ │ │ │ │ │ "\n CPU %8.3f : time to post-process factorization" │ │ │ │ │ │ "\n CPU %8.3f : total factorization time\n", │ │ │ │ │ │ bridge->cpus[5], bridge->cpus[6], bridge->cpus[7], │ │ │ │ │ │ bridge->cpus[8], bridge->cpus[9]) ; │ │ │ │ │ │ fprintf(msgFile, "\n\n factorization statistics" │ │ │ │ │ │ "\n %d pivots, %d pivot tests, %d delayed vertices" │ │ │ │ │ │ "\n %d entries in D, %d entries in L, %d entries in U", │ │ │ │ │ │ @@ -1535,15 +1535,15 @@ │ │ │ │ │ │ DenseMtx_writeForHumanEye(mtxX, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ if ( strcmp(solFileName, "none") != 0 ) { │ │ │ │ │ │ /* │ │ │ │ │ │ ----------------------------------- │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 42 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 42 │ │ │ │ │ │ write the solution matrix to a file │ │ │ │ │ │ ----------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ rc = DenseMtx_writeToFile(mtxX, solFileName) ; │ │ │ │ │ │ if ( rc != 1 ) { │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ "\n fatal error writing mtxX to file %s, rc = %d", │ │ │ │ │ │ @@ -1595,15 +1595,15 @@ │ │ │ │ │ │ /* │ │ │ │ │ │ -------------------- │ │ │ │ │ │ get input parameters │ │ │ │ │ │ -------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ if ( argc != 11 ) { │ │ │ │ │ │ 43 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 44 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 44 │ │ │ │ │ │ fprintf(stdout, │ │ │ │ │ │ "\n\n usage : %s msglvl msgFile neqns type symmetryflag " │ │ │ │ │ │ "\n mtxFile rhsFile solFile seed nthread\n" │ │ │ │ │ │ "\n msglvl -- message level" │ │ │ │ │ │ "\n 0 -- no output" │ │ │ │ │ │ "\n 1 -- timings and statistics" │ │ │ │ │ │ "\n 2 and greater -- lots of output" │ │ │ │ │ │ @@ -1647,15 +1647,15 @@ │ │ │ │ │ │ seed = atoi(argv[9]) ; │ │ │ │ │ │ nthread = atoi(argv[10]) ; │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ "\n\n %s input :" │ │ │ │ │ │ "\n msglvl = %d" │ │ │ │ │ │ "\n msgFile = %s" │ │ │ │ │ │ "\n neqns = %d" │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 45 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 45 │ │ │ │ │ │ "\n type = %d" │ │ │ │ │ │ "\n symmetryflag = %d" │ │ │ │ │ │ "\n mtxFile = %s" │ │ │ │ │ │ "\n rhsFile = %s" │ │ │ │ │ │ "\n solFile = %s" │ │ │ │ │ │ "\n nthread = %d" │ │ │ │ │ │ "\n", │ │ │ │ │ │ @@ -1699,15 +1699,15 @@ │ │ │ │ │ │ DenseMtx_writeForHumanEye(mtxY, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ DenseMtx_dimensions(mtxY, &nrow, &nrhs) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ---------------------------------- │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 46 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 46 │ │ │ │ │ │ create and setup a BridgeMT object │ │ │ │ │ │ ---------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ bridge = BridgeMT_new() ; │ │ │ │ │ │ BridgeMT_setMatrixParams(bridge, neqns, type, symmetryflag) ; │ │ │ │ │ │ BridgeMT_setMessageInfo(bridge, msglvl, msgFile) ; │ │ │ │ │ │ rc = BridgeMT_setup(bridge, mtxA) ; │ │ │ │ │ │ @@ -1751,15 +1751,15 @@ │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ "\n CPU %8.3f : time to setup parallel factorization", │ │ │ │ │ │ bridge->cpus[5]) ; │ │ │ │ │ │ if ( msglvl > 0 ) { │ │ │ │ │ │ fprintf(msgFile, "\n total factor operations = %.0f", │ │ │ │ │ │ DV_sum(bridge->cumopsDV)) ; │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 47 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 47 │ │ │ │ │ │ "\n upper bound on speedup due to load balance = %.2f", │ │ │ │ │ │ DV_sum(bridge->cumopsDV)/DV_max(bridge->cumopsDV)) ; │ │ │ │ │ │ fprintf(msgFile, "\n operations distributions over threads") ; │ │ │ │ │ │ DV_writeForHumanEye(bridge->cumopsDV, msgFile) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ @@ -1803,15 +1803,15 @@ │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------ │ │ │ │ │ │ setup the parallel solve │ │ │ │ │ │ ------------------------ │ │ │ │ │ │ */ │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 48 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 48 │ │ │ │ │ │ rc = BridgeMT_solveSetup(bridge) ; │ │ │ │ │ │ fprintf(msgFile, "\n\n ----- PARALLEL SOLVE SETUP -----\n") ; │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ "\n CPU %8.3f : time to setup parallel solve", │ │ │ │ │ │ bridge->cpus[11]) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ @@ -1855,15 +1855,15 @@ │ │ │ │ │ │ */ │ │ │ │ │ │ rc = DenseMtx_writeToFile(mtxX, solFileName) ; │ │ │ │ │ │ if ( rc != 1 ) { │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ "\n fatal error writing mtxX to file %s, rc = %d", │ │ │ │ │ │ solFileName, rc) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 49 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 49 │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ --------------------- │ │ │ │ │ │ free the working data │ │ │ │ │ │ @@ -1906,15 +1906,15 @@ │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ --------------------------------------------------------------- │ │ │ │ │ │ find out the identity of this process and the number of process │ │ │ │ │ │ --------------------------------------------------------------- │ │ │ │ │ │ */ │ │ │ │ │ │ 50 │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 51 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 51 │ │ │ │ │ │ MPI_Init(&argc, &argv) ; │ │ │ │ │ │ MPI_Comm_rank(MPI_COMM_WORLD, &myid) ; │ │ │ │ │ │ MPI_Comm_size(MPI_COMM_WORLD, &nproc) ; │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ -------------------- │ │ │ │ │ │ get input parameters │ │ │ │ │ │ @@ -1958,15 +1958,15 @@ │ │ │ │ │ │ if ( (msgFile = fopen(buffer, "w")) == NULL ) { │ │ │ │ │ │ fprintf(stderr, "\n fatal error in %s" │ │ │ │ │ │ "\n unable to open file %s\n", │ │ │ │ │ │ argv[0], argv[2]) ; │ │ │ │ │ │ MPI_Finalize() ; │ │ │ │ │ │ return(0) ; │ │ │ │ │ │ } │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 52 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 52 │ │ │ │ │ │ CVfree(buffer) ; │ │ │ │ │ │ } │ │ │ │ │ │ neqns = atoi(argv[3]) ; │ │ │ │ │ │ type = atoi(argv[4]) ; │ │ │ │ │ │ symmetryflag = atoi(argv[5]) ; │ │ │ │ │ │ mtxFileName = argv[6] ; │ │ │ │ │ │ rhsFileName = argv[7] ; │ │ │ │ │ │ @@ -2010,15 +2010,15 @@ │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ } │ │ │ │ │ │ } │ │ │ │ │ │ /* │ │ │ │ │ │ --------------------------------------------------------------- │ │ │ │ │ │ processor 0 broadcasts the error return to the other processors │ │ │ │ │ │ --------------------------------------------------------------- │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 53 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 53 │ │ │ │ │ │ */ │ │ │ │ │ │ MPI_Bcast((void *) &rc, 1, MPI_INT, 0, MPI_COMM_WORLD) ; │ │ │ │ │ │ if ( rc != 1 ) { │ │ │ │ │ │ MPI_Finalize() ; │ │ │ │ │ │ return(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ @@ -2062,15 +2062,15 @@ │ │ │ │ │ │ ------------------------------------------ │ │ │ │ │ │ create and setup a BridgeMPI object │ │ │ │ │ │ set the MPI, matrix and message parameters │ │ │ │ │ │ ------------------------------------------ │ │ │ │ │ │ */ │ │ │ │ │ │ bridge = BridgeMPI_new() ; │ │ │ │ │ │ BridgeMPI_setMPIparams(bridge, nproc, myid, MPI_COMM_WORLD) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 54 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 54 │ │ │ │ │ │ BridgeMPI_setMatrixParams(bridge, neqns, type, symmetryflag) ; │ │ │ │ │ │ BridgeMPI_setMessageInfo(bridge, msglvl, msgFile) ; │ │ │ │ │ │ /* │ │ │ │ │ │ ----------------- │ │ │ │ │ │ setup the problem │ │ │ │ │ │ ----------------- │ │ │ │ │ │ */ │ │ │ │ │ │ @@ -2114,15 +2114,15 @@ │ │ │ │ │ │ MPI_Finalize() ; │ │ │ │ │ │ exit(-1) ; │ │ │ │ │ │ } │ │ │ │ │ │ fprintf(msgFile, "\n\n ----- PARALLEL FACTOR SETUP -----\n") ; │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ "\n CPU %8.3f : time to setup parallel factorization", │ │ │ │ │ │ bridge->cpus[7]) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 55 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 55 │ │ │ │ │ │ if ( msglvl > 0 ) { │ │ │ │ │ │ fprintf(msgFile, "\n total factor operations = %.0f" │ │ │ │ │ │ "\n upper bound on speedup due to load balance = %.2f", │ │ │ │ │ │ DV_sum(bridge->cumopsDV), │ │ │ │ │ │ DV_sum(bridge->cumopsDV)/DV_max(bridge->cumopsDV)) ; │ │ │ │ │ │ fprintf(msgFile, "\n operations distributions over processors") ; │ │ │ │ │ │ DV_writeForHumanEye(bridge->cumopsDV, msgFile) ; │ │ │ │ │ │ @@ -2166,15 +2166,15 @@ │ │ │ │ │ │ tstats[0], tstats[1], tstats[2], │ │ │ │ │ │ tstats[3], tstats[4], tstats[5]) ; │ │ │ │ │ │ fprintf(msgFile, │ │ │ │ │ │ "\n\n factorization: raw mflops %8.3f, overall mflops %8.3f", │ │ │ │ │ │ 1.e-6*nfactorops/bridge->cpus[11], │ │ │ │ │ │ 1.e-6*nfactorops/bridge->cpus[13]) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 56 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 56 │ │ │ │ │ │ /*--------------------------------------------------------------------*/ │ │ │ │ │ │ /* │ │ │ │ │ │ ------------------------ │ │ │ │ │ │ setup the parallel solve │ │ │ │ │ │ ------------------------ │ │ │ │ │ │ */ │ │ │ │ │ │ rc = BridgeMPI_solveSetup(bridge) ; │ │ │ │ │ │ @@ -2218,15 +2218,15 @@ │ │ │ │ │ │ "\n CPU %8.3f : time to distribute rhs " │ │ │ │ │ │ "\n CPU %8.3f : time to initialize solution matrix " │ │ │ │ │ │ "\n CPU %8.3f : time to solve linear system" │ │ │ │ │ │ "\n CPU %8.3f : time to gather solution " │ │ │ │ │ │ "\n CPU %8.3f : time to permute solution into old ordering" │ │ │ │ │ │ "\n CPU %8.3f : total solve time" │ │ │ │ │ │ "\n\n solve: raw mflops %8.3f, overall mflops %8.3f", │ │ │ │ │ │ - SPOOLES 2.2 Wrapper Objects : February 8, 2025 57 │ │ │ │ │ │ + SPOOLES 2.2 Wrapper Objects : January 7, 2024 57 │ │ │ │ │ │ bridge->cpus[15], bridge->cpus[16], bridge->cpus[17], │ │ │ │ │ │ bridge->cpus[18], bridge->cpus[19], bridge->cpus[20], │ │ │ │ │ │ bridge->cpus[21], │ │ │ │ │ │ 1.e-6*nsolveops/bridge->cpus[18], │ │ │ │ │ │ 1.e-6*nsolveops/bridge->cpus[21]) ; │ │ │ │ │ │ fflush(msgFile) ; │ │ │ │ │ │ if ( myid == 0 ) { │ │ │ ├── ./usr/share/doc/spooles-doc/Lock.ps.gz │ │ │ │ ├── Lock.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Lock.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1514,21 +1514,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1712,88 +1711,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3005,16 +2999,16 @@ │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 40258437 52099151 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 133[50 59 4[44 44 46 2[56 62 93 31 2[31 62 │ │ │ │ │ 2[51 62 50 1[54 11[86 11[42 6[80 14[56 56 56 2[31 46[{}22 │ │ │ │ │ 99.6264 /CMBX12 rf /Fb 144[62 3[62 7[62 22[62 76[{}4 │ │ │ │ │ 119.552 /CMTT12 rf /Fc 141[38 2[46 51 2[42 1[28 46 42 │ │ │ │ │ 1[42 1[42 14[65 1[66 11[59 62 69 2[68 6[28 58[{}16 90.9091 │ │ │ │ │ -/CMTI10 rf /Fd 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 │ │ │ │ │ -1[45 2[45 2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf │ │ │ │ │ +/CMTI10 rf /Fd 134[48 3[51 2[36 3[51 12[45 22[47 15[25 │ │ │ │ │ +2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf │ │ │ │ │ %DVIPSBitmapFont: Fe tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3122,20 +3116,20 @@ │ │ │ │ │ Fg(mutex)p 1598 5055 V 33 w(t)47 b(*mutex)p Fh(.)227 │ │ │ │ │ 5231 y(F)-8 b(or)31 b(POSIX)f(threads)g(w)m(e)h(ha)m(v)m(e)g │ │ │ │ │ Fg(pthread)p 1714 5231 V 33 w(mutex)p 1987 5231 V 33 │ │ │ │ │ w(t)47 b(*mutex)p Fh(.)227 5407 y(F)-8 b(or)31 b(no)g(threads)f(w)m(e)g │ │ │ │ │ (ha)m(v)m(e)i Fg(void)47 b(*mutex)p Fh(.)1927 5656 y(1)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fh(2)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fg(Lock)29 b Fd(:)41 b Fc(DRAFT)30 b Fd(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 0 399 a Ff(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ -b(and)f(descriptions)g(of)g Fb(Lock)e Ff(metho)t(ds)0 │ │ │ │ │ -628 y Fa(1.2.1)112 b(Basic)38 b(metho)s(ds)0 823 y Fh(As)d(usual,)h │ │ │ │ │ -(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fh(2)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fg(Lock)29 b Fd(:)41 b Fc(DRAFT)30 b Fd(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 0 399 a Ff(1.2)135 b(Protot)l(yp)t(es)46 b(and)f │ │ │ │ │ +(descriptions)g(of)g Fb(Lock)e Ff(metho)t(ds)0 628 y │ │ │ │ │ +Fa(1.2.1)112 b(Basic)38 b(metho)s(ds)0 823 y Fh(As)d(usual,)h(there)f │ │ │ │ │ +(are)g(four)f(basic)h(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 │ │ │ │ │ b(ject)36 b(creation,)i(setting)e(default)f(\014elds,)h(clearing)0 │ │ │ │ │ 936 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h(the)g(ob)5 │ │ │ │ │ b(ject.)111 1164 y(1.)46 b Fg(Lock)h(*)g(Lock_new)f(\()h(void)g(\))g(;) │ │ │ │ │ 227 1313 y Fh(This)32 b(metho)s(d)f(simply)h(allo)s(cates)i(storage)g │ │ │ │ │ (for)e(the)g Fg(Lock)f Fh(structure)h(and)f(then)h(sets)h(the)f │ │ │ │ │ (default)g(\014elds)227 1426 y(b)m(y)f(a)f(call)i(to)f │ │ │ │ │ Fg(Lock)p 905 1426 29 4 v 33 w(setDefaultFields\(\))p │ │ │ │ │ @@ -3190,17 +3184,17 @@ │ │ │ │ │ b(metho)s(ds)111 5109 y Fh(1.)46 b Fg(void)h(Lock_lock)e(\()j(Lock)e │ │ │ │ │ (*lock)h(\))g(;)227 5258 y Fh(This)30 b(metho)s(d)g(lo)s(c)m(ks)h(the)f │ │ │ │ │ (lo)s(c)m(k.)227 5407 y Fc(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fh(If)30 b Fg(lock)g Fh(is)g Fg(NULL)p Fh(,)f(an)i(error)f(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1134 4 v 1315 100 a Fg(Lock)29 │ │ │ │ │ -b Fd(:)41 b Fc(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fh(3)111 399 y(2.)46 b Fg(void)h(Lock_unlock)e(\()i │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1153 4 v 1334 100 a Fg(Lock)29 │ │ │ │ │ +b Fd(:)41 b Fc(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fh(3)111 399 y(2.)46 b Fg(void)h(Lock_unlock)e(\()i │ │ │ │ │ (Lock)g(*lock)f(\))i(;)227 549 y Fh(This)30 b(metho)s(d)g(unlo)s(c)m │ │ │ │ │ (ks)g(the)g(lo)s(c)m(k.)227 699 y Fc(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fh(If)30 b Fg(lock)g Fh(is)g Fg(NULL)p │ │ │ │ │ Fh(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ TeXDict begin 4 3 bop 0 866 a Fi(Index)0 1289 y Fg(Lock)p │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -19,15 +19,15 @@ │ │ │ │ │ │ • int nlocks : number of locks made. │ │ │ │ │ │ • int nunlocks : number of unlocks made. │ │ │ │ │ │ • the mutual exclusion lock │ │ │ │ │ │ For Solaris threads we have mutex t *mutex. │ │ │ │ │ │ For POSIX threads we have pthread mutex t *mutex. │ │ │ │ │ │ For no threads we have void *mutex. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Lock : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Lock : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2 Prototypes and descriptions of Lock methods │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. Lock * Lock_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the Lock structure and then sets the default fields │ │ │ │ │ │ by a call to Lock setDefaultFields(). │ │ │ │ │ │ @@ -53,15 +53,15 @@ │ │ │ │ │ │ thread package, lockflag != 0 means the lock will be initialized to synchronize only threads │ │ │ │ │ │ in this process. │ │ │ │ │ │ Error checking: If lock is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.3 Utility methods │ │ │ │ │ │ 1. void Lock_lock ( Lock *lock ) ; │ │ │ │ │ │ This method locks the lock. │ │ │ │ │ │ Error checking: If lock is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - Lock : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Lock : DRAFT January 7, 2024 3 │ │ │ │ │ │ 2. void Lock_unlock ( Lock *lock ) ; │ │ │ │ │ │ This method unlocks the lock. │ │ │ │ │ │ Error checking: If lock is NULL, an error message is printed and the program exits. │ │ │ │ │ │ Index │ │ │ │ │ │ Lock clearData(), 2 │ │ │ │ │ │ Lock free(), 2 │ │ │ │ │ │ Lock init(), 2 │ │ │ ├── ./usr/share/doc/spooles-doc/MPI.ps.gz │ │ │ │ ├── MPI.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o MPI.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1205,21 +1205,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1403,88 +1402,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4901,15 +4895,15 @@ │ │ │ │ │ cleartomark │ │ │ │ │ {restore}if │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 175[88 80[{}1 83.022 /CMEX10 rf /Fb 152[42 │ │ │ │ │ 42 69[83 28[42 65 2[{}5 83.022 /CMSY10 rf /Fc 175[62 │ │ │ │ │ 2[62 3[62 73[{}3 119.552 /CMTT12 rf /Fd 134[44 3[46 2[33 │ │ │ │ │ -12[37 2[46 42 26[54 11[23 1[42 2[42 2[42 1[42 3[23 44[{}13 │ │ │ │ │ +3[46 12[42 22[43 15[23 2[42 2[42 1[42 1[42 3[23 44[{}12 │ │ │ │ │ 83.022 /CMSL10 rf /Fe 132[48 59[45 63[{}2 83.022 /CMBX10 │ │ │ │ │ rf │ │ │ │ │ %DVIPSBitmapFont: Ff tcrm1000 10 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ @@ -5059,26 +5053,25 @@ │ │ │ │ │ y Ff(\210)42 b Fl(symflag)24 b Fn(|)k(symmetry)f(\015ag)g(for)g │ │ │ │ │ Fh(A)301 5278 y Fe({)41 b Fn(0)27 b(\()p Fl(SPOOLES)p │ │ │ │ │ 804 5278 V 29 w(SYMMETRIC)p Fn(\))d({)k(symmetric)f(matrix)301 │ │ │ │ │ 5407 y Fe({)41 b Fn(1)27 b(\()p Fl(SPOOLES)p 804 5407 │ │ │ │ │ V 29 w(HERMITIAN)p Fn(\))d({)k(hermitian)f(matrix)1929 │ │ │ │ │ 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fn(2)p 125 100 1231 4 v │ │ │ │ │ -1396 w Fl(MPI)27 b Fd(:)g Fm(DRAFT)h Fd(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)h(2025)p 2669 100 V 301 390 a Fe({)41 b Fn(2)27 │ │ │ │ │ -b(\()p Fl(SPOOLES)p 804 390 27 4 v 29 w(NONSYMMETRIC)p │ │ │ │ │ -Fn(\))c({)k(nonsymmetric)g(matrix)125 559 y Ff(\210)42 │ │ │ │ │ -b Fl(opflag)25 b Fn(|)i(op)r(eration)g(\015ag)g(for)g(the)h(m)n │ │ │ │ │ -(ultiply)301 728 y Fe({)41 b Fn(0)27 b(\()p Fl(MMM)p │ │ │ │ │ -628 728 V 31 w(WITH)p 835 728 V 30 w(A)p Fn(\))g(|)h(p)r(erform)f │ │ │ │ │ -Fh(Y)42 b Fn(:=)22 b Fh(Y)37 b Fn(+)18 b Fh(\013AX)301 │ │ │ │ │ -862 y Fe({)41 b Fn(1)27 b(\()p Fl(MMM)p 628 862 V 31 │ │ │ │ │ -w(WITH)p 835 862 V 30 w(AT)p Fn(\))g(|)g(p)r(erform)g │ │ │ │ │ -Fh(Y)42 b Fn(:=)23 b Fh(Y)37 b Fn(+)18 b Fh(\013A)1915 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 125 100 1249 4 v │ │ │ │ │ +1414 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Jan)n(uary)f(7,)h(2024)p │ │ │ │ │ +2652 100 V 301 390 a Fe({)41 b Fn(2)27 b(\()p Fl(SPOOLES)p │ │ │ │ │ +804 390 27 4 v 29 w(NONSYMMETRIC)p Fn(\))c({)k(nonsymmetric)g(matrix) │ │ │ │ │ +125 559 y Ff(\210)42 b Fl(opflag)25 b Fn(|)i(op)r(eration)g(\015ag)g │ │ │ │ │ +(for)g(the)h(m)n(ultiply)301 728 y Fe({)41 b Fn(0)27 │ │ │ │ │ +b(\()p Fl(MMM)p 628 728 V 31 w(WITH)p 835 728 V 30 w(A)p │ │ │ │ │ +Fn(\))g(|)h(p)r(erform)f Fh(Y)42 b Fn(:=)22 b Fh(Y)37 │ │ │ │ │ +b Fn(+)18 b Fh(\013AX)301 862 y Fe({)41 b Fn(1)27 b(\()p │ │ │ │ │ +Fl(MMM)p 628 862 V 31 w(WITH)p 835 862 V 30 w(AT)p Fn(\))g(|)g(p)r │ │ │ │ │ +(erform)g Fh(Y)42 b Fn(:=)23 b Fh(Y)37 b Fn(+)18 b Fh(\013A)1915 │ │ │ │ │ 832 y Fg(T)1968 862 y Fh(X)301 996 y Fe({)41 b Fn(2)27 │ │ │ │ │ b(\()p Fl(MMM)p 628 996 V 31 w(WITH)p 835 996 V 30 w(AH)p │ │ │ │ │ Fn(\))g(|)g(p)r(erform)g Fh(Y)42 b Fn(:=)23 b Fh(Y)37 │ │ │ │ │ b Fn(+)18 b Fh(\013A)1915 966 y Fg(H)1979 996 y Fh(X)125 │ │ │ │ │ 1165 y Ff(\210)42 b Fl(IV)g(*XownedIV)24 b Fn(|)k(list)g(of)f(ro)n(ws)f │ │ │ │ │ (of)i Fh(X)34 b Fn(that)28 b(are)e(o)n(wned)h(b)n(y)h(this)g(pro)r │ │ │ │ │ (cessor,)d(these)j(form)f(the)h(ro)n(ws)e(of)i Fh(X)3645 │ │ │ │ │ @@ -5150,17 +5143,17 @@ │ │ │ │ │ b(based)h(on)f(the)h Fl(mapIV)d Fn(ob)5 b(ject)23 b(that)g(maps)f(ro)n │ │ │ │ │ (ws)f(to)208 5308 y(pro)r(cesses.)35 b(The)27 b(messages)f(that)h(will) │ │ │ │ │ h(b)r(e)f(sen)n(t)h(require)e Fl(nproc)f Fn(consecutiv)n(e)h(tags)h(|)g │ │ │ │ │ (the)h(\014rst)f(is)g(the)h(parameter)208 5407 y Fl(firsttag)p │ │ │ │ │ Fn(.)33 b(On)28 b(return,)f(the)h Fl(stats[])d Fn(v)n(ector)h(con)n │ │ │ │ │ (tains)g(the)i(follo)n(wing)f(information.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 83 100 1231 4 v 1397 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2630 100 V 1231 w Fn(3)556 377 y Fl(stats[0])97 b Fn(|)i(#)28 │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1249 4 v 1414 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)g Fm(DRAFT)111 b Fd(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2612 100 V 1249 w Fn(3)556 377 y Fl(stats[0])97 b Fn(|)i(#)28 │ │ │ │ │ b(of)g(messages)e(sen)n(t)344 b Fl(stats[1])96 b Fn(|)k(#)28 │ │ │ │ │ b(of)f(b)n(ytes)g(sen)n(t)556 477 y Fl(stats[2])97 b │ │ │ │ │ Fn(|)i(#)28 b(of)g(messages)e(receiv)n(ed)198 b Fl(stats[3])96 │ │ │ │ │ b Fn(|)k(#)28 b(of)f(b)n(ytes)g(receiv)n(ed)208 711 y(Note,)g(the)h(v) │ │ │ │ │ -5 b(alues)27 b(in)h Fl(stats[])c Fn(are)j Fm(incr)l(emente)l(d)p │ │ │ │ │ Fn(,)g(i.e.,)h(the)g Fl(stats[])c Fn(v)n(ector)i(is)h(not)h(zero)r(ed)e │ │ │ │ │ (at)i(the)g(start)e(of)i(the)208 810 y(metho)r(d,)g(and)f(so)g(can)g(b) │ │ │ │ │ @@ -5258,28 +5251,27 @@ │ │ │ │ │ Fn(v)n(ector)j(con)n(tains)f(the)i(follo)n(wing)f(information.)556 │ │ │ │ │ 5319 y Fl(stats[0])97 b Fn(|)i(#)28 b(of)g(messages)e(sen)n(t)344 │ │ │ │ │ b Fl(stats[1])96 b Fn(|)k(#)28 b(of)f(b)n(ytes)g(sen)n(t)556 │ │ │ │ │ 5419 y Fl(stats[2])97 b Fn(|)i(#)28 b(of)g(messages)e(receiv)n(ed)198 │ │ │ │ │ b Fl(stats[3])96 b Fn(|)k(#)28 b(of)f(b)n(ytes)g(receiv)n(ed)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fn(4)p 125 100 1231 4 v │ │ │ │ │ -1396 w Fl(MPI)27 b Fd(:)g Fm(DRAFT)h Fd(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)h(2025)p 2669 100 V 208 390 a Fn(Note,)g(the)h(v)-5 │ │ │ │ │ -b(alues)27 b(in)h Fl(stats[])c Fn(are)j Fm(incr)l(emente)l(d)p │ │ │ │ │ -Fn(,)g(i.e.,)h(the)g Fl(stats[])c Fn(v)n(ector)i(is)h(not)h(zero)r(ed)e │ │ │ │ │ -(at)i(the)g(start)e(of)i(the)208 490 y(metho)r(d,)g(and)f(so)g(can)g(b) │ │ │ │ │ -r(e)h(used)g(to)f(accum)n(ulated)g(information)g(with)h(m)n(ultiple)h │ │ │ │ │ -(calls.)208 632 y Fm(Err)l(or)38 b(che)l(cking:)55 b │ │ │ │ │ -Fn(If)37 b Fl(firsttag)j(<)j(0)36 b Fn(or)f Fl(firsttag)40 │ │ │ │ │ -b(+)j(nproc)35 b Fn(is)g(larger)g(than)h(the)g(largest)f(a)n(v)-5 │ │ │ │ │ -b(ailable)35 b(tag,)i(an)208 731 y(error)25 b(message)h(is)i(prin)n │ │ │ │ │ -(ted)f(and)h(the)g(program)d(exits.)101 916 y(5.)42 b │ │ │ │ │ -Fl(InpMtx)f(*)i(InpMtx_MPI_split)o(Fr)o(omG)o(lo)o(ba)o(l)38 │ │ │ │ │ -b(\()43 b(InpMtx)e(*Aglobal,)f(InpMtx)h(*Alocal,)1864 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 125 100 1249 4 v │ │ │ │ │ +1414 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Jan)n(uary)f(7,)h(2024)p │ │ │ │ │ +2652 100 V 208 390 a Fn(Note,)g(the)h(v)-5 b(alues)27 │ │ │ │ │ +b(in)h Fl(stats[])c Fn(are)j Fm(incr)l(emente)l(d)p Fn(,)g(i.e.,)h(the) │ │ │ │ │ +g Fl(stats[])c Fn(v)n(ector)i(is)h(not)h(zero)r(ed)e(at)i(the)g(start)e │ │ │ │ │ +(of)i(the)208 490 y(metho)r(d,)g(and)f(so)g(can)g(b)r(e)h(used)g(to)f │ │ │ │ │ +(accum)n(ulated)g(information)g(with)h(m)n(ultiple)h(calls.)208 │ │ │ │ │ +632 y Fm(Err)l(or)38 b(che)l(cking:)55 b Fn(If)37 b Fl(firsttag)j(<)j │ │ │ │ │ +(0)36 b Fn(or)f Fl(firsttag)40 b(+)j(nproc)35 b Fn(is)g(larger)g(than)h │ │ │ │ │ +(the)g(largest)f(a)n(v)-5 b(ailable)35 b(tag,)i(an)208 │ │ │ │ │ +731 y(error)25 b(message)h(is)i(prin)n(ted)f(and)h(the)g(program)d │ │ │ │ │ +(exits.)101 916 y(5.)42 b Fl(InpMtx)f(*)i(InpMtx_MPI_split)o(Fr)o(omG)o │ │ │ │ │ +(lo)o(ba)o(l)38 b(\()43 b(InpMtx)e(*Aglobal,)f(InpMtx)h(*Alocal,)1864 │ │ │ │ │ 1015 y(IV)i(*mapIV,)d(int)j(root,)e(int)h(stats[],)f(int)h(msglvl,)1864 │ │ │ │ │ 1115 y(FILE)g(*msgFile,)e(int)i(firsttag,)e(MPI_Comm)g(comm)i(\))h(;) │ │ │ │ │ 208 1257 y Fn(This)30 b(metho)r(d)h(is)f(used)g(when)h(the)f │ │ │ │ │ Fl(Aglobal)e(InpMtx)g Fn(matrix)i(ob)5 b(ject)30 b(is)g(o)n(wned)g(b)n │ │ │ │ │ (y)g(pro)r(cessor)e Fl(root)h Fn(and)h(redis-)208 1357 │ │ │ │ │ y(tributed)e(to)f(the)h(other)f(pro)r(cessors.)208 1499 │ │ │ │ │ y Fl(Aglobal)20 b Fn(is)j(p)r(ertinen)n(t)h(only)f(to)g(pro)r(cessor)e │ │ │ │ │ @@ -5357,17 +5349,17 @@ │ │ │ │ │ Fn(or)f Fl(rowmapIV)e Fn(is)j Fl(NULL)p Fn(,)f(or)h(if)h │ │ │ │ │ Fl(msglvl)41 b(>)i(0)28 b Fn(and)g Fl(msgFile)e Fn(is)i │ │ │ │ │ Fl(NULL)p Fn(,)f(or)g(if)i Fl(firsttag)40 b(<)208 5407 │ │ │ │ │ y(0)27 b Fn(is)g(larger)f(than)i(the)g(largest)e(a)n(v)-5 │ │ │ │ │ b(ailable)26 b(tag,)h(an)h(error)d(message)h(is)i(prin)n(ted)f(and)h │ │ │ │ │ (the)g(program)d(exits.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 83 100 1231 4 v 1397 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2630 100 V 1231 w Fn(5)0 390 y Fj(1.2.2)112 b(Gather)38 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1249 4 v 1414 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)g Fm(DRAFT)111 b Fd(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2612 100 V 1249 w Fn(5)0 390 y Fj(1.2.2)112 b(Gather)38 │ │ │ │ │ b(and)h(scatter)e(metho)s(ds)0 568 y Fn(These)24 b(metho)r(d)g(gather)f │ │ │ │ │ (and)h(scatter/add)e(ro)n(ws)h(of)h Fl(DenseMtx)c Fn(ob)5 │ │ │ │ │ b(jects.)35 b(These)24 b(op)r(erations)f(are)g(p)r(erformed)g(during)h │ │ │ │ │ (the)0 668 y(distributed)19 b(matrix-matrix)e(m)n(ultiply)-7 │ │ │ │ │ b(.)34 b(The)18 b(gather)g(op)r(eration)f Fh(X)2150 638 │ │ │ │ │ y Fg(q)2143 688 y(supp)2309 668 y Fb( )23 b Fh(X)i Fn(is)18 │ │ │ │ │ b(p)r(erformed)g(b)n(y)g Fl(DenseMtx)p 3434 668 27 4 │ │ │ │ │ @@ -5449,25 +5441,24 @@ │ │ │ │ │ 5108 y(FILE)g(*msgFile,)e(int)i(firsttag,)e(MPI_Comm)g(comm)i(\))h(;) │ │ │ │ │ 208 5208 y(IVL)f(*)h(SymbFac_MPI_init)o(Fro)o(mP)o(enc)o(il)37 │ │ │ │ │ b(\()43 b(ETree)f(*etree,)e(IV)j(*frontOwnersIV,)1733 │ │ │ │ │ 5308 y(Pencil)e(*pencil,)f(int)j(stats[],)d(int)i(msglvl,)1733 │ │ │ │ │ 5407 y(FILE)g(*msgFile,)e(int)i(firsttag,)e(MPI_Comm)g(comm)i(\))h(;)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fn(6)p 125 100 1231 4 v │ │ │ │ │ -1396 w Fl(MPI)27 b Fd(:)g Fm(DRAFT)h Fd(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)h(2025)p 2669 100 V 208 390 a Fn(These)19 b(metho)r(ds)h(are)e │ │ │ │ │ -(used)i(in)g(place)f(of)h(the)g Fl(Symbfac)p 1907 390 │ │ │ │ │ -27 4 v 28 w(initFrom)p Fb(f)p Fl(InpMtx,P)o(en)o(cil)o │ │ │ │ │ -Fb(g)p Fl(\()o(\))14 b Fn(metho)r(ds)19 b(to)h(compute)g(the)208 │ │ │ │ │ -490 y(sym)n(b)r(olic)27 b(factorization.)37 b(The)28 │ │ │ │ │ -b Fl(ETree)e Fn(ob)5 b(ject)28 b(is)g(assumed)f(to)h(b)r(e)h │ │ │ │ │ -(replicated)e(o)n(v)n(er)f(the)j(pro)r(cesses.)36 b(The)28 │ │ │ │ │ -b Fl(InpMtx)208 589 y Fn(and)i Fl(Pencil)e Fn(ob)5 b(jects)30 │ │ │ │ │ -b(are)f(partitioned)h(among)f(the)i(pro)r(cesses.)44 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 125 100 1249 4 v │ │ │ │ │ +1414 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Jan)n(uary)f(7,)h(2024)p │ │ │ │ │ +2652 100 V 208 390 a Fn(These)19 b(metho)r(ds)h(are)e(used)i(in)g │ │ │ │ │ +(place)f(of)h(the)g Fl(Symbfac)p 1907 390 27 4 v 28 w(initFrom)p │ │ │ │ │ +Fb(f)p Fl(InpMtx,P)o(en)o(cil)o Fb(g)p Fl(\()o(\))14 │ │ │ │ │ +b Fn(metho)r(ds)19 b(to)h(compute)g(the)208 490 y(sym)n(b)r(olic)27 │ │ │ │ │ +b(factorization.)37 b(The)28 b Fl(ETree)e Fn(ob)5 b(ject)28 │ │ │ │ │ +b(is)g(assumed)f(to)h(b)r(e)h(replicated)e(o)n(v)n(er)f(the)j(pro)r │ │ │ │ │ +(cesses.)36 b(The)28 b Fl(InpMtx)208 589 y Fn(and)i Fl(Pencil)e │ │ │ │ │ +Fn(ob)5 b(jects)30 b(are)f(partitioned)h(among)f(the)i(pro)r(cesses.)44 │ │ │ │ │ b(Therefore,)30 b(to)g(compute)h(the)f Fl(IVL)g Fn(ob)5 │ │ │ │ │ b(ject)30 b(that)208 689 y(con)n(tains)g(the)h(sym)n(b)r(olic)g │ │ │ │ │ (factorization)f(is)h(a)g(distributed,)h(co)r(op)r(erativ)n(e)e(pro)r │ │ │ │ │ (cess.)46 b(A)n(t)32 b(the)f(end)h(of)f(the)h(sym)n(b)r(olic)208 │ │ │ │ │ 789 y(factorization,)c(eac)n(h)h(pro)r(cess)g(will)h(o)n(wn)f(a)g(p)r │ │ │ │ │ (ortion)g(of)h(the)g Fl(IVL)f Fn(ob)5 b(ject.)43 b(The)29 │ │ │ │ │ b Fl(IVL)g Fn(ob)5 b(ject)29 b(is)h(neither)g(replicated)208 │ │ │ │ │ @@ -5548,17 +5539,17 @@ │ │ │ │ │ 2075 5070 y Fl(cpus[9])118 b Fn({)99 b(p)r(ost)28 b(initial)g(receiv)n │ │ │ │ │ (es)2053 5170 y Fl(cpus[10])96 b Fn({)j(c)n(hec)n(k)27 │ │ │ │ │ b(for)g(receiv)n(ed)f(messages)2053 5269 y Fl(cpus[11])96 │ │ │ │ │ b Fn({)j(p)r(ost)28 b(initial)g(sends)2053 5369 y Fl(cpus[12])96 │ │ │ │ │ b Fn({)j(c)n(hec)n(k)27 b(for)g(sen)n(t)g(messages)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 83 100 1231 4 v 1397 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2630 100 V 1231 w Fn(7)208 390 y(On)g(return,)g(the)h │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1249 4 v 1414 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)g Fm(DRAFT)111 b Fd(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2612 100 V 1249 w Fn(7)208 390 y(On)g(return,)g(the)h │ │ │ │ │ Fl(stats[])d Fn(v)n(ector)h(has)h(the)h(follo)n(wing)f(information.)963 │ │ │ │ │ 563 y Fl(stats[0])118 b Fn(|)100 b(#)28 b(of)f(piv)n(ots)963 │ │ │ │ │ 663 y Fl(stats[1])118 b Fn(|)100 b(#)28 b(of)f(piv)n(ot)h(tests)963 │ │ │ │ │ 762 y Fl(stats[2])118 b Fn(|)100 b(#)28 b(of)f(dela)n(y)n(ed)g(ro)n(ws) │ │ │ │ │ f(and)i(columns)963 862 y Fl(stats[3])118 b Fn(|)100 │ │ │ │ │ b(#)28 b(of)f(en)n(tries)g(in)h(D)963 962 y Fl(stats[4])118 │ │ │ │ │ b Fn(|)100 b(#)28 b(of)f(en)n(tries)g(in)h(L)963 1061 │ │ │ │ │ @@ -5640,45 +5631,45 @@ │ │ │ │ │ 5308 y Fn(After)19 b(a)g(factorization)f(with)i(piv)n(oting,)g(the)f │ │ │ │ │ Fl(frontsizesIV)c Fn(ob)5 b(ject)19 b(needs)g(to)g(b)r(e)h(made)f │ │ │ │ │ (global)f(on)h(eac)n(h)f(pro)r(cessor.)208 5407 y(This)26 │ │ │ │ │ b(metho)r(ds)h(tak)n(es)e(the)i(individual)f(en)n(tries)g(of)g(an)g │ │ │ │ │ Fl(IV)g Fn(ob)5 b(ject)26 b(whose)g(o)n(wners)f(are)g(sp)r(eci\014ed)h │ │ │ │ │ (b)n(y)h(the)f Fl(ownersIV)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fn(8)p 125 100 1231 4 v │ │ │ │ │ -1396 w Fl(MPI)27 b Fd(:)g Fm(DRAFT)h Fd(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)h(2025)p 2669 100 V 208 390 a Fn(ob)5 b(ject,)33 │ │ │ │ │ -b(and)g(comm)n(unicates)f(the)h(en)n(tries)f(around)g(the)h(pro)r │ │ │ │ │ -(cessors)e(un)n(til)i(the)g(global)f Fl(IV)g Fn(ob)5 │ │ │ │ │ -b(ject)33 b(is)f(presen)n(t)g(on)208 490 y(eac)n(h.)h(The)20 │ │ │ │ │ -b(messages)e(that)i(will)g(b)r(e)g(sen)n(t)f(require)g(at)g(most)h │ │ │ │ │ -Fl(nproc)d Fn(consecutiv)n(e)i(tags)g(|)h(the)g(\014rst)f(is)h(the)g │ │ │ │ │ -(parameter)208 589 y Fl(firsttag)p Fn(.)208 740 y Fm(Err)l(or)28 │ │ │ │ │ -b(che)l(cking:)38 b Fn(If)26 b Fl(iv)p Fn(,)g Fl(ownersIV)d │ │ │ │ │ -Fn(or)i Fl(stats)f Fn(is)h Fl(NULL)p Fn(,)g(or)g(if)h │ │ │ │ │ -Fl(firsttag)41 b(<)i(0)25 b Fn(or)g Fl(firsttag)41 b(+)i(nproc)p │ │ │ │ │ -Fn(,)24 b(is)i(larger)208 840 y(than)h(the)g(largest)f(a)n(v)-5 │ │ │ │ │ -b(ailable)26 b(tag,)h(or)f(if)h Fl(msglvl)42 b(>)h(0)27 │ │ │ │ │ -b Fn(and)g Fl(msgFile)d Fn(is)j Fl(NULL)p Fn(,)e(an)i(error)e(message)h │ │ │ │ │ -(is)h(prin)n(ted)g(and)208 939 y(the)h(program)d(exits.)101 │ │ │ │ │ -1141 y(4.)42 b Fl(void)f(IVL_MPI_allgather)c(\()43 b(IVL)g(*ivl,)e(IV)i │ │ │ │ │ -(*ownersIV,)c(int)k(stats[],)d(int)i(msglvl,)1297 1241 │ │ │ │ │ -y(FILE)g(*msgFile,)e(int)i(firsttag,)e(MPI_Comm)g(comm)i(\))i(;)208 │ │ │ │ │ -1391 y Fn(When)d(the)g Fl(FrontMtx)d Fn(ob)5 b(ject)41 │ │ │ │ │ -b(is)g(split)g(in)n(to)g(submatrices,)i(eac)n(h)e(pro)r(cessor)d(accum) │ │ │ │ │ -n(ulates)i(the)i(structure)e(of)208 1491 y(the)34 b(blo)r(c)n(k)f │ │ │ │ │ -(matrix)g(for)g(the)h(fron)n(ts)f(its)g(o)n(wns.)55 b(This)33 │ │ │ │ │ -b(structure)g(m)n(ust)h(b)r(e)g(global)e(to)i(all)f(pro)r(cessors)e(b)r │ │ │ │ │ -(efore)j(the)208 1591 y(submatrix)28 b(map)h(can)f(b)r(e)h(computed.)41 │ │ │ │ │ -b(This)29 b(metho)r(d)g(tak)n(es)f(a)h Fm(p)l(artitione)l(d)h │ │ │ │ │ -Fl(IVL)d Fn(ob)5 b(ject)29 b(and)g(comm)n(unicates)f(the)208 │ │ │ │ │ -1690 y(en)n(tries)33 b(among)h(the)g(pro)r(cessors)e(un)n(til)j(the)g │ │ │ │ │ -(global)e Fl(IVL)g Fn(ob)5 b(ject)34 b(is)h(presen)n(t)f(on)g(eac)n(h.) │ │ │ │ │ -56 b(Whic)n(h)35 b(pro)r(cessor)d(o)n(wns)208 1790 y(what)e(lists)g(of) │ │ │ │ │ -g(the)g Fl(IVL)f Fn(ob)5 b(ject)30 b(is)g(giv)n(en)f(b)n(y)h(the)h │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fn(8)p 125 100 1249 4 v │ │ │ │ │ +1414 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Jan)n(uary)f(7,)h(2024)p │ │ │ │ │ +2652 100 V 208 390 a Fn(ob)5 b(ject,)33 b(and)g(comm)n(unicates)f(the)h │ │ │ │ │ +(en)n(tries)f(around)g(the)h(pro)r(cessors)e(un)n(til)i(the)g(global)f │ │ │ │ │ +Fl(IV)g Fn(ob)5 b(ject)33 b(is)f(presen)n(t)g(on)208 │ │ │ │ │ +490 y(eac)n(h.)h(The)20 b(messages)e(that)i(will)g(b)r(e)g(sen)n(t)f │ │ │ │ │ +(require)g(at)g(most)h Fl(nproc)d Fn(consecutiv)n(e)i(tags)g(|)h(the)g │ │ │ │ │ +(\014rst)f(is)h(the)g(parameter)208 589 y Fl(firsttag)p │ │ │ │ │ +Fn(.)208 740 y Fm(Err)l(or)28 b(che)l(cking:)38 b Fn(If)26 │ │ │ │ │ +b Fl(iv)p Fn(,)g Fl(ownersIV)d Fn(or)i Fl(stats)f Fn(is)h │ │ │ │ │ +Fl(NULL)p Fn(,)g(or)g(if)h Fl(firsttag)41 b(<)i(0)25 │ │ │ │ │ +b Fn(or)g Fl(firsttag)41 b(+)i(nproc)p Fn(,)24 b(is)i(larger)208 │ │ │ │ │ +840 y(than)h(the)g(largest)f(a)n(v)-5 b(ailable)26 b(tag,)h(or)f(if)h │ │ │ │ │ +Fl(msglvl)42 b(>)h(0)27 b Fn(and)g Fl(msgFile)d Fn(is)j │ │ │ │ │ +Fl(NULL)p Fn(,)e(an)i(error)e(message)h(is)h(prin)n(ted)g(and)208 │ │ │ │ │ +939 y(the)h(program)d(exits.)101 1141 y(4.)42 b Fl(void)f │ │ │ │ │ +(IVL_MPI_allgather)c(\()43 b(IVL)g(*ivl,)e(IV)i(*ownersIV,)c(int)k │ │ │ │ │ +(stats[],)d(int)i(msglvl,)1297 1241 y(FILE)g(*msgFile,)e(int)i │ │ │ │ │ +(firsttag,)e(MPI_Comm)g(comm)i(\))i(;)208 1391 y Fn(When)d(the)g │ │ │ │ │ +Fl(FrontMtx)d Fn(ob)5 b(ject)41 b(is)g(split)g(in)n(to)g(submatrices,)i │ │ │ │ │ +(eac)n(h)e(pro)r(cessor)d(accum)n(ulates)i(the)i(structure)e(of)208 │ │ │ │ │ +1491 y(the)34 b(blo)r(c)n(k)f(matrix)g(for)g(the)h(fron)n(ts)f(its)g(o) │ │ │ │ │ +n(wns.)55 b(This)33 b(structure)g(m)n(ust)h(b)r(e)g(global)e(to)i(all)f │ │ │ │ │ +(pro)r(cessors)e(b)r(efore)j(the)208 1591 y(submatrix)28 │ │ │ │ │ +b(map)h(can)f(b)r(e)h(computed.)41 b(This)29 b(metho)r(d)g(tak)n(es)f │ │ │ │ │ +(a)h Fm(p)l(artitione)l(d)h Fl(IVL)d Fn(ob)5 b(ject)29 │ │ │ │ │ +b(and)g(comm)n(unicates)f(the)208 1690 y(en)n(tries)33 │ │ │ │ │ +b(among)h(the)g(pro)r(cessors)e(un)n(til)j(the)g(global)e │ │ │ │ │ +Fl(IVL)g Fn(ob)5 b(ject)34 b(is)h(presen)n(t)f(on)g(eac)n(h.)56 │ │ │ │ │ +b(Whic)n(h)35 b(pro)r(cessor)d(o)n(wns)208 1790 y(what)e(lists)g(of)g │ │ │ │ │ +(the)g Fl(IVL)f Fn(ob)5 b(ject)30 b(is)g(giv)n(en)f(b)n(y)h(the)h │ │ │ │ │ Fl(ownersIV)26 b Fn(ob)5 b(ject.)45 b(The)30 b(messages)e(that)i(will)h │ │ │ │ │ (b)r(e)f(sen)n(t)g(require)208 1890 y(at)d(most)g Fl(nproc)f │ │ │ │ │ Fn(consecutiv)n(e)h(tags)f(|)i(the)g(\014rst)f(is)h(the)g(parameter)e │ │ │ │ │ Fl(firsttag)p Fn(.)208 2040 y Fm(Err)l(or)f(che)l(cking:)37 │ │ │ │ │ b Fn(If)23 b Fl(ivl)p Fn(,)g Fl(ownersIV)c Fn(or)j Fl(stats)f │ │ │ │ │ Fn(is)i Fl(NULL)p Fn(,)e(or)h(if)h Fl(firsttag)40 b(<)k(0)22 │ │ │ │ │ b Fn(or)g Fl(firsttag)40 b(+)j(nproc)p Fn(,)22 b(is)h(larger)208 │ │ │ │ │ @@ -5726,17 +5717,17 @@ │ │ │ │ │ Fl(firsttag)208 5308 y(<)43 b(0)30 b Fn(or)f Fl(firsttag)40 │ │ │ │ │ b(+)j(2*nfront)27 b Fn(is)j(larger)f(than)h(the)h(largest)d(a)n(v)-5 │ │ │ │ │ b(ailable)29 b(tag,)i(or)e(if)i Fl(msglvl)41 b(>)i(0)30 │ │ │ │ │ b Fn(and)g Fl(msgFile)208 5407 y Fn(is)d Fl(NULL)p Fn(,)f(an)h(error)f │ │ │ │ │ (message)g(is)i(prin)n(ted)f(and)h(the)g(program)d(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 83 100 1231 4 v 1397 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2630 100 V 1231 w Fn(9)0 390 y Fj(1.2.7)112 b(Matrix-matrix)39 │ │ │ │ │ +TeXDict begin 9 8 bop 83 100 1249 4 v 1414 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)g Fm(DRAFT)111 b Fd(Jan)n(uary)25 b(7,)i(2024)p │ │ │ │ │ +2612 100 V 1249 w Fn(9)0 390 y Fj(1.2.7)112 b(Matrix-matrix)39 │ │ │ │ │ b(m)m(ultiply)f(metho)s(ds)0 573 y Fn(The)28 b(usual)f(sequence)g(of)h │ │ │ │ │ (ev)n(en)n(ts)e(is)i(as)f(follo)n(ws.)125 771 y Ff(\210)42 │ │ │ │ │ b Fn(Set)28 b(up)f(the)h(data)g(structure)f(via)g(a)g(call)g(to)h │ │ │ │ │ Fl(MatMul)p 1887 771 27 4 v 28 w(MPI)p 2047 771 V 31 │ │ │ │ │ w(setup\(\))p Fn(.)125 946 y Ff(\210)42 b Fn(Con)n(v)n(ert)26 │ │ │ │ │ b(the)i(lo)r(cal)f Fh(A)925 916 y Fg(q)989 946 y Fn(matrix)g(to)h(lo)r │ │ │ │ │ (cal)f(indices)g(via)h(a)f(call)g(to)g Fl(MatMul)p 2557 │ │ │ │ │ @@ -5811,29 +5802,28 @@ │ │ │ │ │ (in)g(the)h Fl(info)e Fn(ob)5 b(ject.)50 b(These)32 b(are)f(serial)208 │ │ │ │ │ 5270 y(metho)r(ds,)c(p)r(erformed)h(indep)r(enden)n(tly)g(on)f(eac)n(h) │ │ │ │ │ g(pro)r(cessor.)208 5407 y Fm(Err)l(or)j(che)l(cking:)38 │ │ │ │ │ b Fn(If)28 b Fl(info)e Fn(or)h Fl(A)g Fn(is)h Fl(NULL)p │ │ │ │ │ Fn(,)e(an)h(error)f(message)g(is)i(prin)n(ted)f(and)h(the)g(program)d │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fn(10)p 166 100 1210 4 │ │ │ │ │ -v 1375 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2690 100 V 101 390 a Fn(3.)42 b Fl(void)f(MatMul_MPI_mmm) │ │ │ │ │ -d(\()43 b(MatMulInfo)d(*info,)h(DenseMtx)f(*Yloc,)h(double)g(alpha[],)g │ │ │ │ │ -(InpMtx)g(*A,)600 490 y(DenseMtx)f(*Xloc,)h(int)i(stats[],)d(int)i │ │ │ │ │ -(msglvl,)f(FILE)h(*msgFile,)e(MPI_Comm)g(comm\))h(;)208 │ │ │ │ │ -623 y Fn(This)35 b(metho)r(d)g(computes)g(a)g(distributed)h │ │ │ │ │ -(matrix-matrix)e(m)n(ultiply)h Fh(Y)55 b Fn(:=)35 b Fh(Y)42 │ │ │ │ │ -b Fn(+)23 b Fh(\013AX)7 b Fn(,)37 b Fh(Y)55 b Fn(:=)35 │ │ │ │ │ -b Fh(Y)42 b Fn(+)23 b Fh(\013A)3662 593 y Fg(T)3715 623 │ │ │ │ │ -y Fh(X)42 b Fn(or)208 723 y Fh(Y)k Fn(:=)28 b Fh(Y)39 │ │ │ │ │ -b Fn(+)21 b Fh(\013A)706 692 y Fg(H)769 723 y Fh(X)7 │ │ │ │ │ -b Fn(,)31 b(dep)r(ending)g(on)g(ho)n(w)f(the)h Fl(info)e │ │ │ │ │ -Fn(ob)5 b(ject)30 b(w)n(as)g(set)h(up.)46 b(NOTE:)30 │ │ │ │ │ -b Fl(A)h Fn(m)n(ust)f(ha)n(v)n(e)g(lo)r(cal)g(indices,)208 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fn(10)p 166 100 1228 4 │ │ │ │ │ +v 1392 w Fl(MPI)27 b Fd(:)h Fm(DRAFT)f Fd(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2673 100 V 101 390 a Fn(3.)42 b Fl(void)f(MatMul_MPI_mmm)d(\()43 │ │ │ │ │ +b(MatMulInfo)d(*info,)h(DenseMtx)f(*Yloc,)h(double)g(alpha[],)g(InpMtx) │ │ │ │ │ +g(*A,)600 490 y(DenseMtx)f(*Xloc,)h(int)i(stats[],)d(int)i(msglvl,)f │ │ │ │ │ +(FILE)h(*msgFile,)e(MPI_Comm)g(comm\))h(;)208 623 y Fn(This)35 │ │ │ │ │ +b(metho)r(d)g(computes)g(a)g(distributed)h(matrix-matrix)e(m)n(ultiply) │ │ │ │ │ +h Fh(Y)55 b Fn(:=)35 b Fh(Y)42 b Fn(+)23 b Fh(\013AX)7 │ │ │ │ │ +b Fn(,)37 b Fh(Y)55 b Fn(:=)35 b Fh(Y)42 b Fn(+)23 b │ │ │ │ │ +Fh(\013A)3662 593 y Fg(T)3715 623 y Fh(X)42 b Fn(or)208 │ │ │ │ │ +723 y Fh(Y)k Fn(:=)28 b Fh(Y)39 b Fn(+)21 b Fh(\013A)706 │ │ │ │ │ +692 y Fg(H)769 723 y Fh(X)7 b Fn(,)31 b(dep)r(ending)g(on)g(ho)n(w)f │ │ │ │ │ +(the)h Fl(info)e Fn(ob)5 b(ject)30 b(w)n(as)g(set)h(up.)46 │ │ │ │ │ +b(NOTE:)30 b Fl(A)h Fn(m)n(ust)f(ha)n(v)n(e)g(lo)r(cal)g(indices,)208 │ │ │ │ │ 822 y(use)i Fl(MatMul)p 625 822 27 4 v 29 w(setLocalIndices\()o(\))27 │ │ │ │ │ b Fn(to)32 b(con)n(v)n(ert)f(from)i(global)e(to)i(lo)r(cal)f(indices.) │ │ │ │ │ 52 b Fl(Xloc)31 b Fn(and)i Fl(Yloc)e Fn(con)n(tain)h(the)208 │ │ │ │ │ 922 y(o)n(wned)27 b(ro)n(ws)f(of)h Fh(X)34 b Fn(and)28 │ │ │ │ │ b Fh(Y)18 b Fn(,)28 b(resp)r(ectiv)n(ely)-7 b(.)208 1055 │ │ │ │ │ y(On)27 b(return,)g(the)h(follo)n(wing)f(statistics)g(will)h(ha)n(v)n │ │ │ │ │ (e)e(b)r(een)i(added.)556 1249 y Fl(stats[0])97 b Fn(|)i(#)28 │ │ │ │ │ @@ -5902,17 +5892,17 @@ │ │ │ │ │ (p)r(oin)n(ter)f(to)h(its)g Fl(IV)f Fn(ob)5 b(ject.)37 │ │ │ │ │ b(A)28 b(no)r(de)g(other)f(than)h Fl(root)p Fn(,)f(clears)f(the)j(data) │ │ │ │ │ e(in)h(its)208 5274 y(IV)f(ob)5 b(ject,)28 b(receiv)n(es)e(the)i(IV)g │ │ │ │ │ (ob)5 b(ject)27 b(from)h(the)g(ro)r(ot)e(and)i(returns)f(a)g(p)r(oin)n │ │ │ │ │ (ter)g(to)h(it.)208 5407 y Fm(Err)l(or)i(che)l(cking:)38 │ │ │ │ │ b Fn(None)28 b(presen)n(tly)-7 b(.)p eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 83 100 1210 4 v 1376 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2609 100 V 1210 w Fn(11)0 390 y Fj(1.2.9)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 11 10 bop 83 100 1228 4 v 1393 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)h Fm(DRAFT)110 b Fd(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2592 100 V 1228 w Fn(11)0 390 y Fj(1.2.9)112 b(Utilit)m(y)38 │ │ │ │ │ b(metho)s(ds)101 565 y Fn(1.)k Fl(IVL)g(*)h(InpMtx_MPI_fullA)o(dja)o │ │ │ │ │ (ce)o(ncy)37 b(\()43 b(InpMtx)e(*inpmtx,)f(int)j(stats[],)1646 │ │ │ │ │ 664 y(int)f(msglvl,)f(FILE)h(*msgFile,)e(MPI_Comm)g(comm)i(\))h(;)208 │ │ │ │ │ 764 y(IVL)f(*)h(Pencil_MPI_fullA)o(dja)o(ce)o(ncy)37 │ │ │ │ │ b(\()43 b(Pencil)e(*pencil,)f(int)j(stats[],)1646 863 │ │ │ │ │ y(int)f(msglvl,)f(FILE)h(*msgFile,)e(MPI_Comm)g(comm)i(\))h(;)208 │ │ │ │ │ 993 y Fn(These)37 b(metho)r(ds)h(are)f(used)h(to)g(return)g(an)f │ │ │ │ │ @@ -5996,25 +5986,24 @@ │ │ │ │ │ y Fn(con)n(tains)c(the)i(lists)g(of)f(v)n(ertices)g(this)h(pro)r │ │ │ │ │ (cessor)d(m)n(ust)j(send)f(to)h(all)f(others.)208 5308 │ │ │ │ │ y(This)g(metho)r(d)i(uses)e(tags)g(in)i(the)f(range)e │ │ │ │ │ Fl([tag,tag+nproc-1\))o Fn(.)32 b(On)c(return,)f(the)i(follo)n(wing)e │ │ │ │ │ (statistics)g(will)h(ha)n(v)n(e)208 5407 y(b)r(een)g(added.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fn(12)p 166 100 1210 │ │ │ │ │ -4 v 1375 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2690 100 V 556 377 a Fl(stats[0])97 b Fn(|)i(#)28 │ │ │ │ │ -b(of)g(messages)e(sen)n(t)344 b Fl(stats[1])96 b Fn(|)k(#)28 │ │ │ │ │ -b(of)f(b)n(ytes)g(sen)n(t)556 477 y Fl(stats[2])97 b │ │ │ │ │ -Fn(|)i(#)28 b(of)g(messages)e(receiv)n(ed)198 b Fl(stats[3])96 │ │ │ │ │ -b Fn(|)k(#)28 b(of)f(b)n(ytes)g(receiv)n(ed)208 688 y(This)g(metho)r(d) │ │ │ │ │ -h(is)g Fm(safe)g Fn(in)g(the)g(sense)f(that)h(it)g(uses)f(only)h │ │ │ │ │ -Fl(MPI)p 2162 688 27 4 v 30 w(Sendrecv\(\))p Fn(.)208 │ │ │ │ │ -829 y Fm(Err)l(or)35 b(che)l(cking:)50 b Fn(If)34 b Fl(sendIVL)c │ │ │ │ │ -Fn(or)i Fl(stats)f Fn(is)j Fl(NULL)p Fn(,)d(or)i(if)g │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fn(12)p 166 100 1228 │ │ │ │ │ +4 v 1392 w Fl(MPI)27 b Fd(:)h Fm(DRAFT)f Fd(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2673 100 V 556 377 a Fl(stats[0])97 b Fn(|)i(#)28 b(of)g(messages)e │ │ │ │ │ +(sen)n(t)344 b Fl(stats[1])96 b Fn(|)k(#)28 b(of)f(b)n(ytes)g(sen)n(t) │ │ │ │ │ +556 477 y Fl(stats[2])97 b Fn(|)i(#)28 b(of)g(messages)e(receiv)n(ed) │ │ │ │ │ +198 b Fl(stats[3])96 b Fn(|)k(#)28 b(of)f(b)n(ytes)g(receiv)n(ed)208 │ │ │ │ │ +688 y(This)g(metho)r(d)h(is)g Fm(safe)g Fn(in)g(the)g(sense)f(that)h │ │ │ │ │ +(it)g(uses)f(only)h Fl(MPI)p 2162 688 27 4 v 30 w(Sendrecv\(\))p │ │ │ │ │ +Fn(.)208 829 y Fm(Err)l(or)35 b(che)l(cking:)50 b Fn(If)34 │ │ │ │ │ +b Fl(sendIVL)c Fn(or)i Fl(stats)f Fn(is)j Fl(NULL)p Fn(,)d(or)i(if)g │ │ │ │ │ Fl(msglvl)41 b(>)j(0)33 b Fn(and)g Fl(msgFile)d Fn(is)j │ │ │ │ │ Fl(NULL)p Fn(,)f(or)g(if)i Fl(tag)42 b(<)h(0)208 928 │ │ │ │ │ y Fn(or)28 b Fl(tag)43 b(+)g(nproc)27 b Fn(is)j(larger)e(than)h(the)h │ │ │ │ │ (largest)f(a)n(v)-5 b(ailable)28 b(tag,)h(an)h(error)d(message)i(is)g │ │ │ │ │ (prin)n(ted)h(and)f(the)h(program)208 1028 y(exits.)101 │ │ │ │ │ 1210 y(5.)42 b Fl(void)f(*)j(makeSendRecvIVL)o(s)38 b(\()43 │ │ │ │ │ b(IV)g(*supportedIV,)38 b(IV)43 b(*globalmapIV,)38 b(IVL)k(*sendIVL,)e │ │ │ │ │ @@ -6076,17 +6065,17 @@ │ │ │ │ │ 208 4893 y(en)n(tries)j(from)g(\014le)i Fl(matrix.)m │ │ │ │ │ Fh(q)s Fl(.input)c Fn(and)j(righ)n(t)f(hand)h(side)g(en)n(tries)f(from) │ │ │ │ │ h(\014le)g Fl(rhs.)o Fh(q)s Fl(.input)m Fn(.)47 b(The)31 │ │ │ │ │ b(format)g(for)208 4993 y(the)d(matrix)f(\014les)g(is)h(as)f(follo)n │ │ │ │ │ (ws:)208 5208 y Fl(neqns)41 b(neqns)h(nent)208 5308 y(irow)f(jcol)h │ │ │ │ │ (entry)208 5407 y(...)85 b(...)h(...)p eop end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 83 100 1210 4 v 1376 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2609 100 V 1210 w Fn(13)208 390 y(where)j Fl(neqns)g │ │ │ │ │ +TeXDict begin 13 12 bop 83 100 1228 4 v 1393 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)h Fm(DRAFT)110 b Fd(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2592 100 V 1228 w Fn(13)208 390 y(where)i Fl(neqns)g │ │ │ │ │ Fn(is)h(the)h(global)e(n)n(um)n(b)r(er)i(of)f(equations)g(and)g │ │ │ │ │ Fl(nent)f Fn(is)h(the)h(n)n(um)n(b)r(er)f(of)h(en)n(tries)e(in)i(this)g │ │ │ │ │ (\014le.)49 b(There)208 490 y(follo)n(ws)22 b Fl(nent)h │ │ │ │ │ Fn(lines,)h(eac)n(h)f(con)n(taining)g(a)g(ro)n(w)g(index,)i(a)e(column) │ │ │ │ │ h(index)g(and)f(one)h(or)f(t)n(w)n(o)g(\015oating)g(p)r(oin)n(t)h(n)n │ │ │ │ │ (um)n(b)r(ers,)208 589 y(one)j(if)h(real,)f(t)n(w)n(o)f(if)j(complex.) │ │ │ │ │ 36 b(The)28 b(format)f(for)g(the)h(righ)n(t)f(hand)g(side)h(\014le)f │ │ │ │ │ @@ -6161,27 +6150,27 @@ │ │ │ │ │ y Fl(nrow)i Fn(lines,)i(eac)n(h)f(con)n(taining)g(a)h(ro)n(w)f(index)h │ │ │ │ │ (and)g(either)g Fl(nrhs)e Fn(or)i Fl(2*nrhs)d Fn(\015oating)i(p)r(oin)n │ │ │ │ │ (t)i(n)n(um)n(b)r(ers,)e(the)i(\014rst)f(if)208 5407 │ │ │ │ │ y(real,)e(the)i(second)f(if)h(complex.)37 b(Use)27 b(the)h(script)g │ │ │ │ │ (\014le)f Fl(do)p 1997 5407 27 4 v 31 w(patchAndGo)d │ │ │ │ │ Fn(for)j(testing.)p eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ -TeXDict begin 14 13 bop 0 100 a Fn(14)p 166 100 1210 │ │ │ │ │ -4 v 1375 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2690 100 V 307 390 a Ff(\210)42 b Fn(The)23 │ │ │ │ │ -b Fl(msglvl)e Fn(parameter)g(determines)i(the)h(amoun)n(t)e(of)h │ │ │ │ │ -(output.)36 b(Use)23 b Fl(msglvl)41 b(=)i(1)23 b Fn(for)g(just)g │ │ │ │ │ -(timing)g(output.)307 528 y Ff(\210)42 b Fn(The)32 b │ │ │ │ │ -Fl(msgFile)c Fn(parameter)i(determines)h(the)h(message)e(\014le)i(|)f │ │ │ │ │ -(if)h Fl(msgFile)d Fn(is)i Fl(stdout)p Fn(,)f(then)i(the)g(message)390 │ │ │ │ │ -628 y(\014le)c(is)f Fm(stdout)p Fn(,)h(otherwise)e(a)i(\014le)f(is)h │ │ │ │ │ -(op)r(ened)f(with)i Fm(app)l(end)g Fn(status)e(to)g(receiv)n(e)g(an)n │ │ │ │ │ -(y)g(output)h(data.)307 766 y Ff(\210)42 b Fn(The)28 │ │ │ │ │ -b Fl(type)e Fn(parameter)g(sp)r(eci\014es)h(a)h(real)e(or)h(complex)g │ │ │ │ │ -(linear)g(system.)456 904 y Fe({)41 b Fl(type)h(=)i(1)f(\(SPOOLES)p │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fn(14)p 166 100 1228 │ │ │ │ │ +4 v 1392 w Fl(MPI)27 b Fd(:)h Fm(DRAFT)f Fd(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2673 100 V 307 390 a Ff(\210)42 b Fn(The)23 b Fl(msglvl)e │ │ │ │ │ +Fn(parameter)g(determines)i(the)h(amoun)n(t)e(of)h(output.)36 │ │ │ │ │ +b(Use)23 b Fl(msglvl)41 b(=)i(1)23 b Fn(for)g(just)g(timing)g(output.) │ │ │ │ │ +307 528 y Ff(\210)42 b Fn(The)32 b Fl(msgFile)c Fn(parameter)i │ │ │ │ │ +(determines)h(the)h(message)e(\014le)i(|)f(if)h Fl(msgFile)d │ │ │ │ │ +Fn(is)i Fl(stdout)p Fn(,)f(then)i(the)g(message)390 628 │ │ │ │ │ +y(\014le)c(is)f Fm(stdout)p Fn(,)h(otherwise)e(a)i(\014le)f(is)h(op)r │ │ │ │ │ +(ened)f(with)i Fm(app)l(end)g Fn(status)e(to)g(receiv)n(e)g(an)n(y)g │ │ │ │ │ +(output)h(data.)307 766 y Ff(\210)42 b Fn(The)28 b Fl(type)e │ │ │ │ │ +Fn(parameter)g(sp)r(eci\014es)h(a)h(real)e(or)h(complex)g(linear)g │ │ │ │ │ +(system.)456 904 y Fe({)41 b Fl(type)h(=)i(1)f(\(SPOOLES)p │ │ │ │ │ 1295 904 27 4 v 28 w(REAL\))25 b Fn(for)i(real,)456 1023 │ │ │ │ │ y Fe({)41 b Fl(type)h(=)i(2)f(\(SPOOLES)p 1295 1023 V │ │ │ │ │ 28 w(COMPLEX\))24 b Fn(for)j(complex.)307 1161 y Ff(\210)42 │ │ │ │ │ b Fn(The)28 b Fl(symmetryflag)23 b Fn(parameter)j(sp)r(eci\014es)h(the) │ │ │ │ │ h(symmetry)f(of)h(the)g(matrix.)456 1299 y Fe({)41 b │ │ │ │ │ Fl(type)h(=)i(0)f(\(SPOOLES)p 1295 1299 V 28 w(SYMMETRIC\))23 │ │ │ │ │ b Fn(for)k Fh(A)h Fn(real)f(or)g(complex)g(symmetric,)456 │ │ │ │ │ @@ -6253,17 +6242,17 @@ │ │ │ │ │ Fl(X)p Fn(.)307 5131 y Ff(\210)42 b Fl(inc1)26 b Fn(is)i(the)g(ro)n(w)e │ │ │ │ │ (incremen)n(t)h(for)g Fl(X)p Fn(.)307 5269 y Ff(\210)42 │ │ │ │ │ b Fl(inc2)26 b Fn(is)i(the)g(column)f(incremen)n(t)h(for)f │ │ │ │ │ Fl(X)p Fn(.)307 5407 y Ff(\210)42 b Fn(The)28 b Fl(seed)e │ │ │ │ │ Fn(parameter)g(is)h(a)h(random)e(n)n(um)n(b)r(er)i(seed.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 83 100 1210 4 v 1376 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2609 100 V 1210 w Fn(15)101 390 y(4.)42 b Fl(testGraph_Bcast)37 │ │ │ │ │ +TeXDict begin 15 14 bop 83 100 1228 4 v 1393 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)h Fm(DRAFT)110 b Fd(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2592 100 V 1228 w Fn(15)101 390 y(4.)42 b Fl(testGraph_Bcast)37 │ │ │ │ │ b(msglvl)k(msgFile)g(type)h(nvtx)g(nitem)f(root)h(seed)208 │ │ │ │ │ 528 y Fn(This)35 b(driv)n(er)g(program)f(tests)h(the)h(distributed)h │ │ │ │ │ Fl(Graph)p 2007 528 27 4 v 29 w(MPI)p 2168 528 V 30 w(Bcast\(\))c │ │ │ │ │ Fn(metho)r(d.)62 b(Pro)r(cessor)33 b Fl(root)h Fn(generates)g(a)208 │ │ │ │ │ 628 y(random)g(graph)f(of)i(t)n(yp)r(e)g Fl(type)f Fn(\(see)g(the)i(do) │ │ │ │ │ r(cumen)n(tation)e(for)h(the)g Fl(Graph)e Fn(ob)5 b(ject)35 │ │ │ │ │ b(in)g(c)n(hapter)f Fe(??)p Fn(\))h(with)h Fl(nvtx)208 │ │ │ │ │ @@ -6355,35 +6344,34 @@ │ │ │ │ │ b Fn(The)29 b Fl(type)e Fn(parameter)g(sp)r(eci\014es)i(whether)g(the)g │ │ │ │ │ (linear)f(system)g(is)h(real)f(or)g(complex.)40 b(Use)28 │ │ │ │ │ b Fl(1)h Fn(for)f(real)g(and)g Fl(2)390 5270 y Fn(for)f(complex.)307 │ │ │ │ │ 5407 y Ff(\210)42 b Fn(The)28 b Fl(symmetryflag)23 b │ │ │ │ │ Fn(parameter)j(denotes)h(the)h(presence)f(or)f(absence)h(of)h(symmetry) │ │ │ │ │ -7 b(.)p eop end │ │ │ │ │ %%Page: 16 16 │ │ │ │ │ -TeXDict begin 16 15 bop 0 100 a Fn(16)p 166 100 1210 │ │ │ │ │ -4 v 1375 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2690 100 V 456 390 a Fe({)41 b Fn(Use)f │ │ │ │ │ -Fl(0)g Fn(for)f(a)g(real)g(or)g(complex)g(symmetric)g(matrix)g │ │ │ │ │ -Fh(A)p Fn(.)74 b(A)40 b(\()p Fh(U)2703 360 y Fg(T)2782 │ │ │ │ │ -390 y Fn(+)26 b Fh(I)7 b Fn(\))p Fh(D)r Fn(\()p Fh(I)34 │ │ │ │ │ -b Fn(+)26 b Fh(U)9 b Fn(\))40 b(factorization)e(is)545 │ │ │ │ │ -490 y(computed.)456 601 y Fe({)j Fn(Use)28 b Fl(1)f Fn(for)g(a)h │ │ │ │ │ -(complex)f(Hermitian)g(matrix)g Fh(A)p Fn(.)38 b(A)28 │ │ │ │ │ -b(\()p Fh(U)2273 571 y Fg(H)2354 601 y Fn(+)18 b Fh(I)7 │ │ │ │ │ -b Fn(\))p Fh(D)r Fn(\()p Fh(I)26 b Fn(+)18 b Fh(U)9 b │ │ │ │ │ -Fn(\))28 b(factorization)e(is)i(computed.)456 713 y Fe({)41 │ │ │ │ │ -b Fn(Use)36 b Fl(2)f Fn(for)g(a)h(real)e(or)h(complex)g(nonsymmetric)g │ │ │ │ │ -(matrix)g Fh(A)p Fn(.)62 b(A)36 b(\()p Fh(L)23 b Fn(+)g │ │ │ │ │ -Fh(I)7 b Fn(\))p Fh(D)r Fn(\()p Fh(I)32 b Fn(+)23 b Fh(U)9 │ │ │ │ │ -b Fn(\))36 b(factorization)e(is)545 812 y(computed.)307 │ │ │ │ │ -936 y Ff(\210)42 b Fn(The)31 b Fl(sparsityflag)26 b Fn(parameter)j │ │ │ │ │ -(denotes)i(a)f(direct)g(or)g(appro)n(ximate)f(factorization.)45 │ │ │ │ │ -b(V)-7 b(alid)31 b(v)-5 b(alues)31 b(are)e Fl(0)390 1035 │ │ │ │ │ -y Fn(for)e(a)g(direct)h(factorization)e(and)i Fl(1)f │ │ │ │ │ -Fn(is)g(for)g(an)h(appro)n(ximate)e(factorization.)307 │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fn(16)p 166 100 1228 │ │ │ │ │ +4 v 1392 w Fl(MPI)27 b Fd(:)h Fm(DRAFT)f Fd(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2673 100 V 456 390 a Fe({)41 b Fn(Use)f Fl(0)g Fn(for)f(a)g(real)g(or)g │ │ │ │ │ +(complex)g(symmetric)g(matrix)g Fh(A)p Fn(.)74 b(A)40 │ │ │ │ │ +b(\()p Fh(U)2703 360 y Fg(T)2782 390 y Fn(+)26 b Fh(I)7 │ │ │ │ │ +b Fn(\))p Fh(D)r Fn(\()p Fh(I)34 b Fn(+)26 b Fh(U)9 b │ │ │ │ │ +Fn(\))40 b(factorization)e(is)545 490 y(computed.)456 │ │ │ │ │ +601 y Fe({)j Fn(Use)28 b Fl(1)f Fn(for)g(a)h(complex)f(Hermitian)g │ │ │ │ │ +(matrix)g Fh(A)p Fn(.)38 b(A)28 b(\()p Fh(U)2273 571 │ │ │ │ │ +y Fg(H)2354 601 y Fn(+)18 b Fh(I)7 b Fn(\))p Fh(D)r Fn(\()p │ │ │ │ │ +Fh(I)26 b Fn(+)18 b Fh(U)9 b Fn(\))28 b(factorization)e(is)i(computed.) │ │ │ │ │ +456 713 y Fe({)41 b Fn(Use)36 b Fl(2)f Fn(for)g(a)h(real)e(or)h │ │ │ │ │ +(complex)g(nonsymmetric)g(matrix)g Fh(A)p Fn(.)62 b(A)36 │ │ │ │ │ +b(\()p Fh(L)23 b Fn(+)g Fh(I)7 b Fn(\))p Fh(D)r Fn(\()p │ │ │ │ │ +Fh(I)32 b Fn(+)23 b Fh(U)9 b Fn(\))36 b(factorization)e(is)545 │ │ │ │ │ +812 y(computed.)307 936 y Ff(\210)42 b Fn(The)31 b Fl(sparsityflag)26 │ │ │ │ │ +b Fn(parameter)j(denotes)i(a)f(direct)g(or)g(appro)n(ximate)f │ │ │ │ │ +(factorization.)45 b(V)-7 b(alid)31 b(v)-5 b(alues)31 │ │ │ │ │ +b(are)e Fl(0)390 1035 y Fn(for)e(a)g(direct)h(factorization)e(and)i │ │ │ │ │ +Fl(1)f Fn(is)g(for)g(an)h(appro)n(ximate)e(factorization.)307 │ │ │ │ │ 1158 y Ff(\210)42 b Fn(The)29 b Fl(pivotingflag)24 b │ │ │ │ │ Fn(parameter)j(denotes)i(whether)g(piv)n(oting)f(is)h(to)f(b)r(e)h │ │ │ │ │ (used)g(in)g(the)h(factorization.)39 b(V)-7 b(alid)390 │ │ │ │ │ 1258 y(v)i(alues)27 b(are)g Fl(0)g Fn(for)g(no)h(piv)n(oting)f(and)g │ │ │ │ │ Fl(1)g Fn(to)h(enable)f(piv)n(oting.)307 1381 y Ff(\210)42 │ │ │ │ │ b Fn(The)30 b Fl(tau)f Fn(parameter)g(is)g(used)h(when)h(piv)n(oting)e │ │ │ │ │ (is)h(enabled,)g(in)g(whic)n(h)g(case)f(it)i(is)f(an)f(upp)r(er)i(b)r │ │ │ │ │ @@ -6464,17 +6452,17 @@ │ │ │ │ │ (stored)f(con)n(tiguously)f(or)h(at)g(least)h(in)f(one)208 │ │ │ │ │ 5279 y(blo)r(c)n(k)h(of)g(storage,)f(w)n(e)h(could)h(ha)n(v)n(e)e(used) │ │ │ │ │ i(the)f Fl(MPI)p 1835 5279 V 31 w(Alltoallv\(\))c Fn(metho)r(d.)208 │ │ │ │ │ 5407 y(Use)k(the)h(script)f(\014le)h Fl(do)p 968 5407 │ │ │ │ │ V 31 w(IVL)p 1131 5407 V 30 w(alltoall)c Fn(for)j(testing.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 17 17 │ │ │ │ │ -TeXDict begin 17 16 bop 83 100 1210 4 v 1376 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2609 100 V 1210 w Fn(17)307 390 y Ff(\210)42 b Fn(The)23 │ │ │ │ │ +TeXDict begin 17 16 bop 83 100 1228 4 v 1393 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)h Fm(DRAFT)110 b Fd(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2592 100 V 1228 w Fn(17)307 390 y Ff(\210)42 b Fn(The)23 │ │ │ │ │ b Fl(msglvl)e Fn(parameter)g(determines)i(the)h(amoun)n(t)e(of)h │ │ │ │ │ (output.)36 b(Use)23 b Fl(msglvl)41 b(=)i(1)23 b Fn(for)g(just)g │ │ │ │ │ (timing)g(output.)307 524 y Ff(\210)42 b Fn(The)32 b │ │ │ │ │ Fl(msgFile)c Fn(parameter)i(determines)h(the)h(message)e(\014le)i(|)f │ │ │ │ │ (if)h Fl(msgFile)d Fn(is)i Fl(stdout)p Fn(,)f(then)i(the)g(message)390 │ │ │ │ │ 624 y(\014le)c(is)f Fm(stdout)p Fn(,)h(otherwise)e(a)i(\014le)f(is)h │ │ │ │ │ (op)r(ened)f(with)i Fm(app)l(end)g Fn(status)e(to)g(receiv)n(e)g(an)n │ │ │ │ │ @@ -6573,45 +6561,44 @@ │ │ │ │ │ y Ff(\210)42 b Fn(The)32 b Fl(msgFile)c Fn(parameter)i(determines)h │ │ │ │ │ (the)h(message)e(\014le)i(|)f(if)h Fl(msgFile)d Fn(is)i │ │ │ │ │ Fl(stdout)p Fn(,)f(then)i(the)g(message)390 5407 y(\014le)c(is)f │ │ │ │ │ Fm(stdout)p Fn(,)h(otherwise)e(a)i(\014le)f(is)h(op)r(ened)f(with)i │ │ │ │ │ Fm(app)l(end)g Fn(status)e(to)g(receiv)n(e)g(an)n(y)g(output)h(data.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 18 18 │ │ │ │ │ -TeXDict begin 18 17 bop 0 100 a Fn(18)p 166 100 1210 │ │ │ │ │ -4 v 1375 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2690 100 V 307 390 a Ff(\210)42 b Fn(The)28 │ │ │ │ │ -b Fl(nrowA)d Fn(parameter)i(is)g(the)h(n)n(um)n(b)r(er)f(of)h(ro)n(ws)e │ │ │ │ │ -(in)i Fh(A)p Fn(.)307 524 y Ff(\210)42 b Fn(The)28 b │ │ │ │ │ -Fl(ncolA)d Fn(parameter)i(is)g(the)h(n)n(um)n(b)r(er)f(of)h(columns)f │ │ │ │ │ -(in)h Fh(A)p Fn(.)307 658 y Ff(\210)42 b Fn(The)28 b │ │ │ │ │ -Fl(nentA)d Fn(parameter)i(is)g(the)h(n)n(um)n(b)r(er)f(of)h(en)n(tries) │ │ │ │ │ -f(to)g(b)r(e)h(put)h(in)n(to)e Fh(A)p Fn(.)307 792 y │ │ │ │ │ -Ff(\210)42 b Fn(The)28 b Fl(nrowX)d Fn(parameter)i(is)g(the)h(n)n(um)n │ │ │ │ │ -(b)r(er)f(of)h(ro)n(ws)e(in)i Fh(X)7 b Fn(.)307 926 y │ │ │ │ │ -Ff(\210)42 b Fn(The)24 b Fl(coordType)c Fn(parameter)i(de\014nes)i(the) │ │ │ │ │ -g(co)r(ordinate)e(t)n(yp)r(e)i(that)g(will)g(b)r(e)g(used)f(during)g │ │ │ │ │ -(the)h(redistribution.)390 1026 y(V)-7 b(alid)28 b(v)-5 │ │ │ │ │ -b(alues)27 b(are)g Fl(1)g Fn(for)g(ro)n(ws,)f Fl(2)i │ │ │ │ │ -Fn(for)f(columns)g(and)g Fl(3)h Fn(for)f(c)n(hevrons.)307 │ │ │ │ │ -1160 y Ff(\210)42 b Fn(The)26 b Fl(inputMode)d Fn(parameter)h │ │ │ │ │ -(de\014nes)i(the)h(mo)r(de)f(of)g(input.)37 b(V)-7 b(alid)26 │ │ │ │ │ -b(v)-5 b(alues)26 b(are)f Fl(1)g Fn(for)h(real)f(en)n(tries)g(and)h │ │ │ │ │ -Fl(2)g Fn(for)390 1260 y(complex)h(en)n(tries.)307 1394 │ │ │ │ │ -y Ff(\210)42 b Fn(The)c Fl(symflag)c Fn(parameter)i(sp)r(eci\014es)h │ │ │ │ │ -(whether)h(the)f(matrix)g(is)g(symmetric)g(\()p Fl(symflag)e │ │ │ │ │ -Fn(=)i(0\),)j(Hermitian)390 1493 y(\()p Fl(symflag)25 │ │ │ │ │ -b Fn(=)j(1\))f(or)g(nonsymmetric)g(\()p Fl(symflag)e │ │ │ │ │ -Fn(=)i(2\))307 1627 y Ff(\210)42 b Fn(The)25 b Fl(opflag)d │ │ │ │ │ -Fn(parameter)h(sp)r(eci\014es)i(the)g(t)n(yp)r(e)g(of)g(m)n(ultiply)-7 │ │ │ │ │ -b(,)26 b Fl(0)e Fn(for)g Fh(Y)42 b Fn(:=)22 b Fh(Y)32 │ │ │ │ │ -b Fn(+)13 b Fh(\013AX)7 b Fn(,)24 b Fl(1)h Fn(for)f Fh(Y)42 │ │ │ │ │ -b Fn(:=)22 b Fh(Y)32 b Fn(+)13 b Fh(\013A)3773 1597 y │ │ │ │ │ -Fg(T)3825 1627 y Fh(X)390 1727 y Fn(or)27 b Fl(2)g Fn(for)g │ │ │ │ │ -Fh(Y)42 b Fn(:=)23 b Fh(Y)37 b Fn(+)18 b Fh(\013A)1174 │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fn(18)p 166 100 1228 │ │ │ │ │ +4 v 1392 w Fl(MPI)27 b Fd(:)h Fm(DRAFT)f Fd(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2673 100 V 307 390 a Ff(\210)42 b Fn(The)28 b Fl(nrowA)d │ │ │ │ │ +Fn(parameter)i(is)g(the)h(n)n(um)n(b)r(er)f(of)h(ro)n(ws)e(in)i │ │ │ │ │ +Fh(A)p Fn(.)307 524 y Ff(\210)42 b Fn(The)28 b Fl(ncolA)d │ │ │ │ │ +Fn(parameter)i(is)g(the)h(n)n(um)n(b)r(er)f(of)h(columns)f(in)h │ │ │ │ │ +Fh(A)p Fn(.)307 658 y Ff(\210)42 b Fn(The)28 b Fl(nentA)d │ │ │ │ │ +Fn(parameter)i(is)g(the)h(n)n(um)n(b)r(er)f(of)h(en)n(tries)f(to)g(b)r │ │ │ │ │ +(e)h(put)h(in)n(to)e Fh(A)p Fn(.)307 792 y Ff(\210)42 │ │ │ │ │ +b Fn(The)28 b Fl(nrowX)d Fn(parameter)i(is)g(the)h(n)n(um)n(b)r(er)f │ │ │ │ │ +(of)h(ro)n(ws)e(in)i Fh(X)7 b Fn(.)307 926 y Ff(\210)42 │ │ │ │ │ +b Fn(The)24 b Fl(coordType)c Fn(parameter)i(de\014nes)i(the)g(co)r │ │ │ │ │ +(ordinate)e(t)n(yp)r(e)i(that)g(will)g(b)r(e)g(used)f(during)g(the)h │ │ │ │ │ +(redistribution.)390 1026 y(V)-7 b(alid)28 b(v)-5 b(alues)27 │ │ │ │ │ +b(are)g Fl(1)g Fn(for)g(ro)n(ws,)f Fl(2)i Fn(for)f(columns)g(and)g │ │ │ │ │ +Fl(3)h Fn(for)f(c)n(hevrons.)307 1160 y Ff(\210)42 b │ │ │ │ │ +Fn(The)26 b Fl(inputMode)d Fn(parameter)h(de\014nes)i(the)h(mo)r(de)f │ │ │ │ │ +(of)g(input.)37 b(V)-7 b(alid)26 b(v)-5 b(alues)26 b(are)f │ │ │ │ │ +Fl(1)g Fn(for)h(real)f(en)n(tries)g(and)h Fl(2)g Fn(for)390 │ │ │ │ │ +1260 y(complex)h(en)n(tries.)307 1394 y Ff(\210)42 b │ │ │ │ │ +Fn(The)c Fl(symflag)c Fn(parameter)i(sp)r(eci\014es)h(whether)h(the)f │ │ │ │ │ +(matrix)g(is)g(symmetric)g(\()p Fl(symflag)e Fn(=)i(0\),)j(Hermitian) │ │ │ │ │ +390 1493 y(\()p Fl(symflag)25 b Fn(=)j(1\))f(or)g(nonsymmetric)g(\()p │ │ │ │ │ +Fl(symflag)e Fn(=)i(2\))307 1627 y Ff(\210)42 b Fn(The)25 │ │ │ │ │ +b Fl(opflag)d Fn(parameter)h(sp)r(eci\014es)i(the)g(t)n(yp)r(e)g(of)g │ │ │ │ │ +(m)n(ultiply)-7 b(,)26 b Fl(0)e Fn(for)g Fh(Y)42 b Fn(:=)22 │ │ │ │ │ +b Fh(Y)32 b Fn(+)13 b Fh(\013AX)7 b Fn(,)24 b Fl(1)h │ │ │ │ │ +Fn(for)f Fh(Y)42 b Fn(:=)22 b Fh(Y)32 b Fn(+)13 b Fh(\013A)3773 │ │ │ │ │ +1597 y Fg(T)3825 1627 y Fh(X)390 1727 y Fn(or)27 b Fl(2)g │ │ │ │ │ +Fn(for)g Fh(Y)42 b Fn(:=)23 b Fh(Y)37 b Fn(+)18 b Fh(\013A)1174 │ │ │ │ │ 1697 y Fg(H)1237 1727 y Fh(X)7 b Fn(.)307 1861 y Ff(\210)42 │ │ │ │ │ b Fn(The)28 b Fl(seed)e Fn(parameter)g(is)h(a)h(random)e(n)n(um)n(b)r │ │ │ │ │ (er)i(seed.)307 1995 y Ff(\210)42 b Fn(The)28 b Fl(real)e │ │ │ │ │ Fn(parameter)g(is)h(the)h(real)f(part)g(of)h(the)g(scalar)e │ │ │ │ │ Fh(\013)p Fn(.)307 2129 y Ff(\210)42 b Fn(The)28 b Fl(imag)e │ │ │ │ │ Fn(parameter)g(is)h(the)h(imaginary)e(part)i(of)f(the)h(scalar)e │ │ │ │ │ Fh(\013)p Fn(,)i(ignored)f(for)g(real)f(en)n(tries.)60 │ │ │ │ │ @@ -6674,17 +6661,17 @@ │ │ │ │ │ (timing)g(output.)307 5308 y Ff(\210)42 b Fn(The)32 b │ │ │ │ │ Fl(msgFile)c Fn(parameter)i(determines)h(the)h(message)e(\014le)i(|)f │ │ │ │ │ (if)h Fl(msgFile)d Fn(is)i Fl(stdout)p Fn(,)f(then)i(the)g(message)390 │ │ │ │ │ 5407 y(\014le)c(is)f Fm(stdout)p Fn(,)h(otherwise)e(a)i(\014le)f(is)h │ │ │ │ │ (op)r(ened)f(with)i Fm(app)l(end)g Fn(status)e(to)g(receiv)n(e)g(an)n │ │ │ │ │ (y)g(output)h(data.)p eop end │ │ │ │ │ %%Page: 19 19 │ │ │ │ │ -TeXDict begin 19 18 bop 83 100 1210 4 v 1376 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2609 100 V 1210 w Fn(19)307 390 y Ff(\210)42 b Fn(The)28 │ │ │ │ │ +TeXDict begin 19 18 bop 83 100 1228 4 v 1393 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)h Fm(DRAFT)110 b Fd(Jan)n(uary)25 b(7,)j(2024)p │ │ │ │ │ +2592 100 V 1228 w Fn(19)307 390 y Ff(\210)42 b Fn(The)28 │ │ │ │ │ b Fl(neqns)d Fn(parameter)i(is)g(the)h(n)n(um)n(b)r(er)f(of)h │ │ │ │ │ (equations)f(for)g(the)h(matrix.)307 518 y Ff(\210)42 │ │ │ │ │ b Fn(The)28 b Fl(seed)e Fn(parameter)g(is)h(a)h(random)e(n)n(um)n(b)r │ │ │ │ │ (er)i(seed.)307 647 y Ff(\210)42 b Fn(The)24 b Fl(coordType)c │ │ │ │ │ Fn(parameter)i(de\014nes)i(the)g(co)r(ordinate)e(t)n(yp)r(e)i(that)g │ │ │ │ │ (will)g(b)r(e)g(used)f(during)g(the)h(redistribution.)390 │ │ │ │ │ 746 y(V)-7 b(alid)28 b(v)-5 b(alues)27 b(are)g Fl(1)g │ │ │ │ │ @@ -6777,45 +6764,44 @@ │ │ │ │ │ g Fl(IVL)208 5308 y Fn(ob)5 b(ject)39 b(that)h(con)n(tains)f(the)h │ │ │ │ │ (necessary)e(parts)h(of)g(a)h(sym)n(b)r(olic)f(factorization)f(for)h │ │ │ │ │ (eac)n(h)g(pro)r(cessor.)71 b(The)40 b(pro-)208 5407 │ │ │ │ │ y(gram)34 b(reads)g(in)i(the)g(global)f Fl(Graph)e Fn(and)j │ │ │ │ │ Fl(ETree)d Fn(ob)5 b(jects.)60 b(Eac)n(h)35 b(pro)r(cessor)e(creates)i │ │ │ │ │ (a)g(global)f Fl(InpMtx)f Fn(ob)5 b(ject)p eop end │ │ │ │ │ %%Page: 20 20 │ │ │ │ │ -TeXDict begin 20 19 bop 0 100 a Fn(20)p 166 100 1210 │ │ │ │ │ -4 v 1375 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2690 100 V 208 390 a Fn(from)j(the)i(structure)e(of)h │ │ │ │ │ -(the)h(graph)e(and)h(computes)f(a)h(global)f(sym)n(b)r(olic)h │ │ │ │ │ -(factorization)e(ob)5 b(ject)31 b(using)g(the)g(serial)208 │ │ │ │ │ -490 y Fl(SymbFac)p 521 490 27 4 v 28 w(initFromInpMtx\(\))23 │ │ │ │ │ -b Fn(metho)r(d.)43 b(The)30 b(pro)r(cessors)d(then)j(compute)f(a)h(map) │ │ │ │ │ -f(from)g(fron)n(ts)g(to)g(pro)r(cessors,)208 589 y(and)g(eac)n(h)f(pro) │ │ │ │ │ -r(cessor)f(thro)n(ws)h(a)n(w)n(a)n(y)f(the)i(uno)n(wned)g(matrix)g(en)n │ │ │ │ │ -(tries)f(from)h(the)g Fl(InpMtx)e Fn(ob)5 b(ject.)41 │ │ │ │ │ -b(The)29 b(pro)r(cessors)208 689 y(then)i(compute)h(their)f(necessary)f │ │ │ │ │ -(sym)n(b)r(olic)g(factorizations)g(in)i(parallel.)47 │ │ │ │ │ -b(F)-7 b(or)30 b(a)h(c)n(hec)n(k,)h(they)f(compare)f(the)i(t)n(w)n(o) │ │ │ │ │ -208 789 y(sym)n(b)r(olic)27 b(factorizations)f(for)h(error.)35 │ │ │ │ │ -b(Use)27 b(the)h(script)f(\014le)h Fl(do)p 2190 789 V │ │ │ │ │ -31 w(symbfac)d Fn(for)i(testing.)307 971 y Ff(\210)42 │ │ │ │ │ -b Fn(The)23 b Fl(msglvl)e Fn(parameter)g(determines)i(the)h(amoun)n(t)e │ │ │ │ │ -(of)h(output.)36 b(Use)23 b Fl(msglvl)41 b(=)i(1)23 b │ │ │ │ │ -Fn(for)g(just)g(timing)g(output.)307 1104 y Ff(\210)42 │ │ │ │ │ -b Fn(The)32 b Fl(msgFile)c Fn(parameter)i(determines)h(the)h(message)e │ │ │ │ │ -(\014le)i(|)f(if)h Fl(msgFile)d Fn(is)i Fl(stdout)p Fn(,)f(then)i(the)g │ │ │ │ │ -(message)390 1204 y(\014le)c(is)f Fm(stdout)p Fn(,)h(otherwise)e(a)i │ │ │ │ │ -(\014le)f(is)h(op)r(ened)f(with)i Fm(app)l(end)g Fn(status)e(to)g │ │ │ │ │ -(receiv)n(e)g(an)n(y)g(output)h(data.)307 1337 y Ff(\210)42 │ │ │ │ │ -b Fn(The)28 b Fl(inGraphFile)23 b Fn(parameter)j(is)i(the)g(input)g │ │ │ │ │ -(\014le)g(for)f(the)h Fl(Graph)d Fn(ob)5 b(ject.)307 │ │ │ │ │ -1469 y Ff(\210)42 b Fn(The)28 b Fl(inETreeFile)23 b Fn(parameter)j(is)i │ │ │ │ │ -(the)g(input)g(\014le)g(for)f(the)h Fl(ETree)d Fn(ob)5 │ │ │ │ │ -b(ject.)307 1602 y Ff(\210)42 b Fn(The)28 b Fl(seed)e │ │ │ │ │ -Fn(parameter)g(is)h(a)h(random)e(n)n(um)n(b)r(er)i(seed.)p │ │ │ │ │ -eop end │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fn(20)p 166 100 1228 │ │ │ │ │ +4 v 1392 w Fl(MPI)27 b Fd(:)h Fm(DRAFT)f Fd(Jan)n(uary)e(7,)j(2024)p │ │ │ │ │ +2673 100 V 208 390 a Fn(from)i(the)i(structure)e(of)h(the)h(graph)e │ │ │ │ │ +(and)h(computes)f(a)h(global)f(sym)n(b)r(olic)h(factorization)e(ob)5 │ │ │ │ │ +b(ject)31 b(using)g(the)g(serial)208 490 y Fl(SymbFac)p │ │ │ │ │ +521 490 27 4 v 28 w(initFromInpMtx\(\))23 b Fn(metho)r(d.)43 │ │ │ │ │ +b(The)30 b(pro)r(cessors)d(then)j(compute)f(a)h(map)f(from)g(fron)n(ts) │ │ │ │ │ +g(to)g(pro)r(cessors,)208 589 y(and)g(eac)n(h)f(pro)r(cessor)f(thro)n │ │ │ │ │ +(ws)h(a)n(w)n(a)n(y)f(the)i(uno)n(wned)g(matrix)g(en)n(tries)f(from)h │ │ │ │ │ +(the)g Fl(InpMtx)e Fn(ob)5 b(ject.)41 b(The)29 b(pro)r(cessors)208 │ │ │ │ │ +689 y(then)i(compute)h(their)f(necessary)f(sym)n(b)r(olic)g │ │ │ │ │ +(factorizations)g(in)i(parallel.)47 b(F)-7 b(or)30 b(a)h(c)n(hec)n(k,)h │ │ │ │ │ +(they)f(compare)f(the)i(t)n(w)n(o)208 789 y(sym)n(b)r(olic)27 │ │ │ │ │ +b(factorizations)f(for)h(error.)35 b(Use)27 b(the)h(script)f(\014le)h │ │ │ │ │ +Fl(do)p 2190 789 V 31 w(symbfac)d Fn(for)i(testing.)307 │ │ │ │ │ +971 y Ff(\210)42 b Fn(The)23 b Fl(msglvl)e Fn(parameter)g(determines)i │ │ │ │ │ +(the)h(amoun)n(t)e(of)h(output.)36 b(Use)23 b Fl(msglvl)41 │ │ │ │ │ +b(=)i(1)23 b Fn(for)g(just)g(timing)g(output.)307 1104 │ │ │ │ │ +y Ff(\210)42 b Fn(The)32 b Fl(msgFile)c Fn(parameter)i(determines)h │ │ │ │ │ +(the)h(message)e(\014le)i(|)f(if)h Fl(msgFile)d Fn(is)i │ │ │ │ │ +Fl(stdout)p Fn(,)f(then)i(the)g(message)390 1204 y(\014le)c(is)f │ │ │ │ │ +Fm(stdout)p Fn(,)h(otherwise)e(a)i(\014le)f(is)h(op)r(ened)f(with)i │ │ │ │ │ +Fm(app)l(end)g Fn(status)e(to)g(receiv)n(e)g(an)n(y)g(output)h(data.) │ │ │ │ │ +307 1337 y Ff(\210)42 b Fn(The)28 b Fl(inGraphFile)23 │ │ │ │ │ +b Fn(parameter)j(is)i(the)g(input)g(\014le)g(for)f(the)h │ │ │ │ │ +Fl(Graph)d Fn(ob)5 b(ject.)307 1469 y Ff(\210)42 b Fn(The)28 │ │ │ │ │ +b Fl(inETreeFile)23 b Fn(parameter)j(is)i(the)g(input)g(\014le)g(for)f │ │ │ │ │ +(the)h Fl(ETree)d Fn(ob)5 b(ject.)307 1602 y Ff(\210)42 │ │ │ │ │ +b Fn(The)28 b Fl(seed)e Fn(parameter)g(is)h(a)h(random)e(n)n(um)n(b)r │ │ │ │ │ +(er)i(seed.)p eop end │ │ │ │ │ %%Page: 21 21 │ │ │ │ │ TeXDict begin 21 20 bop 0 866 a Fo(Index)0 1281 y Fl(DenseMtx)p │ │ │ │ │ 357 1281 27 4 v 28 w(MPI)p 517 1281 V 30 w(gatherRows\(\))p │ │ │ │ │ Fn(,)23 b(5)0 1380 y Fl(DenseMtx)p 357 1380 V 28 w(MPI)p │ │ │ │ │ 517 1380 V 30 w(scatterAddRows\(\))p Fn(,)e(6)0 1480 │ │ │ │ │ y Fl(DenseMtx)p 357 1480 V 28 w(MPI)p 517 1480 V 30 w(splitByRows\(\))p │ │ │ │ │ Fn(,)i(3)0 1580 y Fl(DenseMtx)p 357 1580 V 28 w(MPI)p │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -31,15 +31,15 @@ │ │ │ │ │ │ scatter/added into Y. │ │ │ │ │ │ TheMatMulInfoobjectstoresallthenecessaryinformationtomakethishappen. ThereisoneMatMulInfo │ │ │ │ │ │ object per processor. It has the following fields. │ │ │ │ │ │ • symflag — symmetry flag for A │ │ │ │ │ │ – 0 (SPOOLES SYMMETRIC) – symmetric matrix │ │ │ │ │ │ – 1 (SPOOLES HERMITIAN) – hermitian matrix │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ – 2 (SPOOLES NONSYMMETRIC) – nonsymmetric matrix │ │ │ │ │ │ • opflag — operation flag for the multiply │ │ │ │ │ │ – 0 (MMM WITH A) — perform Y := Y +αAX │ │ │ │ │ │ – 1 (MMM WITH AT) — perform Y := Y +αATX │ │ │ │ │ │ – 2 (MMM WITH AH) — perform Y := Y +αAHX │ │ │ │ │ │ • IV *XownedIV — list of rows of X that are owned by this processor, these form the rows of Xq. │ │ │ │ │ │ • IV *XsupIV — list of rows of X that are accessed by this processor, these form the rows of Xq │ │ │ │ │ │ @@ -73,15 +73,15 @@ │ │ │ │ │ │ In a distributed environment, data must be distributed, and sometimes during a computation, data must be │ │ │ │ │ │ re-distributed. These methods split and redistribute four data objects. │ │ │ │ │ │ 1. void DenseMtx_MPI_splitByRows ( DenseMtx *mtx, IV *mapIV, int stats[], int msglvl, │ │ │ │ │ │ FILE *msgFile, int firsttag, MPI_Comm comm ) ; │ │ │ │ │ │ This method splits and redistributes the DenseMtx object based on the mapIV object that maps rows to │ │ │ │ │ │ processes. The messages that will be sent require nproc consecutive tags — the first is the parameter │ │ │ │ │ │ firsttag. On return, the stats[] vector contains the following information. │ │ │ │ │ │ - MPI : DRAFT February 8, 2025 3 │ │ │ │ │ │ + MPI : DRAFT January 7, 2024 3 │ │ │ │ │ │ stats[0] — #ofmessagessent stats[1] — #ofbytessent │ │ │ │ │ │ stats[2] — #ofmessagesreceived stats[3] — #ofbytesreceived │ │ │ │ │ │ Note, the values in stats[] are incremented, i.e., the stats[] vector is not zeroed at the start of the │ │ │ │ │ │ method, and so can be used to accumulated information with multiple calls. │ │ │ │ │ │ Error checking: If mtx or rowmapIV is NULL, or if msglvl > 0 and msgFile is NULL, or if firsttag < │ │ │ │ │ │ 0 or firsttag + nproc is larger than the largest available tag, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ @@ -117,15 +117,15 @@ │ │ │ │ │ │ use the chevron coordinate type to store the matrix entries. This method will redistribute a matrix │ │ │ │ │ │ by rows if the coordinate type is 1 (for rows) and mapIV is a row map. Similarly, this method will │ │ │ │ │ │ redistribute a matrix by columns if the coordinate type is 2 (for columns) and mapIV is a column map. │ │ │ │ │ │ See the InpMtx object for details. The messages that will be sent require nproc consecutive tags — the │ │ │ │ │ │ first is the parameter firsttag. On return, the stats[] vector contains the following information. │ │ │ │ │ │ stats[0] — #ofmessagessent stats[1] — #ofbytessent │ │ │ │ │ │ stats[2] — #ofmessagesreceived stats[3] — #ofbytesreceived │ │ │ │ │ │ - 4 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ Note, the values in stats[] are incremented, i.e., the stats[] vector is not zeroed at the start of the │ │ │ │ │ │ method, and so can be used to accumulated information with multiple calls. │ │ │ │ │ │ Error checking: If firsttag < 0 or firsttag + nproc is larger than the largest available tag, an │ │ │ │ │ │ error message is printed and the program exits. │ │ │ │ │ │ 5. InpMtx * InpMtx_MPI_splitFromGlobal ( InpMtx *Aglobal, InpMtx *Alocal, │ │ │ │ │ │ IV *mapIV, int root, int stats[], int msglvl, │ │ │ │ │ │ FILE *msgFile, int firsttag, MPI_Comm comm ) ; │ │ │ │ │ │ @@ -158,15 +158,15 @@ │ │ │ │ │ │ knownpriortoenteringthis method. Onreturn, the stats[]vectorcontainsthe followinginformation. │ │ │ │ │ │ stats[0] — #ofmessagessent stats[1] — #ofbytessent │ │ │ │ │ │ stats[2] — #ofmessagesreceived stats[3] — #ofbytesreceived │ │ │ │ │ │ Note, the values in stats[] are incremented, i.e., the stats[] vector is not zeroed at the start of the │ │ │ │ │ │ method, and so can be used to accumulated information with multiple calls. │ │ │ │ │ │ Error checking: If mtx or rowmapIV is NULL, or if msglvl > 0 and msgFile is NULL, or if firsttag < │ │ │ │ │ │ 0 is larger than the largest available tag, an error message is printed and the program exits. │ │ │ │ │ │ - MPI : DRAFT February 8, 2025 5 │ │ │ │ │ │ + MPI : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.2.2 Gather and scatter methods │ │ │ │ │ │ These method gather and scatter/add rows of DenseMtx objects. These operations are performed during the │ │ │ │ │ │ distributed matrix-matrixmultiply. ThegatheroperationXq ←XisperformedbyDenseMtx MPI gatherRows(), │ │ │ │ │ │ P supp │ │ │ │ │ │ while the scatter/add operation Y q := Y q + Yr is performed by DenseMtx MPI scatterAddRows(). │ │ │ │ │ │ r supp │ │ │ │ │ │ 1. void DenseMtx_MPI_gatherRows ( DenseMtx *Y, DenseMtx *X, IVL *sendIVL, │ │ │ │ │ │ @@ -202,15 +202,15 @@ │ │ │ │ │ │ 1.2.3 Symbolic Factorization methods │ │ │ │ │ │ 1. IVL * SymbFac_MPI_initFromInpMtx ( ETree *etree, IV *frontOwnersIV, │ │ │ │ │ │ InpMtx *inpmtx, int stats[], int msglvl, │ │ │ │ │ │ FILE *msgFile, int firsttag, MPI_Comm comm ) ; │ │ │ │ │ │ IVL * SymbFac_MPI_initFromPencil ( ETree *etree, IV *frontOwnersIV, │ │ │ │ │ │ Pencil *pencil, int stats[], int msglvl, │ │ │ │ │ │ FILE *msgFile, int firsttag, MPI_Comm comm ) ; │ │ │ │ │ │ - 6 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ ThesemethodsareusedinplaceoftheSymbfac initFrom{InpMtx,Pencil}()methodstocomputethe │ │ │ │ │ │ symbolic factorization. The ETree object is assumed to be replicated over the processes. The InpMtx │ │ │ │ │ │ and Pencil objects are partitioned among the processes. Therefore, to compute the IVL object that │ │ │ │ │ │ contains the symbolic factorization is a distributed, cooperative process. At the end of the symbolic │ │ │ │ │ │ factorization, each process will own a portion of the IVL object. The IVL object is neither replicated │ │ │ │ │ │ nor partitioned (except in trivial cases), but the IVL object on each process contains just a portion, │ │ │ │ │ │ usually not much more than what it needs to know for its part of the factorization and solves. │ │ │ │ │ │ @@ -247,15 +247,15 @@ │ │ │ │ │ │ cpus[0] – initialize fronts cpus[7] – extract postponed data │ │ │ │ │ │ cpus[1] – load original entries cpus[8] – store factor entries │ │ │ │ │ │ cpus[2] – update fronts cpus[9] – post initial receives │ │ │ │ │ │ cpus[3] – insert aggregate data cpus[10] – check for received messages │ │ │ │ │ │ cpus[4] – assemble aggregate data cpus[11] – post initial sends │ │ │ │ │ │ cpus[5] – assemble postponed data cpus[12] – check for sent messages │ │ │ │ │ │ cpus[6] – factor fronts │ │ │ │ │ │ - MPI : DRAFT February 8, 2025 7 │ │ │ │ │ │ + MPI : DRAFT January 7, 2024 7 │ │ │ │ │ │ Onreturn, the stats[] vector has the following information. │ │ │ │ │ │ stats[0] — #ofpivots │ │ │ │ │ │ stats[1] — #ofpivot tests │ │ │ │ │ │ stats[2] — #ofdelayed rows and columns │ │ │ │ │ │ stats[3] — #ofentries in D │ │ │ │ │ │ stats[4] — #ofentries in L │ │ │ │ │ │ stats[5] — #ofentries in U │ │ │ │ │ │ @@ -293,15 +293,15 @@ │ │ │ │ │ │ Error checking: If frontmtx, frontOwnersIV or stats is NULL, or if firsttag < 0 or firsttag + │ │ │ │ │ │ nproc, is larger than the largest available tag, or if msglvl > 0 and msgFile is NULL, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 3. void IV_MPI_allgather ( IV *iv, IV *ownersIV, int stats[], int msglvl, │ │ │ │ │ │ FILE *msgFile, int firsttag, MPI_Comm comm ) ; │ │ │ │ │ │ After a factorization with pivoting, the frontsizesIVobject needs to be made globalon eachprocessor. │ │ │ │ │ │ This methods takes the individual entries of an IV object whose owners are specified by the ownersIV │ │ │ │ │ │ - 8 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ object, and communicates the entries around the processors until the global IV object is present on │ │ │ │ │ │ each. The messagesthat will be sent require at most nprocconsecutive tags — the first is the parameter │ │ │ │ │ │ firsttag. │ │ │ │ │ │ Error checking: If iv, ownersIV or stats is NULL, or if firsttag < 0 or firsttag + nproc, is larger │ │ │ │ │ │ than the largest available tag, or if msglvl > 0 and msgFile is NULL, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 4. void IVL_MPI_allgather ( IVL *ivl, IV *ownersIV, int stats[], int msglvl, │ │ │ │ │ │ @@ -334,15 +334,15 @@ │ │ │ │ │ │ stats[4] — #ofsolution messages received │ │ │ │ │ │ stats[5] — #ofaggregatemessages received │ │ │ │ │ │ stats[6] — #ofsolution bytes received │ │ │ │ │ │ stats[7] — #ofaggregatebytes received │ │ │ │ │ │ Error checking: If frontmtx, mtxX,mtxB, mtxmanager,solvemap,cpusorstatsisNULL,oriffirsttag │ │ │ │ │ │ < 0 or firsttag + 2*nfront is larger than the largest available tag, or if msglvl > 0 and msgFile │ │ │ │ │ │ is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - MPI : DRAFT February 8, 2025 9 │ │ │ │ │ │ + MPI : DRAFT January 7, 2024 9 │ │ │ │ │ │ 1.2.7 Matrix-matrix multiply methods │ │ │ │ │ │ The usual sequence of events is as follows. │ │ │ │ │ │ • Set up the data structure via a call to MatMul MPI setup(). │ │ │ │ │ │ • Convert the local Aq matrix to local indices via a call to MatMul setLocalIndices(). │ │ │ │ │ │ • Compute the matrix-matrix multiply with a call to MatMul MPI mmm(). Inside this method, the MPI │ │ │ │ │ │ methods DenseMtx MPI gatherRows()and DenseMtx MPI scatterAddRows()are called, along with a │ │ │ │ │ │ serial InpMtx matrix-matrix multiply method. │ │ │ │ │ │ @@ -371,15 +371,15 @@ │ │ │ │ │ │ 2. void MatMul_setLocalIndices ( MatMulInfo *info, InpMtx *A ) ; │ │ │ │ │ │ void MatMul_setGlobalIndices ( MatMulInfo *info, InpMtx *A ) ; │ │ │ │ │ │ The first method maps the indices of A (which are assumed to be global) into local indices. The second │ │ │ │ │ │ method maps the indices of A (which are assumed to be local) back into global indices. It uses the │ │ │ │ │ │ XmapIV, XsupIV YmapIV and YsupIV objects that are contained in the info object. These are serial │ │ │ │ │ │ methods, performed independently on each processor. │ │ │ │ │ │ Error checking: If info or A is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 10 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ 3. void MatMul_MPI_mmm ( MatMulInfo *info, DenseMtx *Yloc, double alpha[], InpMtx *A, │ │ │ │ │ │ DenseMtx *Xloc, int stats[], int msglvl, FILE *msgFile, MPI_Comm comm) ; │ │ │ │ │ │ This method computes a distributed matrix-matrix multiply Y := Y + αAX, Y := Y + αATX or │ │ │ │ │ │ H │ │ │ │ │ │ Y := Y +αA X, depending on how the info object was set up. NOTE: A must have local indices, │ │ │ │ │ │ use MatMul setLocalIndices() to convert from global to local indices. Xloc and Yloc contain the │ │ │ │ │ │ owned rows of X and Y, respectively. │ │ │ │ │ │ @@ -413,15 +413,15 @@ │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ 4. IV * IV_MPI_Bcast ( IV *obj, int root, │ │ │ │ │ │ int msglvl, FILE *msgFile, MPI_Comm comm ) ; │ │ │ │ │ │ This method is a broadcast method for an IV object. The root processor broadcasts its IV object to │ │ │ │ │ │ the other nodes and returns a pointer to its IV object. A node other than root, clears the data in its │ │ │ │ │ │ IV object, receives the IV object from the root and returns a pointer to it. │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ - MPI : DRAFT February 8, 2025 11 │ │ │ │ │ │ + MPI : DRAFT January 7, 2024 11 │ │ │ │ │ │ 1.2.9 Utility methods │ │ │ │ │ │ 1. IVL * InpMtx_MPI_fullAdjacency ( InpMtx *inpmtx, int stats[], │ │ │ │ │ │ int msglvl, FILE *msgFile, MPI_Comm comm ) ; │ │ │ │ │ │ IVL * Pencil_MPI_fullAdjacency ( Pencil *pencil, int stats[], │ │ │ │ │ │ int msglvl, FILE *msgFile, MPI_Comm comm ) ; │ │ │ │ │ │ These methods are used to return an IVL object that contains the full adjacency structure of the │ │ │ │ │ │ graph of the matrix or matrix pencil. The matrix or matrix pencil is distributed among the processes, │ │ │ │ │ │ @@ -458,15 +458,15 @@ │ │ │ │ │ │ IVL_MPI_alltoall ( IVL *sendIVL, IVL *recvIVL, int stats[], int msglvl, │ │ │ │ │ │ FILE *msgFile, int firsttag, MPI_Comm comm ) ; │ │ │ │ │ │ This method is used during the setup for matrix-vector multiplies. Each processor has computed │ │ │ │ │ │ the vertices it needs from other processors, these lists are contained in sendIVL. On return, recvIVL │ │ │ │ │ │ contains the lists of vertices this processor must send to all others. │ │ │ │ │ │ This method uses tags in the range [tag,tag+nproc-1). On return, the following statistics will have │ │ │ │ │ │ been added. │ │ │ │ │ │ - 12 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ stats[0] — #ofmessagessent stats[1] — #ofbytessent │ │ │ │ │ │ stats[2] — #ofmessagesreceived stats[3] — #ofbytesreceived │ │ │ │ │ │ This method is safe in the sense that it uses only MPI Sendrecv(). │ │ │ │ │ │ Error checking: If sendIVL or stats is NULL, or if msglvl > 0 and msgFile is NULL, or if tag < 0 │ │ │ │ │ │ or tag + nproc is larger than the largest available tag, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 5. void * makeSendRecvIVLs ( IV *supportedIV, IV *globalmapIV, IVL *sendIVL, IVL *recvIVL, │ │ │ │ │ │ @@ -497,15 +497,15 @@ │ │ │ │ │ │ the matrix, factoring the matrix, and solving the system. Use the script file do AllInOne for testing. │ │ │ │ │ │ The files names for the matrix and right hand side entries are hardcoded. Processor q reads in matrix │ │ │ │ │ │ entries from file matrix.q.input and right hand side entries from file rhs.q.input. The format for │ │ │ │ │ │ the matrix files is as follows: │ │ │ │ │ │ neqns neqns nent │ │ │ │ │ │ irow jcol entry │ │ │ │ │ │ ... ... ... │ │ │ │ │ │ - MPI : DRAFT February 8, 2025 13 │ │ │ │ │ │ + MPI : DRAFT January 7, 2024 13 │ │ │ │ │ │ where neqns is the global number of equations and nent is the number of entries in this file. There │ │ │ │ │ │ follows nent lines, each containing a row index, a column index and one or two floating point numbers, │ │ │ │ │ │ one if real, two if complex. The format for the right hand side file is similar: │ │ │ │ │ │ nrow nrhs │ │ │ │ │ │ irow entry ... entry │ │ │ │ │ │ ... ... ... ... │ │ │ │ │ │ where nrow is the number of rows in this file and nrhs is the number of rigght and sides. There follows │ │ │ │ │ │ @@ -540,15 +540,15 @@ │ │ │ │ │ │ one if real, two if complex. The format for the right hand side file is similar: │ │ │ │ │ │ nrow nrhs │ │ │ │ │ │ irow entry ... entry │ │ │ │ │ │ ... ... ... ... │ │ │ │ │ │ where nrow is the number of rows in this file and nrhs is the number of rigght and sides. There follows │ │ │ │ │ │ nrow lines, each containing a row index and either nrhs or 2*nrhs floating point numbers, the first if │ │ │ │ │ │ real, the second if complex. Use the script file do patchAndGo for testing. │ │ │ │ │ │ - 14 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 14 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ • The msglvlparameterdetermines the amount of output. Use msglvl = 1 for just timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • The type parameter specifies a real or complex linear system. │ │ │ │ │ │ – type = 1 (SPOOLES REAL) for real, │ │ │ │ │ │ – type = 2 (SPOOLES COMPLEX) for complex. │ │ │ │ │ │ • The symmetryflag parameter specifies the symmetry of the matrix. │ │ │ │ │ │ @@ -582,15 +582,15 @@ │ │ │ │ │ │ • The type parameter specifies whether the linear system is real (type = 1) or complex (type = │ │ │ │ │ │ 2). │ │ │ │ │ │ • nrow is the number of rows in X. │ │ │ │ │ │ • ncol is the number of columns in X. │ │ │ │ │ │ • inc1 is the row increment for X. │ │ │ │ │ │ • inc2 is the column increment for X. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ - MPI : DRAFT February 8, 2025 15 │ │ │ │ │ │ + MPI : DRAFT January 7, 2024 15 │ │ │ │ │ │ 4. testGraph_Bcast msglvl msgFile type nvtx nitem root seed │ │ │ │ │ │ This driver program tests the distributed Graph MPI Bcast() method. Processor root generates a │ │ │ │ │ │ random graph of type type (see the documentation for the Graph object in chapter ??) with nvtx │ │ │ │ │ │ vertices. The random graph is constructed via an InpMtx object using nitem edges. Processor root │ │ │ │ │ │ then sends its Graph object to the other processors. Each processor computes a checksum for its object, │ │ │ │ │ │ and the error are collected on processor 0. Use the script file do Graph Bcast for testing. │ │ │ │ │ │ • The msglvlparameterdetermines the amount of output. Use msglvl = 1 for just timing output. │ │ │ │ │ │ @@ -625,15 +625,15 @@ │ │ │ │ │ │ • The n3 parameter is the number of grid points in the third direction. │ │ │ │ │ │ • The maxzeros parameter is the maximum number of zero entries allowed in a front. │ │ │ │ │ │ • The maxsize parameter is the maximum number of internal rows and columns allowed in a front. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ • The type parameter specifies whether the linear system is real or complex. Use 1 for real and 2 │ │ │ │ │ │ for complex. │ │ │ │ │ │ • The symmetryflag parameter denotes the presence or absence of symmetry. │ │ │ │ │ │ - 16 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 16 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ – Use 0 for a real or complex symmetric matrix A. A (UT + I)D(I + U) factorization is │ │ │ │ │ │ computed. │ │ │ │ │ │ – Use 1 for a complex Hermitian matrix A. A (UH +I)D(I +U) factorization is computed. │ │ │ │ │ │ – Use 2 for a real or complex nonsymmetric matrix A. A (L + I)D(I + U) factorization is │ │ │ │ │ │ computed. │ │ │ │ │ │ • The sparsityflag parameter denotes a direct or approximate factorization. Valid values are 0 │ │ │ │ │ │ for a direct factorization and 1 is for an approximate factorization. │ │ │ │ │ │ @@ -671,15 +671,15 @@ │ │ │ │ │ │ IVL object with nproc lists. List iproc contains a set of ids of items that this processor will receive │ │ │ │ │ │ from processor iproc. The processors then call IVL MPI allgather to create their “send” IVL object, │ │ │ │ │ │ where list iproc contains a set of ids of items that this processor will send to processor iproc. The set │ │ │ │ │ │ of lists in all the “receive” IVL objects is exactly the same as the set of lists in all the “send” objects. │ │ │ │ │ │ This is an “all-to-all” scatter/gather operation. Had the lists be stored contiguously or at least in one │ │ │ │ │ │ block of storage, we could have used the MPI Alltoallv() method. │ │ │ │ │ │ Use the script file do IVL alltoall for testing. │ │ │ │ │ │ - MPI : DRAFT February 8, 2025 17 │ │ │ │ │ │ + MPI : DRAFT January 7, 2024 17 │ │ │ │ │ │ • The msglvlparameterdetermines the amount of output. Use msglvl = 1 for just timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • The n parameter is an upper bound on list size and element value. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ 8. testIVL_allgather msglvl msgFile nlist seed │ │ │ │ │ │ This driver program tests the distributed IVL MPI allgather() method. Each processor generates │ │ │ │ │ │ @@ -716,15 +716,15 @@ │ │ │ │ │ │ local coordinates. The matrix-matrix multiply is computed, and then all the Yq local matrices are │ │ │ │ │ │ gathered onto processor zero into Y , which is then compared with Z that was computed using a serial │ │ │ │ │ │ matrix-matrix multiply. The error is written to the message file by processor zero. Use the script file │ │ │ │ │ │ do MMM for testing. │ │ │ │ │ │ • The msglvlparameterdetermines the amount of output. Use msglvl = 1 for just timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ - 18 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 18 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ • The nrowA parameter is the number of rows in A. │ │ │ │ │ │ • The ncolA parameter is the number of columns in A. │ │ │ │ │ │ • The nentA parameter is the number of entries to be put into A. │ │ │ │ │ │ • The nrowX parameter is the number of rows in X. │ │ │ │ │ │ • The coordTypeparameter defines the coordinate type that will be used during the redistribution. │ │ │ │ │ │ Valid values are 1 for rows, 2 for columns and 3 for chevrons. │ │ │ │ │ │ • The inputMode parameter defines the mode of input. Valid values are 1 for real entries and 2 for │ │ │ │ │ │ @@ -759,15 +759,15 @@ │ │ │ │ │ │ This driver program tests the distributed InpMtx MPI splitFromGlobal() method to split a InpMtx │ │ │ │ │ │ sparse matrix object. Process root reads in the InpMtx object. A random map is generated (the same │ │ │ │ │ │ maponall processes) and the object is scattered from processor root to the other processors. Use the │ │ │ │ │ │ script file do ScatterInpMtx for testing. │ │ │ │ │ │ • The msglvlparameterdetermines the amount of output. Use msglvl = 1 for just timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ - MPI : DRAFT February 8, 2025 19 │ │ │ │ │ │ + MPI : DRAFT January 7, 2024 19 │ │ │ │ │ │ • The neqns parameter is the number of equations for the matrix. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ • The coordTypeparameter defines the coordinate type that will be used during the redistribution. │ │ │ │ │ │ Valid values are 1 for rows, 2 for columns and 3 for chevrons. │ │ │ │ │ │ • The inputMode parameter defines the mode of input. Valid values are 0 for indices only, 1 for │ │ │ │ │ │ real entries and 2 for complex entries. │ │ │ │ │ │ • The inInpMtxFile parameter is the name of the file that contain the InpMtx object. │ │ │ │ │ │ @@ -802,15 +802,15 @@ │ │ │ │ │ │ • The inputMode parameter defines the mode of input. Valid values are 0 for indices only, 1 for │ │ │ │ │ │ real entries and 2 for complex entries. │ │ │ │ │ │ • The inInpMtxFile parameter is the name of the file that contain the InpMtx object. │ │ │ │ │ │ 15. testSymbFac msglvl msgFile inGraphFile inETreeFile seed │ │ │ │ │ │ This driver program tests the distributed SymbFac MPI initFromInpMtx() method that forms a IVL │ │ │ │ │ │ object that contains the necessary parts of a symbolic factorization for each processor. The pro- │ │ │ │ │ │ gram reads in the global Graph and ETree objects. Each processor creates a global InpMtx object │ │ │ │ │ │ - 20 MPI : DRAFT February 8, 2025 │ │ │ │ │ │ + 20 MPI : DRAFT January 7, 2024 │ │ │ │ │ │ from the structure of the graph and computes a global symbolic factorization object using the serial │ │ │ │ │ │ SymbFac initFromInpMtx() method. The processors then compute a map from fronts to processors, │ │ │ │ │ │ and each processor throws away the unowned matrix entries from the InpMtx object. The processors │ │ │ │ │ │ then compute their necessary symbolic factorizations in parallel. For a check, they compare the two │ │ │ │ │ │ symbolic factorizations for error. Use the script file do symbfac for testing. │ │ │ │ │ │ • The msglvlparameterdetermines the amount of output. Use msglvl = 1 for just timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ ├── ./usr/share/doc/spooles-doc/MSMD.ps.gz │ │ │ │ ├── MSMD.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o MSMD.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1228,21 +1228,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1426,88 +1425,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5202,26 +5196,26 @@ │ │ │ │ │ 51 3[51 51 4[51 1[51 51 51 3[51 13[51 5[51 3[51 4[51 │ │ │ │ │ 68[{}15 99.6264 /CMTT12 rf /Fc 131[112 1[50 59 59 1[59 │ │ │ │ │ 62 44 44 46 1[62 56 62 93 31 1[34 31 62 56 34 51 62 50 │ │ │ │ │ 62 54 11[86 5[84 5[42 3[74 2[80 7[31 4[56 56 56 56 56 │ │ │ │ │ 2[31 33[62 12[{}37 99.6264 /CMBX12 rf /Fd 134[71 2[71 │ │ │ │ │ 75 52 53 55 1[75 67 75 112 2[41 37 75 67 41 61 75 60 │ │ │ │ │ 75 65 13[75 2[92 11[103 14[67 67 67 67 67 2[37 46[{}29 │ │ │ │ │ -119.552 /CMBX12 rf /Fe 134[48 3[51 2[36 12[40 2[51 45 │ │ │ │ │ -26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 90.9091 │ │ │ │ │ -/CMSL10 rf /Ff 141[39 12[39 16[39 14[39 69[{}4 74.7198 │ │ │ │ │ -/CMTT9 rf /Fg 133[34 41 41 55 41 1[30 30 30 1[43 38 43 │ │ │ │ │ -64 21 41 23 21 43 1[23 34 43 34 43 38 12[55 37[21 1[21 │ │ │ │ │ -31[43 12[{}27 74.7198 /CMR9 rf /Fh 206[30 49[{}1 49.8132 │ │ │ │ │ -/CMR6 rf /Fi 132[52 6[41 4[52 58 46[49 63[{}5 90.9091 │ │ │ │ │ -/CMBX10 rf /Fj 148[47 6[47 100[{}2 90.9091 /CMMI10 rf │ │ │ │ │ -/Fk 134[44 2[42 49 30 37 38 1[46 46 51 1[23 42 28 28 │ │ │ │ │ -46 42 1[42 46 42 42 46 12[65 1[66 11[59 62 69 2[68 6[28 │ │ │ │ │ -7[46 4[33 45[{}29 90.9091 /CMTI10 rf /Fl 206[35 49[{}1 │ │ │ │ │ -66.4176 /CMR8 rf │ │ │ │ │ +119.552 /CMBX12 rf /Fe 134[48 3[51 2[36 3[51 12[45 22[47 │ │ │ │ │ +15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 │ │ │ │ │ +rf /Ff 141[39 12[39 16[39 14[39 69[{}4 74.7198 /CMTT9 │ │ │ │ │ +rf /Fg 133[34 41 41 55 41 1[30 30 30 1[43 38 43 64 21 │ │ │ │ │ +41 23 21 43 1[23 34 43 34 43 38 12[55 37[21 1[21 31[43 │ │ │ │ │ +12[{}27 74.7198 /CMR9 rf /Fh 206[30 49[{}1 49.8132 /CMR6 │ │ │ │ │ +rf /Fi 132[52 6[41 4[52 58 46[49 63[{}5 90.9091 /CMBX10 │ │ │ │ │ +rf /Fj 148[47 6[47 100[{}2 90.9091 /CMMI10 rf /Fk 134[44 │ │ │ │ │ +2[42 49 30 37 38 1[46 46 51 1[23 42 28 28 46 42 1[42 │ │ │ │ │ +46 42 42 46 12[65 1[66 11[59 62 69 2[68 6[28 7[46 4[33 │ │ │ │ │ +45[{}29 90.9091 /CMTI10 rf /Fl 206[35 49[{}1 66.4176 │ │ │ │ │ +/CMR8 rf │ │ │ │ │ %DVIPSBitmapFont: Fm tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -5325,58 +5319,58 @@ │ │ │ │ │ 0 5230 1560 4 v 104 5284 a Fh(1)138 5316 y Fg(The)24 │ │ │ │ │ b Ff(ETree)g Fg(ob)t(ject)g(has)f(the)g Ff(Tree)h Fg(ob)t(ject)g(that)f │ │ │ │ │ (de\014nes)f(the)h(connectivit)n(y)g(of)h(the)e(fron)n(ts,)j(kno)n(ws)e │ │ │ │ │ (the)g(in)n(ternal)g(and)g(external)0 5407 y(size)k(of)f(eac)n(h)g │ │ │ │ │ (fron)n(t,)g(and)f(has)h(a)g(map)g(from)g(the)g(v)n(ertices)g(to)g(the) │ │ │ │ │ f(fron)n(ts.)1927 5656 y Fo(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1139 4 v │ │ │ │ │ -1321 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)h Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2762 100 V 0 399 a Fo(W)-8 b(e)32 b(in)m(tend)e(to)h(add) │ │ │ │ │ -f(more)g(priorities,)h(e.g.,)h(appro)m(ximate)g(de\014ciency)e(from)g │ │ │ │ │ -([)p Fi(?)q Fo(],)h([)p Fi(?)p Fo(])g(and)f([)p Fi(?)p │ │ │ │ │ -Fo(].)141 534 y(Cho)s(ose)37 b(a)h(priorit)m(y)-8 b(,)40 │ │ │ │ │ -b(then)d(sp)s(ecify)g(the)h(de\014nition)f(of)h(a)f Fk(step)p │ │ │ │ │ -Fo(,)j(ho)m(w)e(to)g(c)m(ho)s(ose)g(an)g(indep)s(enden)m(t)e(set)i(of)0 │ │ │ │ │ -647 y(v)m(ertices)32 b(to)g(eliminate)g(at)f(a)g(time.)42 │ │ │ │ │ -b(Then)29 b(pro)m(vide)i(a)g(map)f(from)g(eac)m(h)i(v)m(ertex)g(to)f │ │ │ │ │ -(the)g Fk(stage)g Fo(at)g(whic)m(h)f(it)i(will)0 760 │ │ │ │ │ -y(b)s(e)e(eliminated.)141 896 y(Presen)m(tly)40 b(there)f(is)h(one)f │ │ │ │ │ -(ordering)g(metho)s(d,)i Fn(MSMD)p 2001 896 29 4 v 33 │ │ │ │ │ -w(order\(\))p Fo(.)65 b(It)40 b(orders)e(the)i(v)m(ertices)h(b)m(y)e │ │ │ │ │ -Fk(stages)p Fo(,)j(i.e.)0 1009 y(v)m(ertices)32 b(in)f(stage)h │ │ │ │ │ -Fj(k)i Fo(will)d(b)s(e)g(ordered)f(b)s(efore)g(v)m(ertices)j(in)d │ │ │ │ │ -(stage)i Fj(k)24 b Fo(+)c(1.)43 b(Inside)30 b(eac)m(h)i │ │ │ │ │ -Fk(stage)f Fo(the)g(v)m(ertices)i(are)0 1122 y(ordered)28 │ │ │ │ │ -b(b)m(y)g Fk(steps)p Fo(.)40 b(A)m(t)29 b(eac)m(h)h(step)e(an)g(indep)s │ │ │ │ │ -(enden)m(t)f(set)h(of)h(v)m(ertices)g(is)f(eliminated,)i(and)e(the)g(c) │ │ │ │ │ -m(hoice)i(is)e(based)0 1235 y(on)35 b(their)h(priorities.)56 │ │ │ │ │ -b(When)35 b(the)h(ordering)f(is)g(\014nished)f(one)i(can)f(extract)i(p) │ │ │ │ │ -s(erm)m(utation)f(v)m(ectors)h(of)e(a)h(fron)m(t)0 1348 │ │ │ │ │ -y(tree.)141 1484 y(Here)22 b(are)f(three)h(examples)g(of)f(ho)m(w)g │ │ │ │ │ -(stages)i(de\014ne)d(an)h(ordering)g(metho)s(d.)37 b(\(These)22 │ │ │ │ │ -b(metho)s(ds)e(are)i(supp)s(orted)0 1596 y(b)m(y)30 b(the)h(presen)m(t) │ │ │ │ │ -f Fn(MSMD)f Fo(ob)5 b(ject\).)137 1797 y Fm(\210)45 b │ │ │ │ │ -Fo(Set)d(the)g(stage)h(of)e(eac)m(h)i(v)m(ertex)g(to)f(b)s(e)f(zero)h │ │ │ │ │ -(and)f(w)m(e)h(ha)m(v)m(e)h(a)e(simple)h(minim)m(um)f(degree)h │ │ │ │ │ -(\(priorit)m(y\))227 1910 y(ordering.)137 2094 y Fm(\210)j │ │ │ │ │ -Fo(Giv)m(en)30 b(a)g(domain/Sc)m(h)m(ur)f(complemen)m(t)i(partition)e │ │ │ │ │ -(or)h(a)f(domain/separator)i(tree,)f(w)m(e)g(can)f(\014nd)f(a)i(m)m │ │ │ │ │ -(ul-)227 2207 y(tisection)h(ordering)e(b)m(y)g(setting)h(the)f(stage)h │ │ │ │ │ -(of)f(a)h(v)m(ertex)g(to)g(b)s(e)e(zero)i(if)f(it)g(is)g(a)h(domain)f │ │ │ │ │ -(or)f(one)i(if)f(it)g(is)g(in)227 2320 y(a)i(separator.)137 │ │ │ │ │ -2503 y Fm(\210)45 b Fo(Giv)m(en)g(a)f(domain/separator)h(tree,)k(w)m(e) │ │ │ │ │ -44 b(can)g(\014nd)f(an)h(incomplete)h(nested)f(dissection)g(ordering)g │ │ │ │ │ -(b)m(y)227 2616 y(sp)s(ecifying)30 b(the)h(stage)h(of)e(a)h(v)m(ertex)h │ │ │ │ │ -(to)f(b)s(e)f(the)g(lev)m(el)i(of)f(the)f(separator)h(or)g(domain)f │ │ │ │ │ -(that)h(con)m(tains)g(it.)0 2817 y(Here)g(are)g(three)f(sligh)m(tly)i │ │ │ │ │ -(more)e(complicated)j(examples.)137 3018 y Fm(\210)45 │ │ │ │ │ -b Fo(Order)34 b(the)h(v)m(ertices)h(in)f(the)g(domains,)h(then)e(order) │ │ │ │ │ -h(the)g(Sc)m(h)m(ur)f(complemen)m(t)i(graph)e(b)s(oth)g(b)m(y)h(nested) │ │ │ │ │ -227 3131 y(dissection)27 b(and)f(minim)m(um)g(degree,)i(and)e(then)g │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1158 4 v │ │ │ │ │ +1340 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2742 100 V 0 399 a Fo(W)-8 b(e)32 b(in)m(tend)e(to)h(add)f(more)g │ │ │ │ │ +(priorities,)h(e.g.,)h(appro)m(ximate)g(de\014ciency)e(from)g([)p │ │ │ │ │ +Fi(?)q Fo(],)h([)p Fi(?)p Fo(])g(and)f([)p Fi(?)p Fo(].)141 │ │ │ │ │ +534 y(Cho)s(ose)37 b(a)h(priorit)m(y)-8 b(,)40 b(then)d(sp)s(ecify)g │ │ │ │ │ +(the)h(de\014nition)f(of)h(a)f Fk(step)p Fo(,)j(ho)m(w)e(to)g(c)m(ho)s │ │ │ │ │ +(ose)g(an)g(indep)s(enden)m(t)e(set)i(of)0 647 y(v)m(ertices)32 │ │ │ │ │ +b(to)g(eliminate)g(at)f(a)g(time.)42 b(Then)29 b(pro)m(vide)i(a)g(map)f │ │ │ │ │ +(from)g(eac)m(h)i(v)m(ertex)g(to)f(the)g Fk(stage)g Fo(at)g(whic)m(h)f │ │ │ │ │ +(it)i(will)0 760 y(b)s(e)e(eliminated.)141 896 y(Presen)m(tly)40 │ │ │ │ │ +b(there)f(is)h(one)f(ordering)g(metho)s(d,)i Fn(MSMD)p │ │ │ │ │ +2001 896 29 4 v 33 w(order\(\))p Fo(.)65 b(It)40 b(orders)e(the)i(v)m │ │ │ │ │ +(ertices)h(b)m(y)e Fk(stages)p Fo(,)j(i.e.)0 1009 y(v)m(ertices)32 │ │ │ │ │ +b(in)f(stage)h Fj(k)i Fo(will)d(b)s(e)g(ordered)f(b)s(efore)g(v)m │ │ │ │ │ +(ertices)j(in)d(stage)i Fj(k)24 b Fo(+)c(1.)43 b(Inside)30 │ │ │ │ │ +b(eac)m(h)i Fk(stage)f Fo(the)g(v)m(ertices)i(are)0 1122 │ │ │ │ │ +y(ordered)28 b(b)m(y)g Fk(steps)p Fo(.)40 b(A)m(t)29 │ │ │ │ │ +b(eac)m(h)h(step)e(an)g(indep)s(enden)m(t)f(set)h(of)h(v)m(ertices)g │ │ │ │ │ +(is)f(eliminated,)i(and)e(the)g(c)m(hoice)i(is)e(based)0 │ │ │ │ │ +1235 y(on)35 b(their)h(priorities.)56 b(When)35 b(the)h(ordering)f(is)g │ │ │ │ │ +(\014nished)f(one)i(can)f(extract)i(p)s(erm)m(utation)f(v)m(ectors)h │ │ │ │ │ +(of)e(a)h(fron)m(t)0 1348 y(tree.)141 1484 y(Here)22 │ │ │ │ │ +b(are)f(three)h(examples)g(of)f(ho)m(w)g(stages)i(de\014ne)d(an)h │ │ │ │ │ +(ordering)g(metho)s(d.)37 b(\(These)22 b(metho)s(ds)e(are)i(supp)s │ │ │ │ │ +(orted)0 1596 y(b)m(y)30 b(the)h(presen)m(t)f Fn(MSMD)f │ │ │ │ │ +Fo(ob)5 b(ject\).)137 1797 y Fm(\210)45 b Fo(Set)d(the)g(stage)h(of)e │ │ │ │ │ +(eac)m(h)i(v)m(ertex)g(to)f(b)s(e)f(zero)h(and)f(w)m(e)h(ha)m(v)m(e)h │ │ │ │ │ +(a)e(simple)h(minim)m(um)f(degree)h(\(priorit)m(y\))227 │ │ │ │ │ +1910 y(ordering.)137 2094 y Fm(\210)j Fo(Giv)m(en)30 │ │ │ │ │ +b(a)g(domain/Sc)m(h)m(ur)f(complemen)m(t)i(partition)e(or)h(a)f │ │ │ │ │ +(domain/separator)i(tree,)f(w)m(e)g(can)f(\014nd)f(a)i(m)m(ul-)227 │ │ │ │ │ +2207 y(tisection)h(ordering)e(b)m(y)g(setting)h(the)f(stage)h(of)f(a)h │ │ │ │ │ +(v)m(ertex)g(to)g(b)s(e)e(zero)i(if)f(it)g(is)g(a)h(domain)f(or)f(one)i │ │ │ │ │ +(if)f(it)g(is)g(in)227 2320 y(a)i(separator.)137 2503 │ │ │ │ │ +y Fm(\210)45 b Fo(Giv)m(en)g(a)f(domain/separator)h(tree,)k(w)m(e)44 │ │ │ │ │ +b(can)g(\014nd)f(an)h(incomplete)h(nested)f(dissection)g(ordering)g(b)m │ │ │ │ │ +(y)227 2616 y(sp)s(ecifying)30 b(the)h(stage)h(of)e(a)h(v)m(ertex)h(to) │ │ │ │ │ +f(b)s(e)f(the)g(lev)m(el)i(of)f(the)f(separator)h(or)g(domain)f(that)h │ │ │ │ │ +(con)m(tains)g(it.)0 2817 y(Here)g(are)g(three)f(sligh)m(tly)i(more)e │ │ │ │ │ +(complicated)j(examples.)137 3018 y Fm(\210)45 b Fo(Order)34 │ │ │ │ │ +b(the)h(v)m(ertices)h(in)f(the)g(domains,)h(then)e(order)h(the)g(Sc)m │ │ │ │ │ +(h)m(ur)f(complemen)m(t)i(graph)e(b)s(oth)g(b)m(y)h(nested)227 │ │ │ │ │ +3131 y(dissection)27 b(and)f(minim)m(um)g(degree,)i(and)e(then)g │ │ │ │ │ (splice)h(the)f(b)s(etter)h(of)f(the)h(t)m(w)m(o)g(orderings)f │ │ │ │ │ (together)i(with)227 3244 y(the)j(ordering)f(of)g(the)h(domain)f(v)m │ │ │ │ │ (ertices.)137 3427 y Fm(\210)45 b Fo(Apply)30 b(the)h(ab)s(o)m(v)m(e)g │ │ │ │ │ (algorithm)h(to)f(the)f(Sc)m(h)m(ur)g(complemen)m(t)i(graph)d(recursiv) │ │ │ │ │ m(ely)-8 b(.)137 3611 y Fm(\210)45 b Fo(Since)31 b(m)m(ultisection)h │ │ │ │ │ (is)e(nothing)g(more)h(than)f(applying)g(minim)m(um)f(degree)i(to)h │ │ │ │ │ (the)e(Sc)m(h)m(ur)g(complemen)m(t)227 3724 y(graph,)e(randomly)e(p)s │ │ │ │ │ @@ -5396,17 +5390,17 @@ │ │ │ │ │ (ob)5 b(ject.)137 5294 y Fm(\210)45 b Fn(MSMDinfo)25 │ │ │ │ │ b Fo(:)39 b(an)27 b(ob)5 b(ject)28 b(that)f(comm)m(unicate)i(parameter) │ │ │ │ │ f(c)m(hoices)g(from)f(the)g(caller)h(to)g(the)f Fn(MSMD)f │ │ │ │ │ Fo(ob)5 b(ject)227 5407 y(and)30 b(information)h(and)e(statistics)k │ │ │ │ │ (from)d(the)g Fn(MSMD)f Fo(ob)5 b(ject)32 b(to)f(the)f(caller.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1139 4 v 1320 100 a Fn(MSMD)29 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2714 100 V 1139 w Fo(3)137 399 y Fm(\210)45 b Fn(MSMDstageInfo)25 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1158 4 v 1339 100 a Fn(MSMD)30 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2695 100 V 1158 w Fo(3)137 399 y Fm(\210)45 b Fn(MSMDstageInfo)25 │ │ │ │ │ b Fo(:)40 b(an)28 b(ob)5 b(ject)29 b(that)g(con)m(tains)h(statistics)g │ │ │ │ │ (for)e(a)h(stage)h(of)e(elimination,)i(e.g.,)h(n)m(um)m(b)s(er)c(of)227 │ │ │ │ │ 511 y(steps,)k(n)m(um)m(b)s(er)e(of)h(v)m(ertices)i(eliminated,)g(w)m │ │ │ │ │ (eigh)m(t)g(of)f(v)m(ertices)h(eliminated,)f(etc.)137 │ │ │ │ │ 702 y Fm(\210)45 b Fn(MSMDvtx)29 b Fo(:)40 b(an)31 b(ob)5 │ │ │ │ │ b(ject)31 b(that)g(mo)s(dels)f(a)h(v)m(ertex.)0 917 y(A)f(user)g(needs) │ │ │ │ │ g(to)h(understand)e(the)h Fn(MSMDinfo)e Fo(ob)5 b(ject,)32 │ │ │ │ │ @@ -5466,22 +5460,22 @@ │ │ │ │ │ (ultiple)f(minim)m(um)e(degree.)330 5294 y Fi({)45 b │ │ │ │ │ Fn(stepType)h(>)h(1)22 b Fo(|)g(an)g(indep)s(enden)m(t)f(set)i(of)f(v)m │ │ │ │ │ (ertices)i(is)e(eliminated)i(whose)e(priorities)g(lie)h(b)s(et)m(w)m │ │ │ │ │ (een)427 5407 y(the)31 b(minim)m(um)e(priorit)m(y)i(and)f(the)h(minim)m │ │ │ │ │ (um)e(priorit)m(y)i(m)m(ultiplied)g(b)m(y)f Fn(stepType)p │ │ │ │ │ Fo(.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1139 4 v │ │ │ │ │ -1321 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)h Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2762 100 V 227 399 a Fo(The)f(default)h(v)-5 │ │ │ │ │ -b(alue)31 b(is)f Fn(1)p Fo(,)g(m)m(ultiple)h(elimination)h(of)f(v)m │ │ │ │ │ -(ertices)h(with)e(minim)m(um)f(priorit)m(y)-8 b(.)137 │ │ │ │ │ -625 y Fm(\210)45 b Fn(int)i(seed)26 b Fo(|)g(a)h(seed)g(used)f(for)h(a) │ │ │ │ │ -g(random)f(n)m(um)m(b)s(er)f(generator,)k(this)e(in)m(tro)s(duces)f(a)i │ │ │ │ │ -(necessary)f(random)227 738 y(elemen)m(t)32 b(to)f(the)g(ordering.)137 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1158 4 v │ │ │ │ │ +1340 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2742 100 V 227 399 a Fo(The)f(default)h(v)-5 b(alue)31 │ │ │ │ │ +b(is)f Fn(1)p Fo(,)g(m)m(ultiple)h(elimination)h(of)f(v)m(ertices)h │ │ │ │ │ +(with)e(minim)m(um)f(priorit)m(y)-8 b(.)137 625 y Fm(\210)45 │ │ │ │ │ +b Fn(int)i(seed)26 b Fo(|)g(a)h(seed)g(used)f(for)h(a)g(random)f(n)m │ │ │ │ │ +(um)m(b)s(er)f(generator,)k(this)e(in)m(tro)s(duces)f(a)i(necessary)f │ │ │ │ │ +(random)227 738 y(elemen)m(t)32 b(to)f(the)g(ordering.)137 │ │ │ │ │ 964 y Fm(\210)45 b Fn(int)i(msglvl)33 b Fo({)i(message)g(lev)m(el)h │ │ │ │ │ (for)e(statistics,)k(diagnostics)e(and)d(monitoring.)54 │ │ │ │ │ b(The)33 b(default)i(v)-5 b(alue)35 b(is)227 1077 y(zero,)28 │ │ │ │ │ b(no)e(statistics.)41 b(Set)26 b Fn(msglvl)e Fo(to)j(one)f(and)f(get)i │ │ │ │ │ (elimination)g(monitoring.)40 b(Increase)26 b Fn(msglvl)e │ │ │ │ │ Fo(slo)m(wly)227 1190 y(to)31 b(get)h(more)e(mostly)h(debug)f │ │ │ │ │ (information.)137 1416 y Fm(\210)45 b Fn(FILE)i(*msgFile)28 │ │ │ │ │ @@ -5521,17 +5515,17 @@ │ │ │ │ │ Fo(ob)5 b(jects)31 b(that)g(represen)m(t)g(the)f(v)m(ertices.)137 │ │ │ │ │ 5181 y Fm(\210)45 b Fn(IV)i(ivtmpIV)29 b Fo({)i Fn(IV)e │ │ │ │ │ Fo(ob)5 b(ject)32 b(that)f(holds)e(an)i(in)m(teger)g(temp)s(orary)f(v)m │ │ │ │ │ (ector.)137 5407 y Fm(\210)45 b Fn(IV)i(reachIV)29 b │ │ │ │ │ Fo({)i Fn(IV)e Fo(ob)5 b(ject)32 b(that)f(holds)e(the)i(reac)m(h)g(v)m │ │ │ │ │ (ector.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1139 4 v 1320 100 a Fn(MSMD)29 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2714 100 V 1139 w Fo(5)0 399 y Fc(1.1.3)112 b Fb(MSMDstageInfo)41 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1158 4 v 1339 100 a Fn(MSMD)30 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2695 100 V 1158 w Fo(5)0 399 y Fc(1.1.3)112 b Fb(MSMDstageInfo)41 │ │ │ │ │ b Fc(:)50 b(statistics)38 b(ob)6 b(ject)37 b(for)h(a)f(stage)h(of)g │ │ │ │ │ (the)f(elimination)0 596 y Fo(This)30 b(ob)5 b(ject)31 │ │ │ │ │ b(stores)g(information)f(ab)s(out)g(the)h(elimination)h(pro)s(cess)e │ │ │ │ │ (at)h(a)g(stage)g(of)g(the)f(elimination.)137 838 y Fm(\210)45 │ │ │ │ │ b Fn(int)i(nstep)29 b Fo(|)h(n)m(um)m(b)s(er)f(of)i(elimination)h │ │ │ │ │ (steps)e(in)g(this)g(stage)137 1028 y Fm(\210)45 b Fn(int)i(nfront)29 │ │ │ │ │ b Fo(|)h(n)m(um)m(b)s(er)f(of)i(fron)m(ts)f(created)h(at)h(this)e │ │ │ │ │ @@ -5573,25 +5567,25 @@ │ │ │ │ │ h(\(priorit)m(y\))h(heap)330 5112 y Fi({)45 b Fn('R')30 │ │ │ │ │ b Fo({)h(v)m(ertex)g(on)f(reac)m(h)h(set)330 5260 y Fi({)45 │ │ │ │ │ b Fn('I')30 b Fo({)h(v)m(ertex)g(found)e(to)i(b)s(e)f │ │ │ │ │ (indistinguishable)g(to)h(another)330 5407 y Fi({)45 │ │ │ │ │ b Fn('B')30 b Fo({)h(b)s(oundary)d(v)m(ertex,)k(to)f(b)s(e)e │ │ │ │ │ (eliminated)j(in)e(another)h(stage)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1139 4 v │ │ │ │ │ -1321 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)h Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2762 100 V 137 399 a Fm(\210)45 b Fn(int)i(stage)29 │ │ │ │ │ -b Fo(|)h(stage)i(of)f(the)f(v)m(ertex.)42 b(Stage)32 │ │ │ │ │ -b(0)e(no)s(des)g(are)h(eliminated)g(b)s(efore)f(stage)i(1)f(no)s(des,)e │ │ │ │ │ -(etc.)137 581 y Fm(\210)45 b Fn(int)i(wght)29 b Fo(|)i(w)m(eigh)m(t)g │ │ │ │ │ -(of)g(the)g(v)m(ertex)137 763 y Fm(\210)45 b Fn(int)i(nadj)29 │ │ │ │ │ -b Fo(|)i(size)g(of)f(the)h Fn(adj)e Fo(v)m(ector)137 │ │ │ │ │ -945 y Fm(\210)45 b Fn(int)i(*adj)27 b Fo(|)i(for)f(an)g(uneliminated)g │ │ │ │ │ -(v)m(ertex,)j Fn(adj)c Fo(p)s(oin)m(ts)h(to)h(a)g(list)g(of)g(unco)m(v) │ │ │ │ │ -m(ered)g(adjacen)m(t)g(edges;)h(for)227 1058 y(an)e(eliminated)g(v)m │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1158 4 v │ │ │ │ │ +1340 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2742 100 V 137 399 a Fm(\210)45 b Fn(int)i(stage)29 b │ │ │ │ │ +Fo(|)h(stage)i(of)f(the)f(v)m(ertex.)42 b(Stage)32 b(0)e(no)s(des)g │ │ │ │ │ +(are)h(eliminated)g(b)s(efore)f(stage)i(1)f(no)s(des,)e(etc.)137 │ │ │ │ │ +581 y Fm(\210)45 b Fn(int)i(wght)29 b Fo(|)i(w)m(eigh)m(t)g(of)g(the)g │ │ │ │ │ +(v)m(ertex)137 763 y Fm(\210)45 b Fn(int)i(nadj)29 b │ │ │ │ │ +Fo(|)i(size)g(of)f(the)h Fn(adj)e Fo(v)m(ector)137 945 │ │ │ │ │ +y Fm(\210)45 b Fn(int)i(*adj)27 b Fo(|)i(for)f(an)g(uneliminated)g(v)m │ │ │ │ │ +(ertex,)j Fn(adj)c Fo(p)s(oin)m(ts)h(to)h(a)g(list)g(of)g(unco)m(v)m │ │ │ │ │ +(ered)g(adjacen)m(t)g(edges;)h(for)227 1058 y(an)e(eliminated)g(v)m │ │ │ │ │ (ertex,)i Fn(adj)d Fo(p)s(oin)m(ts)g(p)s(oin)m(ts)g(to)i(a)f(list)g(of) │ │ │ │ │ g(its)f(b)s(oundary)f(v)m(ertices)j(\(only)f(v)-5 b(alid)28 │ │ │ │ │ b(when)f(the)227 1171 y(v)m(ertex)32 b(is)e(a)h(leaf)g(of)g(the)f │ │ │ │ │ (elimination)i(tree)f(or)f(a)h(ro)s(ot)g(of)f(a)h(subtree)f(of)h │ │ │ │ │ (uneliminated)f(v)m(ertices\).)137 1353 y Fm(\210)45 │ │ │ │ │ b Fn(int)i(bndwght)29 b Fo(|)h(for)g(an)g(eliminated)i(v)m(ertex,)f │ │ │ │ │ (the)g(w)m(eigh)m(t)h(of)e(the)h(v)m(ertices)h(on)e(its)h(b)s(oundary) │ │ │ │ │ @@ -5640,17 +5634,17 @@ │ │ │ │ │ (a)h(call)g(to)g Fn(MSMDinfo)p 2440 5147 V 32 w(clearData\(\))d │ │ │ │ │ Fo(then)i(free's)g(the)g(storage)227 5260 y(for)h(the)h(structure)f │ │ │ │ │ (with)g(a)h(call)g(to)g Fn(free\(\))p Fo(.)227 5407 y │ │ │ │ │ Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b Fn(info)g │ │ │ │ │ Fo(is)g Fn(NULL)p Fo(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f │ │ │ │ │ (the)i(program)f(exits.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1139 4 v 1320 100 a Fn(MSMD)29 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2714 100 V 1139 w Fo(7)0 399 y Fc(1.2.2)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1158 4 v 1339 100 a Fn(MSMD)30 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2695 100 V 1158 w Fo(7)0 399 y Fc(1.2.2)112 b(Utilit)m(y)38 │ │ │ │ │ b(metho)s(ds)0 596 y Fo(There)30 b(are)h(t)m(w)m(o)g(utilit)m(y)h │ │ │ │ │ (metho)s(ds,)e(one)h(to)g(prin)m(t)f(the)g(ob)5 b(ject,)32 │ │ │ │ │ b(one)f(to)g(c)m(hec)m(k)h(to)f(see)g(if)f(it)h(is)f(v)-5 │ │ │ │ │ b(alid.)111 835 y(1.)46 b Fn(void)h(MSMDinfo_print)d(\()j(MSMDinfo)f │ │ │ │ │ (*info,)g(FILE)h(*fp)f(\))i(;)227 986 y Fo(This)30 b(metho)s(d)g(prin)m │ │ │ │ │ (ts)g(out)g(the)h(information)f(to)h(a)g(\014le.)227 │ │ │ │ │ 1137 y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ @@ -5703,25 +5697,25 @@ │ │ │ │ │ (a)g(call)i(to)e Fn(MSMD)p 2282 5143 V 34 w(clearData\(\))c │ │ │ │ │ Fo(then)k(free's)g(the)h(storage)g(for)227 5256 y(the)d(structure)f │ │ │ │ │ (with)g(a)h(call)g(to)g Fn(free\(\))p Fo(.)227 5407 y │ │ │ │ │ Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b Fn(msmd)g │ │ │ │ │ Fo(is)g Fn(NULL)p Fo(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f │ │ │ │ │ (the)i(program)f(exits.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1139 4 v │ │ │ │ │ -1321 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)h Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2762 100 V 0 399 a Fc(1.3.2)112 b(Initialization)39 │ │ │ │ │ -b(metho)s(ds)f(|)g(public)0 595 y Fo(There)30 b(is)g(one)h │ │ │ │ │ -(initialization)i(metho)s(d.)111 834 y(1.)46 b Fn(void)h(MSMD_init)e │ │ │ │ │ -(\()j(MSMD)e(*msmd,)g(Graph)h(*graph,)f(int)g(stages[],)g(MSMD)g(*info) │ │ │ │ │ -h(\))g(;)227 985 y Fo(This)35 b(metho)s(d)h(initializes)i(the)e │ │ │ │ │ -Fn(MSMD)f Fo(ob)5 b(ject)37 b(prior)e(to)i(an)e(ordering.)58 │ │ │ │ │ -b(It)36 b(is)g(called)h(b)m(y)f Fn(MSMD)p 3539 985 29 │ │ │ │ │ -4 v 33 w(order\(\))227 1098 y Fo(metho)s(d,)25 b(and)f(so)h(it)f(is)h │ │ │ │ │ -(curren)m(tly)f(a)h Fk(private)g Fo(metho)s(d)e(for)h(the)h(ob)5 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1158 4 v │ │ │ │ │ +1340 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2742 100 V 0 399 a Fc(1.3.2)112 b(Initialization)39 b(metho)s(ds)f(|)g │ │ │ │ │ +(public)0 595 y Fo(There)30 b(is)g(one)h(initialization)i(metho)s(d.) │ │ │ │ │ +111 834 y(1.)46 b Fn(void)h(MSMD_init)e(\()j(MSMD)e(*msmd,)g(Graph)h │ │ │ │ │ +(*graph,)f(int)g(stages[],)g(MSMD)g(*info)h(\))g(;)227 │ │ │ │ │ +985 y Fo(This)35 b(metho)s(d)h(initializes)i(the)e Fn(MSMD)f │ │ │ │ │ +Fo(ob)5 b(ject)37 b(prior)e(to)i(an)e(ordering.)58 b(It)36 │ │ │ │ │ +b(is)g(called)h(b)m(y)f Fn(MSMD)p 3539 985 29 4 v 33 │ │ │ │ │ +w(order\(\))227 1098 y Fo(metho)s(d,)25 b(and)f(so)h(it)f(is)h(curren)m │ │ │ │ │ +(tly)f(a)h Fk(private)g Fo(metho)s(d)e(for)h(the)h(ob)5 │ │ │ │ │ b(ject.)39 b(Ho)m(w)m(ev)m(er,)28 b(when)23 b(designing)i(more)227 │ │ │ │ │ 1211 y(complicated)34 b(ordering)e(metho)s(ds,)g(this)g(ob)5 │ │ │ │ │ b(ject)34 b(is)e(necessary)g(to)h(set)g(up)e(the)i(data)g(structures.) │ │ │ │ │ 45 b(There)227 1324 y(are)30 b(t)m(w)m(o)g(input)e(argumen)m(ts:)41 │ │ │ │ │ b Fn(graph)27 b Fo(is)i(a)h(p)s(oin)m(ter)f(to)h(a)f │ │ │ │ │ Fn(Graph)f Fo(ob)5 b(ject)30 b(that)g(holds)e(the)i(adjacency)f(lists) │ │ │ │ │ 227 1436 y(and)g(w)m(eigh)m(ts)h(of)g(the)f(v)m(ertices,)i(and)e │ │ │ │ │ @@ -5780,17 +5774,17 @@ │ │ │ │ │ Fo(,)e(this)h(metho)s(d)g(\014lls)g(the)g Fn(IV)f Fo(ob)5 │ │ │ │ │ b(ject)34 b(with)f(the)h(new-to-old)g(p)s(erm)m(utation)227 │ │ │ │ │ 5407 y(of)i(the)f(v)m(ertices,)j(resizing)e(the)f Fn(IV)g │ │ │ │ │ Fo(ob)5 b(ject)36 b(if)f(necessary)-8 b(.)56 b(If)34 │ │ │ │ │ b Fn(oldToNewIV)f Fo(is)i(not)g Fn(NULL)p Fo(,)f(this)h(metho)s(d)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1139 4 v 1320 100 a Fn(MSMD)29 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2714 100 V 1139 w Fo(9)227 399 y(\014lls)j(the)h Fn(IV)f │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1158 4 v 1339 100 a Fn(MSMD)30 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2695 100 V 1158 w Fo(9)227 399 y(\014lls)j(the)h Fn(IV)f │ │ │ │ │ Fo(ob)5 b(ject)35 b(with)f(the)g(old-to-new)i(p)s(erm)m(utation)e(of)h │ │ │ │ │ (the)f(v)m(ertices,)k(resizing)d(the)f Fn(IV)g Fo(ob)5 │ │ │ │ │ b(ject)35 b(if)227 511 y(necessary)-8 b(.)227 661 y Fk(Err)j(or)33 │ │ │ │ │ b(che)-5 b(cking:)40 b Fo(If)28 b Fn(msmd)g Fo(is)h Fn(NULL)p │ │ │ │ │ Fo(,)f(or)h(if)g Fn(newToOldIV)d Fo(and)j Fn(oldToNewIV)d │ │ │ │ │ Fo(is)j Fn(NULL)p Fo(,)f(an)h(error)g(message)227 774 │ │ │ │ │ y(is)i(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ @@ -5848,39 +5842,39 @@ │ │ │ │ │ 29 4 v 33 w(cleanSubtreeList\(\))37 b Fo(and)227 5258 │ │ │ │ │ y Fn(MSMD)p 425 5258 V 34 w(clearEdgeList\(\))p Fo(.)227 │ │ │ │ │ 5407 y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ b Fn(msmd)g Fo(or)g Fn(info)f Fo(is)i Fn(NULL)p Fo(,)e(an)h(error)g │ │ │ │ │ (message)i(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1116 4 │ │ │ │ │ -v 1298 w Fn(MSMD)30 b Fe(:)g Fk(DRAFT)g Fe(F)-8 b(ebruary)31 │ │ │ │ │ -b(8,)g(2025)p 2784 100 V 111 399 a Fo(6.)46 b Fn(void)h │ │ │ │ │ -(MSMD_cleanSubtreeList)42 b(\()47 b(MSMD)g(*msmd,)f(MSMDvtx)g(*v,)h │ │ │ │ │ -(MSMD)f(*info)h(\))g(;)227 547 y Fo(This)34 b(metho)s(d)h(cleans)h(the) │ │ │ │ │ -f(list)h(of)f(subtrees)f(for)h(v)m(ertex)h Fn(v)p Fo(,)g(remo)m(ving)g │ │ │ │ │ -(an)m(y)f(no)s(de)g(whic)m(h)f(is)h(no)g(longer)227 660 │ │ │ │ │ -y(the)c(ro)s(ot)g(of)f(a)h(subtree)f(of)g(eliminated)i(no)s(des.)227 │ │ │ │ │ -809 y Fk(Err)-5 b(or)30 b(che)-5 b(cking:)38 b Fo(If)25 │ │ │ │ │ -b Fn(msmd)p Fo(,)h Fn(v)f Fo(or)h Fn(info)e Fo(is)i Fn(NULL)p │ │ │ │ │ -Fo(,)f(an)g(error)h(message)h(is)e(prin)m(ted)g(and)h(the)f(program)h │ │ │ │ │ -(exits.)111 993 y(7.)46 b Fn(void)h(MSMD_cleanEdgeList)c(\()k(MSMD)g │ │ │ │ │ -(*msmd,)f(MSMDvtx)g(*v,)h(MSMD)f(*info)h(\))g(;)227 1141 │ │ │ │ │ -y Fo(This)29 b(metho)s(d)h(cleans)g(the)g(list)h(of)f(unco)m(v)m(ered)g │ │ │ │ │ -(edges)g(for)g(v)m(ertex)h Fn(v)p Fo(,)f(remo)m(ving)g(an)m(y)h(edge)f │ │ │ │ │ -Fn(\(v,w\))e Fo(where)227 1254 y Fn(v)i Fo(and)g Fn(w)g │ │ │ │ │ -Fo(share)g(a)h(common)g(adjacen)m(t)g(subtree.)227 1403 │ │ │ │ │ -y Fk(Err)-5 b(or)30 b(che)-5 b(cking:)38 b Fo(If)25 b │ │ │ │ │ -Fn(msmd)p Fo(,)h Fn(v)f Fo(or)h Fn(info)e Fo(is)i Fn(NULL)p │ │ │ │ │ -Fo(,)f(an)g(error)h(message)h(is)e(prin)m(ted)g(and)h(the)f(program)h │ │ │ │ │ -(exits.)111 1587 y(8.)46 b Fn(void)h(MSMD_update)e(\()i(MSMD)g(*msmd,)f │ │ │ │ │ -(MSMD)g(*info)h(\))g(;)227 1735 y Fo(This)30 b(metho)s(d)g(up)s(dates)f │ │ │ │ │ -(the)i(priorities)f(of)h(all)g(no)s(des)f(in)g(the)g(reac)m(h)i(set.) │ │ │ │ │ -227 1884 y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ -b Fn(msmd)g Fo(or)g Fn(info)f Fo(is)i Fn(NULL)p Fo(,)e(an)h(error)g │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1135 4 │ │ │ │ │ +v 1318 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)g Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2765 100 V 111 399 a Fo(6.)46 b Fn(void)h(MSMD_cleanSubtreeList)42 │ │ │ │ │ +b(\()47 b(MSMD)g(*msmd,)f(MSMDvtx)g(*v,)h(MSMD)f(*info)h(\))g(;)227 │ │ │ │ │ +547 y Fo(This)34 b(metho)s(d)h(cleans)h(the)f(list)h(of)f(subtrees)f │ │ │ │ │ +(for)h(v)m(ertex)h Fn(v)p Fo(,)g(remo)m(ving)g(an)m(y)f(no)s(de)g(whic) │ │ │ │ │ +m(h)f(is)h(no)g(longer)227 660 y(the)c(ro)s(ot)g(of)f(a)h(subtree)f(of) │ │ │ │ │ +g(eliminated)i(no)s(des.)227 809 y Fk(Err)-5 b(or)30 │ │ │ │ │ +b(che)-5 b(cking:)38 b Fo(If)25 b Fn(msmd)p Fo(,)h Fn(v)f │ │ │ │ │ +Fo(or)h Fn(info)e Fo(is)i Fn(NULL)p Fo(,)f(an)g(error)h(message)h(is)e │ │ │ │ │ +(prin)m(ted)g(and)h(the)f(program)h(exits.)111 993 y(7.)46 │ │ │ │ │ +b Fn(void)h(MSMD_cleanEdgeList)c(\()k(MSMD)g(*msmd,)f(MSMDvtx)g(*v,)h │ │ │ │ │ +(MSMD)f(*info)h(\))g(;)227 1141 y Fo(This)29 b(metho)s(d)h(cleans)g │ │ │ │ │ +(the)g(list)h(of)f(unco)m(v)m(ered)g(edges)g(for)g(v)m(ertex)h │ │ │ │ │ +Fn(v)p Fo(,)f(remo)m(ving)g(an)m(y)h(edge)f Fn(\(v,w\))e │ │ │ │ │ +Fo(where)227 1254 y Fn(v)i Fo(and)g Fn(w)g Fo(share)g(a)h(common)g │ │ │ │ │ +(adjacen)m(t)g(subtree.)227 1403 y Fk(Err)-5 b(or)30 │ │ │ │ │ +b(che)-5 b(cking:)38 b Fo(If)25 b Fn(msmd)p Fo(,)h Fn(v)f │ │ │ │ │ +Fo(or)h Fn(info)e Fo(is)i Fn(NULL)p Fo(,)f(an)g(error)h(message)h(is)e │ │ │ │ │ +(prin)m(ted)g(and)h(the)f(program)h(exits.)111 1587 y(8.)46 │ │ │ │ │ +b Fn(void)h(MSMD_update)e(\()i(MSMD)g(*msmd,)f(MSMD)g(*info)h(\))g(;) │ │ │ │ │ +227 1735 y Fo(This)30 b(metho)s(d)g(up)s(dates)f(the)i(priorities)f(of) │ │ │ │ │ +h(all)g(no)s(des)f(in)g(the)g(reac)m(h)i(set.)227 1884 │ │ │ │ │ +y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b │ │ │ │ │ +Fn(msmd)g Fo(or)g Fn(info)f Fo(is)i Fn(NULL)p Fo(,)e(an)h(error)g │ │ │ │ │ (message)i(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)111 │ │ │ │ │ 2068 y(9.)46 b Fn(int)h(MSMD_exactDegree2)c(\()48 b(MSMD)e(*msmd,)g │ │ │ │ │ (MSMDvtx)g(*v,)h(MSMD)g(*info)f(\))i(;)227 2217 y Fo(This)30 │ │ │ │ │ b(metho)s(d)g(computes)g(and)g(returns)f(the)i(exact)h(external)f │ │ │ │ │ (degree)g(for)f(v)m(ertex)i Fn(v)p Fo(.)227 2365 y Fk(Err)-5 │ │ │ │ │ b(or)30 b(che)-5 b(cking:)38 b Fo(If)25 b Fn(msmd)p Fo(,)h │ │ │ │ │ Fn(v)f Fo(or)h Fn(info)e Fo(is)i Fn(NULL)p Fo(,)f(an)g(error)h(message) │ │ │ │ │ @@ -5923,17 +5917,17 @@ │ │ │ │ │ b(metho)s(d)g(prin)m(ts)g(a)g(h)m(uman-readable)h(represen)m(tation)g │ │ │ │ │ (of)g(a)f(v)m(ertex,)i(used)e(for)g(debugging.)227 5407 │ │ │ │ │ y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b │ │ │ │ │ Fn(v)g Fo(or)h Fn(fp)f Fo(is)g Fn(NULL)p Fo(,)f(an)i(error)f(message)h │ │ │ │ │ (is)g(prin)m(ted)e(and)h(the)h(program)f(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1116 4 v 1298 100 a Fn(MSMD)29 │ │ │ │ │ -b Fe(:)h Fk(DRAFT)121 b Fe(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2692 100 V 1116 w Fo(11)0 399 y Fd(1.5)135 b(Driv)l(er)46 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1135 4 v 1317 100 a Fn(MSMD)29 │ │ │ │ │ +b Fe(:)h Fk(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2672 100 V 1135 w Fo(11)0 399 y Fd(1.5)135 b(Driv)l(er)46 │ │ │ │ │ b(programs)g(for)f(the)g Fa(MSMD)e Fd(ob)7 b(ject)0 631 │ │ │ │ │ y Fo(This)30 b(section)h(con)m(tains)h(brief)e(descriptions)g(of)g │ │ │ │ │ (four)g(driv)m(er)g(programs.)111 881 y(1.)46 b Fn(orderViaMMD)f │ │ │ │ │ (msglvl)h(msgFile)g(inGraphFile)f(seed)h(compressFlag)f(prioType)370 │ │ │ │ │ 994 y(stepType)h(outOldToNewIVfile)d(outNewToOldIVfile)g(outETreeFile) │ │ │ │ │ 227 1149 y Fo(This)28 b(driv)m(er)g(program)g(orders)f(a)i(graph)f │ │ │ │ │ (using)f(the)i(m)m(ultiple)g(minim)m(um)e(degree)i(algorithm)g(|)f │ │ │ │ │ @@ -5995,20 +5989,20 @@ │ │ │ │ │ Fn(IV)e Fo(ob)5 b(ject)40 b(that)f(con)m(tains)427 5294 │ │ │ │ │ y(the)34 b(old-to-new)h(p)s(erm)m(utation)f(v)m(ector.)52 │ │ │ │ │ b(If)34 b Fn(outOldToNewIVfile)29 b Fo(is)34 b Fn("none")p │ │ │ │ │ Fo(,)f(then)g(there)h(is)g(no)427 5407 y(output,)d(otherwise)f │ │ │ │ │ Fn(outOldToNewIVfile)c Fo(m)m(ust)k(b)s(e)g(of)g(the)h(form)f │ │ │ │ │ Fn(*.ivf)f Fo(or)h Fn(*.ivb)p Fo(.)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1116 │ │ │ │ │ -4 v 1298 w Fn(MSMD)30 b Fe(:)g Fk(DRAFT)g Fe(F)-8 b(ebruary)31 │ │ │ │ │ -b(8,)g(2025)p 2784 100 V 337 399 a Fm(\210)45 b Fo(The)38 │ │ │ │ │ -b Fn(outNewToOldIVfile)c Fo(parameter)39 b(is)f(the)h(output)f(\014le)h │ │ │ │ │ -(for)f(the)h Fn(IV)e Fo(ob)5 b(ject)40 b(that)f(con)m(tains)427 │ │ │ │ │ -511 y(the)34 b(new-to-old)h(p)s(erm)m(utation)f(v)m(ector.)52 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1135 │ │ │ │ │ +4 v 1318 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)g Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2765 100 V 337 399 a Fm(\210)45 b Fo(The)38 b Fn(outNewToOldIVfile)c │ │ │ │ │ +Fo(parameter)39 b(is)f(the)h(output)f(\014le)h(for)f(the)h │ │ │ │ │ +Fn(IV)e Fo(ob)5 b(ject)40 b(that)f(con)m(tains)427 511 │ │ │ │ │ +y(the)34 b(new-to-old)h(p)s(erm)m(utation)f(v)m(ector.)52 │ │ │ │ │ b(If)34 b Fn(outNewToOldIVfile)29 b Fo(is)34 b Fn("none")p │ │ │ │ │ Fo(,)f(then)g(there)h(is)g(no)427 624 y(output,)d(otherwise)f │ │ │ │ │ Fn(outNewToOldIVfile)c Fo(m)m(ust)k(b)s(e)g(of)g(the)h(form)f │ │ │ │ │ Fn(*.ivf)f Fo(or)h Fn(*.ivb)p Fo(.)337 770 y Fm(\210)45 │ │ │ │ │ b Fo(The)33 b Fn(outETreeFile)d Fo(parameter)j(is)g(the)h(output)f │ │ │ │ │ (\014le)g(for)g(the)g Fn(ETree)f Fo(ob)5 b(ject)34 b(that)f(con)m │ │ │ │ │ (tains)i(the)427 883 y(fron)m(t)23 b(tree)g(for)f(the)g(ordering.)38 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -21,15 +21,15 @@ │ │ │ │ │ │ • approximate external degree, (d from [?]) and [?], or │ │ │ │ │ │ ˜ │ │ │ │ │ │ • half external and half approximate, (d from [?]), or │ │ │ │ │ │ • a constant priority (to induce maximal independent set elimination). │ │ │ │ │ │ 1The ETree object has the Tree object that defines the connectivity of the fronts, knows the internal and external │ │ │ │ │ │ size of each front, and has a map from the vertices to the fronts. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 MSMD : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 MSMD : DRAFT January 7, 2024 │ │ │ │ │ │ We intend to add more priorities, e.g., approximate deficiency from [?], [?] and [?]. │ │ │ │ │ │ Choose a priority, then specify the definition of a step, how to choose an independent set of │ │ │ │ │ │ vertices to eliminate at a time. Then provide a map from each vertex to the stage at which it will │ │ │ │ │ │ be eliminated. │ │ │ │ │ │ Presently there is one ordering method, MSMD order(). It orders the vertices by stages, i.e. │ │ │ │ │ │ vertices in stage k will be ordered before vertices in stage k + 1. Inside each stage the vertices are │ │ │ │ │ │ ordered by steps. At each step an independent set of vertices is eliminated, and the choice is based │ │ │ │ │ │ @@ -57,15 +57,15 @@ │ │ │ │ │ │ The tools are largely written so any of these three algorithms can be prototyped in a small amount │ │ │ │ │ │ of time and effort. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ There are four typed objects. │ │ │ │ │ │ • MSMD : the main object. │ │ │ │ │ │ • MSMDinfo : an object that communicate parameter choices from the caller to the MSMD object │ │ │ │ │ │ and information and statistics from the MSMD object to the caller. │ │ │ │ │ │ - MSMD : DRAFT February 8, 2025 3 │ │ │ │ │ │ + MSMD : DRAFT January 7, 2024 3 │ │ │ │ │ │ • MSMDstageInfo : an object that contains statistics for a stage of elimination, e.g., number of │ │ │ │ │ │ steps, number of vertices eliminated, weight of vertices eliminated, etc. │ │ │ │ │ │ • MSMDvtx : an object that models a vertex. │ │ │ │ │ │ Auser needs to understand the MSMDinfo object, so this is where we will start our description. │ │ │ │ │ │ 1.1.1 MSMDinfo : define your algorithm │ │ │ │ │ │ • int compressFlag – define initial and subsequent compressions of the graph. │ │ │ │ │ │ Wecompress a graph using a checksum technique. At some point in the elimination, vertices │ │ │ │ │ │ @@ -93,15 +93,15 @@ │ │ │ │ │ │ • double stepType — define the elimination steps. │ │ │ │ │ │ – stepType == 0 — only one vertex of minimum priority is eliminated at each step, e.g., │ │ │ │ │ │ as used in SPARSPAK’s GENQMD, YSMP’s ordering, and AMD [?]. │ │ │ │ │ │ – stepType == 1 — an independent set of vertices of minimum priority is eliminated at │ │ │ │ │ │ each step, e.g., as used in GENMMD, multiple minimum degree. │ │ │ │ │ │ – stepType > 1—anindependentsetofvertices iseliminated whoseprioritieslie between │ │ │ │ │ │ the minimum priority and the minimum priority multiplied by stepType. │ │ │ │ │ │ - 4 MSMD : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 MSMD : DRAFT January 7, 2024 │ │ │ │ │ │ The default value is 1, multiple elimination of vertices with minimum priority. │ │ │ │ │ │ • int seed — a seed used for a random number generator, this introduces a necessary random │ │ │ │ │ │ element to the ordering. │ │ │ │ │ │ • int msglvl – message level for statistics, diagnostics and monitoring. The default value is │ │ │ │ │ │ zero, no statistics. Set msglvl to one and get elimination monitoring. Increase msglvl slowly │ │ │ │ │ │ to get more mostly debug information. │ │ │ │ │ │ • FILE *msgFile – message file, default is stdout. │ │ │ │ │ │ @@ -119,15 +119,15 @@ │ │ │ │ │ │ • IIheap *heap – pointer to a IIheap object that maintains the priority queue. │ │ │ │ │ │ • IP *baseIP – pointer to the base IP objects, used to hold subtree lists │ │ │ │ │ │ • IP *freeIP – pointer to the list of free IP objects │ │ │ │ │ │ • int incrIP – integer that holds the increment factor for the IP objects. │ │ │ │ │ │ • MSMDvtx *vertices – pointer to vector of MSMDvtx objects that represent the vertices. │ │ │ │ │ │ • IV ivtmpIV – IV object that holds an integer temporary vector. │ │ │ │ │ │ • IV reachIV – IV object that holds the reach vector. │ │ │ │ │ │ - MSMD : DRAFT February 8, 2025 5 │ │ │ │ │ │ + MSMD : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.1.3 MSMDstageInfo : statistics object for a stage of the elimination │ │ │ │ │ │ This object stores information about the elimination process at a stage of the elimination. │ │ │ │ │ │ • int nstep — number of elimination steps in this stage │ │ │ │ │ │ • int nfront — number of fronts created at this stage │ │ │ │ │ │ • int welim — weight of the vertices eliminated at this stage │ │ │ │ │ │ • int nfind — number of front indices │ │ │ │ │ │ • int nzf — number of factor entries (for a Cholesky factorization) │ │ │ │ │ │ @@ -148,15 +148,15 @@ │ │ │ │ │ │ – ’L’ – eliminated leaf vertex │ │ │ │ │ │ – ’E’ – eliminated interior vertex │ │ │ │ │ │ – ’O’ – outmatched vertex │ │ │ │ │ │ – ’D’ – vertex on degree (priority) heap │ │ │ │ │ │ – ’R’ – vertex on reach set │ │ │ │ │ │ – ’I’ – vertex found to be indistinguishable to another │ │ │ │ │ │ – ’B’ – boundary vertex, to be eliminated in another stage │ │ │ │ │ │ - 6 MSMD : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 MSMD : DRAFT January 7, 2024 │ │ │ │ │ │ • int stage — stage of the vertex. Stage 0 nodes are eliminated before stage 1 nodes, etc. │ │ │ │ │ │ • int wght — weight of the vertex │ │ │ │ │ │ • int nadj — size of the adj vector │ │ │ │ │ │ • int *adj — for an uneliminated vertex, adj points to a list of uncovered adjacent edges; for │ │ │ │ │ │ an eliminated vertex, adj points points to a list of its boundary vertices (only valid when the │ │ │ │ │ │ vertex is a leaf of the elimination tree or a root of a subtree of uneliminated vertices). │ │ │ │ │ │ • int bndwght — for an eliminated vertex, the weight of the vertices on its boundary. │ │ │ │ │ │ @@ -181,15 +181,15 @@ │ │ │ │ │ │ This method clears any data owned by the object and then sets the structure’s default fields │ │ │ │ │ │ with a call to MSMDinfo setDefaultFields(). │ │ │ │ │ │ Error checking: If info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void MSMDinfo_free ( MSMDinfo *info ) ; │ │ │ │ │ │ This method releases any storage by a call to MSMDinfo clearData() then free’s the storage │ │ │ │ │ │ for the structure with a call to free(). │ │ │ │ │ │ Error checking: If info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - MSMD : DRAFT February 8, 2025 7 │ │ │ │ │ │ + MSMD : DRAFT January 7, 2024 7 │ │ │ │ │ │ 1.2.2 Utility methods │ │ │ │ │ │ There are two utility methods, one to print the object, one to check to see if it is valid. │ │ │ │ │ │ 1. void MSMDinfo_print ( MSMDinfo *info, FILE *fp ) ; │ │ │ │ │ │ This method prints out the information to a file. │ │ │ │ │ │ Error checking: If info or fp is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. int MSMDinfo_isValid ( MSMDinfo *info ) ; │ │ │ │ │ │ This method checks that the object is valid. The return value is 1 for a valid object, 0 for an │ │ │ │ │ │ @@ -213,15 +213,15 @@ │ │ │ │ │ │ This method clears any data owned by the object, then sets the structure’s default fields with │ │ │ │ │ │ a call to MSMD setDefaultFields(). │ │ │ │ │ │ Error checking: If msmd is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void MSMD_free ( MSMD *msmd ) ; │ │ │ │ │ │ This method releases any storage by a call to MSMD clearData() then free’s the storage for │ │ │ │ │ │ the structure with a call to free(). │ │ │ │ │ │ Error checking: If msmd is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 8 MSMD : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 MSMD : DRAFT January 7, 2024 │ │ │ │ │ │ 1.3.2 Initialization methods — public │ │ │ │ │ │ There is one initialization method. │ │ │ │ │ │ 1. void MSMD_init ( MSMD *msmd, Graph *graph, int stages[], MSMD *info ) ; │ │ │ │ │ │ This method initializes the MSMD object prior to an ordering. It is called by MSMD order() │ │ │ │ │ │ method, and so it is currently a private method for the object. However, when designing more │ │ │ │ │ │ complicated ordering methods, this object is necessary to set up the data structures. There │ │ │ │ │ │ are two input arguments: graph is a pointer to a Graph object that holds the adjacency lists │ │ │ │ │ │ @@ -249,15 +249,15 @@ │ │ │ │ │ │ 1.3.4 Extraction methods — public │ │ │ │ │ │ There are two methods to extract the ordering. The first fills one or two IV objects with the │ │ │ │ │ │ permutation vector(s). The second returns an ETree object that holds the front tree for the │ │ │ │ │ │ ordering. │ │ │ │ │ │ 1. void MSMD_fillPerms ( MSMD *msmd, IV *newToOldIV, IV *oldToNewIV ) ; │ │ │ │ │ │ If newToOldIV is not NULL, this method fills the IV object with the new-to-old permutation │ │ │ │ │ │ of the vertices, resizing the IV object if necessary. If oldToNewIV is not NULL, this method │ │ │ │ │ │ - MSMD : DRAFT February 8, 2025 9 │ │ │ │ │ │ + MSMD : DRAFT January 7, 2024 9 │ │ │ │ │ │ fills the IV object with the old-to-new permutation of the vertices, resizing the IV object if │ │ │ │ │ │ necessary. │ │ │ │ │ │ Error checking: If msmd is NULL, or if newToOldIV and oldToNewIV is NULL, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 2. ETree * MSMD_frontETree ( MSMD *msmd ) ; │ │ │ │ │ │ This method constructs and returns a ETree object that contains the front tree for the │ │ │ │ │ │ ordering. │ │ │ │ │ │ @@ -283,15 +283,15 @@ │ │ │ │ │ │ The order of the nodes in the reach set may be permuted, but any indistinguishable nodes in │ │ │ │ │ │ the reach set are not purged from the reach set. │ │ │ │ │ │ Error checking: If msmd or info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 5. void MSMD_cleanReachSet ( MSMD *msmd, MSMD *info ) ; │ │ │ │ │ │ This method cleans the nodes in the reach set by calling MSMD cleanSubtreeList() and │ │ │ │ │ │ MSMD clearEdgeList(). │ │ │ │ │ │ Error checking: If msmd or info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 10 MSMD : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 MSMD : DRAFT January 7, 2024 │ │ │ │ │ │ 6. void MSMD_cleanSubtreeList ( MSMD *msmd, MSMDvtx *v, MSMD *info ) ; │ │ │ │ │ │ This method cleans the list of subtrees for vertex v, removing any node which is no longer │ │ │ │ │ │ the root of a subtree of eliminated nodes. │ │ │ │ │ │ Error checking: If msmd, v or info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 7. void MSMD_cleanEdgeList ( MSMD *msmd, MSMDvtx *v, MSMD *info ) ; │ │ │ │ │ │ This method cleans the list of uncovered edges for vertex v, removing any edge (v,w) where │ │ │ │ │ │ v and w share a common adjacent subtree. │ │ │ │ │ │ @@ -317,15 +317,15 @@ │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 1.4 Prototypes and descriptions of MSMDvtx methods │ │ │ │ │ │ TheMSMDvtxobject is private so would not normally be accessed by the user. There is one method │ │ │ │ │ │ to print out the object. │ │ │ │ │ │ 1. void MSMDvtx_print ( MSMDvtx *v, FILE *fp ) ; │ │ │ │ │ │ This method prints a human-readable representation of a vertex, used for debugging. │ │ │ │ │ │ Error checking: If v or fp is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - MSMD : DRAFT February 8, 2025 11 │ │ │ │ │ │ + MSMD : DRAFT January 7, 2024 11 │ │ │ │ │ │ 1.5 Driver programs for the MSMD object │ │ │ │ │ │ This section contains brief descriptions of four driver programs. │ │ │ │ │ │ 1. orderViaMMD msglvl msgFile inGraphFile seed compressFlag prioType │ │ │ │ │ │ stepType outOldToNewIVfile outNewToOldIVfile outETreeFile │ │ │ │ │ │ This driver program orders a graph using the multiple minimum degree algorithm — exactly │ │ │ │ │ │ which algorithm is controlled by the input parameters. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. │ │ │ │ │ │ @@ -355,15 +355,15 @@ │ │ │ │ │ │ SPARSPAK. │ │ │ │ │ │ – stepType == 1 — regular multiple elimination, e.g., GENMMD. │ │ │ │ │ │ – stepType > 1 — vertices whose priority lies between the minimum priority and │ │ │ │ │ │ stepType times the minimum priority are eligible for elimination at a step. │ │ │ │ │ │ • The outOldToNewIVfile parameter is the output file for the IV object that contains │ │ │ │ │ │ the old-to-new permutation vector. If outOldToNewIVfile is "none", then there is no │ │ │ │ │ │ output, otherwise outOldToNewIVfile must be of the form *.ivf or *.ivb. │ │ │ │ │ │ - 12 MSMD : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 MSMD : DRAFT January 7, 2024 │ │ │ │ │ │ • The outNewToOldIVfile parameter is the output file for the IV object that contains │ │ │ │ │ │ the new-to-old permutation vector. If outNewToOldIVfile is "none", then there is no │ │ │ │ │ │ output, otherwise outNewToOldIVfile must be of the form *.ivf or *.ivb. │ │ │ │ │ │ • The outETreeFile parameter is the output file for the ETree object that contains the │ │ │ │ │ │ front tree for the ordering. If outETreeFileis "none", then there is no output, otherwise │ │ │ │ │ │ outETreeFile must be of the form *.etreef or *.etreeb. │ │ │ │ │ │ 2. orderViaND msglvl msgFile inGraphFile inDSTreeFile seed compressFlag │ │ │ ├── ./usr/share/doc/spooles-doc/MT.ps.gz │ │ │ │ ├── MT.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o MT.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1600,21 +1600,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1798,88 +1797,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5014,16 +5008,16 @@ │ │ │ │ │ %EndDVIPSBitmapFont │ │ │ │ │ /Fd 133[50 59 59 1[59 62 44 44 46 1[62 56 62 93 31 2[31 │ │ │ │ │ 62 2[51 62 50 1[54 13[62 5[106 6[70 16[56 56 56 56 56 │ │ │ │ │ 2[31 37 45[{}29 99.6264 /CMBX12 rf /Fe 171[62 6[62 77[{}2 │ │ │ │ │ 119.552 /CMTT12 rf /Ff 134[71 2[71 75 52 53 55 1[75 67 │ │ │ │ │ 75 112 37 2[37 75 67 41 61 75 60 1[65 13[75 2[92 11[103 │ │ │ │ │ 16[67 67 67 2[37 46[{}26 119.552 /CMBX12 rf /Fg 134[44 │ │ │ │ │ -3[46 2[33 12[37 2[46 42 26[54 11[23 1[42 2[42 2[42 1[42 │ │ │ │ │ -3[23 44[{}13 83.022 /CMSL10 rf /Fh 136[55 1[45 28 34 │ │ │ │ │ +3[46 2[33 3[46 12[42 22[43 15[23 2[42 2[42 1[42 1[42 │ │ │ │ │ +3[23 44[{}12 83.022 /CMSL10 rf /Fh 136[55 1[45 28 34 │ │ │ │ │ 35 1[42 42 47 1[21 38 1[25 42 38 1[38 42 38 1[42 9[83 │ │ │ │ │ 2[59 1[61 11[54 56 63 2[62 6[25 58[{}25 83.022 /CMTI10 │ │ │ │ │ rf /Fi 133[44 44 44 44 44 44 44 44 44 44 44 44 44 44 │ │ │ │ │ 44 44 44 44 44 44 44 44 44 44 44 44 1[44 1[44 1[44 1[44 │ │ │ │ │ 44 44 44 44 44 44 44 44 44 44 44 44 44 1[44 44 44 44 │ │ │ │ │ 44 44 44 44 44 44 2[44 44 1[44 1[44 44 44 44 44 44 44 │ │ │ │ │ 44 44 44 44 44 1[44 1[44 44 44 40[{}72 83.022 /CMTT10 │ │ │ │ │ @@ -5147,19 +5141,19 @@ │ │ │ │ │ (ultithreaded)g(solv)n(e)f(metho)r(ds.)36 b(The)26 b(calling)f │ │ │ │ │ (sequences)g(b)r(et)n(w)n(een)0 5308 y(the)j(serial)f(and)g(m)n │ │ │ │ │ (ultithreaded)h(solv)n(es)e(di\013ers)i(b)n(y)f(one)h(parameter,)e(a)h │ │ │ │ │ Fi(SolveMap)e Fn(ob)5 b(ject)27 b(that)h(maps)g(the)g(submatrices)0 │ │ │ │ │ 5407 y(of)g(the)g(factor)e(matrix)h(to)h(the)g(threads)f(that)h(will)f │ │ │ │ │ (compute)h(with)g(them.)1929 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fn(2)p 125 100 1009 4 v │ │ │ │ │ -1174 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ -Fg(F)-7 b(ebruary)27 b(8,)g(2025)p 2892 100 V 0 390 a │ │ │ │ │ -Ff(1.1)135 b(Data)46 b(Structure)0 597 y Fn(There)23 │ │ │ │ │ -b(are)g(no)g(m)n(ultithreaded)h(sp)r(eci\014c)f(data)h(structures.)34 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 125 100 1026 4 v │ │ │ │ │ +1191 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)28 b │ │ │ │ │ +Fg(Jan)n(uary)d(7,)i(2024)p 2874 100 V 0 390 a Ff(1.1)135 │ │ │ │ │ +b(Data)46 b(Structure)0 597 y Fn(There)23 b(are)g(no)g(m)n │ │ │ │ │ +(ultithreaded)h(sp)r(eci\014c)f(data)h(structures.)34 │ │ │ │ │ b(See)24 b(the)g Fi(Lock)e Fn(ob)5 b(ject)23 b(whic)n(h)h(is)f(used)h │ │ │ │ │ (to)f(hide)h(the)g(particular)0 697 y(m)n(utual)k(exclusion)f(device)g │ │ │ │ │ (used)h(b)n(y)f(a)g(thread)g(library)-7 b(.)0 998 y Ff(1.2)135 │ │ │ │ │ b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g Fe(MT)f │ │ │ │ │ Ff(metho)t(ds)0 1205 y Fn(This)25 b(section)f(con)n(tains)g(brief)g │ │ │ │ │ (descriptions)g(including)h(protot)n(yp)r(es)f(of)g(all)h(metho)r(ds)g │ │ │ │ │ (found)g(in)g(the)g Fi(MT)f Fn(source)f(directory)-7 │ │ │ │ │ @@ -5265,17 +5259,17 @@ │ │ │ │ │ Fi(InpMtx)p 1939 5308 V 29 w(MT)p 2056 5308 V 31 w(nonsym)p │ │ │ │ │ 2351 5308 V 28 w(mmm\(A,)42 b(Y,)g(3.22,)g(X,)h(nthread,)d(msglvl,)208 │ │ │ │ │ 5407 y(msgFile\))p Fn(,)31 b(for)i(this)h(ma)n(y)f(result)g(in)h(a)f │ │ │ │ │ (segmen)n(tation)g(violation.)53 b(The)34 b(v)-5 b(alues)33 │ │ │ │ │ b(of)h Fm(\013)g Fn(m)n(ust)f(b)r(e)h(loaded)f(in)n(to)g(an)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 83 100 1009 4 v 1174 100 a Fi(Multithreaded)22 │ │ │ │ │ -b Fg(:)37 b Fh(DRAFT)111 b Fg(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2852 100 V 1009 w Fn(3)208 390 y(arra)n(y)d(of)i(length)h(1)f(or)f(2.) │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1026 4 v 1192 100 a Fi(Multithreaded)22 │ │ │ │ │ +b Fg(:)37 b Fh(DRAFT)110 b Fg(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2835 100 V 1026 w Fn(3)208 390 y(arra)n(y)d(of)i(length)h(1)f(or)f(2.) │ │ │ │ │ 36 b(The)27 b(n)n(um)n(b)r(er)f(of)g(threads)g(is)g(sp)r(eci\014ed)h(b) │ │ │ │ │ n(y)f(the)h Fi(nthread)d Fn(parameter;)h(if,)i Fi(nthread)d │ │ │ │ │ Fn(is)i Fi(1)p Fn(,)208 490 y(the)k(serial)e(metho)r(d)i(is)g(called.) │ │ │ │ │ 43 b(The)30 b Fi(msglvl)d Fn(and)j Fi(msgFile)c Fn(parameters)i(are)h │ │ │ │ │ (used)h(for)f(diagnostics)f(during)i(the)208 589 y(creation)c(of)i(the) │ │ │ │ │ g(threads')f(individual)g(data)g(structures.)208 722 │ │ │ │ │ y Fh(Err)l(or)k(che)l(cking:)43 b Fn(If)30 b Fi(A)p Fn(,)f │ │ │ │ │ @@ -5375,19 +5369,19 @@ │ │ │ │ │ (assem)n(bling)f(aggregate)f(fron)n(ts.)307 5142 y Fc(\210)42 │ │ │ │ │ b Fi(cpus[5])25 b Fn(|)j(time)g(sp)r(en)n(t)g(assem)n(bling)e(p)r(ostp) │ │ │ │ │ r(oned)i(data.)307 5274 y Fc(\210)42 b Fi(cpus[6])25 │ │ │ │ │ b Fn(|)j(time)g(sp)r(en)n(t)g(to)f(factor)g(the)h(fron)n(ts.)307 │ │ │ │ │ 5407 y Fc(\210)42 b Fi(cpus[7])25 b Fn(|)j(time)g(sp)r(en)n(t)g(to)f │ │ │ │ │ (extract)g(p)r(ostp)r(oned)h(data.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fn(4)p 125 100 1009 4 v │ │ │ │ │ -1174 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ -Fg(F)-7 b(ebruary)27 b(8,)g(2025)p 2892 100 V 307 390 │ │ │ │ │ -a Fc(\210)42 b Fi(cpus[8])25 b Fn(|)j(time)g(sp)r(en)n(t)g(to)f(store)g │ │ │ │ │ -(the)h(factor)e(en)n(tries.)307 524 y Fc(\210)42 b Fi(cpus[9])25 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 125 100 1026 4 v │ │ │ │ │ +1191 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)28 b │ │ │ │ │ +Fg(Jan)n(uary)d(7,)i(2024)p 2874 100 V 307 390 a Fc(\210)42 │ │ │ │ │ +b Fi(cpus[8])25 b Fn(|)j(time)g(sp)r(en)n(t)g(to)f(store)g(the)h │ │ │ │ │ +(factor)e(en)n(tries.)307 524 y Fc(\210)42 b Fi(cpus[9])25 │ │ │ │ │ b Fn(|)j(miscellaneous)e(time.)208 691 y(On)h(return,)g(the)h │ │ │ │ │ Fi(stats[])d Fn(v)n(ector)h(is)i(\014lled)g(with)g(the)g(follo)n(wing)e │ │ │ │ │ (information.)307 859 y Fc(\210)42 b Fi(stats[0])25 b │ │ │ │ │ Fn(|)i(n)n(um)n(b)r(er)h(of)f(piv)n(ots.)307 993 y Fc(\210)42 │ │ │ │ │ b Fi(stats[1])25 b Fn(|)i(n)n(um)n(b)r(er)h(of)f(piv)n(ot)g(tests.)307 │ │ │ │ │ 1126 y Fc(\210)42 b Fi(stats[2])25 b Fn(|)i(n)n(um)n(b)r(er)h(of)f │ │ │ │ │ (dela)n(y)n(ed)g(ro)n(ws)f(and)h(columns.)307 1260 y │ │ │ │ │ @@ -5456,17 +5450,17 @@ │ │ │ │ │ b Fm(I)7 b Fn(\))p Fm(D)r Fn(\()p Fm(I)24 b Fn(+)15 b │ │ │ │ │ Fm(U)9 b Fn(\))p Fm(X)30 b Fn(=)22 b Fm(B)31 b Fn(or)26 │ │ │ │ │ b(\()p Fm(L)15 b Fn(+)h Fm(I)7 b Fn(\))p Fm(D)r Fn(\()p │ │ │ │ │ Fm(I)24 b Fn(+)15 b Fm(U)9 b Fn(\))p Fm(X)30 b Fn(=)22 │ │ │ │ │ b Fm(B)t Fn(.)37 b(En)n(tries)25 b(of)h Fm(B)31 b Fn(are)25 │ │ │ │ │ b Fh(r)l(e)l(ad)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 83 100 1009 4 v 1174 100 a Fi(Multithreaded)22 │ │ │ │ │ -b Fg(:)37 b Fh(DRAFT)111 b Fg(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2852 100 V 1009 w Fn(5)208 390 y(from)k Fi(mtxB)g Fn(and)h(en)n(tries)g │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1026 4 v 1192 100 a Fi(Multithreaded)22 │ │ │ │ │ +b Fg(:)37 b Fh(DRAFT)110 b Fg(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2835 100 V 1026 w Fn(5)208 390 y(from)k Fi(mtxB)g Fn(and)h(en)n(tries)g │ │ │ │ │ (of)g Fm(X)39 b Fn(are)31 b(written)i(to)f Fi(mtxX)p │ │ │ │ │ Fn(.)e(Therefore,)j Fi(mtxX)d Fn(and)j Fi(mtxB)d Fn(can)i(b)r(e)h(the)g │ │ │ │ │ (same)e(ob)5 b(ject.)208 490 y(\(Note,)25 b(this)h(do)r(es)e(not)h │ │ │ │ │ (hold)g(true)g(for)f(an)h(MPI)f(factorization)g(with)h(piv)n(oting.\)) │ │ │ │ │ 36 b(The)25 b(submatrix)f(manager)f(ob)5 b(ject)208 589 │ │ │ │ │ y(manages)31 b(the)j(w)n(orking)d(storage.)51 b(The)33 │ │ │ │ │ b Fi(solvemap)d Fn(ob)5 b(ject)33 b(con)n(tains)f(the)h(map)g(from)g │ │ │ │ │ @@ -5546,100 +5540,100 @@ │ │ │ │ │ b(matrix,)h(factors)e Fm(A)h Fn(and)g(solv)n(es)e(the)i(linear)f │ │ │ │ │ (system)h Fm(AX)40 b Fn(=)33 b Fm(B)38 b Fn(for)c Fm(X)40 │ │ │ │ │ b Fn(using)34 b(m)n(ultithreaded)f(factors)g(and)208 │ │ │ │ │ 5407 y(solv)n(es.)i(Use)28 b(the)g(script)f(\014le)h │ │ │ │ │ Fi(do)p 1237 5407 27 4 v 30 w(gridMT)d Fn(for)i(testing.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fn(6)p 125 100 1009 4 v │ │ │ │ │ -1174 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ -Fg(F)-7 b(ebruary)27 b(8,)g(2025)p 2892 100 V 307 390 │ │ │ │ │ -a Fc(\210)42 b Fn(The)23 b Fi(msglvl)e Fn(parameter)g(determines)i(the) │ │ │ │ │ -h(amoun)n(t)e(of)h(output.)36 b(Use)23 b Fi(msglvl)41 │ │ │ │ │ -b(=)i(1)23 b Fn(for)g(just)g(timing)g(output.)307 524 │ │ │ │ │ -y Fc(\210)42 b Fn(The)32 b Fi(msgFile)c Fn(parameter)i(determines)h │ │ │ │ │ -(the)h(message)e(\014le)i(|)f(if)h Fi(msgFile)d Fn(is)i │ │ │ │ │ -Fi(stdout)p Fn(,)f(then)i(the)g(message)390 624 y(\014le)c(is)f │ │ │ │ │ -Fh(stdout)p Fn(,)h(otherwise)e(a)i(\014le)f(is)h(op)r(ened)f(with)i │ │ │ │ │ -Fh(app)l(end)g Fn(status)e(to)g(receiv)n(e)g(an)n(y)g(output)h(data.) │ │ │ │ │ -307 758 y Fc(\210)42 b Fn(The)28 b Fi(type)e Fn(parameter)g(sp)r │ │ │ │ │ -(eci\014es)h(a)h(real)e(or)h(complex)g(linear)g(system.)456 │ │ │ │ │ -892 y Fa({)41 b Fi(type)h(=)i(1)f(\(SPOOLES)p 1295 892 │ │ │ │ │ -27 4 v 28 w(REAL\))25 b Fn(for)i(real,)456 1009 y Fa({)41 │ │ │ │ │ -b Fi(type)h(=)i(2)f(\(SPOOLES)p 1295 1009 V 28 w(COMPLEX\))24 │ │ │ │ │ -b Fn(for)j(complex.)307 1143 y Fc(\210)42 b Fn(The)28 │ │ │ │ │ -b Fi(symmetryflag)23 b Fn(parameter)j(sp)r(eci\014es)h(the)h(symmetry)f │ │ │ │ │ -(of)h(the)g(matrix.)456 1278 y Fa({)41 b Fi(type)h(=)i(0)f(\(SPOOLES)p │ │ │ │ │ -1295 1278 V 28 w(SYMMETRIC\))23 b Fn(for)k Fm(A)h Fn(real)f(or)g │ │ │ │ │ -(complex)g(symmetric,)456 1394 y Fa({)41 b Fi(type)h(=)i(1)f(\(SPOOLES) │ │ │ │ │ -p 1295 1394 V 28 w(HERMITIAN\))23 b Fn(for)k Fm(A)h Fn(complex)g │ │ │ │ │ -(Hermitian,)456 1511 y Fa({)41 b Fi(type)h(=)i(2)f(\(SPOOLES)p │ │ │ │ │ -1295 1511 V 28 w(NONSYMMETRIC\))390 1645 y Fn(for)27 │ │ │ │ │ -b Fm(A)h Fn(real)f(or)g(complex)g(nonsymmetric.)307 1780 │ │ │ │ │ -y Fc(\210)42 b Fn(The)28 b Fi(pivotingflag)23 b Fn(parameter)j(signals) │ │ │ │ │ -g(whether)i(piv)n(oting)e(for)i(stabilit)n(y)f(will)h(b)r(e)g(enabled)f │ │ │ │ │ -(or)g(not.)456 1914 y Fa({)41 b Fn(If)28 b Fi(pivotingflag)39 │ │ │ │ │ -b(=)k(0)g(\(SPOOLES)p 1726 1914 V 29 w(NO)p 1843 1914 │ │ │ │ │ -V 30 w(PIVOTING\))p Fn(,)24 b(no)j(piv)n(oting)g(will)h(b)r(e)g(done.) │ │ │ │ │ -456 2031 y Fa({)41 b Fn(If)31 b Fi(pivotingflag)38 b(=)44 │ │ │ │ │ -b(1)f(\(SPOOLES)p 1729 2031 V 28 w(PIVOTING\))p Fn(,)26 │ │ │ │ │ -b(piv)n(oting)j(will)h(b)r(e)h(done)e(to)h(ensure)f(that)h(all)g(en)n │ │ │ │ │ -(tries)545 2130 y(in)e Fm(U)37 b Fn(and)27 b Fm(L)g Fn(ha)n(v)n(e)g │ │ │ │ │ -(magnitude)g(less)g(than)h Fi(tau)p Fn(.)307 2264 y Fc(\210)42 │ │ │ │ │ -b Fn(The)29 b Fi(matrixFileName)23 b Fn(parameter)28 │ │ │ │ │ -b(is)g(the)h(name)g(of)g(the)g(\014les)g(where)f(the)h(matrix)f(en)n │ │ │ │ │ -(tries)h(are)e(read)h(from.)390 2364 y(The)g(\014le)g(has)f(the)h │ │ │ │ │ -(follo)n(wing)e(structure.)390 2515 y Fi(neqns)42 b(neqns)f(nent)390 │ │ │ │ │ -2615 y(irow)h(jcol)g(entry)390 2715 y(...)86 b(...)g(...)390 │ │ │ │ │ -2866 y Fn(where)36 b Fi(neqns)e Fn(is)i(the)g(global)f(n)n(um)n(b)r(er) │ │ │ │ │ -h(of)g(equations)f(and)h Fi(nent)f Fn(is)h(the)g(n)n(um)n(b)r(er)g(of)g │ │ │ │ │ -(en)n(tries)f(in)h(this)h(\014le.)390 2966 y(There)c(follo)n(ws)f │ │ │ │ │ -Fi(nent)f Fn(lines,)j(eac)n(h)f(con)n(taining)f(a)g(ro)n(w)g(index,)i │ │ │ │ │ -(a)f(column)g(index)g(and)g(one)g(or)f(t)n(w)n(o)g(\015oating)390 │ │ │ │ │ -3065 y(p)r(oin)n(t)c(n)n(um)n(b)r(ers,)f(one)g(if)h(real,)f(t)n(w)n(o)g │ │ │ │ │ -(if)h(complex.)307 3200 y Fc(\210)42 b Fn(The)32 b Fi(rhsFileName)27 │ │ │ │ │ -b Fn(parameter)j(is)h(the)h(name)g(of)f(the)h(\014les)g(where)f(the)h │ │ │ │ │ -(righ)n(t)f(hand)g(side)h(en)n(tries)e(are)h(read)390 │ │ │ │ │ -3299 y(from.)37 b(The)27 b(\014le)h(has)f(the)h(follo)n(wing)f │ │ │ │ │ -(structure.)390 3451 y Fi(nrow)42 b(nrhs)390 3550 y(irow)g(entry)g(...) │ │ │ │ │ -g(entry)390 3650 y(...)86 b(...)130 b(...)42 b(...)390 │ │ │ │ │ -3801 y Fn(where)28 b Fi(nrow)g Fn(is)g(the)i(n)n(um)n(b)r(er)e(of)h(ro) │ │ │ │ │ -n(ws)e(in)i(this)g(\014le)g(and)g Fi(nrhs)e Fn(is)i(the)g(n)n(um)n(b)r │ │ │ │ │ -(er)g(of)f(riggh)n(t)g(and)g(sides.)41 b(There)390 3901 │ │ │ │ │ -y(follo)n(ws)23 b Fi(nrow)f Fn(lines,)j(eac)n(h)e(con)n(taining)f(a)i │ │ │ │ │ -(ro)n(w)e(index)i(and)g(either)f Fi(nrhs)f Fn(or)h Fi(2*nrhs)f │ │ │ │ │ -Fn(\015oating)h(p)r(oin)n(t)h(n)n(um)n(b)r(ers,)390 4001 │ │ │ │ │ -y(the)k(\014rst)g(if)g(real,)e(the)i(second)f(if)h(complex.)307 │ │ │ │ │ -4135 y Fc(\210)42 b Fn(The)28 b Fi(seed)e Fn(parameter)g(is)h(a)h │ │ │ │ │ -(random)e(n)n(um)n(b)r(er)i(seed.)307 4269 y Fc(\210)42 │ │ │ │ │ -b Fn(The)28 b Fi(nthread)d Fn(parameter)h(is)h(the)h(n)n(um)n(b)r(er)g │ │ │ │ │ -(of)f(threads.)101 4455 y(2.)42 b Fi(patchAndGoMT)c(msglvl)j(msgFile)g │ │ │ │ │ -(type)h(symmetryflag)d(patchAndGoFlag)e(fudge)42 b(toosmall)774 │ │ │ │ │ -4554 y(storeids)e(storevalues)f(matrixFileName)f(rhsFileName)h(seed)j │ │ │ │ │ -(nthread)208 4689 y Fn(This)18 b(driv)n(er)g(program)e(is)j(used)f(to)h │ │ │ │ │ -(test)g(the)g(\\patc)n(h-and-go")c(functionalit)n(y)k(for)f(a)g │ │ │ │ │ -(factorization)g(without)h(piv)n(oting.)208 4788 y(When)j(small)f │ │ │ │ │ -(diagonal)f(piv)n(ot)h(elemen)n(ts)h(are)f(found,)i(one)e(of)h(three)f │ │ │ │ │ -(actions)g(are)g(tak)n(en.)34 b(See)22 b(the)g Fi(PatchAndGoInfo)208 │ │ │ │ │ -4888 y Fn(ob)5 b(ject)27 b(for)g(more)g(information.)208 │ │ │ │ │ -5022 y(The)33 b(program)e(reads)g(in)j(a)e(matrix)h Fm(A)g │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 125 100 1026 4 v │ │ │ │ │ +1191 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)28 b │ │ │ │ │ +Fg(Jan)n(uary)d(7,)i(2024)p 2874 100 V 307 390 a Fc(\210)42 │ │ │ │ │ +b Fn(The)23 b Fi(msglvl)e Fn(parameter)g(determines)i(the)h(amoun)n(t)e │ │ │ │ │ +(of)h(output.)36 b(Use)23 b Fi(msglvl)41 b(=)i(1)23 b │ │ │ │ │ +Fn(for)g(just)g(timing)g(output.)307 524 y Fc(\210)42 │ │ │ │ │ +b Fn(The)32 b Fi(msgFile)c Fn(parameter)i(determines)h(the)h(message)e │ │ │ │ │ +(\014le)i(|)f(if)h Fi(msgFile)d Fn(is)i Fi(stdout)p Fn(,)f(then)i(the)g │ │ │ │ │ +(message)390 624 y(\014le)c(is)f Fh(stdout)p Fn(,)h(otherwise)e(a)i │ │ │ │ │ +(\014le)f(is)h(op)r(ened)f(with)i Fh(app)l(end)g Fn(status)e(to)g │ │ │ │ │ +(receiv)n(e)g(an)n(y)g(output)h(data.)307 758 y Fc(\210)42 │ │ │ │ │ +b Fn(The)28 b Fi(type)e Fn(parameter)g(sp)r(eci\014es)h(a)h(real)e(or)h │ │ │ │ │ +(complex)g(linear)g(system.)456 892 y Fa({)41 b Fi(type)h(=)i(1)f │ │ │ │ │ +(\(SPOOLES)p 1295 892 27 4 v 28 w(REAL\))25 b Fn(for)i(real,)456 │ │ │ │ │ +1009 y Fa({)41 b Fi(type)h(=)i(2)f(\(SPOOLES)p 1295 1009 │ │ │ │ │ +V 28 w(COMPLEX\))24 b Fn(for)j(complex.)307 1143 y Fc(\210)42 │ │ │ │ │ +b Fn(The)28 b Fi(symmetryflag)23 b Fn(parameter)j(sp)r(eci\014es)h(the) │ │ │ │ │ +h(symmetry)f(of)h(the)g(matrix.)456 1278 y Fa({)41 b │ │ │ │ │ +Fi(type)h(=)i(0)f(\(SPOOLES)p 1295 1278 V 28 w(SYMMETRIC\))23 │ │ │ │ │ +b Fn(for)k Fm(A)h Fn(real)f(or)g(complex)g(symmetric,)456 │ │ │ │ │ +1394 y Fa({)41 b Fi(type)h(=)i(1)f(\(SPOOLES)p 1295 1394 │ │ │ │ │ +V 28 w(HERMITIAN\))23 b Fn(for)k Fm(A)h Fn(complex)g(Hermitian,)456 │ │ │ │ │ +1511 y Fa({)41 b Fi(type)h(=)i(2)f(\(SPOOLES)p 1295 1511 │ │ │ │ │ +V 28 w(NONSYMMETRIC\))390 1645 y Fn(for)27 b Fm(A)h Fn(real)f(or)g │ │ │ │ │ +(complex)g(nonsymmetric.)307 1780 y Fc(\210)42 b Fn(The)28 │ │ │ │ │ +b Fi(pivotingflag)23 b Fn(parameter)j(signals)g(whether)i(piv)n(oting)e │ │ │ │ │ +(for)i(stabilit)n(y)f(will)h(b)r(e)g(enabled)f(or)g(not.)456 │ │ │ │ │ +1914 y Fa({)41 b Fn(If)28 b Fi(pivotingflag)39 b(=)k(0)g(\(SPOOLES)p │ │ │ │ │ +1726 1914 V 29 w(NO)p 1843 1914 V 30 w(PIVOTING\))p Fn(,)24 │ │ │ │ │ +b(no)j(piv)n(oting)g(will)h(b)r(e)g(done.)456 2031 y │ │ │ │ │ +Fa({)41 b Fn(If)31 b Fi(pivotingflag)38 b(=)44 b(1)f(\(SPOOLES)p │ │ │ │ │ +1729 2031 V 28 w(PIVOTING\))p Fn(,)26 b(piv)n(oting)j(will)h(b)r(e)h │ │ │ │ │ +(done)e(to)h(ensure)f(that)h(all)g(en)n(tries)545 2130 │ │ │ │ │ +y(in)e Fm(U)37 b Fn(and)27 b Fm(L)g Fn(ha)n(v)n(e)g(magnitude)g(less)g │ │ │ │ │ +(than)h Fi(tau)p Fn(.)307 2264 y Fc(\210)42 b Fn(The)29 │ │ │ │ │ +b Fi(matrixFileName)23 b Fn(parameter)28 b(is)g(the)h(name)g(of)g(the)g │ │ │ │ │ +(\014les)g(where)f(the)h(matrix)f(en)n(tries)h(are)e(read)h(from.)390 │ │ │ │ │ +2364 y(The)g(\014le)g(has)f(the)h(follo)n(wing)e(structure.)390 │ │ │ │ │ +2515 y Fi(neqns)42 b(neqns)f(nent)390 2615 y(irow)h(jcol)g(entry)390 │ │ │ │ │ +2715 y(...)86 b(...)g(...)390 2866 y Fn(where)36 b Fi(neqns)e │ │ │ │ │ +Fn(is)i(the)g(global)f(n)n(um)n(b)r(er)h(of)g(equations)f(and)h │ │ │ │ │ +Fi(nent)f Fn(is)h(the)g(n)n(um)n(b)r(er)g(of)g(en)n(tries)f(in)h(this)h │ │ │ │ │ +(\014le.)390 2966 y(There)c(follo)n(ws)f Fi(nent)f Fn(lines,)j(eac)n(h) │ │ │ │ │ +f(con)n(taining)f(a)g(ro)n(w)g(index,)i(a)f(column)g(index)g(and)g(one) │ │ │ │ │ +g(or)f(t)n(w)n(o)g(\015oating)390 3065 y(p)r(oin)n(t)c(n)n(um)n(b)r │ │ │ │ │ +(ers,)f(one)g(if)h(real,)f(t)n(w)n(o)g(if)h(complex.)307 │ │ │ │ │ +3200 y Fc(\210)42 b Fn(The)32 b Fi(rhsFileName)27 b Fn(parameter)j(is)h │ │ │ │ │ +(the)h(name)g(of)f(the)h(\014les)g(where)f(the)h(righ)n(t)f(hand)g │ │ │ │ │ +(side)h(en)n(tries)e(are)h(read)390 3299 y(from.)37 b(The)27 │ │ │ │ │ +b(\014le)h(has)f(the)h(follo)n(wing)f(structure.)390 │ │ │ │ │ +3451 y Fi(nrow)42 b(nrhs)390 3550 y(irow)g(entry)g(...)g(entry)390 │ │ │ │ │ +3650 y(...)86 b(...)130 b(...)42 b(...)390 3801 y Fn(where)28 │ │ │ │ │ +b Fi(nrow)g Fn(is)g(the)i(n)n(um)n(b)r(er)e(of)h(ro)n(ws)e(in)i(this)g │ │ │ │ │ +(\014le)g(and)g Fi(nrhs)e Fn(is)i(the)g(n)n(um)n(b)r(er)g(of)f(riggh)n │ │ │ │ │ +(t)g(and)g(sides.)41 b(There)390 3901 y(follo)n(ws)23 │ │ │ │ │ +b Fi(nrow)f Fn(lines,)j(eac)n(h)e(con)n(taining)f(a)i(ro)n(w)e(index)i │ │ │ │ │ +(and)g(either)f Fi(nrhs)f Fn(or)h Fi(2*nrhs)f Fn(\015oating)h(p)r(oin)n │ │ │ │ │ +(t)h(n)n(um)n(b)r(ers,)390 4001 y(the)k(\014rst)g(if)g(real,)e(the)i │ │ │ │ │ +(second)f(if)h(complex.)307 4135 y Fc(\210)42 b Fn(The)28 │ │ │ │ │ +b Fi(seed)e Fn(parameter)g(is)h(a)h(random)e(n)n(um)n(b)r(er)i(seed.) │ │ │ │ │ +307 4269 y Fc(\210)42 b Fn(The)28 b Fi(nthread)d Fn(parameter)h(is)h │ │ │ │ │ +(the)h(n)n(um)n(b)r(er)g(of)f(threads.)101 4455 y(2.)42 │ │ │ │ │ +b Fi(patchAndGoMT)c(msglvl)j(msgFile)g(type)h(symmetryflag)d │ │ │ │ │ +(patchAndGoFlag)e(fudge)42 b(toosmall)774 4554 y(storeids)e │ │ │ │ │ +(storevalues)f(matrixFileName)f(rhsFileName)h(seed)j(nthread)208 │ │ │ │ │ +4689 y Fn(This)18 b(driv)n(er)g(program)e(is)j(used)f(to)h(test)g(the)g │ │ │ │ │ +(\\patc)n(h-and-go")c(functionalit)n(y)k(for)f(a)g(factorization)g │ │ │ │ │ +(without)h(piv)n(oting.)208 4788 y(When)j(small)f(diagonal)f(piv)n(ot)h │ │ │ │ │ +(elemen)n(ts)h(are)f(found,)i(one)e(of)h(three)f(actions)g(are)g(tak)n │ │ │ │ │ +(en.)34 b(See)22 b(the)g Fi(PatchAndGoInfo)208 4888 y │ │ │ │ │ +Fn(ob)5 b(ject)27 b(for)g(more)g(information.)208 5022 │ │ │ │ │ +y(The)33 b(program)e(reads)g(in)j(a)e(matrix)h Fm(A)g │ │ │ │ │ Fn(and)g(righ)n(t)f(hand)h(side)g Fm(B)t Fn(,)i(generates)c(the)j │ │ │ │ │ (graph)e(for)g Fm(A)h Fn(and)g(orders)f(the)208 5122 │ │ │ │ │ y(matrix,)27 b(factors)f Fm(A)i Fn(and)g(solv)n(es)e(the)i(linear)f │ │ │ │ │ (system)g Fm(AX)j Fn(=)23 b Fm(B)31 b Fn(for)d Fm(X)34 │ │ │ │ │ b Fn(using)27 b(m)n(ultithreaded)g(factors)g(and)g(solv)n(es.)208 │ │ │ │ │ 5221 y(Use)g(the)h(script)f(\014le)h Fi(do)p 968 5221 │ │ │ │ │ V 31 w(patchAndGo)23 b Fn(for)k(testing.)307 5407 y Fc(\210)42 │ │ │ │ │ b Fn(The)23 b Fi(msglvl)e Fn(parameter)g(determines)i(the)h(amoun)n(t)e │ │ │ │ │ (of)h(output.)36 b(Use)23 b Fi(msglvl)41 b(=)i(1)23 b │ │ │ │ │ Fn(for)g(just)g(timing)g(output.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 83 100 1009 4 v 1174 100 a Fi(Multithreaded)22 │ │ │ │ │ -b Fg(:)37 b Fh(DRAFT)111 b Fg(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2852 100 V 1009 w Fn(7)307 390 y Fc(\210)42 b Fn(The)32 │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1026 4 v 1192 100 a Fi(Multithreaded)22 │ │ │ │ │ +b Fg(:)37 b Fh(DRAFT)110 b Fg(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2835 100 V 1026 w Fn(7)307 390 y Fc(\210)42 b Fn(The)32 │ │ │ │ │ b Fi(msgFile)c Fn(parameter)i(determines)h(the)h(message)e(\014le)i(|)f │ │ │ │ │ (if)h Fi(msgFile)d Fn(is)i Fi(stdout)p Fn(,)f(then)i(the)g(message)390 │ │ │ │ │ 490 y(\014le)c(is)f Fh(stdout)p Fn(,)h(otherwise)e(a)i(\014le)f(is)h │ │ │ │ │ (op)r(ened)f(with)i Fh(app)l(end)g Fn(status)e(to)g(receiv)n(e)g(an)n │ │ │ │ │ (y)g(output)h(data.)307 620 y Fc(\210)42 b Fn(The)28 │ │ │ │ │ b Fi(type)e Fn(parameter)g(sp)r(eci\014es)h(a)h(real)e(or)h(complex)g │ │ │ │ │ (linear)g(system.)456 750 y Fa({)41 b Fi(type)h(=)i(1)f(\(SPOOLES)p │ │ │ │ │ @@ -5716,22 +5710,22 @@ │ │ │ │ │ 5277 y Fl(T)3144 5308 y Fj(\003)g Fm(X)27 b Fn(or)19 │ │ │ │ │ b Fm(Y)24 b Fn(+)5 b Fm(\013)g Fj(\003)g Fm(A)3690 5277 │ │ │ │ │ y Fl(H)3756 5308 y Fj(\003)g Fm(X)i Fn(.)208 5407 y(The)27 │ │ │ │ │ b(program's)f(output)i(is)f(a)g(\014le)h(whic)n(h)g(when)f(sen)n(t)h │ │ │ │ │ (in)n(to)f(Matlab,)h(outputs)f(the)h(error)e(in)i(the)g(computation.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fn(8)p 125 100 1009 4 v │ │ │ │ │ -1174 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ -Fg(F)-7 b(ebruary)27 b(8,)g(2025)p 2892 100 V 307 390 │ │ │ │ │ -a Fc(\210)42 b Fn(The)19 b Fi(msglvl)e Fn(parameter)g(determines)i(the) │ │ │ │ │ -h(amoun)n(t)e(of)h(output)h(|)f(taking)f Fi(msglvl)41 │ │ │ │ │ -b(>=)i(3)19 b Fn(means)f(the)h Fi(InpMtx)390 490 y Fn(ob)5 │ │ │ │ │ -b(ject)28 b(is)f(written)h(to)f(the)h(message)e(\014le.)307 │ │ │ │ │ -624 y Fc(\210)42 b Fn(The)32 b Fi(msgFile)c Fn(parameter)i(determines)h │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fn(8)p 125 100 1026 4 v │ │ │ │ │ +1191 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)28 b │ │ │ │ │ +Fg(Jan)n(uary)d(7,)i(2024)p 2874 100 V 307 390 a Fc(\210)42 │ │ │ │ │ +b Fn(The)19 b Fi(msglvl)e Fn(parameter)g(determines)i(the)h(amoun)n(t)e │ │ │ │ │ +(of)h(output)h(|)f(taking)f Fi(msglvl)41 b(>=)i(3)19 │ │ │ │ │ +b Fn(means)f(the)h Fi(InpMtx)390 490 y Fn(ob)5 b(ject)28 │ │ │ │ │ +b(is)f(written)h(to)f(the)h(message)e(\014le.)307 624 │ │ │ │ │ +y Fc(\210)42 b Fn(The)32 b Fi(msgFile)c Fn(parameter)i(determines)h │ │ │ │ │ (the)h(message)e(\014le)i(|)f(if)h Fi(msgFile)d Fn(is)i │ │ │ │ │ Fi(stdout)p Fn(,)f(then)i(the)g(message)390 724 y(\014le)c(is)f │ │ │ │ │ Fh(stdout)p Fn(,)h(otherwise)e(a)i(\014le)f(is)h(op)r(ened)f(with)i │ │ │ │ │ Fh(app)l(end)g Fn(status)e(to)g(receiv)n(e)g(an)n(y)g(output)h(data.) │ │ │ │ │ 307 858 y Fc(\210)42 b Fi(dataType)25 b Fn(is)i(the)h(t)n(yp)r(e)g(of)f │ │ │ │ │ (en)n(tries,)g Fi(0)h Fn(for)f(real,)f Fi(1)i Fn(for)f(complex.)307 │ │ │ │ │ 993 y Fc(\210)42 b Fi(symflag)25 b Fn(is)i(the)h(symmetry)g(\015ag,)e │ │ │ │ │ @@ -5810,17 +5804,17 @@ │ │ │ │ │ V 28 w(HERMITIAN\))23 b Fn(for)k Fm(A)h Fn(complex)g(Hermitian,)456 │ │ │ │ │ 5138 y Fa({)41 b Fi(type)h(=)i(2)f(\(SPOOLES)p 1295 5138 │ │ │ │ │ V 28 w(NONSYMMETRIC\))390 5273 y Fn(for)27 b Fm(A)h Fn(real)f(or)g │ │ │ │ │ (complex)g(nonsymmetric.)307 5407 y Fc(\210)42 b Fn(The)28 │ │ │ │ │ b Fi(sparsityflag)23 b Fn(parameter)j(signals)g(a)h(direct)h(or)e │ │ │ │ │ (appro)n(ximate)g(factorization.)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 83 100 1009 4 v 1174 100 a Fi(Multithreaded)22 │ │ │ │ │ -b Fg(:)37 b Fh(DRAFT)111 b Fg(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2852 100 V 1009 w Fn(9)456 390 y Fa({)41 b Fi(sparsityflag)e(=)k(0)g │ │ │ │ │ +TeXDict begin 9 8 bop 83 100 1026 4 v 1192 100 a Fi(Multithreaded)22 │ │ │ │ │ +b Fg(:)37 b Fh(DRAFT)110 b Fg(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2835 100 V 1026 w Fn(9)456 390 y Fa({)41 b Fi(sparsityflag)e(=)k(0)g │ │ │ │ │ (\(FRONTMTX)p 1687 390 27 4 v 28 w(DENSE)p 1935 390 V │ │ │ │ │ 29 w(FRONTS\))26 b Fn(implies)j(a)f(direct)h(factorization,)f(the)h │ │ │ │ │ (fron)n(ts)f(will)545 490 y(b)r(e)g(stored)f(as)g(dense)h(submatrices.) │ │ │ │ │ 456 607 y Fa({)41 b Fi(sparsityflag)e(=)k(1)g(\(FRONTMTX)p │ │ │ │ │ 1687 607 V 28 w(SPARSE)p 1979 607 V 29 w(FRONTS\))29 │ │ │ │ │ b Fn(implies)j(an)g(appro)n(ximate)e(factorization.)48 │ │ │ │ │ b(The)545 706 y(fron)n(ts)26 b(will)g(b)r(e)g(stored)g(as)f(sparse)g │ │ │ │ │ @@ -5905,21 +5899,21 @@ │ │ │ │ │ b Fi(n1)27 b Fn(is)h(the)g(n)n(um)n(b)r(er)f(of)g(p)r(oin)n(ts)h(in)g │ │ │ │ │ (the)g(\014rst)f(grid)g(direction.)307 5273 y Fc(\210)42 │ │ │ │ │ b Fi(n2)27 b Fn(is)h(the)g(n)n(um)n(b)r(er)f(of)g(p)r(oin)n(ts)h(in)g │ │ │ │ │ (the)g(second)f(grid)g(direction.)307 5407 y Fc(\210)42 │ │ │ │ │ b Fi(n3)27 b Fn(is)h(the)g(n)n(um)n(b)r(er)f(of)g(p)r(oin)n(ts)h(in)g │ │ │ │ │ (the)g(third)g(grid)e(direction.)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fn(10)p 166 100 988 4 │ │ │ │ │ -v 1152 w Fi(Multithreaded)23 b Fg(:)37 b Fh(DRAFT)27 │ │ │ │ │ -b Fg(F)-7 b(ebruary)26 b(8,)i(2025)p 2913 100 V 307 390 │ │ │ │ │ -a Fc(\210)42 b Fn(The)28 b Fi(seed)e Fn(parameter)g(is)h(a)h(random)e │ │ │ │ │ -(n)n(um)n(b)r(er)i(seed.)307 523 y Fc(\210)42 b Fn(The)28 │ │ │ │ │ -b Fi(nrhs)e Fn(parameter)g(is)h(the)h(n)n(um)n(b)r(er)g(of)f(righ)n(t)g │ │ │ │ │ -(hand)h(sides)f(to)h(solv)n(e)e(as)h(one)g(blo)r(c)n(k.)307 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fn(10)p 166 100 1005 4 │ │ │ │ │ +v 1170 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)27 │ │ │ │ │ +b Fg(Jan)n(uary)f(7,)h(2024)p 2895 100 V 307 390 a Fc(\210)42 │ │ │ │ │ +b Fn(The)28 b Fi(seed)e Fn(parameter)g(is)h(a)h(random)e(n)n(um)n(b)r │ │ │ │ │ +(er)i(seed.)307 523 y Fc(\210)42 b Fn(The)28 b Fi(nrhs)e │ │ │ │ │ +Fn(parameter)g(is)h(the)h(n)n(um)n(b)r(er)g(of)f(righ)n(t)g(hand)h │ │ │ │ │ +(sides)f(to)h(solv)n(e)e(as)h(one)g(blo)r(c)n(k.)307 │ │ │ │ │ 656 y Fc(\210)42 b Fn(The)28 b Fi(type)e Fn(parameter)g(sp)r(eci\014es) │ │ │ │ │ h(a)h(real)e(or)h(complex)g(linear)g(system.)456 789 │ │ │ │ │ y Fa({)41 b Fi(type)h(=)i(1)f(\(SPOOLES)p 1295 789 27 │ │ │ │ │ 4 v 28 w(REAL\))25 b Fn(for)i(real,)456 905 y Fa({)41 │ │ │ │ │ b Fi(type)h(=)i(2)f(\(SPOOLES)p 1295 905 V 28 w(COMPLEX\))24 │ │ │ │ │ b Fn(for)j(complex.)307 1038 y Fc(\210)42 b Fn(The)28 │ │ │ │ │ b Fi(nthread)d Fn(parameter)h(is)h(the)h(n)n(um)n(b)r(er)g(of)f │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -35,15 +35,15 @@ │ │ │ │ │ │ by independent topological traversals of the front tree. It is the list and working storage data structures (the │ │ │ │ │ │ ChvList, ChvManager and SubMtxManager objects) that have locks. What is done is common code between │ │ │ │ │ │ the serial and multithreaded environments, it is the choreography, i.e., who does what, that differs. │ │ │ │ │ │ Most of these same comments apply to the multithreaded solve methods. The calling sequences between │ │ │ │ │ │ the serial and multithreaded solves differs by one parameter, a SolveMap object that maps the submatrices │ │ │ │ │ │ of the factor matrix to the threads that will compute with them. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Multithreaded : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Multithreaded : DRAFT January 7, 2024 │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ There are no multithreaded specific data structures. See the Lock object which is used to hide the particular │ │ │ │ │ │ mutual exclusion device used by a thread library. │ │ │ │ │ │ 1.2 Prototypes and descriptions of MT methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods found in the MT source directory. │ │ │ │ │ │ 1.2.1 Matrix-matrix multiply methods │ │ │ │ │ │ Therearefivemethodstomultiplyavectortimesadensematrix. Thefirstthreemethods,calledInpMtx MT nonsym mmm*(), │ │ │ │ │ │ @@ -79,15 +79,15 @@ │ │ │ │ │ │ This method computes the matrix-vector product y := y+αA x, where y is found in the Y DenseMtx │ │ │ │ │ │ object, α is real or complex in alpha[], A is found in the A Inpmtx object, and x is found in the X │ │ │ │ │ │ DenseMtx object. If any of the input objects are NULL, an error message is printed and the program │ │ │ │ │ │ exits. A, X and Y must all be real or all be complex. When A is real, then α = alpha[0]. When A │ │ │ │ │ │ is complex, then α = alpha[0] + i* alpha[1]. This means that one cannot call the methods with │ │ │ │ │ │ a constant as the third parameter, e.g., InpMtx MT nonsym mmm(A, Y, 3.22, X, nthread, msglvl, │ │ │ │ │ │ msgFile), for this may result in a segmentation violation. The values of α must be loaded into an │ │ │ │ │ │ - Multithreaded : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Multithreaded : DRAFT January 7, 2024 3 │ │ │ │ │ │ array of length 1 or 2. The number of threads is specified by the nthread parameter; if, nthread is 1, │ │ │ │ │ │ the serial method is called. The msglvl and msgFile parameters are used for diagnostics during the │ │ │ │ │ │ creation of the threads’ individual data structures. │ │ │ │ │ │ Error checking: If A, Y or X are NULL, or if coordType is not INPMTX BY ROWS, INPMTX BY COLUMNS or │ │ │ │ │ │ INPMTX BY CHEVRONS,orifstorageModeisnotoneofINPMTX RAW DATA,INPMTX SORTEDorINPMTX BY VECTORS, │ │ │ │ │ │ or if inputModeis not SPOOLES REAL or SPOOLES COMPLEX,an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ @@ -124,15 +124,15 @@ │ │ │ │ │ │ • cpus[1] — time spent initializing the fronts and loading the original entries. │ │ │ │ │ │ • cpus[2] — time spent accumulating updates from descendents. │ │ │ │ │ │ • cpus[3] — time spent inserting aggregate fronts. │ │ │ │ │ │ • cpus[4] — time spent removing and assembling aggregate fronts. │ │ │ │ │ │ • cpus[5] — time spent assembling postponed data. │ │ │ │ │ │ • cpus[6] — time spent to factor the fronts. │ │ │ │ │ │ • cpus[7] — time spent to extract postponed data. │ │ │ │ │ │ - 4 Multithreaded : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Multithreaded : DRAFT January 7, 2024 │ │ │ │ │ │ • cpus[8] — time spent to store the factor entries. │ │ │ │ │ │ • cpus[9] — miscellaneous time. │ │ │ │ │ │ Onreturn, the stats[] vector is filled with the following information. │ │ │ │ │ │ • stats[0] — number of pivots. │ │ │ │ │ │ • stats[1] — number of pivot tests. │ │ │ │ │ │ • stats[2] — number of delayed rows and columns. │ │ │ │ │ │ • stats[3] — number of entries in D. │ │ │ │ │ │ @@ -164,15 +164,15 @@ │ │ │ │ │ │ an error message is printed and the program exits. │ │ │ │ │ │ 1.2.4 Multithreaded Solve method │ │ │ │ │ │ 1. void FrontMtx_MT_solve ( FrontMtx *frontmtx, DenseMtx *mtxX, DenseMtx *mtxB, │ │ │ │ │ │ SubMtxManager *mtxmanager, SolveMap *solvemap, │ │ │ │ │ │ double cpus[], int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method is used to solve one of three linear systems of equations using a multithreaded solve — │ │ │ │ │ │ (UT +I)D(I +U)X =B, (UH +I)D(I +U)X =B or (L+I)D(I+U)X =B. Entries of B are read │ │ │ │ │ │ - Multithreaded : DRAFT February 8, 2025 5 │ │ │ │ │ │ + Multithreaded : DRAFT January 7, 2024 5 │ │ │ │ │ │ from mtxB and entries of X are written to mtxX. Therefore, mtxX and mtxB can be the same object. │ │ │ │ │ │ (Note, this does not hold true for an MPI factorization with pivoting.) The submatrix manager object │ │ │ │ │ │ manages the working storage. The solvemap object contains the map from submatrices to threads. │ │ │ │ │ │ The map from fronts to processes that own them is given in the ownersIV object. On return the │ │ │ │ │ │ cpus[] vector is filled with the following. The stats[] vector is not currently used. │ │ │ │ │ │ • cpus[0] — set up the solves │ │ │ │ │ │ • cpus[1] — fetch right hand side and store solution │ │ │ │ │ │ @@ -206,15 +206,15 @@ │ │ │ │ │ │ ¿ 0 and msgFile is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.3 Driver programs for the multithreaded functions │ │ │ │ │ │ 1. allInOneMT msglvl msgFile type symmetryflag pivotingflag │ │ │ │ │ │ matrixFileName rhsFileName seed nthread │ │ │ │ │ │ This driver program reads in a matrix A and right hand side B, generates the graph for A and orders │ │ │ │ │ │ the matrix, factors A and solves the linear system AX = B for X using multithreaded factors and │ │ │ │ │ │ solves. Use the script file do gridMT for testing. │ │ │ │ │ │ - 6 Multithreaded : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 Multithreaded : DRAFT January 7, 2024 │ │ │ │ │ │ • The msglvlparameterdetermines the amount of output. Use msglvl = 1 for just timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • The type parameter specifies a real or complex linear system. │ │ │ │ │ │ – type = 1 (SPOOLES REAL) for real, │ │ │ │ │ │ – type = 2 (SPOOLES COMPLEX) for complex. │ │ │ │ │ │ • The symmetryflag parameter specifies the symmetry of the matrix. │ │ │ │ │ │ @@ -249,15 +249,15 @@ │ │ │ │ │ │ Thisdriverprogramisusedtotestthe“patch-and-go”functionalityforafactorizationwithoutpivoting. │ │ │ │ │ │ Whensmalldiagonalpivotelements are found, one of three actions are taken. See the PatchAndGoInfo │ │ │ │ │ │ object for more information. │ │ │ │ │ │ The program reads in a matrix A and right hand side B, generates the graph for A and orders the │ │ │ │ │ │ matrix, factors A and solves the linear system AX = B for X using multithreaded factors and solves. │ │ │ │ │ │ Use the script file do patchAndGo for testing. │ │ │ │ │ │ • The msglvlparameterdetermines the amount of output. Use msglvl = 1 for just timing output. │ │ │ │ │ │ - Multithreaded : DRAFT February 8, 2025 7 │ │ │ │ │ │ + Multithreaded : DRAFT January 7, 2024 7 │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • The type parameter specifies a real or complex linear system. │ │ │ │ │ │ – type = 1 (SPOOLES REAL) for real, │ │ │ │ │ │ – type = 2 (SPOOLES COMPLEX) for complex. │ │ │ │ │ │ • The symmetryflag parameter specifies the symmetry of the matrix. │ │ │ │ │ │ – type = 0 (SPOOLES SYMMETRIC) for A real or complex symmetric, │ │ │ │ │ │ @@ -294,15 +294,15 @@ │ │ │ │ │ │ • The nthread parameter is the number of threads. │ │ │ │ │ │ 3. testMMM msglvl msgFile dataType symflag storageMode transpose │ │ │ │ │ │ nrow ncol nitem nrhs seed alphaReal alphaImag nthread │ │ │ │ │ │ ThisdriverprogramgeneratesA, anrow×ncolmatrixusingniteminputentries,X andY,nrow×nrhs │ │ │ │ │ │ T H │ │ │ │ │ │ matrices, is filled with random numbers. It then computes Y +α∗A∗X,Y +α∗A ∗X orY +α∗A ∗X. │ │ │ │ │ │ The program’s output is a file which when sent into Matlab, outputs the error in the computation. │ │ │ │ │ │ - 8 Multithreaded : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 Multithreaded : DRAFT January 7, 2024 │ │ │ │ │ │ • Themsglvlparameterdeterminestheamountofoutput—takingmsglvl >= 3meanstheInpMtx │ │ │ │ │ │ object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • dataType is the type of entries, 0 for real, 1 for complex. │ │ │ │ │ │ • symflag is the symmetry flag, 0 for symmetric, 1 for Hermitian, 2 for nonsymmetric. │ │ │ │ │ │ • storageModeisthestoragemodefortheentries,1forbyrows,2forbycolumns, 3forbychevrons. │ │ │ │ │ │ @@ -336,15 +336,15 @@ │ │ │ │ │ │ – type = 2 (SPOOLES COMPLEX) for complex. │ │ │ │ │ │ • The symmetryflag parameter specifies the symmetry of the matrix. │ │ │ │ │ │ – type = 0 (SPOOLES SYMMETRIC) for A real or complex symmetric, │ │ │ │ │ │ – type = 1 (SPOOLES HERMITIAN) for A complex Hermitian, │ │ │ │ │ │ – type = 2 (SPOOLES NONSYMMETRIC) │ │ │ │ │ │ for A real or complex nonsymmetric. │ │ │ │ │ │ • The sparsityflag parameter signals a direct or approximate factorization. │ │ │ │ │ │ - Multithreaded : DRAFT February 8, 2025 9 │ │ │ │ │ │ + Multithreaded : DRAFT January 7, 2024 9 │ │ │ │ │ │ – sparsityflag = 0 (FRONTMTX DENSE FRONTS) implies a direct factorization, the fronts will │ │ │ │ │ │ be stored as dense submatrices. │ │ │ │ │ │ – sparsityflag = 1 (FRONTMTX SPARSE FRONTS) implies an approximate factorization. The │ │ │ │ │ │ fronts will be stored as sparse submatrices, where the entries in the triangular factors will be │ │ │ │ │ │ subjected to a drop tolerance test — if the magnitude of an entry is droptol or larger, it will │ │ │ │ │ │ be stored, otherwise it will be dropped. │ │ │ │ │ │ • The pivotingflag parameter signals whether pivoting for stability will be enabled or not. │ │ │ │ │ │ @@ -382,15 +382,15 @@ │ │ │ │ │ │ X F │ │ │ │ │ │ • The msglvlparameterdetermines the amount of output. Use msglvl = 1 for just timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ │ │ │ file is stdout, otherwise a file is opened with append status to receive any output data. │ │ │ │ │ │ • n1 is the number of points in the first grid direction. │ │ │ │ │ │ • n2 is the number of points in the second grid direction. │ │ │ │ │ │ • n3 is the number of points in the third grid direction. │ │ │ │ │ │ - 10 Multithreaded : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 Multithreaded : DRAFT January 7, 2024 │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ • The nrhs parameter is the number of right hand sides to solve as one block. │ │ │ │ │ │ • The type parameter specifies a real or complex linear system. │ │ │ │ │ │ – type = 1 (SPOOLES REAL) for real, │ │ │ │ │ │ – type = 2 (SPOOLES COMPLEX) for complex. │ │ │ │ │ │ • The nthread parameter is the number of threads. │ │ │ │ │ │ • The maptype parameter determines the type of map from fronts to processes to be used during │ │ │ ├── ./usr/share/doc/spooles-doc/Network.ps.gz │ │ │ │ ├── Network.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Network.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1542,21 +1542,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1740,88 +1739,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4683,16 +4677,16 @@ │ │ │ │ │ 2[51 62 50 1[54 11[86 5[84 5[42 6[80 13[56 56 56 56 2[31 │ │ │ │ │ 46[{}24 99.6264 /CMBX12 rf /Fb 136[62 2[62 1[62 2[62 │ │ │ │ │ 3[62 5[62 22[62 78[{}7 119.552 /CMTT12 rf /Fc 134[71 │ │ │ │ │ 3[75 52 53 55 1[75 67 75 112 3[37 75 1[41 61 75 60 1[65 │ │ │ │ │ 13[75 2[92 11[103 17[67 67 2[37 46[{}22 119.552 /CMBX12 │ │ │ │ │ rf /Fd 141[38 2[46 51 2[42 1[28 46 42 1[42 1[42 14[65 │ │ │ │ │ 1[66 11[59 62 69 2[68 6[28 58[{}16 90.9091 /CMTI10 rf │ │ │ │ │ -/Fe 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 │ │ │ │ │ -2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf /Ff 212[55 │ │ │ │ │ +/Fe 134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 │ │ │ │ │ +1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf /Ff 212[55 │ │ │ │ │ 43[{}1 66.4176 /CMR8 rf /Fg 255[55{}1 66.4176 /CMSY8 │ │ │ │ │ rf /Fh 168[67 13[31 6[53 6[20 59[{}4 66.4176 /CMMI8 rf │ │ │ │ │ /Fi 132[52 123[{}1 90.9091 /CMBX10 rf │ │ │ │ │ %DVIPSBitmapFont: Fj tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ @@ -4824,62 +4818,62 @@ │ │ │ │ │ y Fn(and)j Fl(y)g Fk(2)d Fl(Y)1814 5308 y Fh(I)1886 5294 │ │ │ │ │ y Fn(b)s(ecomes)k(t)m(w)m(o)h(edges,)h(\()p Fl(x;)15 │ │ │ │ │ b(y)2871 5261 y Fg(\000)2930 5294 y Fn(\))33 b(and)g(\()p │ │ │ │ │ Fl(y)3261 5261 y Ff(+)3320 5294 y Fl(;)15 b(x)p Fn(\),)34 │ │ │ │ │ b(b)s(oth)e(with)227 5407 y(in\014nite)e(capacit)m(y)-8 │ │ │ │ │ b(.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fn(2)p 136 100 1062 4 v │ │ │ │ │ -1244 w Fm(Network)28 b Fe(:)41 b Fd(DRAFT)30 b Fe(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2838 100 V 137 399 a Fj(\210)45 │ │ │ │ │ -b Fn(An)33 b(edge)g(\()p Fl(y)s(;)15 b(z)t Fn(\))35 b(where)d │ │ │ │ │ -Fl(y)g Fk(2)e Fl(Y)1313 413 y Fh(I)1385 399 y Fn(and)i │ │ │ │ │ -Fl(z)i Fk(2)29 b Fl(Y)1783 413 y Fh(W)1897 399 y Fn(b)s(ecomes)k(t)m(w) │ │ │ │ │ -m(o)h(edges,)h(\()p Fl(y)2790 366 y Ff(+)2849 399 y Fl(;)15 │ │ │ │ │ -b(z)t Fn(\))34 b(and)e(\()p Fl(z)t(;)15 b(y)3352 366 │ │ │ │ │ -y Fg(\000)3412 399 y Fn(\),)34 b(b)s(oth)e(with)227 511 │ │ │ │ │ -y(in\014nite)e(capacit)m(y)-8 b(.)137 695 y Fj(\210)45 │ │ │ │ │ -b Fn(An)27 b(edge)h(\()p Fl(x;)15 b(y)s Fn(\))27 b(where)g │ │ │ │ │ -Fl(x)e Fk(2)g Fl(Y)1290 709 y Fh(I)1357 695 y Fn(and)h │ │ │ │ │ -Fl(y)i Fk(2)d Fl(Y)1742 709 y Fh(I)1809 695 y Fn(b)s(ecomes)i(t)m(w)m │ │ │ │ │ -(o)h(edges,)h(\()p Fl(x)2688 662 y Ff(+)2747 695 y Fl(;)15 │ │ │ │ │ -b(y)2835 662 y Fg(\000)2894 695 y Fn(\))28 b(and)e(\()p │ │ │ │ │ -Fl(y)3213 662 y Ff(+)3272 695 y Fl(;)15 b(x)3364 662 │ │ │ │ │ -y Fg(\000)3424 695 y Fn(\),)28 b(b)s(oth)e(with)227 808 │ │ │ │ │ -y(in\014nite)k(capacit)m(y)-8 b(.)141 1010 y(The)29 b │ │ │ │ │ -Fm(Network)d Fn(ob)5 b(ject)30 b(can)f(b)s(e)g(constructed)g(fairly)g │ │ │ │ │ -(simply)-8 b(.)40 b(It)29 b(is)g(initialized)i(b)m(y)d(sp)s(ecifying)h │ │ │ │ │ -(the)g(n)m(um)m(b)s(er)0 1123 y(of)36 b(no)s(des)e(in)i(the)f(net)m(w)m │ │ │ │ │ -(ork,)j(including)d(the)h(source)g(and)f(sink.)55 b(Arcs)36 │ │ │ │ │ -b(can)g(b)s(e)e(added)h(one)h(at)g(a)g(time)g(and)f(it)0 │ │ │ │ │ -1236 y(is)f(not)h(necessary)g(to)g(kno)m(w)f(the)h(total)h(n)m(um)m(b)s │ │ │ │ │ -(er)d(of)h(arcs)h(ahead)f(of)h(time.)53 b(T)-8 b(o)35 │ │ │ │ │ -b(sp)s(ecify)f(an)g(arc)h(one)f(needs)g(to)0 1348 y(pro)m(vide)c(the)h │ │ │ │ │ -(\014rst)f(and)f(second)i(v)m(ertices,)h(the)f(capacit)m(y)h(and)e(the) │ │ │ │ │ -h(presen)m(t)f(\015o)m(w.)141 1484 y(Once)25 b(w)m(e)h(ha)m(v)m(e)h │ │ │ │ │ -(constructed)e(the)h(net)m(w)m(ork,)h(w)m(e)f(solv)m(e)h(the)e(max)h │ │ │ │ │ -(\015o)m(w)f(problem)g(in)g(a)h(v)m(ery)f(simple)h(manner,)0 │ │ │ │ │ -1597 y(basically)40 b(the)f(F)-8 b(ord-F)g(ulk)m(erson)40 │ │ │ │ │ -b(algorithm)g(that)f(generates)h(augmen)m(ting)g(paths.)65 │ │ │ │ │ -b(No)39 b(doubt)f(this)h(can)g(b)s(e)0 1710 y(impro)m(v)m(ed,)27 │ │ │ │ │ -b(and)e(it)h(w)m(ould)g(b)s(e)f(w)m(elcome)i(b)s(ecause)e(for)h(large)g │ │ │ │ │ -(three)g(dimensional)g(\014nite)f(elemen)m(t)j(graphs,)e(up)e(to)0 │ │ │ │ │ -1823 y(sixt)m(y)29 b(p)s(er)f(cen)m(t)h(of)g(the)g(time)g(is)g(sp)s(en) │ │ │ │ │ -m(t)f(smo)s(othing)g(the)h(separators,)h(and)d(most)i(of)g(this)f(time) │ │ │ │ │ -i(is)e(sp)s(en)m(t)g(solving)0 1936 y(a)j(max)f(\015o)m(w)h(problem.) │ │ │ │ │ -141 2072 y(Ho)m(w)m(ev)m(er,)i(the)d(net)m(w)m(ork)i(w)m(e)e(generate)i │ │ │ │ │ -(in)e(practice)i(ha)m(v)m(e)g(t)m(w)m(o)f(sp)s(ecial)g(prop)s(erties:) │ │ │ │ │ -137 2274 y Fj(\210)45 b Fn(The)31 b(net)m(w)m(orks)h(are)g(v)m(ery)g │ │ │ │ │ -(shallo)m(w,)g(i.e.,)h(the)f(distance)g(from)f(the)h(source)f(to)h(the) │ │ │ │ │ -g(sink)f(is)g(generally)i(3-6)227 2386 y(in)d(practice.)42 │ │ │ │ │ -b(This)30 b(reduces)g(the)h(p)s(oten)m(tial)g(impro)m(v)m(emen)m(t)h │ │ │ │ │ -(of)f(a)f(pre-push)f(algorithm.)137 2570 y Fj(\210)45 │ │ │ │ │ -b Fn(The)32 b(maxim)m(um)g(capacit)m(y)i(of)f(an)f(edge)h(is)f(small,)i │ │ │ │ │ -(usually)d(6-12.)48 b(Therefore)32 b(scaling)i(algorithms)f(ha)m(v)m(e) │ │ │ │ │ -227 2683 y(little)f(applicabilit)m(y)-8 b(.)0 2885 y(Finding)33 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 136 100 1081 4 v │ │ │ │ │ +1263 w Fm(Network)29 b Fe(:)40 b Fd(DRAFT)30 b Fe(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2819 100 V 137 399 a Fj(\210)45 b Fn(An)33 b(edge)g(\()p │ │ │ │ │ +Fl(y)s(;)15 b(z)t Fn(\))35 b(where)d Fl(y)g Fk(2)e Fl(Y)1313 │ │ │ │ │ +413 y Fh(I)1385 399 y Fn(and)i Fl(z)i Fk(2)29 b Fl(Y)1783 │ │ │ │ │ +413 y Fh(W)1897 399 y Fn(b)s(ecomes)k(t)m(w)m(o)h(edges,)h(\()p │ │ │ │ │ +Fl(y)2790 366 y Ff(+)2849 399 y Fl(;)15 b(z)t Fn(\))34 │ │ │ │ │ +b(and)e(\()p Fl(z)t(;)15 b(y)3352 366 y Fg(\000)3412 │ │ │ │ │ +399 y Fn(\),)34 b(b)s(oth)e(with)227 511 y(in\014nite)e(capacit)m(y)-8 │ │ │ │ │ +b(.)137 695 y Fj(\210)45 b Fn(An)27 b(edge)h(\()p Fl(x;)15 │ │ │ │ │ +b(y)s Fn(\))27 b(where)g Fl(x)e Fk(2)g Fl(Y)1290 709 │ │ │ │ │ +y Fh(I)1357 695 y Fn(and)h Fl(y)i Fk(2)d Fl(Y)1742 709 │ │ │ │ │ +y Fh(I)1809 695 y Fn(b)s(ecomes)i(t)m(w)m(o)h(edges,)h(\()p │ │ │ │ │ +Fl(x)2688 662 y Ff(+)2747 695 y Fl(;)15 b(y)2835 662 │ │ │ │ │ +y Fg(\000)2894 695 y Fn(\))28 b(and)e(\()p Fl(y)3213 │ │ │ │ │ +662 y Ff(+)3272 695 y Fl(;)15 b(x)3364 662 y Fg(\000)3424 │ │ │ │ │ +695 y Fn(\),)28 b(b)s(oth)e(with)227 808 y(in\014nite)k(capacit)m(y)-8 │ │ │ │ │ +b(.)141 1010 y(The)29 b Fm(Network)d Fn(ob)5 b(ject)30 │ │ │ │ │ +b(can)f(b)s(e)g(constructed)g(fairly)g(simply)-8 b(.)40 │ │ │ │ │ +b(It)29 b(is)g(initialized)i(b)m(y)d(sp)s(ecifying)h(the)g(n)m(um)m(b)s │ │ │ │ │ +(er)0 1123 y(of)36 b(no)s(des)e(in)i(the)f(net)m(w)m(ork,)j(including)d │ │ │ │ │ +(the)h(source)g(and)f(sink.)55 b(Arcs)36 b(can)g(b)s(e)e(added)h(one)h │ │ │ │ │ +(at)g(a)g(time)g(and)f(it)0 1236 y(is)f(not)h(necessary)g(to)g(kno)m(w) │ │ │ │ │ +f(the)h(total)h(n)m(um)m(b)s(er)d(of)h(arcs)h(ahead)f(of)h(time.)53 │ │ │ │ │ +b(T)-8 b(o)35 b(sp)s(ecify)f(an)g(arc)h(one)f(needs)g(to)0 │ │ │ │ │ +1348 y(pro)m(vide)c(the)h(\014rst)f(and)f(second)i(v)m(ertices,)h(the)f │ │ │ │ │ +(capacit)m(y)h(and)e(the)h(presen)m(t)f(\015o)m(w.)141 │ │ │ │ │ +1484 y(Once)25 b(w)m(e)h(ha)m(v)m(e)h(constructed)e(the)h(net)m(w)m │ │ │ │ │ +(ork,)h(w)m(e)f(solv)m(e)h(the)e(max)h(\015o)m(w)f(problem)g(in)g(a)h │ │ │ │ │ +(v)m(ery)f(simple)h(manner,)0 1597 y(basically)40 b(the)f(F)-8 │ │ │ │ │ +b(ord-F)g(ulk)m(erson)40 b(algorithm)g(that)f(generates)h(augmen)m │ │ │ │ │ +(ting)g(paths.)65 b(No)39 b(doubt)f(this)h(can)g(b)s(e)0 │ │ │ │ │ +1710 y(impro)m(v)m(ed,)27 b(and)e(it)h(w)m(ould)g(b)s(e)f(w)m(elcome)i │ │ │ │ │ +(b)s(ecause)e(for)h(large)g(three)g(dimensional)g(\014nite)f(elemen)m │ │ │ │ │ +(t)j(graphs,)e(up)e(to)0 1823 y(sixt)m(y)29 b(p)s(er)f(cen)m(t)h(of)g │ │ │ │ │ +(the)g(time)g(is)g(sp)s(en)m(t)f(smo)s(othing)g(the)h(separators,)h │ │ │ │ │ +(and)d(most)i(of)g(this)f(time)i(is)e(sp)s(en)m(t)g(solving)0 │ │ │ │ │ +1936 y(a)j(max)f(\015o)m(w)h(problem.)141 2072 y(Ho)m(w)m(ev)m(er,)i │ │ │ │ │ +(the)d(net)m(w)m(ork)i(w)m(e)e(generate)i(in)e(practice)i(ha)m(v)m(e)g │ │ │ │ │ +(t)m(w)m(o)f(sp)s(ecial)g(prop)s(erties:)137 2274 y Fj(\210)45 │ │ │ │ │ +b Fn(The)31 b(net)m(w)m(orks)h(are)g(v)m(ery)g(shallo)m(w,)g(i.e.,)h │ │ │ │ │ +(the)f(distance)g(from)f(the)h(source)f(to)h(the)g(sink)f(is)g │ │ │ │ │ +(generally)i(3-6)227 2386 y(in)d(practice.)42 b(This)30 │ │ │ │ │ +b(reduces)g(the)h(p)s(oten)m(tial)g(impro)m(v)m(emen)m(t)h(of)f(a)f │ │ │ │ │ +(pre-push)f(algorithm.)137 2570 y Fj(\210)45 b Fn(The)32 │ │ │ │ │ +b(maxim)m(um)g(capacit)m(y)i(of)f(an)f(edge)h(is)f(small,)i(usually)d │ │ │ │ │ +(6-12.)48 b(Therefore)32 b(scaling)i(algorithms)f(ha)m(v)m(e)227 │ │ │ │ │ +2683 y(little)f(applicabilit)m(y)-8 b(.)0 2885 y(Finding)33 │ │ │ │ │ b(a)h(minimal)g(separator)g(giv)m(es)h(rise)f(to)g(net)m(w)m(orks)g(of) │ │ │ │ │ g(a)g(sp)s(ecial)g(nature)f(and)g(that)h(ma)m(y)g(require)f(sp)s(e-)0 │ │ │ │ │ 2998 y(cialized)41 b(solution)f(tec)m(hniques.)67 b(In)38 │ │ │ │ │ b(fact,)43 b(there)c(is)g(a)h(more)f(straigh)m(tforw)m(ard)h(approac)m │ │ │ │ │ (h)f(that)h(generates)h(a)0 3111 y(net)m(w)m(ork)f(where)f(eac)m(h)i(v) │ │ │ │ │ m(ertex)f(in)f Fl(Y)60 b Fn(b)s(ecomes)39 b Fd(one)h │ │ │ │ │ Fn(no)s(de)f(in)g(the)g(net)m(w)m(ork)i(\(as)f(opp)s(osed)e(to)i(t)m(w) │ │ │ │ │ @@ -4909,17 +4903,17 @@ │ │ │ │ │ Fm(nnode)g Fn(arc)227 4891 y(structures.)141 5093 y(The)30 │ │ │ │ │ b Fm(Network)e Fn(ob)5 b(ject)32 b(has)e(six)g(\014elds.)137 │ │ │ │ │ 5294 y Fj(\210)45 b Fm(int)i(nnode)24 b Fn(|)i(the)f(n)m(um)m(b)s(er)f │ │ │ │ │ (of)i(no)s(des)f(in)g(the)h(net)m(w)m(ork,)h(including)e(the)h(source)f │ │ │ │ │ (\(no)s(de)h(0\))g(and)f(the)g(sink)227 5407 y(\(no)s(de)30 │ │ │ │ │ b Fm(nnode-1)p Fn(\).)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1062 4 v 1244 100 a Fm(Network)28 │ │ │ │ │ -b Fe(:)41 b Fd(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2791 100 V 1062 w Fn(3)137 399 y Fj(\210)45 b Fm(int)i(narc)29 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1081 4 v 1263 100 a Fm(Network)28 │ │ │ │ │ +b Fe(:)41 b Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2772 100 V 1081 w Fn(3)137 399 y Fj(\210)45 b Fm(int)i(narc)29 │ │ │ │ │ b Fn(|)i(the)f(n)m(um)m(b)s(er)f(of)i(arcs)f(in)g(the)h(net)m(w)m(ork) │ │ │ │ │ 137 601 y Fj(\210)45 b Fm(int)i(ntrav)29 b Fn(|)h(the)h(n)m(um)m(b)s │ │ │ │ │ (er)e(of)h(arc)h(tra)m(v)m(ersals)h(that)f(w)m(e)g(made)g(to)g(\014nd)e │ │ │ │ │ (a)h(max)h(\015o)m(w.)137 803 y Fj(\210)45 b Fm(Arc)i(**inheads)29 │ │ │ │ │ b Fn(|)h(p)s(oin)m(ter)h(to)h(a)f(v)m(ector)h(of)f(p)s(oin)m(ters)g(to) │ │ │ │ │ h Fm(Arc)p Fn(,)e Fm(inheads[v])e Fn(p)s(oin)m(ts)j(to)g(the)g(\014rst) │ │ │ │ │ g(arc)227 915 y(in)f(the)h(in-list)g(for)f(no)s(de)g │ │ │ │ │ @@ -4964,27 +4958,27 @@ │ │ │ │ │ (h)m(unks.)0 5059 y Fc(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ b(and)f(descriptions)g(of)g Fb(Network)d Fc(metho)t(ds)0 │ │ │ │ │ 5294 y Fn(This)f(section)j(con)m(tains)f(brief)f(descriptions)g │ │ │ │ │ (including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f(that)h(b)s │ │ │ │ │ (elong)f(to)h(the)0 5407 y Fm(Network)28 b Fn(ob)5 b(ject.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fn(4)p 136 100 1062 4 v │ │ │ │ │ -1244 w Fm(Network)28 b Fe(:)41 b Fd(DRAFT)30 b Fe(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2838 100 V 0 399 a Fa(1.2.1)112 │ │ │ │ │ -b(Basic)38 b(metho)s(ds)0 589 y Fn(As)d(usual,)h(there)f(are)g(four)f │ │ │ │ │ -(basic)h(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 │ │ │ │ │ -b(creation,)i(setting)e(default)f(\014elds,)h(clearing)0 │ │ │ │ │ -702 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h(the)g(ob)5 │ │ │ │ │ -b(ject.)111 894 y(1.)46 b Fm(Network)g(*)i(Network_new)c(\()k(void)e │ │ │ │ │ -(\))i(;)227 1038 y Fn(This)39 b(metho)s(d)f(simply)h(allo)s(cates)i │ │ │ │ │ -(storage)g(for)e(the)g Fm(Network)f Fn(structure)g(and)h(then)g(sets)g │ │ │ │ │ -(the)h(default)227 1151 y(\014elds)30 b(b)m(y)g(a)h(call)h(to)f │ │ │ │ │ -Fm(Network)p 1282 1151 29 4 v 32 w(setDefaultFields\(\))p │ │ │ │ │ -Fn(.)111 1326 y(2.)46 b Fm(void)h(Network_setDefaultFields)41 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 136 100 1081 4 v │ │ │ │ │ +1263 w Fm(Network)29 b Fe(:)40 b Fd(DRAFT)30 b Fe(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2819 100 V 0 399 a Fa(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +589 y Fn(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ +(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ +(\014elds,)h(clearing)0 702 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ +(free'ing)h(the)g(ob)5 b(ject.)111 894 y(1.)46 b Fm(Network)g(*)i │ │ │ │ │ +(Network_new)c(\()k(void)e(\))i(;)227 1038 y Fn(This)39 │ │ │ │ │ +b(metho)s(d)f(simply)h(allo)s(cates)i(storage)g(for)e(the)g │ │ │ │ │ +Fm(Network)f Fn(structure)g(and)h(then)g(sets)g(the)h(default)227 │ │ │ │ │ +1151 y(\014elds)30 b(b)m(y)g(a)h(call)h(to)f Fm(Network)p │ │ │ │ │ +1282 1151 29 4 v 32 w(setDefaultFields\(\))p Fn(.)111 │ │ │ │ │ +1326 y(2.)46 b Fm(void)h(Network_setDefaultFields)41 │ │ │ │ │ b(\()48 b(Network)d(*network)h(\))h(;)227 1470 y Fn(This)30 │ │ │ │ │ b(metho)s(d)g(sets)g(the)h(structure's)f(\014elds)g(to)h(default)g(v)-5 │ │ │ │ │ b(alues.)227 1614 y Fd(Err)g(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fn(If)30 b Fm(network)f Fn(is)h Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ (message)h(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)111 │ │ │ │ │ 1789 y(3.)46 b Fm(void)h(Network_clearData)c(\()k(Network)f(*network)g │ │ │ │ │ (\))h(;)227 1933 y Fn(This)26 b(metho)s(d)g(releases)h(an)m(y)g │ │ │ │ │ @@ -5037,17 +5031,17 @@ │ │ │ │ │ Fk(\024)h Fn(0,)k(or)d(if)f Fm(nnode)g Fk(\024)227 5294 │ │ │ │ │ y Fm(firstNode)n Fn(,)d(or)g(if)f Fm(secondNode)29 b │ │ │ │ │ Fk(\024)j Fn(0,)k(or)e(if)h Fm(nnode)30 b Fk(\024)i Fm(secondNode)m │ │ │ │ │ Fn(,)k(or)e(if)h Fm(capacity)29 b Fk(\024)j Fn(0,)k(an)e(error)227 │ │ │ │ │ 5407 y(message)e(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1062 4 v 1244 100 a Fm(Network)28 │ │ │ │ │ -b Fe(:)41 b Fd(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2791 100 V 1062 w Fn(5)0 399 y Fa(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1081 4 v 1263 100 a Fm(Network)28 │ │ │ │ │ +b Fe(:)41 b Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2772 100 V 1081 w Fn(5)0 399 y Fa(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ b(metho)s(ds)111 610 y Fn(1.)46 b Fm(void)h(Network_findMaxFlow)42 │ │ │ │ │ b(\()48 b(Network)e(*network)f(\))j(;)227 777 y Fn(This)37 │ │ │ │ │ b(metho)s(d)g(\014nds)f(a)i(maxim)m(um)g(\015o)m(w)g(o)m(v)m(er)h(the)f │ │ │ │ │ (net)m(w)m(ork)g(b)m(y)g(rep)s(eatedly)g(calling)h(the)f(metho)s(d)f │ │ │ │ │ (to)227 889 y(\014nd)30 b(an)h(augmen)m(ting)i(path)e(and)g(then)g(the) │ │ │ │ │ h(metho)s(d)e(to)j(augmen)m(t)f(the)f(path.)44 b(It)32 │ │ │ │ │ b(uses)f(an)g Fm(Ideq)f Fn(ob)5 b(ject)227 1002 y(to)31 │ │ │ │ │ @@ -5121,37 +5115,36 @@ │ │ │ │ │ Fn(is)g(in)g(the)h(comp)s(onen)m(t)g(that)g(con)m(tains)g(the)g(sink,)f │ │ │ │ │ (then)g Fm(mark[v])46 b(=)h(2)p Fn(.)227 5294 y Fd(Err)-5 │ │ │ │ │ b(or)32 b(che)-5 b(cking:)39 b Fn(If)28 b Fm(network)p │ │ │ │ │ Fn(,)f Fm(deq)g Fn(or)i Fm(mark)e Fn(is)h Fm(NULL)p Fn(,)f(or)i(if)f │ │ │ │ │ Fm(nnode)c Fk(\024)h Fn(0,)k(an)f(error)g(message)h(is)f(prin)m(ted)227 │ │ │ │ │ 5407 y(and)i(the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fn(6)p 136 100 1062 4 v │ │ │ │ │ -1244 w Fm(Network)28 b Fe(:)41 b Fd(DRAFT)30 b Fe(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2838 100 V 0 399 a Fa(1.2.4)112 │ │ │ │ │ -b(IO)38 b(metho)s(ds)0 595 y Fn(There)30 b(are)h(t)m(w)m(o)g(IO)f │ │ │ │ │ -(routines)g(for)h(debugging)f(purp)s(oses.)111 832 y(1.)46 │ │ │ │ │ -b Fm(void)h(Network_writeForHumanEye)41 b(\()48 b(Network)d(*network,)h │ │ │ │ │ -(FILE)g(*fp)h(\))h(;)227 983 y Fn(This)20 b(metho)s(d)f(writes)i(the)f │ │ │ │ │ -(net)m(w)m(ork)h(to)g(a)g(\014le)f(in)g(a)h(h)m(uman)e(readable)i │ │ │ │ │ -(format.)38 b(The)20 b(metho)s(d)f Fm(Network)p 3762 │ │ │ │ │ -983 29 4 v 33 w(writeStats\(\))227 1096 y Fn(is)29 b(called)h(to)f │ │ │ │ │ -(write)g(out)g(the)f(header)h(and)f(statistics.)42 b(Then)28 │ │ │ │ │ -b(the)g(in-list)i(and)e(out-lists)h(for)g(the)f(no)s(des)g(in)227 │ │ │ │ │ -1209 y(the)j(net)m(w)m(ork)g(are)g(prin)m(ted.)227 1359 │ │ │ │ │ -y Fd(Err)-5 b(or)33 b(che)-5 b(cking:)40 b Fn(If)28 b │ │ │ │ │ -Fm(network)f Fn(or)i Fm(fp)g Fn(is)g Fm(NULL)p Fn(,)f(an)h(error)g │ │ │ │ │ -(message)h(is)f(prin)m(ted)f(and)h(the)g(program)g(exits.)111 │ │ │ │ │ -1546 y(2.)46 b Fm(void)h(Network_writeStats)c(\()k(Network)f(*network,) │ │ │ │ │ -f(FILE)i(*fp)g(\))g(;)227 1697 y Fn(This)30 b(metho)s(d)g(writes)g(a)h │ │ │ │ │ -(header)f(and)g(statistics)i(to)f(a)g(\014le.)227 1847 │ │ │ │ │ -y Fd(Err)-5 b(or)33 b(che)-5 b(cking:)40 b Fn(If)28 b │ │ │ │ │ -Fm(network)f Fn(or)i Fm(fp)g Fn(is)g Fm(NULL)p Fn(,)f(an)h(error)g │ │ │ │ │ -(message)h(is)f(prin)m(ted)f(and)h(the)g(program)g(exits.)p │ │ │ │ │ -eop end │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 136 100 1081 4 v │ │ │ │ │ +1263 w Fm(Network)29 b Fe(:)40 b Fd(DRAFT)30 b Fe(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2819 100 V 0 399 a Fa(1.2.4)112 b(IO)38 b(metho)s(ds)0 │ │ │ │ │ +595 y Fn(There)30 b(are)h(t)m(w)m(o)g(IO)f(routines)g(for)h(debugging)f │ │ │ │ │ +(purp)s(oses.)111 832 y(1.)46 b Fm(void)h(Network_writeForHumanEye)41 │ │ │ │ │ +b(\()48 b(Network)d(*network,)h(FILE)g(*fp)h(\))h(;)227 │ │ │ │ │ +983 y Fn(This)20 b(metho)s(d)f(writes)i(the)f(net)m(w)m(ork)h(to)g(a)g │ │ │ │ │ +(\014le)f(in)g(a)h(h)m(uman)e(readable)i(format.)38 b(The)20 │ │ │ │ │ +b(metho)s(d)f Fm(Network)p 3762 983 29 4 v 33 w(writeStats\(\))227 │ │ │ │ │ +1096 y Fn(is)29 b(called)h(to)f(write)g(out)g(the)f(header)h(and)f │ │ │ │ │ +(statistics.)42 b(Then)28 b(the)g(in-list)i(and)e(out-lists)h(for)g │ │ │ │ │ +(the)f(no)s(des)g(in)227 1209 y(the)j(net)m(w)m(ork)g(are)g(prin)m │ │ │ │ │ +(ted.)227 1359 y Fd(Err)-5 b(or)33 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fn(If)28 b Fm(network)f Fn(or)i Fm(fp)g Fn(is)g Fm(NULL)p │ │ │ │ │ +Fn(,)f(an)h(error)g(message)h(is)f(prin)m(ted)f(and)h(the)g(program)g │ │ │ │ │ +(exits.)111 1546 y(2.)46 b Fm(void)h(Network_writeStats)c(\()k(Network) │ │ │ │ │ +f(*network,)f(FILE)i(*fp)g(\))g(;)227 1697 y Fn(This)30 │ │ │ │ │ +b(metho)s(d)g(writes)g(a)h(header)f(and)g(statistics)i(to)f(a)g │ │ │ │ │ +(\014le.)227 1847 y Fd(Err)-5 b(or)33 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fn(If)28 b Fm(network)f Fn(or)i Fm(fp)g Fn(is)g Fm(NULL)p │ │ │ │ │ +Fn(,)f(an)h(error)g(message)h(is)f(prin)m(ted)f(and)h(the)g(program)g │ │ │ │ │ +(exits.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ TeXDict begin 7 6 bop 0 866 a Fo(Index)0 1289 y Fm(Network)p │ │ │ │ │ 342 1289 29 4 v 32 w(addArc\(\))p Fn(,)29 b(4)0 1402 │ │ │ │ │ y Fm(Network)p 342 1402 V 32 w(augmentPath\(\))p Fn(,)e(5)0 │ │ │ │ │ 1515 y Fm(Network)p 342 1515 V 32 w(clearData\(\))p Fn(,)h(4)0 │ │ │ │ │ 1628 y Fm(Network)p 342 1628 V 32 w(findAugmentingPath\(\))p │ │ │ │ │ Fn(,)e(5)0 1741 y Fm(Network)p 342 1741 V 32 w(findMaxFlow\(\))p │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -31,15 +31,15 @@ │ │ │ │ │ │ B B │ │ │ │ │ │ Similarly, an edge (x,y) where x ∈ Y and y ∈ Y is not found in the network. │ │ │ │ │ │ W W │ │ │ │ │ │ • An edge (x,y) where x ∈ Y and y ∈ Y becomes two edges, (x,y−) and (y+,x), both with │ │ │ │ │ │ B I │ │ │ │ │ │ infinite capacity. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Network : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Network : DRAFT January 7, 2024 │ │ │ │ │ │ • An edge (y,z) where y ∈ Y and z ∈ Y becomes two edges, (y+,z) and (z,y−), both with │ │ │ │ │ │ I W │ │ │ │ │ │ infinite capacity. │ │ │ │ │ │ + − + − │ │ │ │ │ │ • An edge (x,y) where x ∈ Y and y ∈ Y becomes two edges, (x ,y ) and (y ,x ), both with │ │ │ │ │ │ I I │ │ │ │ │ │ infinite capacity. │ │ │ │ │ │ @@ -71,15 +71,15 @@ │ │ │ │ │ │ • ArcChunk – a structure that holds the storage for a number of arcs. Since we do not require │ │ │ │ │ │ the number of arcs to be known in advance when initializing the Network object, we allo- │ │ │ │ │ │ cate chunks of space to hold the arcs as necessary. Each chunks holds space for nnode arc │ │ │ │ │ │ structures. │ │ │ │ │ │ The Network object has six fields. │ │ │ │ │ │ • int nnode — the number of nodes in the network, including the source (node 0) and the sink │ │ │ │ │ │ (node nnode-1). │ │ │ │ │ │ - Network : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Network : DRAFT January 7, 2024 3 │ │ │ │ │ │ • int narc — the number of arcs in the network │ │ │ │ │ │ • int ntrav — the number of arc traversals that we made to find a max flow. │ │ │ │ │ │ • Arc **inheads — pointer to a vector of pointers to Arc, inheads[v] points to the first arc │ │ │ │ │ │ in the in-list for node v. │ │ │ │ │ │ • Arc **outheads — pointer to a vector of pointers to Arc, outheads[v] points to the first │ │ │ │ │ │ arc in the out-list for node v. │ │ │ │ │ │ • ArcChunk *chunk — pointer to the first ArcChunk structure. │ │ │ │ │ │ @@ -99,15 +99,15 @@ │ │ │ │ │ │ • int size — the total number of Arc structures in this chunk. │ │ │ │ │ │ • int inuse — the number of active Arc structures in this chunk. │ │ │ │ │ │ • Arc *base — pointer to the first Arc structure in this chunk. │ │ │ │ │ │ • ArcChunk *next — pointer to the next ArcChunk structure in the list of chunks. │ │ │ │ │ │ 1.2 Prototypes and descriptions of Network methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ Network object. │ │ │ │ │ │ - 4 Network : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Network : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. Network * Network_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the Network structure and then sets the default │ │ │ │ │ │ fields by a call to Network setDefaultFields(). │ │ │ │ │ │ 2. void Network_setDefaultFields ( Network *network ) ; │ │ │ │ │ │ @@ -135,15 +135,15 @@ │ │ │ │ │ │ 3. void Network_addArc ( Network *network, int firstNode, secondNode, │ │ │ │ │ │ int capacity, int flow ) ; │ │ │ │ │ │ This method adds an arc from firstNode to secondNode with flow flow and capacity │ │ │ │ │ │ capacity. The arc is inserted in the out-list for firstNode and the in-list for secondNode. │ │ │ │ │ │ Error checking: If network is NULL, or if nnode ≤ 0, or if firstNode ≤ 0, or if nnode ≤ │ │ │ │ │ │ firstNode, or if secondNode ≤ 0, or if nnode ≤ secondNode, or if capacity ≤ 0, an error │ │ │ │ │ │ message is printed and the program exits. │ │ │ │ │ │ - Network : DRAFT February 8, 2025 5 │ │ │ │ │ │ + Network : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.2.3 Utility methods │ │ │ │ │ │ 1. void Network_findMaxFlow ( Network *network ) ; │ │ │ │ │ │ This method finds a maximum flow over the network by repeatedly calling the method to │ │ │ │ │ │ find an augmenting path and then the method to augment the path. It uses an Ideq object │ │ │ │ │ │ to maintain a priority dequeue. │ │ │ │ │ │ Error checking: If network is NULL, or if nnode ≤ 0, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ @@ -172,15 +172,15 @@ │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 5. void Network_findMincutFromSink ( Network *network, Ideq deq, int mark[]) ; │ │ │ │ │ │ This method finds the min-cut closest to the sink by traversing a tree of flow-alternating │ │ │ │ │ │ paths into the sink. On return, mark[v] = 1 if the node v is in the component that contains │ │ │ │ │ │ the source. If the node v is in the component that contains the sink, then mark[v] = 2. │ │ │ │ │ │ Error checking: If network, deq or mark is NULL, or if nnode ≤ 0, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ - 6 Network : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 Network : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.4 IO methods │ │ │ │ │ │ There are two IO routines for debugging purposes. │ │ │ │ │ │ 1. void Network_writeForHumanEye ( Network *network, FILE *fp ) ; │ │ │ │ │ │ Thismethodwritesthenetworktoafileinahumanreadableformat. ThemethodNetwork writeStats() │ │ │ │ │ │ is called to write out the header and statistics. Then the in-list and out-lists for the nodes in │ │ │ │ │ │ the network are printed. │ │ │ │ │ │ Error checking: If network or fp is NULL, an error message is printed and the program exits. │ │ │ ├── ./usr/share/doc/spooles-doc/PatchAndGoInfo.ps.gz │ │ │ │ ├── PatchAndGoInfo.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o PatchAndGoInfo.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2040,21 +2040,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2238,88 +2237,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4776,15 +4770,15 @@ │ │ │ │ │ 1[62 5[62 65[{}12 119.552 /CMTT12 rf /Fc 149[25 2[45 │ │ │ │ │ 45 81[71 18[25 1[{}5 90.9091 /CMSY10 rf /Fd 132[52 123[{}1 │ │ │ │ │ 90.9091 /CMBX10 rf /Fe 134[71 3[75 52 53 55 1[75 67 75 │ │ │ │ │ 112 3[37 75 1[41 61 75 60 1[65 13[75 2[92 11[103 17[67 │ │ │ │ │ 67 2[37 46[{}22 119.552 /CMBX12 rf /Ff 141[38 2[46 51 │ │ │ │ │ 2[42 1[28 46 42 1[42 1[42 14[65 1[66 11[59 62 69 2[68 │ │ │ │ │ 6[28 58[{}16 90.9091 /CMTI10 rf /Fg 134[48 3[51 2[36 │ │ │ │ │ -12[40 2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 │ │ │ │ │ +3[51 12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 │ │ │ │ │ 90.9091 /CMSL10 rf /Fh 255[55{}1 66.4176 /CMSY8 rf /Fi │ │ │ │ │ 220[48 48 34[{}2 83.022 /CMEX10 rf /Fj 149[29 24 20[41 │ │ │ │ │ 21[55 2[20 59[{}5 66.4176 /CMMI8 rf /Fk 205[35 35 49[{}2 │ │ │ │ │ 66.4176 /CMR8 rf /Fl 149[37 31 16[75 11[62 7[75 1[69 │ │ │ │ │ 68 2[71 2[25 59[{}9 90.9091 /CMMI10 rf │ │ │ │ │ %DVIPSBitmapFont: Fm tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ @@ -4914,24 +4908,24 @@ │ │ │ │ │ (is)f(to)h(not)f(use)g(piv)m(oting,)i(but)227 5294 y(to)38 │ │ │ │ │ b(c)m(hec)m(k)h(the)e(magnitude)g(of)g(the)g(diagonal)h(en)m(try)g(as)f │ │ │ │ │ (a)g(ro)m(w)g(and)g(column)g(is)g(to)g(b)s(e)g(eliminated.)61 │ │ │ │ │ b(If)227 5407 y(the)35 b(magnitude)g(is)g(smaller)g(than)f(a)i │ │ │ │ │ (user-supplied)d(parameter,)j(the)f(diagonal)h(en)m(try)f(is)g(set)g │ │ │ │ │ (to)h(some)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 895 4 v │ │ │ │ │ -1077 w Fn(PatchAndGoInfo)27 b Fg(:)40 b Ff(DRAFT)30 b │ │ │ │ │ -Fg(F)-8 b(ebruary)31 b(8,)g(2025)p 3005 100 V 227 399 │ │ │ │ │ -a Fo(m)m(ultiple)c(of)f(the)h(largest)g(o\013diagonal)h(en)m(try)f(in)f │ │ │ │ │ -(that)g(ro)m(w)h(and)e(column)h(of)h(the)f(fron)m(t,)h(the)g(lo)s │ │ │ │ │ -(cation)h(and)227 511 y(p)s(erturbation)i(is)g(noted,)h(and)f(the)g │ │ │ │ │ -(factorization)j(pro)s(ceeds.)141 728 y(Other)27 b(strategies)h(can)f │ │ │ │ │ -(b)s(e)g(added)f(to)i(the)f Fn(PatchAndGoInfo)c Fo(ob)5 │ │ │ │ │ -b(ject.)40 b(F)-8 b(or)28 b(example,)g(if)f(a)g(matrix)g(is)g(b)s(eing) │ │ │ │ │ -0 841 y(factored)34 b(that)g(is)g(b)s(eliev)m(ed)g(to)g(b)s(e)f(p)s │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 914 4 v │ │ │ │ │ +1096 w Fn(PatchAndGoInfo)27 b Fg(:)40 b Ff(DRAFT)30 b │ │ │ │ │ +Fg(Jan)m(uary)g(7,)h(2024)p 2986 100 V 227 399 a Fo(m)m(ultiple)c(of)f │ │ │ │ │ +(the)h(largest)g(o\013diagonal)h(en)m(try)f(in)f(that)g(ro)m(w)h(and)e │ │ │ │ │ +(column)h(of)h(the)f(fron)m(t,)h(the)g(lo)s(cation)h(and)227 │ │ │ │ │ +511 y(p)s(erturbation)i(is)g(noted,)h(and)f(the)g(factorization)j(pro)s │ │ │ │ │ +(ceeds.)141 728 y(Other)27 b(strategies)h(can)f(b)s(e)g(added)f(to)i │ │ │ │ │ +(the)f Fn(PatchAndGoInfo)c Fo(ob)5 b(ject.)40 b(F)-8 │ │ │ │ │ +b(or)28 b(example,)g(if)f(a)g(matrix)g(is)g(b)s(eing)0 │ │ │ │ │ +841 y(factored)34 b(that)g(is)g(b)s(eliev)m(ed)g(to)g(b)s(e)f(p)s │ │ │ │ │ (ositiv)m(e)h(de\014nite,)g(and)f(a)h(negativ)m(e)i(v)-5 │ │ │ │ │ b(alue)33 b(is)h(found)e(in)h(a)h(piv)m(ot)g(elemen)m(t,)0 │ │ │ │ │ 954 y(one)d(could)f(ab)s(ort)g(the)h(factorization,)i(or)e(p)s(erturb)d │ │ │ │ │ (the)i(elemen)m(t)i(so)f(that)g(it)g(is)f(p)s(ositiv)m(e.)0 │ │ │ │ │ 1270 y Fe(1.1)135 b(Data)46 b(Structure)0 1500 y Fo(The)30 │ │ │ │ │ b Fn(PatchAndGoInfo)c Fo(structure)k(has)g(\014v)m(e)h(\014elds.)137 │ │ │ │ │ 1716 y Fm(\210)45 b Fn(int)i(strategy)28 b Fo(:)41 b(t)m(yp)s(e)30 │ │ │ │ │ @@ -4978,17 +4972,17 @@ │ │ │ │ │ (default)h(v)-5 b(alues:)41 b Fn(strategy)28 b Fo(=)i(-1,)h │ │ │ │ │ Fn(toosmall)d Fo(=)h Fn(fudge)227 5255 y Fo(=)h(0.0,)i(and)e │ │ │ │ │ Fn(fudgeIV)e Fo(=)i Fn(fudgeDV)f Fo(=)h Fn(NULL)f Fo(.)227 │ │ │ │ │ 5407 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ b Fn(info)g Fo(is)g Fn(NULL)p Fo(,)f(an)i(error)f(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)f(the)i(program)f(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 895 4 v 1077 100 a Fn(PatchAndGoInfo)26 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2958 100 V 895 w Fo(3)111 399 y(3.)46 b Fn(void)h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 914 4 v 1096 100 a Fn(PatchAndGoInfo)26 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2939 100 V 914 w Fo(3)111 399 y(3.)46 b Fn(void)h │ │ │ │ │ (PatchAndGoInfo_clearData)41 b(\()48 b(PatchAndGoInfo)43 │ │ │ │ │ b(*info)k(\))g(;)227 549 y Fo(This)35 b(metho)s(d)f(clears)i(an)m(y)g │ │ │ │ │ (data)f(o)m(wned)g(b)m(y)g(the)h(ob)5 b(ject.)56 b(If)34 │ │ │ │ │ b Fn(fudgeIV)f Fo(is)i(not)h Fn(NULL)e Fo(it)h(is)h(free'd)f(b)m(y)g(a) │ │ │ │ │ 227 662 y(call)c(to)f Fn(IV)p 605 662 29 4 v 34 w(free\(\))p │ │ │ │ │ Fo(.)38 b(If)29 b Fn(fudgeDV)e Fo(is)i(not)h Fn(NULL)e │ │ │ │ │ Fo(it)i(is)f(free'd)g(b)m(y)g(a)h(call)g(to)g Fn(DV)p │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -26,15 +26,15 @@ │ │ │ │ │ │ If A is singular, the solution X = 0 and X = A−1B is perfectly acceptable. In other │ │ │ │ │ │ 1,1 1 2 2,2 2 │ │ │ │ │ │ cases, the location of the singularity can be communicated back to the user to supply useful │ │ │ │ │ │ information about the finite element model. One common practice is to not use pivoting, but │ │ │ │ │ │ to check the magnitude of the diagonal entry as a row and column is to be eliminated. If │ │ │ │ │ │ the magnitude is smaller than a user-supplied parameter, the diagonal entry is set to some │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 PatchAndGoInfo : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 PatchAndGoInfo : DRAFT January 7, 2024 │ │ │ │ │ │ multiple of the largest offdiagonal entry in that row and column of the front, the location and │ │ │ │ │ │ perturbation is noted, and the factorization proceeds. │ │ │ │ │ │ Other strategies can be added to the PatchAndGoInfo object. For example, if a matrix is being │ │ │ │ │ │ factored that is believed to be positive definite, and a negative value is found in a pivot element, │ │ │ │ │ │ one could abort the factorization, or perturb the element so that it is positive. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ The PatchAndGoInfo structure has five fields. │ │ │ │ │ │ @@ -58,15 +58,15 @@ │ │ │ │ │ │ 1. PatchAndGoInfo * PatchAndGoInfo_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the PatchAndGoInfo structure and then sets the │ │ │ │ │ │ default fields by a call to PatchAndGoInfo setDefaultFields(). │ │ │ │ │ │ 2. void PatchAndGoInfo_setDefaultFields ( PatchAndGoInfo *info ) ; │ │ │ │ │ │ This method sets the structure’s fields to default values: strategy = -1, toosmall = fudge │ │ │ │ │ │ =0.0, and fudgeIV = fudgeDV = NULL . │ │ │ │ │ │ Error checking: If info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - PatchAndGoInfo : DRAFT February 8, 2025 3 │ │ │ │ │ │ + PatchAndGoInfo : DRAFT January 7, 2024 3 │ │ │ │ │ │ 3. void PatchAndGoInfo_clearData ( PatchAndGoInfo *info ) ; │ │ │ │ │ │ This method clears any data owned by the object. If fudgeIV is not NULL it is free’d by a │ │ │ │ │ │ call to IV free(). If fudgeDV is not NULL it is free’d by a call to DV free(). The structure’s │ │ │ │ │ │ default fields are then set with a call to PatchAndGoInfo setDefaultFields(). │ │ │ │ │ │ Error checking: If info is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void PatchAndGoInfo_free ( PatchAndGoInfo *info ) ; │ │ │ │ │ │ This method releases any storage by a call to PatchAndGoInfo clearData() then free’s the │ │ │ ├── ./usr/share/doc/spooles-doc/Pencil.ps.gz │ │ │ │ ├── Pencil.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Pencil.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1881,21 +1881,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2079,88 +2078,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4111,16 +4105,16 @@ │ │ │ │ │ TeXDict begin 40258437 52099151 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 171[41 84[{}1 66.4176 /CMMI8 rf /Fb 152[45 │ │ │ │ │ 45 102[{}2 90.9091 /CMSY10 rf /Fc 133[50 59 4[44 44 3[56 │ │ │ │ │ 62 93 31 2[31 62 2[51 62 50 1[54 11[86 5[84 5[42 6[80 │ │ │ │ │ 13[56 56 56 56 2[31 46[{}23 99.6264 /CMBX12 rf /Fd 141[38 │ │ │ │ │ 2[46 51 2[42 1[28 46 42 1[42 1[42 14[65 1[66 11[59 62 │ │ │ │ │ 69 2[68 6[28 58[{}16 90.9091 /CMTI10 rf /Fe 134[48 3[51 │ │ │ │ │ -2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 │ │ │ │ │ -44[{}13 90.9091 /CMSL10 rf /Ff 145[62 1[62 2[62 3[62 │ │ │ │ │ +2[36 3[51 12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 │ │ │ │ │ +44[{}12 90.9091 /CMSL10 rf /Ff 145[62 1[62 2[62 3[62 │ │ │ │ │ 1[62 18[62 80[{}6 119.552 /CMTT12 rf /Fg 132[52 6[41 │ │ │ │ │ 4[52 9[48 22[82 19[29 58[{}6 90.9091 /CMBX10 rf │ │ │ │ │ %DVIPSBitmapFont: Fh tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ @@ -4219,24 +4213,24 @@ │ │ │ │ │ (shift)f(v)-5 b(alue.)0 5061 y Fi(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ b(and)f(descriptions)g(of)g Ff(Pencil)d Fi(metho)t(ds)0 │ │ │ │ │ 5294 y Fl(This)f(section)j(con)m(tains)f(brief)f(descriptions)g │ │ │ │ │ (including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f(that)h(b)s │ │ │ │ │ (elong)f(to)h(the)0 5407 y Fj(Pencil)29 b Fl(ob)5 b(ject.)1927 │ │ │ │ │ 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fl(2)p 136 100 1158 4 v │ │ │ │ │ -1340 w Fj(Chv)29 b Fe(:)41 b Fd(DRAFT)30 b Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2743 100 V 0 399 a Fc(1.2.1)112 b(Basic)38 │ │ │ │ │ -b(metho)s(ds)0 600 y Fl(As)d(usual,)h(there)f(are)g(four)f(basic)h │ │ │ │ │ -(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e │ │ │ │ │ -(default)f(\014elds,)h(clearing)0 712 y(an)m(y)31 b(allo)s(cated)h │ │ │ │ │ -(data,)f(and)f(free'ing)h(the)g(ob)5 b(ject.)111 962 │ │ │ │ │ -y(1.)46 b Fj(Pencil)g(*)i(Pencil_new)d(\()i(void)g(\))g(;)227 │ │ │ │ │ -1117 y Fl(This)25 b(metho)s(d)g(simply)f(allo)s(cates)k(storage)f(for)e │ │ │ │ │ -(the)h Fj(Pencil)d Fl(structure)i(and)g(then)g(sets)g(the)h(default)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fl(2)p 136 100 1177 4 v │ │ │ │ │ +1359 w Fj(Chv)29 b Fe(:)41 b Fd(DRAFT)30 b Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2724 100 V 0 399 a Fc(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +600 y Fl(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ +(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ +(\014elds,)h(clearing)0 712 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ +(free'ing)h(the)g(ob)5 b(ject.)111 962 y(1.)46 b Fj(Pencil)g(*)i │ │ │ │ │ +(Pencil_new)d(\()i(void)g(\))g(;)227 1117 y Fl(This)25 │ │ │ │ │ +b(metho)s(d)g(simply)f(allo)s(cates)k(storage)f(for)e(the)h │ │ │ │ │ +Fj(Pencil)d Fl(structure)i(and)g(then)g(sets)g(the)h(default)f │ │ │ │ │ (\014elds)227 1230 y(b)m(y)31 b(a)f(call)i(to)f Fj(Pencil)p │ │ │ │ │ 1001 1230 29 4 v 33 w(setDefaultFields\(\))p Fl(.)111 │ │ │ │ │ 1427 y(2.)46 b Fj(void)h(Pencil_setDefaultFields)41 b(\()48 │ │ │ │ │ b(Pencil)e(*pencil)g(\))h(;)227 1581 y Fl(The)35 b(structure's)h │ │ │ │ │ (\014elds)f(are)h(set)g(to)g(default)g(v)-5 b(alues:)52 │ │ │ │ │ b Fj(sigma[2])45 b(=)j Fb(f)p Fj(0,0)p Fb(g)p Fl(,)37 │ │ │ │ │ b Fj(type)d Fl(=)h Fj(SPOOLES)p 3657 1581 V 33 w(REAL)p │ │ │ │ │ @@ -4285,17 +4279,17 @@ │ │ │ │ │ (the)e Fj(InpMtx)p 1709 5139 V 33 w(changeStorageMode\(\))25 │ │ │ │ │ b Fl(metho)s(d)k(for)h(eac)m(h)i(of)e(its)h(t)m(w)m(o)g(ma-)227 │ │ │ │ │ 5252 y(trices.)227 5407 y Fd(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fl(If)30 b Fj(pencil)f Fl(is)h Fj(NULL)p │ │ │ │ │ Fl(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g(zero)h(is)f │ │ │ │ │ (returned.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1158 4 v 1339 100 a Fj(Chv)30 │ │ │ │ │ -b Fe(:)40 b Fd(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2695 100 V 1158 w Fl(3)111 399 y(3.)46 b Fj(void)h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1177 4 v 1358 100 a Fj(Chv)30 │ │ │ │ │ +b Fe(:)40 b Fd(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2676 100 V 1177 w Fl(3)111 399 y(3.)46 b Fj(void)h │ │ │ │ │ (Pencil_sortAndCompress)42 b(\()47 b(Pencil)f(*pencil)g(\))h(;)227 │ │ │ │ │ 554 y Fl(This)20 b(metho)s(d)h(simply)f(calls)i(the)f │ │ │ │ │ Fj(InpMtx)p 1662 554 29 4 v 33 w(sortAndCompress\(\))16 │ │ │ │ │ b Fl(metho)s(d)k(for)h(eac)m(h)h(of)f(its)g(t)m(w)m(o)i(matrices.)227 │ │ │ │ │ 709 y Fd(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fl(If)30 │ │ │ │ │ b Fj(pencil)f Fl(is)h Fj(NULL)p Fl(,)g(an)g(error)g(message)i(is)e │ │ │ │ │ (prin)m(ted)g(and)g(zero)h(is)f(returned.)111 906 y(4.)46 │ │ │ │ │ @@ -4356,19 +4350,19 @@ │ │ │ │ │ 5294 y Fj(SPOOLES)p 569 5294 V 33 w(HERMITIAN)p Fl(,)38 │ │ │ │ │ b(en)m(tries)j(in)f(the)h(lo)m(w)m(er)g(triangle)h(are)f(dropp)s(ed.)68 │ │ │ │ │ b(If)40 b Fj(randomflag)e Fl(is)i(one,)k(the)227 5407 │ │ │ │ │ y(en)m(tries)31 b(are)g(\014lled)f(with)g(random)g(n)m(um)m(b)s(ers)f │ │ │ │ │ (using)h(the)g Fj(Drand)f Fl(random)h(n)m(um)m(b)s(er)f(generator)j │ │ │ │ │ Fj(drand)p Fl(.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fl(4)p 136 100 1158 4 v │ │ │ │ │ -1340 w Fj(Chv)29 b Fe(:)41 b Fd(DRAFT)30 b Fe(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2743 100 V 227 399 a Fg(Note:)52 b Fl(this)36 │ │ │ │ │ -b(metho)s(d)g(w)m(as)g(created)i(for)e(an)g(MPI)g(application.)59 │ │ │ │ │ -b(If)36 b Fj(myid)f Fl(is)h(zero,)j(then)d(the)g(\014les)h(are)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fl(4)p 136 100 1177 4 v │ │ │ │ │ +1359 w Fj(Chv)29 b Fe(:)41 b Fd(DRAFT)30 b Fe(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2724 100 V 227 399 a Fg(Note:)52 b Fl(this)36 b(metho)s(d)g(w)m(as)g │ │ │ │ │ +(created)i(for)e(an)g(MPI)g(application.)59 b(If)36 b │ │ │ │ │ +Fj(myid)f Fl(is)h(zero,)j(then)d(the)g(\014les)h(are)227 │ │ │ │ │ 511 y(read)30 b(in,)g(otherwise)h(just)e(stubs)g(are)h(created)h(for)f │ │ │ │ │ (the)g(in)m(ternal)h(matrix)f(ob)5 b(jects.)41 b(In)30 │ │ │ │ │ b(our)f(MPI)h(driv)m(ers,)227 624 y(pro)s(cess)d(zero)i(reads)e(in)g │ │ │ │ │ (the)h(matrices)g(and)f(then)g(starts)h(the)g(pro)s(cess)f(to)h │ │ │ │ │ (distribute)f(them)h(to)g(the)g(other)227 737 y(pro)s(cesses.)227 │ │ │ │ │ 888 y Fd(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fl(If)30 │ │ │ │ │ b Fj(pencil)f Fl(or)h Fj(fp)g Fl(are)h Fj(NULL)p Fl(,)e(an)i(error)f │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -16,15 +16,15 @@ │ │ │ │ │ │ • InpMtx *inpmtxB : pointer to the matrix object for B. If inpmtxB is NULL, then B is the │ │ │ │ │ │ identity matrix. │ │ │ │ │ │ • double sigma[2] : real or complex scalar shift value. │ │ │ │ │ │ 1.2 Prototypes and descriptions of Pencil methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ Pencil object. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. Pencil * Pencil_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the Pencil structure and then sets the default fields │ │ │ │ │ │ by a call to Pencil setDefaultFields(). │ │ │ │ │ │ 2. void Pencil_setDefaultFields ( Pencil *pencil ) ; │ │ │ │ │ │ @@ -48,15 +48,15 @@ │ │ │ │ │ │ 1. void Pencil_changeCoordType ( Pencil *pencil, int newType ) ; │ │ │ │ │ │ ThismethodsimplycallstheInpMtx changeCoordType()methodforeachofitstwomatrices. │ │ │ │ │ │ Error checking: If pencil is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 2. void Pencil_changeStorageMode ( Pencil *pencil, int newMode ) ; │ │ │ │ │ │ This method simply calls the InpMtx changeStorageMode() method for each of its two ma- │ │ │ │ │ │ trices. │ │ │ │ │ │ Error checking: If pencil is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - Chv : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Chv : DRAFT January 7, 2024 3 │ │ │ │ │ │ 3. void Pencil_sortAndCompress ( Pencil *pencil ) ; │ │ │ │ │ │ ThismethodsimplycallstheInpMtx sortAndCompress()methodforeachofitstwomatrices. │ │ │ │ │ │ Error checking: If pencil is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 4. void Pencil_convertToVectors ( Pencil *pencil ) ; │ │ │ │ │ │ ThismethodsimplycallstheInpMtx sortAndCompress()methodforeachofitstwomatrices. │ │ │ │ │ │ Error checking: If pencil is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 5. void Pencil_mapToLowerTriangle ( Pencil *pencil ) ; │ │ │ │ │ │ @@ -83,15 +83,15 @@ │ │ │ │ │ │ 1. Pencil * Pencil_setup ( int myid, int symflag, char *inpmtxAfile, │ │ │ │ │ │ double sigma[], char *inpmtxBfile, int randomflag, Drand *drand, │ │ │ │ │ │ int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method is used to read in the matrices from two files and initialize the objects. If │ │ │ │ │ │ the file name is “none”, then no matrix is read. If symflag is SPOOLES SYMMETRIC or │ │ │ │ │ │ SPOOLES HERMITIAN, entries in the lower triangle are dropped. If randomflag is one, the │ │ │ │ │ │ entries are filled with random numbers using the Drand random number generator drand. │ │ │ │ │ │ - 4 Chv : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Chv : DRAFT January 7, 2024 │ │ │ │ │ │ Note: this method was created for an MPI application. If myid is zero, then the files are │ │ │ │ │ │ read in, otherwise just stubs are created for the internal matrix objects. In our MPI drivers, │ │ │ │ │ │ process zero reads in the matrices and then starts the process to distribute them to the other │ │ │ │ │ │ processes. │ │ │ │ │ │ Error checking: If pencil or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 2. int Pencil_readFromFiles ( Pencil *pencil, char *fnA, char *fnB ) ; │ │ │ │ │ │ This method reads the two InpMtx objects from two files. If fnA is “none”, then A is not │ │ │ ├── ./usr/share/doc/spooles-doc/Perm.ps.gz │ │ │ │ ├── Perm.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Perm.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1015,21 +1015,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1213,88 +1212,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3519,19 +3513,19 @@ │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ cleartomark │ │ │ │ │ {restore}if │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 133[50 59 4[44 44 46 2[56 62 93 31 2[31 62 │ │ │ │ │ 2[51 62 50 1[54 11[86 5[84 5[42 6[80 13[56 56 56 56 2[31 │ │ │ │ │ -46[{}24 99.6264 /CMBX12 rf /Fb 134[48 3[51 2[36 12[40 │ │ │ │ │ -2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 │ │ │ │ │ -90.9091 /CMSL10 rf /Fc 141[62 4[62 7[62 20[62 80[{}4 │ │ │ │ │ -119.552 /CMTT12 rf /Fd 222[91 32[71{}2 90.9091 /CMSY10 │ │ │ │ │ -rf /Fe 132[52 123[{}1 90.9091 /CMBX10 rf │ │ │ │ │ +46[{}24 99.6264 /CMBX12 rf /Fb 134[48 3[51 2[36 3[51 │ │ │ │ │ +12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 │ │ │ │ │ +/CMSL10 rf /Fc 141[62 4[62 7[62 20[62 80[{}4 119.552 │ │ │ │ │ +/CMTT12 rf /Fd 222[91 32[71{}2 90.9091 /CMSY10 rf /Fe │ │ │ │ │ +132[52 123[{}1 90.9091 /CMBX10 rf │ │ │ │ │ %DVIPSBitmapFont: Ff tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3623,45 +3617,45 @@ │ │ │ │ │ b(to)h(the)g(old-to-new)g(v)m(ector)0 5045 y Fh(1.2)135 │ │ │ │ │ b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g Fc(Perm)e │ │ │ │ │ Fh(metho)t(ds)0 5294 y Fj(This)25 b(section)h(con)m(tains)h(brief)e │ │ │ │ │ (descriptions)h(including)f(protot)m(yp)s(es)h(of)f(all)i(metho)s(ds)d │ │ │ │ │ (that)j(b)s(elong)e(to)h(the)g Fi(Perm)0 5407 y Fj(ob)5 │ │ │ │ │ b(ject.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1139 4 v │ │ │ │ │ -1321 w Fi(PERM)29 b Fb(:)h Fg(DRAFT)h Fb(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2762 100 V 0 399 a Fa(1.2.1)112 b(Basic)38 │ │ │ │ │ -b(metho)s(ds)0 601 y Fj(As)d(usual,)h(there)f(are)g(four)f(basic)h │ │ │ │ │ -(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e │ │ │ │ │ -(default)f(\014elds,)h(clearing)0 714 y(an)m(y)31 b(allo)s(cated)h │ │ │ │ │ -(data,)f(and)f(free'ing)h(the)g(ob)5 b(ject.)111 965 │ │ │ │ │ -y(1.)46 b Fi(Perm)h(*)g(Perm_new)f(\()h(void)g(\))g(;)227 │ │ │ │ │ -1121 y Fj(This)32 b(metho)s(d)f(simply)h(allo)s(cates)i(storage)g(for)e │ │ │ │ │ -(the)g Fi(Perm)f Fj(structure)h(and)f(then)h(sets)h(the)f(default)g │ │ │ │ │ -(\014elds)227 1234 y(b)m(y)f(a)f(call)i(to)f Fi(Perm)p │ │ │ │ │ -905 1234 29 4 v 33 w(setDefaultFields\(\))p Fj(.)111 │ │ │ │ │ -1433 y(2.)46 b Fi(void)h(Perm_setDefaultFields)42 b(\()47 │ │ │ │ │ -b(Perm)g(*perm)f(\))i(;)227 1589 y Fj(This)30 b(metho)s(d)g(sets)g(the) │ │ │ │ │ -h(structure's)f(\014elds)g(to)h(default)g(v)-5 b(alues.)227 │ │ │ │ │ -1745 y Fg(Err)g(or)34 b(che)-5 b(cking:)40 b Fj(If)30 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1158 4 v │ │ │ │ │ +1340 w Fi(PERM)29 b Fb(:)i Fg(DRAFT)f Fb(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2742 100 V 0 399 a Fa(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +601 y Fj(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ +(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ +(\014elds,)h(clearing)0 714 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ +(free'ing)h(the)g(ob)5 b(ject.)111 965 y(1.)46 b Fi(Perm)h(*)g │ │ │ │ │ +(Perm_new)f(\()h(void)g(\))g(;)227 1121 y Fj(This)32 │ │ │ │ │ +b(metho)s(d)f(simply)h(allo)s(cates)i(storage)g(for)e(the)g │ │ │ │ │ +Fi(Perm)f Fj(structure)h(and)f(then)h(sets)h(the)f(default)g(\014elds) │ │ │ │ │ +227 1234 y(b)m(y)f(a)f(call)i(to)f Fi(Perm)p 905 1234 │ │ │ │ │ +29 4 v 33 w(setDefaultFields\(\))p Fj(.)111 1433 y(2.)46 │ │ │ │ │ +b Fi(void)h(Perm_setDefaultFields)42 b(\()47 b(Perm)g(*perm)f(\))i(;) │ │ │ │ │ +227 1589 y Fj(This)30 b(metho)s(d)g(sets)g(the)h(structure's)f │ │ │ │ │ +(\014elds)g(to)h(default)g(v)-5 b(alues.)227 1745 y Fg(Err)g(or)34 │ │ │ │ │ +b(che)-5 b(cking:)40 b Fj(If)30 b Fi(perm)g Fj(is)g Fi(NULL)p │ │ │ │ │ +Fj(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ +(exits.)111 1944 y(3.)46 b Fi(void)h(Perm_clearData)d(\()j(Perm)g │ │ │ │ │ +(*perm)f(\))i(;)227 2100 y Fj(This)36 b(metho)s(d)g(clears)i(data)f(o)m │ │ │ │ │ +(wned)g(b)m(y)f(the)h(ob)5 b(ject.)61 b(If)36 b Fi(perm->newToOld)d │ │ │ │ │ +Fj(is)k(not)g Fi(NULL)p Fj(,)e(its)i(storage)227 2213 │ │ │ │ │ +y(is)21 b(free'd)g(with)f(a)h(call)h(to)g Fi(IVfree\(\))p │ │ │ │ │ +Fj(.)35 b(If)20 b Fi(perm->oldToNew)d Fj(is)k(not)g Fi(NULL)p │ │ │ │ │ +Fj(,)e(its)j(storage)g(is)f(free'd)f(with)h(a)g(call)227 │ │ │ │ │ +2326 y(to)g Fi(IVfree\(\))p Fj(.)35 b(The)20 b(structure's)g(default)h │ │ │ │ │ +(\014elds)e(are)i(then)f(set)h(with)f(a)g(call)i(to)f │ │ │ │ │ +Fi(Perm)p 3097 2326 V 33 w(setDefaultFields\(\))p Fj(.)227 │ │ │ │ │ +2482 y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 │ │ │ │ │ b Fi(perm)g Fj(is)g Fi(NULL)p Fj(,)f(an)i(error)f(message)h(is)g(prin)m │ │ │ │ │ -(ted)f(and)f(the)i(program)f(exits.)111 1944 y(3.)46 │ │ │ │ │ -b Fi(void)h(Perm_clearData)d(\()j(Perm)g(*perm)f(\))i(;)227 │ │ │ │ │ -2100 y Fj(This)36 b(metho)s(d)g(clears)i(data)f(o)m(wned)g(b)m(y)f(the) │ │ │ │ │ -h(ob)5 b(ject.)61 b(If)36 b Fi(perm->newToOld)d Fj(is)k(not)g │ │ │ │ │ -Fi(NULL)p Fj(,)e(its)i(storage)227 2213 y(is)21 b(free'd)g(with)f(a)h │ │ │ │ │ -(call)h(to)g Fi(IVfree\(\))p Fj(.)35 b(If)20 b Fi(perm->oldToNew)d │ │ │ │ │ -Fj(is)k(not)g Fi(NULL)p Fj(,)e(its)j(storage)g(is)f(free'd)f(with)h(a)g │ │ │ │ │ -(call)227 2326 y(to)g Fi(IVfree\(\))p Fj(.)35 b(The)20 │ │ │ │ │ -b(structure's)g(default)h(\014elds)e(are)i(then)f(set)h(with)f(a)g │ │ │ │ │ -(call)i(to)f Fi(Perm)p 3097 2326 V 33 w(setDefaultFields\(\))p │ │ │ │ │ -Fj(.)227 2482 y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ -b Fj(If)30 b Fi(perm)g Fj(is)g Fi(NULL)p Fj(,)f(an)i(error)f(message)h │ │ │ │ │ -(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)111 2681 │ │ │ │ │ -y(4.)46 b Fi(void)h(Perm_free)e(\()j(Perm)e(*perm)h(\))g(;)227 │ │ │ │ │ +(ted)f(and)f(the)i(program)f(exits.)111 2681 y(4.)46 │ │ │ │ │ +b Fi(void)h(Perm_free)e(\()j(Perm)e(*perm)h(\))g(;)227 │ │ │ │ │ 2837 y Fj(This)32 b(metho)s(d)h(releases)h(an)m(y)f(storage)i(b)m(y)e │ │ │ │ │ (a)g(call)i(to)e Fi(Perm)p 2282 2837 V 34 w(clearData\(\))c │ │ │ │ │ Fj(then)k(free's)g(the)h(storage)g(for)227 2950 y(the)d(structure)f │ │ │ │ │ (with)g(a)h(call)g(to)g Fi(free\(\))p Fj(.)227 3106 y │ │ │ │ │ Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 b Fi(perm)g │ │ │ │ │ Fj(is)g Fi(NULL)p Fj(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f │ │ │ │ │ (the)i(program)f(exits.)0 3391 y Fa(1.2.2)112 b(Initializer)38 │ │ │ │ │ @@ -3688,17 +3682,17 @@ │ │ │ │ │ (*perm)f(\))i(;)227 5251 y Fj(This)30 b(metho)s(d)g(returns)f(the)h(n)m │ │ │ │ │ (um)m(b)s(er)f(of)i(b)m(ytes)g(tak)m(en)g(b)m(y)g(this)f(ob)5 │ │ │ │ │ b(ject.)227 5407 y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fj(If)30 b Fi(perm)g Fj(is)g Fi(NULL)p Fj(,)f(an)i(error)f(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1139 4 v 1320 100 a Fi(PERM)29 │ │ │ │ │ -b Fb(:)i Fg(DRAFT)121 b Fb(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2714 100 V 1139 w Fj(3)111 399 y(2.)46 b Fi(int)h(Perm_checkPerm)d(\()k │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1158 4 v 1339 100 a Fi(PERM)30 │ │ │ │ │ +b Fb(:)g Fg(DRAFT)121 b Fb(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2695 100 V 1158 w Fj(3)111 399 y(2.)46 b Fi(int)h(Perm_checkPerm)d(\()k │ │ │ │ │ (Perm)e(*perm)h(\))g(;)227 557 y Fj(This)39 b(metho)s(d)g(c)m(hec)m(ks) │ │ │ │ │ i(the)f(v)-5 b(alidit)m(y)41 b(of)e(the)h Fi(Perm)e Fj(ob)5 │ │ │ │ │ b(ject.)69 b(If)39 b Fi(oldToNew)f Fj(is)h(presen)m(t,)j(it)e(is)g(c)m │ │ │ │ │ (hec)m(k)m(ed)227 670 y(to)c(see)f(that)g(it)h(is)f(a)g(true)f(p)s(erm) │ │ │ │ │ m(utation)h(v)m(ector,)j(i.e.,)f(a)e(one-one)h(and)e(on)m(to)i(map)e │ │ │ │ │ (from)h Fi([0,size\))d Fj(to)227 783 y Fi([0,size\))p │ │ │ │ │ Fj(,)d(and)h(similarly)h(for)g Fi(newToOld)d Fj(if)j(it)g(is)f(presen)m │ │ │ │ │ @@ -3758,39 +3752,38 @@ │ │ │ │ │ b(metho)s(ds)0 4952 y Fj(There)30 b(are)h(the)f(usual)g(eigh)m(t)i(IO)e │ │ │ │ │ (routines.)40 b(The)30 b(\014le)h(structure)f(of)g(a)h │ │ │ │ │ Fi(Perm)e Fj(ob)5 b(ject)31 b(is)g(simple:)0 5181 y Fi(isPresent)d │ │ │ │ │ (size)0 5294 y(oldToNew[size])e Fj(\(if)31 b(presen)m(t\))0 │ │ │ │ │ 5407 y Fi(newToOld[size])26 b Fj(\(if)31 b(presen)m(t\))p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1139 4 v │ │ │ │ │ -1321 w Fi(PERM)29 b Fb(:)h Fg(DRAFT)h Fb(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2762 100 V 111 399 a Fj(1.)46 b Fi(int)h │ │ │ │ │ -(Perm_readFromFile)c(\()48 b(Perm)e(*perm,)g(char)h(*fn)g(\))g(;)227 │ │ │ │ │ -552 y Fj(This)29 b(metho)s(d)f(reads)h(a)g Fi(Perm)f │ │ │ │ │ -Fj(ob)5 b(ject)30 b(from)f(a)g(\014le.)41 b(It)29 b(tries)g(to)h(op)s │ │ │ │ │ -(en)e(the)i(\014le)f(and)f(if)h(it)h(is)f(successful,)g(it)227 │ │ │ │ │ -665 y(then)35 b(calls)i Fi(Perm)p 845 665 29 4 v 33 w │ │ │ │ │ -(readFromFormattedFile\(\))29 b Fj(or)36 b Fi(Perm)p │ │ │ │ │ -2320 665 V 33 w(readFromBinaryFile\(\))p Fj(,)c(closes)k(the)g(\014le) │ │ │ │ │ -227 778 y(and)30 b(returns)f(the)i(v)-5 b(alue)31 b(returned)e(from)h │ │ │ │ │ -(the)g(called)i(routine.)227 931 y Fg(Err)-5 b(or)35 │ │ │ │ │ -b(che)-5 b(cking:)43 b Fj(If)31 b Fi(perm)f Fj(or)h Fi(fn)g │ │ │ │ │ -Fj(are)h Fi(NULL)p Fj(,)e(or)i(if)f Fi(fn)g Fj(is)h(not)f(of)h(the)g │ │ │ │ │ -(form)e Fi(*.permf)g Fj(\(for)i(a)f(formatted)227 1044 │ │ │ │ │ -y(\014le\))g(or)f Fi(*.permb)f Fj(\(for)h(a)h(binary)f(\014le\),)h(an)f │ │ │ │ │ -(error)g(message)i(is)e(prin)m(ted)g(and)g(the)g(metho)s(d)g(returns)f │ │ │ │ │ -(zero.)111 1239 y(2.)46 b Fi(int)h(Perm_readFromFormattedFil)o(e)42 │ │ │ │ │ -b(\()47 b(Perm)g(*perm,)f(FILE)h(*fp)g(\))g(;)227 1392 │ │ │ │ │ -y Fj(This)33 b(metho)s(d)g(reads)h(in)f(a)h Fi(Perm)f │ │ │ │ │ -Fj(ob)5 b(ject)35 b(from)e(a)h(formatted)g(\014le.)51 │ │ │ │ │ -b(If)33 b(there)h(are)h(no)e(errors)g(in)h(reading)227 │ │ │ │ │ -1505 y(the)27 b(data,)h(the)f(v)-5 b(alue)27 b Fi(1)g │ │ │ │ │ -Fj(is)f(returned.)39 b(If)26 b(an)g(IO)h(error)f(is)h(encoun)m(tered)g │ │ │ │ │ -(from)f Fi(fscanf)p Fj(,)g(zero)h(is)g(returned.)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1158 4 v │ │ │ │ │ +1340 w Fi(PERM)29 b Fb(:)i Fg(DRAFT)f Fb(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2742 100 V 111 399 a Fj(1.)46 b Fi(int)h(Perm_readFromFile)c(\()48 │ │ │ │ │ +b(Perm)e(*perm,)g(char)h(*fn)g(\))g(;)227 552 y Fj(This)29 │ │ │ │ │ +b(metho)s(d)f(reads)h(a)g Fi(Perm)f Fj(ob)5 b(ject)30 │ │ │ │ │ +b(from)f(a)g(\014le.)41 b(It)29 b(tries)g(to)h(op)s(en)e(the)i(\014le)f │ │ │ │ │ +(and)f(if)h(it)h(is)f(successful,)g(it)227 665 y(then)35 │ │ │ │ │ +b(calls)i Fi(Perm)p 845 665 29 4 v 33 w(readFromFormattedFile\(\))29 │ │ │ │ │ +b Fj(or)36 b Fi(Perm)p 2320 665 V 33 w(readFromBinaryFile\(\))p │ │ │ │ │ +Fj(,)c(closes)k(the)g(\014le)227 778 y(and)30 b(returns)f(the)i(v)-5 │ │ │ │ │ +b(alue)31 b(returned)e(from)h(the)g(called)i(routine.)227 │ │ │ │ │ +931 y Fg(Err)-5 b(or)35 b(che)-5 b(cking:)43 b Fj(If)31 │ │ │ │ │ +b Fi(perm)f Fj(or)h Fi(fn)g Fj(are)h Fi(NULL)p Fj(,)e(or)i(if)f │ │ │ │ │ +Fi(fn)g Fj(is)h(not)f(of)h(the)g(form)e Fi(*.permf)g │ │ │ │ │ +Fj(\(for)i(a)f(formatted)227 1044 y(\014le\))g(or)f Fi(*.permb)f │ │ │ │ │ +Fj(\(for)h(a)h(binary)f(\014le\),)h(an)f(error)g(message)i(is)e(prin)m │ │ │ │ │ +(ted)g(and)g(the)g(metho)s(d)g(returns)f(zero.)111 1239 │ │ │ │ │ +y(2.)46 b Fi(int)h(Perm_readFromFormattedFil)o(e)42 b(\()47 │ │ │ │ │ +b(Perm)g(*perm,)f(FILE)h(*fp)g(\))g(;)227 1392 y Fj(This)33 │ │ │ │ │ +b(metho)s(d)g(reads)h(in)f(a)h Fi(Perm)f Fj(ob)5 b(ject)35 │ │ │ │ │ +b(from)e(a)h(formatted)g(\014le.)51 b(If)33 b(there)h(are)h(no)e │ │ │ │ │ +(errors)g(in)h(reading)227 1505 y(the)27 b(data,)h(the)f(v)-5 │ │ │ │ │ +b(alue)27 b Fi(1)g Fj(is)f(returned.)39 b(If)26 b(an)g(IO)h(error)f(is) │ │ │ │ │ +h(encoun)m(tered)g(from)f Fi(fscanf)p Fj(,)g(zero)h(is)g(returned.)227 │ │ │ │ │ 1618 y(Note,)36 b(if)d(the)g(p)s(erm)m(utation)g(v)m(ectors)h(are)g │ │ │ │ │ (one-based)f(\(as)h(for)f(F)-8 b(ortran\),)35 b(they)e(are)g(con)m(v)m │ │ │ │ │ (erted)i(to)f(zero-)227 1731 y(based)c(v)m(ectors.)227 │ │ │ │ │ 1884 y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 │ │ │ │ │ b Fi(perm)g Fj(or)g Fi(fp)g Fj(are)g Fi(NULL)p Fj(,)g(an)g(error)g │ │ │ │ │ (message)i(is)e(prin)m(ted)g(and)g(zero)h(is)f(returned.)111 │ │ │ │ │ 2079 y(3.)46 b Fi(int)h(Perm_readFromBinaryFile)42 b(\()47 │ │ │ │ │ @@ -3849,17 +3842,17 @@ │ │ │ │ │ 34 w(writeStats\(\))26 b Fj(is)k(called)h(to)f(write)g(out)h(the)f │ │ │ │ │ (header)f(and)g(statistics.)43 b(The)29 b(v)-5 b(alue)31 │ │ │ │ │ b Fi(1)e Fj(is)h(returned.)227 5407 y Fg(Err)-5 b(or)34 │ │ │ │ │ b(che)-5 b(cking:)40 b Fj(If)30 b Fi(perm)g Fj(or)g Fi(fp)g │ │ │ │ │ Fj(are)g Fi(NULL)p Fj(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and) │ │ │ │ │ g(zero)h(is)f(returned.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1139 4 v 1320 100 a Fi(PERM)29 │ │ │ │ │ -b Fb(:)i Fg(DRAFT)121 b Fb(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2714 100 V 1139 w Fj(5)111 399 y(8.)46 b Fi(int)h(Perm_writeStats)d(\() │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1158 4 v 1339 100 a Fi(PERM)30 │ │ │ │ │ +b Fb(:)g Fg(DRAFT)121 b Fb(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2695 100 V 1158 w Fj(5)111 399 y(8.)46 b Fi(int)h(Perm_writeStats)d(\() │ │ │ │ │ j(Perm)g(*perm,)f(FILE)h(*fp)g(\))g(;)227 549 y Fj(This)30 │ │ │ │ │ b(metho)s(d)g(writes)g(out)h(a)f(header)h(and)e(statistics)k(to)e(a)g │ │ │ │ │ (\014le.)40 b(The)30 b(v)-5 b(alue)31 b Fi(1)f Fj(is)h(returned.)227 │ │ │ │ │ 699 y Fg(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fj(If)30 │ │ │ │ │ b Fi(perm)g Fj(or)g Fi(fp)g Fj(are)g Fi(NULL)p Fj(,)g(an)g(error)g │ │ │ │ │ (message)i(is)e(prin)m(ted)g(and)g(zero)h(is)f(returned.)p │ │ │ │ │ eop end │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -14,15 +14,15 @@ │ │ │ │ │ │ • int size : dimension of the vectors │ │ │ │ │ │ • int *newToOld : pointer to the new-to-old vector │ │ │ │ │ │ • int *oldToNew : pointer to the old-to-new vector │ │ │ │ │ │ 1.2 Prototypes and descriptions of Perm methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the Perm │ │ │ │ │ │ object. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 PERM : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 PERM : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. Perm * Perm_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the Perm structure and then sets the default fields │ │ │ │ │ │ by a call to Perm setDefaultFields(). │ │ │ │ │ │ 2. void Perm_setDefaultFields ( Perm *perm ) ; │ │ │ │ │ │ @@ -46,15 +46,15 @@ │ │ │ │ │ │ isPresent == 3 then newToOld and newToOld are set with calls to IVinit(). │ │ │ │ │ │ Error checking: If perm is NULL, or if isPresent is invalid, or if size <= 0, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 1.2.3 Utility methods │ │ │ │ │ │ 1. int Perm_sizeOf ( Perm *perm ) ; │ │ │ │ │ │ This method returns the number of bytes taken by this object. │ │ │ │ │ │ Error checking: If perm is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - PERM : DRAFT February 8, 2025 3 │ │ │ │ │ │ + PERM : DRAFT January 7, 2024 3 │ │ │ │ │ │ 2. int Perm_checkPerm ( Perm *perm ) ; │ │ │ │ │ │ This method checks the validity of the Perm object. If oldToNew is present, it is checked │ │ │ │ │ │ to see that it is a true permutation vector, i.e., a one-one and onto map from [0,size) to │ │ │ │ │ │ [0,size), and similarly for newToOld if it is present. If the permutation vector(s) are valid, │ │ │ │ │ │ 1 is returned, otherwise 0 is returned. │ │ │ │ │ │ Error checking: If perm is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. void Perm_fillOldToNew ( Perm *perm ) ; │ │ │ │ │ │ @@ -80,15 +80,15 @@ │ │ │ │ │ │ compressed graph. │ │ │ │ │ │ Error checking: If perm or eqmapIV are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 1.2.4 IO methods │ │ │ │ │ │ There are the usual eight IO routines. The file structure of a Perm object is simple: │ │ │ │ │ │ isPresent size │ │ │ │ │ │ oldToNew[size] (if present) │ │ │ │ │ │ newToOld[size] (if present) │ │ │ │ │ │ - 4 PERM : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 PERM : DRAFT January 7, 2024 │ │ │ │ │ │ 1. int Perm_readFromFile ( Perm *perm, char *fn ) ; │ │ │ │ │ │ This method reads a Perm object from a file. It tries to open the file and if it is successful, it │ │ │ │ │ │ then calls Perm readFromFormattedFile() or Perm readFromBinaryFile(), closes the file │ │ │ │ │ │ and returns the value returned from the called routine. │ │ │ │ │ │ Error checking: If perm or fn are NULL, or if fn is not of the form *.permf (for a formatted │ │ │ │ │ │ file) or *.permb (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ 2. int Perm_readFromFormattedFile ( Perm *perm, FILE *fp ) ; │ │ │ │ │ │ @@ -117,15 +117,15 @@ │ │ │ │ │ │ This method writes out a Perm object to a binary file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fwrite, zero is returned. │ │ │ │ │ │ Error checking: If perm or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 7. int Perm_writeForHumanEye ( Perm *perm, FILE *fp ) ; │ │ │ │ │ │ This method writes out a Perm object to a file in a human readable format. The method │ │ │ │ │ │ Perm writeStats() is called to write out the header and statistics. The value 1 is returned. │ │ │ │ │ │ Error checking: If perm or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - PERM : DRAFT February 8, 2025 5 │ │ │ │ │ │ + PERM : DRAFT January 7, 2024 5 │ │ │ │ │ │ 8. int Perm_writeStats ( Perm *perm, FILE *fp ) ; │ │ │ │ │ │ This method writes out a header and statistics to a file. The value 1 is returned. │ │ │ │ │ │ Error checking: If perm or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ Index │ │ │ │ │ │ Perm checkPerm(), 4 │ │ │ │ │ │ Perm clearData(), 3 │ │ │ │ │ │ Perm compress(), 4 │ │ │ ├── ./usr/share/doc/spooles-doc/ReferenceManual.ps.gz │ │ │ │ ├── ReferenceManual.ps │ │ │ │ │ @@ -12,15 +12,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o ReferenceManual.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1025 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0424 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -4807,21 +4807,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -5005,88 +5004,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -10608,26 +10602,24 @@ │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 46 /period put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 67 /C put │ │ │ │ │ dup 68 /D put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ dup 74 /J put │ │ │ │ │ dup 75 /K put │ │ │ │ │ dup 80 /P put │ │ │ │ │ dup 87 /W put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 100 /d put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 102 /f put │ │ │ │ │ dup 104 /h put │ │ │ │ │ dup 105 /i put │ │ │ │ │ dup 108 /l put │ │ │ │ │ @@ -10821,183 +10813,169 @@ │ │ │ │ │ 34DE10D995ABCAF45FBB3B6B73E80D05F4C51F8C29D4B0F67C8A86432A6C5E86 │ │ │ │ │ F0126AB25A5CA2875B48C61CB8112A4CF9AA08F8B0157396CF63CBECDB8867CC │ │ │ │ │ AC10F060630C9BFBAD84B1FF01C814878F0C177F552BDC9BB181B14581C6E968 │ │ │ │ │ DAAAB2896FCFB745795C4D2C87CC15BAA041EF80C5BDC12EC1F5786BB41A5A21 │ │ │ │ │ 073EE0BC436B346E014DB4099EDC67BC432E470A4B779FD556341061CA3F2BE8 │ │ │ │ │ EFA332637AEC878C2BB189CA3267B2BE5B8178E6B7889A33771F86276E6F0B8E │ │ │ │ │ 8E93B816AC7005575762EF4DE45E2794B7322F9B6D8E634FB8FF250D638EB502 │ │ │ │ │ -818321B3C46DB51B8EC6C2EF1D05C716519A3BD6B12A67239898F8A010CB8279 │ │ │ │ │ -86D2D942871606D4B8A274C720E46E43BE44C74224A8520232F7F6C96FC7D6D2 │ │ │ │ │ -EB817F578B294EC22FA123ED64613F3AE96DE23AA1833D2A527F282DC80C38CA │ │ │ │ │ -B5A9D66708ED2293AC1F832C82B70993055FCF9BDE6F5DEAECBE5345572E7D78 │ │ │ │ │ -71D938095EE457512DAABB5278FFBB263323B7FBDC84B52650114DC3DF9E57BB │ │ │ │ │ -C1835D2D17273F234A45642152EA125D909CA252173DAE4D0073D71DC3823955 │ │ │ │ │ -488FADCF5F3B1E500A3059C4E00DAECB29BCACE5456AE77DB22FB7F97E9B9BF2 │ │ │ │ │ -6D89F8080F41B03D402E59FFA3ED920D4DA409ECA9AAD57BAC91C3F1B51279EA │ │ │ │ │ -A3133501892E9E53F3F8A6BDA0FFF9456D027AE49BD31372050313BE55845B85 │ │ │ │ │ -F15380257D6687D5F609325220D553D0F5C384A88E22325B42E6A336A12560BE │ │ │ │ │ -70E273FE85B4E68DD94BD530295F6D981DF936B92F136DF95AEF560EB138CB11 │ │ │ │ │ -EC45F6D29743E46A4DDCB80283409F2C52FF83976BA136A4534307B3E6C8AD1A │ │ │ │ │ -59AED81A503AA8244A279BCB788DF7D2A1863404626CBEC7F122B3EFAC395A0B │ │ │ │ │ -1D514218CA020561041E4398BC1F8FBB74D3130DD0FDE7757DDB4BDC74D4CB0F │ │ │ │ │ -7EE03B5A2D23CD31816C1CD6BF51640ABE4CA02F0BAF2D19CDE2631107BAB24D │ │ │ │ │ -2A0C90021F19EC9CF2337E0C46D709D88BEC0C6160258D93A61D575348017132 │ │ │ │ │ -6896E96413DF24F4E4C56C6EC57274DB2A18D8C4623A85AA6415ECAAE9802F14 │ │ │ │ │ -83AEA8579C3103E98BCABC3CFFBD3E47D451D00D32841475097C9F45E723E881 │ │ │ │ │ -031A311912BAAA1681840FD8E89D61CE4F7E2052122D6C9B7DC9C6D2FF5A57F6 │ │ │ │ │ -60B86EF9AF89821DA03986F63E3558DE20995BD65D74D2679D3098E6772E3B8E │ │ │ │ │ -C541E4B363ED91BA71B00B290E25CEB624720D1A79F543DDA58966B343AFF28F │ │ │ │ │ -D112D245F1698231C38F3974A59FEB4A16DFC3A3EDF4DB772F722AD9EA0E5461 │ │ │ │ │ -6AB29B13565E98FBA1FACBC18452E85C97DD8707937860A63CC3B0E3CE220781 │ │ │ │ │ -2A8274514E941FFF50CA543EC8DD13F1D5A0023C7BFE70411DC27B246F8EC645 │ │ │ │ │ -4268C8216940791ECDA61AE191190ECF159AD477DC5F31E5D9B3501261BE6159 │ │ │ │ │ -3A61E70BB16B3AECBFF9C4D68D1C2770078893445978A7BC5940B00BF7969E80 │ │ │ │ │ -2D4870676BB4B7E59FA7A9371A14D17B2AE018CCB53A9CFCC154B9F3AEDEB2B2 │ │ │ │ │ -D2DFD587ADA457B46F379AD251788EE969EDE18CD2EB4533F934FC0877A1F04A │ │ │ │ │ -EDB5BE194AA4158DEF3137470C1792AC0CF18BAF9ECEEDC8DEB5B1B9CE0AA046 │ │ │ │ │ -08D6F6E80E39B40C81C6C478B9FF021B4C837B77172504D9FE7D9BCD8597A677 │ │ │ │ │ -E5FF51CAB2523BE55BFA15FE296FB22A97AC37E1CE3ACDD7806C0C4E74636D40 │ │ │ │ │ -174059F0E9C836BD88292E356CBC9622960F2F137ED5EB3EDBF3461DA82E824B │ │ │ │ │ -04EAE58585BD3F1BD2CF5EF4C5DC5C9A84E289C8B763569F530B63FDA9C87C5D │ │ │ │ │ -410D070D78131961AF36AEA3C7911C87111A02237CFFB55A498909C3FC3FBE81 │ │ │ │ │ -0230703B27C434BEE75F626F53302D36D65151EA13F4E4D7AE6DB594D1393351 │ │ │ │ │ -5705ECBD244F576B0398156AE3FB3294898497B46505B5762B3137CADEC6F034 │ │ │ │ │ -A0AE6CC2E17BFDE80C7ED0BD91B3237F44BCE9AE51219135DDEBFA93B1BD2035 │ │ │ │ │ -C480C35714BCE9B46524EEA527F104E867B43BF6B32CE4D90C9E02FD9E3ABFD9 │ │ │ │ │ -3FD63E2387A9564A234E47D04093A91645EE5AB3A17CBABE6BED1BD378B83E43 │ │ │ │ │ -51C736184844C09235545959427E87A5F01CBBBC2662899F0F4759CBC2995DB0 │ │ │ │ │ -9E526FE01853FA59F20E86374E79D2BA62B27284268EA657E263C86B1F4F642C │ │ │ │ │ -A13E70243F517B89EC3B47E6E11CA8717E503F85EE57F69778CB37CE69B90A91 │ │ │ │ │ -6B783374C4E17F7B6AEA4F79A556EE4E8D0D61BDCF425E642C9A81A28C50100C │ │ │ │ │ -F2CC09F48949057FA11C94E8F978D1C0EDD326EC05A09523577220344FFBA48B │ │ │ │ │ -B844B562866ED9451ACFC34BFFBF46CD62F761A746907B0D68DD111CB15558BE │ │ │ │ │ -10F5DD05E04A672940DDC287353AA98A0514685B4AEC56CD126C878811A2857C │ │ │ │ │ -A4970BAE2B8E39F5EBB2BF3AD282B2C78F89FAF7F30FFF1B96CD5976BE465F3D │ │ │ │ │ -1A37E5B10379B403FE3668E8CE7E2B8D8254C4E7E7164F2B3B1B6A3D79A88CB0 │ │ │ │ │ -7F07CE6612BB1DE2AF4E29C52CBF8AE211D7D3428D681D189199E8EAAFBFC3CC │ │ │ │ │ -596029C4EEF5544F4831CC73D1AE5A5EDAA42568B2DE63E321952A861852B150 │ │ │ │ │ -CC56B1DFF4F3584888B874A0C2A3B72B2E10B0B200EDD1BD52195685EF368572 │ │ │ │ │ -789D9E47C60DF1D9B702B79AF13FC98498EB6F2E8BABE9B62479DA9274F019A5 │ │ │ │ │ -998CDF1BCB6C9A2244BB952F9FA708B8A6CF0DB7E9E46CB4A71FF571424D8792 │ │ │ │ │ -C03FE0E65BE98EC50F05B716E6BAE77E7863DAE613728DEC3D4F40D08AFDB44E │ │ │ │ │ -9C724CE68873004F249CD30FCF1272670932BE44DC776A4F50DDB33E9898C33D │ │ │ │ │ -7E135A9C911A4973EC0CC90A811B7DC564721B772404BEBCD4DD876883248D72 │ │ │ │ │ -04C1556550C929F5CF9EA7F8D169C36EEA8BC23F73A0BFE09AACB9F51BB082AC │ │ │ │ │ -AE993B18BA81A8DE72A20731985467E22C11758651070F29734E07FDD2A145E8 │ │ │ │ │ -86622B9A77D438C21B5AAB90BA076A892A5371E83928597635B6A1872E880C56 │ │ │ │ │ -DA925C710F213169DFB0C50286A2160095E8E036BF77BED4D561A58AFEDB0C77 │ │ │ │ │ -8D6B0C2EAFA7EC901FF2CFB37B4632C5BF47BA1F553A4C14E8C8AFA48A981530 │ │ │ │ │ -8C657FF47BC9809508D9326E534E1A965936D0DA70D341DA5AFB2DE90258A5A6 │ │ │ │ │ -563698ABC240FB37F0EEC0CC9B74CE4FE43447511D82FD68DCAE05912BEAB752 │ │ │ │ │ -8EA9B27ECB62289CF984E9FFA02C6340201069502FC465453299EC1F04B27846 │ │ │ │ │ -44B7A9965A70EE1C6F7A768871675D0C203D6285C76DD821FC124B31E15B12CB │ │ │ │ │ -775A60E5E6F88C6861AAFFF053F03499CC032095BCC8BC58F7DE7C31FDAC523E │ │ │ │ │ -36F35A30DFC6C9FA89F88C59B8BF426C132AE80CF26EB17F204C2F0B31F2AE22 │ │ │ │ │ -0E3F3DD6A3762976A42654D63B240FE235D72C6EA97E2A1A14BB88F0430519FF │ │ │ │ │ -8F05C0FC8ECBCDE687AC57C7239C1A88ED63581EC58D6A5A7C11BA99641BEAD1 │ │ │ │ │ -E108C5DF5067974B792BD3BC6C73B5113A5800FD5DB3815F144E1E6C15539D13 │ │ │ │ │ -F493EC1AFAE3441CBE8952AE904E22C1F5B09E0759CD61FA764423AE35996DA3 │ │ │ │ │ -8CECD5DA8C207A2BF81C5652C3DD1CCF0742ABCE2DC08D6E6833C0C1F4F7AE27 │ │ │ │ │ -02865E56835588F120ACA0D0EA4F6A1146335BFCEA92CE030AE7ED59E4BA0181 │ │ │ │ │ -657E16F2AD6C8AF69C2B7C6FA67769C7196AF53D8B189D911782AF62C7F7FFA6 │ │ │ │ │ -C1CB3555D0FC043417DA139B3ECDD5181B617FBF0CD90E41F0944396705F8349 │ │ │ │ │ -FD67E42347DE71138AACEA8DEB18A915912DC894C87D5F0C459763D47CCCA203 │ │ │ │ │ -2D408115C12EB468CA96E628511B5E9748C0BF34D65C518F18800650253164D4 │ │ │ │ │ -57771A73F1FD10EE1D51A97D43743376585B1EB1BA72BFAAFD82BC10DA328007 │ │ │ │ │ -FDFF9EA2DC033BEBB8A4A641C515B59C18732D9947031B03C7530F1796CB67C2 │ │ │ │ │ -B6FCF0B619D648DF140643D0B2224FC5E7E4377C6EA37B9CFC0433C0D45AC4EA │ │ │ │ │ -B10C0D70D10197D2AF438C2A910B75FF2A72AEADF0BBA4ADF884FE9A28AB6ABB │ │ │ │ │ -7AF154D2285A52A7DC3C9891A44F85A8536A5E270B4E154F6F785D3B887153FB │ │ │ │ │ -AA6B3228E0DEF2F7DB7F1CEAF6D7855A03AE6AEA5FF23C816DF28AC5EDD1A40C │ │ │ │ │ -B0AD4C3584ACD6E3995388629405998F84751D72D86E2534A17315BA7F257992 │ │ │ │ │ -1A0A07470A9056C79604F8B32D842ABEAD13181112D4421F1E6E5123D2E47DED │ │ │ │ │ -F3718C5A92938AD047F7F10E173AD31CD9A3DAE5A536B2D230B23E700552F884 │ │ │ │ │ -D037C23486CBCF1C045842E8051DCFC85D13E4C37D690083F702C7A57D5E1D0F │ │ │ │ │ -DD9303A66796D77BE4254D2C5DB0B6CDDDF168627C186B01424DB209F03FD2EF │ │ │ │ │ -EAA04A638E1323B2BAB2F8DFF3DE553A4E5923AAD9A2BAC9650CED0A364B6DE1 │ │ │ │ │ -4591B2FC39E22F3DD5101DF5CF3AD6003632B7AE3689C9C0F4DCE0229C39FC66 │ │ │ │ │ -17E5AD6488665012466B9AA10E466BC18B5DE6349CD4749B4589E5E27CA336E3 │ │ │ │ │ -D6952ABBF1BA10B0002D49A443602A3CD47B2776BFF04CABF80434124316E2A0 │ │ │ │ │ -CF56FB40651D2FDB3DD45164A65284EAA3000B3D7FB1F46B39FBCB4E81BF935F │ │ │ │ │ -3DEBB106C491961CBFD49AAA7F1643C8A5E11A3D7A81DDC134747FF520A382AA │ │ │ │ │ -BC3B1E8E932043BA5373F98CE70359404F1AA59C3F82679A70C33D5E97CACFB4 │ │ │ │ │ -34E6BEBEBBFEE39601CBFD526A60AB26F0BC2622A01B704D1CB7A5E9156AEC3A │ │ │ │ │ -C97A3991C6689D50D916E4FF3977D73698C1F8B2C0AC2A1AA28D78EE68EA424C │ │ │ │ │ -ADE3AC401DCEEEC2AF2069F272C61184873A44416154AB4C99BD37AE5E1A1912 │ │ │ │ │ -319B0AE93FA6ABCB3DC8E73E0B0F42BEB839CF2FB7B1E874058D3F1C8080AC2B │ │ │ │ │ -2D22F110C6943C4C7338E7DCDA087A3416060B407F9FA894E80A7C520A83FDD4 │ │ │ │ │ -984053158FD370369335E6BADC127F50BFE3561FA38624AFFCFA21327865BED2 │ │ │ │ │ -38AB756E11C2D969729C19DC507F1B66D0CC96C959B1E9C63D9BDADC5E95CD99 │ │ │ │ │ -A16580A8D1CCD48A426FC6B8CCE39A468DD45C1836F3DD0F81B7BD31468DE2F5 │ │ │ │ │ -170336B08F9E90EDD14CA6D38252EFC0C6E935B9D73B195C9A501E6761C1AFEB │ │ │ │ │ -04C0D2AB260126BFE7227B92033C1A8B76AE6E2DAD64F0390D0D68454B888924 │ │ │ │ │ -7165F44E0779BFDAD27E2F088F783EEEA6A6E22D828068FCDDB194E29F8DC0D2 │ │ │ │ │ -35A15DEA8D85D3BED44145A75C216731025068D71C98AAC5CF9407CF2D1B9ECC │ │ │ │ │ -F98768955A2347231800CA42411FEE623FAB44FBAFA8A975DB13DA5839F78A3F │ │ │ │ │ -22426802E190BFA280F17687D361D903119CE275777DAD214AD8C5B95344C11F │ │ │ │ │ -579706FCBD41C05556044FE55EFA8C797D522425D621FA50E340E4768E9DDAAA │ │ │ │ │ -25658A96B24E1DBEFDD961CA90A1DCAD484BFDDB79F16ECE1F20C2D2757D4406 │ │ │ │ │ -85D919A4753AB9C016657177EF35A4505249D34897DB2F14B8EEDEFEF248F397 │ │ │ │ │ -6B0CD0FA06509F4C9984FF23E6B6CACC69FD5EAB45A3A89D07D6537D4FF258D0 │ │ │ │ │ -1A89500E8CF55B1BC0400D1D7F05577C3B431639C5AA8EDD2D12BA5C1E0A9905 │ │ │ │ │ -275C764AEB0C094D83C98C668120EFCF0BD2E128C04AA44F05FA9DCEC1B8540B │ │ │ │ │ -4A5A4DC587DA3C72DB205BF05D47B032DC45948ED74029D3B409480004947AF4 │ │ │ │ │ -C82F3A3DCF00E692B7DDEA2B344633CE11AD75A091FBBE5082D97B517DEE274C │ │ │ │ │ -798D2E2F4ACE83A94AEC364B02AEFC4FD08624F87D1B1183AC6A062D3460E69E │ │ │ │ │ -3DAD462EF77BD8ACFD1D40FB3B1C1173624CABA7BA343064998E506C7E1609FF │ │ │ │ │ -38CD2DDC35D078E2138B2DEC2EB5C2679D3FDA14275B5B6D326FB3B2DED6E98C │ │ │ │ │ -642FF2418FD59422A4F93914030BF65C1825A6005CD277F3E3E1AF1D44C1B914 │ │ │ │ │ -7514AB3A536AC280DD0CCBE338E59358B5F99E6E6D1F442C13207AB69105B6A7 │ │ │ │ │ -52D047276C44D60D4F71F6CEC22AF8838F23788465F20EE795ED0E223FF5068D │ │ │ │ │ -81BD440D248447307F8C6833300FD329DB12449A858AF99C95B9792198E19959 │ │ │ │ │ -F79989578FE64155197A4804D6E9933132F8B8095C4B9BF98F7A64D1B02218C4 │ │ │ │ │ -688E6857D2091908CA9A2887D48F565C1D58D98D2834F71CCD9F7032EBBD363B │ │ │ │ │ -86960251153D33D7AE7255EC28882C996B92FE1AF86452F66BFC3F5C0E9045AB │ │ │ │ │ -0BCF532945E65CB41A10A359176579CD08007C10E9AD797A958E08EA763EAA4A │ │ │ │ │ -FB0710A13187E729C25485CDB2DEAB7FBE60C92842685A6B0C679AEE55D96BC3 │ │ │ │ │ -B35A05F4FBF9FED780EF600A7E239D1C688447E4BEE3858DC0F396E8D5CAA187 │ │ │ │ │ -64455E3EE140F2B5504F2904517E5CCCF2837E24C72DD1962245758DA9B8F90F │ │ │ │ │ -8F800A582A64DE85561C9A3031C72A4B3A9C0FCCB71CFAA9DF8E45A9105BAD76 │ │ │ │ │ -2C9E38FCC84E2748348CB72C129092BD7BDF6B9EE18EC7BA2D860669961FEF1F │ │ │ │ │ -660737EB612E6FC3DCF5224263FFA8B830436B62B2384348F6B5D39A7143F90B │ │ │ │ │ -0280BE8354DE1466F6EDCBC752B59606B911F7BB2FB4FE6BFC5F975E3E5D3B57 │ │ │ │ │ -4C7B270DAC755E06167F61B3BCB00E423EBAE8E028814EA193CBC9FBE79D9C91 │ │ │ │ │ -FE1610027B153B92EE09899DEEE9FF1C4C93DACA79C505D823B2BBBC485AD012 │ │ │ │ │ -B274F5EF15182321952698E68C0E4D226E851635197CEEA0E4007AF844E952C8 │ │ │ │ │ -78FD129C328BFDB12EA7DAE363C0A0DA500517ECCC85ECA1CBC592A17F789DB3 │ │ │ │ │ -603565EBDFE1F44C9C3209F506FD4B147A04414BA8CCB0C9CC55A9EC712DAE2B │ │ │ │ │ -F3F0E6644DDE6328166738B63D55583BF21569FEE9F494913ED82828F4209D65 │ │ │ │ │ -2D449C432ADCCFFB5D95F785F664C3D36D2EC0D7A5FD62F6982E29047A921FF7 │ │ │ │ │ -96EB5847842EAA723F5CC1BFFAD558443E313E62177D279BAA8086E63BE4D435 │ │ │ │ │ -E75B3E23A8AD723BFD3A35A22187979AE32D4A427E6D0B0857B138EFACB8DE47 │ │ │ │ │ -FFF2D362F3C8EF215CE9CB6FCDA1A34B7BDDA42D30E55B902ACC35DE1179F267 │ │ │ │ │ -18621F36D8919E06DBC230B183E8449011BFEEB0F05BB84529DDAB99778D5A48 │ │ │ │ │ -EDC74B33C164FD06FC04FEEE9EF6E19246CD0894C9781702A31E5E2383A507EB │ │ │ │ │ -042D0ABE4702E0B8A8F12E9E61856E6FE6DB38716BF5BA2FE4A8E6A0BF1DB857 │ │ │ │ │ -B9E4C8B26325FD1F467EA22D7DD3E16FCF5F92AA1457A450CFC8770F08898BB6 │ │ │ │ │ -D118243DD73404EDF5C7E85F52007505FE56D8EA8119612BF5B37DF9A2F6BA40 │ │ │ │ │ -B685BD846802F2179D0344BCDFDFDB1D8284C1762CE03DCC2019ADA5036F89CA │ │ │ │ │ -D25CD628B619CA1A77185BFEC5BC068CA2F91F492474C1AB219251F6AA72D1CC │ │ │ │ │ -7D5CD4C4C6C897FEB13FC80EA3525BF9B6255B51BAA982FF9CC27C2B5688144B │ │ │ │ │ -3B6AD57F5217E11E382EF6E24E1F309F4700D98048A217BC6482B6DFECE1F754 │ │ │ │ │ -9AD37D950EFC5A3E7AB96AC48EE981EC9226FB36B5E00BB9B0589DDF0880712B │ │ │ │ │ -765421502A14A73C16741201E6C01E7BE513436EFEE8C8DFC80BED389F3E9B0F │ │ │ │ │ -E3297C90D698DB5E4E60696182A0F7E438A33F801A03A16A9C0CDFD8AB74730B │ │ │ │ │ -4EE25D1608794AFAB9A959063FE6CF9E64A28725043002A04E60A4EA9F09FFA8 │ │ │ │ │ -B04D46246C61C6E50374259B9EC8378DF930035855B5ABD49461EA4BA8A45B5F │ │ │ │ │ -EE72705E55F63F6CACEFDA22900BA7A3098522086D9CF32E56D3EE662D66A8AD │ │ │ │ │ -80F3C02E405BB4C2EA9FC0BCB16694CADDFDFE8C5442A38E888737B6962244DF │ │ │ │ │ -414B177774057A8F5DADD42B748E4342F330E3341A4E25E3711211A51E8BFE0A │ │ │ │ │ -63A75945B7B84A72F6EEC71C56B6B0509332337CF8195C5AF6EB2FA6B8893DE6 │ │ │ │ │ -C9813E2EE6F0493F9E985E921DC079D2476227E5B2E2757D95529465DB7CEAA4 │ │ │ │ │ -E5687798D2474054C33444486A6DF0271E4BA2869C37C7B3F98478EB471AC3D0 │ │ │ │ │ -17134801DA78714955417A204F078C79A275E9CEDCD5C487F8A97AB0A0FBF922 │ │ │ │ │ -02058030E2BAE66BF4C523AF46344C0A5EE5746B5911FF557FAF49E77F518AD0 │ │ │ │ │ -EE637F8BC556BFF08265755D0BE0906BB80C1EAEE6D2387E984A73D1E0F15F9E │ │ │ │ │ -2D60 │ │ │ │ │ +818321B3C46DB51B8EC6C2EF1D05C716519A3BD6B12A67239898F8A010C9258E │ │ │ │ │ +257B321D3A56C6FE2FAF27428C1A145DEC92EA10BCEBA709F5B7695B2F355214 │ │ │ │ │ +37AA600A1F9A41EBF82A27040A4D8D3F13CAA15E5A7A95BCA716841538940438 │ │ │ │ │ +7F6D11A550DD9BF4022018C02A1D461219E0AC394ECCB098085246EA35555D8A │ │ │ │ │ +1F3B4E349CD2D5A79A91D9736CE08EDEE4AE45A6A69E11DFCF84E55DC5CE9FD0 │ │ │ │ │ +F6B1A6A7CE4922214BC54626C9F7EBCDFC11A1E803E8EC68A11E61AF16CE3CBF │ │ │ │ │ +94872F120BEF7BA4D3748ACA6B3F7610EAE5D51CA82F4BCCF00D9A858CFC7D34 │ │ │ │ │ +3A7FDA08B917FC612A24DB981FAA5D04A850FACC15AFD3C2B26568F9F24FB220 │ │ │ │ │ +35A72D4B4EA59EDB47D5E9F367B8736F6D44C22FD8BA12E0CE444E054A90E7A5 │ │ │ │ │ +B3800ED2151A7323E8DC7E0AC665CCF4FB2E493ED419DFCD6512295863BF6420 │ │ │ │ │ +603AFDBB1549DCBB90E415A7F8833E0E15EF74AFD24962AE4630C8113D8CC51C │ │ │ │ │ +5498E9B93E1F00B8B4B0038D5934B0B62A2835FF7C6825B4EF955F7E80EA4C1F │ │ │ │ │ +C1B45F3DD8F33E7DD74DEF62ECCF90D1CC0B4B353E93946651949878704288B7 │ │ │ │ │ +819260C2195F7F3BE0F18DE6A8BE3115D887886278EDB470BA22F935F4E309F5 │ │ │ │ │ +3AF827E474A667572C821AC79EC4C2FF38D9B79EBEAB66F2E5CCF752D5487EC0 │ │ │ │ │ +8CF76DFA8DF2B1FE4304DBFB8C597E826DFA66A9997E8FA483EEFA84047D03F1 │ │ │ │ │ +D67A7F405D997D7BB60455738CCED0C43EDCAE19E3EA23CC12B6228C0105AEF2 │ │ │ │ │ +9713910D6E36D2BC14A0EB78A42B09F283CA46ABDC888934EA6016D3507C666C │ │ │ │ │ +43FC02AD5226BF5B22829850CF38A2833AF6938EBA22BFD4FEBB08ADB9F6761C │ │ │ │ │ +5088984011581113C5CE16E2B6D1B8CC06EFC32E1B08E56757E25E52EAD1046A │ │ │ │ │ +1AC14E496F18DCC08C0A82A9159958291380A6B06C1188C6C612A0515B9216A3 │ │ │ │ │ +AA90B3D4212934F96D173BCB6F73029D545B654FBEC03ABBFC46B24C5DB35F72 │ │ │ │ │ +A386725C1CD7E06465780FE8CCD2629446AE18829E50CA6FE64D13183FEB7385 │ │ │ │ │ +62F0931C728F70857F4B33078CEDD1F684630DE8CDBEE40BE32F79BD89032A20 │ │ │ │ │ +5739DCD93501D90444232C27BCECB8CBF3EAFF663C7CF61A6EB776F5E7660539 │ │ │ │ │ +CF3363BF2299F3DF4D06CED72AF8C58ABCD7E73E1859AF6CC01949AAF7673C95 │ │ │ │ │ +BB4AE179E22534561049869FEABFE777CFAAA984209106F11B973A3065356626 │ │ │ │ │ +B96FD640D9104363EC434F75F3B4EE8CF6E8246046A1816BCADFCAC4EC9F11F1 │ │ │ │ │ +828CA7E2A5E3DE5767D74255846FC1ED2563DF0B2363E7D47EE97B00D1876465 │ │ │ │ │ +76A4A769C716926EFA695CC3E9CB3AC0A159CE910790DF50AC89CAFFDA3499D3 │ │ │ │ │ +04249ADF701DF5BEB628ECE3EC60EC7F126498909652DADA53ABB0B9CE55BC34 │ │ │ │ │ +4E2DC2DA00D6FC03BD0DB10010A1D2A48207478A0ADCD471D0A19808F9AD05E2 │ │ │ │ │ +5738CFEFBCF0812ECDB5FDDF2EE4BC57DC93FB08D88B8C796EB0943D8D7389BE │ │ │ │ │ +CA96FE33163420414A3E540D30DC17933B1DF987DACE008C8D9ABEB6D74BA49A │ │ │ │ │ +05D0EB87972E3E75234515FFDC6900D7C66E9A6AB9BBF832D9414A18C3114851 │ │ │ │ │ +C0839C55DC323EE13CDF2337BC51A76BAAC332A291345812C4C33FFDB60ED1CB │ │ │ │ │ +F75BCA66C1AB94B4A0DD07D75A99B702EFE26B967C16CC883DA7660FA9AF0F17 │ │ │ │ │ +D598AC90CFB25D0FD14492E1B8B8CA61F32711185A8DFFE4E6AB3737678C50F9 │ │ │ │ │ +3968736A729AF4ED1EC2F2E830AB9CD568E2DCFF04886DB1B70E2C09D6B3FFB5 │ │ │ │ │ +6BD1E5E8CD52C9E85A56CACB4EDB600D1619B75CDD51AAE401A2B6B7CFD541FC │ │ │ │ │ +E7BEA4E6FFAD60E9AA0DC14DD4C7BCC4206E86B786A3D5D0C5AC21DB754B1492 │ │ │ │ │ +AA7FD63E6B52332F5B4CC06F972E7740A649BA2365E908DFFC0226B1D886BF9B │ │ │ │ │ +31FE5A2CA102BA21D34D1D4CF11CDC52A13BCF06577218889FE08A7D6C218097 │ │ │ │ │ +E946250C89D1D57C1AD762A8A1B144A42812A2D26D6D08F8D373132EFE9A988B │ │ │ │ │ +F897FF2AF88C1C075D53951F6AE5A0FEB792BCCD653580547E0A2046E025263E │ │ │ │ │ +F169C2DB0EA20CCE09216EB395BDC03A68C113BD607FA859458107718E5DC04F │ │ │ │ │ +0F7143CA0D1D8A28CAC91C1DB329AEBFF28CC963F6BFA142D16866D795FE0140 │ │ │ │ │ +5414D80CC73E742FC025C891BE09A558EA827ADE925DA68D067A19C8EB850CE3 │ │ │ │ │ +901FD3D14FCEB6E2E29F437028B955E60386B0B622553D5FBC57B8DCDC4BEBF0 │ │ │ │ │ +C5B70AEE27F490B04DF0FE60F647775B80BF602DFB5D3D2012D774C18C43D107 │ │ │ │ │ +1B8FD487026D9413F6FA52BA9FA6974C768C379534B8F5B4C76C071359ED9069 │ │ │ │ │ +607390A2ADE5BC8F70D2194EF01624CFEE919E5C9572C6D25F6B1C677186D1AB │ │ │ │ │ +BC9AC282E81F4999B08EC66C417B2C4606EDD1DB44F0FA58055E9257716C647B │ │ │ │ │ +EB934D019375F2BC1154C37BC158068694D01E0066720F00541AFA282E2F5CC8 │ │ │ │ │ +BD484B1F2084DD73B042CBD1AE11F2949D8D913363164C306A7BDEBBCF986783 │ │ │ │ │ +BE110A5C6BBF4B8029FA41D04A20D1729B5F115BD239477EB1F5370DD1D2D075 │ │ │ │ │ +CE190D1D2AF6B2431B8EC2A543AA9631AAABAF8910897A72CCC902FCD07E4472 │ │ │ │ │ +CF439C17F454F08D200F6A54301300B006ED99B4A0C974CEE93DB1C34F5D6E84 │ │ │ │ │ +E4DA8A8D79D7DD10406F70E1F6B52932A8B585A177217804E585C38B2A1CD8F3 │ │ │ │ │ +8E5EE85678D82D3414B5ED856A1E66BC30B4E09A154233D1F21E0F12D737C81B │ │ │ │ │ +D8D970982CDF85141C67EAF171E2E7E06EE54905F031582C6A0EE93DA0A47784 │ │ │ │ │ +E514F58BFEF59A516B021A046360B8DD29876C4931CD83922C9813379F6C9A0F │ │ │ │ │ +98CCBA3A60C8668EE668701862D3FFAA9D65DC9BCCF628CA78AA1A20AB865191 │ │ │ │ │ +DF821F864D7CD9FDFD308B4BEDEAD47A63B182705A77C2A1697A370B59DA50BA │ │ │ │ │ +9775571F9F4E3FFE1C441A6FBA4C6E9A6EE7436C7368E1399342896E2D1F4C25 │ │ │ │ │ +DEAD1AC7CCBBA13A268A458ACD4007265B2C6B82BAA7CC55322B01C737FDDAB2 │ │ │ │ │ +F13EEF6E7417F0727096E0D93E26AEF06D932031951CD20E65283623ACA1626D │ │ │ │ │ +5C51D383EFE71E4149CF83F0358B9BF7070367D790A641E02E55FCF27503661B │ │ │ │ │ +48BD660E7387B83D420E98FBB29C0E0BE07D6A7EE471F77F11F7E76BDCB892A9 │ │ │ │ │ +8911FBC68A71853679CEF416ED91A02562F44054A65FF580ED8B4C18B8B60629 │ │ │ │ │ +CFC3469D8061019F20F254AE448F7960949308C4477646043D279A4429B29390 │ │ │ │ │ +59ED5A7D2EC85D8439967088D544373F3746A8AE33690D3C993B1DECFF9DFF7B │ │ │ │ │ +D8FC15B5B4B5D486E734A1A2F503DEADC39FC5E18C6E52F3E88156A1A891947F │ │ │ │ │ +4E5291980367D22837B244CC228011F7A5BDE53C180878EF9B847A12EE0A8646 │ │ │ │ │ +7FBD600F56063B2D010701BA36C13958A2AC698E58BBDE549A69688D7DADF815 │ │ │ │ │ +45D472BC4781652C75BCE72F71CB32520E369F1A7CB74A4D7731830A5C0964EC │ │ │ │ │ +1A52BC84A8C9033653C1293AABF2A0E1A272F0E5A64A57B4EE8EA39B4AB7C21F │ │ │ │ │ +775EED0B074F668B50808B319D2B1E7E8BDFE11F7C9095A8E4235A47D07F72B6 │ │ │ │ │ +97196B118DBC062FA6F2BEBF633B1381AC8C1D4283AA432FC4EB04B627269953 │ │ │ │ │ +D3CCD7CFDDA2BBE1C213CB87C0F7DFADA3137CF5F09738287E60E15935F6DEB9 │ │ │ │ │ +EE7219C3721B7A9C7B95BD29B03E800644B353806CC5DE548297B675F877EFD1 │ │ │ │ │ +E88C96C0224E9820947D4C0521771A2019CB0C22F2554D5355E22A2E4374478E │ │ │ │ │ +7D4FFDB5F4B07EBD9588DD3E2299E3E636BC2AF3331C06C4ACD53F2F077E4AFD │ │ │ │ │ +CB68334045F1E0032C06D8628E1CC205C826CF432702D7ADAEE0888EF5B00AD8 │ │ │ │ │ +FDB6FE57174161A249ECB465A089D4807217DED9DD68511C3F55DEC9BBA3BD88 │ │ │ │ │ +1293105D38E74A9BD4E89B8EE5B13B1B40571A725795F447BFDD945A1EE8A604 │ │ │ │ │ +6E5D022FCADAD181412D0285B9DA7F7CC326AC92D57DC8DCF078FF506A87F421 │ │ │ │ │ +DB3382CF11390FBC0F2A7886AE3BC06944DEC4CE6B1CD5A7AF5B99239447C520 │ │ │ │ │ +5F4386F391DD85683377539A0D97CA5E6C9B7F5E254A5AA65A1D880467B3F376 │ │ │ │ │ +0F5FA35BCD76DE0BB2E7BDD1D144F1C19953AE1ACAD2737E45650E3566A8BF3D │ │ │ │ │ +BC923EC9AF07518FF33190F08A67BC7E519262206DB2A41BFDFA0B77B53BB36C │ │ │ │ │ +DDBA91CD4C05290633D3B5E7DCAFD727166E9FE8352196E0246B47BBDF8B0D91 │ │ │ │ │ +3CD9243910C025513264B0BF66A320A995AB106E599CF4AA094C6E7AAB2A992A │ │ │ │ │ +27FD695D817452CFDEBC72AAA120AFBD9AC734A7B590A1FC035361C2FDB04D85 │ │ │ │ │ +A0BC368D66FA5022454C6A9CBBF205A35B9D12C250E98DD128CBBB6CBF1211C4 │ │ │ │ │ +BD91EDE63B9881BC25567AB0EDAD99D80F6D51BD2125977E21B728730AE440E2 │ │ │ │ │ +30B3BC932CF52721E489881C7F2DC61FF8D88F26DA835A37B6E0C6CF87D8E876 │ │ │ │ │ +8790106787808E8A645938848CD617B42E7195E2FB21553FECF48A86629FF76B │ │ │ │ │ +0509AA57226DF009D41FFBD28FA5800F0B1233B5333150B9603BCEB9F34709F3 │ │ │ │ │ +DA7234C5CFDBC8BF042D93A74919EC6F0AFB5DA6E44B28B0C831EFBF4F6CFC3B │ │ │ │ │ +CC70FC672E60D8FF4B993E67A731C0FABA7D37E8D0A9DD11FAE85CDEC5FC4E34 │ │ │ │ │ +937977C7932B3C509D3B0217823D37DF9B89F601A7B7DB00E7BDF41B08639C3D │ │ │ │ │ +32FF376B05726DBC3600BDE9E5250BE9A619CA6491910E642F0C2A647C5A3643 │ │ │ │ │ +E8F283AB6D29B183D6A1322CDCCA06D724F758EEEA7F5AB6E4B788A316032D1C │ │ │ │ │ +D095D7DA536D5B9E74F7EC3D87B8A642A0F7380D99C7D117130FA406E2D96C5A │ │ │ │ │ +A64B2C6B1FA90663A3E068601452ACF798EB6086D99DCD56F5BA1CE67F845912 │ │ │ │ │ +33645EE308731A2B26ED2518B29B763389DEEB528628EE24F415CFE37B43A0FE │ │ │ │ │ +F2AAE7A742352B002AB1546FBBC8D0E59C817E472F592B57210665735C120C54 │ │ │ │ │ +99B09D25102CCCE0B4786665BCAB68F18987BF9CFC369A714F8288CC9EBC3A3D │ │ │ │ │ +377322FC399EBC06D45502C451661DE84E00009C43502F76915ED1B3007886BE │ │ │ │ │ +33EEBC17F129DC12495F8E7B0C9B17B3636512D7A8497B1E008F4FE3735E10B8 │ │ │ │ │ +38711CC2DD00B6564A03EA4D6E22A3B13DAA6306F5082E2F2F1ABFE7512F1356 │ │ │ │ │ +EFA152EAA8F7A46F3584431585F4F371EF1EDF692F4C84FD47AF11E0CAADF012 │ │ │ │ │ +4E9B4A42F9ABF1F98778A0BD7E4AAADE4D3EA3F9739ED3A3B9D0A8BE1CF1245A │ │ │ │ │ +E67B33048AA55F4CFDD43E306E4BB26D9E0A9CB7A7C62FB66233BEA1E4EC4A62 │ │ │ │ │ +0486701C93B51B11A4483B9A9B74A94A27B234EC61BBFC6618040999FBBEE910 │ │ │ │ │ +5AA9439FE74548E98FD325F988210ACED20EB8F9B597E7807C871DC885D75422 │ │ │ │ │ +4AA529678802653909AA37DEBC05D0E649BF49C1042A33918ADA10CD5E250C17 │ │ │ │ │ +242B0143D5FC83FABD12CE5325755CF5DC2835F06CFD9220B742D9AD01130BB7 │ │ │ │ │ +E65F537B3781142529FF775DF737BC7C0DAE8235599B9E22825C8C129AE6DDC8 │ │ │ │ │ +8095E65C9706F1DACE2E1B73A70270EDBFD26410ED2174FE7178F0FC5C40208D │ │ │ │ │ +862ADD534D8F6A86157AC0598A0D18EA8F9A5D4F439B32615237C67A3445FFC1 │ │ │ │ │ +6398A63064B0F778714356DBA94F916BE5A802B7B00201AF76238CA4B9292953 │ │ │ │ │ +F0D46EE19191E467676415E44133F9D3E5F81CF88EB012FEE9064EB04757D97F │ │ │ │ │ +6DBB6E9954A4591183EB0143A5347386422E5690A5DF3E414A0011FDD41D7DD1 │ │ │ │ │ +DB2BF35BBC579AA626CA203DF657FE6C39F359D38B2570997F7791113518E413 │ │ │ │ │ +91F7B6C3FFA88499BE5C543FDAE5D11BAF5868D0582836F39EF565FA510C91ED │ │ │ │ │ +818ECC1FF6F5F9DB7DA13FA71BDB70B9F4403261891C6C2B4DC2BEF2B0FF0D9B │ │ │ │ │ +E0F981CB27141EA6B6FB880E5336EE789FC7AD0BD67F73787F90725FB3276E06 │ │ │ │ │ +A729C16BE61A9F968008D62C1428929ACCC946803C652A0AC6FBD497DF3568E4 │ │ │ │ │ +7579971C009F3999C02D4DBF6B33A9D1C0CB5299B8AF497F3E9AD2B616BA88E3 │ │ │ │ │ +38FAC7EB165702E52A80405E2DF06FD0140212BEC7DE8BAC7479F67E80BCB3BA │ │ │ │ │ +B0C1C14DADFD09347170F98CC6CDF7B97A89037537FA0B1EFB3609A88BF9B219 │ │ │ │ │ +572F23DDF0CE16B8FBAF23DA8DB78CBF487B7AFFC846394896C8BEAA42D741A6 │ │ │ │ │ +DEA013E9959C5AE2040848731C005D4C743C7D8A12A49A7758E1D50C2E69DE3C │ │ │ │ │ +ACD4764EC645C1EA7F3848FA9524D3F035A1094F57B5E0491774E712BDF81DC8 │ │ │ │ │ +547F983FF5A2580783EDBC8BC915C4A968D0995DCF7C5808A5E317668C370A3E │ │ │ │ │ +1F55CBAFF52B3DB46E2375AC7AF9099E934D50AFEC41DEBA9353331FB22D6DCF │ │ │ │ │ +97CEA0BFC4B2D6EB852FB86F8EB3B207344F9C33C41EB99AD8FA65486BFB4C49 │ │ │ │ │ +6955F86BB6AC0718300BA72C1280280C8FBD67C6D37FA7844B282AC6929F75B6 │ │ │ │ │ +8CFB0B0500D02553BDB7BE217F572951026CA332FCCD95406FB3D332C07940D7 │ │ │ │ │ +59C8E29CE11145594149A4FD3AD000990B90043424272D2947FDE73559754065 │ │ │ │ │ +42DB2C4E53AA6A8B270F648D5D775BA213733E3F919288F52FA340D96610AC1D │ │ │ │ │ +CA59C8AB43DAC3AB5A9269B7A6AF5F5BCFC9FABB8D82475A5BFE8BE66050EEA7 │ │ │ │ │ +F5D066B2309B0E04F989517F400FD8CA01FCDDFA38CF4EB2C17357D4E11559D4 │ │ │ │ │ +670F31C38B29723DFE31897E0C59513E12AFAF227C7FF4545789089A8FC8AFF1 │ │ │ │ │ +825468984265C09DF40FF44B95BD39D0E1495067C5BF2820AEC901387723558B │ │ │ │ │ +5145CF5ED32545088EC70BCC0217901DF4D237998AC380BF90D04462B806B4D7 │ │ │ │ │ +EE24FB96BE9487E080DA569903B6ABFDAF2BDACCD8B1EC46FEB79B121C6CD850 │ │ │ │ │ +01865364D8A17C74C6DFDABBBAE13E2FB3A5AB21DC695D7D174BEF6A41E26155 │ │ │ │ │ +C2D93261EE3284DBF5EBE9DD37CFFEECD81357C4A0B9E3B0454DA7CC7BC0604A │ │ │ │ │ +B208A271E022D5498F026013377531F9B3B06304DBC06A400B25727A77821149 │ │ │ │ │ +4F7DEE1A5D7C062B4E2B107B46E9D610AE83357BB791948B22018E7938F151DC │ │ │ │ │ +7A4AC7B1CD8859DA23FFA55617BA725630D9B9929F7C5C96EFAB5C1F5EF1944C │ │ │ │ │ +A2EE09D24B67F2E960DDB468F800F6E914B209823D17AA10 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -11529,66 +11507,65 @@ │ │ │ │ │ /CMBX12 rf /Fo 143[69 1[42 2[42 23 32 32 42 42 37 37 │ │ │ │ │ 7[55 55 31[42 3[0 0 3[55 8[83 7[83 83 5[65 4[65 65 1[65 │ │ │ │ │ 14[42 65 23 65{}27 83.022 /CMSY10 rf /Fp 143[83 12[83 │ │ │ │ │ 46 9[120 7[88 17[74 1[74 1[74 1[74 20[48 48 12[44 44 │ │ │ │ │ 61 61 14[35 35 2[{}17 83.022 /CMEX10 rf /Fq 135[51 2[51 │ │ │ │ │ 49 38 50 1[46 53 51 62 43 53 1[25 51 1[44 46 52 49 48 │ │ │ │ │ 51 14[66 10[71 2[69 9[27 2[46 3[46 46 46 46 48[{}28 83.022 │ │ │ │ │ -/CMCSC10 rf /Fr 134[44 3[46 2[33 12[37 2[46 42 26[54 │ │ │ │ │ -11[23 1[42 2[42 2[42 1[42 3[23 44[{}13 83.022 /CMSL10 │ │ │ │ │ -rf /Fs 133[39 41 47 59 40 48 30 39 37 37 1[40 50 73 25 │ │ │ │ │ -43 34 29 48 40 41 39 43 36 36 44 6[57 48 69 78 48 57 │ │ │ │ │ -49 51 63 66 53 63 2[57 71 46 36 69 65 53 61 69 59 63 │ │ │ │ │ -62 44 1[65 42 65 23 23 27[49 2[47 14[47 53 11[{}59 83.022 │ │ │ │ │ -/CMMI10 rf /Ft 130[44 44 44 44 44 44 44 44 44 44 44 44 │ │ │ │ │ +/CMCSC10 rf /Fr 134[44 3[46 2[33 3[46 12[42 22[43 15[23 │ │ │ │ │ +2[42 2[42 1[42 1[42 3[23 44[{}12 83.022 /CMSL10 rf /Fs │ │ │ │ │ +133[39 41 47 59 40 48 30 39 37 37 1[40 50 73 25 43 34 │ │ │ │ │ +29 48 40 41 39 43 36 36 44 6[57 48 69 78 48 57 49 51 │ │ │ │ │ +63 66 53 63 2[57 71 46 36 69 65 53 61 69 59 63 62 44 │ │ │ │ │ +1[65 42 65 23 23 27[49 2[47 14[47 53 11[{}59 83.022 /CMMI10 │ │ │ │ │ +rf /Ft 130[44 44 44 44 44 44 44 44 44 44 44 44 44 44 │ │ │ │ │ +44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 1[44 │ │ │ │ │ 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 │ │ │ │ │ -44 1[44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 │ │ │ │ │ -44 44 44 44 44 44 44 44 44 44 44 44 44 2[44 44 44 44 │ │ │ │ │ +44 44 44 44 44 44 44 44 44 44 2[44 44 44 44 44 44 44 │ │ │ │ │ 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 44 │ │ │ │ │ -44 44 44 44 1[44 44 44 33[{}89 83.022 /CMTT10 rf /Fu │ │ │ │ │ -131[112 1[50 59 59 81 59 62 44 44 46 1[62 56 62 93 31 │ │ │ │ │ -59 34 31 62 56 34 51 62 50 62 54 9[116 85 86 78 62 84 │ │ │ │ │ -84 77 84 88 106 67 1[58 42 1[88 70 74 86 81 80 85 6[31 │ │ │ │ │ -56 56 56 56 56 56 56 56 56 56 1[31 37 31 31[62 12[{}62 │ │ │ │ │ -99.6264 /CMBX12 rf /Fv 133[103 123 123 168 123 129 90 │ │ │ │ │ -92 95 123 129 116 129 194 65 123 71 65 129 116 71 106 │ │ │ │ │ -129 103 129 113 10[175 179 162 129 173 1[159 175 182 │ │ │ │ │ -220 140 182 1[87 182 183 146 153 178 168 165 175 6[65 │ │ │ │ │ -7[116 2[116 1[77 65 2[90 90 26[129 129 12[{}55 206.559 │ │ │ │ │ -/CMBX12 rf /Fw 172[45 2[55 61 2[49 6[53 69[{}5 66.4176 │ │ │ │ │ -/CMBX8 rf /Fx 190[49 3[51 4[33 33 33 2[33 33 33 33 4[51 │ │ │ │ │ -43[{}10 58.1154 /CMR7 rf /Fy 129[42 1[83 42 37 44 44 │ │ │ │ │ -60 44 46 32 33 33 44 46 42 46 69 23 44 25 23 46 42 25 │ │ │ │ │ -37 46 37 46 42 2[42 23 42 23 51 62 62 85 62 62 60 46 │ │ │ │ │ -61 65 57 65 62 76 52 65 43 30 62 65 54 57 63 60 59 62 │ │ │ │ │ -1[39 39 65 1[23 23 42 42 42 42 42 42 42 42 42 42 42 23 │ │ │ │ │ -28 23 65 42 32 32 23 1[69 1[69 42 18[69 69 46 46 48 60 │ │ │ │ │ -1[60 6[69 1[{}94 83.022 /CMR10 rf /Fz 132[48 42 50 50 │ │ │ │ │ -69 50 53 37 38 39 50 53 48 53 80 27 50 29 27 53 48 1[44 │ │ │ │ │ -53 42 53 46 8[72 1[72 73 66 53 72 72 65 72 75 91 57 75 │ │ │ │ │ -1[36 75 75 60 63 73 69 68 72 6[27 48 48 48 48 48 48 48 │ │ │ │ │ -48 48 48 48 27 32 27 2[37 37 26[53 53 12[{}67 83.022 │ │ │ │ │ -/CMBX10 rf /FA 136[39 39 39 39 39 39 1[39 39 39 39 39 │ │ │ │ │ -1[39 39 39 39 39 39 39 39 39 39 32[39 17[39 46[{}23 74.7198 │ │ │ │ │ -/CMTT9 rf /FB 133[34 41 41 55 41 43 30 30 30 1[43 38 │ │ │ │ │ -43 64 21 2[21 43 38 23 34 43 34 43 38 9[79 2[55 43 57 │ │ │ │ │ -1[52 60 1[70 48 2[28 58 60 2[59 55 54 58 7[38 38 38 38 │ │ │ │ │ -38 38 38 38 38 38 1[21 26 21 44[{}51 74.7198 /CMR9 rf │ │ │ │ │ -/FC 203[30 30 30 30 49[{}4 49.8132 /CMR6 rf /FD 133[31 │ │ │ │ │ -37 37 51 37 39 27 28 28 37 39 35 39 59 20 37 22 20 39 │ │ │ │ │ -35 22 31 39 31 39 35 12[51 39 52 1[48 2[65 3[25 53 3[54 │ │ │ │ │ -51 50 53 7[35 2[35 35 35 35 35 35 35 1[20 24 20 31[39 │ │ │ │ │ -12[{}49 66.4176 /CMR8 rf /FE 134[51 2[51 54 38 38 38 │ │ │ │ │ -2[49 54 1[27 2[27 54 1[30 43 54 43 54 49 9[100 6[66 4[76 │ │ │ │ │ -50 3[64 1[75 70 1[73 8[49 2[49 2[49 1[49 1[27 1[27 44[{}31 │ │ │ │ │ -99.6264 /CMR12 rf /FF 172[90 2[110 121 2[97 6[106 69[{}5 │ │ │ │ │ -143.462 /CMBX12 rf /FG 134[70 1[96 70 73 51 52 51 70 │ │ │ │ │ -73 66 73 111 36 1[40 36 73 66 40 58 73 58 73 66 12[96 │ │ │ │ │ -73 98 2[103 1[122 83 6[90 3[99 6[36 7[66 3[36 1[36 44[{}35 │ │ │ │ │ -143.462 /CMR17 rf end │ │ │ │ │ +44 1[44 44 44 33[{}89 83.022 /CMTT10 rf /Fu 131[112 1[50 │ │ │ │ │ +59 59 81 59 62 44 44 46 1[62 56 62 93 31 59 34 31 62 │ │ │ │ │ +56 34 51 62 50 62 54 9[116 85 86 78 62 84 84 77 84 88 │ │ │ │ │ +106 67 1[58 42 1[88 70 74 86 81 80 85 6[31 56 56 56 56 │ │ │ │ │ +56 56 56 56 56 56 1[31 37 31 31[62 12[{}62 99.6264 /CMBX12 │ │ │ │ │ +rf /Fv 133[103 123 123 168 123 129 90 92 95 123 129 116 │ │ │ │ │ +129 194 65 123 71 65 129 116 71 106 129 103 129 113 10[175 │ │ │ │ │ +179 162 129 173 1[159 175 182 220 140 182 1[87 182 183 │ │ │ │ │ +146 153 178 168 165 175 6[65 7[116 2[116 1[77 65 2[90 │ │ │ │ │ +90 26[129 129 12[{}55 206.559 /CMBX12 rf /Fw 172[45 2[55 │ │ │ │ │ +61 2[49 6[53 69[{}5 66.4176 /CMBX8 rf /Fx 190[49 3[51 │ │ │ │ │ +4[33 33 33 2[33 33 33 33 4[51 43[{}10 58.1154 /CMR7 rf │ │ │ │ │ +/Fy 129[42 1[83 42 37 44 44 60 44 46 32 33 33 44 46 42 │ │ │ │ │ +46 69 23 44 25 23 46 42 25 37 46 37 46 42 2[42 23 42 │ │ │ │ │ +23 51 62 62 85 62 62 60 46 61 65 57 65 62 76 52 65 43 │ │ │ │ │ +30 62 65 54 57 63 60 59 62 1[39 39 65 1[23 23 42 42 42 │ │ │ │ │ +42 42 42 42 42 42 42 42 23 28 23 65 42 32 32 23 1[69 │ │ │ │ │ +1[69 42 18[69 69 46 46 48 60 1[60 6[69 1[{}94 83.022 │ │ │ │ │ +/CMR10 rf /Fz 132[48 42 50 50 69 50 53 37 38 39 50 53 │ │ │ │ │ +48 53 80 27 50 29 27 53 48 1[44 53 42 53 46 8[72 1[72 │ │ │ │ │ +73 66 53 72 72 65 72 75 91 57 75 1[36 75 75 60 63 73 │ │ │ │ │ +69 68 72 6[27 48 48 48 48 48 48 48 48 48 48 48 27 32 │ │ │ │ │ +27 2[37 37 26[53 53 12[{}67 83.022 /CMBX10 rf /FA 136[39 │ │ │ │ │ +39 39 39 39 39 1[39 39 39 39 39 1[39 39 39 39 39 39 39 │ │ │ │ │ +39 39 39 32[39 17[39 46[{}23 74.7198 /CMTT9 rf /FB 133[34 │ │ │ │ │ +41 41 55 41 43 30 30 30 1[43 38 43 64 21 2[21 43 38 23 │ │ │ │ │ +34 43 34 43 38 9[79 2[55 43 57 1[52 60 1[70 48 2[28 58 │ │ │ │ │ +60 2[59 55 54 58 7[38 38 38 38 38 38 38 38 38 38 1[21 │ │ │ │ │ +26 21 44[{}51 74.7198 /CMR9 rf /FC 203[30 30 30 30 49[{}4 │ │ │ │ │ +49.8132 /CMR6 rf /FD 133[31 37 37 51 37 39 27 28 28 37 │ │ │ │ │ +39 35 39 59 20 37 22 20 39 35 22 31 39 31 39 35 12[51 │ │ │ │ │ +39 52 1[48 2[65 3[25 53 3[54 51 50 53 7[35 2[35 35 35 │ │ │ │ │ +35 35 35 35 1[20 24 20 31[39 12[{}49 66.4176 /CMR8 rf │ │ │ │ │ +/FE 134[51 2[51 54 38 38 38 2[49 54 1[27 2[27 54 1[30 │ │ │ │ │ +43 54 43 1[49 9[100 6[66 4[76 50 5[75 70 1[73 9[49 2[49 │ │ │ │ │ +1[49 1[49 1[27 1[27 44[{}29 99.6264 /CMR12 rf /FF 172[90 │ │ │ │ │ +2[110 121 2[97 6[106 69[{}5 143.462 /CMBX12 rf /FG 134[70 │ │ │ │ │ +1[96 70 73 51 52 51 70 73 66 73 111 36 1[40 36 73 66 │ │ │ │ │ +40 58 73 58 73 66 12[96 73 98 2[103 1[122 83 6[90 3[99 │ │ │ │ │ +6[36 7[66 3[36 1[36 44[{}35 143.462 /CMR17 rf end │ │ │ │ │ %%EndProlog │ │ │ │ │ %%BeginSetup │ │ │ │ │ %%Feature: *Resolution 600dpi │ │ │ │ │ TeXDict begin │ │ │ │ │ %%BeginPaperSize: Letter │ │ │ │ │ /setpagedevice where │ │ │ │ │ { pop << /PageSize [612 792] >> setpagedevice } │ │ │ │ │ @@ -11601,16 +11578,16 @@ │ │ │ │ │ TeXDict begin 1 0 bop 407 1704 a FG(The)44 b(Reference)g(Man)l(ual)f │ │ │ │ │ (for)g FF(SPOOLES)p FG(,)g(Release)g(2.2:)518 1886 y(An)h(Ob)7 │ │ │ │ │ b(ject)44 b(Orien)l(ted)h(Soft)l(w)l(are)e(Library)f(for)g(Solving)920 │ │ │ │ │ 2069 y(Sparse)h(Linear)g(Systems)f(of)h(Equations)375 │ │ │ │ │ 2459 y FE(Clev)m(e)35 b(Ashcraft)1004 2423 y FD(1)1297 │ │ │ │ │ 2459 y FE(Daniel)d(Pierce)1864 2423 y FD(2)2158 2459 │ │ │ │ │ y FE(Da)m(vid)g(K.)h(W)-8 b(ah)2774 2423 y FD(3)3066 │ │ │ │ │ -2459 y FE(Jason)33 b(W)-8 b(u)3485 2423 y FD(4)1590 2725 │ │ │ │ │ -y FE(F)g(ebruary)33 b(8,)g(2025)104 4280 y FC(1)138 4312 │ │ │ │ │ +2459 y FE(Jason)33 b(W)-8 b(u)3485 2423 y FD(4)1611 2725 │ │ │ │ │ +y FE(Jan)m(uary)33 b(7,)f(2024)104 4280 y FC(1)138 4312 │ │ │ │ │ y FB(Bo)r(eing)70 b(Shared)d(Services)i(Group,)79 b(P)-6 │ │ │ │ │ b(.)68 b(O.)g(Bo)n(x)g(24346,)81 b(Mail)70 b(Stop)d(7L-22,)80 │ │ │ │ │ b(Seattle,)f(W)-6 b(ashington)69 b(98124,)0 4403 y FA │ │ │ │ │ (cleve.ashcraft@boeing.com)p FB(.)64 b(This)34 b(researc)n(h)g(w)n(as)h │ │ │ │ │ (supp)r(orted)d(in)i(part)f(b)n(y)g(the)g(D)n(ARP)-6 │ │ │ │ │ b(A)31 b(Con)n(tract)k(D)n(ABT63-95-C-0122)0 4494 y(and)25 │ │ │ │ │ b(the)h(DoD)f(High)g(P)n(erformance)j(Computing)e(Mo)r(dernization)h │ │ │ │ │ @@ -11780,38 +11757,37 @@ │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 │ │ │ │ │ b(36)125 5407 y(3.3)83 b(Driv)n(er)27 b(programs)e(for)i(the)h │ │ │ │ │ Ft(Coords)e Fy(ob)5 b(ject)42 b(.)g(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h │ │ │ │ │ (.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.) │ │ │ │ │ f(.)h(.)f(.)93 b(37)1929 5656 y(2)p eop end │ │ │ │ │ %%Page: 3 4 │ │ │ │ │ -TeXDict begin 3 3 bop 83 100 1161 4 v 1326 100 a Fz(SPOOLES)32 │ │ │ │ │ -b(2.2)27 b Fr(:)120 b(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2700 100 V 1161 w Fy(3)0 390 y Fz(4)77 b Ft(DV)p Fz(:)30 │ │ │ │ │ -b(Double)h(V)-8 b(ector)33 b(Ob)5 b(ject)2617 b(39)125 │ │ │ │ │ -511 y Fy(4.1)83 b(Data)28 b(Structure)61 b(.)41 b(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ -(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ -f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ -(.)h(.)f(.)93 b(39)125 632 y(4.2)83 b(Protot)n(yp)r(es)26 │ │ │ │ │ -b(and)i(descriptions)f(of)g Ft(DV)g Fy(metho)r(ds)83 │ │ │ │ │ -b(.)41 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ -g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(40)315 │ │ │ │ │ -752 y(4.2.1)h(Basic)27 b(metho)r(ds)74 b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ -(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ -f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 │ │ │ │ │ -b(40)315 873 y(4.2.2)h(Instance)27 b(metho)r(ds)j(.)41 │ │ │ │ │ -b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h │ │ │ │ │ -(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.) │ │ │ │ │ -f(.)h(.)f(.)93 b(40)315 994 y(4.2.3)h(Initializer)27 │ │ │ │ │ -b(metho)r(ds)48 b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ -g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(41)315 1114 y(4.2.4)h(Utilit)n(y)28 │ │ │ │ │ -b(metho)r(ds)i(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ +TeXDict begin 3 3 bop 83 100 1178 4 v 1344 100 a Fz(SPOOLES)31 │ │ │ │ │ +b(2.2)c Fr(:)120 b(Jan)n(uary)26 b(7,)h(2024)p 2683 100 │ │ │ │ │ +V 1178 w Fy(3)0 390 y Fz(4)77 b Ft(DV)p Fz(:)30 b(Double)h(V)-8 │ │ │ │ │ +b(ector)33 b(Ob)5 b(ject)2617 b(39)125 511 y Fy(4.1)83 │ │ │ │ │ +b(Data)28 b(Structure)61 b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ (.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(42)315 1235 │ │ │ │ │ +h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 │ │ │ │ │ +b(39)125 632 y(4.2)83 b(Protot)n(yp)r(es)26 b(and)i(descriptions)f(of)g │ │ │ │ │ +Ft(DV)g Fy(metho)r(ds)83 b(.)41 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ +(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ +93 b(40)315 752 y(4.2.1)h(Basic)27 b(metho)r(ds)74 b(.)42 │ │ │ │ │ +b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +g(.)f(.)h(.)f(.)93 b(40)315 873 y(4.2.2)h(Instance)27 │ │ │ │ │ +b(metho)r(ds)j(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ +(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(40)315 994 y(4.2.3)h(Initializer) │ │ │ │ │ +27 b(metho)r(ds)48 b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ +(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(41)315 1114 y(4.2.4)h(Utilit)n(y) │ │ │ │ │ +28 b(metho)r(ds)i(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(42)315 1235 │ │ │ │ │ y(4.2.5)h(IO)27 b(metho)r(ds)44 b(.)d(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 │ │ │ │ │ b(43)125 1356 y(4.3)83 b(Driv)n(er)27 b(programs)e(for)i(the)h │ │ │ │ │ Ft(DV)43 b(object)32 b Fy(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)93 b(45)0 1559 y Fz(5)77 b Ft(Drand)p │ │ │ │ │ @@ -11904,17 +11880,17 @@ │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 │ │ │ │ │ b(61)125 5407 y(8.3)83 b(Driv)n(er)27 b(programs)e(for)i(the)h │ │ │ │ │ Ft(IV)43 b(object)32 b Fy(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)93 b(63)p eop end │ │ │ │ │ %%Page: 4 5 │ │ │ │ │ -TeXDict begin 4 4 bop 0 100 a Fy(4)p 125 100 1161 4 v │ │ │ │ │ -1326 w Fz(SPOOLES)31 b(2.2)c Fr(:)37 b(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2740 100 V 0 390 a Fz(9)77 b Ft(IVL)p Fz(:)30 │ │ │ │ │ +TeXDict begin 4 4 bop 0 100 a Fy(4)p 125 100 1178 4 v │ │ │ │ │ +1343 w Fz(SPOOLES)32 b(2.2)27 b Fr(:)37 b(Jan)n(uary)25 │ │ │ │ │ +b(7,)i(2024)p 2722 100 V 0 390 a Fz(9)77 b Ft(IVL)p Fz(:)30 │ │ │ │ │ b(In)m(teger)i(V)-8 b(ector)32 b(List)g(Ob)5 b(ject)2382 │ │ │ │ │ b(64)125 513 y Fy(9.1)83 b(Data)28 b(Structure)61 b(.)41 │ │ │ │ │ b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(64)125 637 y(9.2)83 │ │ │ │ │ b(Protot)n(yp)r(es)26 b(and)i(descriptions)f(of)g Ft(IVL)g │ │ │ │ │ Fy(metho)r(ds)39 b(.)i(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ @@ -12030,20 +12006,20 @@ │ │ │ │ │ b(.)c(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ (.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ 93 b(94)315 5407 y(13.2.5)52 b Ft(FV)27 b Fy(:)h Ft(float)d │ │ │ │ │ Fy(v)n(ector)i(metho)r(ds)21 b(.)42 b(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ (.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 b(96)p eop end │ │ │ │ │ %%Page: 5 6 │ │ │ │ │ -TeXDict begin 5 5 bop 83 100 1161 4 v 1326 100 a Fz(SPOOLES)32 │ │ │ │ │ -b(2.2)27 b Fr(:)120 b(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2700 100 V 1161 w Fy(5)315 390 y(13.2.6)52 b Ft(PCV)27 │ │ │ │ │ -b Fy(:)g Ft(char)42 b(*)28 b Fy(v)n(ector)e(metho)r(ds)64 │ │ │ │ │ -b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ -f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 │ │ │ │ │ +TeXDict begin 5 5 bop 83 100 1178 4 v 1344 100 a Fz(SPOOLES)31 │ │ │ │ │ +b(2.2)c Fr(:)120 b(Jan)n(uary)26 b(7,)h(2024)p 2683 100 │ │ │ │ │ +V 1178 w Fy(5)315 390 y(13.2.6)52 b Ft(PCV)27 b Fy(:)g │ │ │ │ │ +Ft(char)42 b(*)28 b Fy(v)n(ector)e(metho)r(ds)64 b(.)41 │ │ │ │ │ +b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h │ │ │ │ │ +(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)93 │ │ │ │ │ b(99)315 521 y(13.2.7)52 b Ft(PDV)27 b Fy(:)g Ft(double)41 │ │ │ │ │ b(*)28 b Fy(v)n(ector)e(metho)r(ds)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h │ │ │ │ │ (.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.) │ │ │ │ │ h(.)g(.)f(.)h(.)f(.)93 b(99)315 651 y(13.2.8)52 b Ft(PFV)27 │ │ │ │ │ b Fy(:)g Ft(float)42 b(*)27 b Fy(v)n(ector)f(metho)r(ds)85 │ │ │ │ │ b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ @@ -12145,17 +12121,17 @@ │ │ │ │ │ (.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(123)125 │ │ │ │ │ 5407 y(16.3)41 b(Driv)n(er)27 b(programs)e(for)i(the)h │ │ │ │ │ Ft(BPG)f Fy(ob)5 b(ject)44 b(.)e(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)51 b(124)p eop end │ │ │ │ │ %%Page: 6 7 │ │ │ │ │ -TeXDict begin 6 6 bop 0 100 a Fy(6)p 125 100 1161 4 v │ │ │ │ │ -1326 w Fz(SPOOLES)31 b(2.2)c Fr(:)37 b(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2740 100 V 0 390 a Fz(17)i Ft(DSTree)p │ │ │ │ │ +TeXDict begin 6 6 bop 0 100 a Fy(6)p 125 100 1178 4 v │ │ │ │ │ +1343 w Fz(SPOOLES)32 b(2.2)27 b Fr(:)37 b(Jan)n(uary)25 │ │ │ │ │ +b(7,)i(2024)p 2722 100 V 0 390 a Fz(17)i Ft(DSTree)p │ │ │ │ │ Fz(:)125 490 y(A)j(Domain/Separator)g(T)-8 b(ree)32 b(Ob)5 │ │ │ │ │ b(ject)2217 b(126)125 616 y Fy(17.1)41 b(Data)28 b(Structure)61 │ │ │ │ │ b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ (.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(126)125 742 │ │ │ │ │ y(17.2)41 b(Protot)n(yp)r(es)26 b(and)i(descriptions)f(of)g │ │ │ │ │ Ft(DSTree)e Fy(metho)r(ds)38 b(.)k(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h │ │ │ │ │ @@ -12267,57 +12243,57 @@ │ │ │ │ │ (.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ (.)51 b(163)125 5407 y(20.2)41 b(Protot)n(yp)r(es)26 │ │ │ │ │ b(and)i(descriptions)f(of)g Ft(GPart)f Fy(metho)r(ds)81 │ │ │ │ │ b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(164)p eop end │ │ │ │ │ %%Page: 7 8 │ │ │ │ │ -TeXDict begin 7 7 bop 83 100 1161 4 v 1326 100 a Fz(SPOOLES)32 │ │ │ │ │ -b(2.2)27 b Fr(:)120 b(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2700 100 V 1161 w Fy(7)315 390 y(20.2.1)52 b(Basic)27 │ │ │ │ │ -b(metho)r(ds)74 b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +TeXDict begin 7 7 bop 83 100 1178 4 v 1344 100 a Fz(SPOOLES)31 │ │ │ │ │ +b(2.2)c Fr(:)120 b(Jan)n(uary)26 b(7,)h(2024)p 2683 100 │ │ │ │ │ +V 1178 w Fy(7)315 390 y(20.2.1)52 b(Basic)27 b(metho)r(ds)74 │ │ │ │ │ +b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ +h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ +(.)h(.)g(.)f(.)h(.)f(.)51 b(164)315 526 y(20.2.2)h(Initializer)27 │ │ │ │ │ +b(metho)r(ds)48 b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(165)315 661 y(20.2.3)h(Utilit)n(y) │ │ │ │ │ +28 b(metho)r(ds)i(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ -(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(164)315 526 │ │ │ │ │ -y(20.2.2)h(Initializer)27 b(metho)r(ds)48 b(.)42 b(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ -(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(165)315 661 y(20.2.3)h(Utilit)n(y)28 b(metho)r(ds)i(.)42 │ │ │ │ │ +(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(165)315 796 │ │ │ │ │ +y(20.2.4)h(Domain)28 b(decomp)r(osition)f(metho)r(ds)81 │ │ │ │ │ +b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ +b(166)315 932 y(20.2.5)h(Metho)r(ds)28 b(to)f(generate)g(a)g(2-set)g │ │ │ │ │ +(partition)78 b(.)42 b(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h │ │ │ │ │ +(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ +b(167)315 1067 y(20.2.6)h(Metho)r(ds)28 b(to)f(impro)n(v)n(e)g(a)g │ │ │ │ │ +(2-set)g(partition)j(.)41 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h │ │ │ │ │ +(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ +b(167)315 1202 y(20.2.7)h(Recursiv)n(e)27 b(Bisection)g(metho)r(d)45 │ │ │ │ │ +b(.)d(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h │ │ │ │ │ +(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ +b(169)315 1338 y(20.2.8)h Ft(DDsepInfo)24 b Fy(metho)r(ds)69 │ │ │ │ │ +b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ +(.)h(.)f(.)51 b(169)125 1473 y(20.3)41 b(Driv)n(er)27 │ │ │ │ │ +b(programs)e(for)i(the)h Ft(GPart)e Fy(ob)5 b(ject)22 │ │ │ │ │ +b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ +b(170)0 1698 y Fz(21)29 b Ft(Graph)p Fz(:)39 b(A)32 b(Graph)h(ob)5 │ │ │ │ │ +b(ject)2685 b(174)125 1834 y Fy(21.1)41 b(Data)28 b(Structure)61 │ │ │ │ │ +b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(175)125 1969 │ │ │ │ │ +y(21.2)41 b(Protot)n(yp)r(es)26 b(and)i(descriptions)f(of)g │ │ │ │ │ +Ft(Graph)f Fy(metho)r(ds)81 b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ +h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ +b(175)315 2105 y(21.2.1)h(Basic)27 b(metho)r(ds)74 b(.)42 │ │ │ │ │ b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ (.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ -g(.)f(.)h(.)f(.)51 b(165)315 796 y(20.2.4)h(Domain)28 │ │ │ │ │ -b(decomp)r(osition)f(metho)r(ds)81 b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ -g(.)f(.)h(.)f(.)51 b(166)315 932 y(20.2.5)h(Metho)r(ds)28 │ │ │ │ │ -b(to)f(generate)g(a)g(2-set)g(partition)78 b(.)42 b(.)g(.)f(.)h(.)f(.)h │ │ │ │ │ -(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.) │ │ │ │ │ -f(.)h(.)f(.)51 b(167)315 1067 y(20.2.6)h(Metho)r(ds)28 │ │ │ │ │ -b(to)f(impro)n(v)n(e)g(a)g(2-set)g(partition)j(.)41 b(.)h(.)g(.)f(.)h │ │ │ │ │ -(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.) │ │ │ │ │ -h(.)g(.)f(.)h(.)f(.)51 b(167)315 1202 y(20.2.7)h(Recursiv)n(e)27 │ │ │ │ │ -b(Bisection)g(metho)r(d)45 b(.)d(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ -f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ -(.)g(.)f(.)h(.)f(.)51 b(169)315 1338 y(20.2.8)h Ft(DDsepInfo)24 │ │ │ │ │ -b Fy(metho)r(ds)69 b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ -(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(169)125 1473 y(20.3)41 │ │ │ │ │ -b(Driv)n(er)27 b(programs)e(for)i(the)h Ft(GPart)e Fy(ob)5 │ │ │ │ │ -b(ject)22 b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ -(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ -51 b(170)0 1698 y Fz(21)29 b Ft(Graph)p Fz(:)39 b(A)32 │ │ │ │ │ -b(Graph)h(ob)5 b(ject)2685 b(174)125 1834 y Fy(21.1)41 │ │ │ │ │ -b(Data)28 b(Structure)61 b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(175)125 1969 y(21.2)41 b(Protot)n(yp)r(es)26 b(and)i(descriptions)f │ │ │ │ │ -(of)g Ft(Graph)f Fy(metho)r(ds)81 b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ -(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ -51 b(175)315 2105 y(21.2.1)h(Basic)27 b(metho)r(ds)74 │ │ │ │ │ -b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)g(.)f(.)h(.)f(.)51 b(175)315 2240 y(21.2.2)h(Initializer)27 │ │ │ │ │ +g(.)f(.)h(.)f(.)51 b(175)315 2240 y(21.2.2)h(Initializer)27 │ │ │ │ │ b(metho)r(ds)48 b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ (.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(176)315 2375 y(21.2.3)h(Compress)27 │ │ │ │ │ b(and)g(Expand)g(metho)r(ds)g(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ (.)f(.)h(.)f(.)51 b(177)315 2511 y(21.2.4)h(Wirebask)n(et)27 │ │ │ │ │ b(domain)g(decomp)r(osition)g(ordering)54 b(.)42 b(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ @@ -12383,17 +12359,17 @@ │ │ │ │ │ f(of)g Ft(MSMDvtx)e Fy(metho)r(ds)59 b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ (.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ 51 b(192)125 5407 y(22.5)41 b(Driv)n(er)27 b(programs)e(for)i(the)h │ │ │ │ │ Ft(MSMD)e Fy(ob)5 b(ject)66 b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)51 b(192)p eop end │ │ │ │ │ %%Page: 8 9 │ │ │ │ │ -TeXDict begin 8 8 bop 0 100 a Fy(8)p 125 100 1161 4 v │ │ │ │ │ -1326 w Fz(SPOOLES)31 b(2.2)c Fr(:)37 b(F)-7 b(ebruary)27 │ │ │ │ │ -b(8,)g(2025)p 2740 100 V 0 390 a Fz(23)i Ft(Network)p │ │ │ │ │ +TeXDict begin 8 8 bop 0 100 a Fy(8)p 125 100 1178 4 v │ │ │ │ │ +1343 w Fz(SPOOLES)32 b(2.2)27 b Fr(:)37 b(Jan)n(uary)25 │ │ │ │ │ +b(7,)i(2024)p 2722 100 V 0 390 a Fz(23)i Ft(Network)p │ │ │ │ │ Fz(:)39 b(Simple)30 b(Max-\015o)m(w)i(solv)m(er)2283 │ │ │ │ │ b(195)125 514 y Fy(23.1)41 b(Data)28 b(Structure)61 b(.)41 │ │ │ │ │ b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(196)125 638 y(23.2)41 │ │ │ │ │ b(Protot)n(yp)r(es)26 b(and)i(descriptions)f(of)g Ft(Network)e │ │ │ │ │ Fy(metho)r(ds)59 b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ @@ -12503,79 +12479,79 @@ │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(220)315 5407 y(26.2.3)h │ │ │ │ │ (Initialization)27 b(metho)r(ds)62 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h │ │ │ │ │ (.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.) │ │ │ │ │ f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(222)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 9 10 │ │ │ │ │ -TeXDict begin 9 9 bop 83 100 1161 4 v 1326 100 a Fz(SPOOLES)32 │ │ │ │ │ -b(2.2)27 b Fr(:)120 b(F)-7 b(ebruary)26 b(8,)h(2025)p │ │ │ │ │ -2700 100 V 1161 w Fy(9)315 390 y(26.2.4)52 b(Searc)n(h)27 │ │ │ │ │ -b(metho)r(ds)i(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(223)315 513 │ │ │ │ │ -y(26.2.5)h(Piv)n(ot)27 b(metho)r(ds)72 b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ -(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ -f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(224)315 637 y(26.2.6)h(Up)r(date)28 b(metho)r(ds)65 │ │ │ │ │ -b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ -f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ -(.)g(.)f(.)h(.)f(.)51 b(224)315 760 y(26.2.7)h(Assem)n(bly)27 │ │ │ │ │ -b(metho)r(ds)52 b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +TeXDict begin 9 9 bop 83 100 1178 4 v 1344 100 a Fz(SPOOLES)31 │ │ │ │ │ +b(2.2)c Fr(:)120 b(Jan)n(uary)26 b(7,)h(2024)p 2683 100 │ │ │ │ │ +V 1178 w Fy(9)315 390 y(26.2.4)52 b(Searc)n(h)27 b(metho)r(ds)i(.)42 │ │ │ │ │ +b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +g(.)f(.)h(.)f(.)51 b(223)315 513 y(26.2.5)h(Piv)n(ot)27 │ │ │ │ │ +b(metho)r(ds)72 b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(224)315 637 │ │ │ │ │ +y(26.2.6)h(Up)r(date)28 b(metho)r(ds)65 b(.)41 b(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(225)315 883 y(26.2.8)h(F)-7 │ │ │ │ │ -b(actorization)26 b(metho)r(ds)49 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h │ │ │ │ │ -(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.) │ │ │ │ │ -f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(225)315 │ │ │ │ │ -1007 y(26.2.9)h(Cop)n(y)27 b(metho)r(ds)78 b(.)42 b(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(226)315 1130 y(26.2.10)10 b(Sw)n(ap)27 b(metho)r(ds)76 │ │ │ │ │ -b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ +(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ +b(224)315 760 y(26.2.7)h(Assem)n(bly)27 b(metho)r(ds)52 │ │ │ │ │ +b(.)42 b(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ +h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ +(.)f(.)h(.)f(.)51 b(225)315 883 y(26.2.8)h(F)-7 b(actorization)26 │ │ │ │ │ +b(metho)r(ds)49 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)g(.)f(.)h(.)f(.)51 b(228)315 1253 y(26.2.11)10 │ │ │ │ │ -b(Utilit)n(y)28 b(metho)r(ds)i(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ -(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ -f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(229)315 1376 y(26.2.12)10 b(IO)27 b(metho)r(ds)44 b(.)d(.)h(.)g(.)f │ │ │ │ │ -(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +(.)h(.)g(.)f(.)h(.)f(.)51 b(225)315 1007 y(26.2.9)h(Cop)n(y)27 │ │ │ │ │ +b(metho)r(ds)78 b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ -(.)h(.)f(.)51 b(230)125 1500 y(26.3)41 b(Driv)n(er)27 │ │ │ │ │ -b(programs)e(for)i(the)h Ft(Chv)43 b(object)53 b Fy(.)41 │ │ │ │ │ -b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h │ │ │ │ │ -(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(231)0 1706 y Fz(27)29 b Ft(ChvList)p Fz(:)39 b Ft(Chv)30 │ │ │ │ │ -b Fz(list)h(ob)5 b(ject)2678 b(236)125 1829 y Fy(27.1)41 │ │ │ │ │ -b(Data)28 b(Structure)61 b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(226)315 1130 │ │ │ │ │ +y(26.2.10)10 b(Sw)n(ap)27 b(metho)r(ds)76 b(.)42 b(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ (.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(237)125 1953 y(27.2)41 b(Protot)n(yp)r(es)26 b(and)i(descriptions)f │ │ │ │ │ -(of)g Ft(ChvList)e Fy(metho)r(ds)59 b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.) │ │ │ │ │ -f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(237)315 2076 y(27.2.1)h(Basic)27 b(metho)r(ds)74 b(.)42 │ │ │ │ │ +b(228)315 1253 y(26.2.11)10 b(Utilit)n(y)28 b(metho)r(ds)i(.)42 │ │ │ │ │ b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ (.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ -g(.)f(.)h(.)f(.)51 b(237)315 2199 y(27.2.2)h(Initialization)27 │ │ │ │ │ -b(metho)r(ds)62 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)g(.)f(.)h(.)f(.)51 b(238)315 2323 y(27.2.3)h(Utilit)n(y)28 │ │ │ │ │ -b(metho)r(ds)i(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(238)315 2446 │ │ │ │ │ -y(27.2.4)h(IO)27 b(metho)r(ds)44 b(.)d(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ -(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ -f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(238)0 2652 y Fz(28)29 b Ft(ChvManager)p Fz(:)37 b Ft(Chv)31 │ │ │ │ │ -b Fz(manager)h(ob)5 b(ject)2319 b(239)125 2775 y Fy(28.1)41 │ │ │ │ │ -b(Data)28 b(Structure)61 b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ -(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ -h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ -b(240)125 2899 y(28.2)41 b(Protot)n(yp)r(es)26 b(and)i(descriptions)f │ │ │ │ │ -(of)g Ft(ChvManager)d Fy(metho)r(ds)57 b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h │ │ │ │ │ -(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ +g(.)f(.)h(.)f(.)51 b(229)315 1376 y(26.2.12)10 b(IO)27 │ │ │ │ │ +b(metho)r(ds)44 b(.)d(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(230)125 │ │ │ │ │ +1500 y(26.3)41 b(Driv)n(er)27 b(programs)e(for)i(the)h │ │ │ │ │ +Ft(Chv)43 b(object)53 b Fy(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +g(.)f(.)h(.)f(.)51 b(231)0 1706 y Fz(27)29 b Ft(ChvList)p │ │ │ │ │ +Fz(:)39 b Ft(Chv)30 b Fz(list)h(ob)5 b(ject)2678 b(236)125 │ │ │ │ │ +1829 y Fy(27.1)41 b(Data)28 b(Structure)61 b(.)41 b(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ +(.)h(.)f(.)51 b(237)125 1953 y(27.2)41 b(Protot)n(yp)r(es)26 │ │ │ │ │ +b(and)i(descriptions)f(of)g Ft(ChvList)e Fy(metho)r(ds)59 │ │ │ │ │ +b(.)41 b(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(237)315 2076 y(27.2.1)h(Basic)27 │ │ │ │ │ +b(metho)r(ds)74 b(.)42 b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(237)315 2199 │ │ │ │ │ +y(27.2.2)h(Initialization)27 b(metho)r(ds)62 b(.)42 b(.)f(.)h(.)g(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ +b(238)315 2323 y(27.2.3)h(Utilit)n(y)28 b(metho)r(ds)i(.)42 │ │ │ │ │ +b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +g(.)f(.)h(.)f(.)51 b(238)315 2446 y(27.2.4)h(IO)27 b(metho)r(ds)44 │ │ │ │ │ +b(.)d(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ +(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ +h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(238)0 2652 y Fz(28)29 │ │ │ │ │ +b Ft(ChvManager)p Fz(:)37 b Ft(Chv)31 b Fz(manager)h(ob)5 │ │ │ │ │ +b(ject)2319 b(239)125 2775 y Fy(28.1)41 b(Data)28 b(Structure)61 │ │ │ │ │ +b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ +f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(240)125 2899 │ │ │ │ │ +y(28.2)41 b(Protot)n(yp)r(es)26 b(and)i(descriptions)f(of)g │ │ │ │ │ +Ft(ChvManager)d Fy(metho)r(ds)57 b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ +(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ b(240)315 3022 y(28.2.1)h(Basic)27 b(metho)r(ds)74 b(.)42 │ │ │ │ │ b(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ (.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.) │ │ │ │ │ g(.)f(.)h(.)f(.)51 b(240)315 3145 y(28.2.2)h(Initialization)27 │ │ │ │ │ b(metho)r(ds)62 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f │ │ │ │ │ (.)h(.)g(.)f(.)h(.)f(.)51 b(241)315 3269 y(28.2.3)h(Utilit)n(y)28 │ │ │ │ │ @@ -12628,17 +12604,17 @@ │ │ │ │ │ (.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.) │ │ │ │ │ f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(257)315 │ │ │ │ │ 5407 y(30.2.4)h(Utilit)n(y)28 b(F)-7 b(actorization)26 │ │ │ │ │ b(metho)r(ds)43 b(.)e(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)51 b(258)p eop end │ │ │ │ │ %%Page: 10 11 │ │ │ │ │ -TeXDict begin 10 10 bop 0 100 a Fy(10)p 166 100 1140 │ │ │ │ │ -4 v 1304 w Fz(SPOOLES)32 b(2.2)27 b Fr(:)37 b(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 2761 100 V 315 390 a Fy(30.2.5)52 b(Serial)27 │ │ │ │ │ +TeXDict begin 10 10 bop 0 100 a Fy(10)p 166 100 1157 │ │ │ │ │ +4 v 1322 w Fz(SPOOLES)32 b(2.2)26 b Fr(:)37 b(Jan)n(uary)26 │ │ │ │ │ +b(7,)h(2024)p 2743 100 V 315 390 a Fy(30.2.5)52 b(Serial)27 │ │ │ │ │ b(F)-7 b(actorization)26 b(metho)r(d)45 b(.)d(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(260)315 512 y(30.2.6)h(QR)28 │ │ │ │ │ b(factorization)e(utilit)n(y)i(metho)r(ds)56 b(.)41 b(.)h(.)f(.)h(.)g │ │ │ │ │ (.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.) │ │ │ │ │ h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(261)315 635 y(30.2.7)h(Serial)27 │ │ │ │ │ b Fs(QR)h Fy(F)-7 b(actorization)26 b(metho)r(d)82 b(.)41 │ │ │ │ │ @@ -12759,17 +12735,17 @@ │ │ │ │ │ (.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.) │ │ │ │ │ f(.)h(.)f(.)51 b(299)125 5407 y(33.3)41 b(Driv)n(er)27 │ │ │ │ │ b(programs)76 b(.)42 b(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h │ │ │ │ │ (.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.) │ │ │ │ │ h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(302)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 11 12 │ │ │ │ │ -TeXDict begin 11 11 bop 83 100 1140 4 v 1305 100 a Fz(SPOOLES)32 │ │ │ │ │ -b(2.2)27 b Fr(:)120 b(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -2680 100 V 1140 w Fy(11)0 390 y Fz(34)h Ft(PatchAndGoInfo)p │ │ │ │ │ +TeXDict begin 11 11 bop 83 100 1157 4 v 1323 100 a Fz(SPOOLES)32 │ │ │ │ │ +b(2.2)26 b Fr(:)120 b(Jan)n(uary)26 b(7,)h(2024)p 2662 │ │ │ │ │ +100 V 1157 w Fy(11)0 390 y Fz(34)i Ft(PatchAndGoInfo)p │ │ │ │ │ Fz(:)36 b(Piv)m(ot)c(Mo)s(di\014cation)f(Ob)5 b(ject)1856 │ │ │ │ │ b(307)125 513 y Fy(34.1)41 b(Data)28 b(Structure)61 b(.)41 │ │ │ │ │ b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(308)125 637 y(34.2)41 │ │ │ │ │ b(Protot)n(yp)r(es)26 b(and)i(descriptions)f(of)g Ft(PatchAndGoInfo)22 │ │ │ │ │ b Fy(metho)r(ds)76 b(.)42 b(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f │ │ │ │ │ @@ -12882,17 +12858,17 @@ │ │ │ │ │ (.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.) │ │ │ │ │ h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(335)315 5407 │ │ │ │ │ y(38.2.4)h(IO)27 b(metho)r(ds)44 b(.)d(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ b(335)p eop end │ │ │ │ │ %%Page: 12 13 │ │ │ │ │ -TeXDict begin 12 12 bop 0 100 a Fy(12)p 166 100 1140 │ │ │ │ │ -4 v 1304 w Fz(SPOOLES)32 b(2.2)27 b Fr(:)37 b(F)-7 b(ebruary)26 │ │ │ │ │ -b(8,)i(2025)p 2761 100 V 0 390 a Fz(39)h Ft(SubMtxManager)p │ │ │ │ │ +TeXDict begin 12 12 bop 0 100 a Fy(12)p 166 100 1157 │ │ │ │ │ +4 v 1322 w Fz(SPOOLES)32 b(2.2)26 b Fr(:)37 b(Jan)n(uary)26 │ │ │ │ │ +b(7,)h(2024)p 2743 100 V 0 390 a Fz(39)i Ft(SubMtxManager)p │ │ │ │ │ Fz(:)36 b Ft(SubMtx)29 b Fz(ob)5 b(ject)33 b(manager)2057 │ │ │ │ │ b(336)125 515 y Fy(39.1)41 b(Data)28 b(Structure)61 b(.)41 │ │ │ │ │ b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h │ │ │ │ │ (.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.) │ │ │ │ │ f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(337)125 640 y(39.2)41 │ │ │ │ │ b(Protot)n(yp)r(es)26 b(and)i(descriptions)f(of)g Ft(SubMtxManager)22 │ │ │ │ │ b Fy(metho)r(ds)56 b(.)41 b(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h │ │ │ │ │ @@ -12978,17 +12954,17 @@ │ │ │ │ │ f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f │ │ │ │ │ (.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(368)315 5407 │ │ │ │ │ y(43.1.1)h Ft(MatMulInfo)24 b Fy(:)37 b(Matrix-matrix)26 │ │ │ │ │ b(m)n(ultiply)i(information)f(ob)5 b(ject)75 b(.)41 b(.)h(.)f(.)h(.)g │ │ │ │ │ (.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(368)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 13 14 │ │ │ │ │ -TeXDict begin 13 13 bop 83 100 1140 4 v 1305 100 a Fz(SPOOLES)32 │ │ │ │ │ -b(2.2)27 b Fr(:)120 b(F)-7 b(ebruary)26 b(8,)i(2025)p │ │ │ │ │ -2680 100 V 1140 w Fy(13)125 390 y(43.2)41 b(Protot)n(yp)r(es)26 │ │ │ │ │ +TeXDict begin 13 13 bop 83 100 1157 4 v 1323 100 a Fz(SPOOLES)32 │ │ │ │ │ +b(2.2)26 b Fr(:)120 b(Jan)n(uary)26 b(7,)h(2024)p 2662 │ │ │ │ │ +100 V 1157 w Fy(13)125 390 y(43.2)41 b(Protot)n(yp)r(es)26 │ │ │ │ │ b(and)i(descriptions)f(of)g Ft(MPI)g Fy(metho)r(ds)39 │ │ │ │ │ b(.)i(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g │ │ │ │ │ (.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 b(369)315 │ │ │ │ │ 515 y(43.2.1)h(Split)28 b(and)g(redistribution)f(metho)r(ds)59 │ │ │ │ │ b(.)41 b(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)h(.) │ │ │ │ │ f(.)h(.)g(.)f(.)h(.)f(.)h(.)f(.)h(.)g(.)f(.)h(.)f(.)51 │ │ │ │ │ b(369)315 639 y(43.2.2)h(Gather)27 b(and)h(scatter)f(metho)r(ds)j(.)42 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ │ │ The Reference Manual for SPOOLES, Release 2.2: │ │ │ │ │ │ An Object Oriented Software Library for Solving │ │ │ │ │ │ Sparse Linear Systems of Equations │ │ │ │ │ │ 1 2 3 4 │ │ │ │ │ │ Cleve Ashcraft Daniel Pierce David K. Wah Jason Wu │ │ │ │ │ │ - February 8, 2025 │ │ │ │ │ │ + January 7, 2024 │ │ │ │ │ │ 1Boeing Shared Services Group, P. O. Box 24346, Mail Stop 7L-22, Seattle, Washington 98124, │ │ │ │ │ │ cleve.ashcraft@boeing.com. This research was supported in part by the DARPA Contract DABT63-95-C-0122 │ │ │ │ │ │ and the DoD High Performance Computing Modernization Program Common HPC Software Support Initiative. │ │ │ │ │ │ 2Boeing Shared Services Group, P. O. Box 24346, Mail Stop 7L-22, Seattle, Washington 98124, │ │ │ │ │ │ dpierce@redwood.rt.cs.boeing.com. This research was supported in part by the DARPA Contract DABT63- │ │ │ │ │ │ 95-C-0122 and the DoD High Performance Computing Modernization Program Common HPC Software Support │ │ │ │ │ │ Initiative. │ │ │ │ │ │ @@ -68,15 +68,15 @@ │ │ │ │ │ │ 3.2 Prototypes and descriptions of Coords methods . . . . . . . . . . . . . . . . . . . . . . . . . . 34 │ │ │ │ │ │ 3.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 │ │ │ │ │ │ 3.2.2 Initializer methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 │ │ │ │ │ │ 3.2.3 Utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 │ │ │ │ │ │ 3.2.4 IO methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 │ │ │ │ │ │ 3.3 Driver programs for the Coords object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 │ │ │ │ │ │ 2 │ │ │ │ │ │ - SPOOLES 2.2 : February 8, 2025 3 │ │ │ │ │ │ + SPOOLES2.2: January 7, 2024 3 │ │ │ │ │ │ 4 DV: Double Vector Object 39 │ │ │ │ │ │ 4.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 │ │ │ │ │ │ 4.2 Prototypes and descriptions of DV methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 │ │ │ │ │ │ 4.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 │ │ │ │ │ │ 4.2.2 Instance methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 │ │ │ │ │ │ 4.2.3 Initializer methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 │ │ │ │ │ │ 4.2.4 Utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 │ │ │ │ │ │ @@ -109,15 +109,15 @@ │ │ │ │ │ │ 8.2 Prototypes and descriptions of IV methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 │ │ │ │ │ │ 8.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 │ │ │ │ │ │ 8.2.2 Instance methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 │ │ │ │ │ │ 8.2.3 Initializer methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 │ │ │ │ │ │ 8.2.4 Utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 │ │ │ │ │ │ 8.2.5 IO methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 │ │ │ │ │ │ 8.3 Driver programs for the IV object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 │ │ │ │ │ │ - 4 SPOOLES2.2: February 8, 2025 │ │ │ │ │ │ + 4 SPOOLES 2.2 : January 7, 2024 │ │ │ │ │ │ 9 IVL: Integer Vector List Object 64 │ │ │ │ │ │ 9.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 │ │ │ │ │ │ 9.2 Prototypes and descriptions of IVL methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 │ │ │ │ │ │ 9.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 │ │ │ │ │ │ 9.2.2 Instance methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 │ │ │ │ │ │ 9.2.3 Initialization and resizing methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 │ │ │ │ │ │ 9.2.4 List manipulation methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 │ │ │ │ │ │ @@ -149,15 +149,15 @@ │ │ │ │ │ │ 13.1 Data Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 │ │ │ │ │ │ 13.2 Prototypes and descriptions of Utilities methods . . . . . . . . . . . . . . . . . . . . . . . . 81 │ │ │ │ │ │ 13.2.1 CV : char vector methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 │ │ │ │ │ │ 13.2.2 DV : double vector methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 │ │ │ │ │ │ 13.2.3 ZV : double complex vector methods . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 │ │ │ │ │ │ 13.2.4 IV : int vector methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 │ │ │ │ │ │ 13.2.5 FV : float vector methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 │ │ │ │ │ │ - SPOOLES 2.2 : February 8, 2025 5 │ │ │ │ │ │ + SPOOLES2.2: January 7, 2024 5 │ │ │ │ │ │ 13.2.6 PCV : char * vector methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 │ │ │ │ │ │ 13.2.7 PDV : double * vector methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 │ │ │ │ │ │ 13.2.8 PFV : float * vector methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 │ │ │ │ │ │ 13.2.9 Sorting routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 │ │ │ │ │ │ 13.2.10Sort and compress routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 │ │ │ │ │ │ 13.2.11IP : (int, pointer) singly linked-list methods . . . . . . . . . . . . . . . . . . . . . . 103 │ │ │ │ │ │ 13.2.12I2OP : (int, int, void*, pointer) singly linked-list methods . . . . . . . . . . . . 104 │ │ │ │ │ │ @@ -186,15 +186,15 @@ │ │ │ │ │ │ 16.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 │ │ │ │ │ │ 16.2.2 Initializer methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 │ │ │ │ │ │ 16.2.3 Generate induced graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 │ │ │ │ │ │ 16.2.4 Utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 │ │ │ │ │ │ 16.2.5 Dulmage-Mendelsohn decomposition method . . . . . . . . . . . . . . . . . . . . . . . 123 │ │ │ │ │ │ 16.2.6 IO methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 │ │ │ │ │ │ 16.3 Driver programs for the BPG object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 │ │ │ │ │ │ - 6 SPOOLES2.2: February 8, 2025 │ │ │ │ │ │ + 6 SPOOLES 2.2 : January 7, 2024 │ │ │ │ │ │ 17 DSTree: │ │ │ │ │ │ ADomain/Separator Tree Object 126 │ │ │ │ │ │ 17.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 │ │ │ │ │ │ 17.2 Prototypes and descriptions of DSTree methods . . . . . . . . . . . . . . . . . . . . . . . . . . 126 │ │ │ │ │ │ 17.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 │ │ │ │ │ │ 17.2.2 Instance methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 │ │ │ │ │ │ 17.2.3 Initializer methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 │ │ │ │ │ │ @@ -226,15 +226,15 @@ │ │ │ │ │ │ 19.2.11Parallel factorization map methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 │ │ │ │ │ │ 19.2.12Storage profile methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 │ │ │ │ │ │ 19.2.13IO methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 │ │ │ │ │ │ 19.3 Driver programs for the ETree object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 │ │ │ │ │ │ 20 GPart: Graph Partitioning Object 162 │ │ │ │ │ │ 20.1 Data Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 │ │ │ │ │ │ 20.2 Prototypes and descriptions of GPart methods . . . . . . . . . . . . . . . . . . . . . . . . . . 164 │ │ │ │ │ │ - SPOOLES 2.2 : February 8, 2025 7 │ │ │ │ │ │ + SPOOLES2.2: January 7, 2024 7 │ │ │ │ │ │ 20.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 │ │ │ │ │ │ 20.2.2 Initializer methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 │ │ │ │ │ │ 20.2.3 Utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 │ │ │ │ │ │ 20.2.4 Domain decomposition methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 │ │ │ │ │ │ 20.2.5 Methods to generate a 2-set partition . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 │ │ │ │ │ │ 20.2.6 Methods to improve a 2-set partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 │ │ │ │ │ │ 20.2.7 Recursive Bisection method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 │ │ │ │ │ │ @@ -264,15 +264,15 @@ │ │ │ │ │ │ 22.3.1 Basic methods — public . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 │ │ │ │ │ │ 22.3.2 Initialization methods — public . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 │ │ │ │ │ │ 22.3.3 Ordering methods — public . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 │ │ │ │ │ │ 22.3.4 Extraction methods — public . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 │ │ │ │ │ │ 22.3.5 Internal methods — private . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 │ │ │ │ │ │ 22.4 Prototypes and descriptions of MSMDvtx methods . . . . . . . . . . . . . . . . . . . . . . . . . 192 │ │ │ │ │ │ 22.5 Driver programs for the MSMD object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 │ │ │ │ │ │ - 8 SPOOLES2.2: February 8, 2025 │ │ │ │ │ │ + 8 SPOOLES 2.2 : January 7, 2024 │ │ │ │ │ │ 23 Network: Simple Max-flow solver 195 │ │ │ │ │ │ 23.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 │ │ │ │ │ │ 23.2 Prototypes and descriptions of Network methods . . . . . . . . . . . . . . . . . . . . . . . . . 197 │ │ │ │ │ │ 23.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 │ │ │ │ │ │ 23.2.2 Initializer methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 │ │ │ │ │ │ 23.2.3 Utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 │ │ │ │ │ │ 23.2.4 IO methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 │ │ │ │ │ │ @@ -303,15 +303,15 @@ │ │ │ │ │ │ IV Numeric Objects and Methods 216 │ │ │ │ │ │ 26 Chv: Block chevron 217 │ │ │ │ │ │ 26.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 │ │ │ │ │ │ 26.2 Prototypes and descriptions of Chv methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 │ │ │ │ │ │ 26.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 │ │ │ │ │ │ 26.2.2 Instance methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 │ │ │ │ │ │ 26.2.3 Initialization methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 │ │ │ │ │ │ - SPOOLES 2.2 : February 8, 2025 9 │ │ │ │ │ │ + SPOOLES2.2: January 7, 2024 9 │ │ │ │ │ │ 26.2.4 Search methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 │ │ │ │ │ │ 26.2.5 Pivot methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 │ │ │ │ │ │ 26.2.6 Update methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 │ │ │ │ │ │ 26.2.7 Assembly methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 │ │ │ │ │ │ 26.2.8 Factorization methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 │ │ │ │ │ │ 26.2.9 Copy methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 │ │ │ │ │ │ 26.2.10Swap methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 │ │ │ │ │ │ @@ -343,15 +343,15 @@ │ │ │ │ │ │ 30 FrontMtx: Front matrix 250 │ │ │ │ │ │ 30.1 Data Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 │ │ │ │ │ │ 30.2 Prototypes and descriptions of FrontMtx methods . . . . . . . . . . . . . . . . . . . . . . . . 255 │ │ │ │ │ │ 30.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 │ │ │ │ │ │ 30.2.2 Instance methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 │ │ │ │ │ │ 30.2.3 Initialization methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 │ │ │ │ │ │ 30.2.4 Utility Factorization methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 │ │ │ │ │ │ - 10 SPOOLES 2.2 : February 8, 2025 │ │ │ │ │ │ + 10 SPOOLES 2.2: January 7, 2024 │ │ │ │ │ │ 30.2.5 Serial Factorization method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 │ │ │ │ │ │ 30.2.6 QR factorization utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 │ │ │ │ │ │ 30.2.7 Serial QR Factorization method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 │ │ │ │ │ │ 30.2.8 Postprocessing methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 │ │ │ │ │ │ 30.2.9 Utility Solve methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 │ │ │ │ │ │ 30.2.10Serial Solve method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 │ │ │ │ │ │ 30.2.11Serial QR Solve method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 │ │ │ │ │ │ @@ -384,15 +384,15 @@ │ │ │ │ │ │ 32.3 Driver programs for the InpMtx object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 │ │ │ │ │ │ 33 Iter: Iterative Methods 297 │ │ │ │ │ │ 33.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 │ │ │ │ │ │ 33.2 Prototypes and descriptions of Iter methods . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 │ │ │ │ │ │ 33.2.1 Utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 │ │ │ │ │ │ 33.2.2 Iterative methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 │ │ │ │ │ │ 33.3 Driver programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 │ │ │ │ │ │ - SPOOLES 2.2 : February 8, 2025 11 │ │ │ │ │ │ + SPOOLES 2.2: January 7, 2024 11 │ │ │ │ │ │ 34 PatchAndGoInfo: Pivot Modification Object 307 │ │ │ │ │ │ 34.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 │ │ │ │ │ │ 34.2 Prototypes and descriptions of PatchAndGoInfo methods . . . . . . . . . . . . . . . . . . . . 308 │ │ │ │ │ │ 34.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 │ │ │ │ │ │ 34.2.2 Initializer methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 │ │ │ │ │ │ 35 Pencil: Matrix pencil 310 │ │ │ │ │ │ 35.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 │ │ │ │ │ │ @@ -424,15 +424,15 @@ │ │ │ │ │ │ 38 SubMtxList: SubMtx list object 333 │ │ │ │ │ │ 38.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 │ │ │ │ │ │ 38.2 Prototypes and descriptions of SubMtxList methods . . . . . . . . . . . . . . . . . . . . . . . 334 │ │ │ │ │ │ 38.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 │ │ │ │ │ │ 38.2.2 Initialization methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 │ │ │ │ │ │ 38.2.3 Utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 │ │ │ │ │ │ 38.2.4 IO methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 │ │ │ │ │ │ - 12 SPOOLES 2.2 : February 8, 2025 │ │ │ │ │ │ + 12 SPOOLES 2.2: January 7, 2024 │ │ │ │ │ │ 39 SubMtxManager: SubMtx object manager 336 │ │ │ │ │ │ 39.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 │ │ │ │ │ │ 39.2 Prototypes and descriptions of SubMtxManager methods . . . . . . . . . . . . . . . . . . . . . 337 │ │ │ │ │ │ 39.2.1 Basic methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 │ │ │ │ │ │ 39.2.2 Initialization methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 │ │ │ │ │ │ 39.2.3 Utility methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 │ │ │ │ │ │ 39.2.4 IO methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 │ │ │ │ │ │ @@ -459,15 +459,15 @@ │ │ │ │ │ │ 42.2.4 Multithreaded Solve method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 │ │ │ │ │ │ 42.2.5 Multithreaded QR Solve method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 │ │ │ │ │ │ 42.3 Driver programs for the multithreaded functions . . . . . . . . . . . . . . . . . . . . . . . . . 361 │ │ │ │ │ │ VII MPI Methods 367 │ │ │ │ │ │ 43 MPI directory 368 │ │ │ │ │ │ 43.1 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 │ │ │ │ │ │ 43.1.1 MatMulInfo : Matrix-matrix multiply information object . . . . . . . . . . . . . . . . 368 │ │ │ │ │ │ - SPOOLES 2.2 : February 8, 2025 13 │ │ │ │ │ │ + SPOOLES 2.2: January 7, 2024 13 │ │ │ │ │ │ 43.2 Prototypes and descriptions of MPI methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 │ │ │ │ │ │ 43.2.1 Split and redistribution methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 │ │ │ │ │ │ 43.2.2 Gather and scatter methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 │ │ │ │ │ │ 43.2.3 Symbolic Factorization methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 │ │ │ │ │ │ 43.2.4 Numeric Factorization methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 │ │ │ │ │ │ 43.2.5 Post-processing methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 │ │ │ │ │ │ 43.2.6 Numeric Solve methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375 │ │ │ ├── ./usr/share/doc/spooles-doc/SemiImplMtx.ps.gz │ │ │ │ ├── SemiImplMtx.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o SemiImplMtx.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1200,21 +1200,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1398,88 +1397,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4850,16 +4844,16 @@ │ │ │ │ │ @start /Fa 133[50 59 2[59 1[44 44 3[56 62 93 31 2[31 │ │ │ │ │ 62 2[51 62 50 1[54 11[86 1[62 3[84 1[106 3[42 6[80 12[56 │ │ │ │ │ 56 56 56 56 2[31 46[{}27 99.6264 /CMBX12 rf /Fb 135[62 │ │ │ │ │ 3[62 3[62 2[62 62 2[62 3[62 17[62 5[62 3[62 73[{}10 119.552 │ │ │ │ │ /CMTT12 rf /Fc 134[71 2[71 75 52 53 55 1[75 67 75 112 │ │ │ │ │ 2[41 37 75 67 41 61 75 60 75 65 13[75 2[92 11[103 16[67 │ │ │ │ │ 67 67 2[37 46[{}27 119.552 /CMBX12 rf /Fd 134[44 3[46 │ │ │ │ │ -2[33 12[37 2[46 42 26[54 11[23 1[42 2[42 2[42 1[42 3[23 │ │ │ │ │ -44[{}13 83.022 /CMSL10 rf /Fe 137[38 45 28 34 35 1[42 │ │ │ │ │ +2[33 3[46 12[42 22[43 15[23 2[42 2[42 1[42 1[42 3[23 │ │ │ │ │ +44[{}12 83.022 /CMSL10 rf /Fe 137[38 45 28 34 35 1[42 │ │ │ │ │ 42 47 68 21 2[25 3[38 42 38 1[42 12[59 1[61 11[54 1[63 │ │ │ │ │ 2[62 6[25 12[30 45[{}22 83.022 /CMTI10 rf /Ff 149[23 │ │ │ │ │ 104[23 65{}3 83.022 /CMSY10 rf │ │ │ │ │ %DVIPSBitmapFont: Fg tcrm1000 10 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ @@ -5044,25 +5038,25 @@ │ │ │ │ │ Fn(2)p Ff(j)p Fl(D)722 5419 y Fj(1)p Fi(;)p Fj(1)812 │ │ │ │ │ 5407 y Ff(j)g(\000)g(j)p Fl(A)1021 5419 y Fj(2)p Fi(;)p │ │ │ │ │ Fj(1)1112 5407 y Ff(j)g(\000)g(j)p Fl(A)1321 5419 y Fj(1)p │ │ │ │ │ Fi(;)p Fj(2)1412 5407 y Ff(j)p Fn(,)27 b(where)h Ff(j)18 │ │ │ │ │ b(\001)h(j)27 b Fn(denotes)h(the)g(n)n(um)n(b)r(er)f(of)g(nonzero)r(es) │ │ │ │ │ g(in)h(a)f(matrix.)1929 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fn(2)p 125 100 1052 4 v │ │ │ │ │ -1217 w Fm(SemiImplMtx)23 b Fd(:)37 b Fe(DRAFT)28 b Fd(F)-7 │ │ │ │ │ -b(ebruary)26 b(8,)h(2025)p 2848 100 V 0 390 a Fc(1.1)135 │ │ │ │ │ -b(Data)46 b(Structure)0 595 y Fn(The)28 b Fm(SemiImplMtx)23 │ │ │ │ │ -b Fn(structure)k(has)g(the)h(follo)n(wing)e(\014elds.)125 │ │ │ │ │ -776 y Fg(\210)42 b Fm(int)g(neqns)26 b Fn(:)36 b(n)n(um)n(b)r(er)28 │ │ │ │ │ -b(of)f(equations.)125 939 y Fg(\210)42 b Fm(int)g(type)26 │ │ │ │ │ -b Fn(:)37 b(t)n(yp)r(e)28 b(of)f(en)n(tries,)g Fm(SPOOLES)p │ │ │ │ │ -1527 939 27 4 v 29 w(REAL)f Fn(or)g Fm(SPOOLES)p 2167 │ │ │ │ │ -939 V 29 w(COMPLEX)p Fn(.)125 1101 y Fg(\210)42 b Fm(int)g │ │ │ │ │ -(symmetryflag)13 b Fn(:)33 b(t)n(yp)r(e)18 b(of)h(matrix)e(symmetry)-7 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 125 100 1070 4 v │ │ │ │ │ +1235 w Fm(SemiImplMtx)23 b Fd(:)37 b Fe(DRAFT)27 b Fd(Jan)n(uary)f(7,)h │ │ │ │ │ +(2024)p 2831 100 V 0 390 a Fc(1.1)135 b(Data)46 b(Structure)0 │ │ │ │ │ +595 y Fn(The)28 b Fm(SemiImplMtx)23 b Fn(structure)k(has)g(the)h(follo) │ │ │ │ │ +n(wing)e(\014elds.)125 776 y Fg(\210)42 b Fm(int)g(neqns)26 │ │ │ │ │ +b Fn(:)36 b(n)n(um)n(b)r(er)28 b(of)f(equations.)125 │ │ │ │ │ +939 y Fg(\210)42 b Fm(int)g(type)26 b Fn(:)37 b(t)n(yp)r(e)28 │ │ │ │ │ +b(of)f(en)n(tries,)g Fm(SPOOLES)p 1527 939 27 4 v 29 │ │ │ │ │ +w(REAL)f Fn(or)g Fm(SPOOLES)p 2167 939 V 29 w(COMPLEX)p │ │ │ │ │ +Fn(.)125 1101 y Fg(\210)42 b Fm(int)g(symmetryflag)13 │ │ │ │ │ +b Fn(:)33 b(t)n(yp)r(e)18 b(of)h(matrix)e(symmetry)-7 │ │ │ │ │ b(,)20 b Fm(SPOOLES)p 2212 1101 V 29 w(SYMMETRIC)p Fn(,)15 │ │ │ │ │ b Fm(SPOOLES)p 2983 1101 V 28 w(HERMITIAN)g Fn(or)i Fm(SPOOLES)p │ │ │ │ │ 3822 1101 V 29 w(NONSYMMETRIC)p Fn(.)125 1263 y Fg(\210)42 │ │ │ │ │ b Fm(int)g(ndomeqns)24 b Fn(:)37 b(n)n(um)n(b)r(er)28 │ │ │ │ │ b(of)f(equations)g(in)h(the)g(domains,)f(or)f(\(1,1\))i(blo)r(c)n(k.) │ │ │ │ │ 125 1425 y Fg(\210)42 b Fm(int)g(nschureqns)23 b Fn(:)37 │ │ │ │ │ b(n)n(um)n(b)r(er)28 b(of)f(equations)g(in)h(the)g(Sc)n(h)n(ur)f │ │ │ │ │ @@ -5128,17 +5122,17 @@ │ │ │ │ │ Fn(.)101 5145 y(3.)42 b Fm(int)g(SemiImplMtx_clea)o(rD)o(ata)37 │ │ │ │ │ b(\()43 b(SemiImplMtx)c(*mtx)j(\))h(;)208 5276 y Fn(This)27 │ │ │ │ │ b(metho)r(d)h(releases)e(all)h(storage)f(held)i(b)n(y)f(the)h(ob)5 │ │ │ │ │ b(ject.)208 5407 y Fe(R)l(eturn)28 b(c)l(o)l(des:)38 │ │ │ │ │ b Fm(1)27 b Fn(means)g(a)g(normal)g(return,)g Fm(-1)g │ │ │ │ │ Fn(means)g Fm(mtx)f Fn(is)i Fm(NULL)p Fn(.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 83 100 1052 4 v 1218 100 a Fm(SemiImplMtx)23 │ │ │ │ │ -b Fd(:)37 b Fe(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2809 100 V 1052 w Fn(3)101 390 y(4.)42 b Fm(int)g(SemiImplMtx_free)37 │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1070 4 v 1235 100 a Fm(SemiImplMtx)23 │ │ │ │ │ +b Fd(:)37 b Fe(DRAFT)110 b Fd(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2791 100 V 1070 w Fn(3)101 390 y(4.)42 b Fm(int)g(SemiImplMtx_free)37 │ │ │ │ │ b(\()43 b(SemiImplMtx)c(*mtx)j(\))h(;)208 518 y Fn(This)22 │ │ │ │ │ b(metho)r(d)g(releases)f(all)g(storage)g(held)h(b)n(y)g(the)g(ob)5 │ │ │ │ │ b(ject)22 b(via)g(a)f(call)h(to)g Fm(SemiImplMtx)p 2968 │ │ │ │ │ 518 27 4 v 27 w(clearData\(\))p Fn(,)d(then)j(free'd)208 │ │ │ │ │ 617 y(the)28 b(storage)d(for)i(the)h(ob)5 b(ject.)208 │ │ │ │ │ 745 y Fe(R)l(eturn)28 b(c)l(o)l(des:)38 b Fm(1)27 b Fn(means)g(a)g │ │ │ │ │ (normal)g(return,)g Fm(-1)g Fn(means)g Fm(mtx)f Fn(is)i │ │ │ │ │ @@ -5232,22 +5226,22 @@ │ │ │ │ │ Fn(ob)5 b(jects)28 b(during)h(the)h(solv)n(e.)40 b(One)29 │ │ │ │ │ b(can)g(ha)n(v)n(e)f Fm(X)g Fn(and)h Fm(B)g Fn(p)r(oin)n(t)h(to)f(the)g │ │ │ │ │ (same)g(ob)5 b(ject,)29 b(for)g(en)n(tries)208 5407 y(are)d(read)h │ │ │ │ │ (from)g Fm(B)g Fn(and)h(written)g(to)f Fm(X)p Fn(.)g(On)h(return,)f │ │ │ │ │ (the)h Fm(cpus[])d Fn(v)n(ector)h(con)n(tains)h(the)h(follo)n(wing)f │ │ │ │ │ (information.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fn(4)p 125 100 1052 4 v │ │ │ │ │ -1217 w Fm(SemiImplMtx)23 b Fd(:)37 b Fe(DRAFT)28 b Fd(F)-7 │ │ │ │ │ -b(ebruary)26 b(8,)h(2025)p 2848 100 V 369 377 a Fm(cpus[0])97 │ │ │ │ │ -b Fn(initialize)27 b(w)n(orking)f(matrices)369 477 y │ │ │ │ │ -Fm(cpus[1])97 b Fn(load)27 b(righ)n(t)f(hand)i(side)369 │ │ │ │ │ -576 y Fm(cpus[2])97 b Fn(\014rst)27 b(solv)n(e)f(with)j(domains)369 │ │ │ │ │ -676 y Fm(cpus[3])97 b Fn(compute)27 b(Sc)n(h)n(ur)g(righ)n(t)g(hand)h │ │ │ │ │ -(side)369 775 y Fm(cpus[4])97 b Fn(Sc)n(h)n(ur)27 b(solv)n(e)2099 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 125 100 1070 4 v │ │ │ │ │ +1235 w Fm(SemiImplMtx)23 b Fd(:)37 b Fe(DRAFT)27 b Fd(Jan)n(uary)f(7,)h │ │ │ │ │ +(2024)p 2831 100 V 369 377 a Fm(cpus[0])97 b Fn(initialize)27 │ │ │ │ │ +b(w)n(orking)f(matrices)369 477 y Fm(cpus[1])97 b Fn(load)27 │ │ │ │ │ +b(righ)n(t)f(hand)i(side)369 576 y Fm(cpus[2])97 b Fn(\014rst)27 │ │ │ │ │ +b(solv)n(e)f(with)j(domains)369 676 y Fm(cpus[3])97 b │ │ │ │ │ +Fn(compute)27 b(Sc)n(h)n(ur)g(righ)n(t)g(hand)h(side)369 │ │ │ │ │ +775 y Fm(cpus[4])97 b Fn(Sc)n(h)n(ur)27 b(solv)n(e)2099 │ │ │ │ │ 377 y Fm(cpus[5])97 b Fn(compute)27 b(domains')g(righ)n(t)g(hand)h │ │ │ │ │ (side)2099 477 y Fm(cpus[6])97 b Fn(second)27 b(solv)n(e)f(with)i │ │ │ │ │ (domains)2099 576 y Fm(cpus[7])97 b Fn(store)26 b(solution)2099 │ │ │ │ │ 676 y Fm(cpus[8])97 b Fn(miscellaneous)26 b(time)2099 │ │ │ │ │ 775 y Fm(cpus[9])97 b Fn(total)27 b(time)208 972 y Fe(R)l(eturn)h(c)l │ │ │ │ │ (o)l(des:)1193 1150 y Fn(1)99 b(normal)26 b(return)1165 │ │ │ │ │ 1250 y(-1)99 b Fm(mtx)26 b Fn(is)i Fm(NULL)1165 1350 │ │ │ │ │ @@ -5305,17 +5299,17 @@ │ │ │ │ │ (loaded)f(with)i(random)e(en)n(tries.)50 b(The)32 b(linear)208 │ │ │ │ │ 5240 y(system)27 b Fl(AX)j Fn(=)22 b Fl(B)32 b Fn(is)27 │ │ │ │ │ b(solv)n(ed)g(as)g(follo)n(ws.)307 5407 y Fg(\210)42 │ │ │ │ │ b Fn(First)28 b Fl(A)g Fn(is)f(factored,)g(and)g(a)h │ │ │ │ │ Fm(FrontMtx)c Fn(ob)5 b(ject)27 b(is)h(created)f(to)g(hold)h(the)g │ │ │ │ │ (factorization.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 83 100 1052 4 v 1218 100 a Fm(SemiImplMtx)23 │ │ │ │ │ -b Fd(:)37 b Fe(DRAFT)110 b Fd(F)-7 b(ebruary)27 b(8,)g(2025)p │ │ │ │ │ -2809 100 V 1052 w Fn(5)307 390 y Fg(\210)42 b Fn(The)28 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1070 4 v 1235 100 a Fm(SemiImplMtx)23 │ │ │ │ │ +b Fd(:)37 b Fe(DRAFT)110 b Fd(Jan)n(uary)26 b(7,)h(2024)p │ │ │ │ │ +2791 100 V 1070 w Fn(5)307 390 y Fg(\210)42 b Fn(The)28 │ │ │ │ │ b(system)f(is)h(solv)n(ed)e(using)h(the)h Fm(FrontMtx)d │ │ │ │ │ Fn(ob)5 b(ject.)307 523 y Fg(\210)42 b Fn(A)28 b Fm(SemiImplMtx)23 │ │ │ │ │ b Fn(matrix)k(ob)5 b(ject)28 b(is)f(constructed)g(from)h(the)g │ │ │ │ │ Fm(FrontMtx)c Fn(ob)5 b(ject)27 b(and)h Fl(A)p Fn(.)307 │ │ │ │ │ 656 y Fg(\210)42 b Fn(The)28 b(system)f(is)h(solv)n(ed)e(using)h(the)h │ │ │ │ │ Fm(SemiImplMtx)c Fn(ob)5 b(ject.)208 822 y(V)-7 b(arious)30 │ │ │ │ │ b(statistics)h(and)g(CPU)g(timings)g(are)g(written)g(to)g(the)h │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -51,15 +51,15 @@ │ │ │ │ │ │ in a semi-implicit form) can pay off — storage can be saved when the number of entries in L and U │ │ │ │ │ │ 2,1 1,2 │ │ │ │ │ │ are larger than the number of entries in A and A . The number of solve operations is reduced by │ │ │ │ │ │ 2,1 1,2 │ │ │ │ │ │ |L | + |U | − 2|D | − |A | − |A |, where | · | denotes the number of nonzeroes in a matrix. │ │ │ │ │ │ 2,1 1,2 1,1 2,1 1,2 │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 SemiImplMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 SemiImplMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ The SemiImplMtx structure has the following fields. │ │ │ │ │ │ • int neqns : number of equations. │ │ │ │ │ │ • int type : type of entries, SPOOLES REAL or SPOOLES COMPLEX. │ │ │ │ │ │ • int symmetryflag: typeofmatrixsymmetry,SPOOLES SYMMETRIC,SPOOLES HERMITIANorSPOOLES NONSYMMETRIC. │ │ │ │ │ │ • int ndomeqns : number of equations in the domains, or (1,1) block. │ │ │ │ │ │ • int nschureqns : number of equations in the Schur complement, or (2,2) block. │ │ │ │ │ │ @@ -95,15 +95,15 @@ │ │ │ │ │ │ Thismethodsetsthestructure’sfieldstodefaultvalues: neqns=0,type=SPOOLES REAL,symmetryflag │ │ │ │ │ │ =SPOOLES SYMMETRIC,ndomeqns=nschureqns=0,anddomainMtx,schurMtx,A21,A12,domRowsIV, │ │ │ │ │ │ schurRowsIV, domColumnsIV and schurColumnsIV are all set to NULL. │ │ │ │ │ │ Return codes: 1 means a normal return, -1 means mtx is NULL. │ │ │ │ │ │ 3. int SemiImplMtx_clearData ( SemiImplMtx *mtx ) ; │ │ │ │ │ │ This method releases all storage held by the object. │ │ │ │ │ │ Return codes: 1 means a normal return, -1 means mtx is NULL. │ │ │ │ │ │ - SemiImplMtx : DRAFT February 8, 2025 3 │ │ │ │ │ │ + SemiImplMtx : DRAFT January 7, 2024 3 │ │ │ │ │ │ 4. int SemiImplMtx_free ( SemiImplMtx *mtx ) ; │ │ │ │ │ │ This method releases all storage held by the object via a call to SemiImplMtx clearData(), then free’d │ │ │ │ │ │ the storage for the object. │ │ │ │ │ │ Return codes: 1 means a normal return, -1 means mtx is NULL. │ │ │ │ │ │ 1.2.2 Initialization Methods │ │ │ │ │ │ 1. int SemiImplMtx_initFromFrontMtx ( SemiImplMtx *semimtx, FrontMtx *frontmtx, │ │ │ │ │ │ InpMtx *inpmtx, IV *frontmapIV, int msglvl, FILE *msgFile) ; │ │ │ │ │ │ @@ -140,15 +140,15 @@ │ │ │ │ │ │ 1.2.3 Solve Methods │ │ │ │ │ │ 1. int SemiImplMtx_solve ( SemiImplMtx *mtx, DenseMtx *X, DenseMtx *B, │ │ │ │ │ │ SubMtxManager *mtxmanager, double cpus[], int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This methods solves a linear system (L + I)D(I + U)X = B, (UT + I)D(I + U)X = B or (UH + │ │ │ │ │ │ I)D(I + U)X = B, where X and B are DenseMtx objects. mtxmanager is an object to handle the │ │ │ │ │ │ working SubMtx objects during the solve. One can have X and B point to the same object, for entries │ │ │ │ │ │ are read from B and written to X. On return, the cpus[] vector contains the following information. │ │ │ │ │ │ - 4 SemiImplMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 SemiImplMtx : DRAFT January 7, 2024 │ │ │ │ │ │ cpus[0] initialize working matrices cpus[5] compute domains’ right hand side │ │ │ │ │ │ cpus[1] load right hand side cpus[6] second solve with domains │ │ │ │ │ │ cpus[2] first solve with domains cpus[7] store solution │ │ │ │ │ │ cpus[3] compute Schur right hand side cpus[8] miscellaneous time │ │ │ │ │ │ cpus[4] Schur solve cpus[9] total time │ │ │ │ │ │ Return codes: │ │ │ │ │ │ 1 normal return -3 B is NULL │ │ │ │ │ │ @@ -181,15 +181,15 @@ │ │ │ │ │ │ This section contains brief descriptions of the driver programs. │ │ │ │ │ │ 1. testGrid msglvl msgFile n1 n2 n3 maxzeros maxsize seed type symmetryflag │ │ │ │ │ │ sparsityflag pivotingflag tau droptol nrhs depth │ │ │ │ │ │ This driver program tests the SemiImplMtx creation and solve methods for a matrix from a regular │ │ │ │ │ │ 2-D or 3-D grid. The matrix can be real or complex and is loaded with random entries. The linear │ │ │ │ │ │ system AX =B is solved as follows. │ │ │ │ │ │ • First A is factored, and a FrontMtx object is created to hold the factorization. │ │ │ │ │ │ - SemiImplMtx : DRAFT February 8, 2025 5 │ │ │ │ │ │ + SemiImplMtx : DRAFT January 7, 2024 5 │ │ │ │ │ │ • The system is solved using the FrontMtx object. │ │ │ │ │ │ • A SemiImplMtx matrix object is constructed from the FrontMtx object and A. │ │ │ │ │ │ • The system is solved using the SemiImplMtx object. │ │ │ │ │ │ Various statistics and CPU timings are written to the message file to compare the two solution pro- │ │ │ │ │ │ cesses. Use the do grid shell script for testing. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the message │ │ │ ├── ./usr/share/doc/spooles-doc/SolveMap.ps.gz │ │ │ │ ├── SolveMap.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o SolveMap.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1439,21 +1439,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1637,88 +1636,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4348,16 +4342,16 @@ │ │ │ │ │ %%EndFont │ │ │ │ │ TeXDict begin 39158280 55380996 1000 600 600 (main.dvi) │ │ │ │ │ @start /Fa 234[71 21[{}1 90.9091 /CMSY10 rf /Fb 133[50 │ │ │ │ │ 59 2[59 62 44 44 46 1[62 56 62 93 31 2[31 62 2[51 62 │ │ │ │ │ 50 1[54 11[86 1[62 3[84 1[106 3[42 6[80 10[56 56 56 56 │ │ │ │ │ 56 56 56 2[31 46[{}32 99.6264 /CMBX12 rf /Fc 137[62 5[62 │ │ │ │ │ 62 2[62 6[62 3[62 13[62 5[62 77[{}8 119.552 /CMTT12 rf │ │ │ │ │ -/Fd 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 │ │ │ │ │ -2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf /Fe 132[52 │ │ │ │ │ +/Fd 134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 │ │ │ │ │ +1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf /Fe 132[52 │ │ │ │ │ 123[{}1 90.9091 /CMBX10 rf │ │ │ │ │ %DVIPSBitmapFont: Ff tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ @@ -4472,40 +4466,39 @@ │ │ │ │ │ b Fl(int)i(*rowidsUpper)27 b Fm({)k(v)m(ector)h(of)e(ro)m(w)h(ids)f │ │ │ │ │ (for)g(the)h(upp)s(er)d(triangle)137 5213 y Ff(\210)45 │ │ │ │ │ b Fl(int)i(*colidsUpper)27 b Fm({)k(v)m(ector)h(of)e(column)h(ids)f │ │ │ │ │ (for)g(the)g(upp)s(er)f(triangle)137 5407 y Ff(\210)45 │ │ │ │ │ b Fl(int)i(*mapUpper)28 b Fm({)j(map)f(from)g(submatrices)g(to)h │ │ │ │ │ (threads)f(or)g(pro)s(cesses)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fm(2)p 136 100 1038 4 v │ │ │ │ │ -1220 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2862 100 V 137 399 a Ff(\210)45 │ │ │ │ │ -b Fl(int)i(nblockLower)27 b Fm({)k(n)m(um)m(b)s(er)e(of)i(submatrices)f │ │ │ │ │ -(in)g(the)h(lo)m(w)m(er)g(triangle)137 588 y Ff(\210)45 │ │ │ │ │ -b Fl(int)i(*rowidsLower)27 b Fm({)k(v)m(ector)h(of)e(ro)m(w)h(ids)f │ │ │ │ │ -(for)g(the)h(lo)m(w)m(er)g(triangle)137 778 y Ff(\210)45 │ │ │ │ │ -b Fl(int)i(*colidsLower)27 b Fm({)k(v)m(ector)h(of)e(column)h(ids)f │ │ │ │ │ -(for)g(the)g(lo)m(w)m(er)i(triangle)137 967 y Ff(\210)45 │ │ │ │ │ -b Fl(int)i(*mapLower)28 b Fm({)j(map)f(from)g(submatrices)g(to)h │ │ │ │ │ -(threads)f(or)g(pro)s(cesses)h(pro)s(cesses)0 1281 y │ │ │ │ │ -Fg(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g │ │ │ │ │ -Fc(SolveMap)c Fg(metho)t(ds)0 1510 y Fm(This)g(section)j(con)m(tains)f │ │ │ │ │ -(brief)f(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h │ │ │ │ │ -(metho)s(ds)f(that)h(b)s(elong)f(to)h(the)0 1623 y Fl(SolveMap)28 │ │ │ │ │ -b Fm(ob)5 b(ject.)0 1894 y Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ -2092 y Fm(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ -(supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ -(\014elds,)h(clearing)0 2204 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ -(free'ing)h(the)g(ob)5 b(ject.)111 2444 y(1.)46 b Fl(SolveMap)g(*)h │ │ │ │ │ -(SolveMap_new)e(\()i(void)g(\))g(;)227 2596 y Fm(This)35 │ │ │ │ │ -b(metho)s(d)g(simply)g(allo)s(cates)j(storage)f(for)e(the)h │ │ │ │ │ -Fl(SolveMap)d Fm(structure)i(and)g(then)g(sets)h(the)g(default)227 │ │ │ │ │ -2708 y(\014elds)30 b(b)m(y)g(a)h(call)h(to)f Fl(SolveMap)p │ │ │ │ │ -1330 2708 29 4 v 32 w(setDefaultFields\(\))p Fm(.)111 │ │ │ │ │ -2898 y(2.)46 b Fl(void)h(SolveMap_setDefaultField)o(s)42 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 136 100 1057 4 v │ │ │ │ │ +1239 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2843 100 V 137 399 a Ff(\210)45 b Fl(int)i(nblockLower)27 │ │ │ │ │ +b Fm({)k(n)m(um)m(b)s(er)e(of)i(submatrices)f(in)g(the)h(lo)m(w)m(er)g │ │ │ │ │ +(triangle)137 588 y Ff(\210)45 b Fl(int)i(*rowidsLower)27 │ │ │ │ │ +b Fm({)k(v)m(ector)h(of)e(ro)m(w)h(ids)f(for)g(the)h(lo)m(w)m(er)g │ │ │ │ │ +(triangle)137 778 y Ff(\210)45 b Fl(int)i(*colidsLower)27 │ │ │ │ │ +b Fm({)k(v)m(ector)h(of)e(column)h(ids)f(for)g(the)g(lo)m(w)m(er)i │ │ │ │ │ +(triangle)137 967 y Ff(\210)45 b Fl(int)i(*mapLower)28 │ │ │ │ │ +b Fm({)j(map)f(from)g(submatrices)g(to)h(threads)f(or)g(pro)s(cesses)h │ │ │ │ │ +(pro)s(cesses)0 1281 y Fg(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ +b(and)f(descriptions)g(of)g Fc(SolveMap)c Fg(metho)t(ds)0 │ │ │ │ │ +1510 y Fm(This)g(section)j(con)m(tains)f(brief)f(descriptions)g │ │ │ │ │ +(including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f(that)h(b)s │ │ │ │ │ +(elong)f(to)h(the)0 1623 y Fl(SolveMap)28 b Fm(ob)5 b(ject.)0 │ │ │ │ │ +1894 y Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 2092 y │ │ │ │ │ +Fm(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g(supp)s │ │ │ │ │ +(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f(\014elds,)h │ │ │ │ │ +(clearing)0 2204 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h │ │ │ │ │ +(the)g(ob)5 b(ject.)111 2444 y(1.)46 b Fl(SolveMap)g(*)h(SolveMap_new)e │ │ │ │ │ +(\()i(void)g(\))g(;)227 2596 y Fm(This)35 b(metho)s(d)g(simply)g(allo)s │ │ │ │ │ +(cates)j(storage)f(for)e(the)h Fl(SolveMap)d Fm(structure)i(and)g(then) │ │ │ │ │ +g(sets)h(the)g(default)227 2708 y(\014elds)30 b(b)m(y)g(a)h(call)h(to)f │ │ │ │ │ +Fl(SolveMap)p 1330 2708 29 4 v 32 w(setDefaultFields\(\))p │ │ │ │ │ +Fm(.)111 2898 y(2.)46 b Fl(void)h(SolveMap_setDefaultField)o(s)42 │ │ │ │ │ b(\()47 b(SolveMap)f(*solvemap)f(\))j(;)227 3049 y Fm(This)36 │ │ │ │ │ b(metho)s(d)h(sets)g(the)g(default)h(\014elds)e(of)h(the)g(ob)5 │ │ │ │ │ b(ject)38 b(|)f Fl(symmetryflag)44 b(=)k(SPOOLES)p 3419 │ │ │ │ │ 3049 V 32 w(SYMMETRIC)p Fm(,)227 3162 y Fl(nfront)p Fm(,)35 │ │ │ │ │ b Fl(nproc)p Fm(,)g Fl(nblockUpper)e Fm(and)h Fl(nblockLower)e │ │ │ │ │ Fm(are)k(set)g(to)g(zero,)h(and)e Fl(owners)p Fm(,)g │ │ │ │ │ Fl(rowidsUpper)p Fm(,)227 3275 y Fl(colidsUpper)p Fm(,)28 │ │ │ │ │ @@ -4535,17 +4528,17 @@ │ │ │ │ │ b(SolveMap)d(*solvemap)g(\))j(;)227 5256 y Fm(This)30 │ │ │ │ │ b(metho)s(d)g(returns)f Fl(symmetryflag)p Fm(,)e(the)k(symmetry)f │ │ │ │ │ (\015ag.)227 5407 y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fm(If)30 b Fl(solvemap)e Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f │ │ │ │ │ (message)h(is)g(prin)m(ted)e(and)h(the)h(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1038 4 v 1220 100 a Fl(SolveMap)28 │ │ │ │ │ -b Fd(:)41 b Fk(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2815 100 V 1038 w Fm(3)111 399 y(2.)46 b Fl(int)h(SolveMap_nfront)d(\() │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1057 4 v 1239 100 a Fl(SolveMap)28 │ │ │ │ │ +b Fd(:)41 b Fk(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2796 100 V 1057 w Fm(3)111 399 y(2.)46 b Fl(int)h(SolveMap_nfront)d(\() │ │ │ │ │ j(SolveMap)f(*solvemap)f(\))j(;)227 552 y Fm(This)30 │ │ │ │ │ b(metho)s(d)g(returns)f Fl(nfront)p Fm(,)g(the)h(n)m(um)m(b)s(er)f(of)i │ │ │ │ │ (fron)m(ts.)227 706 y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fm(If)30 b Fl(solvemap)e Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f │ │ │ │ │ (message)h(is)g(prin)m(ted)e(and)h(the)h(program)f(exits.)111 │ │ │ │ │ 901 y(3.)46 b Fl(int)h(SolveMap_nproc)d(\()k(SolveMap)d(*solvemap)g(\)) │ │ │ │ │ j(;)227 1055 y Fm(This)30 b(metho)s(d)g(returns)f Fl(nproc)p │ │ │ │ │ @@ -4601,53 +4594,52 @@ │ │ │ │ │ Fl(rowidsLower)p Fm(,)g(a)i(p)s(oin)m(ter)g(to)h(the)f(v)m(ector)h(of)f │ │ │ │ │ (ro)m(w)g(ids)f(of)h(the)h(submatrices)e(in)227 5253 │ │ │ │ │ y(the)e(lo)m(w)m(er)g(triangle.)227 5407 y Fk(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fm(If)30 b Fl(solvemap)e │ │ │ │ │ Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f(message)h(is)g(prin)m(ted)e(and)h │ │ │ │ │ (the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fm(4)p 136 100 1038 4 v │ │ │ │ │ -1220 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2862 100 V 66 399 a Fm(11.)46 │ │ │ │ │ -b Fl(int)h(*)h(SolveMap_colidsLower)42 b(\()47 b(SolveMap)f(*solvemap)f │ │ │ │ │ -(\))j(;)227 567 y Fm(This)31 b(metho)s(d)g(returns)f │ │ │ │ │ -Fl(colidsLower)p Fm(,)f(a)j(p)s(oin)m(ter)f(to)h(the)g(v)m(ector)h(of)f │ │ │ │ │ -(column)f(ids)g(of)g(the)h(submatrices)227 680 y(in)e(the)h(upp)s(er)d │ │ │ │ │ -(triangle.)227 848 y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ -b Fm(If)30 b Fl(solvemap)e Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f │ │ │ │ │ -(message)h(is)g(prin)m(ted)e(and)h(the)h(program)f(exits.)66 │ │ │ │ │ -1072 y(12.)46 b Fl(int)h(*)h(SolveMap_mapLower)43 b(\()k(SolveMap)f │ │ │ │ │ -(*solvemap)f(\))i(;)227 1241 y Fm(This)39 b(metho)s(d)g(returns)f │ │ │ │ │ -Fl(mapLower)p Fm(,)h(a)h(p)s(oin)m(ter)f(to)i(the)e(v)m(ector)i(that)f │ │ │ │ │ -(maps)f(the)g(submatrices)h(in)f(the)227 1354 y(upp)s(er)29 │ │ │ │ │ -b(triangle)i(to)g(threads)f(or)h(pro)s(cesses.)227 1522 │ │ │ │ │ -y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fm(If)30 b │ │ │ │ │ -Fl(solvemap)e Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f(message)h(is)g │ │ │ │ │ -(prin)m(ted)e(and)h(the)h(program)f(exits.)0 1843 y Fb(1.2.3)112 │ │ │ │ │ -b(Initialization)39 b(metho)s(d)111 2057 y Fm(1.)46 b │ │ │ │ │ -Fl(void)h(SolveMap_init)d(\()k(SolveMap)d(*solvemap,)g(int)i │ │ │ │ │ -(symmetryflag,)d(int)j(nfront,)1230 2170 y(int)f(nproc,)h(int)f │ │ │ │ │ -(nblockUpper,)f(nblockLower)g(\))i(;)227 2338 y Fm(An)m(y)33 │ │ │ │ │ -b(previously)f(o)m(wned)g(data)h(is)f(cleared)i(via)f(a)f(call)i(to)f │ │ │ │ │ -Fl(SolveMap)p 2656 2338 29 4 v 32 w(clearData\(\))p Fm(.)44 │ │ │ │ │ -b(The)31 b(\014v)m(e)i(scalars)227 2451 y(are)e(then)f(set)h(and)f(the) │ │ │ │ │ -g(v)m(ectors)i(are)f(allo)s(cated)h(and)e(initialized.)227 │ │ │ │ │ -2620 y Fk(Err)-5 b(or)38 b(che)-5 b(cking:)48 b Fm(If)34 │ │ │ │ │ -b Fl(solvemap)f Fm(is)h Fl(NULL)p Fm(,)g(or)g Fl(symmetryflag)d │ │ │ │ │ -Fm(is)k(in)m(v)-5 b(alid,)36 b(or)f Fl(nfront)p Fm(,)f │ │ │ │ │ -Fl(nblockUpper)p Fm(,)227 2733 y Fl(nblockLower)28 b │ │ │ │ │ -Fm(or)i Fl(nproc)f Fm(is)h(negativ)m(e,)j(an)d(error)g(message)i(is)e │ │ │ │ │ -(prin)m(ted)g(and)g(the)h(program)f(exits.)0 3053 y Fb(1.2.4)112 │ │ │ │ │ -b(Map)39 b(creation)e(metho)s(ds)111 3267 y Fm(1.)46 │ │ │ │ │ -b Fl(void)h(SolveMap_randomMap)c(\()k(SolveMap)f(*solvemap,)f(int)i │ │ │ │ │ -(symmetryflag,)1468 3380 y(IVL)g(*upperBlockIVL,)d(IVL)j │ │ │ │ │ -(*lowerBlockIVL,)c(int)k(nproc,)1468 3493 y(IV)g(*ownersIV,)e(int)i │ │ │ │ │ -(seed,)g(int)g(msglvl,)e(FILE)i(*msgFile\))e(;)227 3661 │ │ │ │ │ -y Fm(This)30 b(metho)s(d)g(maps)g(o\013diagonal)i(submatrices)e(to)h │ │ │ │ │ -(threads)f(or)g(pro)s(cesses)h(in)f(a)g(random)g(fashion.)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 136 100 1057 4 v │ │ │ │ │ +1239 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2843 100 V 66 399 a Fm(11.)46 b Fl(int)h(*)h │ │ │ │ │ +(SolveMap_colidsLower)42 b(\()47 b(SolveMap)f(*solvemap)f(\))j(;)227 │ │ │ │ │ +567 y Fm(This)31 b(metho)s(d)g(returns)f Fl(colidsLower)p │ │ │ │ │ +Fm(,)f(a)j(p)s(oin)m(ter)f(to)h(the)g(v)m(ector)h(of)f(column)f(ids)g │ │ │ │ │ +(of)g(the)h(submatrices)227 680 y(in)e(the)h(upp)s(er)d(triangle.)227 │ │ │ │ │ +848 y Fk(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fm(If)30 │ │ │ │ │ +b Fl(solvemap)e Fm(is)j Fl(NULL)p Fm(,)e(an)i(error)f(message)h(is)g │ │ │ │ │ +(prin)m(ted)e(and)h(the)h(program)f(exits.)66 1072 y(12.)46 │ │ │ │ │ +b Fl(int)h(*)h(SolveMap_mapLower)43 b(\()k(SolveMap)f(*solvemap)f(\))i │ │ │ │ │ +(;)227 1241 y Fm(This)39 b(metho)s(d)g(returns)f Fl(mapLower)p │ │ │ │ │ +Fm(,)h(a)h(p)s(oin)m(ter)f(to)i(the)e(v)m(ector)i(that)f(maps)f(the)g │ │ │ │ │ +(submatrices)h(in)f(the)227 1354 y(upp)s(er)29 b(triangle)i(to)g │ │ │ │ │ +(threads)f(or)h(pro)s(cesses.)227 1522 y Fk(Err)-5 b(or)34 │ │ │ │ │ +b(che)-5 b(cking:)40 b Fm(If)30 b Fl(solvemap)e Fm(is)j │ │ │ │ │ +Fl(NULL)p Fm(,)e(an)i(error)f(message)h(is)g(prin)m(ted)e(and)h(the)h │ │ │ │ │ +(program)f(exits.)0 1843 y Fb(1.2.3)112 b(Initialization)39 │ │ │ │ │ +b(metho)s(d)111 2057 y Fm(1.)46 b Fl(void)h(SolveMap_init)d(\()k │ │ │ │ │ +(SolveMap)d(*solvemap,)g(int)i(symmetryflag,)d(int)j(nfront,)1230 │ │ │ │ │ +2170 y(int)f(nproc,)h(int)f(nblockUpper,)f(nblockLower)g(\))i(;)227 │ │ │ │ │ +2338 y Fm(An)m(y)33 b(previously)f(o)m(wned)g(data)h(is)f(cleared)i │ │ │ │ │ +(via)f(a)f(call)i(to)f Fl(SolveMap)p 2656 2338 29 4 v │ │ │ │ │ +32 w(clearData\(\))p Fm(.)44 b(The)31 b(\014v)m(e)i(scalars)227 │ │ │ │ │ +2451 y(are)e(then)f(set)h(and)f(the)g(v)m(ectors)i(are)f(allo)s(cated)h │ │ │ │ │ +(and)e(initialized.)227 2620 y Fk(Err)-5 b(or)38 b(che)-5 │ │ │ │ │ +b(cking:)48 b Fm(If)34 b Fl(solvemap)f Fm(is)h Fl(NULL)p │ │ │ │ │ +Fm(,)g(or)g Fl(symmetryflag)d Fm(is)k(in)m(v)-5 b(alid,)36 │ │ │ │ │ +b(or)f Fl(nfront)p Fm(,)f Fl(nblockUpper)p Fm(,)227 2733 │ │ │ │ │ +y Fl(nblockLower)28 b Fm(or)i Fl(nproc)f Fm(is)h(negativ)m(e,)j(an)d │ │ │ │ │ +(error)g(message)i(is)e(prin)m(ted)g(and)g(the)h(program)f(exits.)0 │ │ │ │ │ +3053 y Fb(1.2.4)112 b(Map)39 b(creation)e(metho)s(ds)111 │ │ │ │ │ +3267 y Fm(1.)46 b Fl(void)h(SolveMap_randomMap)c(\()k(SolveMap)f │ │ │ │ │ +(*solvemap,)f(int)i(symmetryflag,)1468 3380 y(IVL)g(*upperBlockIVL,)d │ │ │ │ │ +(IVL)j(*lowerBlockIVL,)c(int)k(nproc,)1468 3493 y(IV)g(*ownersIV,)e │ │ │ │ │ +(int)i(seed,)g(int)g(msglvl,)e(FILE)i(*msgFile\))e(;)227 │ │ │ │ │ +3661 y Fm(This)30 b(metho)s(d)g(maps)g(o\013diagonal)i(submatrices)e │ │ │ │ │ +(to)h(threads)f(or)g(pro)s(cesses)h(in)f(a)g(random)g(fashion.)227 │ │ │ │ │ 3830 y Fk(Err)-5 b(or)43 b(che)-5 b(cking:)59 b Fm(If)39 │ │ │ │ │ b Fl(solvemap)p Fm(,)i Fl(upperBlockIVL)36 b Fm(or)k │ │ │ │ │ Fl(ownersIV)d Fm(is)j Fl(NULL)p Fm(,)f(or)h(if)f Fl(symmetryflag)e │ │ │ │ │ Fm(is)227 3943 y(in)m(v)-5 b(alid,)31 b(an)g(error)f(message)h(is)g │ │ │ │ │ (prin)m(ted)f(and)f(the)i(program)f(exits.)111 4167 y(2.)46 │ │ │ │ │ b Fl(void)h(SolveMap_ddMap)d(\()j(SolveMap)f(*solvemap,)f(int)i │ │ │ │ │ (symmetryflag,)1277 4280 y(IVL)g(*upperBlockIVL,)d(IVL)j │ │ │ │ │ @@ -4670,17 +4662,17 @@ │ │ │ │ │ (fashion.)227 5294 y Fk(Err)-5 b(or)43 b(che)-5 b(cking:)59 │ │ │ │ │ b Fm(If)39 b Fl(solvemap)p Fm(,)i Fl(upperBlockIVL)36 │ │ │ │ │ b Fm(or)k Fl(ownersIV)d Fm(is)j Fl(NULL)p Fm(,)f(or)h(if)f │ │ │ │ │ Fl(symmetryflag)e Fm(is)227 5407 y(in)m(v)-5 b(alid,)31 │ │ │ │ │ b(an)g(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1038 4 v 1220 100 a Fl(SolveMap)28 │ │ │ │ │ -b Fd(:)41 b Fk(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2815 100 V 1038 w Fm(5)0 399 y Fb(1.2.5)112 b(Solv)m(e)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1057 4 v 1239 100 a Fl(SolveMap)28 │ │ │ │ │ +b Fd(:)41 b Fk(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2796 100 V 1057 w Fm(5)0 399 y Fb(1.2.5)112 b(Solv)m(e)38 │ │ │ │ │ b(setup)g(metho)s(ds)111 591 y Fm(1.)46 b Fl(IP)h(**)h │ │ │ │ │ (SolveMap_forwardSetup)42 b(\()47 b(SolveMap)f(*solvemap,)f(int)i │ │ │ │ │ (myid,)1659 704 y(int)g(msglvl,)f(FILE)g(*msgFile)g(\))h(;)227 │ │ │ │ │ 817 y(IP)g(**)h(SolveMap_backwardSetup)41 b(\()48 b(SolveMap)d │ │ │ │ │ (*solvemap,)g(int)i(myid,)1659 930 y(int)g(msglvl,)f(FILE)g(*msgFile)g │ │ │ │ │ (\))h(;)227 1076 y Fm(These)21 b(t)m(w)m(o)g(metho)s(ds)f(return)g(a)h │ │ │ │ │ (v)m(ector)h(of)f(p)s(oin)m(ters)f(to)h Fl(IP)f Fm(ob)5 │ │ │ │ │ @@ -4748,29 +4740,29 @@ │ │ │ │ │ b(ject)35 b(that)f(con)m(tains)h(the)f(aggregate)i(coun)m(t)f(for)e(a)h │ │ │ │ │ (forw)m(ard)f(solv)m(e.)52 b(If)227 5407 y Fl(myid)32 │ │ │ │ │ b Fm(o)m(wns)g(fron)m(t)h Fl(J)p Fm(,)g(then)f(en)m(try)h │ │ │ │ │ Fl(J)f Fm(of)h(the)g(returned)f Fl(IV)g Fm(ob)5 b(ject)33 │ │ │ │ │ b(con)m(tains)h(the)f(n)m(um)m(b)s(er)e(of)i(pro)s(cesses)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fm(6)p 136 100 1038 4 v │ │ │ │ │ -1220 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2862 100 V 227 399 a Fm(\(other)d(than)e │ │ │ │ │ -Fl(myid)p Fm(\))g(that)i(o)m(wn)f(an)f Fj(L)1522 413 │ │ │ │ │ -y Fi(J)p Fh(;)p Fi(I)1643 399 y Fm(submatrix,)h(\(or)h │ │ │ │ │ -Fj(U)2304 413 y Fi(I)p Fh(;)p Fi(J)2425 399 y Fm(submatrix)e(if)h │ │ │ │ │ -(symmetric)g(or)g(hermitian\))227 511 y(and)j(so)h(is)f(the)h(n)m(um)m │ │ │ │ │ -(b)s(er)e(of)h(incoming)h(aggregate)i(submatrices)e(pro)s(cess)f │ │ │ │ │ -Fl(myid)f Fm(exp)s(ects)i(for)f(fron)m(t)g Fl(J)p Fm(.)227 │ │ │ │ │ -665 y Fk(Err)-5 b(or)35 b(che)-5 b(cking:)43 b Fm(If)31 │ │ │ │ │ -b Fl(solvemap)f Fm(is)i Fl(NULL)e Fm(or)i Fl(nlist)46 │ │ │ │ │ -b(<)h(0)32 b Fm(then)f(an)h(error)f(message)i(is)e(prin)m(ted)h(and)f │ │ │ │ │ -(the)227 778 y(program)f(exits.)0 1058 y Fb(1.2.7)112 │ │ │ │ │ -b(IO)38 b(metho)s(ds)0 1258 y Fm(There)20 b(are)g(the)h(usual)f(eigh)m │ │ │ │ │ -(t)h(IO)f(routines.)37 b(The)20 b(\014le)g(structure)g(of)h(a)f │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fm(6)p 136 100 1057 4 v │ │ │ │ │ +1239 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2843 100 V 227 399 a Fm(\(other)d(than)e Fl(myid)p │ │ │ │ │ +Fm(\))g(that)i(o)m(wn)f(an)f Fj(L)1522 413 y Fi(J)p Fh(;)p │ │ │ │ │ +Fi(I)1643 399 y Fm(submatrix,)h(\(or)h Fj(U)2304 413 │ │ │ │ │ +y Fi(I)p Fh(;)p Fi(J)2425 399 y Fm(submatrix)e(if)h(symmetric)g(or)g │ │ │ │ │ +(hermitian\))227 511 y(and)j(so)h(is)f(the)h(n)m(um)m(b)s(er)e(of)h │ │ │ │ │ +(incoming)h(aggregate)i(submatrices)e(pro)s(cess)f Fl(myid)f │ │ │ │ │ +Fm(exp)s(ects)i(for)f(fron)m(t)g Fl(J)p Fm(.)227 665 │ │ │ │ │ +y Fk(Err)-5 b(or)35 b(che)-5 b(cking:)43 b Fm(If)31 b │ │ │ │ │ +Fl(solvemap)f Fm(is)i Fl(NULL)e Fm(or)i Fl(nlist)46 b(<)h(0)32 │ │ │ │ │ +b Fm(then)f(an)h(error)f(message)i(is)e(prin)m(ted)h(and)f(the)227 │ │ │ │ │ +778 y(program)f(exits.)0 1058 y Fb(1.2.7)112 b(IO)38 │ │ │ │ │ +b(metho)s(ds)0 1258 y Fm(There)20 b(are)g(the)h(usual)f(eigh)m(t)h(IO)f │ │ │ │ │ +(routines.)37 b(The)20 b(\014le)g(structure)g(of)h(a)f │ │ │ │ │ Fl(SolveMap)e Fm(ob)5 b(ject)21 b(is)g(simple:)35 b Fl(symmetryflag)p │ │ │ │ │ Fm(,)0 1371 y Fl(nfront)p Fm(,)21 b Fl(nproc)p Fm(,)g │ │ │ │ │ Fl(nblockUpper)c Fm(and)j Fl(nblockLower)p Fm(,)f(follo)m(w)m(ed)j(b)m │ │ │ │ │ (y)e Fl(owners[*])p Fm(,)g Fl(rowidsUpper[*])p Fm(,)f │ │ │ │ │ Fl(colidsUpper[*])0 1484 y Fm(and)h Fl(mapidsUpper[*])p │ │ │ │ │ Fm(,)e(and)i(if)g Fl(symmetryflag)45 b(=)i(SPOOLES)p │ │ │ │ │ 2180 1484 29 4 v 33 w(NONSYMMETRIC)p Fm(,)17 b(follo)m(w)m(ed)22 │ │ │ │ │ @@ -4837,17 +4829,17 @@ │ │ │ │ │ Fm(is)h(returned.)37 b(If)24 b(an)f(IO)g(error)g(is)h(encoun)m(tered)g │ │ │ │ │ (from)f Fl(fprintf)p Fm(,)h(zero)g(is)g(returned.)227 │ │ │ │ │ 5407 y Fk(Err)-5 b(or)33 b(che)-5 b(cking:)40 b Fm(If)28 │ │ │ │ │ b Fl(solvemap)f Fm(or)i Fl(fp)g Fm(are)g Fl(NULL)f Fm(an)h(error)g │ │ │ │ │ (message)h(is)f(prin)m(ted)f(and)h(zero)h(is)f(returned.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1038 4 v 1220 100 a Fl(SolveMap)28 │ │ │ │ │ -b Fd(:)41 b Fk(DRAFT)121 b Fd(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2815 100 V 1038 w Fm(7)111 399 y(6.)46 b Fl(int)h │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1057 4 v 1239 100 a Fl(SolveMap)28 │ │ │ │ │ +b Fd(:)41 b Fk(DRAFT)121 b Fd(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2796 100 V 1057 w Fm(7)111 399 y(6.)46 b Fl(int)h │ │ │ │ │ (SolveMap_writeToBinaryFil)o(e)42 b(\()47 b(SolveMap)f(*solvemap,)f │ │ │ │ │ (FILE)h(*fp)h(\))h(;)227 549 y Fm(This)29 b(metho)s(d)h(writes)g(an)f │ │ │ │ │ Fl(SolveMap)f Fm(ob)5 b(ject)31 b(to)f(a)h(binary)e(\014le.)40 │ │ │ │ │ b(If)30 b(there)g(are)g(no)g(errors)f(in)h(writing)g(the)227 │ │ │ │ │ 662 y(data,)i(the)e(v)-5 b(alue)31 b Fl(1)f Fm(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fl(fwrite)p Fm(,)f(zero)i(is)g(returned.)227 812 y Fk(Err)-5 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -19,15 +19,15 @@ │ │ │ │ │ │ • int nproc – number of threads or processes │ │ │ │ │ │ • int *owners – vector mapping fronts to owning threads or processes │ │ │ │ │ │ • int nblockUpper – number of submatrices in the upper triangle │ │ │ │ │ │ • int *rowidsUpper – vector of row ids for the upper triangle │ │ │ │ │ │ • int *colidsUpper – vector of column ids for the upper triangle │ │ │ │ │ │ • int *mapUpper – map from submatrices to threads or processes │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 SolveMap : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 SolveMap : DRAFT January 7, 2024 │ │ │ │ │ │ • int nblockLower – number of submatrices in the lower triangle │ │ │ │ │ │ • int *rowidsLower – vector of row ids for the lower triangle │ │ │ │ │ │ • int *colidsLower – vector of column ids for the lower triangle │ │ │ │ │ │ • int *mapLower – map from submatrices to threads or processes processes │ │ │ │ │ │ 1.2 Prototypes and descriptions of SolveMap methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ SolveMap object. │ │ │ │ │ │ @@ -50,15 +50,15 @@ │ │ │ │ │ │ This method releases any storage by a call to SolveMap clearData() then free’s the storage │ │ │ │ │ │ for the structure with a call to free(). │ │ │ │ │ │ Error checking: If solvemap is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.2 Instance methods │ │ │ │ │ │ 1. int SolveMap_symmetryflag ( SolveMap *solvemap ) ; │ │ │ │ │ │ This method returns symmetryflag, the symmetry flag. │ │ │ │ │ │ Error checking: If solvemap is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - SolveMap : DRAFT February 8, 2025 3 │ │ │ │ │ │ + SolveMap : DRAFT January 7, 2024 3 │ │ │ │ │ │ 2. int SolveMap_nfront ( SolveMap *solvemap ) ; │ │ │ │ │ │ This method returns nfront, the number of fronts. │ │ │ │ │ │ Error checking: If solvemap is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. int SolveMap_nproc ( SolveMap *solvemap ) ; │ │ │ │ │ │ This method returns nproc, the number of threads or processes. │ │ │ │ │ │ Error checking: If solvemap is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. int SolveMap_nblockUpper ( SolveMap *solvemap ) ; │ │ │ │ │ │ @@ -84,15 +84,15 @@ │ │ │ │ │ │ This method returns mapUpper, a pointer to the vector that maps the submatrices in the │ │ │ │ │ │ upper triangle to threads or processes. │ │ │ │ │ │ Error checking: If solvemap is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 10. int * SolveMap_rowidsLower ( SolveMap *solvemap ) ; │ │ │ │ │ │ This method returns rowidsLower, a pointer to the vector of row ids of the submatrices in │ │ │ │ │ │ the lower triangle. │ │ │ │ │ │ Error checking: If solvemap is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 4 SolveMap : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 SolveMap : DRAFT January 7, 2024 │ │ │ │ │ │ 11. int * SolveMap_colidsLower ( SolveMap *solvemap ) ; │ │ │ │ │ │ This method returns colidsLower, a pointer to the vector of column ids of the submatrices │ │ │ │ │ │ in the upper triangle. │ │ │ │ │ │ Error checking: If solvemap is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 12. int * SolveMap_mapLower ( SolveMap *solvemap ) ; │ │ │ │ │ │ This method returns mapLower, a pointer to the vector that maps the submatrices in the │ │ │ │ │ │ upper triangle to threads or processes. │ │ │ │ │ │ @@ -118,15 +118,15 @@ │ │ │ │ │ │ fashion. A domain is a subtree of fronts that are owned by the same thread or process. │ │ │ │ │ │ Furthermore, a domain is maximal, i.e., the parent of the root domain (if it exists) is owned │ │ │ │ │ │ by a different process. If J belongs to a domain, then for all K, LK,J and UJ,K are owned by │ │ │ │ │ │ the thread or process that owns the domain. All other submatrices are mapped to threads or │ │ │ │ │ │ processes in a random fashion. │ │ │ │ │ │ Error checking: If solvemap, upperBlockIVL or ownersIV is NULL, or if symmetryflag is │ │ │ │ │ │ invalid, an error message is printed and the program exits. │ │ │ │ │ │ - SolveMap : DRAFT February 8, 2025 5 │ │ │ │ │ │ + SolveMap : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.2.5 Solve setup methods │ │ │ │ │ │ 1. IP ** SolveMap_forwardSetup ( SolveMap *solvemap, int myid, │ │ │ │ │ │ int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ IP ** SolveMap_backwardSetup ( SolveMap *solvemap, int myid, │ │ │ │ │ │ int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ ThesetwomethodsreturnavectorofpointerstoIPobjectsthatcontainthelistofsubmatrices │ │ │ │ │ │ that thread or process myid will use during the forward or backward solves. │ │ │ │ │ │ @@ -157,15 +157,15 @@ │ │ │ │ │ │ submatrices process myid expects for front J. │ │ │ │ │ │ Error checking: If solvemap is NULL or nlist < 0 then an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 5. IV * SolveMap_lowerAggregateIV ( SolveMap *solvemap, int myid │ │ │ │ │ │ int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method returns an IV object that contains the aggregate count for a forward solve. If │ │ │ │ │ │ myid owns front J, then entry J of the returned IV object contains the number of processes │ │ │ │ │ │ - 6 SolveMap : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 SolveMap : DRAFT January 7, 2024 │ │ │ │ │ │ (other than myid) that own an L submatrix, (or U submatrix if symmetric or hermitian) │ │ │ │ │ │ J,I I,J │ │ │ │ │ │ and so is the number of incoming aggregate submatrices process myid expects for front J. │ │ │ │ │ │ Error checking: If solvemap is NULL or nlist < 0 then an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 1.2.7 IO methods │ │ │ │ │ │ TherearetheusualeightIOroutines. ThefilestructureofaSolveMapobjectissimple: symmetryflag, │ │ │ │ │ │ @@ -194,15 +194,15 @@ │ │ │ │ │ │ Error checking: If solvemap or fn are NULL, or if fn is not of the form *.solvemapf (for a │ │ │ │ │ │ formatted file) or *.solvemapb (for a binary file), an error message is printed and the method │ │ │ │ │ │ returns zero. │ │ │ │ │ │ 5. int SolveMap_writeToFormattedFile ( SolveMap *solvemap, FILE *fp ) ; │ │ │ │ │ │ This method writes an SolveMap object to a formatted file. If there are no errors in writing │ │ │ │ │ │ the data, the value 1 is returned. If an IO error is encountered from fprintf, zero is returned. │ │ │ │ │ │ Error checking: If solvemap or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ - SolveMap : DRAFT February 8, 2025 7 │ │ │ │ │ │ + SolveMap : DRAFT January 7, 2024 7 │ │ │ │ │ │ 6. int SolveMap_writeToBinaryFile ( SolveMap *solvemap, FILE *fp ) ; │ │ │ │ │ │ This method writes an SolveMap object to a binary file. If there are no errors in writing the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fwrite, zero is returned. │ │ │ │ │ │ Error checking: If solvemap or fp are NULL an error message is printed and zero is returned. │ │ │ │ │ │ 7. int SolveMap_writeForHumanEye ( SolveMap *solvemap, FILE *fp ) ; │ │ │ │ │ │ This method writes an SolveMap object to a file in an easily readable format. The method │ │ │ │ │ │ SolveMap writeStats() is called to write out the header and statistics. The value 1 is │ │ │ ├── ./usr/share/doc/spooles-doc/SubMtx.ps.gz │ │ │ │ ├── SubMtx.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o SubMtx.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2119,21 +2119,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2317,88 +2316,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5243,18 +5237,17 @@ │ │ │ │ │ 86 1[62 3[84 5[42 6[80 10[56 56 56 56 56 56 56 2[31 46[{}31 │ │ │ │ │ 99.6264 /CMBX12 rf /Fd 135[62 2[62 62 4[62 4[62 4[62 │ │ │ │ │ 1[62 62 14[62 5[62 77[{}10 119.552 /CMTT12 rf /Fe 134[71 │ │ │ │ │ 2[71 75 52 53 55 1[75 67 75 112 3[37 75 67 41 61 75 60 │ │ │ │ │ 1[65 13[75 2[92 11[103 16[67 67 67 2[37 46[{}25 119.552 │ │ │ │ │ /CMBX12 rf /Ff 138[49 30 37 38 1[46 46 51 1[23 42 1[28 │ │ │ │ │ 46 42 1[42 46 42 1[46 12[65 1[66 11[59 62 69 2[68 6[28 │ │ │ │ │ -58[{}23 90.9091 /CMTI10 rf /Fg 134[48 3[51 2[36 12[40 │ │ │ │ │ -2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 │ │ │ │ │ -90.9091 /CMSL10 rf /Fh 132[52 123[{}1 90.9091 /CMBX10 │ │ │ │ │ -rf │ │ │ │ │ +58[{}23 90.9091 /CMTI10 rf /Fg 134[48 3[51 2[36 3[51 │ │ │ │ │ +12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 │ │ │ │ │ +/CMSL10 rf /Fh 132[52 123[{}1 90.9091 /CMBX10 rf │ │ │ │ │ %DVIPSBitmapFont: Fi tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -5378,40 +5371,39 @@ │ │ │ │ │ y Fh({)45 b Fo(sparse)30 b(using)g(dense)g(sub)s(columns)330 │ │ │ │ │ 5111 y Fh({)45 b Fo(sparse)30 b(using)g(sparse)g(ro)m(ws)330 │ │ │ │ │ 5259 y Fh({)45 b Fo(sparse)30 b(using)g(sparse)g(columns)330 │ │ │ │ │ 5407 y Fh({)45 b Fo(sparse)30 b(using)g(\()p Fm(i;)15 │ │ │ │ │ b(j;)g(a)1170 5421 y Fl(i;j)1252 5407 y Fo(\))31 b(triples)1927 │ │ │ │ │ 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 330 399 a Fh({)45 │ │ │ │ │ -b Fo(a)31 b(diagonal)h(matrix)330 541 y Fh({)45 b Fo(a)c(blo)s(c)m(k)g │ │ │ │ │ -(diagonal)g(symmetric)g(matrix)f(where)g(the)g(blo)s(c)m(ks)h(are)g(1) │ │ │ │ │ -27 b Fj(\002)f Fo(1)41 b(or)f(2)28 b Fj(\002)e Fo(2,)43 │ │ │ │ │ -b(used)d(in)g(the)427 654 y(symmetric)31 b(inde\014nite)f │ │ │ │ │ -(factorization.)330 796 y Fh({)45 b Fo(a)d(blo)s(c)m(k)f(diagonal)h │ │ │ │ │ -(Hermitian)g(matrix)f(where)f(the)h(blo)s(c)m(ks)h(are)f(1)27 │ │ │ │ │ -b Fj(\002)g Fo(1)42 b(or)e(2)28 b Fj(\002)f Fo(2,)44 │ │ │ │ │ -b(used)c(in)h(the)427 909 y(hermitian)31 b(inde\014nite)f │ │ │ │ │ -(factorization.)137 1092 y Fi(\210)45 b Fo(The)30 b Fn(SubMtx)e │ │ │ │ │ -Fo(ob)5 b(ject)31 b(can)f(b)s(e)g(self-con)m(tained,)i(in)d(the)i │ │ │ │ │ -(sense)f(that)g(its)h(structure)e(con)m(tains)i(a)g Fn(DV)e │ │ │ │ │ -Fo(ob)5 b(ject)227 1205 y(that)27 b(manages)f(a)g(con)m(tiguous)h(v)m │ │ │ │ │ -(ector)h(of)e(w)m(orkspace)g(that)h(is)f(used)f(to)h(store)g(all)h │ │ │ │ │ -(information)f(ab)s(out)g(the)227 1318 y Fn(SubMtx)31 │ │ │ │ │ -b Fo(ob)5 b(ject)34 b(|)e(its)h(scalar)g(parameters,)h(an)m(y)f(in)m │ │ │ │ │ -(teger)h(index)e(or)g(dimension)g(information,)i(and)e(all)227 │ │ │ │ │ -1431 y(matrix)e(en)m(tries.)41 b(In)29 b(a)g(distributed)g(en)m │ │ │ │ │ -(vironmen)m(t,)h(this)f(allo)m(ws)i(a)f Fn(SubMtx)d Fo(ob)5 │ │ │ │ │ -b(ject)31 b(to)f(b)s(e)e(sen)m(t)i(b)s(et)m(w)m(een)227 │ │ │ │ │ -1544 y(pro)s(cessors)j(as)h(one)g(message,)i(no)d(cop)m(ying)h(to)h(an) │ │ │ │ │ -e(in)m(ternal)h(bu\013er)f(is)g(needed,)i(nor)e(an)m(y)g(custom)h(data) │ │ │ │ │ -227 1657 y(t)m(yp)s(e)e(needs)f(to)h(b)s(e)e(de\014ned)g(as)i(for)f │ │ │ │ │ -(MPI.)g(In)g(an)g(out-of-core)i(en)m(vironmen)m(t,)g(a)e │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 330 399 a Fh({)45 b Fo(a)31 b(diagonal)h(matrix)330 │ │ │ │ │ +541 y Fh({)45 b Fo(a)c(blo)s(c)m(k)g(diagonal)g(symmetric)g(matrix)f │ │ │ │ │ +(where)g(the)g(blo)s(c)m(ks)h(are)g(1)27 b Fj(\002)f │ │ │ │ │ +Fo(1)41 b(or)f(2)28 b Fj(\002)e Fo(2,)43 b(used)d(in)g(the)427 │ │ │ │ │ +654 y(symmetric)31 b(inde\014nite)f(factorization.)330 │ │ │ │ │ +796 y Fh({)45 b Fo(a)d(blo)s(c)m(k)f(diagonal)h(Hermitian)g(matrix)f │ │ │ │ │ +(where)f(the)h(blo)s(c)m(ks)h(are)f(1)27 b Fj(\002)g │ │ │ │ │ +Fo(1)42 b(or)e(2)28 b Fj(\002)f Fo(2,)44 b(used)c(in)h(the)427 │ │ │ │ │ +909 y(hermitian)31 b(inde\014nite)f(factorization.)137 │ │ │ │ │ +1092 y Fi(\210)45 b Fo(The)30 b Fn(SubMtx)e Fo(ob)5 b(ject)31 │ │ │ │ │ +b(can)f(b)s(e)g(self-con)m(tained,)i(in)d(the)i(sense)f(that)g(its)h │ │ │ │ │ +(structure)e(con)m(tains)i(a)g Fn(DV)e Fo(ob)5 b(ject)227 │ │ │ │ │ +1205 y(that)27 b(manages)f(a)g(con)m(tiguous)h(v)m(ector)h(of)e(w)m │ │ │ │ │ +(orkspace)g(that)h(is)f(used)f(to)h(store)g(all)h(information)f(ab)s │ │ │ │ │ +(out)g(the)227 1318 y Fn(SubMtx)31 b Fo(ob)5 b(ject)34 │ │ │ │ │ +b(|)e(its)h(scalar)g(parameters,)h(an)m(y)f(in)m(teger)h(index)e(or)g │ │ │ │ │ +(dimension)g(information,)i(and)e(all)227 1431 y(matrix)e(en)m(tries.) │ │ │ │ │ +41 b(In)29 b(a)g(distributed)g(en)m(vironmen)m(t,)h(this)f(allo)m(ws)i │ │ │ │ │ +(a)f Fn(SubMtx)d Fo(ob)5 b(ject)31 b(to)f(b)s(e)e(sen)m(t)i(b)s(et)m(w) │ │ │ │ │ +m(een)227 1544 y(pro)s(cessors)j(as)h(one)g(message,)i(no)d(cop)m(ying) │ │ │ │ │ +h(to)h(an)e(in)m(ternal)h(bu\013er)f(is)g(needed,)i(nor)e(an)m(y)g │ │ │ │ │ +(custom)h(data)227 1657 y(t)m(yp)s(e)e(needs)f(to)h(b)s(e)e(de\014ned)g │ │ │ │ │ +(as)i(for)f(MPI.)g(In)g(an)g(out-of-core)i(en)m(vironmen)m(t,)g(a)e │ │ │ │ │ Fn(SubMtx)f Fo(ob)5 b(ject)32 b(can)g(b)s(e)227 1770 │ │ │ │ │ y(read)f(from)e(or)i(written)f(to)h(a)g(\014le)g(b)m(y)f(a)h(single)g │ │ │ │ │ (op)s(eration.)141 1970 y(The)k Fn(SubMtx)e Fo(ob)5 b(ject)35 │ │ │ │ │ b(is)g(a)h(sup)s(erset)d(of)i(the)h Fn(DenseMtx)c Fo(ob)5 │ │ │ │ │ b(ject)36 b(in)e(terms)h(of)g(data)h(structure)e(and)h(func-)0 │ │ │ │ │ 2083 y(tionalit)m(y)-8 b(.)42 b(If)27 b(w)m(e)g(w)m(ere)g(w)m(orking)g │ │ │ │ │ (in)g(a)g(language)h(that)f(supp)s(orts)e(inheritance,)k │ │ │ │ │ @@ -5460,17 +5452,17 @@ │ │ │ │ │ b(Data)46 b(Structure)0 5023 y Fo(The)30 b Fn(SubMtx)f │ │ │ │ │ Fo(structure)g(has)i(the)f(follo)m(wing)i(\014elds.)137 │ │ │ │ │ 5224 y Fi(\210)45 b Fn(int)i(type)29 b Fo(:)41 b(t)m(yp)s(e)31 │ │ │ │ │ b(of)f(en)m(tries.)330 5407 y Fh({)45 b Fn(SPOOLES)p │ │ │ │ │ 769 5407 29 4 v 33 w(REAL)29 b Fo(:)h(double)g(precision)h(real)g(en)m │ │ │ │ │ (tries.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1086 4 v 1267 100 a Fn(SubMtx)29 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2767 100 V 1086 w Fo(3)330 399 y Fh({)45 b Fn(SPOOLES)p │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1105 4 v 1287 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2748 100 V 1105 w Fo(3)330 399 y Fh({)45 b Fn(SPOOLES)p │ │ │ │ │ 769 399 29 4 v 33 w(COMPLEX)28 b Fo(:)j(double)f(precision)g(complex)h │ │ │ │ │ (en)m(tries.)137 590 y Fi(\210)45 b Fn(int)i(mode)29 │ │ │ │ │ b Fo(:)41 b(storage)32 b(mo)s(de.)330 781 y Fh({)45 b │ │ │ │ │ Fn(SUBMTX)p 721 781 V 33 w(DENSE)p 994 781 V 33 w(ROWS)29 │ │ │ │ │ b Fo(:)i(dense,)f(storage)i(b)m(y)e(ro)m(ws.)330 929 │ │ │ │ │ y Fh({)45 b Fn(SUBMTX)p 721 929 V 33 w(DENSE)p 994 929 │ │ │ │ │ V 33 w(COLUMNS)28 b Fo(:)j(dense,)f(storage)i(b)m(y)e(columns.)330 │ │ │ │ │ @@ -5532,19 +5524,19 @@ │ │ │ │ │ g(storage)h(format,)f(and)f Fn(0)g Fo(other-)227 5103 │ │ │ │ │ y(wise.)137 5294 y Fi(\210)45 b Fn(SUBMTX)p 521 5294 │ │ │ │ │ V 33 w(IS)p 650 5294 V 34 w(SPARSE)p 972 5294 V 33 w(COLUMNS\(mtx\))25 │ │ │ │ │ b Fo(is)30 b Fn(1)e Fo(if)h Fn(mtx)g Fo(has)g(sparse)f(columns)h(as)h │ │ │ │ │ (its)f(storage)i(format,)f(and)e Fn(0)227 5407 y Fo(otherwise.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 137 399 a Fi(\210)45 │ │ │ │ │ -b Fn(SUBMTX)p 521 399 29 4 v 33 w(IS)p 650 399 V 34 w(SPARSE)p │ │ │ │ │ -972 399 V 33 w(TRIPLES\(mtx\))24 b Fo(is)k Fn(1)g Fo(if)g │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 137 399 a Fi(\210)45 b Fn(SUBMTX)p │ │ │ │ │ +521 399 29 4 v 33 w(IS)p 650 399 V 34 w(SPARSE)p 972 │ │ │ │ │ +399 V 33 w(TRIPLES\(mtx\))24 b Fo(is)k Fn(1)g Fo(if)g │ │ │ │ │ Fn(mtx)f Fo(has)g(sparse)h(triples)g(as)g(its)g(storage)i(format,)f │ │ │ │ │ Fn(0)e Fo(other-)227 511 y(wise.)137 691 y Fi(\210)45 │ │ │ │ │ b Fn(SUBMTX)p 521 691 V 33 w(IS)p 650 691 V 34 w(DENSE)p │ │ │ │ │ 924 691 V 33 w(SUBROWS\(mtx\))25 b Fo(is)j Fn(1)g Fo(if)g │ │ │ │ │ Fn(mtx)g Fo(has)g(dense)g(subro)m(ws)f(as)i(its)f(storage)i(format,)f │ │ │ │ │ Fn(0)f Fo(other-)227 804 y(wise.)137 984 y Fi(\210)45 │ │ │ │ │ b Fn(SUBMTX)p 521 984 V 33 w(IS)p 650 984 V 34 w(DENSE)p │ │ │ │ │ @@ -5606,17 +5598,17 @@ │ │ │ │ │ (a)h(call)g(to)h Fn(SubMtx)p 2355 5148 V 32 w(clearData\(\))c │ │ │ │ │ Fo(and)h(then)h(frees)h(the)f(space)227 5261 y(for)g │ │ │ │ │ Fn(mtx)p Fo(.)227 5407 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fo(If)30 b Fn(mtx)g Fo(is)g Fn(NULL)p Fo(,)g(an)g(error)g(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)g(the)g(program)g(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1086 4 v 1267 100 a Fn(SubMtx)29 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2767 100 V 1086 w Fo(5)0 399 y Fc(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1105 4 v 1287 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2748 100 V 1105 w Fo(5)0 399 y Fc(1.2.2)112 b(Instance)38 │ │ │ │ │ b(metho)s(ds)111 597 y Fo(1.)46 b Fn(void)h(SubMtx_ids)e(\()i(SubMtx)f │ │ │ │ │ (*mtx,)h(int)g(*prowid,)e(int)i(*pcolid)f(\))h(;)227 │ │ │ │ │ 748 y Fo(This)30 b(metho)s(d)g(\014lls)g Fn(*prowid)e │ │ │ │ │ Fo(with)i(the)h(ro)m(w)f(id)g(and)g Fn(*pcolid)f Fo(with)h(the)g │ │ │ │ │ (column)g(id)g(of)h(the)g(ob)5 b(ject.)227 900 y Ff(Err)-5 │ │ │ │ │ b(or)27 b(che)-5 b(cking:)36 b Fo(If)22 b Fn(mtx)p Fo(,)h │ │ │ │ │ Fn(prowid)e Fo(or)h Fn(pcolid)f Fo(is)h Fn(NULL)p Fo(,)g(an)g(error)g │ │ │ │ │ @@ -5684,21 +5676,21 @@ │ │ │ │ │ (address)f(of)i(the)227 5294 y Fn(sizes[nrow])24 b Fo(v)m(ector)k(that) │ │ │ │ │ g(con)m(tains)g(the)f(n)m(um)m(b)s(er)e(of)i(en)m(tries)h(in)e(eac)m(h) │ │ │ │ │ i(ro)m(w,)g Fn(*indices)c Fo(with)j(the)g(base)227 5407 │ │ │ │ │ y(address)41 b(of)g(the)h Fn(indices[nent])c Fo(v)m(ector)43 │ │ │ │ │ b(that)f(con)m(tains)g(the)g(column)f(index)g(for)g(eac)m(h)h(en)m(try) │ │ │ │ │ -8 b(,)46 b(and)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 227 399 a Fn(*pentries)g │ │ │ │ │ -Fo(with)i(the)g(base)g(address)f(of)i Fn(entries[nent])29 │ │ │ │ │ -b Fo(v)m(ector.)51 b(The)32 b(indices)h(and)g(en)m(tries)h(for)f(the) │ │ │ │ │ -227 511 y(ro)m(ws)e(are)f(stored)h(con)m(tiguously)-8 │ │ │ │ │ -b(.)227 662 y Ff(Err)j(or)28 b(che)-5 b(cking:)37 b Fo(If)24 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 227 399 a Fn(*pentries)g Fo(with)i(the)g(base)g │ │ │ │ │ +(address)f(of)i Fn(entries[nent])29 b Fo(v)m(ector.)51 │ │ │ │ │ +b(The)32 b(indices)h(and)g(en)m(tries)h(for)f(the)227 │ │ │ │ │ +511 y(ro)m(ws)e(are)f(stored)h(con)m(tiguously)-8 b(.)227 │ │ │ │ │ +662 y Ff(Err)j(or)28 b(che)-5 b(cking:)37 b Fo(If)24 │ │ │ │ │ b Fn(mtx)p Fo(,)h Fn(pnrow)p Fo(,)f Fn(pnent)p Fo(,)g │ │ │ │ │ Fn(psizes)p Fo(,)g Fn(pindices)d Fo(or)j Fn(pentries)e │ │ │ │ │ Fo(is)i Fn(NULL)p Fo(,)f(or)h(if)g(the)h(matrix)227 775 │ │ │ │ │ y(t)m(yp)s(e)31 b(is)f(not)h Fn(SUBMTX)p 979 775 29 4 │ │ │ │ │ v 33 w(SPARSE)p 1300 775 V 32 w(ROWS)p Fo(,)f(an)g(error)g(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)g(the)g(program)g(exits.)111 964 │ │ │ │ │ y(8.)46 b Fn(void)h(SubMtx_sparseColumnsInfo)41 b(\()48 │ │ │ │ │ @@ -5781,17 +5773,17 @@ │ │ │ │ │ 5294 y(base)48 b(address)f(of)h(the)g Fn(firstlocs[ncol])c │ │ │ │ │ Fo(v)m(ector,)54 b Fn(*plastlocs)45 b Fo(with)i(the)h(base)g(address)f │ │ │ │ │ (of)h(the)227 5407 y Fn(lastlocs[ncol])22 b Fo(v)m(ector,)29 │ │ │ │ │ b(and)c Fn(*pentries)e Fo(with)j(the)g(base)f(address)g(of)h │ │ │ │ │ Fn(entries[nent])c Fo(v)m(ector.)41 b(F)-8 b(or)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1086 4 v 1267 100 a Fn(SubMtx)29 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2767 100 V 1086 w Fo(7)227 399 y(column)38 b Fn(jcol)p │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1105 4 v 1287 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2748 100 V 1105 w Fo(7)227 399 y(column)38 b Fn(jcol)p │ │ │ │ │ Fo(,)h(the)g(nonzero)f(en)m(tries)h(are)f(found)f(in)h(ro)m(ws)g │ │ │ │ │ Fn([firstlocs[jcol],lastlo)o(cs[j)o(col])o(])227 511 │ │ │ │ │ y Fo(when)32 b Fn(firstlocs[jcol])24 b Fj(\025)k Fo(0)33 │ │ │ │ │ b(and)f Fn(firstlocs[jcol])24 b Fj(\024)29 b Fn(lastlocs[jcol])l │ │ │ │ │ Fo(.)47 b(The)31 b(en)m(tries)j(for)e(the)227 624 y(columns)e(are)h │ │ │ │ │ (stored)g(con)m(tiguously)-8 b(.)227 787 y Ff(Err)j(or)32 │ │ │ │ │ b(che)-5 b(cking:)39 b Fo(If)28 b Fn(mtx)p Fo(,)g Fn(pnrow)p │ │ │ │ │ @@ -5866,21 +5858,21 @@ │ │ │ │ │ Fn(pReal)e Fo(or)i Fn(pImag)e Fo(is)i Fn(NULL)p Fo(,)f(or)h(if)g │ │ │ │ │ Fn(irow)e Fo(or)i Fn(jcol)f Fo(is)h(out)g(of)g(range,)h(an)e(error)227 │ │ │ │ │ 5082 y(message)g(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)66 │ │ │ │ │ 5294 y(16.)46 b Fn(void)95 b(SubMtx_locationOfRealEn)o(try)41 │ │ │ │ │ b(\()48 b(SubMtx)e(*mtx,)g(int)h(irow,)f(int)h(jcol,)1898 │ │ │ │ │ 5407 y(double)f(**ppValue)f(\))j(;)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1086 4 v │ │ │ │ │ -1268 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2814 100 V 227 399 a Fo(If)i(the)g │ │ │ │ │ -Fn(\(irow,jcol\))d Fo(en)m(try)j(is)g(presen)m(t,)h(this)f(metho)s(d)g │ │ │ │ │ -(\014lls)g Fn(*ppValue)d Fo(with)j(a)h(p)s(oin)m(ter)f(to)g(the)h(en)m │ │ │ │ │ -(try)227 511 y(in)d(ro)m(w)f Fn(irow)g Fo(and)g(column)p │ │ │ │ │ -Fn(jcol)p Fo(.)41 b(Otherwise,)30 b Fn(*ppValue)f Fo(is)h(set)i(to)f │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1105 4 v │ │ │ │ │ +1287 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2795 100 V 227 399 a Fo(If)i(the)g Fn(\(irow,jcol\))d │ │ │ │ │ +Fo(en)m(try)j(is)g(presen)m(t,)h(this)f(metho)s(d)g(\014lls)g │ │ │ │ │ +Fn(*ppValue)d Fo(with)j(a)h(p)s(oin)m(ter)f(to)g(the)h(en)m(try)227 │ │ │ │ │ +511 y(in)d(ro)m(w)f Fn(irow)g Fo(and)g(column)p Fn(jcol)p │ │ │ │ │ +Fo(.)41 b(Otherwise,)30 b Fn(*ppValue)f Fo(is)h(set)i(to)f │ │ │ │ │ Fn(NULL)p Fo(.)f(Note,)i Fn(irow)e Fo(and)g Fn(jcol)g │ │ │ │ │ Fo(are)227 624 y Ff(lo)-5 b(c)g(al)32 b Fo(indices,)f(i.e.,)h(0)26 │ │ │ │ │ b Fj(\024)f Fn(irow)f Fj(\024)h Fn(nrow)k Fo(and)h(0)25 │ │ │ │ │ b Fj(\024)g Fn(jcol)g Fj(\024)f Fn(ncol)o Fo(.)227 786 │ │ │ │ │ y Ff(Err)-5 b(or)29 b(che)-5 b(cking:)38 b Fo(If)24 b │ │ │ │ │ Fn(mtx)g Fo(or)h Fn(ppValue)e Fo(is)h Fn(NULL)p Fo(,)g(or)h(if)g │ │ │ │ │ Fn(irow)f Fo(or)g Fn(jcol)g Fo(is)h(out)g(of)g(range,)i(an)d(error)h │ │ │ │ │ @@ -5949,17 +5941,17 @@ │ │ │ │ │ Ff(Err)-5 b(or)37 b(che)-5 b(cking:)46 b Fo(If)33 b Fn(mtx)f │ │ │ │ │ Fo(is)h Fn(NULL)p Fo(,)g(or)g(if)g Fn(nrow)p Fo(,)g Fn(ncol)p │ │ │ │ │ Fo(,)g Fn(inc1)g Fo(or)g Fn(inc2)f Fo(is)h(less)h(than)f(or)g(equal)h │ │ │ │ │ (to)g(zero,)227 5407 y(or)d(if)f(neither)g Fn(inc1)g │ │ │ │ │ Fo(nor)f Fn(inc2)h Fo(are)g Fn(1)p Fo(,)h(an)f(error)g(message)h(is)g │ │ │ │ │ (prin)m(ted)f(and)f(the)i(program)f(exits.)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1086 4 v 1267 100 a Fn(SubMtx)29 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2767 100 V 1086 w Fo(9)111 399 y(4.)46 b Fn(void)h │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1105 4 v 1287 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2748 100 V 1105 w Fo(9)111 399 y(4.)46 b Fn(void)h │ │ │ │ │ (SubMtx_initRandomLowerTr)o(iang)o(le)41 b(\()48 b(SubMtx)e(*mtx,)g │ │ │ │ │ (int)h(type,)g(int)g(mode,)370 511 y(int)g(rowid,)f(int)h(colid,)f(int) │ │ │ │ │ h(nrow,)g(int)g(ncol,)f(int)h(nent,)f(int)h(seed,)g(int)f(strict)h(\))g │ │ │ │ │ (;)227 624 y(void)g(SubMtx_initRandomUpperTr)o(iang)o(le)41 │ │ │ │ │ b(\()48 b(SubMtx)e(*mtx,)g(int)h(type,)g(int)g(mode,)370 │ │ │ │ │ 737 y(int)g(rowid,)f(int)h(colid,)f(int)h(nrow,)g(int)g(ncol,)f(int)h │ │ │ │ │ (nent,)f(int)h(seed,)g(int)f(strict)h(\))g(;)227 885 │ │ │ │ │ @@ -6041,19 +6033,19 @@ │ │ │ │ │ (er)e(triangular,)j(then)f Fn(mtxA)e Fo(m)m(ust)i(ha)m(v)m(e)h(dense)f │ │ │ │ │ (sub)s(columns)d(or)j(sparse)227 5260 y(columns.)227 │ │ │ │ │ 5407 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ b Fn(mtxA)g Fo(or)g Fn(mtxB)f Fo(is)i Fn(NULL)p Fo(,)e(an)h(error)g │ │ │ │ │ (message)i(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1063 4 │ │ │ │ │ -v 1246 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2837 100 V 111 399 a Fo(2.)46 │ │ │ │ │ -b Fn(void)h(SubMtx_solveH)d(\()k(SubMtx)e(*mtxA,)g(SubMtx)g(*mtxB)g(\)) │ │ │ │ │ -i(;)227 547 y Fo(This)24 b(metho)s(d)f(is)h(used)g(to)h(solv)m(e)g(\()p │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1082 4 │ │ │ │ │ +v 1265 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2818 100 V 111 399 a Fo(2.)46 b Fn(void)h(SubMtx_solveH)d(\()k │ │ │ │ │ +(SubMtx)e(*mtxA,)g(SubMtx)g(*mtxB)g(\))i(;)227 547 y │ │ │ │ │ +Fo(This)24 b(metho)s(d)f(is)h(used)g(to)h(solv)m(e)g(\()p │ │ │ │ │ Fm(I)15 b Fo(+)8 b Fm(A)1598 514 y Fl(H)1665 547 y Fo(\))p │ │ │ │ │ Fm(X)33 b Fo(=)25 b Fm(B)5 b Fo(,)26 b(where)d Fm(A)i │ │ │ │ │ Fo(is)f(strict)h(lo)m(w)m(er)g(or)f(upp)s(er)e(triangular.)39 │ │ │ │ │ b(The)227 660 y(solution)32 b Fm(X)38 b Fo(o)m(v)m(erwrites)32 │ │ │ │ │ b Fm(B)5 b Fo(,)31 b(and)f Fn(mtxB)g Fo(m)m(ust)g(ha)m(v)m(e)i(dense)f │ │ │ │ │ (columns.)42 b(If)30 b Fm(A)h Fo(is)g(strict)g(lo)m(w)m(er)h │ │ │ │ │ (triangular,)227 773 y(then)27 b Fn(mtxA)g Fo(m)m(ust)g(ha)m(v)m(e)i │ │ │ │ │ @@ -6124,17 +6116,17 @@ │ │ │ │ │ (prin)m(ted)g(and)g(the)g(program)g(exits.)111 5146 y(2.)46 │ │ │ │ │ b Fn(int)h(SubMtx_nbytesInUse)c(\()k(SubMtx)g(*mtx)f(\))i(;)227 │ │ │ │ │ 5294 y Fo(This)36 b(metho)s(d)f(returns)g(the)i(actual)g(n)m(um)m(b)s │ │ │ │ │ (er)e(of)i(b)m(ytes)g(that)f(are)h(used)f(in)f(the)i(w)m(orkspace)g(o)m │ │ │ │ │ (wned)f(b)m(y)227 5407 y(this)31 b(ob)5 b(ject.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1063 4 v 1245 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2744 100 V 1063 w Fo(11)227 399 y Ff(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1082 4 v 1264 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2725 100 V 1082 w Fo(11)227 399 y Ff(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ b(cking:)40 b Fo(If)30 b Fn(mtx)g Fo(is)g Fn(NULL)p Fo(,)g(an)g(error)g │ │ │ │ │ (message)h(is)g(prin)m(ted)f(and)g(the)g(program)g(exits.)111 │ │ │ │ │ 606 y(3.)46 b Fn(int)h(SubMtx_nbytesInWorkspace)41 b(\()48 │ │ │ │ │ b(SubMtx)e(*mtx)h(\))g(;)227 766 y Fo(This)30 b(metho)s(d)g(returns)f │ │ │ │ │ (the)h(n)m(um)m(b)s(er)f(of)i(b)m(ytes)g(in)f(the)g(w)m(orkspace)i(o)m │ │ │ │ │ (wned)e(b)m(y)g(this)g(ob)5 b(ject.)227 926 y Ff(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 b Fn(mtx)g Fo(is)g │ │ │ │ │ @@ -6192,37 +6184,37 @@ │ │ │ │ │ Fo(of)j(the)f Fn(mtx)227 5134 y Fo(ob)5 b(ject)32 b(in)m(to)f(the)f │ │ │ │ │ Fn(colDV)f Fo(v)m(ector)j(ob)5 b(ject.)227 5294 y Ff(Err)-5 │ │ │ │ │ b(or)30 b(che)-5 b(cking:)38 b Fo(If)26 b Fn(mtx)f Fo(or)h │ │ │ │ │ Fn(colDV)e Fo(is)i Fn(NULL)p Fo(,)f(or)h(if)g Fn(jcol)f │ │ │ │ │ Fo(is)h(out)g(of)g(range,)i(an)e(error)f(message)i(is)f(prin)m(ted)227 │ │ │ │ │ 5407 y(and)k(the)h(program)f(exits.)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1063 │ │ │ │ │ -4 v 1246 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2837 100 V 66 399 a Fo(11.)46 │ │ │ │ │ -b Fn(void)h(SubMtx_fillRowZV)c(\()48 b(SubMtx)e(*mtx,)g(int)h(irow,)f │ │ │ │ │ -(ZV)i(*rowZV)e(\))h(;)227 551 y Fo(This)35 b(metho)s(d)f(is)h(used)f │ │ │ │ │ -(for)h(complex)h(submatrices.)55 b(It)35 b(copies)h(the)f(en)m(tries)h │ │ │ │ │ -(in)e(ro)m(w)h Fn(irow)f Fo(of)i(the)f Fn(mtx)227 664 │ │ │ │ │ -y Fo(ob)5 b(ject)32 b(in)m(to)f(the)f Fn(rowZV)f Fo(v)m(ector)j(ob)5 │ │ │ │ │ -b(ject.)227 816 y Ff(Err)-5 b(or)30 b(che)-5 b(cking:)38 │ │ │ │ │ -b Fo(If)26 b Fn(mtx)f Fo(or)h Fn(rowZV)e Fo(is)i Fn(NULL)p │ │ │ │ │ -Fo(,)f(or)h(if)g Fn(irow)f Fo(is)h(out)g(of)g(range,)i(an)e(error)f │ │ │ │ │ -(message)i(is)f(prin)m(ted)227 929 y(and)k(the)h(program)f(exits.)66 │ │ │ │ │ -1121 y(12.)46 b Fn(void)h(SubMtx_fillColumnZV)42 b(\()48 │ │ │ │ │ -b(SubMtx)e(*mtx,)g(int)h(jcol,)g(ZV)g(*rowZV)f(\))h(;)227 │ │ │ │ │ -1273 y Fo(This)26 b(metho)s(d)g(is)g(used)g(for)g(complex)i │ │ │ │ │ -(submatrices.)39 b(It)26 b(copies)i(the)e(en)m(tries)i(in)e(column)g │ │ │ │ │ -Fn(jcol)f Fo(of)i(the)g Fn(mtx)227 1386 y Fo(ob)5 b(ject)32 │ │ │ │ │ -b(in)m(to)f(the)f Fn(colZV)f Fo(v)m(ector)j(ob)5 b(ject.)227 │ │ │ │ │ -1538 y Ff(Err)-5 b(or)30 b(che)-5 b(cking:)38 b Fo(If)26 │ │ │ │ │ -b Fn(mtx)f Fo(or)h Fn(colZV)e Fo(is)i Fn(NULL)p Fo(,)f(or)h(if)g │ │ │ │ │ -Fn(jcol)f Fo(is)h(out)g(of)g(range,)i(an)e(error)f(message)i(is)f(prin) │ │ │ │ │ -m(ted)227 1651 y(and)k(the)h(program)f(exits.)66 1843 │ │ │ │ │ -y(13.)46 b Fn(double)g(SubMtx_maxabs)f(\()i(SubMtx)f(*mtx)h(\))g(;)227 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1082 │ │ │ │ │ +4 v 1265 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2818 100 V 66 399 a Fo(11.)46 b Fn(void)h(SubMtx_fillRowZV)c │ │ │ │ │ +(\()48 b(SubMtx)e(*mtx,)g(int)h(irow,)f(ZV)i(*rowZV)e(\))h(;)227 │ │ │ │ │ +551 y Fo(This)35 b(metho)s(d)f(is)h(used)f(for)h(complex)h │ │ │ │ │ +(submatrices.)55 b(It)35 b(copies)h(the)f(en)m(tries)h(in)e(ro)m(w)h │ │ │ │ │ +Fn(irow)f Fo(of)i(the)f Fn(mtx)227 664 y Fo(ob)5 b(ject)32 │ │ │ │ │ +b(in)m(to)f(the)f Fn(rowZV)f Fo(v)m(ector)j(ob)5 b(ject.)227 │ │ │ │ │ +816 y Ff(Err)-5 b(or)30 b(che)-5 b(cking:)38 b Fo(If)26 │ │ │ │ │ +b Fn(mtx)f Fo(or)h Fn(rowZV)e Fo(is)i Fn(NULL)p Fo(,)f(or)h(if)g │ │ │ │ │ +Fn(irow)f Fo(is)h(out)g(of)g(range,)i(an)e(error)f(message)i(is)f(prin) │ │ │ │ │ +m(ted)227 929 y(and)k(the)h(program)f(exits.)66 1121 │ │ │ │ │ +y(12.)46 b Fn(void)h(SubMtx_fillColumnZV)42 b(\()48 b(SubMtx)e(*mtx,)g │ │ │ │ │ +(int)h(jcol,)g(ZV)g(*rowZV)f(\))h(;)227 1273 y Fo(This)26 │ │ │ │ │ +b(metho)s(d)g(is)g(used)g(for)g(complex)i(submatrices.)39 │ │ │ │ │ +b(It)26 b(copies)i(the)e(en)m(tries)i(in)e(column)g Fn(jcol)f │ │ │ │ │ +Fo(of)i(the)g Fn(mtx)227 1386 y Fo(ob)5 b(ject)32 b(in)m(to)f(the)f │ │ │ │ │ +Fn(colZV)f Fo(v)m(ector)j(ob)5 b(ject.)227 1538 y Ff(Err)-5 │ │ │ │ │ +b(or)30 b(che)-5 b(cking:)38 b Fo(If)26 b Fn(mtx)f Fo(or)h │ │ │ │ │ +Fn(colZV)e Fo(is)i Fn(NULL)p Fo(,)f(or)h(if)g Fn(jcol)f │ │ │ │ │ +Fo(is)h(out)g(of)g(range,)i(an)e(error)f(message)i(is)f(prin)m(ted)227 │ │ │ │ │ +1651 y(and)k(the)h(program)f(exits.)66 1843 y(13.)46 │ │ │ │ │ +b Fn(double)g(SubMtx_maxabs)f(\()i(SubMtx)f(*mtx)h(\))g(;)227 │ │ │ │ │ 1995 y Fo(This)27 b(metho)s(d)g(returns)f(the)h(magnitude)h(of)f(the)h │ │ │ │ │ (elemen)m(t)h(in)e(the)h(matrix)f(with)g(the)h(largest)h(magnitude.)227 │ │ │ │ │ 2147 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fo(If)30 │ │ │ │ │ b Fn(mtx)g Fo(is)g Fn(NULL)p Fo(,)g(an)g(error)g(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)g(the)g(program)g(exits.)66 2339 y(14.)46 │ │ │ │ │ b Fn(void)h(SubMtx_zero)e(\()i(SubMtx)f(*mtx)h(\))g(;)227 │ │ │ │ │ 2491 y Fo(This)30 b(metho)s(d)g(zeros)h(the)f(en)m(tries)h(of)g(the)g │ │ │ │ │ @@ -6266,17 +6258,17 @@ │ │ │ │ │ Fn(SubMtx)e Fo(ob)5 b(ject)37 b(from)f(a)g(binary)f(\014le.)57 │ │ │ │ │ b(If)36 b(there)g(are)g(no)g(errors)f(in)h(reading)227 │ │ │ │ │ 5407 y(the)30 b(data,)h(the)f(v)-5 b(alue)30 b Fn(1)f │ │ │ │ │ Fo(is)h(returned.)39 b(If)29 b(an)h(IO)f(error)g(is)h(encoun)m(tered)g │ │ │ │ │ (from)f Fn(fread)p Fo(,)g(zero)h(is)g(returned.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 91 100 1063 4 v 1245 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2744 100 V 1063 w Fo(13)227 399 y(Note,)40 b(if)c(the)g(m)m(txutation)i │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1082 4 v 1264 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2725 100 V 1082 w Fo(13)227 399 y(Note,)40 b(if)c(the)g(m)m(txutation)i │ │ │ │ │ (v)m(ectors)f(are)g(one-based)f(\(as)h(for)f(F)-8 b(ortran\),)39 │ │ │ │ │ b(they)e(are)f(con)m(v)m(erted)i(to)f(zero-)227 511 y(based)30 │ │ │ │ │ b(v)m(ectors.)227 660 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fo(If)30 b Fn(mtx)g Fo(or)g Fn(fp)g Fo(are)h Fn(NULL)p │ │ │ │ │ Fo(,)e(an)h(error)g(message)i(is)e(prin)m(ted)g(and)g(zero)h(is)g │ │ │ │ │ (returned.)111 843 y(4.)46 b Fn(int)h(SubMtx_writeToFile)c(\()k(SubMtx) │ │ │ │ │ g(*mtx,)f(char)h(*fn)f(\))i(;)227 991 y Fo(This)32 b(metho)s(d)g │ │ │ │ │ @@ -6345,20 +6337,20 @@ │ │ │ │ │ (follo)m(w)h(the)f(Matlab)h(and)e(F)m(OR)-8 b(TRAN)227 │ │ │ │ │ 5146 y(con)m(v)m(en)m(tion.)227 5294 y Ff(Err)j(or)45 │ │ │ │ │ b(che)-5 b(cking:)63 b Fo(If)42 b Fn(mtx)p Fo(,)i Fn(mtxname)c │ │ │ │ │ Fo(or)i Fn(fp)f Fo(are)h Fn(NULL)p Fo(,)f(an)h(error)f(message)i(is)f │ │ │ │ │ (prin)m(ted)g(and)f(zero)i(is)227 5407 y(returned.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ -TeXDict begin 14 13 bop 0 100 a Fo(14)p 182 100 1063 │ │ │ │ │ -4 v 1246 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2837 100 V 0 399 a Fe(1.3)135 │ │ │ │ │ -b(Driv)l(er)46 b(programs)g(for)f(the)g Fd(SubMtx)58 │ │ │ │ │ -b(object)111 629 y Fo(1.)46 b Fn(testIO)g(msglvl)g(msgFile)g(inFile)g │ │ │ │ │ -(outFile)227 782 y Fo(This)c(driv)m(er)f(program)h(reads)g(in)g(a)g │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fo(14)p 182 100 1082 │ │ │ │ │ +4 v 1265 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2818 100 V 0 399 a Fe(1.3)135 b(Driv)l(er)46 │ │ │ │ │ +b(programs)g(for)f(the)g Fd(SubMtx)58 b(object)111 629 │ │ │ │ │ +y Fo(1.)46 b Fn(testIO)g(msglvl)g(msgFile)g(inFile)g(outFile)227 │ │ │ │ │ +782 y Fo(This)c(driv)m(er)f(program)h(reads)g(in)g(a)g │ │ │ │ │ Fn(SubMtx)e Fo(ob)5 b(ject)43 b(from)f Fn(inFile)e Fo(and)i(writes)g │ │ │ │ │ (out)g(the)g(ob)5 b(ject)43 b(to)227 895 y Fn(outFile)337 │ │ │ │ │ 1114 y Fi(\210)i Fo(The)28 b Fn(msglvl)f Fo(parameter)i(determines)g │ │ │ │ │ (the)g(amoun)m(t)g(of)f(output)h(|)f(taking)i Fn(msglvl)46 │ │ │ │ │ b(>=)h(3)28 b Fo(means)427 1227 y(the)j Fn(SubMtx)e Fo(ob)5 │ │ │ │ │ b(ject)31 b(is)f(written)h(to)g(the)f(message)i(\014le.)337 │ │ │ │ │ 1376 y Fi(\210)45 b Fo(The)33 b Fn(msgFile)e Fo(parameter)j(determines) │ │ │ │ │ @@ -6422,17 +6414,17 @@ │ │ │ │ │ b(When)40 b(the)g(output)g(\014le)g(is)g(loaded)h(in)m(to)227 │ │ │ │ │ 5075 y(matlab,)32 b(the)e(last)h(lines)g(to)g(the)g(screen)f(con)m │ │ │ │ │ (tain)i(the)e(errors.)337 5294 y Fi(\210)45 b Fo(The)f │ │ │ │ │ Fn(msglvl)e Fo(parameter)j(determines)f(the)g(amoun)m(t)h(of)f(output.) │ │ │ │ │ 82 b(Use)44 b Fn(msglvl)i(=)i(1)c Fo(for)g(just)427 5407 │ │ │ │ │ y(timing)31 b(output.)p eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 91 100 1063 4 v 1245 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2744 100 V 1063 w Fo(15)337 399 y Fi(\210)45 b Fo(The)33 │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1082 4 v 1264 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2725 100 V 1082 w Fo(15)337 399 y Fi(\210)45 b Fo(The)33 │ │ │ │ │ b Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ (if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the)427 │ │ │ │ │ 511 y(message)27 b(\014le)f(is)g Ff(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Ff(app)-5 b(end)28 │ │ │ │ │ b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 624 │ │ │ │ │ y(data.)337 772 y Fi(\210)45 b Fo(The)30 b Fn(type)f │ │ │ │ │ Fo(parameter)i(m)m(ust)f(b)s(e)g(one)h(of)f(1)h(\()p │ │ │ │ │ @@ -6512,20 +6504,20 @@ │ │ │ │ │ b(When)35 b(the)g(output)f(\014le)h(is)227 5078 y(loaded)c(in)m(to)g │ │ │ │ │ (matlab,)h(the)e(last)i(lines)e(to)h(the)g(screen)f(con)m(tain)i(the)f │ │ │ │ │ (errors.)337 5294 y Fi(\210)45 b Fo(The)f Fn(msglvl)e │ │ │ │ │ Fo(parameter)j(determines)f(the)g(amoun)m(t)h(of)f(output.)82 │ │ │ │ │ b(Use)44 b Fn(msglvl)i(=)i(1)c Fo(for)g(just)427 5407 │ │ │ │ │ y(timing)31 b(output.)p eop end │ │ │ │ │ %%Page: 16 16 │ │ │ │ │ -TeXDict begin 16 15 bop 0 100 a Fo(16)p 182 100 1063 │ │ │ │ │ -4 v 1246 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2837 100 V 337 399 a Fi(\210)45 │ │ │ │ │ -b Fo(The)33 b Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g │ │ │ │ │ -(\014le)f(|)h(if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the) │ │ │ │ │ -427 511 y(message)27 b(\014le)f(is)g Ff(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fo(16)p 182 100 1082 │ │ │ │ │ +4 v 1265 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2818 100 V 337 399 a Fi(\210)45 b Fo(The)33 b │ │ │ │ │ +Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ +(if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the)427 │ │ │ │ │ +511 y(message)27 b(\014le)f(is)g Ff(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Ff(app)-5 b(end)28 │ │ │ │ │ b Fo(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 624 │ │ │ │ │ y(data.)337 767 y Fi(\210)45 b Fo(The)30 b Fn(type)f │ │ │ │ │ Fo(parameter)i(m)m(ust)f(b)s(e)g(one)h(of)f(1)h(\()p │ │ │ │ │ Fn(SPOOLES)p 2342 767 29 4 v 33 w(REAL)p Fo(\))f(or)g(2)h(\()p │ │ │ │ │ Fn(SPOOLES)p 3190 767 V 32 w(COMPLEX)p Fo(\).)337 910 │ │ │ │ │ y Fi(\210)45 b Fo(The)20 b Fn(mode)f Fo(parameter)i(m)m(ust)f(b)s(e)g │ │ │ │ │ @@ -6604,17 +6596,17 @@ │ │ │ │ │ y(columns,)i(and)d Fm(A)h Fo(has)f(dense)h(ro)m(ws)g(or)f(columns)h(or) │ │ │ │ │ g(sparse)f(ro)m(ws)h(or)f(columns.)63 b(Use)38 b(the)g(script)g(\014le) │ │ │ │ │ 227 5294 y Fn(do)p 329 5294 V 34 w(solveupdH)32 b Fo(for)j(testing.)54 │ │ │ │ │ b(When)35 b(the)f(output)h(\014le)f(is)h(loaded)g(in)m(to)h(matlab,)g │ │ │ │ │ (the)f(last)h(lines)e(to)i(the)227 5407 y(screen)31 b(con)m(tain)g(the) │ │ │ │ │ g(errors.)p eop end │ │ │ │ │ %%Page: 17 17 │ │ │ │ │ -TeXDict begin 17 16 bop 91 100 1063 4 v 1245 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2744 100 V 1063 w Fo(17)337 399 y Fi(\210)45 b Fo(The)f │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1082 4 v 1264 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2725 100 V 1082 w Fo(17)337 399 y Fi(\210)45 b Fo(The)f │ │ │ │ │ Fn(msglvl)e Fo(parameter)j(determines)f(the)g(amoun)m(t)h(of)f(output.) │ │ │ │ │ 82 b(Use)44 b Fn(msglvl)i(=)i(1)c Fo(for)g(just)427 511 │ │ │ │ │ y(timing)31 b(output.)337 655 y Fi(\210)45 b Fo(The)33 │ │ │ │ │ b Fn(msgFile)e Fo(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ (if)f Fn(msgFile)e Fo(is)i Fn(stdout)p Fo(,)g(then)g(the)427 │ │ │ │ │ 767 y(message)27 b(\014le)f(is)g Ff(stdout)p Fo(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Ff(app)-5 b(end)28 │ │ │ │ │ @@ -6693,20 +6685,20 @@ │ │ │ │ │ (en)m(tries)g(in)f(the)h(submatrix,)g(when)e(appro-)427 │ │ │ │ │ 5121 y(priate.)337 5264 y Fi(\210)45 b Fo(The)30 b Fn(nrowX)f │ │ │ │ │ Fo(parameter)i(is)f(the)h(n)m(um)m(b)s(er)e(of)i(ro)m(ws)f(in)g │ │ │ │ │ Fm(X)7 b Fo(,)31 b Fn(nrowA)24 b Fj(\024)h Fn(nrowY)n │ │ │ │ │ Fo(.)337 5407 y Fi(\210)45 b Fo(The)30 b Fn(seed)f Fo(parameter)i(is)g │ │ │ │ │ (a)f(random)g(n)m(um)m(b)s(er)f(seed.)p eop end │ │ │ │ │ %%Page: 18 18 │ │ │ │ │ -TeXDict begin 18 17 bop 0 100 a Fo(18)p 182 100 1063 │ │ │ │ │ -4 v 1246 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2837 100 V 111 399 a Fo(9.)46 │ │ │ │ │ -b Fn(test_sort)g(msglvl)g(msgFile)f(type)i(mode)g(nrowA)f(ncolA)g │ │ │ │ │ -(nentA)h(seed)227 549 y Fo(This)22 b(driv)m(er)h(program)f(tests)i(the) │ │ │ │ │ -f Fn(SubMtx)p 1688 549 29 4 v 32 w(sortRowsUp\(\))d Fo(and)i │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fo(18)p 182 100 1082 │ │ │ │ │ +4 v 1265 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2818 100 V 111 399 a Fo(9.)46 b Fn(test_sort)g(msglvl)g │ │ │ │ │ +(msgFile)f(type)i(mode)g(nrowA)f(ncolA)g(nentA)h(seed)227 │ │ │ │ │ +549 y Fo(This)22 b(driv)m(er)h(program)f(tests)i(the)f │ │ │ │ │ +Fn(SubMtx)p 1688 549 29 4 v 32 w(sortRowsUp\(\))d Fo(and)i │ │ │ │ │ Fn(SubMtx)p 2773 549 V 33 w(sortColumnsUp\(\))c Fo(metho)s(ds.)227 │ │ │ │ │ 662 y(Use)34 b(the)g(script)f(\014le)h Fn(do)p 1073 662 │ │ │ │ │ V 33 w(sort)f Fo(for)g(testing.)51 b(When)33 b(the)h(output)f(\014le)g │ │ │ │ │ (is)h(loaded)g(in)m(to)g(matlab,)h(the)f(last)227 775 │ │ │ │ │ y(lines)d(to)g(the)g(screen)f(con)m(tain)i(the)e(errors.)337 │ │ │ │ │ 987 y Fi(\210)45 b Fo(The)f Fn(msglvl)e Fo(parameter)j(determines)f │ │ │ │ │ (the)g(amoun)m(t)h(of)f(output.)82 b(Use)44 b Fn(msglvl)i(=)i(1)c │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -23,15 +23,15 @@ │ │ │ │ │ │ – dense by columns, i.e., dense and column major │ │ │ │ │ │ – sparse using dense subrows │ │ │ │ │ │ – sparse using dense subcolumns │ │ │ │ │ │ – sparse using sparse rows │ │ │ │ │ │ – sparse using sparse columns │ │ │ │ │ │ – sparse using (i,j,ai,j) triples │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 SubMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 SubMtx : DRAFT January 7, 2024 │ │ │ │ │ │ – a diagonal matrix │ │ │ │ │ │ – a block diagonal symmetric matrix where the blocks are 1 × 1 or 2 × 2, used in the │ │ │ │ │ │ symmetric indefinite factorization. │ │ │ │ │ │ – a block diagonal Hermitian matrix where the blocks are 1 × 1 or 2 × 2, used in the │ │ │ │ │ │ hermitian indefinite factorization. │ │ │ │ │ │ • The SubMtx object can be self-contained, in the sense that its structure contains a DV object │ │ │ │ │ │ that manages a contiguous vector of workspace that is used to store all information about the │ │ │ │ │ │ @@ -60,15 +60,15 @@ │ │ │ │ │ │ information is better than using explicit structure fields. For example, if we want to extend the │ │ │ │ │ │ object by allowing another storage format, we do not need to increase the size of the structure at │ │ │ │ │ │ all — it is only necessary to provide one or more instance methods to return the new information. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ The SubMtx structure has the following fields. │ │ │ │ │ │ • int type : type of entries. │ │ │ │ │ │ – SPOOLES REAL : double precision real entries. │ │ │ │ │ │ - SubMtx : DRAFT February 8, 2025 3 │ │ │ │ │ │ + SubMtx : DRAFT January 7, 2024 3 │ │ │ │ │ │ – SPOOLES COMPLEX : double precision complex entries. │ │ │ │ │ │ • int mode : storage mode. │ │ │ │ │ │ – SUBMTX DENSE ROWS : dense, storage by rows. │ │ │ │ │ │ – SUBMTX DENSE COLUMNS : dense, storage by columns. │ │ │ │ │ │ – SUBMTX SPARSE ROWS : sparse, storage by rows. │ │ │ │ │ │ – SUBMTX SPARSE COLUMNS : sparse, storage by columns. │ │ │ │ │ │ – SUBMTX SPARSE TRIPLES : sparse, storage by (i,j,ai,j) triples. │ │ │ │ │ │ @@ -92,15 +92,15 @@ │ │ │ │ │ │ • SUBMTX IS DENSE ROWS(mtx)is 1 if mtx has dense rows as its storage format, and 0 otherwise. │ │ │ │ │ │ • SUBMTX IS DENSE COLUMNS(mtx) is 1 if mtx has dense columns as its storage format, and 0 │ │ │ │ │ │ otherwise. │ │ │ │ │ │ • SUBMTX IS SPARSE ROWS(mtx) is 1 if mtx has sparse rows as its storage format, and 0 other- │ │ │ │ │ │ wise. │ │ │ │ │ │ • SUBMTX IS SPARSE COLUMNS(mtx) is 1 if mtx has sparse columns as its storage format, and 0 │ │ │ │ │ │ otherwise. │ │ │ │ │ │ - 4 SubMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 SubMtx : DRAFT January 7, 2024 │ │ │ │ │ │ • SUBMTX IS SPARSE TRIPLES(mtx) is 1 if mtx has sparse triples as its storage format, 0 other- │ │ │ │ │ │ wise. │ │ │ │ │ │ • SUBMTX IS DENSE SUBROWS(mtx) is 1 if mtx has dense subrows as its storage format, 0 other- │ │ │ │ │ │ wise. │ │ │ │ │ │ • SUBMTX IS DENSE SUBCOLUMNS(mtx) is 1 if mtx has dense subcolumns as its storage format, │ │ │ │ │ │ 0 otherwise. │ │ │ │ │ │ • SUBMTX IS DIAGONAL(mtx) is 1 if mtx is diagonal, 0 otherwise. │ │ │ │ │ │ @@ -126,15 +126,15 @@ │ │ │ │ │ │ This method clears the object and free’s any owned data by invoking the clearData() │ │ │ │ │ │ methodsforitsinternal DVobject. Thereis a concluding call to SubMtx setDefaultFields(). │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void SubMtx_free ( SubMtx *mtx ) ; │ │ │ │ │ │ This method releases any storage by a call to SubMtx clearData() and then frees the space │ │ │ │ │ │ for mtx. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - SubMtx : DRAFT February 8, 2025 5 │ │ │ │ │ │ + SubMtx : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.2.2 Instance methods │ │ │ │ │ │ 1. void SubMtx_ids ( SubMtx *mtx, int *prowid, int *pcolid ) ; │ │ │ │ │ │ This method fills *prowid with the row id and *pcolid with the column id of the object. │ │ │ │ │ │ Error checking: If mtx, prowid or pcolid is NULL, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 2. void SubMtx_setIds ( SubMtx *mtx, int rowid, int colid ) ; │ │ │ │ │ │ This method sets the row and column id’s of the matrix. │ │ │ │ │ │ @@ -163,15 +163,15 @@ │ │ │ │ │ │ the program exits. │ │ │ │ │ │ 7. void SubMtx_sparseRowsInfo ( SubMtx *mtx, int *pnrow, int *pnent, │ │ │ │ │ │ int **psizes, int **pindices, double **pentries ) ; │ │ │ │ │ │ This method is used when the storage mode is sparse rows. It fills *pnrow with the number │ │ │ │ │ │ of rows, *pnent with the number of matrix entries, *psizes with the base address of the │ │ │ │ │ │ sizes[nrow]vector that contains the number of entries in each row, *indices with the base │ │ │ │ │ │ address of the indices[nent] vector that contains the column index for each entry, and │ │ │ │ │ │ - 6 SubMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 SubMtx : DRAFT January 7, 2024 │ │ │ │ │ │ *pentries with the base address of entries[nent] vector. The indices and entries for the │ │ │ │ │ │ rows are stored contiguously. │ │ │ │ │ │ Error checking: If mtx, pnrow, pnent, psizes, pindices or pentries is NULL, or if the matrix │ │ │ │ │ │ type is not SUBMTX SPARSE ROWS, an error message is printed and the program exits. │ │ │ │ │ │ 8. void SubMtx_sparseColumnsInfo ( SubMtx *mtx, int *pncol, int *pnent, │ │ │ │ │ │ int **psizes, int **pindices, double **pentries ) ; │ │ │ │ │ │ Thismethodisusedwhenthestoragemodeissparsecolumns. Itfills*pncolwiththenumber │ │ │ │ │ │ @@ -204,15 +204,15 @@ │ │ │ │ │ │ exits. │ │ │ │ │ │ 11. void SubMtx_denseSubcolumnsInfo ( SubMtx *mtx, int *pncol, int *pnent, │ │ │ │ │ │ int **pfirstlocs, int **plastlocs, double **pentries ) ; │ │ │ │ │ │ This method is used when the storage mode is dense subcolumns. It fills *pncol with │ │ │ │ │ │ the number of columns, *pnent with the number of matrix entries, *pfirstlocs with the │ │ │ │ │ │ base address of the firstlocs[ncol] vector, *plastlocs with the base address of the │ │ │ │ │ │ lastlocs[ncol]vector, and *pentries with the base address of entries[nent] vector. For │ │ │ │ │ │ - SubMtx : DRAFT February 8, 2025 7 │ │ │ │ │ │ + SubMtx : DRAFT January 7, 2024 7 │ │ │ │ │ │ column jcol, the nonzero entries are found in rows [firstlocs[jcol],lastlocs[jcol]] │ │ │ │ │ │ when firstlocs[jcol] ≥ 0 and firstlocs[jcol] ≤ lastlocs[jcol]. The entries for the │ │ │ │ │ │ columns are stored contiguously. │ │ │ │ │ │ Error checking: If mtx, pnrow, pnent, pfirstlocs, plastlocs or pentries is NULL, or if the │ │ │ │ │ │ matrix type is not SUBMTX DENSE SUBCOLUMNS, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ 12. void SubMtx_diagonalInfo ( SubMtx *mtx, int *pncol, double **pentries ) ; │ │ │ │ │ │ @@ -242,15 +242,15 @@ │ │ │ │ │ │ and 0 ≤ jcol ≤ ncol. If the (irow,jcol) entry is present, the return value is the offset │ │ │ │ │ │ from the start of the entries vector. (The offset is in terms of complex entries, not double │ │ │ │ │ │ entries.) Otherwise, -1 is returned. │ │ │ │ │ │ Error checking: If mtx, pReal or pImag is NULL, or if irow or jcol is out of range, an error │ │ │ │ │ │ message is printed and the program exits. │ │ │ │ │ │ 16. void SubMtx_locationOfRealEntry ( SubMtx *mtx, int irow, int jcol, │ │ │ │ │ │ double **ppValue ) ; │ │ │ │ │ │ - 8 SubMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 SubMtx : DRAFT January 7, 2024 │ │ │ │ │ │ If the (irow,jcol) entry is present, this method fills *ppValue with a pointer to the entry │ │ │ │ │ │ in row irow and columnjcol. Otherwise, *ppValue is set to NULL. Note, irow and jcol are │ │ │ │ │ │ local indices, i.e., 0 ≤ irow ≤ nrow and 0 ≤ jcol ≤ ncol. │ │ │ │ │ │ Error checking: If mtx or ppValue is NULL, or if irow or jcol is out of range, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ 17. void SubMtx_locationOfComplexEntry ( SubMtx *mtx, int irow, int jcol, │ │ │ │ │ │ double **ppReal, double **ppImag ) ; │ │ │ │ │ │ @@ -278,15 +278,15 @@ │ │ │ │ │ │ int nrow, int ncol, int nent, int seed ) ; │ │ │ │ │ │ This is used to initialize an object to have random entries and (possibly) random structure. │ │ │ │ │ │ The object is first initialized via a call to SubMtx init(). Its matrix entries are then filled │ │ │ │ │ │ with random numbers. If the matrix is sparse, its sparsity pattern is sparse and random, │ │ │ │ │ │ using nent when applicable. The row and column indices are ascending starting from zero. │ │ │ │ │ │ Error checking: If mtx is NULL, or if nrow, ncol, inc1 or inc2 is less than or equal to zero, │ │ │ │ │ │ or if neither inc1 nor inc2 are 1, an error message is printed and the program exits. │ │ │ │ │ │ - SubMtx : DRAFT February 8, 2025 9 │ │ │ │ │ │ + SubMtx : DRAFT January 7, 2024 9 │ │ │ │ │ │ 4. void SubMtx_initRandomLowerTriangle ( SubMtx *mtx, int type, int mode, │ │ │ │ │ │ int rowid, int colid, int nrow, int ncol, int nent, int seed, int strict ) ; │ │ │ │ │ │ void SubMtx_initRandomUpperTriangle ( SubMtx *mtx, int type, int mode, │ │ │ │ │ │ int rowid, int colid, int nrow, int ncol, int nent, int seed, int strict ) ; │ │ │ │ │ │ This is used to initialize an object to have random entries and (possibly) random struc- │ │ │ │ │ │ ture. The matrix type may not be diagonal, block diagonal, or triples. If strict = 1, the │ │ │ │ │ │ matrix will be strict lower or upper triangular. The object is first initialized via a call to │ │ │ │ │ │ @@ -317,15 +317,15 @@ │ │ │ │ │ │ 1. void SubMtx_solve ( SubMtx *mtxA, SubMtx *mtxB ) ; │ │ │ │ │ │ This method is used to solve (I + A)X = B (if A is strict lower or upper triangular) or │ │ │ │ │ │ AX =B (if A is diagonal or block diagonal). The solution X overwrites B, and mtxB must │ │ │ │ │ │ have dense columns. If A is strict lower triangular, then mtxA must have dense subrows or │ │ │ │ │ │ sparse rows. If A is strict upper triangular, then mtxA must have dense subcolumns or sparse │ │ │ │ │ │ columns. │ │ │ │ │ │ Error checking: If mtxA or mtxB is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 10 SubMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 SubMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 2. void SubMtx_solveH ( SubMtx *mtxA, SubMtx *mtxB ) ; │ │ │ │ │ │ This method is used to solve (I+AH)X = B, where A is strict lower or upper triangular. The │ │ │ │ │ │ solution X overwrites B, and mtxB must have dense columns. If A is strict lower triangular, │ │ │ │ │ │ then mtxA must have dense subrows or sparse rows. If A is strict upper triangular, then mtxA │ │ │ │ │ │ must have dense subcolumns or sparse columns. │ │ │ │ │ │ Error checking: If mtxA or mtxB is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. void SubMtx_solveT ( SubMtx *mtxA, SubMtx *mtxB ) ; │ │ │ │ │ │ @@ -354,15 +354,15 @@ │ │ │ │ │ │ This method returns the number of bytes required to store the object’s information in its │ │ │ │ │ │ buffer. │ │ │ │ │ │ Error checking: If nrow or ncol is less than or equal to zero, or if nent is less than to zero, │ │ │ │ │ │ or if type is invalid, an error message is printed and the program exits. │ │ │ │ │ │ 2. int SubMtx_nbytesInUse ( SubMtx *mtx ) ; │ │ │ │ │ │ This method returns the actual number of bytes that are used in the workspace owned by │ │ │ │ │ │ this object. │ │ │ │ │ │ - SubMtx : DRAFT February 8, 2025 11 │ │ │ │ │ │ + SubMtx : DRAFT January 7, 2024 11 │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. int SubMtx_nbytesInWorkspace ( SubMtx *mtx ) ; │ │ │ │ │ │ This method returns the number of bytes in the workspace owned by this object. │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 4. void SubMtx_setNbytesInWorkspace ( SubMtx *mtx, int nbytes ) ; │ │ │ │ │ │ This method sets the number of bytes in the workspace of this object. If nbytes is less than │ │ │ │ │ │ the present number of bytes, the workspace is not resized. │ │ │ │ │ │ @@ -387,15 +387,15 @@ │ │ │ │ │ │ Error checking: If mtx or rowDV is NULL, or if irow is out of range, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 10. void SubMtx_fillColumnDV ( SubMtx *mtx, int jcol, DV *rowDV ) ; │ │ │ │ │ │ This method is used for real submatrices. It copies the entries in column jcol of the mtx │ │ │ │ │ │ object into the colDV vector object. │ │ │ │ │ │ Error checking: If mtx or colDV is NULL, or if jcol is out of range, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ - 12 SubMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 SubMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 11. void SubMtx_fillRowZV ( SubMtx *mtx, int irow, ZV *rowZV ) ; │ │ │ │ │ │ This method is used for complex submatrices. It copies the entries in row irow of the mtx │ │ │ │ │ │ object into the rowZV vector object. │ │ │ │ │ │ Error checking: If mtx or rowZV is NULL, or if irow is out of range, an error message is printed │ │ │ │ │ │ and the program exits. │ │ │ │ │ │ 12. void SubMtx_fillColumnZV ( SubMtx *mtx, int jcol, ZV *rowZV ) ; │ │ │ │ │ │ This method is used for complex submatrices. It copies the entries in column jcol of the mtx │ │ │ │ │ │ @@ -422,15 +422,15 @@ │ │ │ │ │ │ the data, the value 1 is returned. If an IO error is encountered from fscanf, zero is returned. │ │ │ │ │ │ Note, if the mtxutation vectors are one-based (as for Fortran), they are converted to zero- │ │ │ │ │ │ based vectors. │ │ │ │ │ │ Error checking: If mtx or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 3. int SubMtx_readFromBinaryFile ( SubMtx *mtx, FILE *fp ) ; │ │ │ │ │ │ This method reads in a SubMtx object from a binary file. If there are no errors in reading │ │ │ │ │ │ the data, the value 1 is returned. If an IO error is encountered from fread, zero is returned. │ │ │ │ │ │ - SubMtx : DRAFT February 8, 2025 13 │ │ │ │ │ │ + SubMtx : DRAFT January 7, 2024 13 │ │ │ │ │ │ Note, if the mtxutation vectors are one-based (as for Fortran), they are converted to zero- │ │ │ │ │ │ based vectors. │ │ │ │ │ │ Error checking: If mtx or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 4. int SubMtx_writeToFile ( SubMtx *mtx, char *fn ) ; │ │ │ │ │ │ This method writes a SubMtx object to a file. It tries to open the file and if it is successful, │ │ │ │ │ │ it then calls SubMtx writeFromFormattedFile()or SubMtx writeFromBinaryFile(),closes │ │ │ │ │ │ the file and returns the value returned from the called routine. │ │ │ │ │ │ @@ -457,15 +457,15 @@ │ │ │ │ │ │ for complex matrices, or │ │ │ │ │ │ a(10,5) = -1.550328201511e-01 ; │ │ │ │ │ │ for real matrices, where mtxname = "a". The matrix indices come from the rowind[] │ │ │ │ │ │ and colind[] vectors, and are incremented by one to follow the Matlab and FORTRAN │ │ │ │ │ │ convention. │ │ │ │ │ │ Error checking: If mtx, mtxname or fp are NULL, an error message is printed and zero is │ │ │ │ │ │ returned. │ │ │ │ │ │ - 14 SubMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 14 SubMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 1.3 Driver programs for the SubMtx object │ │ │ │ │ │ 1. testIO msglvl msgFile inFile outFile │ │ │ │ │ │ This driver program reads in a SubMtx object from inFile and writes out the object to │ │ │ │ │ │ outFile │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the SubMtx object is written to the message file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ @@ -494,15 +494,15 @@ │ │ │ │ │ │ 3. test_solve msglvl msgFile type mode nrowA nentA ncolB seed │ │ │ │ │ │ This driver program tests the SubMtx solve() method which tests the solve AX = B when │ │ │ │ │ │ A is diagonal or block diagonal, and (I + A)X = B otherwise (A is strict upper or lower │ │ │ │ │ │ triangular). Use the script file do solve for testing. When the output file is loaded into │ │ │ │ │ │ matlab, the last lines to the screen contain the errors. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ timing output. │ │ │ │ │ │ - SubMtx : DRAFT February 8, 2025 15 │ │ │ │ │ │ + SubMtx : DRAFT January 7, 2024 15 │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The type parameter must be one of 1 (SPOOLES REAL) or 2 (SPOOLES COMPLEX). │ │ │ │ │ │ • Themodeparametermustbeoneof2(SUBMTX SPARSE ROWS),3(SUBMTX SPARSE COLUMNS), │ │ │ │ │ │ 5 (SUBMTX DENSE SUBROWS), 6 (SUBMTX DENSE SUBCOLUMNS), 7 (SUBMTX DIAGONAL), │ │ │ │ │ │ 8 (SUBMTX BLOCK DIAGONAL SYM) or 9 (SUBMTX BLOCK DIAGONAL HERM). │ │ │ │ │ │ @@ -534,15 +534,15 @@ │ │ │ │ │ │ T │ │ │ │ │ │ This driver program tests the SubMtx solve() method which tests the solve (I +A )X = B │ │ │ │ │ │ when A is strict upper or lower triangular and has dense subrows, dense subcolumns, sparse │ │ │ │ │ │ rows, or sparse columns. Use the script file do solveT for testing. When the output file is │ │ │ │ │ │ loaded into matlab, the last lines to the screen contain the errors. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ timing output. │ │ │ │ │ │ - 16 SubMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 16 SubMtx : DRAFT January 7, 2024 │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The type parameter must be one of 1 (SPOOLES REAL) or 2 (SPOOLES COMPLEX). │ │ │ │ │ │ • Themodeparametermustbeoneof2(SUBMTX SPARSE ROWS),3(SUBMTX SPARSE COLUMNS), │ │ │ │ │ │ 5 (SUBMTX DENSE SUBROWS) or 6 (SUBMTX DENSE SUBCOLUMNS). │ │ │ │ │ │ • The nrowA parameter is the number of rows in the matrix. │ │ │ │ │ │ @@ -573,15 +573,15 @@ │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ 7. test_solveupdH msglvl msgFile type mode nrowA nentA ncolB seed │ │ │ │ │ │ This driver program tests the SubMtx solveupd() method which tests the update Y := │ │ │ │ │ │ Y −AH ∗X, used in the forward solve of a hermitian factorization. X and Y have dense │ │ │ │ │ │ columns, and A has dense rows or columns or sparse rows or columns. Use the script file │ │ │ │ │ │ do solveupdH for testing. When the output file is loaded into matlab, the last lines to the │ │ │ │ │ │ screen contain the errors. │ │ │ │ │ │ - SubMtx : DRAFT February 8, 2025 17 │ │ │ │ │ │ + SubMtx : DRAFT January 7, 2024 17 │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The type parameter must be 2 (SPOOLES COMPLEX). │ │ │ │ │ │ • Themodeparametermustbeoneof0(SUBMTX DENSE ROWS),1(SUBMTX DENSE COLUMNS), │ │ │ │ │ │ @@ -612,15 +612,15 @@ │ │ │ │ │ │ • The ncolY parameter is the number of columns in Y. │ │ │ │ │ │ • The nrowA parameter is the number of rows in A, nrowA ≤ nrowY. │ │ │ │ │ │ • The ncolA parameter is the number of columns in A, ncolA ≤ nrowX. │ │ │ │ │ │ • The nentA parameter is the number of nonzero entries in the submatrix, when appro- │ │ │ │ │ │ priate. │ │ │ │ │ │ • The nrowX parameter is the number of rows in X, nrowA ≤ nrowY. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ - 18 SubMtx : DRAFT February 8, 2025 │ │ │ │ │ │ + 18 SubMtx : DRAFT January 7, 2024 │ │ │ │ │ │ 9. test_sort msglvl msgFile type mode nrowA ncolA nentA seed │ │ │ │ │ │ Thisdriver program tests the SubMtx sortRowsUp()and SubMtx sortColumnsUp()methods. │ │ │ │ │ │ Use the script file do sort for testing. When the output file is loaded into matlab, the last │ │ │ │ │ │ lines to the screen contain the errors. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ ├── ./usr/share/doc/spooles-doc/SubMtxList.ps.gz │ │ │ │ ├── SubMtxList.ps │ │ │ │ │ @@ -10,15 +10,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o SubMtxList.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1777,21 +1777,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1975,88 +1974,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3323,15 +3317,15 @@ │ │ │ │ │ 5[84 5[42 6[80 13[56 56 56 56 2[31 46[{}23 99.6264 /CMBX12 │ │ │ │ │ rf /Fc 135[62 2[62 62 62 9[62 6[62 14[62 5[62 62 76[{}9 │ │ │ │ │ 119.552 /CMTT12 rf /Fd 134[71 3[75 52 53 55 1[75 67 75 │ │ │ │ │ 112 3[37 75 1[41 61 75 60 1[65 13[75 2[92 11[103 17[67 │ │ │ │ │ 67 2[37 46[{}22 119.552 /CMBX12 rf /Fe 141[38 2[46 51 │ │ │ │ │ 2[42 1[28 46 42 1[42 1[42 14[65 1[66 11[59 62 69 2[68 │ │ │ │ │ 6[28 58[{}16 90.9091 /CMTI10 rf /Ff 134[48 3[51 2[36 │ │ │ │ │ -12[40 2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 │ │ │ │ │ +3[51 12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 │ │ │ │ │ 90.9091 /CMSL10 rf │ │ │ │ │ %DVIPSBitmapFont: Fg tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ @@ -3444,57 +3438,56 @@ │ │ │ │ │ (ciated)g(with)e(a)g Fh(SubMtxList)e Fi(ob)5 b(ject)36 │ │ │ │ │ b(is)g(optional,)i(for)d(example,)i(it)f(is)g(not)f(needed)0 │ │ │ │ │ 5407 y(during)22 b(a)i(serial)g(factorization)i(nor)d(a)h(MPI)f(solv)m │ │ │ │ │ (e.)40 b(In)23 b(the)g(latter)i(case)f(there)g(is)f(one)h │ │ │ │ │ Fh(SubMtxList)d Fi(p)s(er)h(pro)s(cess.)1927 5656 y(1)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fi(2)p 136 100 991 4 v │ │ │ │ │ -1172 w Fh(SubMtxList)28 b Ff(:)41 b Fe(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2910 100 V 0 399 a Fi(F)-8 │ │ │ │ │ -b(or)26 b(a)f(m)m(ultithreaded)h(solv)m(e)g(there)g(is)f(one)g │ │ │ │ │ -Fh(SubMtxList)e Fi(ob)5 b(ject)26 b(that)g(is)f(shared)f(b)m(y)h(all)h │ │ │ │ │ -(threads.)39 b(The)25 b(m)m(utual)0 511 y(exclusion)33 │ │ │ │ │ -b(lo)s(c)m(k)h(that)f(is)f(\(optionally\))j(em)m(b)s(edded)c(in)i(the)f │ │ │ │ │ -Fh(SubMtxList)e Fi(ob)5 b(ject)34 b(is)e(a)h Fh(Lock)f │ │ │ │ │ -Fi(ob)5 b(ject)33 b(from)f(this)0 624 y(library)-8 b(.)39 │ │ │ │ │ -b(It)27 b(is)f(inside)g(the)g Fh(Lock)f Fi(ob)5 b(ject)27 │ │ │ │ │ -b(that)g(w)m(e)f(ha)m(v)m(e)i(a)e(m)m(utual)h(exclusion)g(lo)s(c)m(k.) │ │ │ │ │ -40 b(Presen)m(tly)27 b(w)m(e)f(supp)s(ort)f(the)0 737 │ │ │ │ │ -y(Solaris)32 b(and)g(POSIX)f(thread)h(pac)m(k)-5 b(ages.)48 │ │ │ │ │ -b(P)m(orting)33 b(the)g(m)m(ultithreaded)f(co)s(des)g(to)h(another)g │ │ │ │ │ -(platform)f(should)0 850 y(b)s(e)37 b(simple)h(if)g(the)h(POSIX)e │ │ │ │ │ -(thread)h(pac)m(k)-5 b(age)40 b(is)e(presen)m(t.)64 b(Another)38 │ │ │ │ │ -b(t)m(yp)s(e)g(of)g(thread)g(pac)m(k)-5 b(age)40 b(will)e(require)0 │ │ │ │ │ -963 y(some)31 b(mo)s(di\014cations)f(to)h(the)g Fh(Lock)e │ │ │ │ │ -Fi(ob)5 b(ject,)32 b(but)d(none)i(to)g(the)f Fh(SubMtxList)e │ │ │ │ │ -Fi(ob)5 b(jects.)0 1293 y Fd(1.1)135 b(Data)46 b(Structure)0 │ │ │ │ │ -1527 y Fi(The)30 b Fh(SubMtxList)d Fi(structure)j(has)g(the)h(follo)m │ │ │ │ │ -(wing)h(\014elds.)137 1752 y Fg(\210)45 b Fh(int)i(nlist)29 │ │ │ │ │ -b Fi(:)41 b(n)m(um)m(b)s(er)29 b(of)h(lists.)137 1952 │ │ │ │ │ -y Fg(\210)45 b Fh(SubMtx)h(**heads)29 b Fi(:)40 b(v)m(ector)32 │ │ │ │ │ -b(of)f(p)s(oin)m(ters)f(to)h(the)g(heads)f(of)g(the)h(list)g(of)g │ │ │ │ │ -Fh(SubMtx)d Fi(ob)5 b(jects.)137 2152 y Fg(\210)45 b │ │ │ │ │ -Fh(int)i(*counts)29 b Fi(:)40 b(v)m(ector)32 b(of)f(incoming)g(coun)m │ │ │ │ │ -(ts)f(for)h(the)f(lists.)137 2353 y Fg(\210)45 b Fh(Lock)i(*lock)29 │ │ │ │ │ -b Fi(:)41 b(m)m(utual)30 b(exclusion)h(lo)s(c)m(k.)137 │ │ │ │ │ -2553 y Fg(\210)45 b Fh(char)i(*flags)32 b Fi(:)48 b(v)m(ector)36 │ │ │ │ │ -b(of)e(lo)s(c)m(k)h(\015ags)f(for)g(the)g(lists.)52 b(If)33 │ │ │ │ │ -b Fh(flags[ilist])45 b(==)i('N')p Fi(,)33 b(the)h(list)h(do)s(es)f(not) │ │ │ │ │ -227 2666 y(need)27 b(to)h(b)s(e)e(lo)s(c)m(k)m(ed.)41 │ │ │ │ │ -b(If)27 b Fh(flags[ilist])44 b(==)j('Y')p Fi(,)27 b(the)g(list)g(do)s │ │ │ │ │ -(es)g(need)g(to)h(b)s(e)e(lo)s(c)m(k)m(ed.)41 b(Used)27 │ │ │ │ │ -b(only)g(when)227 2779 y Fh(lock)i Fi(is)i(not)g Fh(NULL)p │ │ │ │ │ -Fi(.)137 2979 y Fg(\210)45 b Fh(int)i(nlocks)29 b Fi(:)41 │ │ │ │ │ -b(total)32 b(n)m(um)m(b)s(er)d(of)h(lo)s(c)m(ks)i(made)e(on)g(the)h(m)m │ │ │ │ │ -(utual)f(exclusion)h(lo)s(c)m(k.)0 3309 y Fd(1.2)135 │ │ │ │ │ -b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g Fc(SubMtxList)c │ │ │ │ │ -Fd(metho)t(ds)0 3543 y Fi(This)g(section)j(con)m(tains)f(brief)f │ │ │ │ │ -(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f │ │ │ │ │ -(that)h(b)s(elong)f(to)h(the)0 3656 y Fh(SubMtxList)28 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fi(2)p 136 100 1010 4 v │ │ │ │ │ +1192 w Fh(SubMtxList)27 b Ff(:)41 b Fe(DRAFT)30 b Ff(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2891 100 V 0 399 a Fi(F)-8 b(or)26 b(a)f(m)m(ultithreaded)h │ │ │ │ │ +(solv)m(e)g(there)g(is)f(one)g Fh(SubMtxList)e Fi(ob)5 │ │ │ │ │ +b(ject)26 b(that)g(is)f(shared)f(b)m(y)h(all)h(threads.)39 │ │ │ │ │ +b(The)25 b(m)m(utual)0 511 y(exclusion)33 b(lo)s(c)m(k)h(that)f(is)f │ │ │ │ │ +(\(optionally\))j(em)m(b)s(edded)c(in)i(the)f Fh(SubMtxList)e │ │ │ │ │ +Fi(ob)5 b(ject)34 b(is)e(a)h Fh(Lock)f Fi(ob)5 b(ject)33 │ │ │ │ │ +b(from)f(this)0 624 y(library)-8 b(.)39 b(It)27 b(is)f(inside)g(the)g │ │ │ │ │ +Fh(Lock)f Fi(ob)5 b(ject)27 b(that)g(w)m(e)f(ha)m(v)m(e)i(a)e(m)m │ │ │ │ │ +(utual)h(exclusion)g(lo)s(c)m(k.)40 b(Presen)m(tly)27 │ │ │ │ │ +b(w)m(e)f(supp)s(ort)f(the)0 737 y(Solaris)32 b(and)g(POSIX)f(thread)h │ │ │ │ │ +(pac)m(k)-5 b(ages.)48 b(P)m(orting)33 b(the)g(m)m(ultithreaded)f(co)s │ │ │ │ │ +(des)g(to)h(another)g(platform)f(should)0 850 y(b)s(e)37 │ │ │ │ │ +b(simple)h(if)g(the)h(POSIX)e(thread)h(pac)m(k)-5 b(age)40 │ │ │ │ │ +b(is)e(presen)m(t.)64 b(Another)38 b(t)m(yp)s(e)g(of)g(thread)g(pac)m │ │ │ │ │ +(k)-5 b(age)40 b(will)e(require)0 963 y(some)31 b(mo)s(di\014cations)f │ │ │ │ │ +(to)h(the)g Fh(Lock)e Fi(ob)5 b(ject,)32 b(but)d(none)i(to)g(the)f │ │ │ │ │ +Fh(SubMtxList)e Fi(ob)5 b(jects.)0 1293 y Fd(1.1)135 │ │ │ │ │ +b(Data)46 b(Structure)0 1527 y Fi(The)30 b Fh(SubMtxList)d │ │ │ │ │ +Fi(structure)j(has)g(the)h(follo)m(wing)h(\014elds.)137 │ │ │ │ │ +1752 y Fg(\210)45 b Fh(int)i(nlist)29 b Fi(:)41 b(n)m(um)m(b)s(er)29 │ │ │ │ │ +b(of)h(lists.)137 1952 y Fg(\210)45 b Fh(SubMtx)h(**heads)29 │ │ │ │ │ +b Fi(:)40 b(v)m(ector)32 b(of)f(p)s(oin)m(ters)f(to)h(the)g(heads)f(of) │ │ │ │ │ +g(the)h(list)g(of)g Fh(SubMtx)d Fi(ob)5 b(jects.)137 │ │ │ │ │ +2152 y Fg(\210)45 b Fh(int)i(*counts)29 b Fi(:)40 b(v)m(ector)32 │ │ │ │ │ +b(of)f(incoming)g(coun)m(ts)f(for)h(the)f(lists.)137 │ │ │ │ │ +2353 y Fg(\210)45 b Fh(Lock)i(*lock)29 b Fi(:)41 b(m)m(utual)30 │ │ │ │ │ +b(exclusion)h(lo)s(c)m(k.)137 2553 y Fg(\210)45 b Fh(char)i(*flags)32 │ │ │ │ │ +b Fi(:)48 b(v)m(ector)36 b(of)e(lo)s(c)m(k)h(\015ags)f(for)g(the)g │ │ │ │ │ +(lists.)52 b(If)33 b Fh(flags[ilist])45 b(==)i('N')p │ │ │ │ │ +Fi(,)33 b(the)h(list)h(do)s(es)f(not)227 2666 y(need)27 │ │ │ │ │ +b(to)h(b)s(e)e(lo)s(c)m(k)m(ed.)41 b(If)27 b Fh(flags[ilist])44 │ │ │ │ │ +b(==)j('Y')p Fi(,)27 b(the)g(list)g(do)s(es)g(need)g(to)h(b)s(e)e(lo)s │ │ │ │ │ +(c)m(k)m(ed.)41 b(Used)27 b(only)g(when)227 2779 y Fh(lock)i │ │ │ │ │ +Fi(is)i(not)g Fh(NULL)p Fi(.)137 2979 y Fg(\210)45 b │ │ │ │ │ +Fh(int)i(nlocks)29 b Fi(:)41 b(total)32 b(n)m(um)m(b)s(er)d(of)h(lo)s │ │ │ │ │ +(c)m(ks)i(made)e(on)g(the)h(m)m(utual)f(exclusion)h(lo)s(c)m(k.)0 │ │ │ │ │ +3309 y Fd(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g │ │ │ │ │ +Fc(SubMtxList)c Fd(metho)t(ds)0 3543 y Fi(This)g(section)j(con)m(tains) │ │ │ │ │ +f(brief)f(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h │ │ │ │ │ +(metho)s(ds)f(that)h(b)s(elong)f(to)h(the)0 3656 y Fh(SubMtxList)28 │ │ │ │ │ b Fi(ob)5 b(ject.)0 3942 y Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ 4145 y Fi(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g │ │ │ │ │ (supp)s(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f │ │ │ │ │ (\014elds,)h(clearing)0 4258 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f │ │ │ │ │ (free'ing)h(the)g(ob)5 b(ject.)111 4511 y(1.)46 b Fh(SubMtxList)f(*)j │ │ │ │ │ (SubMtxList_new)c(\()j(void)g(\))g(;)227 4668 y Fi(This)28 │ │ │ │ │ b(metho)s(d)f(simply)h(allo)s(cates)i(storage)g(for)e(the)g │ │ │ │ │ @@ -3508,65 +3501,65 @@ │ │ │ │ │ (and)d Fh(heads)p Fi(,)227 5251 y Fh(counts)p Fi(,)29 │ │ │ │ │ b Fh(lock)g Fi(and)h Fh(flags)f Fi(are)i(set)g(to)g Fh(NULL)e │ │ │ │ │ Fi(.)227 5407 y Fe(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fi(If)30 b Fh(list)g Fi(is)g Fh(NULL)p Fi(,)f(an)i(error)f(message)h │ │ │ │ │ (is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 991 4 v 1172 100 a Fh(SubMtxList)28 │ │ │ │ │ -b Ff(:)40 b Fe(DRAFT)121 b Ff(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2863 100 V 991 w Fi(3)111 399 y(3.)46 b Fh(void)h(SubMtxList_clearData) │ │ │ │ │ -42 b(\()48 b(SubMtxList)d(*list)h(\))h(;)227 555 y Fi(This)31 │ │ │ │ │ -b(metho)s(d)f(clears)j(the)e(ob)5 b(ject)32 b(and)f(free's)h(an)m(y)f │ │ │ │ │ -(o)m(wned)g(data)h(b)m(y)g(calling)g Fh(SubMtx)p 3241 │ │ │ │ │ -555 29 4 v 33 w(free\(\))e Fi(for)h(eac)m(h)227 668 y(ob)5 │ │ │ │ │ -b(ject)30 b(on)e(the)h(free)g(list.)41 b(If)28 b Fh(heads)f │ │ │ │ │ -Fi(is)i(not)g Fh(NULL)p Fi(,)f(it)h(is)g(free'd.)40 b(If)28 │ │ │ │ │ -b Fh(counts)f Fi(is)i(not)g Fh(NULL)p Fi(,)f(it)h(is)g(free'd)f(via)227 │ │ │ │ │ -781 y(a)i(call)g(to)f Fh(IVfree\(\))p Fi(.)38 b(If)29 │ │ │ │ │ -b Fh(flags)e Fi(is)i(not)g Fh(NULL)p Fi(,)f(it)h(is)g(free'd)g(via)h(a) │ │ │ │ │ -f(call)h(to)f Fh(CVfree\(\))p Fi(.)38 b(If)29 b(the)g(lo)s(c)m(k)h(is)f │ │ │ │ │ -(not)227 894 y Fh(NULL)p Fi(,)34 b(it)i(is)f(destro)m(y)m(ed)h(via)f(a) │ │ │ │ │ -g(call)i(to)e Fh(mutex)p 1848 894 V 33 w(destroy\(\))e │ │ │ │ │ -Fi(and)h(then)h(free'd.)54 b(There)34 b(is)h(a)h(concluding)227 │ │ │ │ │ -1007 y(call)c(to)f Fh(SubMtxList)p 991 1007 V 32 w │ │ │ │ │ -(setDefaultFields\(\))p Fi(.)227 1164 y Fe(Err)-5 b(or)34 │ │ │ │ │ -b(che)-5 b(cking:)40 b Fi(If)30 b Fh(list)g Fi(is)g Fh(NULL)p │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1010 4 v 1191 100 a Fh(SubMtxList)28 │ │ │ │ │ +b Ff(:)40 b Fe(DRAFT)121 b Ff(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2843 100 V 1010 w Fi(3)111 399 y(3.)46 b Fh(void)h │ │ │ │ │ +(SubMtxList_clearData)42 b(\()48 b(SubMtxList)d(*list)h(\))h(;)227 │ │ │ │ │ +555 y Fi(This)31 b(metho)s(d)f(clears)j(the)e(ob)5 b(ject)32 │ │ │ │ │ +b(and)f(free's)h(an)m(y)f(o)m(wned)g(data)h(b)m(y)g(calling)g │ │ │ │ │ +Fh(SubMtx)p 3241 555 29 4 v 33 w(free\(\))e Fi(for)h(eac)m(h)227 │ │ │ │ │ +668 y(ob)5 b(ject)30 b(on)e(the)h(free)g(list.)41 b(If)28 │ │ │ │ │ +b Fh(heads)f Fi(is)i(not)g Fh(NULL)p Fi(,)f(it)h(is)g(free'd.)40 │ │ │ │ │ +b(If)28 b Fh(counts)f Fi(is)i(not)g Fh(NULL)p Fi(,)f(it)h(is)g(free'd)f │ │ │ │ │ +(via)227 781 y(a)i(call)g(to)f Fh(IVfree\(\))p Fi(.)38 │ │ │ │ │ +b(If)29 b Fh(flags)e Fi(is)i(not)g Fh(NULL)p Fi(,)f(it)h(is)g(free'd)g │ │ │ │ │ +(via)h(a)f(call)h(to)f Fh(CVfree\(\))p Fi(.)38 b(If)29 │ │ │ │ │ +b(the)g(lo)s(c)m(k)h(is)f(not)227 894 y Fh(NULL)p Fi(,)34 │ │ │ │ │ +b(it)i(is)f(destro)m(y)m(ed)h(via)f(a)g(call)i(to)e Fh(mutex)p │ │ │ │ │ +1848 894 V 33 w(destroy\(\))e Fi(and)h(then)h(free'd.)54 │ │ │ │ │ +b(There)34 b(is)h(a)h(concluding)227 1007 y(call)c(to)f │ │ │ │ │ +Fh(SubMtxList)p 991 1007 V 32 w(setDefaultFields\(\))p │ │ │ │ │ +Fi(.)227 1164 y Fe(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fi(If)30 b Fh(list)g Fi(is)g Fh(NULL)p Fi(,)f(an)i(error)f(message)h │ │ │ │ │ +(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)111 1364 │ │ │ │ │ +y(4.)46 b Fh(void)h(SubMtxList_free)d(\()j(SubMtxList)e(*list)h(\))i(;) │ │ │ │ │ +227 1521 y Fi(This)37 b(metho)s(d)f(releases)i(an)m(y)g(storage)h(b)m │ │ │ │ │ +(y)e(a)g(call)i(to)e Fh(SubMtxList)p 2607 1521 V 32 w(clearData\(\))d │ │ │ │ │ +Fi(and)j(then)f(free)i(the)227 1634 y(space)31 b(for)f │ │ │ │ │ +Fh(list)p Fi(.)227 1791 y Fe(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +b(cking:)40 b Fi(If)30 b Fh(list)g Fi(is)g Fh(NULL)p │ │ │ │ │ Fi(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ -(exits.)111 1364 y(4.)46 b Fh(void)h(SubMtxList_free)d(\()j(SubMtxList) │ │ │ │ │ -e(*list)h(\))i(;)227 1521 y Fi(This)37 b(metho)s(d)f(releases)i(an)m(y) │ │ │ │ │ -g(storage)h(b)m(y)e(a)g(call)i(to)e Fh(SubMtxList)p 2607 │ │ │ │ │ -1521 V 32 w(clearData\(\))d Fi(and)j(then)f(free)i(the)227 │ │ │ │ │ -1634 y(space)31 b(for)f Fh(list)p Fi(.)227 1791 y Fe(Err)-5 │ │ │ │ │ -b(or)34 b(che)-5 b(cking:)40 b Fi(If)30 b Fh(list)g Fi(is)g │ │ │ │ │ -Fh(NULL)p Fi(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i │ │ │ │ │ -(program)f(exits.)0 2078 y Fb(1.2.2)112 b(Initialization)39 │ │ │ │ │ -b(metho)s(ds)0 2281 y Fi(There)30 b(are)h(three)f(initializer)j(metho)s │ │ │ │ │ -(ds.)111 2534 y(1.)46 b Fh(void)h(SubMtxList_init\()c(SubMtxList)i │ │ │ │ │ -(*list,)h(int)h(nlist,)f(int)h(counts[],)1277 2647 y(int)g(lockflag,)e │ │ │ │ │ -(char)i(flags[])f(\))h(;)227 2804 y Fi(An)m(y)35 b(data)h(is)f(cleared) │ │ │ │ │ -h(via)f(a)h(call)g(to)g Fh(SubMtxList)p 2054 2804 V 31 │ │ │ │ │ -w(clearData\(\))p Fi(.)51 b(The)35 b(n)m(um)m(b)s(er)f(of)h(lists)g(is) │ │ │ │ │ -g(set)h(and)227 2917 y(the)43 b Fh(heads[])d Fi(v)m(ector)j(is)f │ │ │ │ │ -(initialized.)78 b(If)41 b Fh(counts)g Fi(is)h(not)g │ │ │ │ │ -Fh(NULL)p Fi(,)f(the)h(ob)5 b(ject's)43 b Fh(counts[])d │ │ │ │ │ -Fi(v)m(ector)k(is)227 3030 y(allo)s(cated)31 b(and)e(\014lled)g(with)g │ │ │ │ │ -(the)g(incoming)h(en)m(tries.)41 b(If)29 b Fh(lockflag)e │ │ │ │ │ -Fi(is)i(zero,)i(the)e(lo)s(c)m(k)h(is)f(not)h(initialized.)227 │ │ │ │ │ -3143 y(If)39 b Fh(lockflag)e Fi(is)i Fh(1)p Fi(,)j(the)d(lo)s(c)m(k)i │ │ │ │ │ -(is)e(initialized)i(to)f(b)s(e)f(able)h(to)g(sync)m(hronize)f(threads)g │ │ │ │ │ -(with)g(the)g(calling)227 3256 y(pro)s(cess.)71 b(If)40 │ │ │ │ │ -b Fh(lockflag)e Fi(is)j Fh(2)p Fi(,)i(the)e(lo)s(c)m(k)g(is)g │ │ │ │ │ -(initialized)h(to)f(b)s(e)f(able)h(to)g(sync)m(hronize)g(threads)f │ │ │ │ │ -(across)227 3368 y(pro)s(cesses.)49 b(If)32 b Fh(flags)g │ │ │ │ │ -Fi(is)h(not)g Fh(NULL)p Fi(,)f(the)h(ob)5 b(ject's)34 │ │ │ │ │ -b Fh(flags[])d Fi(v)m(ector)k(is)e(allo)s(cated)i(and)d(\014lled)h │ │ │ │ │ -(with)g(the)227 3481 y(incoming)e(en)m(tries.)227 3638 │ │ │ │ │ -y Fe(Err)-5 b(or)40 b(che)-5 b(cking:)53 b Fi(If)36 b │ │ │ │ │ -Fh(list)g Fi(is)h Fh(NULL)p Fi(,)f(or)g(if)h Fh(nlist)e │ │ │ │ │ +(exits.)0 2078 y Fb(1.2.2)112 b(Initialization)39 b(metho)s(ds)0 │ │ │ │ │ +2281 y Fi(There)30 b(are)h(three)f(initializer)j(metho)s(ds.)111 │ │ │ │ │ +2534 y(1.)46 b Fh(void)h(SubMtxList_init\()c(SubMtxList)i(*list,)h(int) │ │ │ │ │ +h(nlist,)f(int)h(counts[],)1277 2647 y(int)g(lockflag,)e(char)i │ │ │ │ │ +(flags[])f(\))h(;)227 2804 y Fi(An)m(y)35 b(data)h(is)f(cleared)h(via)f │ │ │ │ │ +(a)h(call)g(to)g Fh(SubMtxList)p 2054 2804 V 31 w(clearData\(\))p │ │ │ │ │ +Fi(.)51 b(The)35 b(n)m(um)m(b)s(er)f(of)h(lists)g(is)g(set)h(and)227 │ │ │ │ │ +2917 y(the)43 b Fh(heads[])d Fi(v)m(ector)j(is)f(initialized.)78 │ │ │ │ │ +b(If)41 b Fh(counts)g Fi(is)h(not)g Fh(NULL)p Fi(,)f(the)h(ob)5 │ │ │ │ │ +b(ject's)43 b Fh(counts[])d Fi(v)m(ector)k(is)227 3030 │ │ │ │ │ +y(allo)s(cated)31 b(and)e(\014lled)g(with)g(the)g(incoming)h(en)m │ │ │ │ │ +(tries.)41 b(If)29 b Fh(lockflag)e Fi(is)i(zero,)i(the)e(lo)s(c)m(k)h │ │ │ │ │ +(is)f(not)h(initialized.)227 3143 y(If)39 b Fh(lockflag)e │ │ │ │ │ +Fi(is)i Fh(1)p Fi(,)j(the)d(lo)s(c)m(k)i(is)e(initialized)i(to)f(b)s(e) │ │ │ │ │ +f(able)h(to)g(sync)m(hronize)f(threads)g(with)g(the)g(calling)227 │ │ │ │ │ +3256 y(pro)s(cess.)71 b(If)40 b Fh(lockflag)e Fi(is)j │ │ │ │ │ +Fh(2)p Fi(,)i(the)e(lo)s(c)m(k)g(is)g(initialized)h(to)f(b)s(e)f(able)h │ │ │ │ │ +(to)g(sync)m(hronize)g(threads)f(across)227 3368 y(pro)s(cesses.)49 │ │ │ │ │ +b(If)32 b Fh(flags)g Fi(is)h(not)g Fh(NULL)p Fi(,)f(the)h(ob)5 │ │ │ │ │ +b(ject's)34 b Fh(flags[])d Fi(v)m(ector)k(is)e(allo)s(cated)i(and)d │ │ │ │ │ +(\014lled)h(with)g(the)227 3481 y(incoming)e(en)m(tries.)227 │ │ │ │ │ +3638 y Fe(Err)-5 b(or)40 b(che)-5 b(cking:)53 b Fi(If)36 │ │ │ │ │ +b Fh(list)g Fi(is)h Fh(NULL)p Fi(,)f(or)g(if)h Fh(nlist)e │ │ │ │ │ Fa(\024)g Fi(0,)k(or)e(if)g Fh(lockflag)d Fi(is)j(not)g(in)f │ │ │ │ │ Fh([0,2])p Fi(,)i(an)e(error)227 3751 y(message)c(is)e(prin)m(ted)g │ │ │ │ │ (and)g(zero)h(is)f(returned.)0 4038 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ b(metho)s(ds)111 4241 y Fi(1.)46 b Fh(int)h(SubMtxList_isListNonempty) │ │ │ │ │ 41 b(\()48 b(SubMtxList)d(*list,)h(int)h(ilist)f(\))h(;)227 │ │ │ │ │ 4398 y Fi(If)30 b(list)h Fh(ilist)e Fi(is)i(empt)m(y)-8 │ │ │ │ │ b(,)31 b(the)g(metho)s(d)e(returns)h(0.)41 b(Otherwise,)30 │ │ │ │ │ @@ -3582,27 +3575,27 @@ │ │ │ │ │ (1.)44 b(Otherwise,)32 b(the)227 5138 y(metho)s(d)e(returns)f(0.)227 │ │ │ │ │ 5294 y Fe(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fi(If)29 │ │ │ │ │ b Fh(list)g Fi(is)h Fh(NULL)p Fi(,)f(or)h(if)g Fh(ilist)e │ │ │ │ │ Fi(is)i(not)h(in)e(the)h(range)h Fh([0,nlist\))p Fi(,)c(an)j(error)g │ │ │ │ │ (message)227 5407 y(is)h(prin)m(ted)f(and)f(zero)j(is)e(returned.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fi(4)p 136 100 991 4 v │ │ │ │ │ -1172 w Fh(SubMtxList)28 b Ff(:)41 b Fe(DRAFT)30 b Ff(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2910 100 V 111 399 a Fi(3.)46 │ │ │ │ │ -b Fh(SubMtx)g(*)i(SubMtxList_getList)43 b(\()k(SubMtxList)e(*list,)h │ │ │ │ │ -(int)h(ilist)f(\))i(;)227 549 y Fi(If)28 b(list)h Fh(ilist)e │ │ │ │ │ -Fi(is)h(empt)m(y)-8 b(,)30 b(the)f(metho)s(d)f(returns)f │ │ │ │ │ -Fh(NULL)p Fi(.)g(Otherwise,)i(if)f(the)h(list)g(needs)f(to)h(b)s(e)e │ │ │ │ │ -(lo)s(c)m(k)m(ed,)k(the)227 662 y(lo)s(c)m(k)37 b(is)e(lo)s(c)m(k)m │ │ │ │ │ -(ed.)57 b(The)34 b(head)h(of)h(the)f(list)h(is)f(sa)m(v)m(ed)i(to)f(a)f │ │ │ │ │ -(p)s(oin)m(ter)h(and)e(then)h(the)h(head)f(is)g(set)h(to)g │ │ │ │ │ -Fh(NULL)p Fi(.)227 775 y(If)c(the)h(list)g(w)m(as)f(lo)s(c)m(k)m(ed,)j │ │ │ │ │ -(the)d(n)m(um)m(b)s(er)f(of)i(lo)s(c)m(ks)g(is)g(incremen)m(ted)f(and)g │ │ │ │ │ -(the)h(lo)s(c)m(k)g(unlo)s(c)m(k)m(ed.)47 b(The)32 b(sa)m(v)m(ed)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fi(4)p 136 100 1010 4 v │ │ │ │ │ +1192 w Fh(SubMtxList)27 b Ff(:)41 b Fe(DRAFT)30 b Ff(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2891 100 V 111 399 a Fi(3.)46 b Fh(SubMtx)g(*)i │ │ │ │ │ +(SubMtxList_getList)43 b(\()k(SubMtxList)e(*list,)h(int)h(ilist)f(\))i │ │ │ │ │ +(;)227 549 y Fi(If)28 b(list)h Fh(ilist)e Fi(is)h(empt)m(y)-8 │ │ │ │ │ +b(,)30 b(the)f(metho)s(d)f(returns)f Fh(NULL)p Fi(.)g(Otherwise,)i(if)f │ │ │ │ │ +(the)h(list)g(needs)f(to)h(b)s(e)e(lo)s(c)m(k)m(ed,)k(the)227 │ │ │ │ │ +662 y(lo)s(c)m(k)37 b(is)e(lo)s(c)m(k)m(ed.)57 b(The)34 │ │ │ │ │ +b(head)h(of)h(the)f(list)h(is)f(sa)m(v)m(ed)i(to)f(a)f(p)s(oin)m(ter)h │ │ │ │ │ +(and)e(then)h(the)h(head)f(is)g(set)h(to)g Fh(NULL)p │ │ │ │ │ +Fi(.)227 775 y(If)c(the)h(list)g(w)m(as)f(lo)s(c)m(k)m(ed,)j(the)d(n)m │ │ │ │ │ +(um)m(b)s(er)f(of)i(lo)s(c)m(ks)g(is)g(incremen)m(ted)f(and)g(the)h(lo) │ │ │ │ │ +s(c)m(k)g(unlo)s(c)m(k)m(ed.)47 b(The)32 b(sa)m(v)m(ed)227 │ │ │ │ │ 888 y(p)s(oin)m(ter)f(is)f(returned.)227 1038 y Fe(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fi(If)29 b Fh(list)g Fi(is)h │ │ │ │ │ Fh(NULL)p Fi(,)f(or)h(if)g Fh(ilist)e Fi(is)i(not)h(in)e(the)h(range)h │ │ │ │ │ Fh([0,nlist\))p Fi(,)c(an)j(error)g(message)227 1151 │ │ │ │ │ y(is)h(prin)m(ted)f(and)f(zero)j(is)e(returned.)111 1338 │ │ │ │ │ y(4.)46 b Fh(void)h(SubMtxList_addObjectToLi)o(st)42 │ │ │ │ │ b(\()47 b(SubMtxList)e(*list,)1993 1451 y(SubMtx)h(*mtx,)h(int)g(ilist) │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -22,15 +22,15 @@ │ │ │ │ │ │ The first two operations are queries, and can be done without locking the list. The third operation │ │ │ │ │ │ needs a lock only when two or more threads will be inserting objects into the list. The fourth │ │ │ │ │ │ operation requires a lock only when one thread will add an object while another thread removes │ │ │ │ │ │ the object and the incoming count is not yet zero. │ │ │ │ │ │ Having a lock associated with a SubMtxList object is optional, for example, it is not needed │ │ │ │ │ │ during a serial factorization nor a MPI solve. In the latter case there is one SubMtxList per process. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 SubMtxList : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 SubMtxList : DRAFT January 7, 2024 │ │ │ │ │ │ For a multithreaded solve there is one SubMtxList object that is shared by all threads. The mutual │ │ │ │ │ │ exclusion lock that is (optionally) embedded in the SubMtxList object is a Lock object from this │ │ │ │ │ │ library. It is inside the Lock object that we have a mutual exclusion lock. Presently we support the │ │ │ │ │ │ Solaris and POSIX thread packages. Porting the multithreaded codes to another platform should │ │ │ │ │ │ be simple if the POSIX thread package is present. Another type of thread package will require │ │ │ │ │ │ some modifications to the Lock object, but none to the SubMtxList objects. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ @@ -52,15 +52,15 @@ │ │ │ │ │ │ 1. SubMtxList * SubMtxList_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the SubMtxList structure and then sets the default │ │ │ │ │ │ fields by a call to SubMtxList setDefaultFields(). │ │ │ │ │ │ 2. void SubMtxList_setDefaultFields ( SubMtxList *list ) ; │ │ │ │ │ │ The structure’s fields are set to default values: nlist and nlocks set to zero, and heads, │ │ │ │ │ │ counts, lock and flags are set to NULL . │ │ │ │ │ │ Error checking: If list is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - SubMtxList : DRAFT February 8, 2025 3 │ │ │ │ │ │ + SubMtxList : DRAFT January 7, 2024 3 │ │ │ │ │ │ 3. void SubMtxList_clearData ( SubMtxList *list ) ; │ │ │ │ │ │ This method clears the object and free’s any owned data by calling SubMtx free() for each │ │ │ │ │ │ object on the free list. If heads is not NULL, it is free’d. If counts is not NULL, it is free’d via │ │ │ │ │ │ a call to IVfree(). If flags is not NULL, it is free’d via a call to CVfree(). If the lock is not │ │ │ │ │ │ NULL, it is destroyed via a call to mutex destroy() and then free’d. There is a concluding │ │ │ │ │ │ call to SubMtxList setDefaultFields(). │ │ │ │ │ │ Error checking: If list is NULL, an error message is printed and the program exits. │ │ │ │ │ │ @@ -87,15 +87,15 @@ │ │ │ │ │ │ Error checking: If list is NULL, or if ilist is not in the range [0,nlist), an error message │ │ │ │ │ │ is printed and zero is returned. │ │ │ │ │ │ 2. int SubMtxList_isCountZero ( SubMtxList *list, int ilist ) ; │ │ │ │ │ │ If counts is NULL, or if counts[ilist] equal to zero, the method returns 1. Otherwise, the │ │ │ │ │ │ method returns 0. │ │ │ │ │ │ Error checking: If list is NULL, or if ilist is not in the range [0,nlist), an error message │ │ │ │ │ │ is printed and zero is returned. │ │ │ │ │ │ - 4 SubMtxList : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 SubMtxList : DRAFT January 7, 2024 │ │ │ │ │ │ 3. SubMtx * SubMtxList_getList ( SubMtxList *list, int ilist ) ; │ │ │ │ │ │ If list ilist is empty, the method returns NULL. Otherwise, if the list needs to be locked, the │ │ │ │ │ │ lock is locked. The head of the list is saved to a pointer and then the head is set to NULL. │ │ │ │ │ │ If the list was locked, the number of locks is incremented and the lock unlocked. The saved │ │ │ │ │ │ pointer is returned. │ │ │ │ │ │ Error checking: If list is NULL, or if ilist is not in the range [0,nlist), an error message │ │ │ │ │ │ is printed and zero is returned. │ │ │ ├── ./usr/share/doc/spooles-doc/SubMtxManager.ps.gz │ │ │ │ ├── SubMtxManager.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o SubMtxManager.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1420,21 +1420,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1618,88 +1617,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3868,16 +3862,16 @@ │ │ │ │ │ @start /Fa 235[71 20[{}1 90.9091 /CMSY10 rf /Fb 133[50 │ │ │ │ │ 59 4[44 44 3[56 62 93 31 2[31 62 2[51 62 50 1[54 11[86 │ │ │ │ │ 5[84 5[42 6[80 13[56 56 56 56 2[31 46[{}23 99.6264 /CMBX12 │ │ │ │ │ rf /Fc 135[62 2[62 62 1[62 3[62 6[62 1[62 2[62 62 13[62 │ │ │ │ │ 5[62 77[{}11 119.552 /CMTT12 rf /Fd 134[71 3[75 52 53 │ │ │ │ │ 55 1[75 67 75 112 3[37 75 1[41 61 75 60 1[65 13[75 2[92 │ │ │ │ │ 11[103 17[67 67 2[37 46[{}22 119.552 /CMBX12 rf /Fe 134[48 │ │ │ │ │ -3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 │ │ │ │ │ -3[25 44[{}13 90.9091 /CMSL10 rf /Ff 180[60 39 9[37 4[20 │ │ │ │ │ +3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 1[45 1[45 │ │ │ │ │ +3[25 44[{}12 90.9091 /CMSL10 rf /Ff 180[60 39 9[37 4[20 │ │ │ │ │ 59[{}4 66.4176 /CMMI8 rf /Fg 170[62 8[62 76[{}2 90.9091 │ │ │ │ │ /CMMI10 rf /Fh 134[44 4[30 37 38 2[46 51 74 23 42 1[28 │ │ │ │ │ 46 42 1[42 46 42 1[46 12[65 1[66 11[59 62 69 2[68 6[28 │ │ │ │ │ 58[{}23 90.9091 /CMTI10 rf │ │ │ │ │ %DVIPSBitmapFont: Fi tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ @@ -4012,26 +4006,26 @@ │ │ │ │ │ (utual)f(exclusion)h(lo)s(c)m(k.)63 b(This)36 b(is)i(not)0 │ │ │ │ │ 5294 y(necessary)33 b(for)g(a)g(serial)h(or)f(MPI)g(factorization)j(or) │ │ │ │ │ d(solv)m(e)h(\(where)f(there)g(is)g(one)g Fj(SubMtxManager)c │ │ │ │ │ Fk(ob)5 b(ject)34 b(for)0 5407 y(eac)m(h)e(pro)s(cessor\),)e(but)g(it)h │ │ │ │ │ (is)f(necessary)h(for)f(in)g(a)h(m)m(ultithreaded)f(en)m(vironmen)m(t.) │ │ │ │ │ 1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 919 4 v │ │ │ │ │ -1101 w Fj(SubMtxManager)27 b Fe(:)40 b Fh(DRAFT)31 b │ │ │ │ │ -Fe(F)-8 b(ebruary)30 b(8,)h(2025)p 2981 100 V 141 399 │ │ │ │ │ -a Fk(Eac)m(h)21 b(manager)h(ob)5 b(ject)21 b(k)m(eeps)h(trac)m(k)g(of)e │ │ │ │ │ -(certain)i(statistics,)j(b)m(ytes)c(in)g(their)f(w)m(orkspaces,)k(the)d │ │ │ │ │ -(total)h(n)m(um)m(b)s(er)0 511 y(of)34 b(b)m(ytes)h(requested,)h(the)e │ │ │ │ │ -(n)m(um)m(b)s(er)f(of)i(requests)f(for)g(a)h Fj(SubMtx)d │ │ │ │ │ -Fk(ob)5 b(jects,)36 b(the)f(n)m(um)m(b)s(er)e(of)h(releases,)j(and)d │ │ │ │ │ -(the)0 624 y(n)m(um)m(b)s(er)29 b(of)i(lo)s(c)m(ks)g(and)f(unlo)s(c)m │ │ │ │ │ -(ks.)0 951 y Fd(1.1)135 b(Data)46 b(Structure)0 1184 │ │ │ │ │ -y Fk(The)30 b Fj(SubMtxManager)d Fk(structure)j(has)g(the)g(follo)m │ │ │ │ │ -(wing)i(\014elds.)137 1407 y Fi(\210)45 b Fj(SubMtx)h(*head)29 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 938 4 v │ │ │ │ │ +1120 w Fj(SubMtxManager)27 b Fe(:)40 b Fh(DRAFT)31 b │ │ │ │ │ +Fe(Jan)m(uary)f(7,)h(2024)p 2962 100 V 141 399 a Fk(Eac)m(h)21 │ │ │ │ │ +b(manager)h(ob)5 b(ject)21 b(k)m(eeps)h(trac)m(k)g(of)e(certain)i │ │ │ │ │ +(statistics,)j(b)m(ytes)c(in)g(their)f(w)m(orkspaces,)k(the)d(total)h │ │ │ │ │ +(n)m(um)m(b)s(er)0 511 y(of)34 b(b)m(ytes)h(requested,)h(the)e(n)m(um)m │ │ │ │ │ +(b)s(er)f(of)i(requests)f(for)g(a)h Fj(SubMtx)d Fk(ob)5 │ │ │ │ │ +b(jects,)36 b(the)f(n)m(um)m(b)s(er)e(of)h(releases,)j(and)d(the)0 │ │ │ │ │ +624 y(n)m(um)m(b)s(er)29 b(of)i(lo)s(c)m(ks)g(and)f(unlo)s(c)m(ks.)0 │ │ │ │ │ +951 y Fd(1.1)135 b(Data)46 b(Structure)0 1184 y Fk(The)30 │ │ │ │ │ +b Fj(SubMtxManager)d Fk(structure)j(has)g(the)g(follo)m(wing)i │ │ │ │ │ +(\014elds.)137 1407 y Fi(\210)45 b Fj(SubMtx)h(*head)29 │ │ │ │ │ b Fk(:)41 b(head)30 b(of)h(the)f(free)h(list)g(of)f Fj(SubMtx)f │ │ │ │ │ Fk(ob)5 b(jects.)137 1606 y Fi(\210)45 b Fj(Lock)i(*lock)29 │ │ │ │ │ b Fk(:)41 b(m)m(utual)30 b(exclusion)h(lo)s(c)m(k.)137 │ │ │ │ │ 1804 y Fi(\210)45 b Fj(int)i(mode)19 b Fk(:)36 b(b)s(eha)m(vior)20 │ │ │ │ │ b(mo)s(de.)37 b(When)20 b Fj(mode)47 b(=)g(0)p Fk(,)23 │ │ │ │ │ b(the)d(ob)5 b(ject)21 b(calls)h Fj(SubMtx)p 2911 1804 │ │ │ │ │ 29 4 v 32 w(new\(\))d Fk(and)h Fj(SubMtx)p 3657 1804 │ │ │ │ │ @@ -4071,17 +4065,17 @@ │ │ │ │ │ k(SubMtxManager_new)43 b(\()k(void)g(\))h(;)227 5294 │ │ │ │ │ y Fk(This)41 b(metho)s(d)g(simply)g(allo)s(cates)j(storage)f(for)e(the) │ │ │ │ │ h Fj(SubMtxManager)c Fk(structure)j(and)g(then)g(sets)h(the)227 │ │ │ │ │ 5407 y(default)31 b(\014elds)f(b)m(y)g(a)h(call)g(to)g │ │ │ │ │ Fj(SubMtxManager)p 1875 5407 V 31 w(setDefaultFields\(\))p │ │ │ │ │ Fk(.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 919 4 v 1100 100 a Fj(SubMtxManager)27 │ │ │ │ │ -b Fe(:)41 b Fh(DRAFT)121 b Fe(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2934 100 V 919 w Fk(3)111 399 y(2.)46 b Fj(void)h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 938 4 v 1119 100 a Fj(SubMtxManager)27 │ │ │ │ │ +b Fe(:)41 b Fh(DRAFT)121 b Fe(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2915 100 V 938 w Fk(3)111 399 y(2.)46 b Fj(void)h │ │ │ │ │ (SubMtxManager_setDefault)o(Fiel)o(ds)41 b(\()48 b(SubMtxManager)c │ │ │ │ │ (*manager)i(\))h(;)227 558 y Fk(The)20 b(structure's)g(\014elds)g(are)g │ │ │ │ │ (set)h(to)g(default)g(v)-5 b(alues:)36 b Fj(mode)p Fk(,)21 │ │ │ │ │ b Fj(nactive)p Fk(,)g Fj(nbytesactive)p Fk(,)e Fj(nbytesrequested)p │ │ │ │ │ Fk(,)227 671 y Fj(nbytesalloc)p Fk(,)33 b Fj(nrequests)p │ │ │ │ │ Fk(,)f Fj(nreleases)p Fk(,)h Fj(nlocks)g Fk(and)g Fj(nunlocks)f │ │ │ │ │ Fk(are)j(set)g(to)g(zero,)h(and)d Fj(head)h Fk(and)227 │ │ │ │ │ @@ -4144,18 +4138,18 @@ │ │ │ │ │ Fj(mode)46 b(=)i(0)p Fk(\),)30 b(or)g(returning)f(it)i(to)g(the)227 │ │ │ │ │ 5247 y(free)g(list)g(\(if)f Fj(mode)47 b(=)h(1)p Fk(\).)227 │ │ │ │ │ 5407 y Fh(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 │ │ │ │ │ b Fj(manager)f Fk(or)h Fj(mtx)g Fk(is)g Fj(NULL)p Fk(,)f(an)i(error)f │ │ │ │ │ (message)h(is)g(prin)m(ted)f(and)f(zero)i(is)g(returned.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 919 4 v │ │ │ │ │ -1101 w Fj(SubMtxManager)27 b Fe(:)40 b Fh(DRAFT)31 b │ │ │ │ │ -Fe(F)-8 b(ebruary)30 b(8,)h(2025)p 2981 100 V 111 399 │ │ │ │ │ -a Fk(3.)46 b Fj(void)h(SubMtxManager_releaseLis)o(tOfO)o(bje)o(cts)41 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 938 4 v │ │ │ │ │ +1120 w Fj(SubMtxManager)27 b Fe(:)40 b Fh(DRAFT)31 b │ │ │ │ │ +Fe(Jan)m(uary)f(7,)h(2024)p 2962 100 V 111 399 a Fk(3.)46 │ │ │ │ │ +b Fj(void)h(SubMtxManager_releaseLis)o(tOfO)o(bje)o(cts)41 │ │ │ │ │ b(\()48 b(SubMtxManager)c(*manager,)h(SubMtx)h(*first)g(\))i(;)227 │ │ │ │ │ 549 y Fk(This)35 b(metho)s(d)g(releases)h(a)g(list)g(of)f │ │ │ │ │ Fj(SubMtx)f Fk(ob)5 b(jects)36 b(whose)f(head)g(is)g │ │ │ │ │ Fj(first)p Fk(,)h(either)f(free'ing)h(them)g(\(if)227 │ │ │ │ │ 662 y Fj(mode)47 b(=)g(0)p Fk(\),)31 b(or)f(returning)g(them)g(to)h │ │ │ │ │ (the)g(free)f(list)h(\(if)g Fj(mode)47 b(=)g(1)p Fk(\).)227 │ │ │ │ │ 812 y Fh(Err)-5 b(or)32 b(che)-5 b(cking:)39 b Fk(If)28 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -27,15 +27,15 @@ │ │ │ │ │ │ with sufficient work space, and returns a pointer to the object. When a SubMtx object is no longer │ │ │ │ │ │ necessary, it is released to the manager object, which then inserts it into the free list. A list of │ │ │ │ │ │ SubMtx objects can be released in one call. │ │ │ │ │ │ One can specify whether the object is to be locked via a mutual exclusion lock. This is not │ │ │ │ │ │ necessary for a serial or MPI factorization or solve (where there is one SubMtxManager object for │ │ │ │ │ │ each processor), but it is necessary for in a multithreaded environment. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 SubMtxManager : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 SubMtxManager : DRAFT January 7, 2024 │ │ │ │ │ │ Eachmanagerobjectkeepstrackofcertainstatistics, bytesintheirworkspaces, thetotal number │ │ │ │ │ │ of bytes requested, the number of requests for a SubMtx objects, the number of releases, and the │ │ │ │ │ │ number of locks and unlocks. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ The SubMtxManager structure has the following fields. │ │ │ │ │ │ • SubMtx *head : head of the free list of SubMtx objects. │ │ │ │ │ │ • Lock *lock : mutual exclusion lock. │ │ │ │ │ │ @@ -55,15 +55,15 @@ │ │ │ │ │ │ SubMtxManager object. │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. SubMtxManager * SubMtxManager_new ( void ) ; │ │ │ │ │ │ This method simply allocates storage for the SubMtxManager structure and then sets the │ │ │ │ │ │ default fields by a call to SubMtxManager setDefaultFields(). │ │ │ │ │ │ - SubMtxManager : DRAFT February 8, 2025 3 │ │ │ │ │ │ + SubMtxManager : DRAFT January 7, 2024 3 │ │ │ │ │ │ 2. void SubMtxManager_setDefaultFields ( SubMtxManager *manager ) ; │ │ │ │ │ │ Thestructure’sfieldsaresettodefaultvalues: mode,nactive,nbytesactive,nbytesrequested, │ │ │ │ │ │ nbytesalloc, nrequests, nreleases, nlocks and nunlocks are set to zero, and head and │ │ │ │ │ │ lock are set to NULL . │ │ │ │ │ │ Error checking: If manager is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. void SubMtxManager_clearData ( SubMtxManager *manager ) ; │ │ │ │ │ │ This method clears the object and free’s any owned data by calling SubMtx free() for each │ │ │ │ │ │ @@ -89,15 +89,15 @@ │ │ │ │ │ │ its workspace. │ │ │ │ │ │ Error checking: If manager is NULL, or if nbytesNeeded ≤ 0, an error message is printed and │ │ │ │ │ │ zero is returned. │ │ │ │ │ │ 2. void SubMtxManager_releaseObject ( SubMtxManager *manager, SubMtx *mtx ) ; │ │ │ │ │ │ This method releases the mtx instance, either free’ing it (if mode = 0), or returning it to the │ │ │ │ │ │ free list (if mode = 1). │ │ │ │ │ │ Error checking: If manager or mtx is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - 4 SubMtxManager : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 SubMtxManager : DRAFT January 7, 2024 │ │ │ │ │ │ 3. void SubMtxManager_releaseListOfObjects ( SubMtxManager *manager, SubMtx *first ) ; │ │ │ │ │ │ This method releases a list of SubMtx objects whose head is first, either free’ing them (if │ │ │ │ │ │ mode = 0), or returning them to the free list (if mode = 1). │ │ │ │ │ │ Error checking: If manager or head is NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 1.2.4 IO methods │ │ │ │ │ │ 1. void SubMtxManager_writeForHumanEye ( SubMtxManager *manager, FILE *fp ) ; │ │ │ │ │ │ This method writes a SubMtxManager object to a file in an easily readable format. │ │ │ ├── ./usr/share/doc/spooles-doc/SymbFac.ps.gz │ │ │ │ ├── SymbFac.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o SymbFac.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -1007,21 +1007,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -1205,88 +1204,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3968,16 +3962,16 @@ │ │ │ │ │ FFFE000FFFFFFC0007FFFFF80003FFFFF00000FFFFC000003FFF0000000FFC000022227B │ │ │ │ │ A72D>136 D E │ │ │ │ │ /Fa load 0 Fa currentfont 91.25 scalefont put/FMat X/FBB │ │ │ │ │ X/IEn X │ │ │ │ │ %EndDVIPSBitmapFont │ │ │ │ │ /Fb 133[50 59 4[44 44 46 2[56 62 93 31 2[31 62 1[34 51 │ │ │ │ │ 62 50 62 54 13[62 32[56 56 2[31 46[{}21 99.6264 /CMBX12 │ │ │ │ │ -rf /Fc 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 │ │ │ │ │ -2[45 2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf /Fd 134[62 │ │ │ │ │ +rf /Fc 134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 │ │ │ │ │ +1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf /Fd 134[62 │ │ │ │ │ 11[62 9[62 62 62 13[62 12[62 70[{}7 119.552 /CMTT12 rf │ │ │ │ │ /Fe 134[71 2[71 75 52 53 55 1[75 67 75 112 3[37 75 67 │ │ │ │ │ 41 61 75 60 1[65 13[75 2[92 11[103 16[67 67 67 2[37 46[{}25 │ │ │ │ │ 119.552 /CMBX12 rf /Ff 171[73 4[79 82 8[69 10[29 58[{}5 │ │ │ │ │ 90.9091 /CMBX10 rf /Fg 164[61 36[0 53[71{}3 90.9091 /CMSY10 │ │ │ │ │ rf /Fh 181[50 7[69 68 48 3[71 32[52 27[{}6 90.9091 /CMMI10 │ │ │ │ │ rf /Fi 137[42 49 30 37 38 1[46 46 51 2[42 1[28 46 42 │ │ │ │ │ @@ -4065,22 +4059,21 @@ │ │ │ │ │ (ciated)g(with)g(the)f Fj(SymbFac)f Fk(ob)5 b(ject.)0 │ │ │ │ │ 5073 y Fe(1.2)135 b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g │ │ │ │ │ Fd(SymbFac)d Fe(metho)t(ds)0 5294 y Fk(This)f(section)j(con)m(tains)f │ │ │ │ │ (brief)f(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h │ │ │ │ │ (metho)s(ds)f(that)h(b)s(elong)f(to)h(the)0 5407 y Fj(SymbFac)28 │ │ │ │ │ b Fk(ob)5 b(ject.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1062 4 v │ │ │ │ │ -1244 w Fj(SymbFac)28 b Fc(:)41 b Fi(DRAFT)30 b Fc(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2838 100 V 0 399 a Fb(1.2.1)112 │ │ │ │ │ -b(Sym)m(b)s(olic)39 b(factorization)f(metho)s(ds)111 │ │ │ │ │ -596 y Fk(1.)46 b Fj(IVL)h(*)h(SymbFac_initFromGraph)42 │ │ │ │ │ -b(\()47 b(ETree)f(*etree,)g(Graph)h(*graph)f(\))h(;)227 │ │ │ │ │ -748 y Fk(This)33 b(sym)m(b)s(olic)h(factorization)i(metho)s(d)d(tak)m │ │ │ │ │ -(es)i(a)f Fj(Graph)e Fk(ob)5 b(ject)34 b(as)g(input.)49 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1081 4 v │ │ │ │ │ +1263 w Fj(SymbFac)29 b Fc(:)40 b Fi(DRAFT)30 b Fc(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2819 100 V 0 399 a Fb(1.2.1)112 b(Sym)m(b)s(olic)39 │ │ │ │ │ +b(factorization)f(metho)s(ds)111 596 y Fk(1.)46 b Fj(IVL)h(*)h │ │ │ │ │ +(SymbFac_initFromGraph)42 b(\()47 b(ETree)f(*etree,)g(Graph)h(*graph)f │ │ │ │ │ +(\))h(;)227 748 y Fk(This)33 b(sym)m(b)s(olic)h(factorization)i(metho)s │ │ │ │ │ +(d)d(tak)m(es)i(a)f Fj(Graph)e Fk(ob)5 b(ject)34 b(as)g(input.)49 │ │ │ │ │ b(This)33 b(metho)s(d)g(constructs)227 861 y(an)e Fj(IVL)f │ │ │ │ │ Fk(ob)5 b(ject)32 b(that)f(con)m(tains)h(one)g(list)f(p)s(er)f(fron)m │ │ │ │ │ (t.)42 b(List)31 b Fj(ilist)f Fk(con)m(tains)i(the)f(in)m(ternal)h(and) │ │ │ │ │ e(external)227 974 y(v)m(ertices)25 b(for)d(fron)m(t)h │ │ │ │ │ Fj(ilist)p Fk(.)36 b(If)22 b(the)h(input)f Fj(graph)f │ │ │ │ │ Fk(is)h(a)h(compressed)g(graph,)g(then)g(the)f(lists)i(of)e(compressed) │ │ │ │ │ 227 1087 y(v)m(ertices)39 b(mak)m(e)g(little)g(sense;)i(they)d(m)m(ust) │ │ │ │ │ @@ -4160,17 +4153,17 @@ │ │ │ │ │ b(is)h(optionally)h(written)f(out)g(to)g Fj(outETreeFile)p │ │ │ │ │ Fk(.)35 b(The)22 b(old-to-new)i Fj(IV)e Fk(ob)5 b(ject)23 │ │ │ │ │ b(is)g(optionally)h(written)227 5294 y(to)32 b Fj(outIVfile)p │ │ │ │ │ Fk(.)40 b(The)31 b Fj(IVL)f Fk(ob)5 b(ject)32 b(that)g(con)m(tains)g │ │ │ │ │ (the)f(sym)m(b)s(olic)h(factorization)h(is)e(optionally)i(written)227 │ │ │ │ │ 5407 y(to)e Fj(outIVLfile)p Fk(.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1062 4 v 1244 100 a Fj(SymbFac)28 │ │ │ │ │ -b Fc(:)41 b Fi(DRAFT)121 b Fc(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2791 100 V 1062 w Fk(3)337 399 y Fa(\210)45 b Fk(The)30 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1081 4 v 1263 100 a Fj(SymbFac)28 │ │ │ │ │ +b Fc(:)41 b Fi(DRAFT)121 b Fc(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2772 100 V 1081 w Fk(3)337 399 y Fa(\210)45 b Fk(The)30 │ │ │ │ │ b Fj(msglvl)f Fk(parameter)i(determines)f(the)h(amoun)m(t)f(of)h │ │ │ │ │ (output.)337 557 y Fa(\210)45 b Fk(The)33 b Fj(msgFile)e │ │ │ │ │ Fk(parameter)j(determines)f(the)h(message)g(\014le)f(|)h(if)f │ │ │ │ │ Fj(msgFile)e Fk(is)i Fj(stdout)p Fk(,)g(then)g(the)427 │ │ │ │ │ 670 y(message)27 b(\014le)f(is)g Fi(stdout)p Fk(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Fi(app)-5 b(end)28 │ │ │ │ │ b Fk(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 783 │ │ │ │ │ @@ -4251,21 +4244,21 @@ │ │ │ │ │ (input)e(\014le)i(for)f(the)g Fj(Graph)f Fk(ob)5 b(ject.)39 │ │ │ │ │ b(It)24 b(m)m(ust)f(b)s(e)f(of)i(the)f(form)427 5294 │ │ │ │ │ y Fj(*.graphf)18 b Fk(or)j Fj(*.graphb)p Fk(.)35 b(The)19 │ │ │ │ │ b Fj(Graph)g Fk(ob)5 b(ject)21 b(is)g(read)f(from)g(the)g(\014le)h(via) │ │ │ │ │ f(the)h Fj(Graph)p 3368 5294 V 33 w(readFromFile\(\))427 │ │ │ │ │ 5407 y Fk(metho)s(d.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1062 4 v │ │ │ │ │ -1244 w Fj(SymbFac)28 b Fc(:)41 b Fi(DRAFT)30 b Fc(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2838 100 V 337 399 a Fa(\210)45 │ │ │ │ │ -b Fk(The)24 b Fj(outETreeFile)d Fk(parameter)k(is)f(the)h(output)f │ │ │ │ │ -(\014le)g(for)g(the)h Fj(ETree)d Fk(ob)5 b(ject.)40 b(If)24 │ │ │ │ │ -b Fj(outETreeFile)d Fk(is)427 511 y Fj(none)g Fk(then)h(the)g │ │ │ │ │ -Fj(ETree)f Fk(ob)5 b(ject)22 b(is)g(not)h(written)f(to)g(a)h(\014le.)38 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1081 4 v │ │ │ │ │ +1263 w Fj(SymbFac)29 b Fc(:)40 b Fi(DRAFT)30 b Fc(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2819 100 V 337 399 a Fa(\210)45 b Fk(The)24 b │ │ │ │ │ +Fj(outETreeFile)d Fk(parameter)k(is)f(the)h(output)f(\014le)g(for)g │ │ │ │ │ +(the)h Fj(ETree)d Fk(ob)5 b(ject.)40 b(If)24 b Fj(outETreeFile)d │ │ │ │ │ +Fk(is)427 511 y Fj(none)g Fk(then)h(the)g Fj(ETree)f │ │ │ │ │ +Fk(ob)5 b(ject)22 b(is)g(not)h(written)f(to)g(a)h(\014le.)38 │ │ │ │ │ b(Otherwise,)23 b(the)g Fj(ETree)p 3253 511 29 4 v 33 │ │ │ │ │ w(writeToFile\(\))427 624 y Fk(metho)s(d)30 b(is)h(called)h(to)f(write) │ │ │ │ │ g(the)g(ob)5 b(ject)31 b(to)h(a)f(formatted)g(\014le)g(\(if)g │ │ │ │ │ Fj(outETreeFile)c Fk(is)k(of)g(the)f(form)427 737 y Fj(*.etreef)p │ │ │ │ │ Fk(\),)f(or)h(a)h(binary)f(\014le)g(\(if)h Fj(outETreeFile)c │ │ │ │ │ Fk(is)j(of)h(the)f(form)g Fj(*.etreeb)p Fk(\).)337 883 │ │ │ │ │ y Fa(\210)45 b Fk(The)h Fj(outIVfile)f Fk(parameter)i(is)g(the)f │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -22,15 +22,15 @@ │ │ │ │ │ │ to have chevron coordinate type and storage mode must be by vectors. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ There is no struct or data associated with the SymbFac object. │ │ │ │ │ │ 1.2 Prototypes and descriptions of SymbFac methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ SymbFac object. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 SymbFac : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 SymbFac : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.1 Symbolic factorization methods │ │ │ │ │ │ 1. IVL * SymbFac_initFromGraph ( ETree *etree, Graph *graph ) ; │ │ │ │ │ │ This symbolic factorization method takes a Graph object as input. This method constructs │ │ │ │ │ │ an IVL object that contains one list per front. List ilist contains the internal and external │ │ │ │ │ │ vertices for front ilist. If the input graph is a compressed graph, then the lists of compressed │ │ │ │ │ │ vertices make little sense; they must be converted to original vertices. To do this, see the │ │ │ │ │ │ IVL expand() method. The nodwghtsIV and bndwghtsIV objects for the ETree object are │ │ │ │ │ │ @@ -61,15 +61,15 @@ │ │ │ │ │ │ 1. testSymbFacInpMtx msglvl msgFile inETreeFile inDInpMtxFile │ │ │ │ │ │ outETreeFile outIVfile outIVLfile │ │ │ │ │ │ This driver program reads in an ETree object and a InpMtx object and computes the symbolic │ │ │ │ │ │ factorization. The ETree object is updated (the front sizes and boundary sizes may change) │ │ │ │ │ │ andisoptionally written out to outETreeFile. The old-to-new IV object is optionally written │ │ │ │ │ │ to outIVfile. The IVL object that contains the symbolic factorization is optionally written │ │ │ │ │ │ to outIVLfile. │ │ │ │ │ │ - SymbFac : DRAFT February 8, 2025 3 │ │ │ │ │ │ + SymbFac : DRAFT January 7, 2024 3 │ │ │ │ │ │ • The msglvl parameter determines the amount of output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • TheinETreeFileparameteristheinputfilefortheETreeobject. It mustbeof theform │ │ │ │ │ │ *.etreefor*.etreeb. TheETreeobjectisreadfromthefileviatheETree readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ @@ -101,15 +101,15 @@ │ │ │ │ │ │ data. │ │ │ │ │ │ • TheinETreeFileparameteristheinputfilefortheETreeobject. It mustbeof theform │ │ │ │ │ │ *.etreefor*.etreeb. TheETreeobjectisreadfromthefileviatheETree readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • TheinGraphFileparameteristheinputfilefortheGraphobject. It mustbeof theform │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ - 4 SymbFac : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 SymbFac : DRAFT January 7, 2024 │ │ │ │ │ │ • TheoutETreeFileparameter is the output file for the ETree object. If outETreeFileis │ │ │ │ │ │ nonethentheETreeobjectisnotwrittentoafile. Otherwise,theETree writeToFile() │ │ │ │ │ │ method is called to write the object to a formatted file (if outETreeFile is of the form │ │ │ │ │ │ *.etreef), or a binary file (if outETreeFile is of the form *.etreeb). │ │ │ │ │ │ • The outIVfile parameter is the output file for the vertex-to-front map IV object. │ │ │ │ │ │ If outIVfile is none then the IV object is not written to a file. Otherwise, the │ │ │ │ │ │ IV writeToFile()methodis called to write the object to a formatted file (if outIVfile │ │ │ ├── ./usr/share/doc/spooles-doc/Tree.ps.gz │ │ │ │ ├── Tree.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Tree.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2228,21 +2228,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2426,88 +2425,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4953,15 +4947,15 @@ │ │ │ │ │ rf /Fb 146[62 3[24 105[{}2 66.4176 /CMMI8 rf /Fc 206[35 │ │ │ │ │ 5[55 43[{}2 66.4176 /CMR8 rf /Fd 152[45 45 81[71 20[{}3 │ │ │ │ │ 90.9091 /CMSY10 rf /Fe 133[50 59 1[81 1[62 44 44 46 1[62 │ │ │ │ │ 56 62 93 31 2[31 62 56 1[51 62 50 1[54 11[86 4[77 84 │ │ │ │ │ 1[106 2[58 42 4[86 81 80 8[56 56 56 56 56 56 56 56 56 │ │ │ │ │ 56 1[31 33[62 12[{}40 99.6264 /CMBX12 rf /Ff 141[62 12[62 │ │ │ │ │ 16[62 84[{}3 119.552 /CMTT12 rf /Fg 134[48 3[51 2[36 │ │ │ │ │ -12[40 2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 │ │ │ │ │ +3[51 12[45 22[47 15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 │ │ │ │ │ 90.9091 /CMSL10 rf /Fh 134[45 52 1[44 7[55 80 3[31 42[71 │ │ │ │ │ 1[71 25 25 58[{}10 90.9091 /CMMI10 rf │ │ │ │ │ %DVIPSBitmapFont: Fi tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ @@ -5084,29 +5078,29 @@ │ │ │ │ │ b(>)f Fn(0)31 b(then)f(w)m(e)h(assume)f(that)h(the)f(structure)0 │ │ │ │ │ 5294 y(w)m(as)e(in)m(tialized)i(correctly)f(and)e(that)h(the)g │ │ │ │ │ Fm(par)p Fn(,)g Fm(fch)f Fn(and)g Fm(sib)f Fn(\014elds)i(p)s(oin)m(t)f │ │ │ │ │ (to)i(storage)g(that)f(w)m(as)g(allo)s(cated)i(b)m(y)0 │ │ │ │ │ 5407 y(the)h(initializer)h(metho)s(d.)1927 5656 y(1)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fn(2)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 0 399 a Fj(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ -b(and)f(descriptions)g(of)g Ff(Tree)e Fj(metho)t(ds)0 │ │ │ │ │ -628 y Fn(This)25 b(section)h(con)m(tains)h(brief)e(descriptions)h │ │ │ │ │ -(including)f(protot)m(yp)s(es)h(of)f(all)i(metho)s(ds)d(that)j(b)s │ │ │ │ │ -(elong)e(to)h(the)g Fm(Tree)0 741 y Fn(ob)5 b(ject.)0 │ │ │ │ │ -1013 y Fe(1.2.1)112 b(Basic)38 b(metho)s(ds)0 1210 y │ │ │ │ │ -Fn(As)d(usual,)h(there)f(are)g(four)f(basic)h(metho)s(ds)g(to)g(supp)s │ │ │ │ │ -(ort)e(ob)5 b(ject)36 b(creation,)i(setting)e(default)f(\014elds,)h │ │ │ │ │ -(clearing)0 1323 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h │ │ │ │ │ -(the)g(ob)5 b(ject.)111 1564 y(1.)46 b Fm(Tree)h(*)g(Tree_new)f(\()h │ │ │ │ │ -(void)g(\))g(;)227 1716 y Fn(This)32 b(metho)s(d)f(simply)h(allo)s │ │ │ │ │ -(cates)i(storage)g(for)e(the)g Fm(Tree)f Fn(structure)h(and)f(then)h │ │ │ │ │ -(sets)h(the)f(default)g(\014elds)227 1828 y(b)m(y)f(a)f(call)i(to)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 0 399 a Fj(1.2)135 b(Protot)l(yp)t(es)46 b(and)f │ │ │ │ │ +(descriptions)g(of)g Ff(Tree)e Fj(metho)t(ds)0 628 y │ │ │ │ │ +Fn(This)25 b(section)h(con)m(tains)h(brief)e(descriptions)h(including)f │ │ │ │ │ +(protot)m(yp)s(es)h(of)f(all)i(metho)s(ds)d(that)j(b)s(elong)e(to)h │ │ │ │ │ +(the)g Fm(Tree)0 741 y Fn(ob)5 b(ject.)0 1013 y Fe(1.2.1)112 │ │ │ │ │ +b(Basic)38 b(metho)s(ds)0 1210 y Fn(As)d(usual,)h(there)f(are)g(four)f │ │ │ │ │ +(basic)h(metho)s(ds)g(to)g(supp)s(ort)e(ob)5 b(ject)36 │ │ │ │ │ +b(creation,)i(setting)e(default)f(\014elds,)h(clearing)0 │ │ │ │ │ +1323 y(an)m(y)31 b(allo)s(cated)h(data,)f(and)f(free'ing)h(the)g(ob)5 │ │ │ │ │ +b(ject.)111 1564 y(1.)46 b Fm(Tree)h(*)g(Tree_new)f(\()h(void)g(\))g(;) │ │ │ │ │ +227 1716 y Fn(This)32 b(metho)s(d)f(simply)h(allo)s(cates)i(storage)g │ │ │ │ │ +(for)e(the)g Fm(Tree)f Fn(structure)h(and)f(then)h(sets)h(the)f │ │ │ │ │ +(default)g(\014elds)227 1828 y(b)m(y)f(a)f(call)i(to)f │ │ │ │ │ Fm(Tree)p 905 1828 29 4 v 33 w(setDefaultFields\(\))p │ │ │ │ │ Fn(.)111 2019 y(2.)46 b Fm(void)h(Tree_setDefaultFields)42 │ │ │ │ │ b(\()47 b(Tree)g(*tree)f(\))i(;)227 2170 y Fn(This)31 │ │ │ │ │ b(metho)s(d)g(sets)h(the)g(structure's)f(\014elds)h(to)g(default)g(v)-5 │ │ │ │ │ b(alues:)43 b Fm(n)32 b Fn(is)g(zero,)h Fm(root)d Fn(is)i │ │ │ │ │ Fm(-1)p Fn(,)f(and)g Fm(par)p Fn(,)h Fm(fch)227 2283 │ │ │ │ │ y Fn(and)e Fm(sib)g Fn(are)g(all)i Fm(NULL)p Fn(.)227 │ │ │ │ │ @@ -5143,17 +5137,17 @@ │ │ │ │ │ y(3.)46 b Fm(int)h(*)h(Tree_par)d(\()j(Tree)e(*tree)h(\))g(;)227 │ │ │ │ │ 5256 y Fn(This)30 b(metho)s(d)g(returns)f(a)i(p)s(oin)m(ter)f(to)h(the) │ │ │ │ │ g(paren)m(t)f(v)m(ector.)227 5407 y Fl(Err)-5 b(or)34 │ │ │ │ │ b(che)-5 b(cking:)40 b Fn(If)30 b Fm(tree)g Fn(is)g Fm(NULL)p │ │ │ │ │ Fn(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ (exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1134 4 v 1315 100 a Fm(Tree)29 │ │ │ │ │ -b Fg(:)41 b Fl(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fn(3)111 399 y(4.)46 b Fm(int)h(*)h(Tree_fch)d(\()j │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1153 4 v 1334 100 a Fm(Tree)29 │ │ │ │ │ +b Fg(:)41 b Fl(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fn(3)111 399 y(4.)46 b Fm(int)h(*)h(Tree_fch)d(\()j │ │ │ │ │ (Tree)e(*tree)h(\))g(;)227 548 y Fn(This)30 b(metho)s(d)g(returns)f(a)i │ │ │ │ │ (p)s(oin)m(ter)f(to)h(the)g(\014rst)e(c)m(hild)i(v)m(ector.)227 │ │ │ │ │ 698 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ b Fm(tree)g Fn(is)g Fm(NULL)p Fn(,)f(an)i(error)f(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)f(the)i(program)f(exits.)111 885 y(5.)46 b │ │ │ │ │ Fm(int)h(*)h(Tree_sib)d(\()j(Tree)e(*tree)h(\))g(;)227 │ │ │ │ │ 1035 y Fn(This)30 b(metho)s(d)g(returns)f(a)i(p)s(oin)m(ter)f(to)h(the) │ │ │ │ │ @@ -5211,28 +5205,27 @@ │ │ │ │ │ 4996 y Fl(R)-5 b(eturn)34 b(c)-5 b(o)g(des:)1030 5193 │ │ │ │ │ y Fn(1)100 b(normal)31 b(return)1000 5306 y(-1)100 b │ │ │ │ │ Fm(subtree)29 b Fn(is)h Fm(NULL)1000 5419 y Fn(-2)100 │ │ │ │ │ b Fm(nodeidsIV)28 b Fn(is)i Fm(NULL)2138 5250 y Fn(-3)101 │ │ │ │ │ b Fm(tree)29 b Fn(is)h Fm(NULL)2138 5363 y Fn(-4)101 │ │ │ │ │ b Fm(nodeidsIV)27 b Fn(is)k(in)m(v)-5 b(alid)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fn(4)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 111 399 a Fn(5.)46 b Fm(void)h │ │ │ │ │ -(Tree_setFchSibRoot)c(\()k(Tree)g(*tree)f(\))i(;)227 │ │ │ │ │ -553 y Fn(The)25 b(ro)s(ot)g(and)f(the)h(en)m(tries)h(in)e(the)h │ │ │ │ │ -Fm(fch[])e Fn(and)i Fm(sib[])e Fn(v)m(ectors)j(are)g(set)f(using)f(the) │ │ │ │ │ -h(en)m(tries)h(in)e(the)h Fm(par[])227 666 y Fn(v)m(ector.)227 │ │ │ │ │ -821 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ -b Fm(tree)g Fn(is)g Fm(NULL)p Fn(,)f(an)i(error)f(message)h(is)g(prin)m │ │ │ │ │ -(ted)f(and)f(the)i(program)f(exits.)111 1017 y(6.)46 │ │ │ │ │ -b Fm(void)h(Tree_setRoot)d(\()k(Tree)e(*tree)h(\))g(;)227 │ │ │ │ │ -1172 y Fn(The)28 b(v)m(ertices)i(that)f(are)g(ro)s(ots)g(in)f(the)h │ │ │ │ │ -(tree)g(are)g(link)m(ed)g(b)m(y)f(their)g Fm(sib[])g │ │ │ │ │ -Fn(\014eld)g(and)f(the)i(ro)s(ot)g(of)g(the)f(tree)227 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 111 399 a Fn(5.)46 b Fm(void)h(Tree_setFchSibRoot)c(\()k │ │ │ │ │ +(Tree)g(*tree)f(\))i(;)227 553 y Fn(The)25 b(ro)s(ot)g(and)f(the)h(en)m │ │ │ │ │ +(tries)h(in)e(the)h Fm(fch[])e Fn(and)i Fm(sib[])e Fn(v)m(ectors)j(are) │ │ │ │ │ +g(set)f(using)f(the)h(en)m(tries)h(in)e(the)h Fm(par[])227 │ │ │ │ │ +666 y Fn(v)m(ector.)227 821 y Fl(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +b(cking:)40 b Fn(If)30 b Fm(tree)g Fn(is)g Fm(NULL)p │ │ │ │ │ +Fn(,)f(an)i(error)f(message)h(is)g(prin)m(ted)f(and)f(the)i(program)f │ │ │ │ │ +(exits.)111 1017 y(6.)46 b Fm(void)h(Tree_setRoot)d(\()k(Tree)e(*tree)h │ │ │ │ │ +(\))g(;)227 1172 y Fn(The)28 b(v)m(ertices)i(that)f(are)g(ro)s(ots)g │ │ │ │ │ +(in)f(the)h(tree)g(are)g(link)m(ed)g(b)m(y)f(their)g │ │ │ │ │ +Fm(sib[])g Fn(\014eld)g(and)f(the)i(ro)s(ot)g(of)g(the)f(tree)227 │ │ │ │ │ 1285 y(is)j(set)g(to)g(the)f(head)g(of)h(the)g(list.)227 │ │ │ │ │ 1440 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ b Fm(tree)g Fn(is)g Fm(NULL)p Fn(,)f(an)i(error)f(message)h(is)g(prin)m │ │ │ │ │ (ted)f(and)f(the)i(program)f(exits.)0 1721 y Fe(1.2.4)112 │ │ │ │ │ b(Utilit)m(y)38 b(metho)s(ds)0 1922 y Fn(The)33 b(utilit)m(y)i(metho)s │ │ │ │ │ (ds)e(return)f(the)i(n)m(um)m(b)s(er)e(of)i(b)m(ytes)g(tak)m(en)h(b)m │ │ │ │ │ (y)e(the)h(ob)5 b(ject,)35 b(aid)f(in)f(p)s(erforming)g(pre-order)0 │ │ │ │ │ @@ -5277,17 +5270,17 @@ │ │ │ │ │ (tra)m(v)m(ersal.)227 5294 y Fl(Err)-5 b(or)37 b(che)-5 │ │ │ │ │ b(cking:)47 b Fn(If)33 b Fm(tree)f Fn(is)i Fm(NULL)p │ │ │ │ │ Fn(,)e(or)i(if)f Fm(tree->n)46 b(<)i(1)p Fn(,)34 b(or)f │ │ │ │ │ Fm(v)g Fn(is)h(not)g(in)f Fm([0,tree->n-1])p Fn(,)e(an)i(error)227 │ │ │ │ │ 5407 y(message)f(is)e(prin)m(ted)g(and)g(the)g(program)h(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1134 4 v 1315 100 a Fm(Tree)29 │ │ │ │ │ -b Fg(:)41 b Fl(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fn(5)111 399 y(6.)46 b Fm(int)h(Tree_nleaves)e(\()i │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1153 4 v 1334 100 a Fm(Tree)29 │ │ │ │ │ +b Fg(:)41 b Fl(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fn(5)111 399 y(6.)46 b Fm(int)h(Tree_nleaves)e(\()i │ │ │ │ │ (Tree)g(*tree)f(\))i(;)227 569 y Fn(This)30 b(metho)s(d)g(returns)f │ │ │ │ │ (the)h(n)m(um)m(b)s(er)f(of)i(lea)m(v)m(es)i(of)d(the)h(tree.)227 │ │ │ │ │ 740 y Fl(Err)-5 b(or)45 b(che)-5 b(cking:)64 b Fn(If)41 │ │ │ │ │ b Fm(tree)g Fn(is)h Fm(NULL)p Fn(,)f(or)h(if)h Fm(tree->n)i(<)j(1)p │ │ │ │ │ Fn(,)d(an)d(error)f(message)j(is)e(prin)m(ted)f(and)h(the)227 │ │ │ │ │ 853 y(program)30 b(exits.)111 1082 y(7.)46 b Fm(int)h(Tree_nroots)e(\() │ │ │ │ │ i(Tree)g(*tree)f(\))i(;)227 1253 y Fn(This)30 b(metho)s(d)g(returns)f │ │ │ │ │ @@ -5336,27 +5329,27 @@ │ │ │ │ │ 5123 y(main/Sc)m(h)m(ur)30 b(complemen)m(t)i(partition)f(for)f(a)h │ │ │ │ │ (semi-implicit)h(factorization.)227 5294 y Fl(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)41 b Fn(If)30 b Fm(tree)p Fn(,)g │ │ │ │ │ Fm(gainIV)f Fn(or)h Fm(ptotalgain)e Fn(is)j Fm(NULL)p │ │ │ │ │ Fn(,)f(an)g(error)g(message)i(is)f(prin)m(ted)f(and)g(the)227 │ │ │ │ │ 5407 y(program)g(exits.)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fn(6)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 0 399 a Fe(1.2.5)112 b(Metrics)38 │ │ │ │ │ -b(metho)s(ds)0 595 y Fn(Man)m(y)24 b(op)s(erations)h(need)e(to)i(kno)m │ │ │ │ │ -(w)e(some)i Fl(metric)f Fn(de\014ned)e(on)i(the)g(no)s(des)f(in)g(a)h │ │ │ │ │ -(tree.)40 b(Here)24 b(are)g(three)g(examples:)0 708 y(the)39 │ │ │ │ │ -b(heigh)m(t)h(of)f(a)g(no)s(de)f(\(the)i(minim)m(um)e(distance)h(from)g │ │ │ │ │ -(a)g(descendan)m(t)g(leaf)7 b(\),)43 b(the)c(depth)f(of)h(a)g(no)s(de)f │ │ │ │ │ -(\(the)0 821 y(distance)j(from)e(its)h(ro)s(ot)g(ancestor\),)k(or)c │ │ │ │ │ -(the)g(w)m(eigh)m(t)h(asso)s(ciated)h(with)d(a)i(subtree)e(ro)s(oted)h │ │ │ │ │ -(at)h(a)f(no)s(de.)69 b(Of)0 934 y(course,)30 b(a)g(w)m(eigh)m(t)h │ │ │ │ │ -(could)e(b)s(e)g(asso)s(ciated)i(with)e(eac)m(h)i(no)s(de,)e(so)h(the)g │ │ │ │ │ -(heigh)m(t)g(or)g(depth)e(b)s(ecomes)i(the)g(w)m(eigh)m(t)h(of)0 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 0 399 a Fe(1.2.5)112 b(Metrics)38 b(metho)s(ds)0 │ │ │ │ │ +595 y Fn(Man)m(y)24 b(op)s(erations)h(need)e(to)i(kno)m(w)e(some)i │ │ │ │ │ +Fl(metric)f Fn(de\014ned)e(on)i(the)g(no)s(des)f(in)g(a)h(tree.)40 │ │ │ │ │ +b(Here)24 b(are)g(three)g(examples:)0 708 y(the)39 b(heigh)m(t)h(of)f │ │ │ │ │ +(a)g(no)s(de)f(\(the)i(minim)m(um)e(distance)h(from)g(a)g(descendan)m │ │ │ │ │ +(t)g(leaf)7 b(\),)43 b(the)c(depth)f(of)h(a)g(no)s(de)f(\(the)0 │ │ │ │ │ +821 y(distance)j(from)e(its)h(ro)s(ot)g(ancestor\),)k(or)c(the)g(w)m │ │ │ │ │ +(eigh)m(t)h(asso)s(ciated)h(with)d(a)i(subtree)e(ro)s(oted)h(at)h(a)f │ │ │ │ │ +(no)s(de.)69 b(Of)0 934 y(course,)30 b(a)g(w)m(eigh)m(t)h(could)e(b)s │ │ │ │ │ +(e)g(asso)s(ciated)i(with)e(eac)m(h)i(no)s(de,)e(so)h(the)g(heigh)m(t)g │ │ │ │ │ +(or)g(depth)e(b)s(ecomes)i(the)g(w)m(eigh)m(t)h(of)0 │ │ │ │ │ 1047 y(the)g(no)s(des)e(on)h(the)h(path.)141 1185 y(Metrics)h(can)f(b)s │ │ │ │ │ (e)f Fm(int)f Fn(or)i Fm(double)p Fn(.)40 b(Because)32 │ │ │ │ │ b(of)e(the)h(limitations)i(of)d(C,)h(w)m(e)g(need)f(t)m(w)m(o)i │ │ │ │ │ (separate)g(metho)s(ds)0 1298 y(for)f(eac)m(h)i(of)f(the)g(heigh)m(t,)h │ │ │ │ │ (depth)e(and)g(subtree)g(functions.)44 b(Eac)m(h)32 b(pair)g(of)g │ │ │ │ │ (metho)s(ds)f(di\013ers)g(only)h(in)f(the)h(t)m(yp)s(e)0 │ │ │ │ │ 1410 y(of)f(the)f(v)m(ector)i(ob)5 b(ject)31 b(argumen)m(t.)111 │ │ │ │ │ @@ -5405,17 +5398,17 @@ │ │ │ │ │ 4956 y Fm(hmetric[v])45 b(=)j(vmetric[v])d(if)i(fch[v])f(==)h(-1)752 │ │ │ │ │ 5069 y(=)h(vmetric[v])d(+)i(max_{par[u])e(=)i(v})h(hmetric[par[v]])227 │ │ │ │ │ 5294 y Fl(Err)-5 b(or)47 b(che)-5 b(cking:)68 b Fn(If)44 │ │ │ │ │ b Fm(tree)f Fn(or)h Fm(vmetric)p Fd(f)p Fm(I,D)p Fd(g)p │ │ │ │ │ Fm(V)e Fn(is)i Fm(NULL)p Fn(,)g(an)g(error)g(message)h(is)f(prin)m(ted) │ │ │ │ │ g(and)g(the)227 5407 y(program)30 b(exits.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1134 4 v 1315 100 a Fm(Tree)29 │ │ │ │ │ -b Fg(:)41 b Fl(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fn(7)0 399 y Fe(1.2.6)112 b(Compression)39 │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1153 4 v 1334 100 a Fm(Tree)29 │ │ │ │ │ +b Fg(:)41 b Fl(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fn(7)0 399 y Fe(1.2.6)112 b(Compression)39 │ │ │ │ │ b(metho)s(ds)0 590 y Fn(F)-8 b(requen)m(tly)31 b(a)f(tree)g(will)g │ │ │ │ │ (need)g(to)g(b)s(e)f(compressed)g(in)h(some)g(manner.)39 │ │ │ │ │ b(Elimination)31 b(trees)f(usually)f(ha)m(v)m(e)i(long)0 │ │ │ │ │ 703 y(c)m(hains)i(of)f(no)s(des)g(at)h(the)f(higher)g(lev)m(els,)j │ │ │ │ │ (where)c(eac)m(h)j(c)m(hain)f(of)f(no)s(des)g(corresp)s(onds)e(to)j(a)g │ │ │ │ │ (sup)s(erno)s(de.)44 b(Liu's)0 816 y(generalized)27 b(ro)m(w)e(en)m(v)m │ │ │ │ │ (elop)s(e)i(metho)s(ds)d(partition)i(the)g(v)m(ertices)g(b)m(y)g │ │ │ │ │ @@ -5491,37 +5484,37 @@ │ │ │ │ │ b(.)47 b(If)32 b Fm(u)g Fn(and)g Fm(v)227 5294 y Fn(are)k(siblings,)g │ │ │ │ │ (and)f Fm(u)g Fn(comes)h(b)s(efore)f Fm(v)g Fn(in)g(a)g(p)s(ost-order)g │ │ │ │ │ (tra)m(v)m(ersal,)j(then)d(the)h(w)m(eigh)m(t)h(of)e(the)g(subtree)227 │ │ │ │ │ 5407 y(ro)s(oted)c(at)g Fm(u)f Fn(is)g(as)h(large)h(or)e(larger)h(than) │ │ │ │ │ f(the)h(w)m(eigh)m(t)h(of)e(the)h(subtree)f(ro)s(oted)g(at)h │ │ │ │ │ Fm(v)p Fn(.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fn(8)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 227 399 a Fl(Err)-5 b(or)34 │ │ │ │ │ -b(che)-5 b(cking:)40 b Fn(If)30 b Fm(tree)f Fn(or)h Fm(metricIV)e │ │ │ │ │ -Fn(is)i Fm(NULL)p Fn(,)f(or)h(if)h Fm(n)47 b(<)g(1)p │ │ │ │ │ -Fn(,)31 b(or)f(if)g Fm(n)g Fn(is)g(not)g(the)h(size)g(of)f │ │ │ │ │ -Fm(metricIV)p Fn(,)227 511 y(an)h(error)f(message)h(is)f(prin)m(ted)g │ │ │ │ │ -(and)g(the)h(program)f(exits.)0 778 y Fe(1.2.8)112 b(P)m(erm)m(utation) │ │ │ │ │ -38 b(metho)s(ds)0 973 y Fn(Often)32 b(w)m(e)h(need)f(to)h(extract)g(a)g │ │ │ │ │ -(p)s(erm)m(utation)f(from)g(a)h(tree,)g(e.g.,)i(a)d(p)s(ost-order)g │ │ │ │ │ -(tra)m(v)m(ersal)i(of)e(an)h(elimination)0 1086 y(tree)39 │ │ │ │ │ -b(giv)m(es)i(an)d(ordering)h(for)f(a)h(sparse)g(matrix.)66 │ │ │ │ │ -b(On)37 b(other)i(o)s(ccasions,)k(w)m(e)c(need)f(to)i(p)s(erm)m(ute)e │ │ │ │ │ -(a)h(tree,)j(i.e.)0 1199 y(re-lab)s(el)31 b(the)g(no)s(des.)111 │ │ │ │ │ -1429 y(1.)46 b Fm(void)h(Tree_fillNewToOldPerm)42 b(\()47 │ │ │ │ │ -b(Tree)g(*tree,)f(int)h(newToOld[])e(\))i(;)227 1542 │ │ │ │ │ -y(void)g(Tree_fillOldToNewPerm)42 b(\()47 b(Tree)g(*tree,)f(int)h │ │ │ │ │ -(oldToNew[])e(\))i(;)227 1655 y(void)g(Tree_fillBothPerms)c(\()k(Tree)g │ │ │ │ │ -(*tree,)f(int)h(newToOld[],)e(int)h(oldToNew[])f(\))j(;)227 │ │ │ │ │ -1804 y Fn(If)35 b Fm(tree)f Fn(is)h Fm(NULL)p Fn(,)g │ │ │ │ │ -Fm(tree->n)46 b(<)h(1)35 b Fn(or)g(a)h(p)s(erm)m(utation)f(v)m(ector)i │ │ │ │ │ -(is)e Fm(NULL)p Fn(,)g(an)g(error)g(message)h(is)f(prin)m(ted)227 │ │ │ │ │ -1917 y(and)29 b(the)g(program)g(exits.)41 b(Otherwise,)29 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fn(8)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 227 399 a Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +b Fn(If)30 b Fm(tree)f Fn(or)h Fm(metricIV)e Fn(is)i │ │ │ │ │ +Fm(NULL)p Fn(,)f(or)h(if)h Fm(n)47 b(<)g(1)p Fn(,)31 │ │ │ │ │ +b(or)f(if)g Fm(n)g Fn(is)g(not)g(the)h(size)g(of)f Fm(metricIV)p │ │ │ │ │ +Fn(,)227 511 y(an)h(error)f(message)h(is)f(prin)m(ted)g(and)g(the)h │ │ │ │ │ +(program)f(exits.)0 778 y Fe(1.2.8)112 b(P)m(erm)m(utation)38 │ │ │ │ │ +b(metho)s(ds)0 973 y Fn(Often)32 b(w)m(e)h(need)f(to)h(extract)g(a)g(p) │ │ │ │ │ +s(erm)m(utation)f(from)g(a)h(tree,)g(e.g.,)i(a)d(p)s(ost-order)g(tra)m │ │ │ │ │ +(v)m(ersal)i(of)e(an)h(elimination)0 1086 y(tree)39 b(giv)m(es)i(an)d │ │ │ │ │ +(ordering)h(for)f(a)h(sparse)g(matrix.)66 b(On)37 b(other)i(o)s │ │ │ │ │ +(ccasions,)k(w)m(e)c(need)f(to)i(p)s(erm)m(ute)e(a)h(tree,)j(i.e.)0 │ │ │ │ │ +1199 y(re-lab)s(el)31 b(the)g(no)s(des.)111 1429 y(1.)46 │ │ │ │ │ +b Fm(void)h(Tree_fillNewToOldPerm)42 b(\()47 b(Tree)g(*tree,)f(int)h │ │ │ │ │ +(newToOld[])e(\))i(;)227 1542 y(void)g(Tree_fillOldToNewPerm)42 │ │ │ │ │ +b(\()47 b(Tree)g(*tree,)f(int)h(oldToNew[])e(\))i(;)227 │ │ │ │ │ +1655 y(void)g(Tree_fillBothPerms)c(\()k(Tree)g(*tree,)f(int)h │ │ │ │ │ +(newToOld[],)e(int)h(oldToNew[])f(\))j(;)227 1804 y Fn(If)35 │ │ │ │ │ +b Fm(tree)f Fn(is)h Fm(NULL)p Fn(,)g Fm(tree->n)46 b(<)h(1)35 │ │ │ │ │ +b Fn(or)g(a)h(p)s(erm)m(utation)f(v)m(ector)i(is)e Fm(NULL)p │ │ │ │ │ +Fn(,)g(an)g(error)g(message)h(is)f(prin)m(ted)227 1917 │ │ │ │ │ +y(and)29 b(the)g(program)g(exits.)41 b(Otherwise,)29 │ │ │ │ │ b(the)g(p)s(erm)m(utation)h(v)m(ector\(s\))h(is)e(\(are\))h(\014lled)f │ │ │ │ │ (with)g(the)g(ordering)227 2030 y(of)i(the)f(no)s(des)g(in)g(a)h(p)s │ │ │ │ │ (ost-order)f(tra)m(v)m(ersal.)227 2179 y Fl(Err)-5 b(or)42 │ │ │ │ │ b(che)-5 b(cking:)57 b Fn(If)38 b Fm(tree)g Fn(or)h(a)g(p)s(erm)m │ │ │ │ │ (utation)g(v)m(ector)h(is)f Fm(NULL)p Fn(,)f(or)h(if)f │ │ │ │ │ Fm(n)48 b(<)f(1)p Fn(,)41 b(an)e(error)f(message)i(is)227 │ │ │ │ │ 2292 y(prin)m(ted)30 b(and)g(the)h(program)f(exits.)111 │ │ │ │ │ @@ -5562,17 +5555,17 @@ │ │ │ │ │ b(alid)2198 4858 y(-3)100 b Fm(xDV)30 b Fn(is)g Fm(NULL)2198 │ │ │ │ │ 4970 y Fn(-4)100 b Fm(yDV)30 b Fn(is)g Fm(NULL)111 5181 │ │ │ │ │ y Fn(2.)46 b Fm(int)h(Tree_drawToEPS)d(\()k(Tree)e(*tree,)g(FILE)h │ │ │ │ │ (*filename,)e(DV)i(*xDV,)f(DV)i(*yDV,)1230 5294 y(double)e(rscale,)f │ │ │ │ │ (DV)j(*radiusDV,)d(int)i(labelflag,)1230 5407 y(double)f(fontscale,)f │ │ │ │ │ (IV)i(*labelsIV,)e(double)h(bbox[],)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1134 4 v 1315 100 a Fm(Tree)29 │ │ │ │ │ -b Fg(:)41 b Fl(DRAFT)121 b Fg(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fn(9)1230 399 y Fm(double)46 b(frame[],)f(double)h │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1153 4 v 1334 100 a Fm(Tree)29 │ │ │ │ │ +b Fg(:)41 b Fl(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fn(9)1230 399 y Fm(double)46 b(frame[],)f(double)h │ │ │ │ │ (bounds[])g(\))h(;)227 557 y Fn(This)24 b(metho)s(d)f(dra)m(ws)h(a)g │ │ │ │ │ (tree.)40 b(The)23 b(co)s(ordinates)i(of)f(the)h(no)s(des)e(are)h │ │ │ │ │ (found)f(in)h(the)g Fm(xDV)f Fn(and)h Fm(yDV)f Fn(v)m(ectors.)227 │ │ │ │ │ 715 y(The)29 b(no)s(des)f(will)h(ha)m(v)m(e)i(circles)f(of)f(constan)m │ │ │ │ │ (t)i(radius)d(\(if)h Fm(radiusDV)e Fn(is)i Fm(NULL)p │ │ │ │ │ Fn(\))f(or)h(eac)m(h)i(circle)f(can)f(ha)m(v)m(e)i(a)227 │ │ │ │ │ 828 y(di\013eren)m(t)g(radius)f(found)f(in)h Fm(radiusDV)e │ │ │ │ │ @@ -5645,19 +5638,19 @@ │ │ │ │ │ b(alue)27 b Fm(1)g Fn(is)f(returned.)39 b(If)26 b(an)g(IO)h(error)f(is) │ │ │ │ │ h(encoun)m(tered)g(from)f Fm(fscanf)p Fn(,)g(zero)h(is)g(returned.)227 │ │ │ │ │ 5407 y Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 │ │ │ │ │ b Fm(tree)g Fn(or)g Fm(fp)g Fn(are)g Fm(NULL)p Fn(,)g(an)g(error)g │ │ │ │ │ (message)i(is)e(prin)m(ted)g(and)g(zero)h(is)f(returned.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fn(10)p 182 100 1111 4 │ │ │ │ │ -v 1293 w Fm(Tree)30 b Fg(:)40 b Fl(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2789 100 V 111 399 a Fn(3.)46 │ │ │ │ │ -b Fm(int)h(Tree_readFromBinaryFile)42 b(\()47 b(Tree)g(*tree,)f(FILE)g │ │ │ │ │ -(*fp)h(\))h(;)227 557 y Fn(This)32 b(metho)s(d)g(reads)g(in)h(a)g │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fn(10)p 182 100 1130 4 │ │ │ │ │ +v 1312 w Fm(Tree)30 b Fg(:)40 b Fl(DRAFT)31 b Fg(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2770 100 V 111 399 a Fn(3.)46 b Fm(int)h │ │ │ │ │ +(Tree_readFromBinaryFile)42 b(\()47 b(Tree)g(*tree,)f(FILE)g(*fp)h(\))h │ │ │ │ │ +(;)227 557 y Fn(This)32 b(metho)s(d)g(reads)g(in)h(a)g │ │ │ │ │ Fm(Perm)e Fn(ob)5 b(ject)33 b(from)f(a)h(binary)f(\014le.)48 │ │ │ │ │ b(If)32 b(there)g(are)h(no)g(errors)f(in)g(reading)h(the)227 │ │ │ │ │ 670 y(data,)f(the)e(v)-5 b(alue)31 b Fm(1)f Fn(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fm(fread)p Fn(,)f(zero)i(is)g(returned.)227 828 y Fl(Err)-5 │ │ │ │ │ b(or)34 b(che)-5 b(cking:)40 b Fn(If)30 b Fm(tree)g Fn(or)g │ │ │ │ │ Fm(fp)g Fn(are)g Fm(NULL)p Fn(,)g(an)g(error)g(message)i(is)e(prin)m │ │ │ │ │ @@ -5723,17 +5716,17 @@ │ │ │ │ │ (fontsize)227 5062 y Fn(This)29 b(driv)m(er)g(program)g(reads)g(in)f(a) │ │ │ │ │ i Fm(Tree)e Fn(\014le)h(and)g(optionally)h(a)g(tags)g │ │ │ │ │ Fm(IV)f Fn(\014le)g(and)g(creates)h(an)f(EPS)g(\014le)227 │ │ │ │ │ 5175 y(with)h(a)h(simple)f(picture)h(of)f(a)h(tree.)337 │ │ │ │ │ 5407 y Fi(\210)45 b Fn(The)30 b Fm(msglvl)f Fn(parameter)i(determines)f │ │ │ │ │ (the)h(amoun)m(t)f(of)h(output.)p eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1111 4 v 1292 100 a Fm(Tree)30 │ │ │ │ │ -b Fg(:)40 b Fl(DRAFT)121 b Fg(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2697 100 V 1111 w Fn(11)337 399 y Fi(\210)45 b Fn(The)33 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1130 4 v 1312 100 a Fm(Tree)29 │ │ │ │ │ +b Fg(:)40 b Fl(DRAFT)122 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2678 100 V 1130 w Fn(11)337 399 y Fi(\210)45 b Fn(The)33 │ │ │ │ │ b Fm(msgFile)e Fn(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ (if)f Fm(msgFile)e Fn(is)i Fm(stdout)p Fn(,)g(then)g(the)427 │ │ │ │ │ 511 y(output)c(\014le)h(is)f Fl(stdout)p Fn(,)i(otherwise)f(a)f(\014le) │ │ │ │ │ h(is)f(op)s(ened)g(with)g Fl(app)-5 b(end)31 b Fn(status)e(to)i(receiv) │ │ │ │ │ m(e)g(an)m(y)e(output)427 624 y(data.)337 770 y Fi(\210)45 │ │ │ │ │ b Fn(The)29 b Fm(inTreeFile)e Fn(parameter)j(is)g(the)f(input)g(\014le) │ │ │ │ │ g(for)h(the)f Fm(Tree)g Fn(ob)5 b(ject.)41 b(It)30 b(m)m(ust)f(b)s(e)g │ │ │ │ │ @@ -5781,24 +5774,23 @@ │ │ │ │ │ Fn(The)30 b Fm(fontsize)e Fn(parameter)j(is)g(the)f(size)h(of)g(the)f │ │ │ │ │ (fon)m(t)h(to)g(b)s(e)f(used)g(to)h(dra)m(w)f(the)g(no)s(de)g(lab)s │ │ │ │ │ (els.)227 3314 y(Use)g(the)h Fm(doDraw)d Fn(script)h(\014le)h(as)g(an)g │ │ │ │ │ (example.)41 b(F)-8 b(our)31 b(plots)f(of)g(a)g(tree)h(for)e(the)h │ │ │ │ │ Fm(R2D100)e Fn(matrix)j(ordered)227 3427 y(b)m(y)g(nested)f(dissection) │ │ │ │ │ h(are)g(found)e(b)s(elo)m(w.)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fn(12)p 182 100 1111 │ │ │ │ │ -4 v 1293 w Fm(Tree)30 b Fg(:)40 b Fl(DRAFT)30 b Fg(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2789 100 V 0 571 a Fn(Figure)38 │ │ │ │ │ -b(1.1:)56 b Fa(R2D100)p Fn(:)f(domain/separator)39 b(tree.)62 │ │ │ │ │ -b(On)37 b(the)g(left)h Fm(heightflag)45 b(=)j('H')36 │ │ │ │ │ -b Fn(and)h Fm(coordflag)45 b(=)0 684 y('C')p Fn(,)30 │ │ │ │ │ -b(on)g(the)h(righ)m(t)g Fm(heightflag)45 b(=)i('D')29 │ │ │ │ │ -b Fn(and)h Fm(coordflag)45 b(=)j('C')p Fn(.)105 2612 │ │ │ │ │ -y @beginspecial 0 @llx 0 @lly 600 @urx 600 @ury 2159 │ │ │ │ │ -@rwi 2159 @rhi @setspecial │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fn(12)p 182 100 1130 │ │ │ │ │ +4 v 1312 w Fm(Tree)30 b Fg(:)40 b Fl(DRAFT)31 b Fg(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2770 100 V 0 571 a Fn(Figure)38 b(1.1:)56 b Fa(R2D100)p │ │ │ │ │ +Fn(:)f(domain/separator)39 b(tree.)62 b(On)37 b(the)g(left)h │ │ │ │ │ +Fm(heightflag)45 b(=)j('H')36 b Fn(and)h Fm(coordflag)45 │ │ │ │ │ +b(=)0 684 y('C')p Fn(,)30 b(on)g(the)h(righ)m(t)g Fm(heightflag)45 │ │ │ │ │ +b(=)i('D')29 b Fn(and)h Fm(coordflag)45 b(=)j('C')p Fn(.)105 │ │ │ │ │ +2612 y @beginspecial 0 @llx 0 @lly 600 @urx 600 @ury │ │ │ │ │ +2159 @rwi 2159 @rhi @setspecial │ │ │ │ │ %%BeginDocument: ../../Tree/doc/R2D100HC.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0 0 600 600 │ │ │ │ │ /CSH { │ │ │ │ │ % │ │ │ │ │ % center show a string │ │ │ │ │ % │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -20,15 +20,15 @@ │ │ │ │ │ │ • int *sib : pointer to sibling vector, size n, entries in the range [-1,n-1] │ │ │ │ │ │ The user should rarely if ever change these five fields. In particular, throughout the code we │ │ │ │ │ │ assume that the Tree object was correctly initialized using one of the three initializer methods. │ │ │ │ │ │ Inside almost every method we check to ensure n > 0. If n > 0 then we assume that the structure │ │ │ │ │ │ was intialized correctly and that the par, fch and sib fields point to storage that was allocated by │ │ │ │ │ │ the initializer method. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Tree : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Tree : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2 Prototypes and descriptions of Tree methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the Tree │ │ │ │ │ │ object. │ │ │ │ │ │ 1.2.1 Basic methods │ │ │ │ │ │ As usual, there are four basic methods to support object creation, setting default fields, clearing │ │ │ │ │ │ any allocated data, and free’ing the object. │ │ │ │ │ │ 1. Tree * Tree_new ( void ) ; │ │ │ │ │ │ @@ -52,15 +52,15 @@ │ │ │ │ │ │ Error checking: If tree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 2. int Tree_root ( Tree *tree ) ; │ │ │ │ │ │ This method returns the root of the tree. │ │ │ │ │ │ Error checking: If tree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 3. int * Tree_par ( Tree *tree ) ; │ │ │ │ │ │ This method returns a pointer to the parent vector. │ │ │ │ │ │ Error checking: If tree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - Tree : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Tree : DRAFT January 7, 2024 3 │ │ │ │ │ │ 4. int * Tree_fch ( Tree *tree ) ; │ │ │ │ │ │ This method returns a pointer to the first child vector. │ │ │ │ │ │ Error checking: If tree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 5. int * Tree_sib ( Tree *tree ) ; │ │ │ │ │ │ This method returns a pointer to the sibling vector. │ │ │ │ │ │ Error checking: If tree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.3 Initializer methods │ │ │ │ │ │ @@ -88,15 +88,15 @@ │ │ │ │ │ │ The subtree object is initialized from the tree object, the nodes that are included are those │ │ │ │ │ │ found in nodeidsIV. A parent-child link in the subtree means that the two nodes have a │ │ │ │ │ │ parent-child link in the tree. │ │ │ │ │ │ Return codes: │ │ │ │ │ │ 1 normal return -3 tree is NULL │ │ │ │ │ │ -1 subtree is NULL -4 nodeidsIV is invalid │ │ │ │ │ │ -2 nodeidsIV is NULL │ │ │ │ │ │ - 4 Tree : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Tree : DRAFT January 7, 2024 │ │ │ │ │ │ 5. void Tree_setFchSibRoot ( Tree *tree ) ; │ │ │ │ │ │ Theroot and the entries in the fch[] and sib[] vectors are set using the entries in the par[] │ │ │ │ │ │ vector. │ │ │ │ │ │ Error checking: If tree is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 6. void Tree_setRoot ( Tree *tree ) ; │ │ │ │ │ │ The vertices that are roots in the tree are linked by their sib[] field and the root of the tree │ │ │ │ │ │ is set to the head of the list. │ │ │ │ │ │ @@ -122,15 +122,15 @@ │ │ │ │ │ │ This method returns the first node in a pre-order traversal. │ │ │ │ │ │ Error checking: If tree is NULL, or if tree->n < 1, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 5. int Tree_preOTnext ( Tree *tree, int v ) ; │ │ │ │ │ │ This method returns the node that follows v in a pre-order traversal. │ │ │ │ │ │ Error checking: If tree is NULL, or if tree->n < 1, or v is not in [0,tree->n-1], an error │ │ │ │ │ │ message is printed and the program exits. │ │ │ │ │ │ - Tree : DRAFT February 8, 2025 5 │ │ │ │ │ │ + Tree : DRAFT January 7, 2024 5 │ │ │ │ │ │ 6. int Tree_nleaves ( Tree *tree ) ; │ │ │ │ │ │ This method returns the number of leaves of the tree. │ │ │ │ │ │ Error checking: If tree is NULL, or if tree->n < 1, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 7. int Tree_nroots ( Tree *tree ) ; │ │ │ │ │ │ This method returns the number of roots of the tree (really a forest). │ │ │ │ │ │ Error checking: If tree is NULL, or if tree->n < 1, an error message is printed and the │ │ │ │ │ │ @@ -155,15 +155,15 @@ │ │ │ │ │ │ 12. IV * Tree_maximizeGainIV ( Tree *tree, IV *gainIV, int *ptotalgain, │ │ │ │ │ │ int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ Given a gain value assigned to each node, find a set of nodes, no two in a child-ancestor │ │ │ │ │ │ relationship, that maximizes the total gain. This problem arises in finding the optimal do- │ │ │ │ │ │ main/Schur complement partition for a semi-implicit factorization. │ │ │ │ │ │ Error checking: If tree, gainIV or ptotalgain is NULL, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ - 6 Tree : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 Tree : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2.5 Metrics methods │ │ │ │ │ │ Manyoperations need to know some metric defined on the nodes in a tree. Here are three examples: │ │ │ │ │ │ the height of a node (the minimum distance from a descendant leaf), the depth of a node (the │ │ │ │ │ │ distance from its root ancestor), or the weight associated with a subtree rooted at a node. Of │ │ │ │ │ │ course, a weight could be associated with each node, so the height or depth becomes the weight of │ │ │ │ │ │ the nodes on the path. │ │ │ │ │ │ Metrics can be int or double. Because of the limitations of C, we need two separate methods │ │ │ │ │ │ @@ -191,15 +191,15 @@ │ │ │ │ │ │ These methods create and return IV or DV objects that contain height metrics using as input │ │ │ │ │ │ an IV or DV object that contains the metric for each of the nodes. If hmetric[] is the vector │ │ │ │ │ │ in the returned IV or DV object, then │ │ │ │ │ │ hmetric[v] = vmetric[v] if fch[v] == -1 │ │ │ │ │ │ = vmetric[v] + max_{par[u] = v} hmetric[par[v]] │ │ │ │ │ │ Error checking: If tree or vmetric{I,D}V is NULL, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ - Tree : DRAFT February 8, 2025 7 │ │ │ │ │ │ + Tree : DRAFT January 7, 2024 7 │ │ │ │ │ │ 1.2.6 Compression methods │ │ │ │ │ │ Frequently a tree will need to be compressed in some manner. Elimination trees usually have long │ │ │ │ │ │ chains of nodes at the higher levels, where each chain of nodes corresponds to a supernode. Liu’s │ │ │ │ │ │ generalized row envelope methods partition the vertices by longest chains [?]. In both cases, we can │ │ │ │ │ │ construct a map from each node to a set of nodes to define a smaller, more compact tree. Given │ │ │ │ │ │ such a map, we construct the smaller tree. │ │ │ │ │ │ Afundamental chain is a set of nodes v ,...,v such that (1) v is a leaf or has two or more │ │ │ │ │ │ @@ -232,15 +232,15 @@ │ │ │ │ │ │ Error checking: If tree or map is NULL, or if n < 1, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ 2. void Tree_leftJustifyI ( Tree *tree, IV *metricIV ) ; │ │ │ │ │ │ void Tree_leftJustifyD ( Tree *tree, DV *metricIV ) ; │ │ │ │ │ │ This method justifies the tree, reordering the children of each node as necessary. If u and v │ │ │ │ │ │ are siblings, and u comes before v in a post-order traversal, then the weight of the subtree │ │ │ │ │ │ rooted at u is as large or larger than the weight of the subtree rooted at v. │ │ │ │ │ │ - 8 Tree : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 Tree : DRAFT January 7, 2024 │ │ │ │ │ │ Error checking: If tree or metricIV is NULL, or if n < 1, or if n is not the size of metricIV, │ │ │ │ │ │ an error message is printed and the program exits. │ │ │ │ │ │ 1.2.8 Permutation methods │ │ │ │ │ │ Often we need to extract a permutation from a tree, e.g., a post-order traversal of an elimination │ │ │ │ │ │ tree gives an ordering for a sparse matrix. On other occasions, we need to permute a tree, i.e. │ │ │ │ │ │ re-label the nodes. │ │ │ │ │ │ 1. void Tree_fillNewToOldPerm ( Tree *tree, int newToOld[] ) ; │ │ │ │ │ │ @@ -269,15 +269,15 @@ │ │ │ │ │ │ Return codes: │ │ │ │ │ │ 1 normal return -3 coordflag is invalid │ │ │ │ │ │ -1 tree is NULL -3 xDV is NULL │ │ │ │ │ │ -2 heightflag is invalid -4 yDV is NULL │ │ │ │ │ │ 2. int Tree_drawToEPS ( Tree *tree, FILE *filename, DV *xDV, DV *yDV, │ │ │ │ │ │ double rscale, DV *radiusDV, int labelflag, │ │ │ │ │ │ double fontscale, IV *labelsIV, double bbox[], │ │ │ │ │ │ - Tree : DRAFT February 8, 2025 9 │ │ │ │ │ │ + Tree : DRAFT January 7, 2024 9 │ │ │ │ │ │ double frame[], double bounds[] ) ; │ │ │ │ │ │ This method draws a tree. The coordinates of the nodes are found in the xDV and yDV vectors. │ │ │ │ │ │ The nodes will have circles of constant radius (if radiusDV is NULL) or each circle can have a │ │ │ │ │ │ different radius found in radiusDV when radiusDV is not NULL. The value rscale is used to │ │ │ │ │ │ scale all the radii. (If radiusDV is NULL, then all radii are equal to one point — there are 72 │ │ │ │ │ │ points to the inch.) │ │ │ │ │ │ If labelflag = 1, the nodes will have a numeric label. If labelsIV is NULL, then the label │ │ │ │ │ │ @@ -306,15 +306,15 @@ │ │ │ │ │ │ and returns the value returned from the called routine. │ │ │ │ │ │ Error checking: If tree or fn are NULL, or if fn is not of the form *.treef (for a formatted │ │ │ │ │ │ file) or *.treeb (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ 2. int Tree_readFromFormattedFile ( Tree *tree, FILE *fp ) ; │ │ │ │ │ │ This method reads in a Perm object from a formatted file. If there are no errors in reading │ │ │ │ │ │ the data, the value 1 is returned. If an IO error is encountered from fscanf, zero is returned. │ │ │ │ │ │ Error checking: If tree or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - 10 Tree : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 Tree : DRAFT January 7, 2024 │ │ │ │ │ │ 3. int Tree_readFromBinaryFile ( Tree *tree, FILE *fp ) ; │ │ │ │ │ │ This method reads in a Perm object from a binary file. If there are no errors in reading the │ │ │ │ │ │ data, the value 1 is returned. If an IO error is encountered from fread, zero is returned. │ │ │ │ │ │ Error checking: If tree or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 4. int Tree_writeToFile ( Tree *tree, char *fn ) ; │ │ │ │ │ │ This method writes a Perm object to a file. It tries to open the file and if it is successful, │ │ │ │ │ │ it then calls Tree writeFromFormattedFile() or Tree writeFromBinaryFile(), closes the │ │ │ │ │ │ @@ -339,15 +339,15 @@ │ │ │ │ │ │ Error checking: If tree or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 1.3 Driver programs for the Tree object │ │ │ │ │ │ 1. drawTree msglvl msgFile inTreeFile inTagsFile outEPSfile │ │ │ │ │ │ heightflag coordflag radius bbox[4] frame[4] tagflag fontsize │ │ │ │ │ │ This driver program reads in a Tree file and optionally a tags IV file and creates an EPS file │ │ │ │ │ │ with a simple picture of a tree. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. │ │ │ │ │ │ - Tree : DRAFT February 8, 2025 11 │ │ │ │ │ │ + Tree : DRAFT January 7, 2024 11 │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ output file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The inTreeFile parameter is the input file for the Tree object. It must be of the form │ │ │ │ │ │ *.treefor*.treeb. TheTreeobjectisreadfromthefileviatheTree readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The inTagsFile parameter is the input file for the IV vector object than holds the tags │ │ │ │ │ │ @@ -364,15 +364,15 @@ │ │ │ │ │ │ • The frame parameter a sequence of four numbers that form the frame of the plot within │ │ │ │ │ │ the bounding box: lower left x value, lower left y value, width and height. │ │ │ │ │ │ • When tagflag = 1, tags are drawn on the nodes. If tagsFile is NULL, then node ids │ │ │ │ │ │ will be drawn on the nodes. Otherwise, node ids will be taken from the tagsIV object. │ │ │ │ │ │ • The fontsize parameter is the size of the font to be used to draw the node labels. │ │ │ │ │ │ Use the doDraw script file as an example. Four plots of a tree for the R2D100 matrix ordered │ │ │ │ │ │ by nested dissection are found below. │ │ │ │ │ │ - 12 Tree : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 Tree : DRAFT January 7, 2024 │ │ │ │ │ │ Figure 1.1: R2D100: domain/separator tree. On the left heightflag = ’H’ and coordflag = │ │ │ │ │ │ ’C’, on the right heightflag = ’D’ and coordflag = ’C’. │ │ │ │ │ │ 71 71 │ │ │ │ │ │ 70 70 32 │ │ │ │ │ │ 51 51 69 31 13 │ │ │ │ │ │ 40 32 50 40 61 68 22 30 8 12 │ │ │ │ │ │ 39 31 49 43 39 56 60 67 64 21 17 29 23 7 11 9 │ │ │ ├── ./usr/share/doc/spooles-doc/Utilities.ps.gz │ │ │ │ ├── Utilities.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Utilities.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -3358,21 +3358,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -3556,88 +3555,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5503,16 +5497,16 @@ │ │ │ │ │ 51 16[51 5[51 1[51 51 51 40[{}31 99.6264 /CMTT12 rf /Fi │ │ │ │ │ 134[59 2[59 62 44 44 46 1[62 56 62 93 31 59 1[31 62 56 │ │ │ │ │ 1[51 62 50 1[54 13[62 24[31 56 56 56 56 56 56 56 56 56 │ │ │ │ │ 56 1[31 37 45[{}33 99.6264 /CMBX12 rf /Fj 139[62 62 6[62 │ │ │ │ │ 2[62 3[62 15[62 85[{}6 119.552 /CMTT12 rf /Fk 138[49 │ │ │ │ │ 30 37 38 1[46 46 51 2[42 1[28 46 42 1[42 46 42 1[46 12[65 │ │ │ │ │ 1[66 11[59 62 69 2[68 6[28 58[{}22 90.9091 /CMTI10 rf │ │ │ │ │ -/Fl 134[48 3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 │ │ │ │ │ -2[45 1[45 3[25 44[{}13 90.9091 /CMSL10 rf │ │ │ │ │ +/Fl 134[48 3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 │ │ │ │ │ +1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 rf │ │ │ │ │ %DVIPSBitmapFont: Fm tcrm1095 10.95 1 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -5611,46 +5605,46 @@ │ │ │ │ │ b Fq(data)h(\014elds.)558 4763 y Fp(typedef)45 b(struct)h(_I2OP)h(I2OP) │ │ │ │ │ f(;)558 4876 y(struct)g(_I2OP)g({)701 4989 y(int)190 │ │ │ │ │ b(value0)94 b(;)701 5101 y(int)190 b(value1)94 b(;)701 │ │ │ │ │ 5214 y(void)142 b(*value2)46 b(;)701 5327 y(I2OP)142 │ │ │ │ │ b(*next)g(;)558 5440 y(})47 b(;)1927 5656 y Fq(1)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fq(2)p 136 100 1015 4 v │ │ │ │ │ -1196 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2886 100 V 0 399 a Fn(1.2)135 │ │ │ │ │ -b(Protot)l(yp)t(es)46 b(and)f(descriptions)g(of)g Fj(Utilities)c │ │ │ │ │ -Fn(metho)t(ds)0 632 y Fq(This)g(section)j(con)m(tains)f(brief)f │ │ │ │ │ -(descriptions)g(including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f │ │ │ │ │ -(that)h(b)s(elong)f(to)h(the)0 744 y Fp(Utilities)28 │ │ │ │ │ -b Fq(directory)-8 b(.)0 1028 y Fi(1.2.1)112 b Fh(CV)38 │ │ │ │ │ -b Fi(:)g Fh(char)g Fi(v)m(ector)f(metho)s(ds)111 1230 │ │ │ │ │ -y Fq(1.)46 b Fp(char)h(*)g(CVinit)f(\()i(int)f(n,)g(char)g(c)g(\))h(;) │ │ │ │ │ -227 1385 y Fq(This)32 b(is)h(the)g(allo)s(cator)j(and)c(initializer)j │ │ │ │ │ -(metho)s(d)d(for)h Fp(char)f Fq(v)m(ectors.)49 b(Storage)35 │ │ │ │ │ -b(for)d(an)h(arra)m(y)g(with)g(size)227 1498 y Fp(n)d │ │ │ │ │ -Fq(is)h(found)e(and)h(eac)m(h)h(en)m(try)g(is)f(\014lled)g(with)g(c)m │ │ │ │ │ -(haracter)i Fp(c)p Fq(.)41 b(A)30 b(p)s(oin)m(ter)h(to)g(the)f(arra)m │ │ │ │ │ -(y)h(is)g(returned.)111 1697 y(2.)46 b Fp(char)h(*)g(CVinit2)f(\()i │ │ │ │ │ -(int)f(n)g(\))g(;)227 1852 y Fq(This)34 b(is)h(an)g(allo)s(cator)i │ │ │ │ │ -(metho)s(d)e(for)g Fp(char)e Fq(v)m(ectors.)56 b(Storage)36 │ │ │ │ │ -b(for)f(an)g(arra)m(y)h(with)e(size)i Fp(n)f Fq(is)g(found.)53 │ │ │ │ │ -b(A)227 1965 y(p)s(oin)m(ter)31 b(to)g(the)f(arra)m(y)h(is)g(returned.) │ │ │ │ │ -39 b(Note,)32 b(on)e(return,)g(there)g(will)h(lik)m(ely)h(b)s(e)e │ │ │ │ │ -(garbage)h(in)g(the)f(arra)m(y)-8 b(.)111 2163 y(3.)46 │ │ │ │ │ -b Fp(void)h(CVfree)f(\()h(char)g(cvec[])f(\))i(;)227 │ │ │ │ │ -2319 y Fq(This)30 b(metho)s(d)g(releases)h(the)g(storage)h(tak)m(en)f │ │ │ │ │ -(b)m(y)f Fp(cvec[])p Fq(.)111 2517 y(4.)46 b Fp(void)h(CVcopy)f(\()h │ │ │ │ │ -(int)g(n,)h(char)e(y[],)h(char)f(x[])h(\))h(;)227 2673 │ │ │ │ │ -y Fq(This)30 b(metho)s(d)g(copies)h Fp(n)f Fq(en)m(tries)h(from)f │ │ │ │ │ -Fp(x[])f Fq(to)j Fp(y[])p Fq(,)d(i.e.,)j Fp(y[i])47 b(=)g(x[i])29 │ │ │ │ │ -b Fq(for)h Fp(0)48 b(<=)f(i)h(<)f(n)p Fq(.)111 2871 y(5.)f │ │ │ │ │ -Fp(void)h(CVfill)f(\()h(int)g(n,)h(char)e(y[],)h(char)f(c)i(\))f(;)227 │ │ │ │ │ -3027 y Fq(This)30 b(metho)s(d)g(\014lls)g Fp(n)g Fq(en)m(tries)h(in)f │ │ │ │ │ -Fp(y[])g Fq(with)g(the)g(c)m(haracter)i Fp(c)p Fq(,)e(i.e.,)i │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fq(2)p 136 100 1034 4 v │ │ │ │ │ +1215 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2867 100 V 0 399 a Fn(1.2)135 b(Protot)l(yp)t(es)46 │ │ │ │ │ +b(and)f(descriptions)g(of)g Fj(Utilities)c Fn(metho)t(ds)0 │ │ │ │ │ +632 y Fq(This)g(section)j(con)m(tains)f(brief)f(descriptions)g │ │ │ │ │ +(including)f(protot)m(yp)s(es)i(of)f(all)h(metho)s(ds)f(that)h(b)s │ │ │ │ │ +(elong)f(to)h(the)0 744 y Fp(Utilities)28 b Fq(directory)-8 │ │ │ │ │ +b(.)0 1028 y Fi(1.2.1)112 b Fh(CV)38 b Fi(:)g Fh(char)g │ │ │ │ │ +Fi(v)m(ector)f(metho)s(ds)111 1230 y Fq(1.)46 b Fp(char)h(*)g(CVinit)f │ │ │ │ │ +(\()i(int)f(n,)g(char)g(c)g(\))h(;)227 1385 y Fq(This)32 │ │ │ │ │ +b(is)h(the)g(allo)s(cator)j(and)c(initializer)j(metho)s(d)d(for)h │ │ │ │ │ +Fp(char)f Fq(v)m(ectors.)49 b(Storage)35 b(for)d(an)h(arra)m(y)g(with)g │ │ │ │ │ +(size)227 1498 y Fp(n)d Fq(is)h(found)e(and)h(eac)m(h)h(en)m(try)g(is)f │ │ │ │ │ +(\014lled)g(with)g(c)m(haracter)i Fp(c)p Fq(.)41 b(A)30 │ │ │ │ │ +b(p)s(oin)m(ter)h(to)g(the)f(arra)m(y)h(is)g(returned.)111 │ │ │ │ │ +1697 y(2.)46 b Fp(char)h(*)g(CVinit2)f(\()i(int)f(n)g(\))g(;)227 │ │ │ │ │ +1852 y Fq(This)34 b(is)h(an)g(allo)s(cator)i(metho)s(d)e(for)g │ │ │ │ │ +Fp(char)e Fq(v)m(ectors.)56 b(Storage)36 b(for)f(an)g(arra)m(y)h(with)e │ │ │ │ │ +(size)i Fp(n)f Fq(is)g(found.)53 b(A)227 1965 y(p)s(oin)m(ter)31 │ │ │ │ │ +b(to)g(the)f(arra)m(y)h(is)g(returned.)39 b(Note,)32 │ │ │ │ │ +b(on)e(return,)g(there)g(will)h(lik)m(ely)h(b)s(e)e(garbage)h(in)g(the) │ │ │ │ │ +f(arra)m(y)-8 b(.)111 2163 y(3.)46 b Fp(void)h(CVfree)f(\()h(char)g │ │ │ │ │ +(cvec[])f(\))i(;)227 2319 y Fq(This)30 b(metho)s(d)g(releases)h(the)g │ │ │ │ │ +(storage)h(tak)m(en)f(b)m(y)f Fp(cvec[])p Fq(.)111 2517 │ │ │ │ │ +y(4.)46 b Fp(void)h(CVcopy)f(\()h(int)g(n,)h(char)e(y[],)h(char)f(x[])h │ │ │ │ │ +(\))h(;)227 2673 y Fq(This)30 b(metho)s(d)g(copies)h │ │ │ │ │ +Fp(n)f Fq(en)m(tries)h(from)f Fp(x[])f Fq(to)j Fp(y[])p │ │ │ │ │ +Fq(,)d(i.e.,)j Fp(y[i])47 b(=)g(x[i])29 b Fq(for)h Fp(0)48 │ │ │ │ │ +b(<=)f(i)h(<)f(n)p Fq(.)111 2871 y(5.)f Fp(void)h(CVfill)f(\()h(int)g │ │ │ │ │ +(n,)h(char)e(y[],)h(char)f(c)i(\))f(;)227 3027 y Fq(This)30 │ │ │ │ │ +b(metho)s(d)g(\014lls)g Fp(n)g Fq(en)m(tries)h(in)f Fp(y[])g │ │ │ │ │ +Fq(with)g(the)g(c)m(haracter)i Fp(c)p Fq(,)e(i.e.,)i │ │ │ │ │ Fp(y[i])47 b(=)g(c)30 b Fq(for)g Fp(0)48 b(<=)f(i)h(<)f(n)p │ │ │ │ │ Fq(.)111 3225 y(6.)f Fp(void)h(CVfprintf)e(\()j(FILE)e(*fp,)h(int)g(n,) │ │ │ │ │ g(char)g(y[])g(\))g(;)227 3381 y Fq(This)36 b(metho)s(d)f(prin)m(ts)h │ │ │ │ │ Fp(n)g Fq(en)m(tries)h(in)e Fp(y[])h Fq(to)h(\014le)f │ │ │ │ │ Fp(fp)p Fq(.)57 b(The)36 b(format)g(is)g(new)g(line)h(follo)m(w)m(ed)g │ │ │ │ │ (b)m(y)f(lines)h(of)227 3494 y(eigh)m(t)m(y)32 b(columns)f(of)f(single) │ │ │ │ │ h(c)m(haracters.)111 3692 y(7.)46 b Fp(int)h(CVfp80)f(\()i(FILE)e(*fp,) │ │ │ │ │ @@ -5677,17 +5671,17 @@ │ │ │ │ │ (val)f(\))i(;)227 5294 y Fq(This)26 b(is)h(the)g(allo)s(cator)i(and)d │ │ │ │ │ (initializer)j(metho)s(d)d(for)g Fp(double)f Fq(v)m(ectors.)41 │ │ │ │ │ b(Storage)28 b(for)f(an)f(arra)m(y)i(with)e(size)227 │ │ │ │ │ 5407 y Fp(n)k Fq(is)h(found)e(and)h(eac)m(h)h(en)m(try)g(is)f(\014lled) │ │ │ │ │ g(with)g Fp(val)p Fq(.)40 b(A)31 b(p)s(oin)m(ter)f(to)h(the)g(arra)m(y) │ │ │ │ │ g(is)f(returned.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1015 4 v 1196 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)40 b Fk(DRAFT)122 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2839 100 V 1015 w Fq(3)111 399 y(2.)46 b Fp(double)g(*)i(DVinit2)e(\()h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1034 4 v 1215 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)40 b Fk(DRAFT)122 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2820 100 V 1034 w Fq(3)111 399 y(2.)46 b Fp(double)g(*)i(DVinit2)e(\()h │ │ │ │ │ (int)g(n)g(\))h(;)227 545 y Fq(This)30 b(is)g(an)h(allo)s(cator)h │ │ │ │ │ (metho)s(d)e(for)g Fp(double)f Fq(v)m(ectors.)42 b(Storage)32 │ │ │ │ │ b(for)e(an)g(arra)m(y)h(with)f(size)i Fp(n)e Fq(is)g(found.)40 │ │ │ │ │ b(A)227 658 y(p)s(oin)m(ter)31 b(to)g(the)f(arra)m(y)h(is)g(returned.) │ │ │ │ │ 39 b(Note,)32 b(on)e(return,)g(there)g(will)h(lik)m(ely)h(b)s(e)e │ │ │ │ │ (garbage)h(in)g(the)f(arra)m(y)-8 b(.)111 838 y(3.)46 │ │ │ │ │ b Fp(void)h(DVfree)f(\()h(int)g(vec[])g(\))g(;)227 985 │ │ │ │ │ @@ -5739,22 +5733,22 @@ │ │ │ │ │ (alpha[3])d(*)j(x1[])227 4945 y(y2[])f(=)g(y2[])g(+)g(alpha[4])f(*)h │ │ │ │ │ (x0[])g(+)h(alpha[5])d(*)j(x1[])66 5148 y Fq(11.)e Fp(void)h(DVaxpy31)e │ │ │ │ │ (\()j(int)f(n,)g(double)f(y0[],)g(double)h(y1[],)f(double)g(y2[],)991 │ │ │ │ │ 5261 y(double)g(alpha,)g(double)g(x0[],)h(double)f(x1[])g(\))i(;)227 │ │ │ │ │ 5407 y Fq(This)30 b(metho)s(d)g(computes)g(this)g(computation.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fq(4)p 136 100 1015 4 v │ │ │ │ │ -1196 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2886 100 V 227 399 a Fp(y0[])47 │ │ │ │ │ -b(=)g(y0[])g(+)g(alpha[0])f(*)h(x0[])227 511 y(y1[])g(=)g(y1[])g(+)g │ │ │ │ │ -(alpha[1])f(*)h(x0[])227 624 y(y2[])g(=)g(y2[])g(+)g(alpha[2])f(*)h │ │ │ │ │ -(x0[])66 850 y Fq(12.)f Fp(void)h(DVaxpy23)e(\()j(int)f(n,)g(double)f │ │ │ │ │ -(y0[],)g(double)h(y1[],)991 963 y(double)f(alpha,)g(double)g(x0[],)h │ │ │ │ │ -(double)f(x1[],)g(double)g(x2[])h(\))g(;)227 1114 y Fq(This)30 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fq(4)p 136 100 1034 4 v │ │ │ │ │ +1215 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2867 100 V 227 399 a Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0])f(*)h │ │ │ │ │ +(x0[])227 511 y(y1[])g(=)g(y1[])g(+)g(alpha[1])f(*)h(x0[])227 │ │ │ │ │ +624 y(y2[])g(=)g(y2[])g(+)g(alpha[2])f(*)h(x0[])66 850 │ │ │ │ │ +y Fq(12.)f Fp(void)h(DVaxpy23)e(\()j(int)f(n,)g(double)f(y0[],)g │ │ │ │ │ +(double)h(y1[],)991 963 y(double)f(alpha,)g(double)g(x0[],)h(double)f │ │ │ │ │ +(x1[],)g(double)g(x2[])h(\))g(;)227 1114 y Fq(This)30 │ │ │ │ │ b(metho)s(d)g(computes)g(this)g(computation.)227 1340 │ │ │ │ │ y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0])f(*)h(x0[])g(+)h(alpha[1])d(*)j │ │ │ │ │ (x1[])e(+)i(alpha[2])d(*)j(x2[])227 1453 y(y1[])f(=)g(y1[])g(+)g │ │ │ │ │ (alpha[3])f(*)h(x0[])g(+)h(alpha[4])d(*)j(x1[])e(+)i(alpha[5])d(*)j │ │ │ │ │ (x2[])66 1679 y Fq(13.)e Fp(void)h(DVaxpy22)e(\()j(int)f(n,)g(double)f │ │ │ │ │ (y0[],)g(double)h(y1[],)991 1792 y(double)f(alpha,)g(double)g(x0[],)h │ │ │ │ │ (double)f(x1[])g(\))i(;)227 1942 y Fq(This)30 b(metho)s(d)g(computes)g │ │ │ │ │ @@ -5783,17 +5777,17 @@ │ │ │ │ │ (int)g(index[],)e(double)i(alpha,)f(double)g(x[])h(\))g(;)227 │ │ │ │ │ 5294 y Fq(This)31 b(metho)s(d)f(scatteradds)i(a)g(scaled)g(m)m(ultiple) │ │ │ │ │ g(of)f Fp(n)g Fq(en)m(tries)h(from)f Fp(x[])f Fq(in)m(to)i │ │ │ │ │ Fp(y[])p Fq(,)f(i.e.,)i Fp(y[index[i]])227 5407 y(+=)47 │ │ │ │ │ b(alpha)g(*)g(x[i])29 b Fq(for)i Fp(0)47 b(<=)g(i)h(<)f(n)p │ │ │ │ │ Fq(.)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1015 4 v 1196 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)40 b Fk(DRAFT)122 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2839 100 V 1015 w Fq(5)66 399 y(19.)46 b Fp(void)h(DVcompress)e(\()i │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1034 4 v 1215 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)40 b Fk(DRAFT)122 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2820 100 V 1034 w Fq(5)66 399 y(19.)46 b Fp(void)h(DVcompress)e(\()i │ │ │ │ │ (int)g(n1,)g(double)f(x1[],)h(double)f(y1[],)1086 511 │ │ │ │ │ y(int)h(n2,)g(double)f(x2[],)h(double)f(y2[])g(\))i(;)227 │ │ │ │ │ 672 y Fq(Giv)m(en)c(a)f(pair)g(of)f(arra)m(ys)i Fp(x1[n1])d │ │ │ │ │ Fq(and)h Fp(y1[n1])p Fq(,)i(\014ll)f Fp(x2[n2])e Fq(and)h │ │ │ │ │ Fp(y2[n2])f Fq(with)i(a)g(subset)f(of)h(the)227 785 y │ │ │ │ │ Fp(\(x1[j],y1[j])27 b Fq(en)m(tries)k(whose)g(distribution)e(is)i(an)f │ │ │ │ │ (appro)m(ximation.)66 993 y(20.)46 b Fp(void)h(DVcopy)f(\()h(int)g(n,)h │ │ │ │ │ @@ -5883,21 +5877,20 @@ │ │ │ │ │ Fp(row1)p Fq([)p Fp(i)p Fq(])19 b Fg(\003)i Fp(col0)p │ │ │ │ │ Fq([)p Fp(i)p Fq(])277 5346 y Fp(sums)p Fq([)p Fp(2)p │ │ │ │ │ Fq(])j(=)687 5241 y Fe(n)p Fd(\000)p Fe(1)690 5266 y │ │ │ │ │ Ff(X)687 5445 y Fe(i)p Fc(=)p Fe(0)828 5346 y Fp(row2)p │ │ │ │ │ Fq([)p Fp(i)p Fq(])19 b Fg(\003)i Fp(col0)p Fq([)p Fp(i)p │ │ │ │ │ Fq(])p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fq(6)p 136 100 1015 4 v │ │ │ │ │ -1196 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2886 100 V 66 399 a Fq(25.)46 │ │ │ │ │ -b Fp(int)h(DVdot23)f(\()h(int)g(n,)h(double)e(row0[],)f(double)i │ │ │ │ │ -(row1[],)895 511 y(double)g(col0[],)e(double)h(col1[],)g(double)g │ │ │ │ │ -(col2[],)g(double)g(sums[])g(\))i(;)227 667 y Fq(This)30 │ │ │ │ │ -b(metho)s(d)g(computes)g(six)h(dot)f(pro)s(ducts.)277 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fq(6)p 136 100 1034 4 v │ │ │ │ │ +1215 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2867 100 V 66 399 a Fq(25.)46 b Fp(int)h(DVdot23)f(\()h(int)g │ │ │ │ │ +(n,)h(double)e(row0[],)f(double)i(row1[],)895 511 y(double)g(col0[],)e │ │ │ │ │ +(double)h(col1[],)g(double)g(col2[],)g(double)g(sums[])g(\))i(;)227 │ │ │ │ │ +667 y Fq(This)30 b(metho)s(d)g(computes)g(six)h(dot)f(pro)s(ducts.)277 │ │ │ │ │ 891 y Fp(sums)p Fq([)p Fp(0)p Fq(])24 b(=)687 786 y Fe(n)p │ │ │ │ │ Fd(\000)p Fe(1)690 810 y Ff(X)687 989 y Fe(i)p Fc(=)p │ │ │ │ │ Fe(0)828 891 y Fp(row0)p Fq([)p Fp(i)p Fq(])19 b Fg(\003)i │ │ │ │ │ Fp(col0)p Fq([)p Fp(i)p Fq(])99 b Fp(sums)p Fq([)p Fp(1)p │ │ │ │ │ Fq(])24 b(=)2002 786 y Fe(n)p Fd(\000)p Fe(1)2005 810 │ │ │ │ │ y Ff(X)2002 989 y Fe(i)p Fc(=)p Fe(0)2143 891 y Fp(row0)p │ │ │ │ │ Fq([)p Fp(i)p Fq(])19 b Fg(\003)i Fp(col1)p Fq([)p Fp(i)p │ │ │ │ │ @@ -5974,17 +5967,17 @@ │ │ │ │ │ (double)i(col0[],)e(double)h(sums[])h(\))g(;)227 5123 │ │ │ │ │ y Fq(This)30 b(metho)s(d)g(computes)g(one)h(dot)f(pro)s(duct.)277 │ │ │ │ │ 5346 y Fp(sums)p Fq([)p Fp(0)p Fq(])24 b(=)687 5241 y │ │ │ │ │ Fe(n)p Fd(\000)p Fe(1)690 5266 y Ff(X)687 5445 y Fe(i)p │ │ │ │ │ Fc(=)p Fe(0)828 5346 y Fp(row0)p Fq([)p Fp(i)p Fq(])19 │ │ │ │ │ b Fg(\003)i Fp(col0)p Fq([)p Fp(i)p Fq(])p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1015 4 v 1196 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)40 b Fk(DRAFT)122 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2839 100 V 1015 w Fq(7)66 399 y(31.)46 b Fp(int)h(DVdoti)f(\()i(int)f │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1034 4 v 1215 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)40 b Fk(DRAFT)122 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2820 100 V 1034 w Fq(7)66 399 y(31.)46 b Fp(int)h(DVdoti)f(\()i(int)f │ │ │ │ │ (n,)g(double)f(y[],)h(int)f(index[],)g(double)g(x[])h(\))g(;)227 │ │ │ │ │ 616 y Fq(This)30 b(metho)s(d)g(returns)f(the)h(indexed)g(dot)h(pro)s │ │ │ │ │ (duct)2075 510 y Fe(n)p Fd(\000)p Fe(1)2078 535 y Ff(X)2075 │ │ │ │ │ 714 y Fe(i)p Fc(=)p Fe(0)2216 616 y Fp(y)p Fq([)p Fp(index)p │ │ │ │ │ Fq([)p Fp(i)p Fq(]])19 b Fg(\003)i Fp(x)p Fq([)p Fp(i)p │ │ │ │ │ Fq(].)66 862 y(32.)46 b Fp(void)h(DVfill)f(\()h(int)g(n,)h(double)e │ │ │ │ │ (y[],)g(double)g(val)h(\))h(;)227 1009 y Fq(This)30 b(metho)s(d)g │ │ │ │ │ @@ -6038,21 +6031,21 @@ │ │ │ │ │ Fq(,)34 b Fp(start)227 5079 y(+)48 b(3*inc)p Fq(,)29 │ │ │ │ │ b(etc.)66 5260 y(43.)46 b Fp(void)h(DVscale)f(\()h(int)g(n,)g(double)f │ │ │ │ │ (y[],)h(double)f(alpha)g(\))i(;)227 5407 y Fq(This)30 │ │ │ │ │ b(metho)s(d)g(scales)h(a)g(v)m(ector)h Fp(y[])d Fq(b)m(y)i │ │ │ │ │ Fp(alpha)p Fq(,)e(i.e.,)j Fp(y[i])46 b(*=)h(alpha)p Fq(.)40 │ │ │ │ │ b(for)30 b Fp(0)47 b(<=)g(i)h(<)f(n)p Fq(.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fq(8)p 136 100 1015 4 v │ │ │ │ │ -1196 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2886 100 V 66 399 a Fq(44.)46 │ │ │ │ │ -b Fp(void)h(DVscale2)e(\()j(int)f(n,)g(double)f(x[],)h(double)f(y[],) │ │ │ │ │ -991 511 y(double)g(a,)h(double)f(b,)h(double)g(c,)g(double)f(d)h(\))h │ │ │ │ │ -(;)227 668 y Fq(This)30 b(metho)s(d)g(scales)h(t)m(w)m(o)h(v)m(ectors)g │ │ │ │ │ -Fp(y[])d Fq(b)m(y)h(a)h(2)21 b Fg(\002)f Fq(2)31 b(matrix,)g(i.e.,)881 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fq(8)p 136 100 1034 4 v │ │ │ │ │ +1215 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2867 100 V 66 399 a Fq(44.)46 b Fp(void)h(DVscale2)e(\()j(int)f │ │ │ │ │ +(n,)g(double)f(x[],)h(double)f(y[],)991 511 y(double)g(a,)h(double)f │ │ │ │ │ +(b,)h(double)g(c,)g(double)f(d)h(\))h(;)227 668 y Fq(This)30 │ │ │ │ │ +b(metho)s(d)g(scales)h(t)m(w)m(o)h(v)m(ectors)g Fp(y[])d │ │ │ │ │ +Fq(b)m(y)h(a)h(2)21 b Fg(\002)f Fq(2)31 b(matrix,)g(i.e.,)881 │ │ │ │ │ 800 y Ff(")971 887 y Fp(x)p Fq([)p Fp(0)p Fq(])83 b Fb(:)15 │ │ │ │ │ b(:)g(:)84 b Fp(x)p Fq([)p Fp(n)20 b Fg(\000)g Fp(1)p │ │ │ │ │ Fq(])971 1000 y Fp(y)p Fq([)p Fp(0)p Fq(])83 b Fb(:)15 │ │ │ │ │ b(:)g(:)84 b Fp(y)p Fq([)p Fp(n)20 b Fg(\000)g Fp(1)p │ │ │ │ │ Fq(])1735 800 y Ff(#)1809 944 y Fq(:=)1930 800 y Ff(")2020 │ │ │ │ │ 887 y Fp(a)83 b(b)2020 1000 y(c)g(d)2240 800 y Ff(#)15 │ │ │ │ │ b(")2393 887 y Fp(x)p Fq([)p Fp(0)p Fq(])83 b Fb(:)15 │ │ │ │ │ @@ -6114,17 +6107,17 @@ │ │ │ │ │ h(seed)g(\))g(;)227 5294 y Fq(This)23 b(metho)s(d)g(sh)m(u\017es)g(the) │ │ │ │ │ g(\014rst)g Fp(n)g Fq(en)m(tries)h(in)f Fp(y[])p Fq(.)38 │ │ │ │ │ b(The)23 b(v)-5 b(alue)24 b Fp(seed)e Fq(is)h(the)h(seed)g(to)g(a)g │ │ │ │ │ (random)e(n)m(um)m(b)s(er)227 5407 y(generator,)32 b(and)e(one)h(can)f │ │ │ │ │ (get)i(rep)s(eatable)f(b)s(eha)m(vior)f(b)m(y)h(rep)s(eating)f │ │ │ │ │ Fp(seed)p Fq(.)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1015 4 v 1196 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)40 b Fk(DRAFT)122 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2839 100 V 1015 w Fq(9)0 399 y Fi(1.2.3)112 b Fh(ZV)38 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1034 4 v 1215 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)40 b Fk(DRAFT)122 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2820 100 V 1034 w Fq(9)0 399 y Fi(1.2.3)112 b Fh(ZV)38 │ │ │ │ │ b Fi(:)g Fh(double)53 b(complex)90 b Fi(v)m(ector)37 │ │ │ │ │ b(metho)s(ds)0 605 y Fq(A)22 b(double)g(precision)g(complex)g(v)m │ │ │ │ │ (ector)i(of)e(length)g Fp(n)g Fq(is)g(simply)f(a)i(double)e(precision)h │ │ │ │ │ (v)m(ector)i(of)e(length)g Fp(2n)p Fq(.)37 b(There)0 │ │ │ │ │ 718 y(is)28 b(a)h(separate)g Fp(ZVinit\(\))d Fq(allo)s(cator)31 │ │ │ │ │ b(and)c(initializer)j(metho)s(d,)f(since)f(it)h(requires)f(a)h(real)g │ │ │ │ │ (and)e(imaginary)i(part)0 831 y(to)g(\014ll)g(the)g(v)m(ector.)42 │ │ │ │ │ @@ -6191,39 +6184,38 @@ │ │ │ │ │ 5294 y Fq(This)33 b(metho)s(d)h(adds)f(a)h(scaled)g(m)m(ultiple)h(of)f │ │ │ │ │ (t)m(w)m(o)h(v)m(ectors)g Fp(x[])e Fq(and)h Fp(y[])f │ │ │ │ │ Fq(to)h(another)g(v)m(ector)i Fp(z[])p Fq(,)e(i.e.,)227 │ │ │ │ │ 5407 y(i.e.,)e Fp(z[i])47 b(+=)g(\(areal,aimag\))d(*)j(x[i])g(+)h │ │ │ │ │ (\(breal,bimag\))c(*)j(y[i])29 b Fq(for)h Fp(0)48 b(<=)f(i)h(<)f(n)p │ │ │ │ │ Fq(.)p eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fq(10)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 111 399 a Fq(8.)46 │ │ │ │ │ -b Fp(void)h(ZVaxpy33)e(\()j(int)f(n,)g(double)f(y0[],)g(double)h(y1[],) │ │ │ │ │ -f(double)g(y2[],)991 511 y(double)g(alpha[],)g(double)g(x0[],)g(double) │ │ │ │ │ -g(x1[],)g(double)h(x2[])f(\))i(;)227 661 y Fq(This)30 │ │ │ │ │ -b(metho)s(d)g(computes)g(the)h(follo)m(wing.)227 881 │ │ │ │ │ -y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])f(+)g(alpha[2:3])e │ │ │ │ │ -(*)i(x1[])g(+)h(alpha[4:5])d(*)i(x2[])227 994 y(y1[])g(=)g(y1[])g(+)g │ │ │ │ │ -(alpha[6:7])e(*)j(x0[])f(+)g(alpha[8:9])e(*)i(x1[])g(+)h(alpha[10:11])c │ │ │ │ │ -(*)j(x2[])227 1107 y(y2[])g(=)g(y2[])g(+)g(alpha[12:13])e(*)i(x0[])g(+) │ │ │ │ │ -g(alpha[14:15])e(*)i(x1[])g(+)g(alpha[16:17])e(*)i(x2[])111 │ │ │ │ │ -1326 y Fq(9.)f Fp(void)h(ZVaxpy32)e(\()j(int)f(n,)g(double)f(y0[],)g │ │ │ │ │ -(double)h(y1[],)f(double)g(y2[],)991 1439 y(double)g(alpha[],)g(double) │ │ │ │ │ -g(x0[],)g(double)g(x1[])h(\))g(;)227 1589 y Fq(This)30 │ │ │ │ │ -b(metho)s(d)g(computes)g(the)h(follo)m(wing.)227 1809 │ │ │ │ │ -y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])f(+)g(alpha[2:3])e │ │ │ │ │ -(*)i(x1[])227 1921 y(y1[])g(=)g(y1[])g(+)g(alpha[4:5])e(*)j(x0[])f(+)g │ │ │ │ │ -(alpha[6:7])e(*)i(x1[])227 2034 y(y2[])g(=)g(y2[])g(+)g(alpha[8:9])e(*) │ │ │ │ │ -j(x0[])f(+)g(alpha[10:11])d(*)k(x1[])66 2254 y Fq(10.)e │ │ │ │ │ -Fp(void)h(ZVaxpy31)e(\()j(int)f(n,)g(double)f(y0[],)g(double)h(y1[],)f │ │ │ │ │ -(double)g(y2[],)991 2367 y(double)g(alpha[],)g(double)g(x0[])g(\))i(;) │ │ │ │ │ -227 2517 y Fq(This)30 b(metho)s(d)g(computes)g(the)h(follo)m(wing.)227 │ │ │ │ │ -2736 y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])227 │ │ │ │ │ -2849 y(y1[])f(=)g(y1[])g(+)g(alpha[2:3])e(*)j(x0[])227 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fq(10)p 182 100 1011 4 │ │ │ │ │ +v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Jan)m(uary)g(7,)h │ │ │ │ │ +(2024)p 2890 100 V 111 399 a Fq(8.)46 b Fp(void)h(ZVaxpy33)e(\()j(int)f │ │ │ │ │ +(n,)g(double)f(y0[],)g(double)h(y1[],)f(double)g(y2[],)991 │ │ │ │ │ +511 y(double)g(alpha[],)g(double)g(x0[],)g(double)g(x1[],)g(double)h │ │ │ │ │ +(x2[])f(\))i(;)227 661 y Fq(This)30 b(metho)s(d)g(computes)g(the)h │ │ │ │ │ +(follo)m(wing.)227 881 y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j │ │ │ │ │ +(x0[])f(+)g(alpha[2:3])e(*)i(x1[])g(+)h(alpha[4:5])d(*)i(x2[])227 │ │ │ │ │ +994 y(y1[])g(=)g(y1[])g(+)g(alpha[6:7])e(*)j(x0[])f(+)g(alpha[8:9])e(*) │ │ │ │ │ +i(x1[])g(+)h(alpha[10:11])c(*)j(x2[])227 1107 y(y2[])g(=)g(y2[])g(+)g │ │ │ │ │ +(alpha[12:13])e(*)i(x0[])g(+)g(alpha[14:15])e(*)i(x1[])g(+)g │ │ │ │ │ +(alpha[16:17])e(*)i(x2[])111 1326 y Fq(9.)f Fp(void)h(ZVaxpy32)e(\()j │ │ │ │ │ +(int)f(n,)g(double)f(y0[],)g(double)h(y1[],)f(double)g(y2[],)991 │ │ │ │ │ +1439 y(double)g(alpha[],)g(double)g(x0[],)g(double)g(x1[])h(\))g(;)227 │ │ │ │ │ +1589 y Fq(This)30 b(metho)s(d)g(computes)g(the)h(follo)m(wing.)227 │ │ │ │ │ +1809 y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])f(+)g │ │ │ │ │ +(alpha[2:3])e(*)i(x1[])227 1921 y(y1[])g(=)g(y1[])g(+)g(alpha[4:5])e(*) │ │ │ │ │ +j(x0[])f(+)g(alpha[6:7])e(*)i(x1[])227 2034 y(y2[])g(=)g(y2[])g(+)g │ │ │ │ │ +(alpha[8:9])e(*)j(x0[])f(+)g(alpha[10:11])d(*)k(x1[])66 │ │ │ │ │ +2254 y Fq(10.)e Fp(void)h(ZVaxpy31)e(\()j(int)f(n,)g(double)f(y0[],)g │ │ │ │ │ +(double)h(y1[],)f(double)g(y2[],)991 2367 y(double)g(alpha[],)g(double) │ │ │ │ │ +g(x0[])g(\))i(;)227 2517 y Fq(This)30 b(metho)s(d)g(computes)g(the)h │ │ │ │ │ +(follo)m(wing.)227 2736 y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j │ │ │ │ │ +(x0[])227 2849 y(y1[])f(=)g(y1[])g(+)g(alpha[2:3])e(*)j(x0[])227 │ │ │ │ │ 2962 y(y2[])f(=)g(y2[])g(+)g(alpha[4:5])e(*)j(x0[])66 │ │ │ │ │ 3182 y Fq(11.)e Fp(void)h(ZVaxpy23)e(\()j(int)f(n,)g(double)f(y0[],)g │ │ │ │ │ (double)h(y1[],)991 3295 y(double)f(alpha[],)g(double)g(x0[],)g(double) │ │ │ │ │ g(x1[],)g(double)h(x2[])f(\))i(;)227 3444 y Fq(This)30 │ │ │ │ │ b(metho)s(d)g(computes)g(the)h(follo)m(wing.)227 3664 │ │ │ │ │ y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])f(+)g(alpha[2:3])e │ │ │ │ │ (*)i(x1[])g(+)h(alpha[4:5])d(*)i(x2[])227 3777 y(y1[])g(=)g(y1[])g(+)g │ │ │ │ │ @@ -6238,24 +6230,24 @@ │ │ │ │ │ (int)f(n,)g(double)f(y0[],)g(double)h(y1[],)991 4925 │ │ │ │ │ y(double)f(alpha[],)g(double)g(x0[])g(\))i(;)227 5074 │ │ │ │ │ y Fq(This)30 b(metho)s(d)g(computes)g(the)h(follo)m(wing.)227 │ │ │ │ │ 5294 y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])227 │ │ │ │ │ 5407 y(y1[])f(=)g(y1[])g(+)g(alpha[2:3])e(*)j(x0[])p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(11)66 399 y(14.)46 b Fp(void)h(ZVaxpy13)e(\()j(int) │ │ │ │ │ -f(n,)g(double)f(y0[],)991 511 y(double)g(alpha[],)g(double)g(x0[],)g │ │ │ │ │ -(double)g(x1[],)g(double)h(x2[])f(\))i(;)227 667 y Fq(This)30 │ │ │ │ │ -b(metho)s(d)g(computes)g(the)h(follo)m(wing.)227 907 │ │ │ │ │ -y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])f(+)g(alpha[2:3])e │ │ │ │ │ -(*)i(x1[])g(+)h(alpha[4:5])d(*)i(x2[])66 1146 y Fq(15.)f │ │ │ │ │ -Fp(void)h(ZVaxpy12)e(\()j(int)f(n,)g(double)f(y0[],)g(double)h │ │ │ │ │ -(alpha[],)e(double)h(x0[],)h(double)f(x1[])g(\))i(;)227 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(11)66 399 y(14.)46 b Fp(void)h(ZVaxpy13)e(\()j │ │ │ │ │ +(int)f(n,)g(double)f(y0[],)991 511 y(double)g(alpha[],)g(double)g │ │ │ │ │ +(x0[],)g(double)g(x1[],)g(double)h(x2[])f(\))i(;)227 │ │ │ │ │ +667 y Fq(This)30 b(metho)s(d)g(computes)g(the)h(follo)m(wing.)227 │ │ │ │ │ +907 y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])f(+)g │ │ │ │ │ +(alpha[2:3])e(*)i(x1[])g(+)h(alpha[4:5])d(*)i(x2[])66 │ │ │ │ │ +1146 y Fq(15.)f Fp(void)h(ZVaxpy12)e(\()j(int)f(n,)g(double)f(y0[],)g │ │ │ │ │ +(double)h(alpha[],)e(double)h(x0[],)h(double)f(x1[])g(\))i(;)227 │ │ │ │ │ 1302 y Fq(This)30 b(metho)s(d)g(computes)g(the)h(follo)m(wing.)227 │ │ │ │ │ 1541 y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])f(+)g │ │ │ │ │ (alpha[2:3])e(*)i(x1[])66 1781 y Fq(16.)f Fp(void)h(ZVaxpy11)e(\()j │ │ │ │ │ (int)f(n,)g(double)f(y0[],)g(double)h(alpha[],)e(double)h(x0[])h(\))g │ │ │ │ │ (;)227 1937 y Fq(This)30 b(metho)s(d)g(computes)g(the)h(follo)m(wing.) │ │ │ │ │ 227 2176 y Fp(y0[])47 b(=)g(y0[])g(+)g(alpha[0:1])e(*)j(x0[])66 │ │ │ │ │ 2415 y Fq(17.)e Fp(void)h(ZVcopy)f(\()h(int)g(n,)h(double)e(y[],)g │ │ │ │ │ @@ -6295,17 +6287,17 @@ │ │ │ │ │ b Fg(\003)i Fp(x)p Fq([)p Fp(i)p Fq(].)66 5138 y(22.)46 │ │ │ │ │ b Fp(int)h(ZVdotU33)f(\()h(int)g(n,)g(double)f(row0[],)g(double)g │ │ │ │ │ (row1[],)g(double)g(row2[],)895 5251 y(double)h(col0[],)e(double)h │ │ │ │ │ (col1[],)g(double)g(col2[],)g(double)g(sums[])g(\))i(;)227 │ │ │ │ │ 5407 y Fq(This)30 b(metho)s(d)g(computes)g(nine)g(dot)h(pro)s(ducts.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fq(12)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 277 462 a Fp(sums)p │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fq(12)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 277 462 a Fp(sums)p │ │ │ │ │ Fq([)p Fp(0)p Fq(;)15 b Fp(1)p Fq(])25 b(=)776 356 y │ │ │ │ │ Fe(n)p Fd(\000)p Fe(1)778 381 y Ff(X)776 560 y Fe(i)p │ │ │ │ │ Fc(=)p Fe(0)916 462 y Fp(row0)p Fq([)p Fp(i)p Fq(])20 │ │ │ │ │ b Fg(\003)g Fp(col0)p Fq([)p Fp(i)p Fq(])230 b Fp(sums)p │ │ │ │ │ Fq([)p Fp(2)24 b Fq(:)h Fp(3)p Fq(])h(=)2345 356 y Fe(n)p │ │ │ │ │ Fd(\000)p Fe(1)2347 381 y Ff(X)2345 560 y Fe(i)p Fc(=)p │ │ │ │ │ Fe(0)2485 462 y Fp(row0)p Fq([)p Fp(i)p Fq(])20 b Fg(\003)g │ │ │ │ │ @@ -6406,18 +6398,18 @@ │ │ │ │ │ Fq(])19 b Fg(\003)i Fp(col1)p Fq([)p Fp(i)p Fq(])98 b │ │ │ │ │ Fp(sums)p Fq([)p Fp(10)24 b Fq(:)i Fp(11)p Fq(])f(=)2345 │ │ │ │ │ 5241 y Fe(n)p Fd(\000)p Fe(1)2347 5266 y Ff(X)2345 5445 │ │ │ │ │ y Fe(i)p Fc(=)p Fe(0)2485 5346 y Fp(row1)p Fq([)p Fp(i)p │ │ │ │ │ Fq(])20 b Fg(\003)g Fp(col2)p Fq([)p Fp(i)p Fq(])p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(13)66 399 y(26.)46 b Fp(int)h(ZVdotU22)f(\()h(int)g │ │ │ │ │ -(n,)g(double)f(row0[],)g(double)g(row1[],)895 511 y(double)h(col0[],)e │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(13)66 399 y(26.)46 b Fp(int)h(ZVdotU22)f(\()h(int) │ │ │ │ │ +g(n,)g(double)f(row0[],)g(double)g(row1[],)895 511 y(double)h(col0[],)e │ │ │ │ │ (double)h(col1[],)g(double)g(sums[])g(\))i(;)227 681 │ │ │ │ │ y Fq(This)30 b(metho)s(d)g(computes)g(four)g(dot)g(pro)s(ducts.)277 │ │ │ │ │ 918 y Fp(sums)p Fq([)p Fp(0)24 b Fq(:)i Fp(1)p Fq(])f(=)811 │ │ │ │ │ 813 y Fe(n)p Fd(\000)p Fe(1)814 838 y Ff(X)811 1017 y │ │ │ │ │ Fe(i)p Fc(=)p Fe(0)952 918 y Fp(row0)p Fq([)p Fp(i)p │ │ │ │ │ Fq(])19 b Fg(\003)i Fp(col0)p Fq([)p Fp(i)p Fq(])98 b │ │ │ │ │ Fp(sums)p Fq([)p Fp(2)24 b Fq(:)i Fp(3)p Fq(])f(=)2249 │ │ │ │ │ @@ -6479,17 +6471,17 @@ │ │ │ │ │ Fq(])19 b Fg(\003)i Fp(col0)p Fq([)p Fp(i)p Fq(])66 5125 │ │ │ │ │ y(31.)46 b Fp(int)h(ZVdotC33)f(\()h(int)g(n,)g(double)f(row0[],)g │ │ │ │ │ (double)g(row1[],)g(double)g(row2[],)895 5238 y(double)h(col0[],)e │ │ │ │ │ (double)h(col1[],)g(double)g(col2[],)g(double)g(sums[])g(\))i(;)227 │ │ │ │ │ 5407 y Fq(This)30 b(metho)s(d)g(computes)g(nine)g(dot)h(pro)s(ducts.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ -TeXDict begin 14 13 bop 0 100 a Fq(14)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 277 462 a Fp(sums)p │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fq(14)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 277 462 a Fp(sums)p │ │ │ │ │ Fq([)p Fp(0)p Fq(;)15 b Fp(1)p Fq(])25 b(=)776 356 y │ │ │ │ │ Fe(n)p Fd(\000)p Fe(1)778 381 y Ff(X)776 560 y Fe(i)p │ │ │ │ │ Fc(=)p Fe(0)p 916 384 290 4 v 916 462 a Fp(row0)p Fq([)p │ │ │ │ │ Fp(i)p Fq(])20 b Fg(\003)g Fp(col0)p Fq([)p Fp(i)p Fq(])230 │ │ │ │ │ b Fp(sums)p Fq([)p Fp(2)24 b Fq(:)h Fp(3)p Fq(])h(=)2345 │ │ │ │ │ 356 y Fe(n)p Fd(\000)p Fe(1)2347 381 y Ff(X)2345 560 │ │ │ │ │ y Fe(i)p Fc(=)p Fe(0)p 2485 384 V 2485 462 a Fp(row0)p │ │ │ │ │ @@ -6595,18 +6587,18 @@ │ │ │ │ │ b Fg(\003)i Fp(col1)p Fq([)p Fp(i)p Fq(])98 b Fp(sums)p │ │ │ │ │ Fq([)p Fp(10)24 b Fq(:)i Fp(11)p Fq(])f(=)2345 5241 y │ │ │ │ │ Fe(n)p Fd(\000)p Fe(1)2347 5266 y Ff(X)2345 5445 y Fe(i)p │ │ │ │ │ Fc(=)p Fe(0)p 2485 5268 V 2485 5346 a Fp(row1)p Fq([)p │ │ │ │ │ Fp(i)p Fq(])20 b Fg(\003)g Fp(col2)p Fq([)p Fp(i)p Fq(])p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(15)66 399 y(35.)46 b Fp(int)h(ZVdotC22)f(\()h(int)g │ │ │ │ │ -(n,)g(double)f(row0[],)g(double)g(row1[],)895 511 y(double)h(col0[],)e │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(15)66 399 y(35.)46 b Fp(int)h(ZVdotC22)f(\()h(int) │ │ │ │ │ +g(n,)g(double)f(row0[],)g(double)g(row1[],)895 511 y(double)h(col0[],)e │ │ │ │ │ (double)h(col1[],)g(double)g(sums[])g(\))i(;)227 669 │ │ │ │ │ y Fq(This)30 b(metho)s(d)g(computes)g(four)g(dot)g(pro)s(ducts.)277 │ │ │ │ │ 895 y Fp(sums)p Fq([)p Fp(0)24 b Fq(:)i Fp(1)p Fq(])f(=)811 │ │ │ │ │ 789 y Fe(n)p Fd(\000)p Fe(1)814 814 y Ff(X)811 993 y │ │ │ │ │ Fe(i)p Fc(=)p Fe(0)p 952 817 290 4 v 952 895 a Fp(row0)p │ │ │ │ │ Fq([)p Fp(i)p Fq(])19 b Fg(\003)i Fp(col0)p Fq([)p Fp(i)p │ │ │ │ │ Fq(])98 b Fp(sums)p Fq([)p Fp(2)24 b Fq(:)i Fp(3)p Fq(])f(=)2249 │ │ │ │ │ @@ -6673,17 +6665,17 @@ │ │ │ │ │ (y[],)h(double)f(x[],)g(int)h(index[])f(\))i(;)227 5047 │ │ │ │ │ y(y[i])f(=)g(x[index[i]])28 b Fq(for)i Fp(0)47 b(<=)g(i)h(<)f(n)p │ │ │ │ │ Fq(.)66 5249 y(41.)f Fp(double)g(ZVmaxabs)g(\()h(int)g(n,)g(double)g │ │ │ │ │ (y[])f(\))i(;)227 5407 y Fq(This)30 b(metho)s(d)g(returns)f(the)h │ │ │ │ │ (maxim)m(um)h(magnitude)f(of)h(en)m(tries)g(in)f Fp(y[0:n-1])p │ │ │ │ │ Fq(.)p eop end │ │ │ │ │ %%Page: 16 16 │ │ │ │ │ -TeXDict begin 16 15 bop 0 100 a Fq(16)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 66 399 a Fq(42.)46 │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fq(16)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 66 399 a Fq(42.)46 │ │ │ │ │ b Fp(double)g(ZVminabs)g(\()h(int)g(n,)g(double)g(y[])f(\))i(;)227 │ │ │ │ │ 560 y Fq(This)30 b(metho)s(d)g(returns)f(the)h(minim)m(um)g(magnitude)g │ │ │ │ │ (of)h(en)m(tries)g(in)f Fp(y[0:n-1])p Fq(.)66 771 y(43.)46 │ │ │ │ │ b Fp(void)h(ZVscale)f(\()h(int)g(n,)g(double)f(y[],)h(double)f(areal,)g │ │ │ │ │ (double)g(aimag)h(\))g(;)227 933 y Fq(This)29 b(metho)s(d)f(scales)i(a) │ │ │ │ │ g(v)m(ector)g Fp(y[])e Fq(b)m(y)h Fp(\(areal,aimag\))p │ │ │ │ │ Fq(,)d(i.e.,)31 b Fp(y[i])46 b(*=)i(\(areal,aimag\))p │ │ │ │ │ @@ -6740,17 +6732,17 @@ │ │ │ │ │ y(4.)46 b Fp(void)h(IVfprintf)e(\()j(FILE)e(*fp,)h(int)g(n,)g(int)g │ │ │ │ │ (y[])g(\))g(;)227 5294 y Fq(This)27 b(metho)s(d)g(prin)m(ts)g │ │ │ │ │ Fp(n)g Fq(en)m(tries)i(in)e Fp(y[])g Fq(to)h(\014le)g │ │ │ │ │ Fp(fp)p Fq(.)39 b(The)27 b(format)h(is)f(new)h(line)f(follo)m(w)m(ed)j │ │ │ │ │ (b)m(y)d(lines)h(of)g(\014v)m(e)227 5407 y Fp(int)p Fq('s)i(in)g │ │ │ │ │ Fp(")47 b(\0454d")30 b Fq(format.)p eop end │ │ │ │ │ %%Page: 17 17 │ │ │ │ │ -TeXDict begin 17 16 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(17)111 399 y(5.)46 b Fp(int)h(IVfp80)f(\()i(FILE)e │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(17)111 399 y(5.)46 b Fp(int)h(IVfp80)f(\()i(FILE)e │ │ │ │ │ (*fp,)h(int)g(n,)g(int)g(y[],)g(int)g(column,)e(int)i(*pierr)f(\))i(;) │ │ │ │ │ 227 549 y Fq(This)21 b(metho)s(d)g(prin)m(ts)g Fp(n)g │ │ │ │ │ Fq(en)m(tries)h(in)g Fp(y[])e Fq(to)i(\014le)g Fp(fp)p │ │ │ │ │ Fq(.)37 b(The)21 b(metho)s(d)g(splices)h(v)m(ectors)h(together)g(or)f │ │ │ │ │ (naturally)227 662 y(breaks)33 b(the)h(large)g(v)m(ectors)h(in)m(to)f │ │ │ │ │ (lines.)49 b(The)33 b Fp(column)f Fq(v)-5 b(alue)33 b(is)h(the)f │ │ │ │ │ (presen)m(t)g(lo)s(cation.)51 b(If)33 b(the)g(prin)m(ted)227 │ │ │ │ │ @@ -6814,17 +6806,17 @@ │ │ │ │ │ Fp(ploc)p Fq(.)66 5144 y(15.)46 b Fp(int)h(IVmaxabs)f(\()h(int)g(n,)g │ │ │ │ │ (int)g(y[],)g(int)g(*ploc)f(\))i(;)227 5294 y Fq(This)c(metho)s(d)g │ │ │ │ │ (returns)f(the)i(maxim)m(um)f(magnitude)h(of)g(en)m(tries)g(in)f │ │ │ │ │ Fp(y[0:n-1])e Fq(and)i(puts)g(the)h(\014rst)227 5407 │ │ │ │ │ y(lo)s(cation)32 b(where)e(it)h(w)m(as)g(found)e(in)m(to)i(the)g │ │ │ │ │ (address)e Fp(ploc)p Fq(.)p eop end │ │ │ │ │ %%Page: 18 18 │ │ │ │ │ -TeXDict begin 18 17 bop 0 100 a Fq(18)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 66 399 a Fq(16.)46 │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fq(18)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 66 399 a Fq(16.)46 │ │ │ │ │ b Fp(int)h(IVmin)g(\()g(int)g(n,)g(int)g(y[],)g(int)g(*ploc)f(\))h(;) │ │ │ │ │ 227 554 y Fq(This)25 b(metho)s(d)h(returns)f(the)h(minim)m(um)f(en)m │ │ │ │ │ (try)h(in)g Fp(y[0:n-1])d Fq(and)j(puts)f(the)h(\014rst)f(lo)s(cation)j │ │ │ │ │ (where)d(it)i(w)m(as)227 667 y(found)i(in)m(to)j(the)e(address)g │ │ │ │ │ Fp(ploc)p Fq(.)66 866 y(17.)46 b Fp(int)h(IVminabs)f(\()h(int)g(n,)g │ │ │ │ │ (int)g(y[],)g(int)g(*ploc)f(\))i(;)227 1022 y Fq(This)29 │ │ │ │ │ b(metho)s(d)f(returns)g(the)h(minim)m(um)f(magnitude)i(of)f(en)m(tries) │ │ │ │ │ @@ -6880,17 +6872,17 @@ │ │ │ │ │ 5294 y Fq(This)30 b(is)g(the)g(allo)s(cator)i(and)e(initializer)i │ │ │ │ │ (metho)s(d)d(for)h Fp(float)f Fq(v)m(ectors.)42 b(Storage)31 │ │ │ │ │ b(for)f(an)g(arra)m(y)g(with)g(size)227 5407 y Fp(n)g │ │ │ │ │ Fq(is)h(found)e(and)h(eac)m(h)h(en)m(try)g(is)f(\014lled)g(with)g │ │ │ │ │ Fp(val)p Fq(.)40 b(A)31 b(p)s(oin)m(ter)f(to)h(the)g(arra)m(y)g(is)f │ │ │ │ │ (returned.)p eop end │ │ │ │ │ %%Page: 19 19 │ │ │ │ │ -TeXDict begin 19 18 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(19)111 399 y(2.)46 b Fp(float)h(*)g(FVinit2)f(\()h │ │ │ │ │ +TeXDict begin 19 18 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(19)111 399 y(2.)46 b Fp(float)h(*)g(FVinit2)f(\()h │ │ │ │ │ (int)g(n)h(\))f(;)227 549 y Fq(This)32 b(is)h(an)f(allo)s(cator)j │ │ │ │ │ (metho)s(d)d(for)h Fp(float)e Fq(v)m(ectors.)49 b(Storage)34 │ │ │ │ │ b(for)f(an)f(arra)m(y)h(with)g(size)g Fp(n)g Fq(is)f(found.)47 │ │ │ │ │ b(A)227 662 y(p)s(oin)m(ter)31 b(to)g(the)f(arra)m(y)h(is)g(returned.) │ │ │ │ │ 39 b(Note,)32 b(on)e(return,)g(there)g(will)h(lik)m(ely)h(b)s(e)e │ │ │ │ │ (garbage)h(in)g(the)f(arra)m(y)-8 b(.)111 850 y(3.)46 │ │ │ │ │ b Fp(void)h(FVfree)f(\()h(int)g(vec[])g(\))g(;)227 1001 │ │ │ │ │ @@ -6950,17 +6942,17 @@ │ │ │ │ │ g(index[])f(\))h(;)227 5068 y(y[i])g(=)g(x[index[i]])28 │ │ │ │ │ b Fq(for)i Fp(0)47 b(<=)g(i)h(<)f(n)p Fq(.)66 5257 y(14.)f │ │ │ │ │ Fp(void)h(FVgatherAddZero)d(\()j(int)g(n,)g(float)f(y[],)h(float)f │ │ │ │ │ (x[],)h(int)g(index[])f(\))h(;)227 5407 y(y[i])g(+=)g(x[index[i]])27 │ │ │ │ │ b Fq(and)j Fp(x[index[i]])45 b(=)i(0)30 b Fq(for)g Fp(0)48 │ │ │ │ │ b(<=)f(i)h(<)f(n)p Fq(.)p eop end │ │ │ │ │ %%Page: 20 20 │ │ │ │ │ -TeXDict begin 20 19 bop 0 100 a Fq(20)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 66 399 a Fq(15.)46 │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fq(20)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 66 399 a Fq(15.)46 │ │ │ │ │ b Fp(void)h(FVgatherZero)d(\()k(int)f(n,)g(float)f(y[],)h(float)f(x[],) │ │ │ │ │ h(int)g(index[])f(\))h(;)227 549 y(y[i])g(=)g(x[index[i]])28 │ │ │ │ │ b Fq(and)h Fp(x[index[i]])45 b(=)j(0)66 738 y Fq(16.)e │ │ │ │ │ Fp(void)h(FVinvPerm)e(\()j(int)f(n,)g(float)f(y[],)h(int)g(index[])e │ │ │ │ │ (\))j(;)227 888 y Fq(This)26 b(metho)s(d)g(p)s(erm)m(utes)g(the)g(v)m │ │ │ │ │ (ector)j(y)d(as)h(follo)m(ws.)40 b(i.e.,)29 b Fp(y[index[i]])45 │ │ │ │ │ b(:=)i(y[i])p Fq(.)38 b(See)27 b Fp(FVperm\(\))d Fq(for)227 │ │ │ │ │ @@ -7015,17 +7007,17 @@ │ │ │ │ │ (int)g(index[],)e(float)h(x[])h(\))h(;)227 5294 y Fq(This)27 │ │ │ │ │ b(metho)s(d)g(scatters)i Fp(n)f Fq(en)m(tries)g(of)g │ │ │ │ │ Fp(x[])f Fq(in)m(to)i Fp(y[])e Fq(as)h(follo)m(ws,)i │ │ │ │ │ Fp(y[index[i]])44 b(=)k(x[i])26 b Fq(and)i Fp(x[i])e │ │ │ │ │ Fq(for)227 5407 y Fp(0)48 b(<=)f(i)g(<)h(n)p Fq(.)p eop │ │ │ │ │ end │ │ │ │ │ %%Page: 21 21 │ │ │ │ │ -TeXDict begin 21 20 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(21)66 399 y(27.)46 b Fp(void)h(FVsub)f(\()i(int)f │ │ │ │ │ +TeXDict begin 21 20 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(21)66 399 y(27.)46 b Fp(void)h(FVsub)f(\()i(int)f │ │ │ │ │ (n,)g(float)f(y[],)h(float)f(x[])h(\))h(;)227 546 y Fq(This)30 │ │ │ │ │ b(metho)s(d)g(subtracts)g Fp(n)g Fq(en)m(tries)h(from)f │ │ │ │ │ Fp(x[])f Fq(to)j Fp(y[])p Fq(,)d(i.e.,)j Fp(y[i])47 b(-=)g(x[i])29 │ │ │ │ │ b Fq(for)h Fp(0)48 b(<=)f(i)g(<)h(n)p Fq(.)66 729 y(28.)e │ │ │ │ │ Fp(float)h(FVsum)f(\()h(int)g(n,)h(float)e(y[])h(\))g(;)227 │ │ │ │ │ 877 y Fq(This)30 b(metho)s(d)g(returns)f(the)h(sum)g(of)g(the)h │ │ │ │ │ (\014rst)f Fp(n)g Fq(en)m(tries)h(in)f(the)g(v)m(ector)i │ │ │ │ │ @@ -7088,17 +7080,17 @@ │ │ │ │ │ Fq(is)f(found)f(and)h(eac)m(h)h(en)m(try)g(is)f(\014lled)h(with)f │ │ │ │ │ Fp(NULL)p Fq(.)f(A)i(p)s(oin)m(ter)f(to)h(the)g(arra)m(y)g(is)f │ │ │ │ │ (returned.)111 5259 y(2.)46 b Fp(void)h(PDVfree)f(\()h(double)f │ │ │ │ │ (**p_vec)g(\))i(;)227 5407 y Fq(This)30 b(metho)s(d)g(releases)h(the)g │ │ │ │ │ (storage)h(tak)m(en)f(b)m(y)f Fp(p)p 1993 5407 V 34 w(vec[])p │ │ │ │ │ Fq(.)p eop end │ │ │ │ │ %%Page: 22 22 │ │ │ │ │ -TeXDict begin 22 21 bop 0 100 a Fq(22)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 111 399 a Fq(3.)46 │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fq(22)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 111 399 a Fq(3.)46 │ │ │ │ │ b Fp(void)h(PDVcopy)f(\()h(int)g(n,)g(double)f(*p_y[],)g(double)g │ │ │ │ │ (*p_x[])g(\))i(;)227 571 y Fq(This)30 b(metho)s(d)g(copies)h │ │ │ │ │ Fp(n)f Fq(en)m(tries)h(from)f Fp(p)p 1672 571 29 4 v │ │ │ │ │ 34 w(x[])g Fq(to)h Fp(p)p 2039 571 V 34 w(y[])p Fq(,)e(i.e.,)j │ │ │ │ │ Fp(p)p 2491 571 V 34 w(y[i])47 b(=)g(p)p 2907 571 V 34 │ │ │ │ │ w(x[i])30 b Fq(for)g Fp(0)47 b(<=)g(i)h(<)f(n)p Fq(.)111 │ │ │ │ │ 803 y(4.)f Fp(void)h(PDVsetup)e(\()j(int)f(n,)g(int)g(sizes[],)e │ │ │ │ │ @@ -7157,17 +7149,17 @@ │ │ │ │ │ Fp(p)p 1544 5294 V 34 w(vec[])e Fq(as)i(p)s(oin)m(ters)f(in)m(to)i │ │ │ │ │ Fp(vec[])d Fq(giv)m(en)i(b)m(y)g(the)g Fp(sizes[])d Fq(v)m(ector,)227 │ │ │ │ │ 5407 y(i.e.,)32 b Fp(p)p 453 5407 V 34 w(vec[0])46 b(=)i(vec)p │ │ │ │ │ Fq(,)29 b(and)h Fp(p)p 1340 5407 V 34 w(vec[i])46 b(=)i(p)p │ │ │ │ │ 1852 5407 V 34 w(vec[i-1])d(+)j(sizes[i-1])27 b Fq(for)k │ │ │ │ │ Fp(0)47 b(<)g(i)h(<)f(n)p Fq(.)p eop end │ │ │ │ │ %%Page: 23 23 │ │ │ │ │ -TeXDict begin 23 22 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(23)0 399 y Fi(1.2.9)112 b(Sorting)38 │ │ │ │ │ +TeXDict begin 23 22 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(23)0 399 y Fi(1.2.9)112 b(Sorting)38 │ │ │ │ │ b(routines)0 591 y Fo(V)-9 b(alidation)35 b(routines)111 │ │ │ │ │ 784 y Fq(1.)46 b Fp(int)h(IVisascending)d(\()k(int)f(n,)g(int)g(ivec[]) │ │ │ │ │ f(\))h(;)227 897 y(int)g(IVisdescending)d(\()k(int)e(n,)i(int)f(ivec[]) │ │ │ │ │ f(\))h(;)227 1044 y Fq(These)29 b(metho)s(ds)f(returns)f │ │ │ │ │ Fp(1)h Fq(if)h(the)g(arra)m(y)g Fp(ivec[])e Fq(is)i(in)f(ascending)h │ │ │ │ │ (or)g(descending)f(order)g(and)g(returns)227 1156 y Fp(0)i │ │ │ │ │ Fq(otherwise.)111 1337 y(2.)46 b Fp(int)h(DVisascending)d(\()k(int)f │ │ │ │ │ @@ -7217,17 +7209,17 @@ │ │ │ │ │ b(metho)s(ds)g(sort)g(the)h(arra)m(y)f Fp(ivec1[])e Fq(in)m(to)k │ │ │ │ │ (ascending)e(or)g(descending)g(order)g(using)g(an)g(insertion)227 │ │ │ │ │ 5294 y(sort)43 b(and)e(p)s(erm)m(utes)h(the)g(companion)h(arra)m(ys)f │ │ │ │ │ Fp(ivec2[])e Fq(and)i Fp(dvec[])f Fq(in)g(the)i(same)f(fashion.)76 │ │ │ │ │ b(The)227 5407 y Fp(dvec[])29 b Fq(arra)m(y)i(is)f(double)g(precision)h │ │ │ │ │ (complex.)p eop end │ │ │ │ │ %%Page: 24 24 │ │ │ │ │ -TeXDict begin 24 23 bop 0 100 a Fq(24)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 111 399 a Fq(7.)46 │ │ │ │ │ +TeXDict begin 24 23 bop 0 100 a Fq(24)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 111 399 a Fq(7.)46 │ │ │ │ │ b Fp(void)h(DVisortUp)e(\()j(int)f(n,)g(double)f(dvec[])g(\))h(;)227 │ │ │ │ │ 511 y(void)g(DVisortDown)e(\()i(int)g(n,)g(double)f(dvec[])g(\))i(;)227 │ │ │ │ │ 656 y Fq(These)39 b(metho)s(ds)g(sort)g(a)g Fp(double)f │ │ │ │ │ Fq(arra)m(y)h(in)m(to)h(ascending)g(or)f(descending)g(order)f(using)h │ │ │ │ │ (an)g(insertion)227 769 y(sort.)111 945 y(8.)46 b Fp(void)h(DV2isortUp) │ │ │ │ │ e(\()i(int)g(n,)g(double)g(dvec1[],)e(double)h(dvec2[])g(\))h(;)227 │ │ │ │ │ 1058 y(void)g(DV2isortDown)d(\()k(int)f(n,)g(double)f(dvec1[],)g │ │ │ │ │ @@ -7284,17 +7276,17 @@ │ │ │ │ │ 5181 y Fq(These)30 b(metho)s(ds)e(sort)i(the)g(arra)m(y)g │ │ │ │ │ Fp(ivec1[])d Fq(in)m(to)k(ascending)e(or)h(descending)f(order)g(using)g │ │ │ │ │ (a)h(quic)m(k)g(sort)227 5294 y(and)j(p)s(erm)m(utes)g(the)g(companion) │ │ │ │ │ g(arra)m(ys)h Fp(ivec2[])d Fq(and)i Fp(dvec[])f Fq(in)h(the)g(same)h │ │ │ │ │ (fashion.)49 b(The)33 b Fp(dvec[])227 5407 y Fq(arra)m(y)e(is)g(double) │ │ │ │ │ e(precision)i(complex.)p eop end │ │ │ │ │ %%Page: 25 25 │ │ │ │ │ -TeXDict begin 25 24 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(25)111 399 y(7.)46 b Fp(void)h(DVqsortUp)e(\()j │ │ │ │ │ +TeXDict begin 25 24 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(25)111 399 y(7.)46 b Fp(void)h(DVqsortUp)e(\()j │ │ │ │ │ (int)f(n,)g(double)f(dvec[])g(\))h(;)227 511 y(void)g(DVqsortDown)e(\() │ │ │ │ │ i(int)g(n,)g(double)f(dvec[])g(\))i(;)227 658 y Fq(Thes)30 │ │ │ │ │ b(metho)s(ds)g(sort)g(a)h Fp(double)e Fq(arra)m(y)i(in)m(to)g │ │ │ │ │ (ascending)g(or)f(descending)g(order)g(using)g(a)h(quic)m(k)f(sort.)111 │ │ │ │ │ 839 y(8.)46 b Fp(void)h(DV2qsortUp)e(\()i(int)g(n,)g(double)g(dvec1[],) │ │ │ │ │ e(double)h(dvec2[])g(\))h(;)227 952 y(void)g(DV2qsortDown)d(\()k(int)f │ │ │ │ │ (n,)g(double)f(dvec1[],)g(double)g(dvec2[])f(\))j(;)227 │ │ │ │ │ @@ -7360,17 +7352,17 @@ │ │ │ │ │ (stored)g(in)g(the)g(leading)h(lo)s(cations)g(of)f(the)g(v)m(ectors)h │ │ │ │ │ Fp(ivec1[])d Fq(and)i Fp(ivec2[])p Fq(.)227 5294 y Fk(Err)-5 │ │ │ │ │ b(or)37 b(che)-5 b(cking:)45 b Fq(If)33 b Fp(n)47 b(<)h(0)p │ │ │ │ │ Fq(,)33 b(or)g(if)g Fp(ivec1)f Fq(or)h Fp(ivec2)e Fq(is)i │ │ │ │ │ Fp(NULL)p Fq(,)f(an)h(error)g(message)h(is)f(prin)m(ted)f(and)h(the)227 │ │ │ │ │ 5407 y(program)d(exits.)p eop end │ │ │ │ │ %%Page: 26 26 │ │ │ │ │ -TeXDict begin 26 25 bop 0 100 a Fq(26)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 111 399 a Fq(5.)46 │ │ │ │ │ +TeXDict begin 26 25 bop 0 100 a Fq(26)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 111 399 a Fq(5.)46 │ │ │ │ │ b Fp(int)h(IV2DVsortUpAndCompress)42 b(\()47 b(int)g(n,)g(int)g │ │ │ │ │ (ivec1[],)f(int)h(ivec2[],)e(double)h(dvec[])h(\))g(;)227 │ │ │ │ │ 549 y Fq(This)39 b(metho)s(d)g(sorts)g Fp(ivec1[])f Fq(in)m(to)i │ │ │ │ │ (ascending)g(order)f(with)g Fp(ivec2[])e Fq(and)i Fp(dvec[])f │ │ │ │ │ Fq(as)i(companion)227 662 y(v)m(ectors.)56 b(It)35 b(then)f(compresses) │ │ │ │ │ h(the)g(pairs,)h(summing)e(the)h Fp(dvec[])e Fq(en)m(tries)i(for)g │ │ │ │ │ (iden)m(tical)h Fp(\(ivec1[],)227 775 y(ivec2[]\))42 │ │ │ │ │ @@ -7432,17 +7424,17 @@ │ │ │ │ │ 5144 y(4.)46 b Fp(int)h(IP_fp80)f(\()h(FILE)g(*fp,)g(int)g(n,)g(int)g │ │ │ │ │ (y[],)f(int)h(column,)f(int)h(*pierr)f(\))i(;)227 5294 │ │ │ │ │ y Fq(This)29 b(metho)s(d)h(prin)m(ts)f(the)h(singly)h(link)m(ed)f(list) │ │ │ │ │ g(that)h(starts)f(with)g Fp(ip)p Fq(.)40 b(See)30 b Fp(IVfp80\(\))e │ │ │ │ │ Fq(for)i(a)g(description)227 5407 y(of)h(ho)m(w)f(the)h(en)m(tries)g │ │ │ │ │ (are)g(placed)g(on)f(a)h(line.)p eop end │ │ │ │ │ %%Page: 27 27 │ │ │ │ │ -TeXDict begin 27 26 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(27)111 399 y(5.)46 b Fp(IP)h(*)h(IP_mergeUp)d(\()i │ │ │ │ │ +TeXDict begin 27 26 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(27)111 399 y(5.)46 b Fp(IP)h(*)h(IP_mergeUp)d(\()i │ │ │ │ │ (IP)h(*ip1,)e(IP)h(*ip2)g(\))g(;)227 547 y Fq(This)32 │ │ │ │ │ b(metho)s(d)h(merges)g(t)m(w)m(o)h(singly)f(link)m(ed)g(lists)g(in)m │ │ │ │ │ (to)h(one.)49 b(If)32 b(the)h(t)m(w)m(o)h(lists)f(are)h(in)e(ascending) │ │ │ │ │ h(order,)227 660 y(the)e(new)f(list)h(is)f(also)h(in)g(ascending)f │ │ │ │ │ (order.)40 b(The)30 b(head)g(of)h(the)g(new)e(list)i(is)g(returned.)111 │ │ │ │ │ 845 y(6.)46 b Fp(IP)h(*)h(IP_mergeSortUp)c(\()j(IP)g(*ip)g(\))h(;)227 │ │ │ │ │ 993 y Fq(This)30 b(metho)s(d)g(sorts)g(a)h(list)g(in)m(to)g(ascending)g │ │ │ │ │ @@ -7500,17 +7492,17 @@ │ │ │ │ │ b(=)j(NULL)p Fq(.)337 5294 y Fm(\210)e Fq(If)20 b Fp(flag)47 │ │ │ │ │ b(=)g(I2OP)p 1040 5294 V 33 w(BACKWARD)p Fq(,)19 b(the)h(elemen)m(ts)i │ │ │ │ │ (are)e(link)m(ed)h(in)f(a)h(bac)m(kw)m(ard)f(manner,)i(i.e.,)i │ │ │ │ │ Fp(ips[i].next)427 5407 y(=)48 b(&ips[i-1])28 b Fq(for)i │ │ │ │ │ Fp(0)47 b(<)h(i)f(<)h(n)30 b Fq(and)f Fp(ips[0].next)45 │ │ │ │ │ b(=)i(NULL)p Fq(.)p eop end │ │ │ │ │ %%Page: 28 28 │ │ │ │ │ -TeXDict begin 28 27 bop 0 100 a Fq(28)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 111 399 a Fq(3.)46 │ │ │ │ │ +TeXDict begin 28 27 bop 0 100 a Fq(28)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 111 399 a Fq(3.)46 │ │ │ │ │ b Fp(void)h(I2OP_free)e(\()j(I2OP)e(*i2op)h(\))g(;)227 │ │ │ │ │ 546 y Fq(This)30 b(metho)s(d)g(releases)h(the)g(storage)h(based)e(at)h │ │ │ │ │ Fp(*i2op)p Fq(.)111 729 y(4.)46 b Fp(void)h(I2OP_fprintf)d(\()k(FILE)e │ │ │ │ │ (*fp,)h(I2OP)g(*i2op)f(\))i(;)227 876 y Fq(This)30 b(metho)s(d)g(prin)m │ │ │ │ │ (ts)g(the)g(singly)h(link)m(ed)f(list)h(that)g(starts)g(with)f │ │ │ │ │ Fp(i2op)p Fq(.)0 1183 y Fn(1.3)135 b(Driv)l(er)46 b(programs)111 │ │ │ │ │ 1408 y Fq(1.)g Fp(test_sort)g(msglvl)g(msgFile)f(target)i(sortType)e(n) │ │ │ │ │ @@ -7560,17 +7552,17 @@ │ │ │ │ │ (and)f(compress")h(metho)s(ds.)38 b(Use)24 b(the)g(script)227 │ │ │ │ │ 5089 y(\014le)31 b Fp(do)p 476 5089 V 34 w(test)p 702 │ │ │ │ │ 5089 V 33 w(sortUpAndCompress)25 b Fq(for)31 b(testing.)337 │ │ │ │ │ 5294 y Fm(\210)45 b Fq(The)f Fp(msglvl)e Fq(parameter)j(determines)f │ │ │ │ │ (the)g(amoun)m(t)h(of)f(output.)82 b(Use)44 b Fp(msglvl)i(=)i(1)c │ │ │ │ │ Fq(for)g(just)427 5407 y(timing)31 b(output.)p eop end │ │ │ │ │ %%Page: 29 29 │ │ │ │ │ -TeXDict begin 29 28 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(29)337 399 y Fm(\210)45 b Fq(The)33 │ │ │ │ │ +TeXDict begin 29 28 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(29)337 399 y Fm(\210)45 b Fq(The)33 │ │ │ │ │ b Fp(msgFile)e Fq(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ (if)f Fp(msgFile)e Fq(is)i Fp(stdout)p Fq(,)g(then)g(the)427 │ │ │ │ │ 511 y(message)27 b(\014le)f(is)g Fk(stdout)p Fq(,)i(otherwise)e(a)h │ │ │ │ │ (\014le)f(is)f(op)s(ened)g(with)h Fk(app)-5 b(end)28 │ │ │ │ │ b Fq(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 624 │ │ │ │ │ y(data.)337 770 y Fm(\210)45 b Fq(The)30 b Fp(target)f │ │ │ │ │ Fq(parameter)i(denotes)f(the)h(t)m(yp)s(e)g(of)f(v)m(ector\(s\))j(to)e │ │ │ │ │ @@ -7635,17 +7627,17 @@ │ │ │ │ │ y Fp(DVzero\(\))p Fq(,)g(7)1992 4720 y Fp(FVadd\(\))p │ │ │ │ │ Fq(,)g(16)1992 4835 y Fp(FVaxpy\(\))p Fq(,)g(16)1992 │ │ │ │ │ 4949 y Fp(FVaxpyi\(\))p Fq(,)g(16)1992 5064 y Fp(FVcompress\(\))p │ │ │ │ │ Fq(,)f(16)1992 5178 y Fp(FVcopy\(\))p Fq(,)h(17)1992 │ │ │ │ │ 5293 y Fp(FVdot\(\))p Fq(,)g(17)1992 5407 y Fp(FVfill\(\))p │ │ │ │ │ Fq(,)g(17)1905 5656 y(30)p eop end │ │ │ │ │ %%Page: 31 31 │ │ │ │ │ -TeXDict begin 31 30 bop 91 100 992 4 v 1173 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2816 100 V 992 w Fq(31)0 399 y Fp(FVfprintf\(\))p Fq(,)d(16)0 │ │ │ │ │ +TeXDict begin 31 30 bop 91 100 1011 4 v 1192 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2797 100 V 1011 w Fq(31)0 399 y Fp(FVfprintf\(\))p Fq(,)d(16)0 │ │ │ │ │ 513 y Fp(FVfree\(\))p Fq(,)g(16)0 627 y Fp(FVfscanf\(\))p │ │ │ │ │ Fq(,)g(16)0 741 y Fp(FVgather\(\))p Fq(,)g(17)0 855 y │ │ │ │ │ Fp(FVgatherAddZero\(\))p Fq(,)e(17)0 969 y Fp(FVgatherZero\(\))p │ │ │ │ │ Fq(,)h(17)0 1083 y Fp(FVinit\(\))p Fq(,)h(16)0 1197 y │ │ │ │ │ Fp(FVinit2\(\))p Fq(,)g(16)0 1311 y Fp(FVinvPerm\(\))p │ │ │ │ │ Fq(,)g(17)0 1425 y Fp(FVmax\(\))p Fq(,)h(17)0 1539 y │ │ │ │ │ Fp(FVmaxabs\(\))p Fq(,)f(17)0 1654 y Fp(FVmin\(\))p Fq(,)h(17)0 │ │ │ │ │ @@ -7704,17 +7696,17 @@ │ │ │ │ │ Fq(,)h(15)1992 4724 y Fp(IVscatter\(\))p Fq(,)f(15)1992 │ │ │ │ │ 4838 y Fp(IVshuffle\(\))p Fq(,)g(16)1992 4952 y Fp │ │ │ │ │ (IVsortUpAndCompress\(\))p Fq(,)d(22)1992 5066 y Fp(IVsum\(\))p │ │ │ │ │ Fq(,)k(15)1992 5180 y Fp(IVsumabs\(\))p Fq(,)f(15)1992 │ │ │ │ │ 5293 y Fp(IVswap\(\))p Fq(,)h(15)1992 5407 y Fp(IVzero\(\))p │ │ │ │ │ Fq(,)g(16)p eop end │ │ │ │ │ %%Page: 32 32 │ │ │ │ │ -TeXDict begin 32 31 bop 0 100 a Fq(32)p 182 100 992 4 │ │ │ │ │ -v 1174 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(F)-8 │ │ │ │ │ -b(ebruary)30 b(8,)h(2025)p 2909 100 V 0 399 a Fp(IVZVisortDown\(\))p │ │ │ │ │ +TeXDict begin 32 31 bop 0 100 a Fq(32)p 182 100 1011 │ │ │ │ │ +4 v 1193 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(Jan)m(uary)g(7,)h(2024)p 2890 100 V 0 399 a Fp(IVZVisortDown\(\))p │ │ │ │ │ Fq(,)26 b(21)0 511 y Fp(IVZVisortUp\(\))p Fq(,)h(21)0 │ │ │ │ │ 624 y Fp(IVZVqsortDown\(\))p Fq(,)f(22)0 737 y Fp(IVZVqsortUp\(\))p │ │ │ │ │ Fq(,)h(22)0 850 y Fp(IVZVsortUpAndCompress\(\))p Fq(,)d(23)0 │ │ │ │ │ 1040 y Fp(PCVcopy\(\))p Fq(,)k(19)0 1153 y Fp(PCVfree\(\))p │ │ │ │ │ Fq(,)g(18)0 1266 y Fp(PCVinit\(\))p Fq(,)g(18)0 1379 │ │ │ │ │ y Fp(PCVsetup\(\))p Fq(,)g(19)0 1491 y Fp(PDVcopy\(\))p │ │ │ │ │ Fq(,)g(19)0 1604 y Fp(PDVfree\(\))p Fq(,)g(19)0 1717 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -22,15 +22,15 @@ │ │ │ │ │ │ struct _I2OP { │ │ │ │ │ │ int value0 ; │ │ │ │ │ │ int value1 ; │ │ │ │ │ │ void *value2 ; │ │ │ │ │ │ I2OP *next ; │ │ │ │ │ │ } ; │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 1.2 Prototypes and descriptions of Utilities methods │ │ │ │ │ │ This section contains brief descriptions including prototypes of all methods that belong to the │ │ │ │ │ │ Utilities directory. │ │ │ │ │ │ 1.2.1 CV : char vector methods │ │ │ │ │ │ 1. char * CVinit ( int n, char c ) ; │ │ │ │ │ │ This is the allocator and initializer method for char vectors. Storage for an array with size │ │ │ │ │ │ n is found and each entry is filled with character c. A pointer to the array is returned. │ │ │ │ │ │ @@ -54,15 +54,15 @@ │ │ │ │ │ │ 8. int CVfscanf ( FILE *fp, int n, char y[] ) ; │ │ │ │ │ │ This method scans in characters from file fp and places them in the array y[]. It tries to │ │ │ │ │ │ read in n characters, and returns the number that were actually read. │ │ │ │ │ │ 1.2.2 DV : double vector methods │ │ │ │ │ │ 1. double * DVinit ( int n, double val ) ; │ │ │ │ │ │ This is the allocator and initializer method for double vectors. Storage for an array with size │ │ │ │ │ │ n is found and each entry is filled with val. A pointer to the array is returned. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 3 │ │ │ │ │ │ 2. double * DVinit2 ( int n ) ; │ │ │ │ │ │ This is an allocator method for double vectors. Storage for an array with size n is found. A │ │ │ │ │ │ pointer to the array is returned. Note, on return, there will likely be garbage in the array. │ │ │ │ │ │ 3. void DVfree ( int vec[] ) ; │ │ │ │ │ │ This method releases the storage taken by vec[]. │ │ │ │ │ │ 4. void DVfprintf ( FILE *fp, int n, double y[] ) ; │ │ │ │ │ │ This method prints n entries in y[] to file fp. The format is new line followed by lines of six │ │ │ │ │ │ @@ -90,15 +90,15 @@ │ │ │ │ │ │ This method computes this computation. │ │ │ │ │ │ y0[] = y0[] + alpha[0] * x0[] + alpha[1] * x1[] │ │ │ │ │ │ y1[] = y1[] + alpha[2] * x0[] + alpha[3] * x1[] │ │ │ │ │ │ y2[] = y2[] + alpha[4] * x0[] + alpha[5] * x1[] │ │ │ │ │ │ 11. void DVaxpy31 ( int n, double y0[], double y1[], double y2[], │ │ │ │ │ │ double alpha, double x0[], double x1[] ) ; │ │ │ │ │ │ This method computes this computation. │ │ │ │ │ │ - 4 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ y0[] = y0[] + alpha[0] * x0[] │ │ │ │ │ │ y1[] = y1[] + alpha[1] * x0[] │ │ │ │ │ │ y2[] = y2[] + alpha[2] * x0[] │ │ │ │ │ │ 12. void DVaxpy23 ( int n, double y0[], double y1[], │ │ │ │ │ │ double alpha, double x0[], double x1[], double x2[] ) ; │ │ │ │ │ │ This method computes this computation. │ │ │ │ │ │ y0[] = y0[] + alpha[0] * x0[] + alpha[1] * x1[] + alpha[2] * x2[] │ │ │ │ │ │ @@ -121,15 +121,15 @@ │ │ │ │ │ │ y0[] = y0[] + alpha[0] * x0[] + alpha[1] * x1[] │ │ │ │ │ │ 17. void DVaxpy11 ( int n, double y0[], double alpha, double x0[] ) ; │ │ │ │ │ │ This method computes this computation. │ │ │ │ │ │ y0[] = y0[] + alpha[0] * x0[] │ │ │ │ │ │ 18. void DVaxpyi ( int n, double y[], int index[], double alpha, double x[] ) ; │ │ │ │ │ │ This method scatteradds a scaled multiple of n entries from x[] into y[], i.e., y[index[i]] │ │ │ │ │ │ += alpha * x[i] for 0 <= i < n. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 5 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 5 │ │ │ │ │ │ 19. void DVcompress ( int n1, double x1[], double y1[], │ │ │ │ │ │ int n2, double x2[], double y2[] ) ; │ │ │ │ │ │ Given a pair of arrays x1[n1] and y1[n1], fill x2[n2] and y2[n2] with a subset of the │ │ │ │ │ │ (x1[j],y1[j] entries whose distribution is an approximation. │ │ │ │ │ │ 20. void DVcopy ( int n, double y[], double x[] ) ; │ │ │ │ │ │ This method copies n entries from x[] to y[], i.e., y[i] = x[i] for 0 <= i < n. │ │ │ │ │ │ 21. int DVdot ( int n, double y[], double x[] ) ; │ │ │ │ │ │ @@ -167,15 +167,15 @@ │ │ │ │ │ │ i=0 │ │ │ │ │ │ n−1 │ │ │ │ │ │ sums[1] = Xrow1[i]∗col0[i] │ │ │ │ │ │ i=0 │ │ │ │ │ │ n−1 │ │ │ │ │ │ sums[2] = Xrow2[i]∗col0[i] │ │ │ │ │ │ i=0 │ │ │ │ │ │ - 6 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 25. int DVdot23 ( int n, double row0[], double row1[], │ │ │ │ │ │ double col0[], double col1[], double col2[], double sums[] ) ; │ │ │ │ │ │ This method computes six dot products. │ │ │ │ │ │ n−1 n−1 n−1 │ │ │ │ │ │ sums[0] = Xrow0[i]∗col0[i] sums[1] = Xrow0[i]∗col1[i] sums[2] = Xrow0[i]∗col2[i] │ │ │ │ │ │ i=0 i=0 i=0 │ │ │ │ │ │ n−1 n−1 n−1 │ │ │ │ │ │ @@ -212,15 +212,15 @@ │ │ │ │ │ │ sums[0] = Xrow0[i]∗col0[i] sums[1] = Xrow0[i]∗col1[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ 30. int DVdot11 ( int n, double row0[], double col0[], double sums[] ) ; │ │ │ │ │ │ This method computes one dot product. │ │ │ │ │ │ n−1 │ │ │ │ │ │ sums[0] = Xrow0[i]∗col0[i] │ │ │ │ │ │ i=0 │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 7 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 7 │ │ │ │ │ │ 31. int DVdoti ( int n, double y[], int index[], double x[] ) ; │ │ │ │ │ │ n−1 │ │ │ │ │ │ This method returns the indexed dot product Xy[index[i]]∗x[i]. │ │ │ │ │ │ i=0 │ │ │ │ │ │ 32. void DVfill ( int n, double y[], double val ) ; │ │ │ │ │ │ This method fills n entries in y[] with val, i.e., y[i] = val for 0 <= i < n. │ │ │ │ │ │ 33. void DVgather ( int n, double y[], double x[], int index[] ) ; │ │ │ │ │ │ @@ -248,15 +248,15 @@ │ │ │ │ │ │ This method permutes the vector y as follows. i.e., y[i] := y[index[i]]. See DVinvPerm() │ │ │ │ │ │ for a similar function. │ │ │ │ │ │ 42. void DVramp ( int n, double y[], double start, double inc ) ; │ │ │ │ │ │ This method fills n entries in y[] with values start, start + inc, start + 2*inc, start │ │ │ │ │ │ + 3*inc, etc. │ │ │ │ │ │ 43. void DVscale ( int n, double y[], double alpha ) ; │ │ │ │ │ │ This method scales a vector y[] by alpha, i.e., y[i] *= alpha. for 0 <= i < n. │ │ │ │ │ │ - 8 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 44. void DVscale2 ( int n, double x[], double y[], │ │ │ │ │ │ double a, double b, double c, double d ) ; │ │ │ │ │ │ This method scales two vectors y[] by a 2 ×2 matrix, i.e., │ │ │ │ │ │ " x[0] . . . x[n−1] # := " a b #" x[0] ... x[n−1] #. │ │ │ │ │ │ y[0] . . . y[n−1] c d y[0] . . . y[n−1] │ │ │ │ │ │ 45. void DVscatter ( int n, double y[], int index[], double x[] ) ; │ │ │ │ │ │ This method scatters n entries of x[] into y[] as follows, y[index[i]] = x[i] for 0 <= i │ │ │ │ │ │ @@ -284,15 +284,15 @@ │ │ │ │ │ │ This method swaps the x[] and y[] vectors as follows. i.e., y[i] := x[i] and x[i] := │ │ │ │ │ │ y[i] for 0 <= i < n. │ │ │ │ │ │ 53. void DVzero ( int n, double y[] ) ; │ │ │ │ │ │ This method zeroes n entries in y[], i.e., y[i] = 0 for 0 <= i < n. │ │ │ │ │ │ 54. void DVshuffle ( int n, double y[], int seed ) ; │ │ │ │ │ │ This method shuffles the first n entries in y[]. The value seed is the seed to a random number │ │ │ │ │ │ generator, and one can get repeatable behavior by repeating seed. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 9 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 9 │ │ │ │ │ │ 1.2.3 ZV : double complex vector methods │ │ │ │ │ │ Adoubleprecisioncomplexvector oflengthnissimplya doubleprecisionvector oflength2n. There │ │ │ │ │ │ is a separate ZVinit() allocator and initializer method, since it requires a real and imaginary part │ │ │ │ │ │ to fill the vector. However, there is no ZVinit2() method (which allocates without initializing the │ │ │ │ │ │ entries) nor a ZVfree() method to free the entries; the DVinit2() and DVfree() methods can be │ │ │ │ │ │ used. Similarly, there is no ZVfscanf() method, instead the DVfscanf() method can be used. │ │ │ │ │ │ 1. double * ZVinit ( int n, double real, double imag ) ; │ │ │ │ │ │ @@ -320,15 +320,15 @@ │ │ │ │ │ │ 6. void ZVaxpy ( int n, double y[], double areal, double aimag, double x[] ) ; │ │ │ │ │ │ Thismethodaddsascaledmultipleofnentriesfromx[]intoy[],i.e., y[i] += (areal,aimag) │ │ │ │ │ │ * x[i] for 0 <= i < n. │ │ │ │ │ │ 7. void ZVaxpy2 ( int n, double z[], double areal, double aimag, │ │ │ │ │ │ double x[], double breal, double bimag, double y[] ) ; │ │ │ │ │ │ This method adds a scaled multiple of two vectors x[] and y[] to another vector z[], i.e., │ │ │ │ │ │ i.e., z[i] += (areal,aimag) * x[i] + (breal,bimag) * y[i] for 0 <= i < n. │ │ │ │ │ │ - 10 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 8. void ZVaxpy33 ( int n, double y0[], double y1[], double y2[], │ │ │ │ │ │ double alpha[], double x0[], double x1[], double x2[] ) ; │ │ │ │ │ │ This method computes the following. │ │ │ │ │ │ y0[] = y0[] + alpha[0:1] * x0[] + alpha[2:3] * x1[] + alpha[4:5] * x2[] │ │ │ │ │ │ y1[] = y1[] + alpha[6:7] * x0[] + alpha[8:9] * x1[] + alpha[10:11] * x2[] │ │ │ │ │ │ y2[] = y2[] + alpha[12:13] * x0[] + alpha[14:15] * x1[] + alpha[16:17] * x2[] │ │ │ │ │ │ 9. void ZVaxpy32 ( int n, double y0[], double y1[], double y2[], │ │ │ │ │ │ @@ -354,15 +354,15 @@ │ │ │ │ │ │ y0[] = y0[] + alpha[0:1] * x0[] + alpha[2:3] * x1[] │ │ │ │ │ │ y1[] = y1[] + alpha[4:5] * x0[] + alpha[6:7] * x1[] │ │ │ │ │ │ 13. void ZVaxpy21 ( int n, double y0[], double y1[], │ │ │ │ │ │ double alpha[], double x0[] ) ; │ │ │ │ │ │ This method computes the following. │ │ │ │ │ │ y0[] = y0[] + alpha[0:1] * x0[] │ │ │ │ │ │ y1[] = y1[] + alpha[2:3] * x0[] │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 11 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 11 │ │ │ │ │ │ 14. void ZVaxpy13 ( int n, double y0[], │ │ │ │ │ │ double alpha[], double x0[], double x1[], double x2[] ) ; │ │ │ │ │ │ This method computes the following. │ │ │ │ │ │ y0[] = y0[] + alpha[0:1] * x0[] + alpha[2:3] * x1[] + alpha[4:5] * x2[] │ │ │ │ │ │ 15. void ZVaxpy12 ( int n, double y0[], double alpha[], double x0[], double x1[] ) ; │ │ │ │ │ │ This method computes the following. │ │ │ │ │ │ y0[] = y0[] + alpha[0:1] * x0[] + alpha[2:3] * x1[] │ │ │ │ │ │ @@ -389,15 +389,15 @@ │ │ │ │ │ │ This method fills *prdot and *pidot with the real and imaginary parts of the indexed dot │ │ │ │ │ │ n−1 │ │ │ │ │ │ product Xy[index[i]]∗x[i]. │ │ │ │ │ │ i=0 │ │ │ │ │ │ 22. int ZVdotU33 ( int n, double row0[], double row1[], double row2[], │ │ │ │ │ │ double col0[], double col1[], double col2[], double sums[] ) ; │ │ │ │ │ │ This method computes nine dot products. │ │ │ │ │ │ - 12 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[0;1] = Xrow0[i]∗col0[i] sums[2 : 3] = Xrow0[i]∗col1[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[4 : 5] = Xrow0[i]∗col2[i] sums[6 : 7] = Xrow1[i]∗col0[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ @@ -441,15 +441,15 @@ │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[4 : 5] = Xrow0[i]∗col2[i] sums[6 : 7] = Xrow1[i]∗col0[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[8 : 9] = Xrow1[i]∗col1[i] sums[10 : 11] = Xrow1[i]∗col2[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 13 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 13 │ │ │ │ │ │ 26. int ZVdotU22 ( int n, double row0[], double row1[], │ │ │ │ │ │ double col0[], double col1[], double sums[] ) ; │ │ │ │ │ │ This method computes four dot products. │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[0 : 1] = Xrow0[i]∗col0[i] sums[2 : 3] = Xrow0[i]∗col1[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ @@ -483,15 +483,15 @@ │ │ │ │ │ │ This method computes one dot product. │ │ │ │ │ │ n−1 │ │ │ │ │ │ sums[0 : 1] = Xrow0[i]∗col0[i] │ │ │ │ │ │ i=0 │ │ │ │ │ │ 31. int ZVdotC33 ( int n, double row0[], double row1[], double row2[], │ │ │ │ │ │ double col0[], double col1[], double col2[], double sums[] ) ; │ │ │ │ │ │ This method computes nine dot products. │ │ │ │ │ │ - 14 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 14 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[0;1] = Xrow0[i]∗col0[i] sums[2 : 3] = Xrow0[i]∗col1[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[4 : 5] = Xrow0[i]∗col2[i] sums[6 : 7] = Xrow1[i]∗col0[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ @@ -535,15 +535,15 @@ │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[4 : 5] = Xrow0[i]∗col2[i] sums[6 : 7] = Xrow1[i]∗col0[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[8 : 9] = Xrow1[i]∗col1[i] sums[10 : 11] = Xrow1[i]∗col2[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 15 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 15 │ │ │ │ │ │ 35. int ZVdotC22 ( int n, double row0[], double row1[], │ │ │ │ │ │ double col0[], double col1[], double sums[] ) ; │ │ │ │ │ │ This method computes four dot products. │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ sums[0 : 1] = Xrow0[i]∗col0[i] sums[2 : 3] = Xrow0[i]∗col1[i] │ │ │ │ │ │ i=0 i=0 │ │ │ │ │ │ n−1 n−1 │ │ │ │ │ │ @@ -578,15 +578,15 @@ │ │ │ │ │ │ n−1 │ │ │ │ │ │ sums[0 : 1] = Xrow0[i]∗col0[i] │ │ │ │ │ │ i=0 │ │ │ │ │ │ 40. void ZVgather ( int n, double y[], double x[], int index[] ) ; │ │ │ │ │ │ y[i] = x[index[i]] for 0 <= i < n. │ │ │ │ │ │ 41. double ZVmaxabs ( int n, double y[] ) ; │ │ │ │ │ │ This method returns the maximum magnitude of entries in y[0:n-1]. │ │ │ │ │ │ - 16 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 16 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 42. double ZVminabs ( int n, double y[] ) ; │ │ │ │ │ │ This method returns the minimum magnitude of entries in y[0:n-1]. │ │ │ │ │ │ 43. void ZVscale ( int n, double y[], double areal, double aimag ) ; │ │ │ │ │ │ This method scales a vector y[] by (areal,aimag), i.e., y[i] *= (areal,aimag). for 0 <= │ │ │ │ │ │ i < n. │ │ │ │ │ │ 44. void ZVscale2 ( int n, double x[], double y[], │ │ │ │ │ │ double areal, double aimag, double breal, double bimag, │ │ │ │ │ │ @@ -609,15 +609,15 @@ │ │ │ │ │ │ This is an allocator method for int vectors. Storage for an array with size n is found. A │ │ │ │ │ │ pointer to the array is returned. Note, on return, there will likely be garbage in the array. │ │ │ │ │ │ 3. void IVfree ( int vec[] ) ; │ │ │ │ │ │ This method releases the storage taken by vec[]. │ │ │ │ │ │ 4. void IVfprintf ( FILE *fp, int n, int y[] ) ; │ │ │ │ │ │ This method prints n entries in y[] to file fp. The format is new line followed by lines of five │ │ │ │ │ │ int’s in " %4d" format. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 17 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 17 │ │ │ │ │ │ 5. int IVfp80 ( FILE *fp, int n, int y[], int column, int *pierr ) ; │ │ │ │ │ │ Thismethodprintsnentriesiny[]tofilefp. Themethodsplicesvectorstogetherornaturally │ │ │ │ │ │ breaks the large vectors into lines. The column value is the present location. If the printed │ │ │ │ │ │ value of an array entry will not fit within the eighty columns of the present line, a newline │ │ │ │ │ │ character is written and the value starts a new line. The number of the present column in │ │ │ │ │ │ the line is returned. If *pierr < 0, an IO error has occured. │ │ │ │ │ │ 6. int IVfscanf ( FILE *fp, int n, int y[] ) ; │ │ │ │ │ │ @@ -645,15 +645,15 @@ │ │ │ │ │ │ returns a location where target is found. If target is not in y[], -1 is returned. │ │ │ │ │ │ 14. int IVmax ( int n, int y[], int *ploc ) ; │ │ │ │ │ │ This method returns the maximum entry in y[0:n-1] and puts the first location where it │ │ │ │ │ │ was found into the address ploc. │ │ │ │ │ │ 15. int IVmaxabs ( int n, int y[], int *ploc ) ; │ │ │ │ │ │ This method returns the maximum magnitude of entries in y[0:n-1] and puts the first │ │ │ │ │ │ location where it was found into the address ploc. │ │ │ │ │ │ - 18 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 18 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 16. int IVmin ( int n, int y[], int *ploc ) ; │ │ │ │ │ │ This method returns the minimum entry in y[0:n-1] and puts the first location where it was │ │ │ │ │ │ found into the address ploc. │ │ │ │ │ │ 17. int IVminabs ( int n, int y[], int *ploc ) ; │ │ │ │ │ │ This method returns the minimum magnitude of entries in y[0:n-1] and puts the first loca- │ │ │ │ │ │ tion where it was found into the address ploc. │ │ │ │ │ │ 18. void IVperm ( int n, int y[], int index[] ) ; │ │ │ │ │ │ @@ -681,15 +681,15 @@ │ │ │ │ │ │ 25. void IVshuffle ( int n, int y[], int seed ) ; │ │ │ │ │ │ This method shuffles the first n entries in y[]. The value seed is the seed to a random number │ │ │ │ │ │ generator, and one can get repeatable behavior by repeating seed. │ │ │ │ │ │ 1.2.5 FV : float vector methods │ │ │ │ │ │ 1. float * FVinit ( int n, float val ) ; │ │ │ │ │ │ This is the allocator and initializer method for float vectors. Storage for an array with size │ │ │ │ │ │ n is found and each entry is filled with val. A pointer to the array is returned. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 19 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 19 │ │ │ │ │ │ 2. float * FVinit2 ( int n ) ; │ │ │ │ │ │ This is an allocator method for float vectors. Storage for an array with size n is found. A │ │ │ │ │ │ pointer to the array is returned. Note, on return, there will likely be garbage in the array. │ │ │ │ │ │ 3. void FVfree ( int vec[] ) ; │ │ │ │ │ │ This method releases the storage taken by vec[]. │ │ │ │ │ │ 4. void FVfprintf ( FILE *fp, int n, float y[] ) ; │ │ │ │ │ │ This method prints n entries in y[] to file fp. The format is new line followed by lines of six │ │ │ │ │ │ @@ -716,15 +716,15 @@ │ │ │ │ │ │ i=0 │ │ │ │ │ │ 12. void FVfill ( int n, float y[], float val ) ; │ │ │ │ │ │ This method fills n entries in y[] with val, i.e., y[i] = val for 0 <= i < n. │ │ │ │ │ │ 13. void FVgather ( int n, float y[], float x[], int index[] ) ; │ │ │ │ │ │ y[i] = x[index[i]] for 0 <= i < n. │ │ │ │ │ │ 14. void FVgatherAddZero ( int n, float y[], float x[], int index[] ) ; │ │ │ │ │ │ y[i] += x[index[i]] and x[index[i]] = 0 for 0 <= i < n. │ │ │ │ │ │ - 20 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 20 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 15. void FVgatherZero ( int n, float y[], float x[], int index[] ) ; │ │ │ │ │ │ y[i] = x[index[i]] and x[index[i]] = 0 │ │ │ │ │ │ 16. void FVinvPerm ( int n, float y[], int index[] ) ; │ │ │ │ │ │ This method permutes the vector y as follows. i.e., y[index[i]] := y[i]. See FVperm() for │ │ │ │ │ │ a similar function. │ │ │ │ │ │ 17. float FVmax ( int n, float y[], int *ploc ) ; │ │ │ │ │ │ This method returns the maximum entry in y[0:n-1] and puts the first location where it │ │ │ │ │ │ @@ -751,15 +751,15 @@ │ │ │ │ │ │ < n. │ │ │ │ │ │ 25. void FVscatterAddZero ( int n, float y[], int index[], float x[] ) ; │ │ │ │ │ │ This method scatters/adds n entries of x[] into y[] as follows, y[index[i]] += x[i] and │ │ │ │ │ │ x[i] for 0 <= i < n. │ │ │ │ │ │ 26. void FVscatterZero ( int n, float y[], int index[], float x[] ) ; │ │ │ │ │ │ This method scatters n entries of x[] into y[] as follows, y[index[i]] = x[i] and x[i] for │ │ │ │ │ │ 0 <= i < n. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 21 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 21 │ │ │ │ │ │ 27. void FVsub ( int n, float y[], float x[] ) ; │ │ │ │ │ │ This method subtracts n entries from x[] to y[], i.e., y[i] -= x[i] for 0 <= i < n. │ │ │ │ │ │ 28. float FVsum ( int n, float y[] ) ; │ │ │ │ │ │ P │ │ │ │ │ │ This method returns the sum of the first n entries in the vector x[], i.e., return n−1x[i]. │ │ │ │ │ │ i=0 │ │ │ │ │ │ 29. float FVsumabs ( int n, float y[] ) ; │ │ │ │ │ │ @@ -787,15 +787,15 @@ │ │ │ │ │ │ i.e., p vec[0] = vec, and p vec[i] = p vec[i-1] + sizes[i-1] for 0 < i < n. │ │ │ │ │ │ 1.2.7 PDV : double * vector methods │ │ │ │ │ │ 1. double ** PDVinit ( int n ) ; │ │ │ │ │ │ This is the allocator and initializer method for double* vectors. Storage for an array with │ │ │ │ │ │ size n is found and each entry is filled with NULL. A pointer to the array is returned. │ │ │ │ │ │ 2. void PDVfree ( double **p_vec ) ; │ │ │ │ │ │ This method releases the storage taken by p vec[]. │ │ │ │ │ │ - 22 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 22 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 3. void PDVcopy ( int n, double *p_y[], double *p_x[] ) ; │ │ │ │ │ │ This method copies n entries from p x[] to p y[], i.e., p y[i] = p x[i] for 0 <= i < n. │ │ │ │ │ │ 4. void PDVsetup ( int n, int sizes[], double vec[], double *p_vec[] ) ; │ │ │ │ │ │ This method sets the entries of p vec[] as pointers into vec[] given by the sizes[] vector, │ │ │ │ │ │ i.e., p vec[0] = vec, and p vec[i] = p vec[i-1] + sizes[i-1] for 0 < i < n. │ │ │ │ │ │ PIV : int * vector methods │ │ │ │ │ │ 1. int ** PIVinit ( int n ) ; │ │ │ │ │ │ @@ -815,15 +815,15 @@ │ │ │ │ │ │ 2. void PFVfree ( float **p_vec ) ; │ │ │ │ │ │ This method releases the storage taken by p vec[]. │ │ │ │ │ │ 3. void PFVcopy ( int n, float *p_y[], float *p_x[] ) ; │ │ │ │ │ │ This method copies n entries from p x[] to p y[], i.e., p y[i] = p x[i] for 0 <= i < n. │ │ │ │ │ │ 4. void PFVsetup ( int n, int sizes[], float vec[], float *p_vec[] ) ; │ │ │ │ │ │ This method sets the entries of p vec[] as pointers into vec[] given by the sizes[] vector, │ │ │ │ │ │ i.e., p vec[0] = vec, and p vec[i] = p vec[i-1] + sizes[i-1] for 0 < i < n. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 23 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 23 │ │ │ │ │ │ 1.2.9 Sorting routines │ │ │ │ │ │ Validation routines │ │ │ │ │ │ 1. int IVisascending ( int n, int ivec[] ) ; │ │ │ │ │ │ int IVisdescending ( int n, int ivec[] ) ; │ │ │ │ │ │ These methods returns 1 if the array ivec[] is in ascending or descending order and returns │ │ │ │ │ │ 0 otherwise. │ │ │ │ │ │ 2. int DVisascending ( int n, double dvec[] ) ; │ │ │ │ │ │ @@ -852,15 +852,15 @@ │ │ │ │ │ │ This sorts the array ivec[] into ascending or descending order using an insertion sort and │ │ │ │ │ │ permutes the double precision complex companion array dvec[] in the same fashion. │ │ │ │ │ │ 6. void IV2ZVisortUp ( int n, int ivec1[], int ivec2[], double dvec[] ) ; │ │ │ │ │ │ void IV2ZVisortDown ( int n, int ivec1[], int ivec2[], double dvec[] ) ; │ │ │ │ │ │ These methods sort the array ivec1[] into ascending or descending order using an insertion │ │ │ │ │ │ sort and permutes the companion arrays ivec2[] and dvec[] in the same fashion. The │ │ │ │ │ │ dvec[] array is double precision complex. │ │ │ │ │ │ - 24 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 24 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 7. void DVisortUp ( int n, double dvec[] ) ; │ │ │ │ │ │ void DVisortDown ( int n, double dvec[] ) ; │ │ │ │ │ │ These methods sort a double array into ascending or descending order using an insertion │ │ │ │ │ │ sort. │ │ │ │ │ │ 8. void DV2isortUp ( int n, double dvec1[], double dvec2[] ) ; │ │ │ │ │ │ void DV2isortDown ( int n, double dvec1[], double dvec2[] ) ; │ │ │ │ │ │ These methods sort the array dvec1[] into ascending or descending order using an insertion │ │ │ │ │ │ @@ -890,15 +890,15 @@ │ │ │ │ │ │ These methods sort the array ivec[] into ascending or descending order using a quick sort │ │ │ │ │ │ and permutes the double precision complex companion array dvec[] in the same fashion. │ │ │ │ │ │ 6. void IV2ZVqsortUp ( int n, int ivec1[], int ivec2[], double dvec[] ) ; │ │ │ │ │ │ void IV2ZVqsortDown ( int n, int ivec1[], int ivec2[], double dvec[] ) ; │ │ │ │ │ │ These methods sort the array ivec1[] into ascending or descending order using a quick sort │ │ │ │ │ │ and permutes the companion arrays ivec2[] and dvec[] in the same fashion. The dvec[] │ │ │ │ │ │ array is double precision complex. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 25 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 25 │ │ │ │ │ │ 7. void DVqsortUp ( int n, double dvec[] ) ; │ │ │ │ │ │ void DVqsortDown ( int n, double dvec[] ) ; │ │ │ │ │ │ Thes methods sort a double array into ascending or descending order using a quick sort. │ │ │ │ │ │ 8. void DV2qsortUp ( int n, double dvec1[], double dvec2[] ) ; │ │ │ │ │ │ void DV2qsortDown ( int n, double dvec1[], double dvec2[] ) ; │ │ │ │ │ │ These methods sort the array dvec1[] into ascending or descending order using a quick sort │ │ │ │ │ │ and permutes the companion array dvec2[] in the same fashion. │ │ │ │ │ │ @@ -928,15 +928,15 @@ │ │ │ │ │ │ program exits. │ │ │ │ │ │ 4. int IV2sortUpAndCompress ( int n, int ivec1[], int ivec2[] ) ; │ │ │ │ │ │ This method sorts ivec1[] into ascending order with ivec2[] as a companion vector. It │ │ │ │ │ │ then compresses the pairs, dropping all but one of identical pairs. The return value is the │ │ │ │ │ │ number of unique entries stored in the leading locations of the vectors ivec1[] and ivec2[]. │ │ │ │ │ │ Error checking: If n < 0, or if ivec1 or ivec2 is NULL, an error message is printed and the │ │ │ │ │ │ program exits. │ │ │ │ │ │ - 26 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 26 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 5. int IV2DVsortUpAndCompress ( int n, int ivec1[], int ivec2[], double dvec[] ) ; │ │ │ │ │ │ This method sorts ivec1[] into ascending order with ivec2[] and dvec[] as companion │ │ │ │ │ │ vectors. It then compresses the pairs, summing the dvec[] entries for identical (ivec1[], │ │ │ │ │ │ ivec2[]) pairs. The return value is the number of unique entries stored in the leading │ │ │ │ │ │ locations of the vectors ivec1[], ivec2[] and dvec[]. │ │ │ │ │ │ Error checking: If n < 0, or if ivec1, ivec2 or dvec is NULL, an error message is printed and │ │ │ │ │ │ the program exits. │ │ │ │ │ │ @@ -965,15 +965,15 @@ │ │ │ │ │ │ 2. void IP_free ( IP *ip ) ; │ │ │ │ │ │ This method releases the storage based at *ip. │ │ │ │ │ │ 3. void IP_fprintf ( FILE *fp, IP *ip ) ; │ │ │ │ │ │ This method prints the singly linked list that starts with ip. │ │ │ │ │ │ 4. int IP_fp80 ( FILE *fp, int n, int y[], int column, int *pierr ) ; │ │ │ │ │ │ This method prints the singly linked list that starts with ip. See IVfp80() for a description │ │ │ │ │ │ of how the entries are placed on a line. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 27 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 27 │ │ │ │ │ │ 5. IP * IP_mergeUp ( IP *ip1, IP *ip2 ) ; │ │ │ │ │ │ This method merges two singly linked lists into one. If the two lists are in ascending order, │ │ │ │ │ │ the new list is also in ascending order. The head of the new list is returned. │ │ │ │ │ │ 6. IP * IP_mergeSortUp ( IP *ip ) ; │ │ │ │ │ │ This method sorts a list into ascending order using a merge sort. │ │ │ │ │ │ 7. IP * IP_radixSortUp ( IP *ip ) ; │ │ │ │ │ │ This method sorts a list into ascending order using a radix sort. │ │ │ │ │ │ @@ -1002,15 +1002,15 @@ │ │ │ │ │ │ base[i].value1 = -1. The flag parameter determines how the next field is filled. │ │ │ │ │ │ • If flag = I2OP NULL, the elements are not linked, i.e., ips[i].next = NULL for 0 <= │ │ │ │ │ │ i < n. │ │ │ │ │ │ • If flag = I2OP FORWARD,the elements are linked in a forward manner, i.e., ips[i].next │ │ │ │ │ │ = &ips[i+1] for 0 <= i < n-1 and ips[n-1].next = NULL. │ │ │ │ │ │ • If flag = I2OP BACKWARD,theelementsarelinkedinabackwardmanner,i.e., ips[i].next │ │ │ │ │ │ = &ips[i-1] for 0 < i < n and ips[0].next = NULL. │ │ │ │ │ │ - 28 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 28 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ 3. void I2OP_free ( I2OP *i2op ) ; │ │ │ │ │ │ This method releases the storage based at *i2op. │ │ │ │ │ │ 4. void I2OP_fprintf ( FILE *fp, I2OP *i2op ) ; │ │ │ │ │ │ This method prints the singly linked list that starts with i2op. │ │ │ │ │ │ 1.3 Driver programs │ │ │ │ │ │ 1. test_sort msglvl msgFile target sortType n range mod seed │ │ │ │ │ │ This driver program tests the sort methods. Use the script file do test sort for testing. │ │ │ │ │ │ @@ -1038,15 +1038,15 @@ │ │ │ │ │ │ • Integer entries are of the form k mod mod, where k in [0,range]. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ 2. test_sortUpAndCompress msglvl msgFile target n range mod seed │ │ │ │ │ │ This driver program tests the “sort in ascending order and compress” methods. Use the script │ │ │ │ │ │ file do test sortUpAndCompress for testing. │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ timing output. │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 29 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 29 │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The target parameter denotes the type of vector(s) to be sorted. │ │ │ │ │ │ – IV — int vector sort │ │ │ │ │ │ – IV2 — (int, int) vector sort │ │ │ │ │ │ – IVDV — (int, double) vector sort │ │ │ │ │ │ @@ -1091,15 +1091,15 @@ │ │ │ │ │ │ DVfree(), 3 FVaxpy(), 16 │ │ │ │ │ │ DVfscanf(), 3 FVaxpyi(), 16 │ │ │ │ │ │ DVgather(), 5 FVcompress(), 16 │ │ │ │ │ │ DVgatherAddZero(), 5 FVcopy(), 17 │ │ │ │ │ │ DVgatherZero(), 6 FVdot(), 17 │ │ │ │ │ │ DVinit(), 2 FVfill(), 17 │ │ │ │ │ │ 30 │ │ │ │ │ │ - Utilities : DRAFT February 8, 2025 31 │ │ │ │ │ │ + Utilities : DRAFT January 7, 2024 31 │ │ │ │ │ │ FVfprintf(), 16 IV2qsortDown(), 21 │ │ │ │ │ │ FVfree(), 16 IV2qsortUp(), 21 │ │ │ │ │ │ FVfscanf(), 16 IV2sortUpAndCompress(), 23 │ │ │ │ │ │ FVgather(), 17 IV2ZVisortDown(), 21 │ │ │ │ │ │ FVgatherAddZero(), 17 IV2ZVisortUp(), 21 │ │ │ │ │ │ FVgatherZero(), 17 IV2ZVqsortDown(), 22 │ │ │ │ │ │ FVinit(), 16 IV2ZVqsortUp(), 22 │ │ │ │ │ │ @@ -1137,15 +1137,15 @@ │ │ │ │ │ │ IV2DVisortDown(), 21 IVscatter(), 15 │ │ │ │ │ │ IV2DVisortUp(), 21 IVshuffle(), 16 │ │ │ │ │ │ IV2DVqsortDown(), 22 IVsortUpAndCompress(), 22 │ │ │ │ │ │ IV2DVqsortUp(), 22 IVsum(), 15 │ │ │ │ │ │ IV2DVsortUpAndCompress(), 23 IVsumabs(), 15 │ │ │ │ │ │ IV2isortDown(), 20 IVswap(), 15 │ │ │ │ │ │ IV2isortUp(), 20 IVzero(), 16 │ │ │ │ │ │ - 32 Utilities : DRAFT February 8, 2025 │ │ │ │ │ │ + 32 Utilities : DRAFT January 7, 2024 │ │ │ │ │ │ IVZVisortDown(), 21 ZVdotU23(), 10 │ │ │ │ │ │ IVZVisortUp(), 21 ZVdotU31(), 9 │ │ │ │ │ │ IVZVqsortDown(), 22 ZVdotU32(), 9 │ │ │ │ │ │ IVZVqsortUp(), 22 ZVdotU33(), 9 │ │ │ │ │ │ IVZVsortUpAndCompress(), 23 ZVfprintf(), 8 │ │ │ │ │ │ ZVgather(), 13 │ │ │ │ │ │ PCVcopy(), 19 ZVinit(), 7 │ │ │ ├── ./usr/share/doc/spooles-doc/ZV.ps.gz │ │ │ │ ├── ZV.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o ZV.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2351,21 +2351,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2549,88 +2548,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4013,19 +4007,19 @@ │ │ │ │ │ /Fb 235[71 20[{}1 90.9091 /CMSY10 rf /Fc 206[35 35 48[{}2 │ │ │ │ │ 66.4176 /CMR8 rf /Fd 133[50 59 4[44 44 46 2[56 62 93 │ │ │ │ │ 31 2[31 62 2[51 62 50 1[54 11[86 5[84 5[42 6[80 12[56 │ │ │ │ │ 56 56 56 56 2[31 46[{}25 99.6264 /CMBX12 rf /Fe 139[62 │ │ │ │ │ 4[62 4[62 4[62 1[62 62 7[62 3[62 86[{}8 119.552 /CMTT12 │ │ │ │ │ rf /Ff 138[49 30 37 38 1[46 46 51 74 23 42 1[28 46 42 │ │ │ │ │ 1[42 46 42 42 46 12[65 1[66 11[59 62 69 2[68 6[28 58[{}25 │ │ │ │ │ -90.9091 /CMTI10 rf /Fg 134[48 3[51 2[36 12[40 2[51 45 │ │ │ │ │ -26[59 11[25 1[45 2[45 2[45 1[45 3[25 44[{}13 90.9091 │ │ │ │ │ -/CMSL10 rf /Fh 134[71 2[71 75 52 53 55 1[75 67 75 112 │ │ │ │ │ -3[37 75 67 41 61 75 60 1[65 13[75 2[92 11[103 16[67 67 │ │ │ │ │ -67 2[37 46[{}25 119.552 /CMBX12 rf │ │ │ │ │ +90.9091 /CMTI10 rf /Fg 134[48 3[51 2[36 3[51 12[45 22[47 │ │ │ │ │ +15[25 2[45 2[45 1[45 1[45 3[25 44[{}12 90.9091 /CMSL10 │ │ │ │ │ +rf /Fh 134[71 2[71 75 52 53 55 1[75 67 75 112 3[37 75 │ │ │ │ │ +67 41 61 75 60 1[65 13[75 2[92 11[103 16[67 67 67 2[37 │ │ │ │ │ +46[{}25 119.552 /CMBX12 rf │ │ │ │ │ %DVIPSBitmapFont: Fi tcrm1095 10.95 2 │ │ │ │ │ [/Grave/Acute/Circumflex/Tilde/Dieresis/Hungarumlaut/Ring/Caron/Breve/Macron │ │ │ │ │ /Dotaccent/cedilla/ogonek/quotesinglbase.ts1 4{/.notdef}repeat │ │ │ │ │ /quotedblbase.ts1/.notdef/.notdef/twelveudash/threequartersemdash │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -4141,18 +4135,18 @@ │ │ │ │ │ (oin)m(ter)g(to)h(the)g(base)f(arra)m(y)h(from)f(the)g │ │ │ │ │ Fj(ZV)g Fk(ob)5 b(ject.)41 b(On)29 b(the)g(other)h(hand,)e(the)i(con)m │ │ │ │ │ (v)m(enience)0 4867 y(mak)m(es)h(it)g(a)g(widely)f(used)g(ob)5 │ │ │ │ │ b(ject.)0 5179 y Fh(1.1)135 b(Data)46 b(Structure)0 5407 │ │ │ │ │ y Fk(The)30 b Fj(ZV)g Fk(structure)g(has)g(three)g(\014elds.)1927 │ │ │ │ │ 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fj(ZV)30 b Fg(:)h Ff(DRAFT)f Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 137 399 a Fi(\210)45 b Fj(int)i(size)29 │ │ │ │ │ -b Fk(:)41 b(presen)m(t)30 b(size)i(of)e(the)h(v)m(ector.)137 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 137 399 a Fi(\210)45 b Fj(int)i(size)29 b │ │ │ │ │ +Fk(:)41 b(presen)m(t)30 b(size)i(of)e(the)h(v)m(ector.)137 │ │ │ │ │ 595 y Fi(\210)45 b Fj(int)i(maxsize)29 b Fk(:)40 b(maxim)m(um)30 │ │ │ │ │ b(size)i(of)e(the)h(v)m(ector.)137 791 y Fi(\210)45 b │ │ │ │ │ Fj(int)i(owned)27 b Fk(:)40 b(o)m(wner)28 b(\015ag)h(for)f(the)h(data.) │ │ │ │ │ 41 b(When)28 b Fj(owned)46 b(=)i(1)p Fk(,)28 b(storage)i(for)f │ │ │ │ │ Fj(owned)e(double)p Fk('s)f(has)j(b)s(een)227 904 y(allo)s(cated)k(b)m │ │ │ │ │ (y)d(this)h(ob)5 b(ject)31 b(and)f(can)h(b)s(e)f(free'd)g(b)m(y)h(the)f │ │ │ │ │ (ob)5 b(ject.)42 b(When)31 b Fj(owned)46 b(==)h(0)30 │ │ │ │ │ @@ -4206,17 +4200,17 @@ │ │ │ │ │ (storage)i(b)m(y)d(a)i(call)g(to)f Fj(ZV)p 2148 5140 │ │ │ │ │ V 34 w(clearData\(\))d Fk(then)i(free's)h(the)g(storage)h(for)f(the)227 │ │ │ │ │ 5253 y(structure)h(with)g(a)h(call)h(to)f Fj(free\(\))p │ │ │ │ │ Fk(.)227 5407 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fk(If)30 b Fj(zv)g Fk(is)h Fj(NULL)e Fk(an)h(error)g(message)h(is)g │ │ │ │ │ (prin)m(ted)f(and)g(the)g(program)g(exits.)p eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1187 4 v 1368 100 a Fj(ZV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fk(3)0 399 y Fd(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1206 4 v 1387 100 a Fj(ZV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fk(3)0 399 y Fd(1.2.2)112 b(Instance)38 │ │ │ │ │ b(metho)s(ds)0 591 y Fk(These)33 b(metho)s(d)f(allo)m(w)j(access)g(to)e │ │ │ │ │ (information)h(in)f(the)g(data)h(\014elds)e(without)i(explicitly)g │ │ │ │ │ (follo)m(wing)h(p)s(oin)m(ters.)0 704 y(There)g(is)h(o)m(v)m(erhead)h │ │ │ │ │ (in)m(v)m(olv)m(ed)h(with)d(these)h(metho)s(d)g(due)f(to)h(the)g │ │ │ │ │ (function)g(call)h(and)e(error)h(c)m(hec)m(king)h(inside)0 │ │ │ │ │ 817 y(the)31 b(metho)s(ds.)111 1029 y(1.)46 b Fj(int)h(ZV_owned)f(\()h │ │ │ │ │ (ZV)g(*zv)g(\))h(;)227 1176 y Fk(This)24 b(metho)s(d)g(returns)g(the)g │ │ │ │ │ @@ -4280,19 +4274,19 @@ │ │ │ │ │ Fk(with)i(the)g(size)h(of)f(the)g(v)m(ector)h(and)e Fj(**pentries)e │ │ │ │ │ Fk(with)j(the)g(base)g(address)227 5148 y(of)e(the)f(v)m(ector.)227 │ │ │ │ │ 5294 y Ff(Err)-5 b(or)27 b(che)-5 b(cking:)36 b Fk(If)22 │ │ │ │ │ b Fj(zv)p Fk(,)i Fj(psize)d Fk(or)h Fj(pentries)e Fk(is)i │ │ │ │ │ Fj(NULL)p Fk(,)g(an)g(error)g(message)i(is)e(prin)m(ted)g(and)g(the)g │ │ │ │ │ (program)227 5407 y(exits.)p eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fj(ZV)30 b Fg(:)h Ff(DRAFT)f Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 111 399 a Fk(8.)46 b Fj(void)h(ZV_setEntry)e │ │ │ │ │ -(\()i(ZV)g(*zv,)g(int)g(loc,)f(double)h(real,)f(double)g(imag)h(\))g(;) │ │ │ │ │ -227 551 y Fk(This)30 b(metho)s(d)g(sets)g(the)h Fj(loc)p │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 111 399 a Fk(8.)46 b Fj(void)h(ZV_setEntry)e(\()i(ZV)g(*zv,) │ │ │ │ │ +g(int)g(loc,)f(double)h(real,)f(double)g(imag)h(\))g(;)227 │ │ │ │ │ +551 y Fk(This)30 b(metho)s(d)g(sets)g(the)h Fj(loc)p │ │ │ │ │ Fk('th)f(en)m(try)g(of)h(the)f(v)m(ector)i(to)f Fj(\(real,imag\))p │ │ │ │ │ Fk(.)227 704 y Ff(Err)-5 b(or)33 b(che)-5 b(cking:)40 │ │ │ │ │ b Fk(If)28 b Fj(zv)h Fk(is)g Fj(NULL)e Fk(or)j Fj(loc)46 │ │ │ │ │ b(<)i(0)p Fk(,)29 b(an)g(error)g(message)h(is)f(prin)m(ted)f(and)h(the) │ │ │ │ │ g(program)g(exits.)0 978 y Fd(1.2.3)112 b(Initializer)38 │ │ │ │ │ b(metho)s(ds)0 1177 y Fk(There)30 b(are)h(three)f(initializer)j(metho)s │ │ │ │ │ (ds.)111 1420 y(1.)46 b Fj(void)h(ZV_init)f(\()h(ZV)g(*zv,)g(int)g │ │ │ │ │ @@ -4366,17 +4360,17 @@ │ │ │ │ │ 5294 y Ff(Err)-5 b(or)37 b(che)-5 b(cking:)46 b Fk(If)33 │ │ │ │ │ b Fj(zv)g Fk(is)g Fj(NULL)p Fk(,)f(or)i Fj(newsize)46 │ │ │ │ │ b(<)h(0)p Fk(,)34 b(or)f(if)h Fj(0)47 b(<)h(maxsize)d(<)j(newsize)31 │ │ │ │ │ b Fk(and)i Fj(owned)46 b(=)227 5407 y(0)p Fk(,)31 b(an)f(error)g │ │ │ │ │ (message)h(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1187 4 v 1368 100 a Fj(ZV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fk(5)0 399 y Fd(1.2.4)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1206 4 v 1387 100 a Fj(ZV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fk(5)0 399 y Fd(1.2.4)112 b(Utilit)m(y)38 │ │ │ │ │ b(metho)s(ds)111 607 y Fk(1.)46 b Fj(void)h(ZV_shiftBase)d(\()k(ZV)f │ │ │ │ │ (*zv,)g(int)g(offset)f(\))h(;)227 770 y Fk(This)32 b(metho)s(d)h │ │ │ │ │ (shifts)f(the)i(base)f(en)m(tries)g(of)h(the)f(v)m(ector)h(and)f │ │ │ │ │ (decremen)m(ts)g(the)g(presen)m(t)g(size)h(and)f(max-)227 │ │ │ │ │ 883 y(im)m(um)g(size)g(of)g(the)f(v)m(ector)j(b)m(y)d │ │ │ │ │ Fj(offset)p Fk(.)46 b(This)31 b(is)i(a)g(dangerous)f(metho)s(d)g(to)h │ │ │ │ │ (use)g(b)s(ecause)f(the)h(state)h(of)227 996 y(the)j(v)m(ector)h(is)e │ │ │ │ │ @@ -4436,23 +4430,22 @@ │ │ │ │ │ b(The)24 b(n)m(um)m(b)s(er)f(of)i(en)m(tries)g(that)g(are)g(copied)g │ │ │ │ │ (is)g(the)f(smaller)227 5244 y(of)31 b(the)f(t)m(w)m(o)i(sizes.)227 │ │ │ │ │ 5407 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 │ │ │ │ │ b Fj(zv1)g Fk(or)g Fj(zv2)g Fk(is)g Fj(NULL)p Fk(,)g(an)g(error)g │ │ │ │ │ (message)h(is)g(prin)m(ted)f(and)f(the)i(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fk(6)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fj(ZV)30 b Fg(:)h Ff(DRAFT)f Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 111 399 a Fk(8.)46 b Fj(void)h │ │ │ │ │ -(ZV_log10profile)d(\()j(ZV)g(*zv,)g(int)g(npts,)f(DV)h(*xDV,)g(DV)g │ │ │ │ │ -(*yDV,)f(double)g(tausmall,)1325 511 y(double)g(taubig,)g(int)h │ │ │ │ │ -(*pnzero,)e(int)i(*pnsmall,)f(int)g(*pnbig)h(\))g(;)227 │ │ │ │ │ -660 y Fk(This)34 b(metho)s(d)f(scans)i(the)f(en)m(tries)h(in)f(the)g │ │ │ │ │ -Fj(ZV)g Fk(ob)5 b(ject)35 b(and)f(\014lls)g Fj(xDV)f │ │ │ │ │ -Fk(and)h Fj(yDV)f Fk(with)h(data)h(that)g(allo)m(ws)227 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fk(6)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 111 399 a Fk(8.)46 b Fj(void)h(ZV_log10profile)d(\()j(ZV)g │ │ │ │ │ +(*zv,)g(int)g(npts,)f(DV)h(*xDV,)g(DV)g(*yDV,)f(double)g(tausmall,)1325 │ │ │ │ │ +511 y(double)g(taubig,)g(int)h(*pnzero,)e(int)i(*pnsmall,)f(int)g │ │ │ │ │ +(*pnbig)h(\))g(;)227 660 y Fk(This)34 b(metho)s(d)f(scans)i(the)f(en)m │ │ │ │ │ +(tries)h(in)f(the)g Fj(ZV)g Fk(ob)5 b(ject)35 b(and)f(\014lls)g │ │ │ │ │ +Fj(xDV)f Fk(and)h Fj(yDV)f Fk(with)h(data)h(that)g(allo)m(ws)227 │ │ │ │ │ 773 y(a)c(simple)f(log)703 795 y Fc(10)808 773 y Fk(distribution)f │ │ │ │ │ (plot.)41 b(Only)29 b(en)m(tries)i(whose)f(magnitudes)g(lie)h(in)e(the) │ │ │ │ │ h(range)h Fj([tausmall,)227 886 y(taubig])i Fk(con)m(tribute)j(to)g │ │ │ │ │ (the)g(distribution.)54 b(The)35 b(n)m(um)m(b)s(er)f(of)h(en)m(tries)h │ │ │ │ │ (whose)f(magnitudes)g(are)h(zero,)227 999 y(smaller)27 │ │ │ │ │ b(than)f Fj(tausmall)p Fk(,)f(or)i(larger)g(than)f Fj(taubig)f │ │ │ │ │ Fk(are)i(placed)f(in)m(to)i Fj(pnzero)p Fk(,)d Fj(*pnsmall)g │ │ │ │ │ @@ -4529,17 +4522,17 @@ │ │ │ │ │ 5259 y(the)j(v)-5 b(alue)31 b Fj(1)f Fk(is)g(returned.)40 │ │ │ │ │ b(If)30 b(an)g(IO)g(error)g(is)g(encoun)m(tered)h(from)f │ │ │ │ │ Fj(fprintf)p Fk(,)e(zero)k(is)e(returned.)227 5407 y │ │ │ │ │ Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 b Fj(zv)g │ │ │ │ │ Fk(or)g Fj(fp)g Fk(are)h Fj(NULL)p Fk(,)e(an)i(error)f(message)h(is)g │ │ │ │ │ (prin)m(ted)f(and)f(zero)i(is)g(returned.)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1187 4 v 1368 100 a Fj(ZV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2667 100 V 1187 w Fk(7)111 399 y(6.)46 b Fj(int)h(ZV_writeToBinaryFile) │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1206 4 v 1387 100 a Fj(ZV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)121 b Fg(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2647 100 V 1206 w Fk(7)111 399 y(6.)46 b Fj(int)h(ZV_writeToBinaryFile) │ │ │ │ │ 42 b(\()48 b(ZV)f(*zv,)g(FILE)f(*fp)h(\))h(;)227 557 │ │ │ │ │ y Fk(This)27 b(metho)s(d)f(writes)h(a)h Fj(ZV)e Fk(ob)5 │ │ │ │ │ b(ject)28 b(to)g(a)f(binary)g(\014le.)39 b(If)27 b(there)g(are)h(no)e │ │ │ │ │ (errors)h(in)g(writing)g(the)g(data,)i(the)227 670 y(v)-5 │ │ │ │ │ b(alue)31 b Fj(1)f Fk(is)h(returned.)39 b(If)30 b(an)g(IO)g(error)g(is) │ │ │ │ │ h(encoun)m(tered)f(from)g Fj(fwrite)p Fk(,)f(zero)i(is)g(returned.)227 │ │ │ │ │ 829 y Ff(Err)-5 b(or)34 b(che)-5 b(cking:)40 b Fk(If)30 │ │ │ │ │ @@ -4595,23 +4588,23 @@ │ │ │ │ │ 5140 y(data.)337 5294 y Fi(\210)45 b Fk(The)29 b Fj(inFile)f │ │ │ │ │ Fk(parameter)j(is)e(the)h(name)g(of)g(the)g(\014le)f(from)h(whic)m(h)f │ │ │ │ │ (to)h(read)g(in)f(the)h(ob)5 b(ject.)42 b Fj(inFile)427 │ │ │ │ │ 5407 y Fk(m)m(ust)31 b(b)s(e)e(of)i(the)f(form)g Fj(*.zvf)f │ │ │ │ │ Fk(for)h(a)h(formatted)g(\014le)g(or)f Fj(*.zvb)f Fk(for)h(a)h(binary)e │ │ │ │ │ (\014le.)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fk(8)p 136 100 1187 4 v │ │ │ │ │ -1368 w Fj(ZV)30 b Fg(:)h Ff(DRAFT)f Fg(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2714 100 V 337 399 a Fi(\210)45 b Fk(The)40 │ │ │ │ │ -b Fj(outFile)f Fk(parameter)i(is)g(the)g(name)g(of)f(the)h(\014le)g(to) │ │ │ │ │ -g(whic)m(h)g(to)g(write)g(out)g(the)g(ob)5 b(ject.)72 │ │ │ │ │ -b(If)427 511 y Fj(outfile)28 b Fk(is)j(of)f(the)g(form)g │ │ │ │ │ -Fj(*.zvf)p Fk(,)f(the)h(ob)5 b(ject)31 b(is)f(written)g(to)h(a)f │ │ │ │ │ -(formatted)h(\014le.)41 b(If)30 b Fj(outfile)e Fk(is)i(of)427 │ │ │ │ │ -624 y(the)e(form)g Fj(*.zvb)p Fk(,)f(the)h(ob)5 b(ject)29 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fk(8)p 136 100 1206 4 v │ │ │ │ │ +1388 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2695 100 V 337 399 a Fi(\210)45 b Fk(The)40 b Fj(outFile)f │ │ │ │ │ +Fk(parameter)i(is)g(the)g(name)g(of)f(the)h(\014le)g(to)g(whic)m(h)g │ │ │ │ │ +(to)g(write)g(out)g(the)g(ob)5 b(ject.)72 b(If)427 511 │ │ │ │ │ +y Fj(outfile)28 b Fk(is)j(of)f(the)g(form)g Fj(*.zvf)p │ │ │ │ │ +Fk(,)f(the)h(ob)5 b(ject)31 b(is)f(written)g(to)h(a)f(formatted)h │ │ │ │ │ +(\014le.)41 b(If)30 b Fj(outfile)e Fk(is)i(of)427 624 │ │ │ │ │ +y(the)e(form)g Fj(*.zvb)p Fk(,)f(the)h(ob)5 b(ject)29 │ │ │ │ │ b(is)f(written)g(to)h(a)f(binary)f(\014le.)40 b(When)28 │ │ │ │ │ b Fj(outFile)e Fk(is)i Ff(not)h Fj("none")p Fk(,)e(the)427 │ │ │ │ │ 737 y(ob)5 b(ject)32 b(is)f(written)g(to)g(the)g(\014le)g(in)f(a)i(h)m │ │ │ │ │ (uman)e(readable)h(format.)42 b(When)31 b Fj(outFile)d │ │ │ │ │ Fk(is)j Fj("none")p Fk(,)f(the)427 850 y(ob)5 b(ject)32 │ │ │ │ │ b(is)e(not)h(written)f(out.)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -22,15 +22,15 @@ │ │ │ │ │ │ Onemustchoose where to use this object. There is a substantial performance penalty for doing the │ │ │ │ │ │ simplest operations, and so when we need to manipulate an double vector inside a loop, we extract │ │ │ │ │ │ out the size and pointer to the base array from the ZV object. On the other hand, the convenience │ │ │ │ │ │ makes it a widely used object. │ │ │ │ │ │ 1.1 Data Structure │ │ │ │ │ │ The ZV structure has three fields. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 ZV : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 ZV : DRAFT January 7, 2024 │ │ │ │ │ │ • int size : present size of the vector. │ │ │ │ │ │ • int maxsize : maximum size of the vector. │ │ │ │ │ │ • int owned : owner flag for the data. When owned = 1, storage for owned double’s has been │ │ │ │ │ │ allocated by this object and can be free’d by the object. When owned == 0 but size > 0 , │ │ │ │ │ │ this object points to entries that have been allocated elsewhere, and these entries will not be │ │ │ │ │ │ free’d by this object. │ │ │ │ │ │ • double *vec : pointer to the base address of the double vector │ │ │ │ │ │ @@ -54,15 +54,15 @@ │ │ │ │ │ │ the storage for vec is free’d by a call to ZVfree(). The structure’s default fields are then set │ │ │ │ │ │ with a call to ZV setDefaultFields(). │ │ │ │ │ │ Error checking: If zv is NULL an error message is printed and the program exits. │ │ │ │ │ │ 4. void ZV_free ( ZV *zv ) ; │ │ │ │ │ │ This method releases any storage by a call to ZV clearData() then free’s the storage for the │ │ │ │ │ │ structure with a call to free(). │ │ │ │ │ │ Error checking: If zv is NULL an error message is printed and the program exits. │ │ │ │ │ │ - ZV : DRAFT February 8, 2025 3 │ │ │ │ │ │ + ZV : DRAFT January 7, 2024 3 │ │ │ │ │ │ 1.2.2 Instance methods │ │ │ │ │ │ These method allow access to information in the data fields without explicitly following pointers. │ │ │ │ │ │ There is overhead involved with these method due to the function call and error checking inside │ │ │ │ │ │ the methods. │ │ │ │ │ │ 1. int ZV_owned ( ZV *zv ) ; │ │ │ │ │ │ This method returns the value of owned. If owned > 0, then the object owns the data pointed │ │ │ │ │ │ to by vec and will free this data with a call to ZVfree() when its data is cleared by a call to │ │ │ │ │ │ @@ -91,15 +91,15 @@ │ │ │ │ │ │ This method returns vec, a pointer to the base address of the vector. │ │ │ │ │ │ Error checking: If zv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 7. void ZV_sizeAndEntries ( ZV *zv, int *psize, double **pentries ) ; │ │ │ │ │ │ This method fills *psize with the size of the vector and **pentries with the base address │ │ │ │ │ │ of the vector. │ │ │ │ │ │ Error checking: If zv, psize or pentriesis NULL, an error message is printed and the program │ │ │ │ │ │ exits. │ │ │ │ │ │ - 4 ZV : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 ZV : DRAFT January 7, 2024 │ │ │ │ │ │ 8. void ZV_setEntry ( ZV *zv, int loc, double real, double imag ) ; │ │ │ │ │ │ This method sets the loc’th entry of the vector to (real,imag). │ │ │ │ │ │ Error checking: If zv is NULL or loc < 0, an error message is printed and the program exits. │ │ │ │ │ │ 1.2.3 Initializer methods │ │ │ │ │ │ There are three initializer methods. │ │ │ │ │ │ 1. void ZV_init ( ZV *zv, int size, double *entries ) ; │ │ │ │ │ │ This method initializes the object given a size for the vector and a possible pointer to the │ │ │ │ │ │ @@ -128,15 +128,15 @@ │ │ │ │ │ │ Error checking: If zv is NULL or newmaxsize < 0, or if 0 < maxsize and owned == 0, an │ │ │ │ │ │ error message is printed and the program exits. │ │ │ │ │ │ 5. void ZV_setSize ( ZV *zv, int newsize ) ; │ │ │ │ │ │ This method sets the size of the vector. If newsize > maxsize, the length of the vector is │ │ │ │ │ │ increased with a call to ZV setMaxsize(). The size field is set to newsize. │ │ │ │ │ │ Error checking: If zv is NULL, or newsize < 0, or if 0 < maxsize < newsize and owned = │ │ │ │ │ │ 0, an error message is printed and the program exits. │ │ │ │ │ │ - ZV : DRAFT February 8, 2025 5 │ │ │ │ │ │ + ZV : DRAFT January 7, 2024 5 │ │ │ │ │ │ 1.2.4 Utility methods │ │ │ │ │ │ 1. void ZV_shiftBase ( ZV *zv, int offset ) ; │ │ │ │ │ │ This method shifts the base entries of the vector and decrements the present size and max- │ │ │ │ │ │ imum size of the vector by offset. This is a dangerous method to use because the state of │ │ │ │ │ │ the vector is lost, namely vec, the base of the entries, is corrupted. If the object owns its │ │ │ │ │ │ entries and ZV free(), ZV setSize() or ZV setMaxsize() is called before the base has been │ │ │ │ │ │ shifted back to its original position, a segmentation violation will likely result. This is a very │ │ │ │ │ │ @@ -162,15 +162,15 @@ │ │ │ │ │ │ This method fills the vector with zeros. │ │ │ │ │ │ Error checking: If zv is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 7. void ZV_copy ( ZV *zv1, ZV *zv2 ) ; │ │ │ │ │ │ This method fills the zv1 object with entries in the iv2 object. Note, this is a mapped copy, │ │ │ │ │ │ zv1 and zv2 need not have the same size. The number of entries that are copied is the smaller │ │ │ │ │ │ of the two sizes. │ │ │ │ │ │ Error checking: If zv1 or zv2 is NULL, an error message is printed and the program exits. │ │ │ │ │ │ - 6 ZV : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 ZV : DRAFT January 7, 2024 │ │ │ │ │ │ 8. void ZV_log10profile ( ZV *zv, int npts, DV *xDV, DV *yDV, double tausmall, │ │ │ │ │ │ double taubig, int *pnzero, int *pnsmall, int *pnbig ) ; │ │ │ │ │ │ This method scans the entries in the ZV object and fills xDV and yDV with data that allows │ │ │ │ │ │ a simple log10 distribution plot. Only entries whose magnitudes lie in the range [tausmall, │ │ │ │ │ │ taubig] contribute to the distribution. The number of entries whose magnitudes are zero, │ │ │ │ │ │ smaller than tausmall, or larger than taubig are placed into pnzero, *pnsmall and *pnbig, │ │ │ │ │ │ respectively. On return, the size of the xDV and yDV objects is npts. │ │ │ │ │ │ @@ -199,15 +199,15 @@ │ │ │ │ │ │ and returns the value returned from the called routine. │ │ │ │ │ │ Error checking: If zv or fn are NULL, or if fn is not of the form *.zvf (for a formatted file) │ │ │ │ │ │ or *.zvb (for a binary file), an error message is printed and the method returns zero. │ │ │ │ │ │ 5. int ZV_writeToFormattedFile ( ZV *zv, FILE *fp ) ; │ │ │ │ │ │ This method writes a ZV object to a formatted file. If there are no errors in writing the data, │ │ │ │ │ │ the value 1 is returned. If an IO error is encountered from fprintf, zero is returned. │ │ │ │ │ │ Error checking: If zv or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ - ZV : DRAFT February 8, 2025 7 │ │ │ │ │ │ + ZV : DRAFT January 7, 2024 7 │ │ │ │ │ │ 6. int ZV_writeToBinaryFile ( ZV *zv, FILE *fp ) ; │ │ │ │ │ │ This method writes a ZV object to a binary file. If there are no errors in writing the data, the │ │ │ │ │ │ value 1 is returned. If an IO error is encountered from fwrite, zero is returned. │ │ │ │ │ │ Error checking: If zv or fp are NULL, an error message is printed and zero is returned. │ │ │ │ │ │ 7. int ZV_writeForHumanEye ( ZV *zv, FILE *fp ) ; │ │ │ │ │ │ This method writes a ZV object to a file in a human readable format. is called to write out │ │ │ │ │ │ the header and statistics. The entries of the vector then follow in eighty column format using │ │ │ │ │ │ @@ -232,15 +232,15 @@ │ │ │ │ │ │ • The msglvl parameter determines the amount of output. Use msglvl = 1 for just │ │ │ │ │ │ timing output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The inFile parameter is the name of the file from which to read in the object. inFile │ │ │ │ │ │ must be of the form *.zvf for a formatted file or *.zvb for a binary file. │ │ │ │ │ │ - 8 ZV : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 ZV : DRAFT January 7, 2024 │ │ │ │ │ │ • The outFile parameter is the name of the file to which to write out the object. If │ │ │ │ │ │ outfile is of the form *.zvf, the object is written to a formatted file. If outfile is of │ │ │ │ │ │ the form *.zvb, the object is written to a binary file. When outFile is not "none", the │ │ │ │ │ │ object is written to the file in a human readable format. When outFile is "none", the │ │ │ │ │ │ object is not written out. │ │ │ │ │ │ Index │ │ │ │ │ │ ZV clearData(), 2 │ │ │ ├── ./usr/share/doc/spooles-doc/misc.ps.gz │ │ │ │ ├── misc.ps │ │ │ │ │ @@ -11,15 +11,15 @@ │ │ │ │ │ %%EndComments │ │ │ │ │ %%BeginDefaults │ │ │ │ │ %%ViewingOrientation: 1 0 0 1 │ │ │ │ │ %%EndDefaults │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o misc.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2025.02.08:1026 │ │ │ │ │ +%DVIPSSource: TeX output 2024.01.07:0425 │ │ │ │ │ %%BeginProcSet: tex.pro 0 0 │ │ │ │ │ %! │ │ │ │ │ /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S │ │ │ │ │ N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 │ │ │ │ │ mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 │ │ │ │ │ 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ │ │ │ │ │ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize │ │ │ │ │ @@ -2251,21 +2251,20 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ end readonly def │ │ │ │ │ /Encoding 256 array │ │ │ │ │ 0 1 255 {1 index exch /.notdef put} for │ │ │ │ │ dup 44 /comma put │ │ │ │ │ dup 48 /zero put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 53 /five put │ │ │ │ │ -dup 56 /eight put │ │ │ │ │ +dup 52 /four put │ │ │ │ │ +dup 55 /seven put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 70 /F put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 97 /a put │ │ │ │ │ -dup 98 /b put │ │ │ │ │ -dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ @@ -2449,88 +2448,83 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004E075961 │ │ │ │ │ -88009C56E0A43A9F2C854AB15BE89F440EA595FC1B79E3B328B583C840EF718E │ │ │ │ │ -EA8EE6B6C64D7325289DCFFBDEE1D1D14B28E009E5ECBF7626D8440C676974C4 │ │ │ │ │ -1AFCC4688D674C01A6D8AC619A4A13B1259FC65826315E692F52273D5761C841 │ │ │ │ │ -B4D14DBE9F11DCC4AFF9A3309A4AEE4ABFCD80A3ED6EC056A499666D4E637044 │ │ │ │ │ -38E6795EACA5B1CCB1C87577CABB7247FFED46CE6ECE2330348701D7987E6B5A │ │ │ │ │ -C673340DE61033E7EBE83890DEFF32BCAE034D5CF098F16F768D9A1BD46465F3 │ │ │ │ │ -DAE58EA38E5B582263A7D86B9AD5A0AD75CA7A5A0017FF9530FF80EA907ED3CD │ │ │ │ │ -E05C9AB9209F8DC8447847C16AC02318B17AA985A38B2C77229F5E0E3DA8D1F3 │ │ │ │ │ -48D6A7F86D814CCBE85133B3A304AF0A4AA647CD0E2539DFAD9604486DCCFA49 │ │ │ │ │ -AC96130D106A8F8387633622C3809400D6E8FF9D60877C743502E4D211CEBF62 │ │ │ │ │ -9A6F91045C22D5D20C5FF677D89983D02E5EE26C71A9EAE0E7C52465DA5A149A │ │ │ │ │ -9B731C27EC8366BC3E841C0CAE49A33DE164A857365B17B09CAD121C47A980CB │ │ │ │ │ -C75E1030F6C394EDB46C54B46880D2344127B903FB22684C9CAACE6053DC3BFA │ │ │ │ │ -4E47C565ECAF19C4295A11BD68CA6D45B5738B932BB5CF8865CA56D4E2B8FB0D │ │ │ │ │ -F6B5FB6D8169CC271F17825FD456F1DC53031CB0C7651568408EF4ABF997035B │ │ │ │ │ -7B8BBE226184A82A3EDA36EA3B4045F935CDE0EAF90D0FF2C1F31909E3FF41D7 │ │ │ │ │ -2B4FB4E7A5AADA750CBD5233F6F6DE4B33991C185EFD53561C52C0D0C45A490C │ │ │ │ │ -0EB57D975163E6CD1BF935452E8EE52FB125EC3B8C8C169A2F2138709992016D │ │ │ │ │ -8A81CC75D7AFE278913A393654DC24AAA9956B27021F9AC140C4D40D4BE61219 │ │ │ │ │ -5A2C6D6C6AD3990237B3DA80EFE1856FDE80AB556B24B2DF7740D10D7F760B57 │ │ │ │ │ -C4DB7B0686E4D201073730F4BA4215156BF977466382C2DB0937949A568AF6A9 │ │ │ │ │ -931FC89BA02CC2F674D6BAADCE22574D7C9DA9B8FD73CD031472BC998596D702 │ │ │ │ │ -B8B59D1C3E098B7032E9DAA742E6B3278119A9151FF307AF76B4B1A92EB38D19 │ │ │ │ │ -84EA0372291277514E5D64F97783BD8882065C3941C160A0CB47DA62DE377A08 │ │ │ │ │ -EA373DF717358B39E9A244DD003248FAAE5AE92F064507CB8294622134314DDA │ │ │ │ │ -AB057D3B4D7485C654D1E10312F74F8BFF5E65538F9FFBF21F45B61EAA4007FA │ │ │ │ │ -AC857752E7B2E40CCDB1A04820BFD233DFE9D3981430EFBB136B324F25E6A3C4 │ │ │ │ │ -5DCB4C302467843C1F90D7D8210F9868B0146B23182CC0BF95F624E09B979B4B │ │ │ │ │ -DC7B5944599714E7851320F5696D58E6DC7E73B734DB3A506B1C51C874682E35 │ │ │ │ │ -A784C7FBA06B2DFEB8DBAB8782A8219D5DEF5A00416B557B71B0909C31B0292B │ │ │ │ │ -AF24D368FE9EC4A16878C1B6B0BFA429507C02135C53A471FE05ACB39086324C │ │ │ │ │ -756E5068C65C638ECA9D746CC1C7E78DC2C1A6E9AE9FB612D4B1AD534A7CE61A │ │ │ │ │ -6893F2D7337256AD079799A37738A772EB141DD604904FF2E889898F74984175 │ │ │ │ │ -E404EEBCC53029A95D15D02079FCDB60D7184D2E5B1580970579B8BC3F346C90 │ │ │ │ │ -F5C92C686F122D96124228C8DE6516AAECB35CB44B90C8A96E8FA2EDF6BCE369 │ │ │ │ │ -D037B110DE13F135173FA5F9D2A26CF898004A0CE74FC3D62CD008BF26A45BDF │ │ │ │ │ -9B487338E7A0B2DBDD478D68B5064AE0A8201DF80AD04846B6BAE408C1E93B7C │ │ │ │ │ -4FF31323A1C5D3063A1DD3C4723C8268488C56ACA442F0E8F5ED96E3E3042893 │ │ │ │ │ -E9600BA1E1F20EE82C79968E43E8AAAA723750CEECBBBF677BDEE3C1FACD3D86 │ │ │ │ │ -6604CBC9C301606303DC037D4E9EA59CADE8F2CF02ABFA125EA6FD60445A7FBD │ │ │ │ │ -DA93CE8D7D1BCCE89E007B69C4309676D7BB9AF94FBEECE350770A6A1C5B4DA1 │ │ │ │ │ -9031FA620455F297388BAB6394065C77D45375B4D8F504514193F0584209A692 │ │ │ │ │ -1E68C9025C02628BCAD1A42153CB5E813E052730C59A566B049A64148E2C7812 │ │ │ │ │ -29ED975E2A904F21E4C5D705096E5438D3689380D0C25A8F80093E1CC64AE817 │ │ │ │ │ -20EBD99E61A1056B627EC135A55649E9C6D8E09DA21CD2EBB4AB80661174BE53 │ │ │ │ │ -A4835804A988B5587CDD31CC08BFCAFE9AA47B0EF233A9B707BAD18259089856 │ │ │ │ │ -8FAD814DB59413563FF4100DBB90A41FB8F0E510BA2663D6C3456C29BE3A98D3 │ │ │ │ │ -D1B2777F32F6A3876F5DD773E2C312C32302A36D637E623CD1B193DACA65A09F │ │ │ │ │ -676061206B24BD7CFE6CB244ADE9F061C068A1FD0D3D6907A15FF093F7DD0AF7 │ │ │ │ │ -5491BEBA4DE7A0F66F535231EC8F392465E67E31BD81D803F4584A7859638208 │ │ │ │ │ -98C3D43F61E388937490C8348ED94D18230682B7DFFDDB4C0C5207FD519316AC │ │ │ │ │ -1700D6CDFD180996371FC7148E654D1EE077EDADEC4BF5B96C0F63F657E541E1 │ │ │ │ │ -2707AFDB011DE058957E866C92D931DCC5E59F5D38BAADD5254D6EA59000A10A │ │ │ │ │ -50F9202C89BB9338CB4E7271BA84C4C6AA65653796D15EDC4FCBDBF5E18EB408 │ │ │ │ │ -08B5D55F1867B1ADA26778A8E5F89678F5DA2ED3B854A063061D2F6FFA9A0F0C │ │ │ │ │ -1F5D72211E3E33906A0B8EAB808A6CB1E2AA534D94731355F3C691C5D6928605 │ │ │ │ │ -8B1C7DA854607EA562E3345BBA213B3DF67CA4CF00E1FBD2BC4F90A179B5C253 │ │ │ │ │ -C0ED84663B63CCBC8427CE60A057C7CF2BE1264338BFA264037DE04A996CF6DC │ │ │ │ │ -D69F32AD4F6DAB56A008E1F626E4CFC49B8380F9227273004CD2284C6DA79BC4 │ │ │ │ │ -535E9FF4FCC105C7402C43414EED88D2DA35779EF868513C33D22244CBDF0856 │ │ │ │ │ -3830193CBC9B9A93BA2AF6D9505367D512DD0E9FE718D3F582938A827018ADBA │ │ │ │ │ -080E02BDFD26E683A80E1EC0B2A826CF9351AE04C7D4A1AB79FC993633DF3FE9 │ │ │ │ │ -9A925E3C7AD7131B7224B598AC585A7F886400CBA7D5DFDDE7531373B638FEE6 │ │ │ │ │ -67489F66686B9A2472854C0175CC17951E1D84B1E45A064038390AA2157A937D │ │ │ │ │ -211765423D6E64FBB44C6A6D6F78F85B07E779593B0729579844C45919B2D2C2 │ │ │ │ │ -925C0577E7C920437DFDA53F9C27D8CA4E74720EB2F3F19B9439D645916B6BB6 │ │ │ │ │ -C70AE9B2CB46EDF380BC706E9B412DFA9598E40D7260B60B0499E23D5DF3F8EF │ │ │ │ │ -1534A81AEBBB7B8FA2ED27E571BB9D791E2AB7D89943AF354EC8E8C5A273677A │ │ │ │ │ -20AF08CC7EFBA258A1B28E8EC10AB634657BB1F8C836453E12C65AD51DE3D36B │ │ │ │ │ -D95E761D24DEB82072F159FD0AA8A11143F6F13849CB99E3AA8211C41D8B1E0D │ │ │ │ │ -023DD60AAA4D45746FD71DADCE5D3942B330D0A661AB8194BE90A6F08E35546E │ │ │ │ │ -055AFCFBBC8533C2A414DDC358E753C911F4B1A3DCD0A137DF21FAFBA9E8FF83 │ │ │ │ │ -067F15AEABD3386CA97FBACB7488095CA5EA7F68CC20 │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB884400493EF704 │ │ │ │ │ +AAD58B5EC7446C104E35E1BD40C2A5E8212D57F595E78782FF19251B1D373536 │ │ │ │ │ +E1A3A3EE00CD97FC5A24DC762E7B137A39BF92FCC32B212DD98F38F58DBF529B │ │ │ │ │ +46E5C4DF7FCC98AF1868EFACE75B457F265EABDBED7B0B4C58B992F2C7447EFE │ │ │ │ │ +FBB747B040B7A00BDD7E6E1A9144C7C2A0B5FE09992FD8372689AC90494273BA │ │ │ │ │ +389E9AEECD921A82778626A823A88C7E731F64A920DF219678972CC33BA79221 │ │ │ │ │ +7883F0BED070FA6336715004DE725C4438E0A4431CDB05CA0177BDEA3DFF75DB │ │ │ │ │ +2938B887D7EC2E7CBC13845072C39A1DA383303D39F219ABC7F6E6C99B6A4FC0 │ │ │ │ │ +C6F170700D1A58EF5512E64926C123AAF808D1F82B4347D87457E6C42D4F2861 │ │ │ │ │ +B15A3EDD23FA95CAE9D32CB9EE6A700CEC2EEA533EEE0F00CA439A37411A466A │ │ │ │ │ +F6C8B4BC37A342DA97BE768416340641DF734271EE332F3763367088C8D2F5D1 │ │ │ │ │ +B449959619A4DAD5EE691A62AB98C9BE7746648046A1C58CE843113593A1A10F │ │ │ │ │ +D57F3443B8E9CA5948AC50008389EB42FA4389968616998AD134A8E2E8296CD1 │ │ │ │ │ +EBEDAA3EB7C026D5D278CD661DE0C5458BE871894537AAD4DA1263381284D664 │ │ │ │ │ +7CBEF442BDA369A70583951C321B8BA376849751840CC1DB0E9AE1BF1EB6A6CD │ │ │ │ │ +5C9CFFE491A29BFBAA81748806C0197CF02738AF64AF426C30A53A94D9761FFD │ │ │ │ │ +4542E058DCC4FF352A96547462BEC1CF81944498557B2EC3573F73FCA516CB9C │ │ │ │ │ +9A5B3FE6ABE533BF2A2174A17D54EBBEC88E48E19DAA19E677B700F7FD327CB7 │ │ │ │ │ +B5717878035F4563A565B0C5877B4D56E9A308FD2A369A21AFDF75646FCCF89C │ │ │ │ │ +1B4B20B5D9FFEE1E4B2183516E0EFB339708C1612124983C0F6DFE8E02AFB817 │ │ │ │ │ +6107350605A0FB00D54150B01CD30428376450F2DB2FD96D9E404038CBABF963 │ │ │ │ │ +3B492FC43496E0A3A5ED18B733EE61E7EAB0BE8B647ADDD37E97C5EFC8D1C19F │ │ │ │ │ +0C6300218C28D632730823BACB3F26FAF7BB98A7FF62650C58BCB592E5A9A9AF │ │ │ │ │ +E994D93E2C5F4074A837774791F0ED09913498CDBBF10E31CFB78E83521726B6 │ │ │ │ │ +70810BFFA1D9557FC47D0985BF6D071DA994E75BE261004DD63DCACC9C7EF276 │ │ │ │ │ +3B5005F00675A3E389FE768A562BBF82D10A3AA6AB595233B269795A1BCA6BC0 │ │ │ │ │ +D82E9DEA5009E56307D4F90DAB366511845328900FBD1D3A0974AAE6F3D0D082 │ │ │ │ │ +3381F505FC1C51305685901C412A361DDB496F8457E801D20E3D25CC6B74B90D │ │ │ │ │ +B6188058A129D9C4646C35FCD508D7A84F4902AEF1642A7F54108F9C11F1F670 │ │ │ │ │ +E0BB408B74DAEC3DBB23C17E173888F0B7EA4A5CBD3C6E8FC64A347B76C7D10E │ │ │ │ │ +DBE89E59D6967D4DE94BFF96318F25817DDF6455E6D1D0E32964A11900664ED4 │ │ │ │ │ +E61B1C1FF2EA65ADBF64D4D3674E1D7628A01AC4CCA30269482D57629A3D147C │ │ │ │ │ +53CBEE45AB05290CEACE60767DE112DC3090980717A65B2CF1A2D12451185DEA │ │ │ │ │ +E2AA14D2E4B196311360C4961E1C45B855BC19E3FEECFA911F7BDBF14B7DC1C5 │ │ │ │ │ +3696614AF402D7F10002A0FD428CD3F512D7332578B78E9BD03363A3A9AB86E5 │ │ │ │ │ +D03F160D78FCDAF4FD94E2DB85504289B2DDE689C8566FC560703222FB2F7ADE │ │ │ │ │ +8829EF36824644D1F58F9B6F9CC4D65C77D8992BC3E6D5FA072167BCAADC243A │ │ │ │ │ +92C21F9184625753C637BC8752B48C0A7A5930E6B12E464EA00A2533E2F015DB │ │ │ │ │ +7257F5446F13EEA0F658D97529E85837E02D7CC042934230A87EFD5C672A175D │ │ │ │ │ +7988125337794D26B5B0CD8B8F3CDA6D520D4BC9668F66A246BCD2C288F6E00F │ │ │ │ │ +A8FD53180F154405E3DCC11FE918CEB1C3DFD506F0B44BD6A7195089C876914E │ │ │ │ │ +25BBA23A63673677BF4DC8B1198560836501398185AC11761022359013FEEFA6 │ │ │ │ │ +8956DED15E9B181183495F49A0DDCA7CCA16F298951229BE8A48409A69D4CFC8 │ │ │ │ │ +B160D21C16EFF2A4CE39644D6B0C5E7DC2DED8B473E1DB387551A35BD44CF201 │ │ │ │ │ +CDEC173724C0D0EB234ACE2F65133613D70B8509BDE5B7D316F5F2C83E179E52 │ │ │ │ │ +D5130535AB7196BEB82E61168C4EE0DF9B7232C7EE88132663A1B1FD272D74E4 │ │ │ │ │ +A68047B5F5162045B0EB710084DBFD076808220E6BB24B0014DD4AD3AF7712B1 │ │ │ │ │ +68FDBD0A626A5765A7F000B42148BD07DF4DAD4F302889E00CE56E7A0313107C │ │ │ │ │ +194D0AD8C18EA65AFC27663E3F69FE2B050FE41A8C64EA00A57FC06A519CAFA1 │ │ │ │ │ +1D9A7603106E65293A1E38D547026691DC7C9C574A515E16304F703F9EF7EA0A │ │ │ │ │ +7A562239C8E4B88E004E16C81277AC968211A08024551E92F38EFF21B2252798 │ │ │ │ │ +A5583C23D884CC4951337F0FD9D63398BBCF146F83FAC1B4C12ADE6FC1980088 │ │ │ │ │ +A95F8921960ABB4AA44DF2F889B1DB6868314812D0D5649F44FAC3BF85B86115 │ │ │ │ │ +5F43C0C200E7D97203DA3FA2992080B970BAFC37A7D095D8E22C07FF206E4CB2 │ │ │ │ │ +BF4872A44C911CA31ADB4BBE42E25E058AD13DBE259F46653CC2817BC7282905 │ │ │ │ │ +8A826684D82DA9D1C2EFA613C3D4CC1E3E870A097A8C54BCA9F21C63C38B8908 │ │ │ │ │ +AF56126552737063C7395D8E9F415E6C748E33019DD43584BC652B70BFFAAD3F │ │ │ │ │ +3A4E9CEF2EDCC0435286C4F1A3EEF60F988B699A14BC349FF636AB5B298B19CE │ │ │ │ │ +B983E63D7F6D489951B8B717355A27FB989E90BE141150B6FAA88AA32C900792 │ │ │ │ │ +5613408A42C291CE5C60D88D8118648688CE5B1D1AD4CC2BE2887F2AD6CDACD8 │ │ │ │ │ +1BD31C17650283670F8880BEB6FD696679DEA623D020592AEFF17EF7903F01E9 │ │ │ │ │ +AB054F45D1DDD4F455A2C4738AF477FBA31084335DDFD9335A4185280EF39A82 │ │ │ │ │ +AC94D2854B9C683462C75D10114DEC0263D8AC05A333E173C752592884635EF1 │ │ │ │ │ +124932E242F3D56580446A13C9222C70E39ABBDFDD359D0E8A445EF459C5675E │ │ │ │ │ +238BC1F9C8C04ADC6E9927B9E5A1911968F978F0C82C4C1DE5C8F0BBB4AC21A8 │ │ │ │ │ +F847186E0A2B51B2B4B16B80209F7A308438F59D8397A22543DFA8A500BE7876 │ │ │ │ │ +F88B3EC8B05753F8C6AA99695935FB9A7C9D837B17B447CE7F99CE7809501553 │ │ │ │ │ +F2E7529000B6AEB196648E9B33AB730076E7426C097247E12D5DEB2A080F9F24 │ │ │ │ │ + │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5638,16 +5632,16 @@ │ │ │ │ │ FFFE000FFFFFFC0007FFFFF80003FFFFF00000FFFFC000003FFF0000000FFC000022227B │ │ │ │ │ A72D>136 D E │ │ │ │ │ /Ff load 0 Ff currentfont 91.25 scalefont put/FMat X/FBB │ │ │ │ │ X/IEn X │ │ │ │ │ %EndDVIPSBitmapFont │ │ │ │ │ /Fg 134[45 52 29[62 53 75 2[62 2[69 72 4[62 7[75 1[69 │ │ │ │ │ 68 2[71 2[25 25 58[{}15 90.9091 /CMMI10 rf /Fh 134[48 │ │ │ │ │ -3[51 2[36 12[40 2[51 45 26[59 11[25 1[45 2[45 2[45 1[45 │ │ │ │ │ -3[25 44[{}13 90.9091 /CMSL10 rf /Fi 234[71 71 17[71 1[71{}4 │ │ │ │ │ +3[51 2[36 3[51 12[45 22[47 15[25 2[45 2[45 1[45 1[45 │ │ │ │ │ +3[25 44[{}12 90.9091 /CMSL10 rf /Fi 234[71 71 17[71 1[71{}4 │ │ │ │ │ 90.9091 /CMSY10 rf /Fj 136[60 42 49 30 37 38 1[46 46 │ │ │ │ │ 51 74 23 42 1[28 46 42 1[42 46 42 42 46 12[65 1[66 3[68 │ │ │ │ │ 7[59 62 69 2[68 6[28 12[33 45[{}29 90.9091 /CMTI10 rf │ │ │ │ │ /Fk 134[59 1[81 1[62 44 44 46 1[62 56 62 93 31 2[31 62 │ │ │ │ │ 56 1[51 62 50 1[54 12[78 5[88 106 67 4[88 18[56 56 56 │ │ │ │ │ 56 2[31 1[31 44[{}29 99.6264 /CMBX12 rf /Fl 130[48 1[48 │ │ │ │ │ 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 │ │ │ │ │ @@ -5722,20 +5716,20 @@ │ │ │ │ │ Fp(,)30 b Fl(south)g Fp(or)h Fl(bottom)e Fp(are)i(less)g(than)g(or)g │ │ │ │ │ (equal)g(to)h(zero,)g(of)f(if)g Fl(east)25 b Fi(\025)h │ │ │ │ │ Fl(n1)o Fp(,)32 b(of)f(if)g Fl(north)24 b Fi(\025)i Fl(n2)p │ │ │ │ │ Fp(,)31 b(of)g(if)227 5407 y Fl(top)25 b Fi(\025)g Fl(n3)o │ │ │ │ │ Fp(,)31 b(an)f(error)g(message)h(is)g(prin)m(ted)f(and)g(the)g(program) │ │ │ │ │ g(exits.)1927 5656 y(1)p eop end │ │ │ │ │ %%Page: 2 2 │ │ │ │ │ -TeXDict begin 2 1 bop 0 100 a Fp(2)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 111 399 a Fp(2.)46 b Fl(void)h(mkNDperm2)e(\() │ │ │ │ │ -j(int)f(n1,)f(int)h(n2,)g(int)g(n3,)g(int)g(newToOld[],)e(int)i(west,) │ │ │ │ │ -1039 511 y(int)g(east,)f(int)h(south,)f(int)h(north,)f(int)h(bottom,)f │ │ │ │ │ -(int)h(top)f(\))i(;)227 655 y Fp(This)c(metho)s(d)f(this)i(v)m(ector)g │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fp(2)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 111 399 a Fp(2.)46 b Fl(void)h(mkNDperm2)e(\()j(int)f(n1,)f │ │ │ │ │ +(int)h(n2,)g(int)g(n3,)g(int)g(newToOld[],)e(int)i(west,)1039 │ │ │ │ │ +511 y(int)g(east,)f(int)h(south,)f(int)h(north,)f(int)h(bottom,)f(int)h │ │ │ │ │ +(top)f(\))i(;)227 655 y Fp(This)c(metho)s(d)f(this)i(v)m(ector)g │ │ │ │ │ (\014lls)f(a)h(p)s(erm)m(utation)f(v)m(ector)i(with)e(the)h(nested)f │ │ │ │ │ (dissection)h(new-to-old)227 768 y(ordering)30 b(of)h(the)f(v)m │ │ │ │ │ (ertices)j(for)d(the)g(subgrid)f(de\014ned)g(b)m(y)i(no)s(des)e(whose)h │ │ │ │ │ (co)s(ordinates)h(lie)h(in)227 955 y Fl([west,)46 b(east])h(x)g │ │ │ │ │ ([south,)f(north])g(x)i([bottom,)d(top].)227 1142 y Fp(There)31 │ │ │ │ │ b(is)g(one)h(imp)s(ortan)m(t)f(di\013erence)h(b)s(et)m(w)m(een)g(this)f │ │ │ │ │ (metho)s(d)g(and)g Fl(mkNDperm\(\))d Fp(ab)s(o)m(v)m(e;)33 │ │ │ │ │ @@ -5819,17 +5813,17 @@ │ │ │ │ │ Fp(,)26 b(en)m(tries)h(in)f Fl(dsizes2[])d Fp(m)m(ust)227 │ │ │ │ │ 5294 y(sum)28 b(to)h Fl(n2)47 b(-)h(p2)f(+)g(1)p Fp(,)29 │ │ │ │ │ b(and)f(en)m(tries)i(in)e Fl(dsizes3[])e Fp(m)m(ust)i(sum)g(to)h │ │ │ │ │ Fl(n3)47 b(-)h(p3)f(+)g(1)p Fp(,)29 b(an)g(error)f(message)227 │ │ │ │ │ 5407 y(is)j(prin)m(ted)f(and)f(the)i(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 3 3 │ │ │ │ │ -TeXDict begin 3 2 bop 91 100 1134 4 v 1315 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)41 b Fj(DRAFT)121 b Fh(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fp(3)111 399 y(5.)46 b Fl(void)h(fp2DGrid)e(\()j(int) │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1153 4 v 1334 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)41 b Fj(DRAFT)121 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fp(3)111 399 y(5.)46 b Fl(void)h(fp2DGrid)e(\()j(int) │ │ │ │ │ f(n1,)g(int)g(n2,)g(int)f(ivec[],)g(FILE)h(*fp)g(\))g(;)227 │ │ │ │ │ 562 y Fp(This)40 b(metho)s(d)f(writes)i(the)f Fl(ivec[])f │ │ │ │ │ Fp(v)m(ector)j(on)m(to)f(an)f Fl(n1)48 b(x)f(n2)40 b │ │ │ │ │ Fp(grid)g(to)h(\014le)f Fl(fp)p Fp(.)70 b(This)39 b(is)i(useful)e(to) │ │ │ │ │ 227 675 y(visualize)32 b(an)e(ordering)g(or)h(a)f(metric)h(on)g(a)g │ │ │ │ │ (grid.)227 838 y Fj(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ b Fp(If)29 b Fl(n1)g Fp(or)h Fl(n2)f Fp(are)h(less)g(than)g(or)g(equal) │ │ │ │ │ @@ -5901,20 +5895,20 @@ │ │ │ │ │ (amoun)m(ts)227 5131 y(of)31 b(output.)227 5294 y Fj(Err)-5 │ │ │ │ │ b(or)33 b(che)-5 b(cking:)40 b Fp(If)29 b Fl(graph)f │ │ │ │ │ Fp(is)h Fl(NULL)p Fp(,)g(or)g(if)h Fl(msglvl)46 b(>)h(0)29 │ │ │ │ │ b Fp(and)g Fl(msgFile)e Fp(is)j Fl(NULL)p Fp(,)e(an)h(error)g(message)i │ │ │ │ │ (is)227 5407 y(prin)m(ted)f(and)g(the)h(program)f(exits.)p │ │ │ │ │ eop end │ │ │ │ │ %%Page: 4 4 │ │ │ │ │ -TeXDict begin 4 3 bop 0 100 a Fp(4)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 111 399 a Fp(2.)46 b Fl(ETree)h(*)g │ │ │ │ │ -(orderViaND)e(\()j(Graph)e(*graph,)g(int)h(maxdomainsize,)d(int)i │ │ │ │ │ -(seed,)1230 511 y(int)g(msglvl,)g(FILE)h(*msgFile)e(\))j(;)227 │ │ │ │ │ -664 y Fp(This)32 b(metho)s(d)g(returns)g(a)h(fron)m(t)g(tree)g │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fp(4)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 111 399 a Fp(2.)46 b Fl(ETree)h(*)g(orderViaND)e(\()j(Graph) │ │ │ │ │ +e(*graph,)g(int)h(maxdomainsize,)d(int)i(seed,)1230 511 │ │ │ │ │ +y(int)g(msglvl,)g(FILE)h(*msgFile)e(\))j(;)227 664 y │ │ │ │ │ +Fp(This)32 b(metho)s(d)g(returns)g(a)h(fron)m(t)g(tree)g │ │ │ │ │ Fl(ETree)f Fp(ob)5 b(ject)33 b(for)g(a)g(nested)g(dissection)g │ │ │ │ │ (ordering)g(of)g(the)f(graph)227 777 y Fl(graph)p Fp(.)45 │ │ │ │ │ b(If)32 b(a)g(subgraph)e(has)i(more)h(v)m(ertices)g(than)f(the)h │ │ │ │ │ Fl(maxdomainsize)28 b Fp(parameter,)33 b(it)g(is)f(split.)46 │ │ │ │ │ b(The)227 889 y Fl(seed)c Fp(parameter)i(is)f(a)g(random)f(n)m(um)m(b)s │ │ │ │ │ (er)g(seed.)78 b(The)43 b Fl(msglvl)e Fp(and)h Fl(msgFile)f │ │ │ │ │ Fp(parameters)j(go)m(v)m(ern)227 1002 y(the)36 b(diagnostics)g(output.) │ │ │ │ │ @@ -5989,17 +5983,17 @@ │ │ │ │ │ 5294 y(The)40 b Fl(graph)f Fp(ob)5 b(ject)41 b(de\014nes)e(the)h │ │ │ │ │ (connectivit)m(y)i(of)f(the)f(v)m(ertices.)72 b(The)39 │ │ │ │ │ b Fl(coords)g Fp(ob)5 b(ject)41 b(de\014nes)e(the)227 │ │ │ │ │ 5407 y(lo)s(cations)k(of)f(the)f(v)m(ertices.)76 b(The)41 │ │ │ │ │ b Fl(tagsIV)e Fp(ob)5 b(ject)43 b(is)e(used)g(to)h(de\014ne)f(whether)f │ │ │ │ │ (or)i(not)f(an)h(edge)g(is)p eop end │ │ │ │ │ %%Page: 5 5 │ │ │ │ │ -TeXDict begin 5 4 bop 91 100 1134 4 v 1315 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)41 b Fj(DRAFT)121 b Fh(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fp(5)227 399 y(dra)m(wn)h(b)s(et)m(w)m(een)h(t)m(w)m │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1153 4 v 1334 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)41 b Fj(DRAFT)121 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fp(5)227 399 y(dra)m(wn)h(b)s(et)m(w)m(een)h(t)m(w)m │ │ │ │ │ (o)h(v)m(ertices)h(adjacen)m(t)f(in)e(the)h(graph.)47 │ │ │ │ │ b(When)32 b Fl(tagsIV)f Fp(is)i(not)g Fl(NULL)p Fp(,)f(if)g(there)h(is) │ │ │ │ │ g(an)227 511 y(edge)g Fl(\(u,v\))f Fp(in)g(the)h(graph)f(and)f │ │ │ │ │ Fl(tags[u])46 b(=)i(tags[v])p Fp(,)31 b(then)h(the)h(edge)g(with)f │ │ │ │ │ (width)g Fl(linewidth1)e Fp(is)227 624 y(dra)m(wn.)54 │ │ │ │ │ b(F)-8 b(or)36 b(edges)f Fl(\(u,v\))f Fp(in)g(the)h(graph)g(and)f │ │ │ │ │ Fl(tags[u])46 b(!=)h(tags[v])p Fp(,)35 b(then)f(the)h(edge)h(with)f │ │ │ │ │ @@ -6082,28 +6076,27 @@ │ │ │ │ │ Fp(is)31 b(computed)g(as)g(the)g(pro)s(duct)f(of)i Fg(A)f │ │ │ │ │ Fp(with)f Fg(X)7 b Fp(.)44 b Fg(A)31 b Fp(can)g(b)s(e)g(real)g(\()p │ │ │ │ │ Fl(type)47 b(=)227 5407 y(1)p Fp(\))28 b(or)f(complex)i(\()p │ │ │ │ │ Fl(type)47 b(=)g(2)p Fp(\).)40 b(The)27 b(n)m(um)m(b)s(er)f(of)i │ │ │ │ │ (columns)g(of)f Fg(X)35 b Fp(is)28 b(giv)m(en)h(b)m(y)e │ │ │ │ │ Fl(nrhs)p Fp(.)39 b(The)27 b(linear)h(system)p eop end │ │ │ │ │ %%Page: 6 6 │ │ │ │ │ -TeXDict begin 6 5 bop 0 100 a Fp(6)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 227 399 a Fp(is)41 b(ordered)f(using)h │ │ │ │ │ -(theoretical)i(nested)e(dissection,)j(and)d(the)g(fron)m(t)g(tree)g(is) │ │ │ │ │ -g(transformed)f(using)h(the)227 511 y Fl(maxzeros)31 │ │ │ │ │ -b Fp(and)i Fl(maxsize)e Fp(parameters.)49 b(The)33 b(addresses)f(of)h │ │ │ │ │ -(the)h(fron)m(t)f(tree,)i(sym)m(b)s(olic)e(factorization,)227 │ │ │ │ │ -624 y(and)d(three)h(matrix)f(ob)5 b(jects)31 b(are)g(returned)e(in)h │ │ │ │ │ -(the)h(last)g(\014v)m(e)g(argumen)m(ts)g(of)f(the)h(calling)h │ │ │ │ │ -(sequence.)227 769 y Fj(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ -b Fp(None)31 b(presen)m(tly)-8 b(.)0 1071 y Fn(1.2)135 │ │ │ │ │ -b(Driv)l(er)46 b(programs)g(found)e(in)h(the)g Fm(Misc)e │ │ │ │ │ -Fn(directory)0 1294 y Fp(This)30 b(section)h(con)m(tains)h(brief)e │ │ │ │ │ -(descriptions)g(of)g(the)h(driv)m(er)f(programs.)111 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fp(6)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 227 399 a Fp(is)41 b(ordered)f(using)h(theoretical)i(nested) │ │ │ │ │ +e(dissection,)j(and)d(the)g(fron)m(t)g(tree)g(is)g(transformed)f(using) │ │ │ │ │ +h(the)227 511 y Fl(maxzeros)31 b Fp(and)i Fl(maxsize)e │ │ │ │ │ +Fp(parameters.)49 b(The)33 b(addresses)f(of)h(the)h(fron)m(t)f(tree,)i │ │ │ │ │ +(sym)m(b)s(olic)e(factorization,)227 624 y(and)d(three)h(matrix)f(ob)5 │ │ │ │ │ +b(jects)31 b(are)g(returned)e(in)h(the)h(last)g(\014v)m(e)g(argumen)m │ │ │ │ │ +(ts)g(of)f(the)h(calling)h(sequence.)227 769 y Fj(Err)-5 │ │ │ │ │ +b(or)34 b(che)-5 b(cking:)40 b Fp(None)31 b(presen)m(tly)-8 │ │ │ │ │ +b(.)0 1071 y Fn(1.2)135 b(Driv)l(er)46 b(programs)g(found)e(in)h(the)g │ │ │ │ │ +Fm(Misc)e Fn(directory)0 1294 y Fp(This)30 b(section)h(con)m(tains)h │ │ │ │ │ +(brief)e(descriptions)g(of)g(the)h(driv)m(er)f(programs.)111 │ │ │ │ │ 1495 y(1.)46 b Fl(testNDperm)f(msglvl)h(msgFile)g(n1)h(n2)h(n3)f │ │ │ │ │ (outPermFile)227 1641 y Fp(This)29 b(driv)m(er)h(program)g(generates)h │ │ │ │ │ (a)g Fl(Perm)d Fp(ob)5 b(ject)31 b(that)g(con)m(tains)g(a)f(nested)g │ │ │ │ │ (dissection)h(ordering)f(for)g(a)227 1753 y Fl(n1)47 │ │ │ │ │ b(x)h(n2)f(x)h(n3)29 b Fp(regular)i(grid.)337 1951 y │ │ │ │ │ Ff(\210)45 b Fp(The)28 b Fl(msglvl)f Fp(parameter)i(determines)g(the)g │ │ │ │ │ (amoun)m(t)g(of)f(output)h(|)f(taking)i Fl(msglvl)46 │ │ │ │ │ @@ -6160,17 +6153,17 @@ │ │ │ │ │ b(Otherwise,)41 b(the)e Fl(ETree)p 3253 5181 V 33 w(writeToFile\(\))427 │ │ │ │ │ 5294 y Fp(metho)s(d)g(is)h(called)h(to)f(write)g(the)g(ob)5 │ │ │ │ │ b(ject)40 b(to)g(a)g(formatted)h(\014le)e(\(if)h Fl(ETreeFile)d │ │ │ │ │ Fp(is)j(of)g(the)f(form)427 5407 y Fl(*.etreef)p Fp(\),)29 │ │ │ │ │ b(or)h(a)h(binary)f(\014le)g(\(if)h Fl(ETreeFile)d Fp(is)i(of)h(the)f │ │ │ │ │ (form)g Fl(*.etreeb)p Fp(\).)p eop end │ │ │ │ │ %%Page: 7 7 │ │ │ │ │ -TeXDict begin 7 6 bop 91 100 1134 4 v 1315 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)41 b Fj(DRAFT)121 b Fh(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fp(7)111 399 y(3.)46 b Fl(testOrderViaND)e(msglvl)i │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1153 4 v 1334 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)41 b Fj(DRAFT)121 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fp(7)111 399 y(3.)46 b Fl(testOrderViaND)e(msglvl)i │ │ │ │ │ (msgFile)g(GraphFile)f(maxdomainsize)g(seed)h(ETreeFile)227 │ │ │ │ │ 550 y Fp(This)23 b(program)h(reads)g(in)g(a)g Fl(Graph)f │ │ │ │ │ Fp(ob)5 b(ject)25 b(from)e(a)i(\014le)f(and)f(computes)h(a)h │ │ │ │ │ (generalized)g(nested)f(dissection)227 663 y(ordering)30 │ │ │ │ │ b(of)h(the)f(graph.)337 878 y Ff(\210)45 b Fp(The)28 │ │ │ │ │ b Fl(msglvl)f Fp(parameter)i(determines)g(the)g(amoun)m(t)g(of)f │ │ │ │ │ (output)h(|)f(taking)i Fl(msglvl)46 b(>=)h(3)28 b Fp(means)427 │ │ │ │ │ @@ -6240,35 +6233,34 @@ │ │ │ │ │ Fp(is)j(of)g(the)f(form)427 5079 y Fl(*.etreef)p Fp(\),)29 │ │ │ │ │ b(or)h(a)h(binary)f(\014le)g(\(if)h Fl(ETreeFile)d Fp(is)i(of)h(the)f │ │ │ │ │ (form)g Fl(*.etreeb)p Fp(\).)111 5294 y(5.)46 b Fl(drawGraph)g(msglvl)g │ │ │ │ │ (msgFile)f(inGraphFile)g(inCoordsFile)g(inTagsIVfile)705 │ │ │ │ │ 5407 y(outEPSfile)g(linewidth1)g(linewidth2)g(bbox[4])g(rect[4])h │ │ │ │ │ (radius)p eop end │ │ │ │ │ %%Page: 8 8 │ │ │ │ │ -TeXDict begin 8 7 bop 0 100 a Fp(8)p 136 100 1134 4 v │ │ │ │ │ -1316 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(F)-8 b(ebruary)30 │ │ │ │ │ -b(8,)h(2025)p 2767 100 V 227 399 a Fp(This)41 b(driv)m(er)g(program)h │ │ │ │ │ -(generates)h(a)f(Encapsulated)f(P)m(ostscript)i(\014le)e │ │ │ │ │ -Fl(outEPSfile)e Fp(of)j(a)g(2-D)g(graph)227 511 y(using)29 │ │ │ │ │ -b(a)i Fl(Graph)d Fp(ob)5 b(ject,)31 b(a)f Fl(Coords)e │ │ │ │ │ -Fp(ob)5 b(ject)31 b(and)e(a)h(tags)h Fl(IV)e Fp(ob)5 │ │ │ │ │ -b(ject)30 b(that)h(con)m(tains)f(the)g(comp)s(onen)m(t)g(ids)227 │ │ │ │ │ -624 y(of)h(the)f(v)m(ertices.)227 780 y(See)h(the)f Fl(doDraw)f │ │ │ │ │ -Fp(script)h(\014le)h(in)f(this)g(directory)h(for)f(an)g(example)i │ │ │ │ │ -(calling)f(sequence.)337 978 y Ff(\210)45 b Fp(The)28 │ │ │ │ │ -b Fl(msglvl)f Fp(parameter)i(determines)g(the)g(amoun)m(t)g(of)f │ │ │ │ │ -(output)h(|)f(taking)i Fl(msglvl)46 b(>=)h(3)28 b Fp(means)427 │ │ │ │ │ -1091 y(that)j(all)h(ob)5 b(jects)31 b(are)f(written)h(to)g(the)f │ │ │ │ │ -(output)g(\014le.)337 1243 y Ff(\210)45 b Fp(The)33 b │ │ │ │ │ -Fl(msgFile)e Fp(parameter)j(determines)f(the)h(message)g(\014le)f(|)h │ │ │ │ │ -(if)f Fl(msgFile)e Fp(is)i Fl(stdout)p Fp(,)g(then)g(the)427 │ │ │ │ │ -1356 y(message)27 b(\014le)f(is)g Fj(stdout)p Fp(,)i(otherwise)e(a)h │ │ │ │ │ -(\014le)f(is)f(op)s(ened)g(with)h Fj(app)-5 b(end)28 │ │ │ │ │ -b Fp(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 1469 │ │ │ │ │ -y(data.)337 1620 y Ff(\210)45 b Fp(The)23 b Fl(inGraphFile)d │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fp(8)p 136 100 1153 4 v │ │ │ │ │ +1335 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(Jan)m(uary)g(7,)h(2024)p │ │ │ │ │ +2748 100 V 227 399 a Fp(This)41 b(driv)m(er)g(program)h(generates)h(a)f │ │ │ │ │ +(Encapsulated)f(P)m(ostscript)i(\014le)e Fl(outEPSfile)e │ │ │ │ │ +Fp(of)j(a)g(2-D)g(graph)227 511 y(using)29 b(a)i Fl(Graph)d │ │ │ │ │ +Fp(ob)5 b(ject,)31 b(a)f Fl(Coords)e Fp(ob)5 b(ject)31 │ │ │ │ │ +b(and)e(a)h(tags)h Fl(IV)e Fp(ob)5 b(ject)30 b(that)h(con)m(tains)f │ │ │ │ │ +(the)g(comp)s(onen)m(t)g(ids)227 624 y(of)h(the)f(v)m(ertices.)227 │ │ │ │ │ +780 y(See)h(the)f Fl(doDraw)f Fp(script)h(\014le)h(in)f(this)g │ │ │ │ │ +(directory)h(for)f(an)g(example)i(calling)f(sequence.)337 │ │ │ │ │ +978 y Ff(\210)45 b Fp(The)28 b Fl(msglvl)f Fp(parameter)i(determines)g │ │ │ │ │ +(the)g(amoun)m(t)g(of)f(output)h(|)f(taking)i Fl(msglvl)46 │ │ │ │ │ +b(>=)h(3)28 b Fp(means)427 1091 y(that)j(all)h(ob)5 b(jects)31 │ │ │ │ │ +b(are)f(written)h(to)g(the)f(output)g(\014le.)337 1243 │ │ │ │ │ +y Ff(\210)45 b Fp(The)33 b Fl(msgFile)e Fp(parameter)j(determines)f │ │ │ │ │ +(the)h(message)g(\014le)f(|)h(if)f Fl(msgFile)e Fp(is)i │ │ │ │ │ +Fl(stdout)p Fp(,)g(then)g(the)427 1356 y(message)27 b(\014le)f(is)g │ │ │ │ │ +Fj(stdout)p Fp(,)i(otherwise)e(a)h(\014le)f(is)f(op)s(ened)g(with)h │ │ │ │ │ +Fj(app)-5 b(end)28 b Fp(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 │ │ │ │ │ +1469 y(data.)337 1620 y Ff(\210)45 b Fp(The)23 b Fl(inGraphFile)d │ │ │ │ │ Fp(parameter)k(is)f(the)h(input)e(\014le)i(for)f(the)g │ │ │ │ │ Fl(Graph)f Fp(ob)5 b(ject.)39 b(It)24 b(m)m(ust)f(b)s(e)f(of)i(the)f │ │ │ │ │ (form)427 1733 y Fl(*.graphf)18 b Fp(or)j Fl(*.graphb)p │ │ │ │ │ Fp(.)35 b(The)19 b Fl(Graph)g Fp(ob)5 b(ject)21 b(is)g(read)f(from)g │ │ │ │ │ (the)g(\014le)h(via)f(the)h Fl(Graph)p 3368 1733 29 4 │ │ │ │ │ v 33 w(readFromFile\(\))427 1846 y Fp(metho)s(d.)337 │ │ │ │ │ 1997 y Ff(\210)45 b Fp(The)c Fl(inCoordsFile)c Fp(parameter)k(is)g(the) │ │ │ │ │ @@ -6327,17 +6319,17 @@ │ │ │ │ │ y Fd(1)p Fc(;)p Fd(1)1975 5207 y Fe(#)16 b(")2129 5294 │ │ │ │ │ y Fg(X)2204 5308 y Fd(0)2129 5407 y Fg(X)2204 5421 y │ │ │ │ │ Fd(1)2285 5207 y Fe(#)2359 5351 y Fp(=)2455 5207 y Fe(")2545 │ │ │ │ │ 5294 y Fg(B)2614 5308 y Fd(0)2545 5407 y Fg(B)2614 5421 │ │ │ │ │ y Fd(1)2695 5207 y Fe(#)2768 5351 y Fp(=)25 b Fg(B)5 │ │ │ │ │ b(:)p eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 91 100 1134 4 v 1315 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)41 b Fj(DRAFT)121 b Fh(F)-8 b(ebruary)30 b(8,)h(2025)p │ │ │ │ │ -2719 100 V 1134 w Fp(9)1541 1617 y(Figure)g(1.1:)42 b │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1153 4 v 1334 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)41 b Fj(DRAFT)121 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2700 100 V 1153 w Fp(9)1541 1617 y(Figure)g(1.1:)42 b │ │ │ │ │ Fb(R2D100)750 4143 y @beginspecial 0 @llx 0 @lly 600 │ │ │ │ │ @urx 600 @ury 2880 @rwi 2880 @rhi @setspecial │ │ │ │ │ %%BeginDocument: ../../misc/doc/R2D100notags.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0.0 0.0 600.0 600.0 │ │ │ │ │ /radius 10.000 def │ │ │ │ │ /Helvetica findfont 12.500 scalefont setfont │ │ │ │ │ @@ -6742,20 +6734,19 @@ │ │ │ │ │ 348.123 444.374 () radius drawLabel │ │ │ │ │ grestore │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 10 10 │ │ │ │ │ -TeXDict begin 10 9 bop 0 100 a Fp(10)p 182 100 1111 4 │ │ │ │ │ -v 1293 w Fl(Misc)30 b Fh(:)40 b Fj(DRAFT)30 b Fh(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2789 100 V 813 1617 a Fp(Figure)f(1.2:)42 │ │ │ │ │ -b Fb(R2D100:)k(fishnet)33 b(domain)h(decomposition)750 │ │ │ │ │ -4143 y @beginspecial 0 @llx 0 @lly 600 @urx 600 @ury │ │ │ │ │ -2880 @rwi 2880 @rhi @setspecial │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fp(10)p 182 100 1130 4 │ │ │ │ │ +v 1312 w Fl(Misc)30 b Fh(:)40 b Fj(DRAFT)31 b Fh(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2770 100 V 813 1617 a Fp(Figure)f(1.2:)42 b Fb(R2D100:)k │ │ │ │ │ +(fishnet)33 b(domain)h(decomposition)750 4143 y @beginspecial │ │ │ │ │ +0 @llx 0 @lly 600 @urx 600 @ury 2880 @rwi 2880 @rhi @setspecial │ │ │ │ │ %%BeginDocument: ../../misc/doc/R2D100fishnet.eps │ │ │ │ │ %!PS-Adobe-2.0 EPSF-1.2 │ │ │ │ │ %%BoundingBox: 0.0 0.0 600.0 600.0 │ │ │ │ │ /radius 10.000 def │ │ │ │ │ /Helvetica findfont 12.500 scalefont setfont │ │ │ │ │ /M {moveto} def │ │ │ │ │ /L {lineto} def │ │ │ │ │ @@ -7162,17 +7153,17 @@ │ │ │ │ │ 348.123 444.374 (0) radius drawLabel │ │ │ │ │ grestore │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1111 4 v 1292 100 a Fl(Misc)30 │ │ │ │ │ -b Fh(:)40 b Fj(DRAFT)121 b Fh(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2697 100 V 1111 w Fp(11)227 399 y Fg(A)g Fp(is)f(factored)h(as)1106 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1130 4 v 1312 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)122 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2678 100 V 1130 w Fp(11)227 399 y Fg(A)g Fp(is)f(factored)h(as)1106 │ │ │ │ │ 410 y Fe(")1196 497 y Fg(A)1264 511 y Fd(0)p Fc(;)p Fd(0)1441 │ │ │ │ │ 497 y Fg(A)1509 511 y Fd(0)p Fc(;)p Fd(1)1196 610 y Fg(A)1264 │ │ │ │ │ 624 y Fd(1)p Fc(;)p Fd(0)1441 610 y Fg(A)1509 624 y Fd(1)p │ │ │ │ │ Fc(;)p Fd(1)1645 410 y Fe(#)1719 554 y Fp(=)1815 410 │ │ │ │ │ y Fe(")1905 497 y Fg(L)1967 511 y Fd(0)p Fc(;)p Fd(0)2199 │ │ │ │ │ 497 y Fp(0)1905 610 y Fg(L)1967 624 y Fd(1)p Fc(;)p Fd(0)2144 │ │ │ │ │ 610 y Fg(L)2206 624 y Fd(1)p Fc(;)p Fd(1)2342 410 y Fe(#)15 │ │ │ │ │ @@ -7281,20 +7272,20 @@ │ │ │ │ │ Fp(parameter)j(is)g(the)g(input)e(\014le)i(for)f(the)h │ │ │ │ │ Fl(Graph)e Fp(ob)5 b(ject.)41 b(It)30 b(m)m(ust)f(b)s(e)g(of)h(the)f │ │ │ │ │ (form)427 5294 y Fl(*.graphf)18 b Fp(or)j Fl(*.graphb)p │ │ │ │ │ Fp(.)35 b(The)19 b Fl(Graph)g Fp(ob)5 b(ject)21 b(is)g(read)f(from)g │ │ │ │ │ (the)g(\014le)h(via)f(the)h Fl(Graph)p 3368 5294 V 33 │ │ │ │ │ w(readFromFile\(\))427 5407 y Fp(metho)s(d.)p eop end │ │ │ │ │ %%Page: 12 12 │ │ │ │ │ -TeXDict begin 12 11 bop 0 100 a Fp(12)p 182 100 1111 │ │ │ │ │ -4 v 1293 w Fl(Misc)30 b Fh(:)40 b Fj(DRAFT)30 b Fh(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2789 100 V 337 399 a Ff(\210)45 │ │ │ │ │ -b Fp(The)29 b Fl(ETreeFile)e Fp(parameter)j(is)g(the)g(input)e(\014le)i │ │ │ │ │ -(for)f(the)h Fl(ETree)e Fp(ob)5 b(ject.)41 b(It)30 b(m)m(ust)f(b)s(e)g │ │ │ │ │ -(of)h(the)f(form)427 511 y Fl(*.etreef)18 b Fp(or)j Fl(*.etreeb)p │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fp(12)p 182 100 1130 │ │ │ │ │ +4 v 1312 w Fl(Misc)30 b Fh(:)40 b Fj(DRAFT)31 b Fh(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2770 100 V 337 399 a Ff(\210)45 b Fp(The)29 b │ │ │ │ │ +Fl(ETreeFile)e Fp(parameter)j(is)g(the)g(input)e(\014le)i(for)f(the)h │ │ │ │ │ +Fl(ETree)e Fp(ob)5 b(ject.)41 b(It)30 b(m)m(ust)f(b)s(e)g(of)h(the)f │ │ │ │ │ +(form)427 511 y Fl(*.etreef)18 b Fp(or)j Fl(*.etreeb)p │ │ │ │ │ Fp(.)35 b(The)19 b Fl(ETree)g Fp(ob)5 b(ject)21 b(is)g(read)f(from)g │ │ │ │ │ (the)g(\014le)h(via)f(the)h Fl(ETree)p 3368 511 29 4 │ │ │ │ │ v 33 w(readFromFile\(\))427 624 y Fp(metho)s(d.)337 769 │ │ │ │ │ y Ff(\210)45 b Fp(The)31 b Fl(mapFile)f Fp(parameter)i(is)g(the)g │ │ │ │ │ (input)e(\014le)i(for)f(the)h(map)f Fl(IV)g Fp(ob)5 b(ject.)46 │ │ │ │ │ b(It)31 b(m)m(ust)h(b)s(e)f(of)h(the)f(form)427 882 y │ │ │ │ │ Fl(*.ivf)24 b Fp(or)h Fl(*.ivb)p Fp(.)37 b(The)25 b Fl(IV)f │ │ │ │ │ @@ -7359,17 +7350,17 @@ │ │ │ │ │ Fl(nrow)f Fp(m)m(ust)h(b)s(e)g(equal)h(to)g Fl(ncol)e │ │ │ │ │ Fp(since)h(w)m(e)h(are)g(factoring)g(a)g(square)f(matrix.\))50 │ │ │ │ │ b(Eac)m(h)34 b(of)427 5294 y(the)h Fl(nent)e Fp(follo)m(wing)i(lines)g │ │ │ │ │ (con)m(tain)g(one)f(nonzero)h(en)m(try)-8 b(.)53 b(F)-8 │ │ │ │ │ b(or)35 b(a)f(complex)h(matrix,)h(the)e(\014le)g(has)427 │ │ │ │ │ 5407 y(this)d(structure.)p eop end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 91 100 1111 4 v 1292 100 a Fl(Misc)30 │ │ │ │ │ -b Fh(:)40 b Fj(DRAFT)121 b Fh(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2697 100 V 1111 w Fp(13)427 399 y Fl(nrow)47 b(ncol)g(nent)427 │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1130 4 v 1312 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)122 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2678 100 V 1130 w Fp(13)427 399 y Fl(nrow)47 b(ncol)g(nent)427 │ │ │ │ │ 511 y(...)427 624 y(irow)g(jcol)g(real_value)e(imag_value)427 │ │ │ │ │ 737 y(...)427 904 y Fp(F)-8 b(or)30 b(b)s(oth)e(real)i(and)e(complex)h │ │ │ │ │ (en)m(tries,)i(the)e(en)m(tries)g(need)g(not)g(b)s(e)f(disjoin)m(t,)i │ │ │ │ │ (i.e.,)h(en)m(tries)e(with)g(the)427 1017 y(same)i Fl(irow)e │ │ │ │ │ Fp(and)h Fl(jcol)f Fp(v)-5 b(alues)31 b(are)g Fj(summe)-5 │ │ │ │ │ b(d)p Fp(.)337 1163 y Ff(\210)45 b Fp(The)26 b Fl(rhsFileName)d │ │ │ │ │ Fp(parameter)k(is)g(the)f(name)h(of)f(the)h(input)e(\014le)i(for)f(the) │ │ │ │ │ @@ -7425,43 +7416,42 @@ │ │ │ │ │ (\(SPOOLES)p 1417 5148 V 32 w(SYMMETRIC\))28 b Fp(for)i │ │ │ │ │ Fg(A)g Fp(real)h(or)g(complex)g(symmetric,)500 5278 y │ │ │ │ │ Fo({)45 b Fl(type)i(=)g(1)h(\(SPOOLES)p 1417 5278 V 32 │ │ │ │ │ w(HERMITIAN\))28 b Fp(for)i Fg(A)g Fp(complex)h(Hermitian,)500 │ │ │ │ │ 5407 y Fo({)45 b Fl(type)i(=)g(2)h(\(SPOOLES)p 1417 5407 │ │ │ │ │ V 32 w(NONSYMMETRIC\))p eop end │ │ │ │ │ %%Page: 14 14 │ │ │ │ │ -TeXDict begin 14 13 bop 0 100 a Fp(14)p 182 100 1111 │ │ │ │ │ -4 v 1293 w Fl(Misc)30 b Fh(:)40 b Fj(DRAFT)30 b Fh(F)-8 │ │ │ │ │ -b(ebruary)31 b(8,)g(2025)p 2789 100 V 427 399 a Fp(for)f │ │ │ │ │ -Fg(A)h Fp(real)g(or)f(complex)h(nonsymmetric.)337 539 │ │ │ │ │ -y Ff(\210)45 b Fp(The)30 b Fl(patchAndGoFlag)d Fp(sp)s(eci\014es)j(the) │ │ │ │ │ -g(\\patc)m(h-and-go")j(strategy)-8 b(.)500 680 y Fo({)45 │ │ │ │ │ -b Fl(patchAndGoFlag)f(=)k(0)21 b Fp(|)g(if)g(a)h(zero)g(piv)m(ot)g(is)f │ │ │ │ │ -(detected,)k(stop)c(computing)h(the)f(factorization,)597 │ │ │ │ │ -793 y(set)31 b(the)g(error)f(\015ag)g(and)g(return.)500 │ │ │ │ │ -920 y Fo({)45 b Fl(patchAndGoFlag)f(=)k(1)30 b Fp(|)h(if)g(a)h(small)f │ │ │ │ │ -(or)h(zero)f(piv)m(ot)h(is)g(detected,)g(set)g(the)f(diagonal)i(en)m │ │ │ │ │ -(try)597 1033 y(to)e(1)g(and)f(the)g(o\013diagonal)j(en)m(tries)e(to)g │ │ │ │ │ -(zero.)500 1159 y Fo({)45 b Fl(patchAndGoFlag)f(=)k(2)34 │ │ │ │ │ -b Fp(|)h(if)g(a)h(small)f(or)h(zero)f(piv)m(ot)h(is)g(detected,)h(p)s │ │ │ │ │ -(erturb)c(the)j(diagonal)597 1272 y(en)m(try)-8 b(.)337 │ │ │ │ │ -1413 y Ff(\210)45 b Fp(The)30 b Fl(fudge)f Fp(parameter)i(is)f(used)g │ │ │ │ │ -(to)h(p)s(erturb)d(a)j(diagonal)h(en)m(try)-8 b(.)337 │ │ │ │ │ -1554 y Ff(\210)45 b Fp(The)30 b Fl(toosmall)e Fp(parameter)j(is)g │ │ │ │ │ -(judge)e(when)h(a)h(diagonal)g(en)m(try)g(is)f(small.)337 │ │ │ │ │ -1695 y Ff(\210)45 b Fp(If)30 b Fl(storeids)46 b(=)h(1)p │ │ │ │ │ -Fp(,)30 b(then)h(the)f(lo)s(cations)i(where)e(action)i(w)m(as)e(tak)m │ │ │ │ │ -(en)i(is)e(stored)h(in)f(an)g Fl(IV)g Fp(ob)5 b(ject.)337 │ │ │ │ │ -1835 y Ff(\210)45 b Fp(If)30 b Fl(storevalues)45 b(=)i(1)p │ │ │ │ │ -Fp(,)31 b(then)f(the)g(p)s(erturbations)f(are)i(stored)g(in)f(an)g │ │ │ │ │ -Fl(DV)g Fp(ob)5 b(ject.)337 1976 y Ff(\210)45 b Fp(The)37 │ │ │ │ │ -b Fl(matrixFileName)d Fp(parameter)k(is)f(the)h(name)f(of)h(the)g │ │ │ │ │ -(\014les)f(where)g(the)h(matrix)f(en)m(tries)i(are)427 │ │ │ │ │ -2089 y(read)31 b(from.)40 b(The)30 b(\014le)g(has)g(the)h(follo)m(wing) │ │ │ │ │ -h(structure.)427 2250 y Fl(neqns)47 b(neqns)f(nent)427 │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fp(14)p 182 100 1130 │ │ │ │ │ +4 v 1312 w Fl(Misc)30 b Fh(:)40 b Fj(DRAFT)31 b Fh(Jan)m(uary)f(7,)h │ │ │ │ │ +(2024)p 2770 100 V 427 399 a Fp(for)f Fg(A)h Fp(real)g(or)f(complex)h │ │ │ │ │ +(nonsymmetric.)337 539 y Ff(\210)45 b Fp(The)30 b Fl(patchAndGoFlag)d │ │ │ │ │ +Fp(sp)s(eci\014es)j(the)g(\\patc)m(h-and-go")j(strategy)-8 │ │ │ │ │ +b(.)500 680 y Fo({)45 b Fl(patchAndGoFlag)f(=)k(0)21 │ │ │ │ │ +b Fp(|)g(if)g(a)h(zero)g(piv)m(ot)g(is)f(detected,)k(stop)c(computing)h │ │ │ │ │ +(the)f(factorization,)597 793 y(set)31 b(the)g(error)f(\015ag)g(and)g │ │ │ │ │ +(return.)500 920 y Fo({)45 b Fl(patchAndGoFlag)f(=)k(1)30 │ │ │ │ │ +b Fp(|)h(if)g(a)h(small)f(or)h(zero)f(piv)m(ot)h(is)g(detected,)g(set)g │ │ │ │ │ +(the)f(diagonal)i(en)m(try)597 1033 y(to)e(1)g(and)f(the)g │ │ │ │ │ +(o\013diagonal)j(en)m(tries)e(to)g(zero.)500 1159 y Fo({)45 │ │ │ │ │ +b Fl(patchAndGoFlag)f(=)k(2)34 b Fp(|)h(if)g(a)h(small)f(or)h(zero)f │ │ │ │ │ +(piv)m(ot)h(is)g(detected,)h(p)s(erturb)c(the)j(diagonal)597 │ │ │ │ │ +1272 y(en)m(try)-8 b(.)337 1413 y Ff(\210)45 b Fp(The)30 │ │ │ │ │ +b Fl(fudge)f Fp(parameter)i(is)f(used)g(to)h(p)s(erturb)d(a)j(diagonal) │ │ │ │ │ +h(en)m(try)-8 b(.)337 1554 y Ff(\210)45 b Fp(The)30 b │ │ │ │ │ +Fl(toosmall)e Fp(parameter)j(is)g(judge)e(when)h(a)h(diagonal)g(en)m │ │ │ │ │ +(try)g(is)f(small.)337 1695 y Ff(\210)45 b Fp(If)30 b │ │ │ │ │ +Fl(storeids)46 b(=)h(1)p Fp(,)30 b(then)h(the)f(lo)s(cations)i(where)e │ │ │ │ │ +(action)i(w)m(as)e(tak)m(en)i(is)e(stored)h(in)f(an)g │ │ │ │ │ +Fl(IV)g Fp(ob)5 b(ject.)337 1835 y Ff(\210)45 b Fp(If)30 │ │ │ │ │ +b Fl(storevalues)45 b(=)i(1)p Fp(,)31 b(then)f(the)g(p)s(erturbations)f │ │ │ │ │ +(are)i(stored)g(in)f(an)g Fl(DV)g Fp(ob)5 b(ject.)337 │ │ │ │ │ +1976 y Ff(\210)45 b Fp(The)37 b Fl(matrixFileName)d Fp(parameter)k(is)f │ │ │ │ │ +(the)h(name)f(of)h(the)g(\014les)f(where)g(the)h(matrix)f(en)m(tries)i │ │ │ │ │ +(are)427 2089 y(read)31 b(from.)40 b(The)30 b(\014le)g(has)g(the)h │ │ │ │ │ +(follo)m(wing)h(structure.)427 2250 y Fl(neqns)47 b(neqns)f(nent)427 │ │ │ │ │ 2363 y(irow)h(jcol)g(entry)427 2476 y(...)95 b(...)g(...)427 │ │ │ │ │ 2638 y Fp(where)28 b Fl(neqns)e Fp(is)i(the)g(global)h(n)m(um)m(b)s(er) │ │ │ │ │ d(of)i(equations)h(and)e Fl(nent)g Fp(is)h(the)g(n)m(um)m(b)s(er)e(of)i │ │ │ │ │ (en)m(tries)h(in)e(this)427 2751 y(\014le.)49 b(There)32 │ │ │ │ │ b(follo)m(ws)i Fl(nent)e Fp(lines,)i(eac)m(h)g(con)m(taining)h(a)e(ro)m │ │ │ │ │ (w)g(index,)h(a)f(column)g(index)f(and)h(one)g(or)427 │ │ │ │ │ 2864 y(t)m(w)m(o)f(\015oating)f(p)s(oin)m(t)g(n)m(um)m(b)s(ers,)e(one)h │ │ │ │ │ @@ -7497,17 +7487,17 @@ │ │ │ │ │ 5181 y Ff(\210)45 b Fp(The)33 b Fl(msgFile)e Fp(parameter)j(determines) │ │ │ │ │ f(the)h(message)g(\014le)f(|)h(if)f Fl(msgFile)e Fp(is)i │ │ │ │ │ Fl(stdout)p Fp(,)g(then)g(the)427 5294 y(message)27 b(\014le)f(is)g │ │ │ │ │ Fj(stdout)p Fp(,)i(otherwise)e(a)h(\014le)f(is)f(op)s(ened)g(with)h │ │ │ │ │ Fj(app)-5 b(end)28 b Fp(status)e(to)g(receiv)m(e)i(an)m(y)e(output)427 │ │ │ │ │ 5407 y(data.)p eop end │ │ │ │ │ %%Page: 15 15 │ │ │ │ │ -TeXDict begin 15 14 bop 91 100 1111 4 v 1292 100 a Fl(Misc)30 │ │ │ │ │ -b Fh(:)40 b Fj(DRAFT)121 b Fh(F)-8 b(ebruary)31 b(8,)g(2025)p │ │ │ │ │ -2697 100 V 1111 w Fp(15)337 399 y Ff(\210)45 b Fl(type)29 │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1130 4 v 1312 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)122 b Fh(Jan)m(uary)30 b(7,)h(2024)p │ │ │ │ │ +2678 100 V 1130 w Fp(15)337 399 y Ff(\210)45 b Fl(type)29 │ │ │ │ │ b Fp(is)i(the)f(t)m(yp)s(e)h(of)g(en)m(tries)500 545 │ │ │ │ │ y Fo({)45 b Fl(1)30 b Fp(|)h(\()p Fl(SPOOLES)p 1174 545 │ │ │ │ │ 29 4 v 32 w(REAL)p Fp(\))f(for)g(real)h(en)m(tries)500 │ │ │ │ │ 674 y Fo({)45 b Fl(2)30 b Fp(|)h(\()p Fl(SPOOLES)p 1174 │ │ │ │ │ 674 V 32 w(COMPLEX)p Fp(\))e(for)h(complex)h(en)m(tries)337 │ │ │ │ │ 820 y Ff(\210)45 b Fp(The)27 b Fl(matrixFileName)d Fp(parameter)k(is)g │ │ │ │ │ (the)f(name)h(of)g(the)f(input)g(\014le)h(for)f(the)h(matrix)g(en)m │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -17,15 +17,15 @@ │ │ │ │ │ │ The method calls itself recursively. To find the permutation for an n1 x n2 x n3 grid, call │ │ │ │ │ │ mkNDperm(n1, n2, n3, newToOld, 0, n1-1, 0, n2-1, 0, n3-1) ; │ │ │ │ │ │ from a driver program. │ │ │ │ │ │ Error checking: If n1, n2 or n3 are less than or equal to zero, or if newToOld is NULL, or if │ │ │ │ │ │ west, south or bottom are less than or equal to zero, of if east ≥ n1, of if north ≥ n2, of if │ │ │ │ │ │ top ≥ n3, an error message is printed and the program exits. │ │ │ │ │ │ 1 │ │ │ │ │ │ - 2 Misc : DRAFT February 8, 2025 │ │ │ │ │ │ + 2 Misc : DRAFT January 7, 2024 │ │ │ │ │ │ 2. void mkNDperm2 ( int n1, int n2, int n3, int newToOld[], int west, │ │ │ │ │ │ int east, int south, int north, int bottom, int top ) ; │ │ │ │ │ │ This method this vector fills a permutation vector with the nested dissection new-to-old │ │ │ │ │ │ ordering of the vertices for the subgrid defined by nodes whose coordinates lie in │ │ │ │ │ │ [west, east] x [south, north] x [bottom, top]. │ │ │ │ │ │ There is one important difference between this method and mkNDperm() above; this method │ │ │ │ │ │ finds double-wide separators, necessary for an operator with more than nearest neighbor grid │ │ │ │ │ │ @@ -58,15 +58,15 @@ │ │ │ │ │ │ tains a dsizes1[q1] x dsizes2[q2] x disizes3[q3] subgrid of points. │ │ │ │ │ │ Error checking: If n1, n2 or n3 are less than or equal to zero, or if p1, p2 or p3 are less than or │ │ │ │ │ │ equal to zero, or if 2p1−1 > n1, or if 2p2−1 > n2, or if 2p3−1 > n3, or if oldToNew is NULL, │ │ │ │ │ │ or if dsizes1[], disizes2[] and dsizes3[] are not NULL but have invalid entries (all entries │ │ │ │ │ │ must be positive, entries in dsizes1[] must sum to n1 - p1 + 1, entries in dsizes2[] must │ │ │ │ │ │ sum to n2 - p2 + 1, and entries in dsizes3[] must sum to n3 - p3 + 1, an error message │ │ │ │ │ │ is printed and the program exits. │ │ │ │ │ │ - Misc : DRAFT February 8, 2025 3 │ │ │ │ │ │ + Misc : DRAFT January 7, 2024 3 │ │ │ │ │ │ 5. void fp2DGrid ( int n1, int n2, int ivec[], FILE *fp ) ; │ │ │ │ │ │ This method writes the ivec[] vector onto an n1 x n2 grid to file fp. This is useful to │ │ │ │ │ │ visualize an ordering or a metric on a grid. │ │ │ │ │ │ Error checking: If n1 or n2 are less than or equal to zero, or if ivec or fp are NULL, an error │ │ │ │ │ │ message is printed and the program exits. │ │ │ │ │ │ 6. void fp3DGrid ( int n1, int n2, int n3, int ivec[], FILE *fp ) ; │ │ │ │ │ │ This method writes the ivec[] vector onto an n1 x n2 x n3 grid to file fp. This is useful │ │ │ │ │ │ @@ -96,15 +96,15 @@ │ │ │ │ │ │ This method returns a front tree ETree object for a multiple minimum degree ordering of │ │ │ │ │ │ the graph graph. The seed parameter is a random number seed. The msglvl and msgFile │ │ │ │ │ │ parameters govern the diagnostics output. Use msglvl = 0 for no output, msglvl = 1 for │ │ │ │ │ │ timings and scalar statistics, and use msglvl > 1 with care, for it can generate huge amounts │ │ │ │ │ │ of output. │ │ │ │ │ │ Error checking: If graph is NULL, or if msglvl > 0 and msgFile is NULL, an error message is │ │ │ │ │ │ printed and the program exits. │ │ │ │ │ │ - 4 Misc : DRAFT February 8, 2025 │ │ │ │ │ │ + 4 Misc : DRAFT January 7, 2024 │ │ │ │ │ │ 2. ETree * orderViaND ( Graph *graph, int maxdomainsize, int seed, │ │ │ │ │ │ int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method returns a front tree ETree object for a nested dissection ordering of the graph │ │ │ │ │ │ graph. If a subgraph has more vertices than the maxdomainsize parameter, it is split. The │ │ │ │ │ │ seed parameter is a random number seed. The msglvl and msgFile parameters govern │ │ │ │ │ │ the diagnostics output. Use msglvl = 0 for no output, msglvl = 1 for timings and scalar │ │ │ │ │ │ statistics, and use msglvl > 1 with care, for it can generate huge amounts of output. │ │ │ │ │ │ @@ -136,15 +136,15 @@ │ │ │ │ │ │ double linewidth2, double radius, char *epsFileName, │ │ │ │ │ │ int msglvl, FILE *msgFile ) ; │ │ │ │ │ │ This method is used to create an EPS (Encapsulated Postscript) file that contains a picture │ │ │ │ │ │ of a graph in two dimensions. We use this to visualize separators and domain decompositions, │ │ │ │ │ │ mostly of regular grids and triangulations of a planar region. │ │ │ │ │ │ The graph object defines the connectivity of the vertices. The coords object defines the │ │ │ │ │ │ locations of the vertices. The tagsIV object is used to define whether or not an edge is │ │ │ │ │ │ - Misc : DRAFT February 8, 2025 5 │ │ │ │ │ │ + Misc : DRAFT January 7, 2024 5 │ │ │ │ │ │ drawn between two vertices adjacent in the graph. When tagsIV is not NULL, if there is an │ │ │ │ │ │ edge (u,v) in the graph and tags[u] = tags[v], then the edge with width linewidth1 is │ │ │ │ │ │ drawn. For edges (u,v) in the graph and tags[u] != tags[v], then the edge with width │ │ │ │ │ │ linewidth2is drawn, assuming linewidth2> 0. If tagsIV is NULL, than all edges are drawn │ │ │ │ │ │ with width linewidth1. Each vertex is draw with a filled circle with radius radius. │ │ │ │ │ │ The graph and its Coords object occupy a certain area in 2-D space. We try to plot the │ │ │ │ │ │ graph inside the area defined by the rect[] array in such a manner that the relative scales │ │ │ │ │ │ @@ -177,15 +177,15 @@ │ │ │ │ │ │ InpMtx **pmtxA, DenseMtx **pmtxX, DenseMtx **pmtxB ) ; │ │ │ │ │ │ This method creates a linear system AX = B for a natural factor formulation of a n1×n2×n3 │ │ │ │ │ │ grid. If n1, n2 and n3 are all greater than 1, the grid is formed of linear hexahedral elements │ │ │ │ │ │ andthematrixAhas8*n1*n2*n3rows. Ifoneofn1,n2andn3isequalto1,thegridisformed │ │ │ │ │ │ of linear quadrilateral elements and the matrix A has 4*n1*n2*n3 rows. The entries in A and │ │ │ │ │ │ X are random numbers, B is computed as the product of A with X. A can be real (type = │ │ │ │ │ │ 1) or complex (type = 2). The number of columns of X is given by nrhs. The linear system │ │ │ │ │ │ - 6 Misc : DRAFT February 8, 2025 │ │ │ │ │ │ + 6 Misc : DRAFT January 7, 2024 │ │ │ │ │ │ is ordered using theoretical nested dissection, and the front tree is transformed using the │ │ │ │ │ │ maxzeros and maxsize parameters. The addresses of the front tree, symbolic factorization, │ │ │ │ │ │ and three matrix objects are returned in the last five arguments of the calling sequence. │ │ │ │ │ │ Error checking: None presently. │ │ │ │ │ │ 1.2 Driver programs found in the Misc directory │ │ │ │ │ │ This section contains brief descriptions of the driver programs. │ │ │ │ │ │ 1. testNDperm msglvl msgFile n1 n2 n3 outPermFile │ │ │ │ │ │ @@ -215,15 +215,15 @@ │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ • The ETreeFile parameter is the output file for the ETree object. If ETreeFile is none │ │ │ │ │ │ then the ETree object is not written to a file. Otherwise, the ETree writeToFile() │ │ │ │ │ │ method is called to write the object to a formatted file (if ETreeFile is of the form │ │ │ │ │ │ *.etreef), or a binary file (if ETreeFile is of the form *.etreeb). │ │ │ │ │ │ - Misc : DRAFT February 8, 2025 7 │ │ │ │ │ │ + Misc : DRAFT January 7, 2024 7 │ │ │ │ │ │ 3. testOrderViaND msglvl msgFile GraphFile maxdomainsize seed ETreeFile │ │ │ │ │ │ This program reads in a Graph object from a file and computes a generalized nested dissection │ │ │ │ │ │ ordering of the graph. │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the Perm object is written to the output file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ @@ -254,15 +254,15 @@ │ │ │ │ │ │ • The seed parameter is a random number seed. │ │ │ │ │ │ • The ETreeFile parameter is the output file for the ETree object. If ETreeFile is none │ │ │ │ │ │ then the ETree object is not written to a file. Otherwise, the ETree writeToFile() │ │ │ │ │ │ method is called to write the object to a formatted file (if ETreeFile is of the form │ │ │ │ │ │ *.etreef), or a binary file (if ETreeFile is of the form *.etreeb). │ │ │ │ │ │ 5. drawGraph msglvl msgFile inGraphFile inCoordsFile inTagsIVfile │ │ │ │ │ │ outEPSfile linewidth1 linewidth2 bbox[4] rect[4] radius │ │ │ │ │ │ - 8 Misc : DRAFT February 8, 2025 │ │ │ │ │ │ + 8 Misc : DRAFT January 7, 2024 │ │ │ │ │ │ This driver program generates a Encapsulated Postscript file outEPSfile of a 2-D graph │ │ │ │ │ │ using a Graph object, a Coords object and a tags IV object that contains the component ids │ │ │ │ │ │ of the vertices. │ │ │ │ │ │ See the doDraw script file in this directory for an example calling sequence. │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ that all objects are written to the output file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ @@ -293,48 +293,48 @@ │ │ │ │ │ │ See Figure 1.1 for a plot of the graph of R2D100, a randomly triangulated grid with 100 │ │ │ │ │ │ vertices with linewidth1 = 3. Figure 1.2 illustrates a domain decomposition obtained from │ │ │ │ │ │ the fishnet algorithm of Chapter ?? with linewidth1 = 3 and linewidth2 = 0.1. │ │ │ │ │ │ 6. testSemi msglvl msgFile GraphFile ETreeFile mapFile │ │ │ │ │ │ This program is used to compute the effect of using a semi-implicit factorization to solve │ │ │ │ │ │ AX=" A0,0 A0,1 #" X0 #=" B0 #=B. │ │ │ │ │ │ A1,0 A1,1 X1 B1 │ │ │ │ │ │ - Misc : DRAFT February 8, 2025 9 │ │ │ │ │ │ + Misc : DRAFT January 7, 2024 9 │ │ │ │ │ │ Figure 1.1: R2D100 │ │ │ │ │ │ - 10 Misc : DRAFT February 8, 2025 │ │ │ │ │ │ + 10 Misc : DRAFT January 7, 2024 │ │ │ │ │ │ Figure 1.2: R2D100: fishnet domain decomposition │ │ │ │ │ │ - 3 3 3 3 3 3 3 0 0 5 │ │ │ │ │ │ + 3 3 3 3 3 3 3 0 0 5 │ │ │ │ │ │ 3 │ │ │ │ │ │ - 3 3 3 0 0 │ │ │ │ │ │ + 3 3 3 0 0 │ │ │ │ │ │ 3 3 │ │ │ │ │ │ 3 1 │ │ │ │ │ │ - 0 0 1 1 │ │ │ │ │ │ - 3 0 1 │ │ │ │ │ │ - 3 1 │ │ │ │ │ │ + 0 0 1 1 │ │ │ │ │ │ + 3 0 1 │ │ │ │ │ │ + 3 1 │ │ │ │ │ │ 0 1 │ │ │ │ │ │ - 2 0 1 1 │ │ │ │ │ │ + 2 0 1 1 │ │ │ │ │ │ 0 1 1 │ │ │ │ │ │ - 0 1 │ │ │ │ │ │ - 2 2 1 1 1 │ │ │ │ │ │ - 2 1 │ │ │ │ │ │ - 0 11 │ │ │ │ │ │ - 2 1 │ │ │ │ │ │ - 2 2 0 1 1 │ │ │ │ │ │ + 0 1 │ │ │ │ │ │ + 2 2 1 1 1 │ │ │ │ │ │ + 2 1 │ │ │ │ │ │ + 0 11 │ │ │ │ │ │ + 2 1 │ │ │ │ │ │ + 2 2 0 1 1 │ │ │ │ │ │ 1 1 │ │ │ │ │ │ - 2 1 │ │ │ │ │ │ - 2 2 0 1 0 │ │ │ │ │ │ - 0 1 │ │ │ │ │ │ - 2 2 0 │ │ │ │ │ │ - 2 2 0 4 │ │ │ │ │ │ - 4 0 0 │ │ │ │ │ │ - 0 4 │ │ │ │ │ │ + 2 1 │ │ │ │ │ │ + 2 2 0 1 0 │ │ │ │ │ │ + 0 1 │ │ │ │ │ │ + 2 2 0 │ │ │ │ │ │ + 2 2 0 4 │ │ │ │ │ │ + 4 0 0 │ │ │ │ │ │ + 0 4 │ │ │ │ │ │ 2 2 4 │ │ │ │ │ │ - 2 2 4 4 │ │ │ │ │ │ - 0 4 4 │ │ │ │ │ │ - 2 2 0 4 4 4 4 4 4 4 │ │ │ │ │ │ - Misc : DRAFT February 8, 2025 11 │ │ │ │ │ │ + 2 2 4 4 │ │ │ │ │ │ + 0 4 4 │ │ │ │ │ │ + 2 2 0 4 4 4 4 4 4 4 │ │ │ │ │ │ + Misc : DRAFT January 7, 2024 11 │ │ │ │ │ │ Ais factored as " # " #" # │ │ │ │ │ │ A A L 0 U U │ │ │ │ │ │ 0,0 0,1 = 0,0 0,0 0,1 , │ │ │ │ │ │ A A L L 0 U │ │ │ │ │ │ 1,0 1,1 1,0 1,1 1,1 │ │ │ │ │ │ and to solve AX = B, we do the following steps. │ │ │ │ │ │ • solve L Y =B │ │ │ │ │ │ @@ -378,15 +378,15 @@ │ │ │ │ │ │ • The msglvl parameter determines the amount of output. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ • The GraphFile parameter is the input file for the Graph object. It must be of the form │ │ │ │ │ │ *.graphfor*.graphb. TheGraphobjectisreadfromthefileviatheGraph readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ - 12 Misc : DRAFT February 8, 2025 │ │ │ │ │ │ + 12 Misc : DRAFT January 7, 2024 │ │ │ │ │ │ • The ETreeFile parameter is the input file for the ETree object. It must be of the form │ │ │ │ │ │ *.etreefor*.etreeb. TheETreeobjectisreadfromthefileviatheETree readFromFile() │ │ │ │ │ │ method. │ │ │ │ │ │ • The mapFile parameter is the input file for the map IV object. It must be of the form │ │ │ │ │ │ *.ivfor *.ivb. The IV object is read from the file via the IV readFromFile() method. │ │ │ │ │ │ 7. allInOne msglvl msgFile type symmetryflag pivotingflag │ │ │ │ │ │ matrixFileName rhsFileName seed │ │ │ │ │ │ @@ -418,15 +418,15 @@ │ │ │ │ │ │ ... │ │ │ │ │ │ irow jcol value │ │ │ │ │ │ ... │ │ │ │ │ │ where the first line has the number of rows, columns and entries. (Note, for this driver │ │ │ │ │ │ program nrow must be equal to ncol since we are factoring a square matrix.) Each of │ │ │ │ │ │ the nent following lines contain one nonzero entry. For a complex matrix, the file has │ │ │ │ │ │ this structure. │ │ │ │ │ │ - Misc : DRAFT February 8, 2025 13 │ │ │ │ │ │ + Misc : DRAFT January 7, 2024 13 │ │ │ │ │ │ nrow ncol nent │ │ │ │ │ │ ... │ │ │ │ │ │ irow jcol real_value imag_value │ │ │ │ │ │ ... │ │ │ │ │ │ For both real and complex entries, the entries need not be disjoint, i.e., entries with the │ │ │ │ │ │ same irow and jcol values are summed. │ │ │ │ │ │ • The rhsFileNameparameter is the name of the input file for the right hand side matrix. │ │ │ │ │ │ @@ -457,15 +457,15 @@ │ │ │ │ │ │ • The type parameter specifies a real or complex linear system. │ │ │ │ │ │ – type = 1 (SPOOLES REAL) for real, │ │ │ │ │ │ – type = 2 (SPOOLES COMPLEX) for complex. │ │ │ │ │ │ • The symmetryflag parameter specifies the symmetry of the matrix. │ │ │ │ │ │ – type = 0 (SPOOLES SYMMETRIC) for A real or complex symmetric, │ │ │ │ │ │ – type = 1 (SPOOLES HERMITIAN) for A complex Hermitian, │ │ │ │ │ │ – type = 2 (SPOOLES NONSYMMETRIC) │ │ │ │ │ │ - 14 Misc : DRAFT February 8, 2025 │ │ │ │ │ │ + 14 Misc : DRAFT January 7, 2024 │ │ │ │ │ │ for A real or complex nonsymmetric. │ │ │ │ │ │ • The patchAndGoFlag specifies the “patch-and-go” strategy. │ │ │ │ │ │ – patchAndGoFlag = 0—ifazeropivotisdetected, stopcomputingthefactorization, │ │ │ │ │ │ set the error flag and return. │ │ │ │ │ │ – patchAndGoFlag = 1 — if a small or zero pivot is detected, set the diagonal entry │ │ │ │ │ │ to 1 and the offdiagonal entries to zero. │ │ │ │ │ │ – patchAndGoFlag = 2 — if a small or zero pivot is detected, perturb the diagonal │ │ │ │ │ │ @@ -497,15 +497,15 @@ │ │ │ │ │ │ right hand side entries are read in from a file, and the system is solved. One input parameter │ │ │ │ │ │ specifies the type of system (real or complex). │ │ │ │ │ │ • The msglvl parameter determines the amount of output — taking msglvl >= 3 means │ │ │ │ │ │ the Perm object is written to the output file. │ │ │ │ │ │ • The msgFile parameter determines the message file — if msgFile is stdout, then the │ │ │ │ │ │ message file is stdout, otherwise a file is opened with append status to receive any output │ │ │ │ │ │ data. │ │ │ │ │ │ - Misc : DRAFT February 8, 2025 15 │ │ │ │ │ │ + Misc : DRAFT January 7, 2024 15 │ │ │ │ │ │ • type is the type of entries │ │ │ │ │ │ – 1 — (SPOOLES REAL) for real entries │ │ │ │ │ │ – 2 — (SPOOLES COMPLEX) for complex entries │ │ │ │ │ │ • The matrixFileName parameter is the name of the input file for the matrix entries. For │ │ │ │ │ │ a real matrix, this file must have the following form. │ │ │ │ │ │ nrow ncol nent │ │ │ │ │ │ ...